The PROGRAMS
commands allow you to bind the GGSLIB
intercept library to application programs, link GGSDLL
intercept library to application programs, and view information about programs that may or may not be bound with GGSLIB
.
BIND
PROGRAMS
binds the TNS version of the GGSLIB
intercept library to application programs. You must bind the intercept library to capture non-audited database updates to Enscribe files.
After issuing the BIND
PROGRAMS
command, you are prompted for a list of files with which to bind GGSLIB
. You can enter a wildcard or actual program name. Terminate the list with GO
(or cancel with EXIT
). GGSLIB
becomes the Guardian user library for specified programs (through the BIND
CHANGE
LIBRARY
command).
If a program references a user library, that library is added to the bind list and GGSLIB
is physically bound to the user library module (through the BIND
BUILD
command). The calling program's link to the user library is unchanged.
Syntax
BIND PROGRAMS [, AXCEL| NOAXCEL] [, PARAMS param_file_name] [, REPORT report_file] [, GGSLIB library_filename] [, ERRORS num_errors] [, FORCEBIND] [, NOLIBBIND] [, CHANGELIB]
AXCEL|NOAXCEL
AXCEL
causes code acceleration after binding with existing user libraries. This option has no effect unless a user library is bound to GGSLIB
and can be bypassed with NOAXCEL
. If you do not specify NOAXCEL,
Oracle GoldenGate will run BIND
PROGRAMS
with the AXCEL
option enabled.
PARAMS
param_file_name
The file that contains the program names to bind, as an alternative to entering file names interactively.
REPORT
report_file
A file name for the detailed report of activity caused by this command. The default is install_volume
.GGSRPT
.BIND
. Previous versions of the report file are aged to BIND00
, BIND01
, and so on.
GGSLIB
library_filename
Changes the name of the GGSLIB
to bind with the application. The default is GGSLIB
in the Oracle GoldenGate home subvolume.
ERRORS
num_errors
The number of allowable errors encountered by the BIND
process before quitting. Default is 5.
FORCEBIND
Forces programs to be rebound with the library, even if they are already bound. Use FORCEBIND
, for example, when binding a new release of GGSLIB
to the application.
NOLIBBIND
Bypasses binding of existing user libraries with GGSLIB
(default is to bind).
CHANGELIB
Instructs the bind process to change libraries to GGSLIB
. Use this when receiving a new release of GGSLIB
or BASELIB.
Note:
If your application programs are Native, then you must use the LINK PROGRAMS
command to bind the Native version of the intercept library to your programs.
Use INFO PROGRAMS
to retrieve information about programs that may or may not be bound with GGSLIB
. Use this command to determine if non-audited data will be extracted on a program-by-program basis.
Each program's modification timestamp is reported, so you can determine when data extraction took effect.
LINK PROGRAMS
links the native intercept library, GGSDLL
, to your application programs. You must bind the intercept library to capture non-audited database updates to Enscribe files. Once this is complete, GGSDLL
becomes the Guardian user library for specified programs (through the NLD
-change
libname
command).
Syntax
LINK PROGRAMS [, PARAMS param_file_name] [, REPORT report_file] [, GGSDLL library_filename] [, ERRORS num_errors] [, CHANGELIB]
After issuing the LINK PROGRAMS
command, you are prompted for a list of files with which to link the library. You can enter a wildcard or actual program name. Terminate the list with GO
(or cancel with EXIT
).
PARAMS
param_file_name
The file that contains the program names to link, as an alternative to entering file names interactively.
REPORT
report_file
A file name for the detailed report of activity caused by this command. The default is install_volume.GGSRPT.LINK
.
Previous versions of the report file are aged to LINK00
, LINK01
, and so on.
GGSDLL
library_filename
Changes the name of the library to link with the application. The default name is GGSDLL
for the operating systems. This library is stored in the Oracle GoldenGate installation subvolume.
ERRORS
num_errors
The number of allowable errors encountered by the NLD
process before quitting. Default is 5.
CHANGELIB
Instructs the link process to change libraries to GGSDLL
. Use this when receiving a new release of BASELIBR and using NLDLIB.