When the control block formatter service returns control to your
exit routine, IPCS sets register 15 to contain one of the following
return codes:
- Code
- Meaning
- 00
- The control block formatter service completed normally
- 04
- Attention: Check the following bit string flags in the ADPLPRET
field (within BLSABDPL) for additional diagnostic information:
- ADPLPRAC
- Control block acronym check failed
- ADPLPRNL
- Unable to load the control block formatting model
- ADPLPRNB
- Unable to access the control block
- ADPLPRNF
- Unable to format the control block
- ADPLPRTB
- Truncated control block
- ADPLPRNC
- The CBFORMAT service was unable to associate the data type specified
with any data type defined to IPCS. This may be the result of the
caller spelling the name incorrectly or may reflect the absence of
a definition. Definitions are supplied by DATA statements in BLSCECT,
BLSCUSER, or related parmlib members read at the start of the IPCS
session.
- ADPLPRNE
- The CBFORMAT service was able to associate the data type specified
with a defined data type, but neither formatter nor model is, in turn
associated with that data type.
- ADPLPRNG
- Storage not available for the CBAT
- ADPLPRUU
- Control block formatter previously marked unusable
- ADPLPRIM
- Incorrect control block formatting model
- ADPLPRCM
- Control block formatting model error
- ADPLPNVM
- No view match and therefore, no output
- ADPLPBXI
- Identifier on parameter list extension is bad
- ADPLPFEF
- Formatting exit failure
- ADPLPNXD
- No exit data
- 16
- The system stopped processing this service because of a lack of
sufficient storage for the CBAT
If the control block formatter service completed successfully,
your exit routine has a formatted control block.
Note: - This service changes the contents of fields ADPLPBAS (buffer address
in central storage) and ADPLPBLS (length of the block in central storage).
These two fields must be set by your exit routine, otherwise the
control block formatting service interprets the nonzero contents of
these fields to indicate that the control block is in a buffer.
- Some formatting programs must perform another dump access to get
extensions to the first control block, and in some environments, the
same buffer location is reused. The buffer might not contain an image
of the first control block. Therefore, your exit routine should do
its own dump access if it needs information out of a control block.