Use this system macro to compute the RVT1 or SCB1 address, the RVT2 or SCB2
address, and the resource identifier (RID) or SCBID for the next or previous
resource in the hierarchy of the network configuration.
- Note:
- If you specify an SCB1 or SCB2 address, this address must reference a session
control block (SCB) that is anchored off an entry in the resource vector table
(RVT).
Required Authorizations
|
Key0
| Restricted
| System
| Common Storage
|
| X
|
|
|
Format
- EOT=eot
- This parameter specifies that a branch is to be taken to the label
eot if the input or stepped entry is the delimiting entry of the
table.
- EOTR=Rv
- This parameter specifies that a branch is to be taken to the address
specified in register Rv if the input or stepped entry is the
delimiting entry of the table.
- IN1=Rx
- This indicates that the address passed in register Rx as input to
the macro is an RVT1 or SCB1 address. If it is an SCB1 address, it must
reference an SCB that is anchored to the RVT.
- IN2=Rx
- This indicates that the address passed in register Rx as input to
the macro is an RVT2 or SCB2 address. If it is an SCB2 address, it must
reference an SCB that is anchored to the RVT.
- STEP
- This parameter specifies which resource in the table is to be
retrieved.
- NEXT
- The next resource in the table is to be retrieved.
- PREV
- The previous resource in the table is to be retrieved.
- ARG
- This parameter can be used to key the searching on a particular RVT entry
value.
- CDRM
- When STEP=NEXT, the entry of the next resource owned by the CDRM is
retrieved. When STEP=PREV, the entry for the CDRM is retrieved.
- CCW
- When STEP=NEXT, the entry for the next resource whose session runs through
the ALS/NCP/CTC is retrieved. When STEP=PREV, the entry for the
ALS/NCP/CTC is retrieved.
- LOCAL
- When STEP=NEXT, the entry of the next local resource is retrieved.
When STEP=PREV, the entry for the local SSCP is retrieved, with one
exception: if the input entry is an SLU thread, the entry of the
application PLU is retrieved.
If you do not specify the ARG parameter, the next (previous) resource of
any type is retrieved.
- RVT1=Rz
- Register Rz contains the RVT1 or SCB1 address for the stepped
resource on return.
- RVT2=Ry
- Register Ry contains the RVT2 or SCB2 address for the stepped
resource on return.
- RID=Rw
- Register Rw contains the RID or SCBID of the stepped resource on
return.
- SCBIND=Rv
- Register Rv contains an indicator of whether the values returned
through RVT1, RVT2, and RID reference an RVT or an SCB. If they refer
to an SCB, Rv contains one (X'00000001'); if they refer
to an RVT, Rv contains zero.
Entry Requirements
- The input register specified by IN1 or IN2 must contain a valid RVT1 (or
SCB1) or RVT2 (or SCB2) address, respectively.
- Operands specifying input registers can use R0 through R7, R14, or
R15.
Return Conditions
- The registers specified in the macro call are set appropriately.
- Processing continues following the macro expansion, unless a delimiting
entry is found. In that case, a branch is taken to the label specified
by the EOT parameter or to the address in the register specified by the EOTR
parameter.
- Delimiting entries are detected under the following conditions:
- For all entry conditions:
- When the entry retrieved is the first entry in the table
- When the entry retrieved is the end of table entry.
- For STEP=NEXT and any ARG settings:
- When the input entry is either the last RVT (if there are no SCBs anchored
off it) or the last SCB in the chain anchored off the last RVT.
- For STEP=PREV and any ARG settings:
- When the input RVT entry is the first entry in the table.
- For STEP=PREV and ARG=CDRM:
- When the entry for the CDRM cannot be found.
- For STEP=PREV and ARG=CCW:
- When the entry for the ALS/NCP/CTC cannot be found.
- For STEP=PREV and ARG=LOCAL:
- When the entry for the local SSCP cannot be found
- When the entry for the application PLU cannot be found.
- The contents of registers R14, R15, and R0 through R7 are unchanged,
except as requested by the macro call.
Programming Considerations
- This macro is for use by systems programs only.
- At assembly time the macro call is checked for:
- A STEP parameter that is not valid or is missing
- A ARG parameter that is not valid
- A IN1 or IN2 parameter that is not valid or is missing
- A EOT or EOTR label that is not valid or is missing.
- The registers specified by RVT1, RVT2, and RID are checked for
validity.
Examples
None.