Parameters

The parameters are explained as follows:

name

An optional symbol, starting in column 1, that is the name on the IWM4MABN macro invocation. The name must conform to the rules for an ordinary assembler language symbol.

ABNORMAL=abnormal

A required input parameter, which indicates the abnormal mask to use to reflect the abnormality. Macro IWMYCON contains the defined abnormal masks. The mask variable names begin with IWM4MABN, for example - IWMMABNL_SCOPE_LOCALMVS.

To code: Specify the RS-type address, or address in register (2)-(12), of a 32 bit field.

,MONENV=NOSWITCH

,MONENV=SECONDARY

A required parameter, which describes whether a space switch is needed to access the input monitoring environment.

,MONENV=NOSWITCH

indicates that NO space switch is needed to access the input monitoring environment. This would be appropriate if the input monitoring environment was established (by IWM4MCRE) to be used by routines in a specific system key or if it was established to be used in a specific user key in the current primary.

,MONENV=SECONDARY

indicates that the input monitoring environment was established in current secondary (for use by a specific user key).

,MONENVKEY=monenvkey

When MONENVKEYP=VALUE is specified, a required input parameter, which contains the key in which the input monitoring environment must be accessed. Use of this keyword value requires that the invoker be in supervisor state or that the caller have PKM authority to the key specified. The leftmost, i.e. high order, 4 bits contain the key value.

Note that this is different from the "natural" way of declaring the key, and uses the machine orientation for keeping the storage key in the high order bits.

To code: Specify the RS-type address, or address in register (2)-(12), of an 8 bit field.

,MONENVKEYP=VALUE

,MONENVKEYP=PSWKEY

,MONENVKEYP=UNKNOWN

A required parameter, which describes whether a key switch is needed to access the input monitoring environment.

,MONENVKEYP=VALUE

indicates that the key is being passed explicitly via MONENVKEY.

,MONENVKEYP=PSWKEY

indicates that the current PSW key should be used. Use of this keyword value requires that the input monitoring environment was established with the same key as the current PSW.

,MONENVKEYP=UNKNOWN

indicates that the key associated with the input monitoring environment is unknown. Use of this keyword value requires that the invoker be in supervisor state or that the caller have PKM authority to key 0.

,MONTKN=montkn

A required input parameter which contains the delay monitoring token for the environment affected by the abnormality.

To code: Specify the RS-type address, or address in register (2)-(12), of a 32 bit field.

,MONTKN64=montkn64

A required input parameter which contains the long delay monitoring token for the environment affected by the abnormality.

To code: Specify the RS-type address, or address in register (2)-(12), of a 64 bit field.

,RETCODE=retcode

An optional output parameter into which the return code is to be copied from GPR 15. If you specify 15, GPR15, REG15, or R15 (within or without parentheses), the value will be left in GPR 15.

To code: Specify the RS-type address of a fullword field, or register (2)-(12) or (15), (GPR15), (REG15), or (R15).

,RSNCODE=rsncode

An optional output parameter into which the reason code is to be copied from GPR 0. If you specify 0, 00, GPR0, GPR00, REG0, REG00, or R0 (within or without parentheses), the value will be left in GPR 0.

To code: Specify the RS-type address of a fullword field, or register (0) or (2)-(12), (00), (GPR0), (GPR00), REG0), (REG00), or (R0).