Parameters

The parameters are explained as follows:

,FUNCTION=CONTINUE

,FUNCTION=RETURN

Required input parameter that specifies where there may be one or more monitoring environments which represent current information about the work request. FUNCTION indicates further continuations, and does not deal with any parent environment that may exist.

Use FUNCTION=CONTINUE to indicate that the current monitoring environment continues elsewhere.

If you specify FUNCTION=CONTINUE, you cannot specify the MF keyword. With FUNCTION=CONTINUE, IWMMSWCH produces an inline expansion rather than an out-of-line service, so that you do not need a parameter list. Registers 0, 1, 14, and 15 are not preserved across the expansion.

Use FUNCTION=RETURN to indicate that continuations of the current monitoring environment have completed. Registers 0, 1, 14, and 15 are not preserved across the expansion.

,RUNTIME_VER=SHORT_FORM

,RUNTIME_VER=MINIMAL

Optional parameter that specifies what level of runtime verification will be performed.

RUNTIME_VER=SHORT_FORM indicates that checking should verify that a monitoring environment is established and passes a short form of verification prior to being used.

RUNTIME_VER=MINIMAL indicates that checking should assume that if a monitoring environment is created, it is valid and useable.

,WHERE=LOCALMVS

,WHERE=SYSPLEX

,WHERE=NETWORK

Required input parameter for FUNCTION=CONTINUE that specifies where there may be another monitoring environment.

Use WHERE=LOCALMVS to indicate that another monitoring environment may exist on the current MVS™.

Use WHERE=SYSPLEX to indicate that another monitoring environment may exist in the current sysplex, but is not expected to be on the current MVS image.

Use WHERE=NETWORK to indicate that another monitoring environment may exist, but is not expected to be in the current MVS sysplex.

,MONTKN=montkn

Required input parameter that specifies the monitoring token.

To code: Specify the RS-type name or address (using a register from 2 to 12) of a 32 bit field containing the monitoring token.

,COMPCODE=NO

,COMPCODE=YES

Optional input parameter that specifies whether you need completion status for IWMMSWCH.

COMPCODE=NO specifies that you do not need completion status. Registers 0, 15 cannot be used as reason code and return code registers upon completion of the macro expansion. If you specify COMPCODE=NO, you cannot specify RETCODE nor RSNCODE.

COMPCODE=YES specifies that you need completion status.

,RETCODE=retcode addr

Optional output parameter that specifies where the system is to store the return code. The return code is also in GPR 15.

To code: Specify the name (RS-type) or address (using a register from 2 to 12) of a fullword to contain the return code.

,RSNCODE=rsncode addr

Optional output parameter that specifies where the system is to store the reason code. The reason code is also in GPR 0.

To code: Specify the name (RS-type) or address (using a register from 2 to 12) of a fullword to contain the reason code (if any).

,MF=S

MF=(L,mfctrl,mfattr)

MF=(E,mfctrl,COMPLETE)

Use MF=S to specify the standard form, which places parameters into an inline parameter list and invokes the IWM4CON macro service.

Use MF=L to specify the list form of the macro. Use the list form together with the execute form of the macro for applications that require re-entrant code. The list form defines an area of storage that the execute form uses to store the parameters.

Use MF=E to specify the execute form of the macro. Use the execute form with the list form of the macro for applications that require re-entrant code. The execute form stores the parameters into the storage area defined by the list form and generates the macro invocation to transfer control to the service.

,mfctrl

Use this output parameter to specify the name of the storage area to contain the parameters.

To code: Specify the name (RS-type) or address (using a register from 2 to 12) of the storage area containing the parameter list.

,mfattr

Use this input parameter to specify the name of a 1 to 60 character storage area that can contain any value that is valid on an assembler DS pseudo-op. You can use this parameter to force boundary alignment of the parameter list. If you do not code ,mfattr the system provides a value of 0D, which forces the parameter on a doubleword boundary.

,COMPLETE

Use this input parameter to specify that the system check for required parameters and supply defaults for omitted optional parameter.