Use the modify form of the HSPSERV 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 HSPSERV macro is written as follows:
| Syntax | Description |
|---|---|
| name | name: Symbol. Begin name in column 1. |
| ␢ | One or more blanks must precede HSPSERV. |
| HSPSERV | |
| ␢ | One or more blanks must follow HSPSERV. |
| SREAD | |
| SWRITE | |
| CREAD | |
| CWRITE | |
| ,STOKEN=stoken-addr | stoken-addr: RX-type address or register (2) - (12). |
| ,HSPALET=alet-addr | alet-addr: RX-type address or register (2) - (12). |
| ,NUMRANGE=1 | Default: NUMRANGE=1. |
| ,NUMRANGE=num-addr | num-addr: RX-type address or register (2) - (12). |
| ,RANGLIST=list-addr | list-addr: RX-type address or register (2) - (12). |
| ,RELEASE=NO | Default: RELEASE=NO. |
| ,RELEASE=YES | |
| ,ADDRSP=HOME | Default: ADDRSP=HOME. |
| ,ADDRSP=PRIMARY | |
| ,ADDRSP=COMMON | |
| ,KEEP=YES | Default: KEEP=YES. |
| ,KEEP=NO | |
| ,RETCODE=ret-addr | ret-addr: RX-type address or register (2) - (12). |
| ,RSNCODE=rsn-addr | rsn-addr: RX-type address or register (2) - (12). |
| ,MF=(E,list-addr,COMPLETE) | list-addr: RX-type address or register (2) - (12). |
| ,MF=(E,list-addr,NOCHECK) | Default: COMPLETE. |
Parameters for the modify form of HSPSERV are described in the standard form of the macro with the following exceptions:
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.