Displaying installation-defined callable services

ICSF provides callable services to perform cryptographic functions. You can write a callable service to perform a function unique to your installation. In the installation options data set, you must define each installation-defined callable service. You specify a number to identify the service to ICSF, and you specify the load module that contains the service. You can use the panels to view the number and module name for each installation-defined callable service.

To run an installation-defined service, you must:

Write the service.
Define the service.
Write a service stub and link it with your application program.

For more information about writing, defining, and running an installation-defined service, see z/OS Cryptographic Services ICSF System Programmer's Guide.

To display information about installation-defined callable services:

Select option 3, OPSTAT, on the ICSF Primary Menu panel.

The Installation Options panel appears. Refer to Figure 1.

Figure 1. Installation Options Panel

 CSFSOP00 ----------- ICSF - Installation Options --------
 OPTION ===> 3

 Enter the number of the desired option above.

   1  OPTIONS  -  Display Installation Options
   2  EXITS    -  Display Installation exits and exit options
   3  SERVICES -  Display Installation Defined Services

Select option 3, Services, on the Installation Options Status panel.
The Installation Defined Services panel appears. Refer to Figure 2.
Figure 2. Installation-Defined Services Display Panel
```
 CSFSOP40 -------- ICSF - Installation Defined Services --- ROW 1 TO 8 OF 8
 COMMAND ===>

   SERVICE NUMBER        INSTALLATION NAME
   --------------        -----------------

          1               SERVICE1
          3               SERVICE3
          5               SERVICE5
          6               SERVICE6
          8               SERVICE8
         11               SERVICEB
         13               SERVICED
****************************BOTTOM OF DATA**************************************
 
```
The system programmer used the SERVICE keyword in the installation options data set to specify the service-number, the load-module-name, and fail-option for each service. The service number identies the service to ICSF. The load-module-name identifies the module that contains the installation-defined service. The Installation Name column on the panel lists the load-module-name for each installation service.

The panel displays the service number and the corresponding installation name for each installation-defined service that is specified in the installation options data set.

Note: If your installation does not have any installation-defined callable services and you select option 3, the message NO GENERIC SERVICES displays and you remain on the Installation Options panel.

At ICSF start up, you define an installation options data set that contains the options your installation wants to use. The options specify certain modes and conditions on your ICSF system. You specify the keyword and value for each option in the installation options data set. You specify the data set name in the startup procedure. When you start ICSF, the options become active.