Installing the exit

Install the load module that contains the exit into an APF authorized library. ICSF uses this search order to locate the exit:

Job pack area
Steplib (if one exists)
Joblib (if one exists)
Link pack area (LPA)
Link list (SYS1.LINKLIB concatenation)

Define the ICSF name and load module name on the EXIT keyword in the installation options data set.

Note: The load module name must not be named CSFKGUP

For more information about the installation options data set, see Parameters in the installation options data set. The EXIT keyword has this syntax:

EXIT ( ICSF name, load module name, FAIL (options) )

The ICSF name portion of the keyword refers to the ICSF name for the KGUP exit. The ICSF name for the KGUP exit is CSFKGUP. The load module name is the name of the load module that contains the exit. The name can be any valid name that your installation chooses. The FAIL portion of the EXIT keyword specifies the action ICSF takes if the exit cannot be loaded. The valid FAIL options are NONE, EXIT, SERVICE, and ICSF. The FAIL options available to the KGUP exit are:

NONE: Initialization continues even if exit cannot be loaded.
ICSF: Initialization ends if exit cannot be loaded.

You must specify a FAIL option. If you do not, ICSF returns an error message, ends abnormally, and generates an SVC dump when attempting to load the exit. If the exit ends abnormally, KGUP also ends abnormally.