gtpg2m4mGeneral Macros

TPPCC GET_ATTRIBUTES

Use the TPPCC general macro with the GET_ATTRIBUTES verb specified to return information pertaining to a conversation.

Format




label
A symbolic name can be assigned to the macro statement.

GET_ATTRIBUTES
Directs the TPPCC macro to perform the GET_ATTRIBUTES verb function.

RESID
Specifies the symbolic name of a field or a register that points to a field. This is a 4-byte field in which the resource ID is supplied. This resource ID must be the one assigned on the initial ALLOCATE for this conversation or one that was assigned by an incoming ATTACH.

RCODE
Specifies the symbolic name of a field or a register that points to a field. This is a 6-byte field in which the return code is placed. The return code consists of a 2-byte primary return code followed by a 4-byte secondary return code. The actual values returned are listed in Return Conditions.

OWNAME
Specifies the symbolic name of a field or a register that points to a field. The field is a 16-byte field in which the network name of the local TPF LU is returned. The first 8 bytes contain the left-justified network name, which is padded with blanks, or all blanks if the LU name is unqualified. The second 8 bytes contain the left-justified LU name, which is padded with blanks.

PLUNAME
Specifies the symbolic name of a field or a register that points to a field. This is a 16-byte field in which the network name of the partner (remote) LU is returned. The first 8 bytes contain the left-justified network name, which is padded with blanks, or all blanks if the LU name is unqualified. The second 8 bytes contain the left-justified partner LU name, which is padded with blanks. This returned LU name is the name of the LU in which the remote transaction program is located.

MODE
Specifies the symbolic name of a field or a register that points to a field. This is an 8-byte field in which the mode name of the conversation is returned.

SYNC
Specifies the symbolic name of a field or a register that points to a field. This is a 1-byte field in which a value is returned that indicates the synchronization level of this conversation. The possible values are:

LU62_SYNCLVL_NONE
Specifies synchronization is not allowed on this conversation.

LU62_SYNCLVL_CONFIRM
Specifies CONFIRM synchronization is allowed on this conversation.

TPF does not support the SYNCPT level defined by the LU 6.2 architecture.

Entry Requirements

Return Conditions

Programming Considerations

Examples

SYMB100   TPPCC GET_ATTRIBUTES,                    X
                RESID=EBW004,                      X
                RCODE=EBW064,                      X
                OWNAME=(R4),                       X
                PLUNAME=EBW036,                    X
                MODE=EBW058,                       X
                SYNC=EBW060