You install an exit for a service by installing the load module that contains the exit into an APF-authorized library. ICSF uses this normal search order to locate the exit:

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

Define the ICSF name and the load module name as a value on the EXIT keyword in the installation options data set. 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 each service exit. Note that the ICSF name for each service exit is the same as its name. Table 14 lists the ICSF names for each of the service exits. Table 15 lists the ICSF names for each of the compatibility service exits. 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 or it ends abnormally. The valid FAIL options are:

NONE

No action is taken. The exit can be called again and will end abnormally again.

EXIT

The exit is no longer available to be called again.

SERVICE

The service or program that called the exit is no longer available to be called again.

ICSF

ICSF or the key generator utility program or the PCF conversion program is ended, depending on the exit.

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, the service call fails regardless of the fail option you specified. Fail options apply only to subsequent requests for the service.