z/OS Cryptographic Services ICSF System Programmer's Guide
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Installing the exit

z/OS Cryptographic Services ICSF System Programmer's Guide
SA22-7520-17

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 of 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 the exit. The ICSF name for the single-record, read-write exit is CSFSRRW. 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 ends abnormally. The valid FAIL options are:

NONE
Do not take any action.
EXIT
Do not call this exit again.
SERVICE
Fail the service that called the exit.
ICSF
Fail the service that called 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 you specify FAIL(ICSF) and the exit cannot be loaded, ICSF initialization does not continue. If you specify FAIL(ICSF) and the exit ends abnormally, ICSF issues an advisory message that ICSF should be ended.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014