Use the TPPCC general macro with the CONFIRM verb specified to send a
confirmation request to the remote transaction program and wait for the
confirmation reply. This allows the 2 programs to synchronize their
processing.
Format
- label
- A symbolic name can be assigned to the macro statement.
- CONFIRM
- Directs the TPPCC macro to perform the CONFIRM 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.
- RTSRCVD
- Specifies the symbolic name of a 1-byte field or a register that contains
a value that indicates whether REQUEST_TO_SEND has been received. If a
REQUEST_TO_SEND has been received, the value is LU62_RTSND_RCVDYES.
Entry Requirements
- The conversation must be in send 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 CONFIRM 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_STATE_CHECK
| 0002
|
|
LU62RC_SKCNFRM_BADSTATE
| ....
| 00000032
|
LU62RC_SKCNFRM_INVALID
| ....
| 00000033
|
LU62RC_ALLOC_ERROR
| 0003
|
|
LU62RC_TP_NOT_AVAIL_RETRY
| ....
| 084B6031
|
LU62RC_TP_NOT_AVAIL_NO_RETRY
| ....
| 084C0000
|
LU62RC_TPN_NOT_RECOGNIZED
| ....
| 10086021
|
LU62RC_PIP_NOT_SPECIFIED_CORRECTLY
| ....
| 10086032
|
LU62RC_CONV_TYPE_MISMATCH
| ....
| 10086034
|
LU62RC_SYNLVL_NOTSUPORT
| ....
| 10086041
|
LU62RC_DLLOC_ABEND_PGM
| 0006
|
|
LU62RC_DLLOC_ABEND_SVC
| 0007
|
|
LU62RC_DLLOC_ABEND_TMR
| 0008
|
|
LU62RC_PGMERR_PURGING
| 000E
|
|
LU62RC_CONVFAIL_RETRY
| 000F
|
|
LU62RC_CONVFAIL_NORETRY
| 0010
|
|
LU62RC_SVCERR_PURGING
| 0013
|
|
LU62RC_TPF_ABEND
| FFFF
|
|
Programming Considerations
- 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.
- This verb uses TPF's EVENT and POST facility to suspend the ECB until
the program receives a confirmation reply. Since the ECB is suspended,
all unnecessary resources should be released before this verb is
issued. Failure to do so can cause serious system performance
degradation.
- Note:
- You can avoid the problem of suspended ECBs by using the
ACTIVATE_ON_CONFIRMATION verb instead of CONFIRM. See TPPCC ACTIVATE_ON_CONFIRMATION for more information.
- If the program does not receive a confirmation reply within a certain
amount of time, the TPF/APPC support issues a DEALLOCATE TYPE=ABEND to
terminate the conversation. The amount of time that the system waits is
determined by the value you specify for the TPRECV parameter on the SNAKEY
macro. See the TPF ACF/SNA Network Generation
for information about the SNAKEY macro.
- When the value of the RTSRCVD parameter is LU62_RTSND_RCVDYES, the remote
program is requesting the local TPF transaction program to enter
receive state and thereby place the remote program in
send state. The local TPF transaction program enters
receive state by issuing a RECEIVE verb or a PREPARE_TO_RECEIVE
verb. The remote partner program enters the corresponding
send state when it issues a RECEIVE verb and receives the SEND
indicator on the WHATRCV parameter.
- If RCODE is LU62RC_PGMERR_PURGING or LU62RC_SVCERR_PURGING, the
conversation enters receive state.
- See Programming Considerations for the programming considerations relating to the TPPCC
macro in general.
Examples
SYMB100 TPPCC CONFIRM, X
RESID=EBW004, X
RCODE=EBW010, X
RTSRCVD=EBW016