Programs commands

1.14 Programs commands

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.

1.14.1 BIND PROGRAMS

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.

1.14.2 INFO 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.

Syntax

INFO PROGRAMS file_name [, BOUND | UNBOUND]

file_name

A single file name or a wildcard list of files.

BOUND | UNBOUND

BOUND limits the output to programs that have GGSLIB bound with either the program or the program's user library.
UNBOUND reports programs that are not bound.

1.14.3 LINK PROGRAMS

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.