gtpg2m4tGeneral Macros

TPPCC SEND_ERROR

Use the TPPCC general macro with the SEND_ERROR verb specified to inform the remote program that the local TPF transaction program detected an error.

Upon successful completion of this verb, the local TPF transaction program is in send state, and the remote program is in receive state. The transaction program's logic defines any further action.

Format




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

SEND_ERROR
Directs the TPPCC macro to perform the SEND_ERROR 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.

TYPE
Specifies the type of error indication to be sent. The valid types are:

PROG
Specifies that the TPF transaction program detected an error that is to be reported to the remote transaction program.

SVC
Specifies that a TPF service program detected an error that is to be reported to the remote LU service program.

LOGDATA
Specifies whether the error indication is logged. NO is the only supported option. TPF does not support the YES option defined by the LU 6.2 architecture.

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 that indicates whether a REQUEST_TO_SEND has been received. The REQUEST_TO_SEND_RECEIVED indication can contain:

LU62_RTSEND_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_ERROR,                        X
                RESID=(R3),                        X
                TYPE=PROG,                         X
                LOGDATA=NO,                        X
                RCODE=EBW064,                      X
                RTSRCVD=EBSW01