Parameter Descriptions
- ,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.
- RECOVERYSITE=sitename
- Use this input parameter to specify the name of the site being
used as the recovery site. The name must be 8 characters long, padded
on the right with blanks. The name must be 'SITE1 '
or 'SITE2 '.
To Code: Specify the RS-type name or address (using a register from 2 to 12) of an 8-byte field that contains the name of the site being used as the recovery site.
- REQUEST=RMACTIVE
- REQUEST=RMINACTIVE
- Use this input parameter to specify what information the requestor
wants.
- RMACTIVE
- Informs XCF that the recovery manager is currently active. The
name of the site being used as the recovery site must be supplied.
CFRM will use this information to enhance "duplexing failover" decisions
to keep the structure instance at the recovery site for potential
site failures.
Use this request to inform XCF that the recovery manager has become active, or to inform XCF that the currently active recovery manager has changed the recovery site.
- RMINACTIVE
- Informs XCF that the recovery manager is currently inactive. CFRM will no longer use the recovery site information when making "duplexing failover" decisions.
- ,RETCODE=retcode
- Use this output parameter to specify a field to contain the return
code. (The return code is also returned in register 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 request has completed.
- ,RSNCODE=rsncode
- Use this output parameter to specify a field to contain the reason
code returned, if applicable. (The reason code is also returned in
register 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 request has completed.