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


IPCS Formatting Routine

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

There is a CTrace filter exit for ICSF. You can now issue these IPCS commands:

CTRACE COMP(CSF) OPTIONS((COUNTS,FAILURES))
CTRACE COMP(CSF) OPTIONS((COUNTS))
CTRACE COMP(CSF) OPTIONS((FAILURES))
COUNTS
Produces a list of services called and how often they were called.
FAILURES
Produces output for each failed ICSF service trace entry.

There is a formatter for ICSF called CSFDATA. It is an IPCS VERBEXIT. To run it, enter:

VERBX CSFDATA 'options'

The supported options are:

  • CELL
  • CCPV
  • CCPP
  • CCPA
  • CCPS
  • CACB
  • CCPD

If no options are specified you get VERBX CSFDATA Output:

No valid options were specified on VERBX CSFDATA.
Valid options are CELL,CCPV,CCPP,CCPA,CCPS,CACB,CCPD

Sample output:

COMPONENT TRACE FULL FORMAT                                                
COMP(CSF)                                                                    
OPTIONS((FAILURES))                                                          
**** 08/15/2006                                                              
                                                                             
SYSNAME   MNEMONIC  ENTRY ID    TIME STAMP     DESCRIPTION                   
-------   --------  --------  ---------------  -------------                 
                                                                             
SYSAK     ASERVICE  00000006  12:58:13.679197  After  call to service        
                                                                             
         ASCB@.... 00FCD980  TCB@..... 007BCA38  AS_id.... 0022              
         Module... CSFNENC   RCode.... 00000008  Reason... 0000002F          
         User..... 00000000  00000000  00000000  00000000  00000000  00000000
                   00000000  00000000  00000000  00000000  00000000  00000000
                   0000   

SYSAK     ASERVICE  00000006  13:07:02.162950  After  call to service        
                                                                             
         ASCB@.... 00FCD980  TCB@..... 007BCA38  AS_id.... 0022              
         Module... CSFNSYI   RCode.... 00000008  Reason... 00000042          
         User..... 00000000  00000000  00000000  00000000  00000000  00000000
                   00000000  00000000  00000000  00000000  00000000  00000000
                   0000             


==================================================================
  COMPONENT TRACE FULL FORMAT      
  COMP(CSF)                        
  OPTIONS((COUNTS))  

              
 ICSF COUNTS FROM CTRACE:          
 SERVICE CALLS_FOUND = 00000070    
 FAILING SERVICES    = 00000035    
 SERVICE   #SUCCESS   #FAILED      
 CSFSSTSW  00000001   00000000     
 CSFNPCV   00000001   00000000     
 CSFNPCM   00000001   00000000     
 CSFSTRL   00000002   00000000     
 CSFNENC   00000003   00000025     
 CSFNDEC   00000017   00000000     
 CSFNSYI   00000003   00000004     
 CSFNPKD   00000007   00000006     


======================================================================
COMPONENT TRACE FULL FORMAT                                                  
COMP(CSF)                                                                    
OPTIONS((COUNTS,FAILURES))                                                   
**** 08/15/2006                                                              
                                                                             
SYSNAME   MNEMONIC  ENTRY ID    TIME STAMP     DESCRIPTION                   
-------   --------  --------  ---------------  -------------                 
                                                                             
SYSAK     ASERVICE  00000006  12:58:13.679197  After  call to service        
                                                                             
         ASCB@.... 00FCD980  TCB@..... 007BCA38  AS_id.... 0022              
         Module... CSFNENC   RCode.... 00000008  Reason... 0000002F          
         User..... 00000000  00000000  00000000  00000000  00000000  00000000
                   00000000  00000000  00000000  00000000  00000000  00000000
                   0000                                                      
       
SYSAK     ASERVICE  00000006  13:11:04.023615  After  call to service        
                                                                               
         ASCB@.... 00FCD980  TCB@..... 007BCA38  AS_id.... 0022              
         Module... CSFNPKD   RCode.... 00000008  Reason... 00000041          
         User..... 00000000  00000000  00000000  00000000  00000000  00000000
                   00000000  00000000  00000000  00000000  00000000  00000000
                   0000 
                                                     
