Parameters

TYPE=

ON: Specifies that you want to wait for one of the ECF bits indicated by the mask to be turned on.
OFF: Specifies that you want to wait for all of the ECF bits indicated by the mask to be turned off.

ECFMASK=

Specifies a one-byte mask indicating which bits in the ECF are to be waited on. This parameter can be specified as a decimal value, a hex value, a symbol, or as a register. If a decimal value (nnn) is specified, it must be a value less than 256. If a hex expression is used, the mask must be specified in the form X'hh'. If a symbol is used, it must be equated to a one-byte ECF mask value. The symbol is not the address of the ECF mask. If a register is specified, the register must contain the one-byte mask value. The remainder of the register must be zero. If R1, R14 or R15 are used, the input value will be changed on return from the macro.

ECFADD=

Specifies the address of the one-byte ECF to be waited on. If coded, then the ECFMASK parameter must also be coded. ECFADD cannot specify the same register as ECFMASK.

ECFLIST=

Specifies the address of an event completion (ECF) list. The list contains one or more two-word entries plus a one-word list terminator. For each entry, the first word contains the 31-bit address of the ECF and the second word contains the ECF mask in the low-order byte. The other three bytes must be zero. The list terminator is a fullword of binary ones.

DATA=

Specifies 1 to 16 bytes of data associated with the AWAIT. For example, if you want to wait for a read I/O request to complete for the JST, you can specify DATA='JST'.

You specify the DATA= keyword as follows:

DATA=label: The data is at the location identified by "label". The length of the data is the length of the filed "label".
DATA='string': The data is the specified character string. The character string should not contain imbedded quotation marks or ampersands.
DATA=((register),len): The data is pointed to by the specified register. The length of the data is specified by the second subparameter.
DATA=((register),INREG): The data is contained within the register. The length of the data is assumed to be four bytes.

REASON=

Specifies the reason why the FCT is waiting. The reason codes are documented in z/OS JES3 Diagnosis Reference. If you want to add a new reason code, then use the IATYAWR macro to make the update.

Note: ECFMASK cannot specify register 0. Both ECFADD and ECFLIST cannot specify register 1. REASON cannot specify register 0 or register 1. All other registers are allowed.