Delete_Post_Sync_PET (ATRDPSP2, ATR4DPSP)

ATRDPSP2 is for AMODE(31) callers.
ATR4DPSP is for AMODE(64) callers and allows parameters in 64 bit addressable storage.

A work manager calls the Delete_Post_Sync_PET service to inform RRS that it no longer needs to know about syncpoint completion through a pause element token (PET) set by the Set_Post_Sync_PET service.

Environment

The requirements for the caller are:

Minimum authorization:

None

Dispatchable unit mode:

Task or SRB

Cross memory mode:

Any PASN, any HASN, any SASN

AMODE:

31 bit (ATRDPSP2)
64 bit (ATR4DPSP)

ASC mode:

Primary or access register (AR)

Interrupt status:

Enabled for I/O and external interrupts

Locks:

No locks held

Control parameters:

Control parameters must be in the primary address space and addressable by the caller.

Linkage:

MVS™ standard linkage conventions are used.

Programming requirements

Either link edit your object code with the linkable stub routine ATRRCSS (31 bit) or ATRR4CSS (64 bit) from SYS1.CSSLIB, or LOAD and CALL the callable service. The high level language (HLL) definitions for the callable service are:

HLL definition	Description
ATRRASM	390 Assembler declarations
ATRRC	C/390 declarations

Restrictions

For the call, the UR state must be in-reset or in-flight.

When the resource manager issues the call in SRB mode, the call cannot specify a ur_token of 0, indicating information for the current UR.

Input register information

Before issuing the call, the caller does not have to place any information into any register unless using it in register notation for the parameters, or using it as a base register.

Output register information

When control returns to the caller, the GPRs contain:

Register: Contents
0-1: Used as work registers by the system
2-13: Unchanged
14: Used as a work register by the system
15: Return code

When control returns to the caller, the ARs contain:

Register: Contents
0-1: Used as work registers by the system
2-13: Unchanged
14-15: Used as work registers by the system

Some callers depend on register contents remaining the same before and after issuing a call. If the system changes the contents of registers on which the caller depends, the caller must save them before calling the service, and restore them after the system returns control.

Performance implications

None.

Syntax

Write the call as shown in the syntax diagram. You must code the parameters in the CALL statement as shown.

CALL ATRDPSP2

(return_code
,UR_token
,pause_element_token)

CALL ATR4DPSP

(return_code
,UR_token
,pause_element_token)

Parameters

The parameters are explained as follows:

return_code

Returned parameter

Type: Integer
Character Set: N/A
Length: 4 bytes

Contains the return code from the Delete_Post_Sync_PET service.

,UR_token

Supplied parameter

Type: Character string
Character Set: No restriction
Length: 16 bytes

Specifies the token of the UR to which the PET specified by pause_element_token is associated:

0: Binary zero specifies the current UR associated with the application's task.
token: The UR token of a particular UR.

,pause_element_token

Supplied parameter

Type: Character string
Character Set: No restriction
Length: 16 bytes

Specifies the pause element token to be disassociated from the UR specified by the UR_token.

ABEND codes

The call might result in an abend X'5C4' with a reason code of either X'00210000' or X'00210001'. See z/OS MVS System Codes for the explanations and actions.

Return codes

When the service returns control to the resource manager, GPR 15 and return_code contain a hexadecimal return code.

Return Code in: Hexadecimal Equate Symbol	Meaning and action
0 ATR_OK	Meaning: Successful completion. Action: None.
103 ATR_INTERRUPT_STATUS_INV	Meaning: Program error. The calling program is disabled; the interrupt status must be enabled for I/O and external interrupts. The system rejects the service call. Action: Check the calling program for a probable coding error. Correct the calling program and rerun it.
104 ATR_MODE_INV	Meaning: Program error. The calling program specified 0 in UR_token, indicating the context associated with the current UR, but the calling program is not in task mode. The system rejects the service call. Action: Check the calling program for a probable coding error. Correct the calling program and rerun it.
105 ATR_LOCKS_HELD	Meaning: Program error. The calling program is holding one or more locks; no locks must be held. The system rejects the service call. Action: Check the calling program for a probable coding error. Correct the calling program and rerun it.
107 ATR_UNSUPPORTED_RELEASE	Meaning: Environmental error. The system release does not support this service. The system rejects the service call. Action: Remove the resource manager from the system, and install it on a system that is running a version of RRS that supports this service call. Then rerun the resource manager.
3A3 ATR_UR_TOKEN_INV	Meaning: Program error. The UR token specified in the UR_token parameter is not valid. The system rejects the service call. Action: Check the calling program for a probable coding error. Correct the program and rerun it.
3A6 ATR_PET_INV	Meaning: Program error. The pause element token specified in the pause_element_token parameter is not valid. The system rejects the service call. Action: Check the calling program for a probable coding error. Correct the program and rerun it.
3A7 ATR_PET_OUTDATED	Meaning: Program error. The pause element token specified in the pause_element_token parameter is outdated. The system rejects the service call. Action: Check the calling program for a probable coding error. Correct the program and rerun it.
3A8 ATR_PET_AUTH_FAILURE	Meaning: Program error. The pause element token specified in the pause_element_token parameter was allocated with auth_level=IEA_AUTHORIZED, and the caller is unauthorized. The system rejects the service call. Action: Check the calling program for a probable coding error. Correct the program and rerun it.
3A9 ATR_PET_SPACE_FAILURE	Meaning: Program error. The pause element token specified in the pause_element_token parameter represents a pause element belonging to another address space, and the caller is unauthorized. The system rejects the service call. Action: Check the calling program for a probable coding error. Correct the program and rerun it.
3AA ATR_PET_NOT_ASSOCIATED	Meaning: Program error. The pause element token specified in the pause_element_token parameter does not represent a pause element associated with the specified UR. The system rejects the service call. Action: Check the calling program for a probable coding error. Correct the program and rerun it.
731 ATR_UR_STATE_ERROR	Meaning: Program error. The UR specified by the UR_token is not in a valid state for the service call. The UR must be in an in-reset or in-flight state. The system rejects the service call. Action: Check the resource manager for a probable coding error. Correct the resource manager and rerun it.
F00 ATR_NOT_AVAILABLE	Meaning: RRS is not available. Action: The system rejects the service request. Retry the request later. Before retrying the request, the resource manager must reset its RRS exit routine information and begin restart processing with RRS.
F06 ATR_WAS_NOT_AVAILABLE	Meaning: RRS was available to the resource manager, but went down and came back up again. A commit or backout operation may or may not have been in progress for the context under which the Delete_Post_Sync_PET was done at the time of the RRS failure. A new unit of recovery can not be created until the current unit of recovery is completed. Action: The system rejects the service request. Restart your resource manager, making sure to reset the resource manager's exit routines with RRS. The resource manager must inform the application that one of the following actions must be taken to complete the current unit of recovery: If a commit or backout request was not active at the time of the RRS failure, a commit or backout must be requested before a new unit of recovery can begin. If a commit or backout request was active at the time of the RRS failure, the context must be ended, via the CTXENDC service, before a new unit of recovery can begin.
FFF ATR_UNEXPECTED_ERROR	Meaning: System error. The service that was called encountered an unexpected error. The system rejects the service call. Action: Search problem reporting databases for a fix for the problem. If no fix exists, contact the IBM® Support Center.

Example

In the pseudocode example, the calling program attempts to disassociate a UR from its pause element token. Storage for the call parameters has already been allocated.

⋮
CALL ATRDPSP2(RC, URTOKEN, PETOKEN)

⋮