Use the TPPCC general macro with the FLUSH verb specified to allow the
application to transmit any data from the local LU's data buffer,
including an ATTACH from the ALLOCATE verb.
Format
- label
- A symbolic name can be assigned to the macro statement.
- FLUSH
- Directs the TPPCC macro to perform the FLUSH 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
returned. 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
- 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 FLUSH 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_SKFLUSH_BADSTATE
| ....
| 00000061
|
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 is useful for optimization of processing between the local and
remote transaction programs. The TPF/APPC support code buffers the
information from consecutive SEND_DATA verbs until it has a sufficient amount
of information for transmission. At that time, it transmits the
buffered data. However, the local TPF transaction program can issue the
FLUSH verb in order to cause the TPF/APPC support code to transmit any
buffered data. In this way, the local program can minimize the delay in
the remote transaction program's processing. The TPF/APPC support
code actually flushes the buffered data only when it has some data
buffered; if there is no data buffered, nothing is transmitted to the
remote LU. The buffer size is determined by the maximum request unit
(RU) size of the session, which is negotiated at BIND time.
- See Programming Considerations for the programming considerations relating to the TPPCC
macro in general.
Examples
SYMB100 TPPCC FLUSH, X
RESID=EBW004, X
RCODE=EBW010