|
|
TPACALL(3cbl)
Name
TPACALL() - routine to send a message to a service asynchronously
Synopsis
01 TPSVCDEF-REC.
COPY TPSVCDEF.
01 TPTYPE-REC.
COPY TPTYPE.
01 DATA-REC.
COPY User data.
01 TPSTATUS-REC.
COPY TPSTATUS.
CALL "TPACALL" USING TPSVCDEF-REC TPTYPE-REC DATA-REC TPSTATUS-REC.
Description
TPACALL() sends a request message to the service named by SERVICE-NAME IN TPSVCDEF-REC. The request is sent out at the priority defined for SERVICE-NAME unless overridden by a previous call to TPSPRIO(). DATA-REC is a message to be sent and LEN IN TPTYPE-REC specifies the amount of data in DATA-REC that should be sent. Note that if DATA-REC is a record of a type that does not require a length to be specified, then LEN is ignored (and may be 0). If REC-TYPE IN TPTYPE-REC is SPACES, DATA-REC and LEN are ignored and a request is sent with no data portion. If REC-TYPE is STRING and LEN is 0, then the request is sent with no data portion. The REC-TYPE and SUB-TYPE of DATA-REC must match one of the REC-TYPE and SUB-TYPEs recognized by SERVICE-NAME. Note that for each request sent while in transaction mode, a corresponding reply must ultimately be received.
The following is a list of valid settings in TPSVCDEF-REC.
Return Values
Upon successful completion, TPACALL() sets TP-STATUS to [TPOK]. In addition, if TPREPLY was set in TPSVCDEF-REC, then TPCALL() returns a valid communications handle in COMM-HANDLE that can be used to receive the reply of the request sent.
Errors
Under the following conditions, TPACALL() fails and sets TP-STATUS to (unless otherwise noted, failure does not affect the caller's transaction, if one exists):
See Also
TPCALL(3cbl), TPCANCEL(3cbl), TPGETRPLY(3cbl), TPGPRIO(3cbl), TPSPRIO(3cbl)
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|