The parameter list that is passed to the exit is mapped by macro
ICHCDXP and contains fields such as:
- Address of data area
- Address of profile length and name. If multiple profile names
are specified, the first one is passed to the exit, and the rest will
is available in the command buffer.
- Address of class name
- Address of TSO/E CPPL containing address of command
buffer, which contains:
- An image of the original command after parsing.
- Quoted text strings, such as values for the ADDUSER NAME keyword,
appear as entered.
Note: Quoted text strings might be longer than
allowed because of TSO parse processing. These strings are typically
truncated in the RACF® database.
- If the AT or ONLYAT keyword was specified, it does not appear
in the command buffer.
- The defaults for command keywords that have defaults and were
not specified on the original command.
- Any data that was provided by the prompting.
- Segment name
- Keyword name
- Flags
- A pointer to a 200 byte message area. If the exit fails the command
with a message, it can provide message text in this area to be inserted
into message IRR52217I. The exit should not change the pointer.
Note: Fields in the parameter list, and any values that it points
to should not be changed, except for the 200 byte message area.
Based on the information that is passed to it in the parameter
list, the exit routine can:
- Determine whether the keyword value is accepted or not, by setting
a return code in register 15, as described in Registers at exit.
- Determine whether RACF issues
message IRR52217I for a failed command, by setting a return code in
register 15, as described in Registers at exit.
The exit routine might provide text to be appended to message IRR52217I.