IPCS formatting routine

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
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,CCPA,CCPS,CACB,CCPD

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 1 lists the control blocks you can display, the symbol IPCS recognizes for each control block, and a reference for the control block format.

Table 1. IPCS symbols and format references for the ICSF Control Blocks
Control Block	Symbol	Format Reference
Installation-defined Service Table	CSFMGST	Varies for each installation.
CSF Exit Name Table	CSFENT	See Table 4.
Cryptographic Communication Vector Table	CSFCCVT	See Table 1.
Cryptographic Communication Vector Table Extension	CSFCCVE	See Table 1.
Secondary Parameter Block	CSFASPB	See Table 1.

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.