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:

1. Select option 3, OPSTAT, on the Primary Option panel, as shown in Figure 197.
   Figure 197. Selecting the Installation Options and Hardware Status Option on the Primary Menu Panel

    CSF@PRIM ----- Integrated Cryptographic Service Facility ---------
    OPTION ===> 3
   
    Enter the number of the desired option.
   
      1  COPROCESSOR MGMT    -  Management of Cryptographic Coprocessors
      2  MASTER KEY MGMT     -  Master key set or change, CKDS/PKDS processing
      3  OPSTAT              -  Installation options
      4  ADMINCNTL           -  Administrative Control Functions
      5  UTILITY             -  ICSF Utilities
      6  PPINIT              -  Pass Phrase Master Key/KDS Initialization
      7  TKE                 -  TKE Master and Operational key processing
      8  KGUP                -  Key Generator Utility processes
      9  UDX MGMT            -  Management of User Defined Extensions
   
          Licensed Materials - Property of IBM
   
         5694-A01 (C) Copyright IBM Corp. 1990, 2011. All rights reserved.
         US Government Users Restricted Rights - Use, duplication or
         disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
   
    Press ENTER to go to the selected option.
    Press END   to exit to the previous menu.
    

   The Installation Options panel appears. Refer to Figure 198.

   Figure 198. 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
      

2. Select option 3, Services, on the Installation Options Status panel.

   The Installation Defined Services panel appears. Refer to Figure 199.

   Figure 199. 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.