Previous Topic: Add User ID Parameter List

Next Topic: Data Set Authorization Exits Support


Delete User ID Parameter List

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

The diagram shows the parameter list for the Delete User ID call.

The contents of the parameter list are as follows:

Word 1

Is a fullword containing the address of function code F‘44’.

Word 2

Is set to zero.

Word 3

Is the address of an eight-character field, blank-padded, containing the user definition to delete.

Word 4

Is the address of three full words containing the session correlator and the user token (UTOKEN) associated with the user issuing the DELETE request.

Word 5

Is the address of an eight-character field containing the user ID of the user issuing the DELETE request.

Word 6

Is set to zero.

Word 7

Is set to zero.

Word 8

Is the address of an 82-character message area into which the exit can place any error message text if the delete request is denied or failed. Any text placed in this area is displayed to the user in response to the command that caused this request. If an error 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.

Limits: 80 characters

Message text is converted to uppercase.

Word 9

Is set to zero.

Word 10

Is set to zero.

Return Codes from the Delete User ID Call

The exit must return a completion code in Register 15 (R15) on return. Completion codes are supported as described below. Causes for delete rejection are identified by error message text returned in the area addressed by word 8 of the DELETE call parameter list.

The following return codes are the only codes that are accepted in response to a delete call. Any other return codes are regarded as a rejection of the delete call.

0

Indicates that Delete is complete.

4

Indicates that Delete is rejected. An error message might be available in the 80-character area addressed by word 8 of the parameter list.