Use this system macro to return to the caller the number of blocks
currently queued on the specified system task dispatcher list.
Required Authorizations
|
Key0
| Restricted
| System
| Common Storage
|
X
| X
|
|
|
Format
- ISN=Rx
- The register specified on this input parameter contains the I-stream
number for the CPU whose system task dispatcher list is to be queried.
If this parameter is omitted, the I-stream that the request is issued on will
be queried.
- LIST=R0|Rx
- The register specified on this input parameter contains a list equate
value. Equate values are assigned to the cross, ready, input, and defer
lists. If the parameter is left out, the default assignment is
R0. Valid equate values are:
- #CLHCRS
- Cross List
- #CLHRDY
- Ready List
- #CLHINP
- Input List
- #CLHDEF
- Defer List
- 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.
Entry Requirements
If the macro is coded in a real-time segment, R9 must contain the address
of the ECB being processed.
Return Conditions
- Control is returned to the next sequential instruction (NSI).
- The register used on the LIST parameter will contain the number of blocks
found on the specified system task dispatcher list. When invoked from a
real-time segment, all other user registers are preserved across this macro
call. When invoked from the control program (CP), the registers
specified on the WKREG parameter will be used to save the contents of any
volatile registers specified on the SAVREG parameter. All other
registers will be returned intact.
- The condition code is not saved across this macro call.
Programming Considerations
- This macro can be run on any I-stream.
- If LOCK=YES and the specified program is file resident, then the program
remains in storage until the RELPC macro is issued.
- NUMLC can be used either by realtime programs or by the control
program. It is a restricted use macro and requires KEY0 authorization
when used by a realtime program.
- The WKREG and SAVREG parameters are used only on macro invocations from
the control program (CP). These parameters have no effect on the macro
expansions in real-time programs.
Examples
None.