ICSF COUNTS FROM CTRACE:                                                      
SERVICE CALLS_FOUND = 00000010                                                
FAILING SERVICES    = 00000002                                                
SERVICE   #SUCCESS   #FAILED                                                                                                     
CSFNENC   00000003   00000001                                                                                         
CSFNPKD   00000007   00000001


================================================================
Sample output of ?CSFTRCE TYPE(MISC)

COMPONENT TRACE FULL FORMAT                                                  
COMP(CSF)                                                                    
**** 08/15/2006                                                              
                                                                             
SYSNAME   MNEMONIC  ENTRY ID    TIME STAMP     DESCRIPTION                   
-------   --------  --------  ---------------  -------------                 
                                                                             
         
SYSAK     MISC      00000013  15:20:29.471700  Miscellaneous                 
                                                                             
         ASCB@.... 00F58100  TCB@..... 007D4A70  AS_id.... 001E              
         Module... CSFACCPD  HEX8..... 00297D54  F800804D                    
         Hex4A.... 7F44B3B0  Hex4B.... 00E7F1F0  ID....... X10               
SYSAK     MISC      00000013  15:20:29.471702  Miscellaneous                 
                                                                             
         ASCB@.... 00F58100  TCB@..... 007D4A70  AS_id.... 001E              
         Module... CSFACCPD  HEX8..... 00297D54  F800804D                    
         Hex4A.... 7F44B468  Hex4B.... ACD7F0F1  ID....... P01               
SYSAK     MISC      00000013  15:20:29.471731  Miscellaneous                 
                                                                             
         ASCB@.... 00FB1780  TCB@..... 007D54F8  AS_id.... 0029 
         Module... CSFGCCPN  HEX8..... 00297D54  F800804D                    
         Hex4A.... 7F44B468  Hex4B.... B8D7F0F8  ID....... P08               
                                                  
SYSAK     MISC      00000013  15:20:29.476769  Miscellaneous                 
                                                                             
         ASCB@.... 00FB0D00  TCB@..... 007D9138  AS_id.... 0030              
         Module... CSFASEND  HEX8..... 00307D91  3800804F                    
         Hex4A.... 7F44B3B0  Hex4B.... 00E7F1F1  ID....... X11               
SYSAK     MISC      00000013  15:20:29.476769  Miscellaneous                 
                                                                             
         ASCB@.... 00FB0D00  TCB@..... 007D9138  AS_id.... 0030              
         Module... CSFASEND  HEX8..... 00307D91  3800804F                    
         Hex4A.... 7F44B468  Hex4B.... A4D7F1F0  ID....... P10                            

You can use the Interactive Problem Control System (IPCS) to format and display the certain ICSF control blocks. The IPCS CBFORMAT command displays the control block's eye-catcher name, its location in the address space, and its field names with their offsets. You specify a symbol with the command to identify the control block. Table 7 lists the control blocks you can display, the symbol IPCS recognizes for each control block, and a reference for the control block format.

Table 7. IPCS Symbols and Format References for the ICSF Control Blocks
Control BlockSymbolFormat Reference
Installation-defined Service TableCSFMGSTVaries for each installation.
CSF Exit Name TableCSFENTSee Table 13.
Cryptographic Communication Vector TableCSFCCVTSee Table 88.
Cryptographic Communication Vector Table ExtensionCSFCCVESee Table 89.
Secondary Parameter BlockCSFASPBSee Table 17.

For example, to format and display the ICSF Exit Name table issue this command:

   CBFORMAT CSFENT

Instead of using a symbol to identify the control block, you can provide an address. Find and specify the address of the control block in the address space at the time of the dump. When you specify an address, you must also specify the STRUCTURE keyword with the control block symbol.

Note:
To format the secondary parameter block, you must provide an address to identify the control block.

For example, if the address of the secondary parameter block is F632D0, issue this command to format the secondary parameter block.

   CBFORMAT F632D0. STRUCTURE(CSFASPB)

In the example, the secondary parameter block is located at address F632D0 in the address space at the time of the dump. On the command, you must put a period after the address. With this control block, you also specify the structure keyword with the symbol CSFASPB.

For more information about using the CBFORMAT command, see z/OS MVS IPCS User’s Guide.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014