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


Defining a callable service

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

Use the SERVICE keyword in the installation options data set to specify information about the callable service. ICSF uses this information at ICSF startup to enable the service. See Steps to create the Installation Options Data Set for more information about ICSF installation options.

The SERVICE keyword has this syntax:

  • SERVICE(service-number,load-module-name,FAIL(fail-option))

The service-number is a number that identifies the service to ICSF. The valid service numbers are 1 through 32767, inclusive. The load-module-name is the name of the module that contains the service your installation wrote. During ICSF startup, ICSF loads the module and binds it to the service number you specified.

Using the fail-option, you specify the action ICSF takes if the loading of the service ends abnormally. ICSF loads all installation-defined services at ICSF startup.

Specify one of these values for the fail-option:

YES
ICSF abends if your service cannot be loaded.
NO
ICSF continues to start if your service cannot be loaded.

If the callable service ends abnormally while it is processing, ICSF does not end.

This SERVICE installation option statement identifies a specific installation-defined service to ICSF:

   SERVICE(50,KSUST,FAIL(NO))

When ICSF starts, it binds the service number 50 to the load module KSUST, which contains the callable service you wrote. Because the fail option is NO, if your service cannot be loaded, ICSF continues to start anyway.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014