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 fullword containing the address of function code F‘32’.

Word 2

Is set to zero.

Word 3

Is the address of an eight-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 eight-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 and 01

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

Bytes 02 through nn

Specifies the error message text. Message text is converted to uppercase.

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 fullword 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 and 01

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

Bytes 02 through 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.