gtps1m1eSystem Macros

ADDLC-Add Block to the End of a Dispatch List

Use this system macro to add a block to the bottom of the specified system task dispatcher list.

Required Authorizations
Key0 Restricted System Common Storage

X

Format




BLOCK=R0|Rx
The register specified by this parameter contains the EVM address of the storage block to be added to the specified System Task Dispatcher list. If the parameter is omitted, the default assignment is R0.

The BLOCK and ADDRESS parameters are mutually exclusive.

ADDRESS=Rw
The register specified by this parameter contains the SVM address of the storage block to be added to the system task dispatcher specified by the LIST parameter. There is no default.

The BLOCK and ADDRESS parameters are mutually exclusive.

LIST=R1|Rx
The register specified on this input parameter contains a dispatch list equate value as defined in the CLHEQ macro. If the parameter is omitted, the default assignment is R1.

Valid equate values are:

#CLHRDY
Ready List

#CLHINP
Input List

#CLHDEF
Defer List

PIADDR=Rx
The register specified on this parameter contains the address of the postinterrupt routine to be given control when dispatched from the list. If the parameter is omitted, it is assumed that displacements 6-7 into the specified block will contain the postinterrupt address.

SAVREG
The specified volatile registers will be saved by the macro in the stack area or in the registers specified by the WKREG parameter. Up to 3 registers can be specified. Those registers are R0, R1, R2. If this keyword is omitted, none of the 3 registers will be saved. You should not save a volatile register if you expect it to contain an output parameter. The register will be overwritten with its original contents, since the reload is the last thing performed by the macro.

WKREG
The specified symbolic register names are free to be used by the macro to save the volatile registers coded on the SAVREG parameter. Up to 3 registers can be specified, but the standard linkage registers R13 through R2 cannot be used here. This parameter is used in conjunction with the SAVREG parameter to generate efficient code and enhance the performance of the macro. The number of registers specified by WKREG should be less than or equal to the number of registers specified by SAVREG. If this parameter is omitted or not used to its maximum capacity, code optimization is sacrificed.

DEBUG=NO|YES
This parameter is only valid on calls from the control program (CP). If coded as YES, the value of all macro parameters at the time of the macro call will be printed. This parameter is not for general use, and will not effect operation at processing time.

Entry Requirements

Return Conditions

Programming Considerations

Examples

None.