Call the IEANTDL service to delete a name/token pair.
The requirements for the caller are:
Environmental factor | Requirement |
---|---|
Minimum authorization: | Problem state and any PSW key Note: Problem-state
programs with PSW key 8 - 15 cannot delete name/token pairs created
by supervisor-state or PSW key 0 - 7 programs.
|
Dispatchable unit mode: | Task |
Cross memory mode: | Any PASN, any HASN, any SASN |
AMODE: | 31-bit |
ASC mode: | Primary or access register (AR) |
Interrupt status: | Enabled for I/O and external interrupts |
Locks: | No locks held |
Control parameters: | The parameter list and all parameters must reside in the caller's primary address space. |
* Name/Token Level Constants
*
IEANT_TASK_LEVEL EQU 1
IEANT_HOME_LEVEL EQU 2
IEANT_PRIMARY_LEVEL EQU 3
IEANT_SYSTEM_LEVEL EQU 4
IEANT_TASKAUTH_LEVEL EQU 11
IEANT_HOMEAUTH_LEVEL EQU 12
IEANT_PRIMARYAUTH_LEVEL EQU 13
*
* Name/Token Persistence Constants
*
IEANT_NOPERSIST EQU 0
IEANT_PERSIST EQU 1
*
* Name/Token Return Code Constants
*
IEANT_OK EQU 0
IEANT_DUP_NAME EQU 4
IEANT_NOT_FOUND EQU 4
IEANT_24BITMODE EQU 8
IEANT_NOT_AUTH EQU 16
IEANT_SRB_MODE EQU 20
IEANT_LOCK_HELD EQU 24
IEANT_LEVEL_INVALID EQU 28
IEANT_NAME_INVALID EQU 32
IEANT_PERSIST_INVALID EQU 36
IEANT_AR_INVALID EQU 40
IEANT_UNEXPECTED_ERR EQU 64
None.
Before issuing the IEANTDL callable service, the caller does not have to place any information into any register unless using it in register notation for a particular parameter, or using it as a base register.
Some callers depend on register contents remaining the same before and after issuing a service. If the system changes the contents of registers on which the caller depends, the caller must save them before issuing the service, and restore them after the system returns control.
None.
Write the call as shown on the syntax diagram. You must code all parameters on the CALL statement in the order shown.
Syntax | Description |
---|---|
CALL IEANTDL | |
1. LOAD EP=IEANTDL
Save the entry point address
...
Put the saved entry point address into R15
CALL (15),(...)
2. L 15,X'10'
L 15,X'220'(15,0)
L 15,X'14'(15,0)
L 15,X'0C'(15,0)
CALL (15),(...)
This second technique requires AMODE=31, and, before the CALL is issued, verification that the IEANTDL service is supported by the system (in the CVT, both the CVTOSEXT and the CVTOS390 bits are set on).
The parameters are explained as follows:
The caller might encounter abend X'AC7' with a reason code of either X'00030000' or X'00030001'. See z/OS MVS System Codes for an explanation and responses to these codes.
When IEANTDL returns control to your program, GPR 15 and return_code contain a return code. The following table identifies return codes in hexadecimal and decimal, tells what each means, and recommends an action that you should take:
Hexadecimal Return Code | Decimal Return Code | Meaning and Action |
---|---|---|
00 | 0 | Meaning: The operation was
successful. Action: None. |
04 | 4 | Meaning: The request is
rejected because the system could not find the requested name/token
pair. Action: Check the user_name you specified. |
08 | 8 | Meaning: The request is
rejected because the caller is in 24-bit addressing mode. Action: Change your program to 31-bit addressing mode. |
10 | 16 | Meaning: An unauthorized
caller attempted to delete a system-level name/token pair or a name/token
pair created by an authorized program. Action: Check which level of name/token pair you are deleting. |
18 | 24 | Meaning: The caller held
locks. Action: Release all locks before issuing IEANTDL. |
1C | 28 | Meaning: The caller specified
an incorrect level. Action: Respecify the correct level. Valid values are 1, 2, or 3. |
20 | 32 | Meaning: The caller specified
an incorrect user_name. Action: Respecify the correct user_name. |
28 | 40 | Meaning: The caller was
in AR ASC mode and AR1 was not zero. Action: Change your program to primary mode or make sure the parameter list is in the primary address space. |
40 | 64 | Meaning: A system error
occurred while handling the request. Action: Retry the request. |
For a complete example of creating, retrieving, and deleting a task-level name/token pair, see the IEANTCR callable service.