The TEST option of the ESPIE macro determines the active SPIE/ESPIE environment and returns the information in a 4-byte parameter list.
Before issuing the TEST 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.
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.
The TEST 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. |
TEST | |
,parm addr | parm addr: RX-type address, or register (1) or (2) - (12). |
The parameters are explained as follows:
ESPIE TEST returns status information about the current ESPIE environment in GPR 15. When control returns from ESPIE TEST, GPR 15 contains one of the following hexadecimal return codes.
Hexadecimal Return Code | Meaning |
---|---|
00 | Meaning: An ESPIE exit is active and the 4-word parameter list contains the information specified in the description of the parm addr parameter. |
04 | Meaning: A SPIE exit is active. Word 1 of the parameter list described under parm addr contains the address of the current PICA. Words 0, 2, and 3 of the parameter list contain no relevant information. |
08 | Meaning: No SPIE or ESPIE is active. The contents of the 4-word parameter list contain no relevant information. |
ESPIE TEST,PARMLIST