User ID Security Exit Support › &SECCALL EXIT Parameter List

&SECCALL EXIT Parameter List

On entry to the security exit, Register 1 points to a list of ten full words, as shown in this diagram.

The contents of the parameter list are as follows:

• Word 1

  Is a full word containing the address of function code F'32'.

• Word 2

  Is set to zero.

• Word 3

  Is the address of an 8-character field, blank-padded, containing the user ID executing the procedure in which &SECCALL EXIT was issued. If &SECCALL EXIT was issued from an EASINET procedure, this word is set to zero.

• Word 4

  Is the address of three full words containing the session correlator and the user token (UTOKEN) associated with the user issuing the &SECCALL EXIT statement. If no user ID is involved because the &SECCALL EXIT statement has been issued from an EASINET procedure, this word is set to zero.

• Word 5

  Is the address of 8-character terminal name.

• Word 6

  Is set to zero.

• Word 7

  Is set to zero.

• Word 8

  Is the address of an 82-character area into which the exit can place any message text. If a message is placed in this area it is returned to the issuing NCL procedure in the system variable &SYSMSG. If a message is returned in this area it must be formatted as follows:

  • Bytes 00 to 01

    Specifies the hexadecimal length of the message text (excluding these two bytes).

  • Bytes 02 to nn

    Specifies the error message text. Message text is converted to upper case.

    Limits: 80 characters

• Word 9

  Is set to zero.

• Word 10

  Is the address of a variable length list of contiguous full words, ended by a full word containing a value of X'FFFFFFFF'. Each word in the list points at an area that represents an NCL variable, where the format of this area is always:

  • Bytes 00 to 01

    Specifies the length of parameter data present (excluding these two length bytes).

  • Bytes 02 to 257

    Specifies the parameter data, padded to 256 bytes with blanks.

Return Codes from &SECCALL EXIT Call

The exit can pass information back to the calling NCL procedure in the following ways:

• A return code can be set by the exit in Register 15 on exit. Valid return codes are 0 to 99. Any other return code is forced to 99. The return code is available to the procedure in the system variable &RETCODE after the &SECCALL EXIT statement.
• A message (error or otherwise) can be returned in the 82-character message area addressed by word 8 of the parameter list, as described above.
• Information can be returned in the parameter areas addressed by word 10 of the &SECCALL EXIT parameter list. The exit can return information only in those areas originally passed in the parameter list.