gtpg2m3mGeneral Macros

RIDCC-RID Conversion

This general macro checks the correctness of resource IDs (RIDs), resource vector table addresses (RVT1s and RVT2s), pseudo-LNIATAs, network addresses, and session control block IDs (SCBIDs), and session control block addresses (SCB1s and SCB2s), and converts them to other formats.

Format




SVC=YES
Specify one of the following:

YES
Indicates that the macro is serviced by an SVC. The data is returned in an area pointed to by R15.
Note:
One return area for each I-stream is allocated in the CP. The returned data should be saved by the calling segment before issuing any macro that could cause it to give up control; once control has passed to another ECB, the contents of the return area are unpredictable.

NO
Indicates the macro is be serviced inline. The entry parameter is expected to be either an RID or an SCBID. The data is returned in the indicated registers.

CODE
This parameter determines the type of input that is to be supplied to the routine.

RID
Given an RID, check its correctness and calculate its SAT, RVT1, RVT2, pseudo-LNIATA, and network address. If the input is an SCBID, compute SCB1 and SCB2 instead of RVT1 and RVT2.

RVT1
Given an RVT1 address, check its correctness and calculate its RID, SAT, RVT2, pseudo-LNIATA, and network addresses. If the input is an SCB1, compute SCBID and SCB2 instead of RID and RVT2.

RVT2
Given an RVT2 address, check its correctness and calculate its RID, SAT, RVT1, pseudo-LNIATA, and network addresses. If the input is an SCB2, compute SCBID and SCB1 instead of RID and RVT1.

PLIT
Given a pseudo-LNIATA, check its correctness and calculate its RID and its SAT, RVT1, RVT2, and network addresses.

NETA
Given a network address, check its correctness and calculate its RID or SCBID and its SAT, RVT1 or SCB1, RVT2 or SCB2, and pseudo-LNIATA addresses. Byte 1 of R15 contains the subarea and bytes 2-3 contain the element.

RVT1=Rx
A register (R0-R7) that receives the RVT1 address. If the input parameter is an SCBID, Rx receives the SCB1 address.

RVT2=Ry
A register (R0-R7) that receives the RVT2 address. If the input parameter is an SCBID, Ry receives the SCB2 address.

SAT=Rz
A register (R0-R7) that receives the SAT address.

Entry Requirements

R15 must contain an appropriate entry parameter to be validated and converted.

Return Conditions

Programming Considerations

Register R9 must contain the address of the ECB if the SVC=YES option is selected.

Examples

None.