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 CKDS entry retrieval exit by installing the load module that contains the exit into an APF-authorized library. ICSF uses this normal z/OS 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 on the EXIT keyword in the installation options data set. Parameters in the installation options data set describes the installation options data set in further detail. 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 CKDS entry retrieval exit is CSFCKDS. 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 if it ends abnormally. The valid FAIL options are:

NONE
Do not take any action.
EXIT
Do not call this exit again. The exit will not receive control during subsequent attempts at CKDS retrieval.
SERVICE
Fail the service. All subsequent attempts at CKDS entry retrieval fail.
ICSF
End ICSF.

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 attempt at CKDS entry retrieval fails, regardless of the FAIL option you specified. FAIL options only apply to subsequent attempts at CKDS entry retrieval.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014