Control Block Status (CBSTAT) Exit Routine

Write a control block status (CBSTAT) exit routine to do the following:

Perform analysis and generate a unique diagnostic report that is not currently available in IPCS
Perform analysis and enhance the report produced by IBM-supplied CBSTAT exit routines

CBSTAT exit routines do not format data areas or report on normal conditions.

This exit routine might process a dump for either:

Installation application storage
IBM® component data areas and storage

Before writing a CBSTAT exit routine, become familiar with the existing CBSTAT exit routines to avoid duplicating functions that are already available. IBM supplies CBSTAT exit routines for ASCBs and TCBs. CBSTAT exit routines for ASCBs generate status for the ASCB or address space. CBSTAT exit routines for TCBs generate status for the TCB or the task in general.

Define the CBSTAT exit routine in the BLSCUSER parmlib member with the following statement:

EXIT EP(epname[HBB7703]) CBSTAT(cbname)

epname is the name of the CBSTAT exit routine.

cbname is the name of the control block for which status is being obtained.

EP(epname,HBB7703) indicates that the CBSTAT routine will accept a BLSACBSP in 64-bit format. Exits written to accept the HBB7703 API that also need to run against dumps of earlier releases should check the format of the BLSACBSP structure passed. Ones solely designed to run on HBB7703 or higher levels may assume that the 64-bit format will be passed.

References

See the following:

z/OS MVS IPCS Commands for information about the CBSTAT exit routines supplied by IBM
z/OS MVS Initialization and Tuning Reference for information about the DATA statement in a BLSCUSER parmlib member