gtps1m4rSystem Macros

RVTCC-Search RVT Entries

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

Return Conditions

Programming Considerations

Examples

None.