gtpg2m4sGeneral Macros

TPPCC SEND_DATA

Use the TPPCC general macro with the SEND_DATA verb specified to send data to the remote transaction program. The data sent consists of logical records.

Format




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

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

RESID
Specifies the symbolic name of a field or a register pointing 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.

DATA
Specifies the symbolic name of a field or a register pointing to a field from which the data is to be sent.

LENGTH
Specifies the symbolic name of a field or a register pointing to a field. This is a 2-byte field that contains the length of the data to be sent. The value can be from 0 to 32767. This data length is not related in any way to the length of a logical record. It is used only to determine the length of the data located at the address specified by the DATA parameter.
Note:
If the DATA and LENGTH parameters are omitted, the data is assumed to be on data level 0 in AM0SG format. See the programming considerations for an explanation of the record format.

RCODE
Specifies the symbolic name of a field or a register pointing 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 the indicates whether a REQUEST_TO_SEND has been received. The REQUEST_TO_SEND_RECEIVED indication can contain:

LU62_RTSND_RCVDYES
Indicates a REQUEST_TO_SEND indication has been received from the remote transaction program. The remote program issued REQUEST_TO_SEND requesting the local TPF transaction program to enter receive state and placing the remote transaction program in send state.

Any other value indicates that a REQUEST_TO_SEND notification has not been received.

Entry Requirements

Return Conditions

Programming Considerations

Examples

SYMB100   TPPCC SEND_DATA,                         X
                RESID=(R6),                        X
                DATA=(R3),                         X
                LENGTH=(R2),                       X
                RCODE=EBW064,                      X
                RTSRCVD=EBSW01

Footnotes:

6
The AM0CCT field is equal to the actual text count in this block plus 5, which is the length of the AM0SG filler. Thus the physical length of data in a block is (AM0CCT - 5).