The requirements for the caller are:
Environmental factor | Requirement |
---|---|
Minimum authorization: | Problem state and any PSW key. |
Dispatchable unit mode: | Task |
Cross memory mode: | PASN=HASN=SASN |
AMODE: | 31-bit |
ASC mode: | Primary |
Interrupt status: | Enabled for I/O and external interrupts |
Locks: | No locks held. |
Control parameters: | Must be in the primary address space and addressable by the caller. |
Either link the calling program's object code with the linkable stub routine (IEACSS from SYS1.CSSLIB), or load the calling program and then call the service. The high-level language (HLL) definitions for the callable service are:
HLL Definition | Description |
---|---|
IEAASM | 390 Assembler declarations |
IEAC | C/390 and C++/390 declarations |
When the calling program specifies auth_level=IEA_UNAUTHORIZED, the caller must be in task mode and can only release another task in its home address space. All pause element tokens (PETs) used when auth_level=IEA_UNAUTHORIZED must have been obtained using an authorization level of IEA_UNAUTHORIZED.
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.
Syntax | Description |
---|---|
CALL IEAVAPE | |
The parameters are explained as follows:
Contains the return code from the Allocate_Pause_Element service.
Represents one or more possible levels of the pause element being allocated. The calling program can use the constants defined in IEAASM or IEAC, as appropriate. The level desired results from adding the values of the required types together. The authorization type is not optional.
For instance, the level to allocate authorized pause elements that are checkpoint/restart tolerant is IEA_AUTHORIZED + IEA_CHECKPOINTOK, or 3.
IEAASM and IEAC defined constants | Value (hexadecimal) | Meaning |
---|---|---|
IEA_UNAUTHORIZED | 0 | When using the allocated pause element through other services, either auth_level IEA_UNAUTHORIZED or IEA_AUTHORIZED can be used. |
IEA_AUTHORIZED | 1 | When using the allocated pause element through other services, auth_level=IEA_AUTHORIZED will be required. Caller must be both key 0 and supervisor state. |
IEAASM and IEAC defined constants | Value (hexadecimal) | Meaning |
---|---|---|
IEA_CHECKPOINTOK | 2 | The application can tolerate the pause elements' not being restored upon a restart after a checkpoint. |
Contains the pause element token that identifies the pause element which you can use to synchronize the processing of a task.
None.
When the service returns control to the resource manager, GPR 15 and return_code contain a hexadecimal return code.
Return code in: |
Meaning and Action |
---|---|
00 (0) IEA_SUCCESS |
Meaning: Successful completion. Action: None. |
24 (18) IEA_LOCK_HELD |
Meaning: Program error.
If the auth_level indicates AUTHORIZED, locks other than the local
lock are held. If the auth_level indicates UNAUTHORIZED, locks are
held. The system rejects the service call. Action: Check the calling program for a probable coding error. Correct the program and rerun it. |
36 (24) IEA_UNSUPPORTED_MVS_RELEASE |
Meaning: Environmental error.
The system release does not support this service. The system rejects
the service call. Action: Run the program on a system that supports the service. |
40 (28) IEA_PE_NOT_HOME |
Meaning: Program error.
The auth_level value specified in the call 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. |
44 (2C) IEA_XFER_TO_SELF |
Meaning: Program error.
The calling program is not in primary ASC mode, which this service
requires. The system rejects the service call. Action: Check the calling program for a probable coding error. Correct the program and rerun it. |
48 (30) IEA_XFER_FAILED |
Meaning: Environmental error.
The system could not obtain storage for a pause element. The system
rejects the service call. Action: Retry the request later. If the problem persists, consult your system programmer. |
56 (38) IEA_NO_PETS_AVAILABLE |
Meaning: There are no pause
element tokens available. Action: Retry the request later. |
4095 (FFF) IEA_UNEXPECTED_ERROR |
Meaning: This service routine
encountered an unexpected error. The system rejects this service
request. Action: Contact IBM® support. |