In addition to the input considerations described in Conditions on Entry to an IPCS Exit Routine, the following special input considerations
apply to CBSTAT exit routines.
On entry to a CBSTAT exit routine, register 1 points to a parameter
list that contains the addresses of the following:
- The exit parameter list (data area ABDPL)
- The CBSTAT parameter list CBSP (mapped by mapping macro BLSACBSP)
The CBSTAT parameter list contains the following information that
is useful for a CBSTAT exit routine:
- Field
- Description
- CBSPAS
- Address space description (see mapping macro BLSRDATS within BLSACBSP).
- CBSPIDL
- Whether the ABITS=31 or ABITS=64 format pf BLSACBSP has been
passed to the CBSTAT exit. The ABITS=64 format will always be used
by IPCS in Release 10 when HBB7703 exits are given control. The ABITS=31
format is always used otherwise.
- CBSPAS2
- Fullword containing the ASID.
- CBSPLAD
- Virtual address of the data area being processed.
- CBSPD
- Data description (see mapping macro BLSRDATC within BLSACBSP).
- CBSPDLE
- Length of the data area.
If the data area length was not provided
as input to the CB status service and IPCS does not recognize the
structure type, the length of the data area will take the default
length specified on the SETDEF subcommand. This will generate a situation
where the entire data area might not be contained in the buffer being
passed to the CB status exit routine. CB status exit routines for
data areas that are not known to IPCS must check the CBSPDLE field
to determine if the entire data area is contained in the passed buffer.
If the passed length is too short, the CB status exit routine must
do a dump access for the correct length, in order to view the entire
data area.
- CBSPDTD
- The name of the data area being processed (for example, ASCB).
- CBSPBFAD
- Address of a buffer containing the data area being processed.
For prefixed data areas, the passed buffer will contain the prefix
and the main body of the data area. The address placed in CBSPBFAD
will point to the start of the main body of the data area.
Reference
See z/OS MVS™ Data Areas in the z/OS® Internet Library: &zosliburl; for information about the
BLSABDPL and BLSACBSP mapping macros.