Use the modify form of the MCSOPMSG macro together with the list and execute forms of the macro for service routines that need to provide different options according to user-provided input. Use the list form to define a storage area; use the modify form to set the appropriate options; then use the execute form to call the service.
The modify form of the MCSOPMSG macro is written as follows:
| Syntax | Description |
|---|---|
| name | name: Symbol. Begin name in column 1. |
| ␢ | One or more blanks must precede MCSOPMSG. |
| MCSOPMSG | |
| ␢ | One or more blanks must follow MCSOPMSG. |
| REQUEST=GETMSG | See Table 1 for parameters valid with REQUEST services. |
| REQUEST=RESUME | |
| ,CMDRESP=NO | Default: CMDRESP=NO |
| ,CMDRESP=YES | |
| ,CART=cart addr | cart addr: RX-type address or register (2) - (12). |
| ,MASK=mask addr | mask addr: RX-type address or register (2) - (12). |
| ,NAME=console name addr | console name addr: RX-type address or register (2) - (12). |
| ,CONSID=console id addr | console id addr: RX-type address or register (2) - (12). |
| ,RTNCODE=return code addr | return code addr: RX-type address or register (2) - (12). |
| ,RSNCODE=reason code addr | reason code addr: RX-type address or register (2) - (12). |
| ,MF=(M,list addr,COMPLETE) | list addr: RX-type address or register (2) - (12). |
| ,MF=(M,list addr,NOCHECK) | Default: COMPLETE |
| Parameters | REQUEST=GETMSG | REQUEST=RESUME |
|---|---|---|
| CMDRESP | optional | not valid |
| CART | optional | not valid |
| MASK | optional | not valid |
| NAME | either NAME or CONSID (not both) | either NAME or CONSID (not both) |
| CONSID | either NAME or CONSID (not both) | either NAME or CONSID (not both) |
| RTNCODE | optional | optional |
| RSNCODE | optional | optional |
| MF | required | required |
The parameters are explained under the standard form of the macro with the following exception:
list addr specifies the area that the system uses to store the parameters.
COMPLETE, which is the default, specifies that the system is to check for required parameters and supply optional parameters that you did not specify.
NOCHECK specifies that the system does not check for required parameters and does not supply the optional parameters that you did not specify.