RESET option

z/OS MVS Programming: Assembler Services Reference ABE-HSP

RESET option

z/OS MVS Programming: Assembler Services Reference ABE-HSP
SA23-1369-00

The RESET option of the ESPIE macro cancels the current SPIE/ESPIE environment and re-establishes the previously active SPIE/ESPIE environment identified by the token specified.

Input register information

Before issuing the RESET option of the ESPIE macro, 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.

Output register information

When control returns to the caller, the general purpose registers (GPRs) contain:

Register: Contents
0: Used as a work register by the system
1: Token identifying the new active SPIE/ESPIE environment
2-13: Unchanged
14: Used as a work register by the system
15: Return code of 0

When control returns to the caller, the access registers (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 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.

Syntax

The RESET option of the ESPIE macro is written as follows:

Syntax	Description

`name`	`name`: Symbol. Begin `name` in column 1.

␢	One or more blanks must precede ESPIE.

ESPIE

␢	One or more blanks must follow ESPIE.


RESET

,`token`	`token`: RX-type address, or register (1), (2) - (12).

Parameters

The parameters are explained as follows:

RESET: Indicates that the current ESPIE environment is to be deleted and the previously active SPIE/ESPIE environment specified by token is to be reestablished.
,token: Specifies a fullword that contains a token representing the previously active SPIE/ESPIE environment. This is the same token that ESPIE processing returned to the caller when the ESPIE environment was established using the SET option of the ESPIE macro.
If the token is zero, all SPIEs and ESPIEs are deleted.

Return and reason codes

None.

Example

Cancel the current SPIE/ESPIE environment and restore the SPIE/ESPIE environment represented by the contents of TOKEN.

ESPIE RESET,TOKEN