z/OS Security Server RACF System Programmer's Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Information passed in the parameter list

z/OS Security Server RACF System Programmer's Guide
SA23-2287-00

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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014