gtpg2m4hGeneral Macros

TPPCC ALLOCATE

Use the TPPCC general macro with the ALLOCATE verb specified to allocate a conversation between a TPF transaction program and a transaction program in a remote LU. A resource ID is assigned to the conversation and returned by this macro.

Format




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

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

LUNAME
Specifies the symbolic name of a field or a register pointing to a field. This is a 16-byte field that contains the network name of the remote LU or local secondary LU (SLU) thread with which this local transaction program wants to start a conversation. 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.

TPN
Specifies either the symbolic name of a field or a register pointing to a field that contains the following:

RCONTROL
Specifies when control is returned to the issuer. The allowed values are:

WSA
Specifies that control is returned when a session is allocated for this conversation.

IMM
Specifies to allocate a session for the conversation if a session is immediately available. A session is immediately available when it is active, it is not allocated to another conversation, and the local LU is the contention winner for the session.

Note:
TPF does not support the other options defined for this parameter by the LU 6.2 architecture.

MODE
Specifies the name used to designate the properties of the session to be allocated. It can be specified as a symbolic name of a field or a register, which points to a field that contains the 8-character mode name (padded on the right with blanks if necessary).
Note:
If you do not specify MODE, it defaults to the single session mode name. The single session mode name is defined with the SINGMODE parameter on the SNAKEY macro. See TPF ACF/SNA Network Generation for more information about the SNAKEY macro.

TYPE
Specifies the type of conversation. The allowed values are:

BASIC
Provides support for the BASIC_CONVERSATION option defined by the LU 6.2 architecture. This is the default.

MAPPED
Provides support for the MAPPED_CONVERSATION option defined by the LU 6.2 architecture.
Note:
TPF/APPC supports mapped conversations through the C language only. See TPF C/C++ Language Support User's Guide for information on the mapped conversation verbs.

SHAREDB
Provides support for the BASIC_CONVERSATION option defined by the LU 6.2 architecture, and specifies that this is a shared LU 6.2 conversation.

SHAREDM
Provides support for the MAPPED_CONVERSATION option defined by the LU 6.2 architecture, and specifies that this is a shared LU 6.2 conversation.
Note:
TPF/APPC supports mapped conversations through the C language only. See TPF C/C++ Language Support User's Guide for information on the mapped conversation verbs.

PIP
NO is the only allowable value. PIP (program initialization parameter) data cannot be supplied by the TPF transaction program. If PIP data is indicated in an ATTACH header received by TPF, the ATTACH conversation request is rejected.

SYNC
Specifies the synchronization level allowed on this conversation. The allowed values are:

NONE
Specifies that the programs cannot perform confirmation processing on this conversation. This is the default value.

CONFIRM
Specifies that the programs can perform confirmation processing on this conversation.

Note:
TPF does not support the LU 6.2 architecture's SYNCPT option.

SECURITY
Specifies the security level allowed on this conversation. NONE is the only allowed value. (For migration purposes, NONE can be abbreviated as NO.) TPF does not support the options SAME and PGM defined by the LU 6.2 architecture.

RESID
Specifies either 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 returned. This resource ID must be specified on all subsequent verbs for this conversation.

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.

Entry Requirements

See Entry Requirements for the entry requirements relating to the TPPCC macro in general.

Return Conditions

Programming Considerations

Examples

SYMB100   TPPCC ALLOCATE,                          X
                LUNAME=EBX024,                     X
                TPN=EBX000,                        X
                RCONTROL=WSA,                      X
                MODE=(R3)                          X
                TYPE=BASIC,                        X
                PIP=NO,                            X
                SYNC=NONE,                         X
                SECURITY=NONE,                     X
                RESID=(R7),                        X
                RCODE=EBW010