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
- The conversation can be in any state.
- See Entry Requirements for the entry requirements relating to the TPPCC macro in
general.
Return Conditions
- The results of the verb are indicated by the value returned in
RCODE. The valid return codes are listed in the following section,
"Return Codes".
- See Return Conditions for the return conditions relating to the TPPCC macro in
general.
- The following table contains a list of the primary and secondary return
codes that can be returned to the program that issued the GET_ATTRIBUTES
verb. A complete list of return codes and their definitions can be
found in Table 11 and in Table 12.
Symbolic Name
| Primary Code
| Secondary Code
|
LU62RC_OK
| 0000
|
|
LU62RC_PARAMETER_CHECK
| 0001
|
|
LU62RC_PK_BAD_TCBID
| ....
| 00000001
|
LU62RC_PK_BAD_CONVID
| ....
| 00000002
|
LU62RC_TPF_ABEND
| FFFF
|
|
Programming Considerations
- TPF does not support the other parameters defined by the LU 6.2
architecture for the GET_ATTRIBUTES verb.
- If you specify a register for a keyword value, the register must be
enclosed in parentheses and in the range R1-R7.
- The value supplied in RESID must be the resource ID returned by the
ALLOCATE verb or one that was assigned by an incoming ATTACH.
- You must specify at least one of the parameters OWNAME, PLUNAME, MODE, or
SYNC.
- See Programming Considerations for the programming considerations relating to the TPPCC
macro in general.
Examples
SYMB100 TPPCC GET_ATTRIBUTES, X
RESID=EBW004, X
RCODE=EBW064, X
OWNAME=(R4), X
PLUNAME=EBW036, X
MODE=EBW058, X
SYNC=EBW060