Parameter Descriptions

The parameter descriptions are listed in alphabetical order. Default values are underlined:

MEMTOKEN=memtoken

Use this input parameter to specify the 64-bit token of the member. XCF provided this token when it placed the member in the active state.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of an 8-byte field that contains the member token.

,MF=S

,MF=(L,mfctrl)

,MF=(L,mfctrl,mfattr)

,MF=(L,mfctrl,0D)

,MF=(E,mfctrl)

,MF=(E,mfctrl,COMPLETE)

Use MF=S to specify the standard form of the macro, which builds an inline parameter list and generates the macro invocation to transfer control to the 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 reentrant code. The list form defines an area of storage that the execute form uses to store the parameters. Only the PLISTVER parameter can be coded with the list form of the macro.

Use MF=E to specify the execute form of the macro. Use the execute form together with the list form of the macro for applications that require reentrant 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 a storage area to contain the parameters.
To Code: Specify the RS-type name or address (using a register from 2 to 12) of the parameter list.
,mfattr: Use this input parameter to specify the name of a 1- to 60-character string 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 list to a doubleword boundary.
,COMPLETE: Use this input parameter to require that the system check for required parameters and supply defaults for omitted optional parameters.
Note: In the macro expansion you might see some defaults for optional parameters that are not documented here. The ones that are not documented do not have any effect on the macro. For example, if SMILE=var were an optional parameter and the default is SMILE=NO_SMILE then it would not be documented. However, if the default was SMILE=:-), then it would be documented because a value would be the default.

,RETCODE=retcode

Use this output parameter to specify the location in which the system is to copy the return code from GPR 15.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of a 4-byte field that will contain the return code when the quiesce requests completes.

,RSNCODE=rsncode

Use this output parameter to specify the location in which the system is to copy the reason code from GPR 0.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of a 4-byte field that will contain the reason code (if any) when the quiesce request completes.

,USLEN=uslen

Use this input parameter to specify the length in bytes of the user state data that you provide on the USTATE parameter. The length must be from 1 to 32 bytes. XCF overlays any previous value in the user state field up to the length you specify on USLEN. XCF does not pad the remainder of the user state field (up to 32 bytes) with zeros. IXCQUERY always returns the full 32 bytes, and group user-routines always receive the full 32 bytes. If you code USTATE, USLEN is required.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of a 4-byte field that contains the length of the user state data (USTATE).

,USTATE=NO_USTATE

,USTATE=ustate

Use this input parameter to specify the area containing data that you want XCF to place in the user state field associated with the member. Use the USLEN parameter to specify the length of the user state data.

If you do not specify USTATE, or if you specify USTATE=NO_USTATE, the user state field remains unchanged.

To Code: Specify the RS-type name or address (using a register from 2 to 12) of the area (with a length of USLEN) that contains the user state information.