Description

The LOADWAIT macro can:

z/OS MVS Programming: Authorized Assembler Services Guide describes how to use the LOADWAIT macro.

The WSPARM parameter of the WTO macro contains the name of the parameter list that you build using the LOADWAIT macro. WTO uses the parameter list from LOADWAIT to put the system into the wait state and issues one message to the operator. The wait state code and operator message explain what action the operator is to take. For more information about wait state codes, see z/OS MVS System Codes.

There is a list and modify form of the macro, but no standard form.

Environment

The requirements for the caller are:

Environmental factor Requirement
Minimum authorization: Supervisor state and PSW key 0, or APF-authorized
Dispatchable unit mode: Task or SRB
Cross memory mode: PASN=HASN=SASN or PASN¬=HASN¬=SASN
AMODE: 24- or 31-bit
ASC mode: Primary
Interrupt Status: Enabled or disabled for I/O and external interrupts
Locks: No requirement
Control parameters: No requirement

Programming requirements

None.

Restrictions

The LOADWAIT parameter list and action code receiving byte, if specified, must be in fixed storage of the WTO issuer’s address space.

Register information

After the caller issues the macro, the system might use some registers as work registers or might change the contents of some registers. When the system returns control to the caller, the contents of these registers are not the same as they were before the macro was issued. Therefore, if the caller depends on these registers containing the same value before and after issuing the macro, the caller must save these registers before issuing the macro and restore them after the system returns control.

When control returns to the caller after the caller has issued the modify form of the macro, the general purpose registers contain:
Register
Contents
0
Address of the action code variable if specified.
1
Address of parameter list.
2-15
Unchanged

Performance implications

None.