Share this page

# lrt_tpconnect

Communication Functions

Establishes a conversational service connection.

int lrt_tpconnect( char *svc, char *data, long len, long flags );

svc | Conversational service name. Must be one of the names posted by the conversational server.
data | Pointer to a buffer containing application-defined data to send to the listening program.
len | Length of the data.
flags | Valid flags: TPNOTRAN- SVC will not be performed on behalf of caller's transaction, TPSENDONLY - caller wants only to send data, TPRECVONLY - caller wants only to receive data, TPNOBLOCK - request not sent if blocking condition exists, TPNOTIME - caller immune to blocking timeouts, TPSIGRSTRT - any interrupted system calls are re-issued after lrt_tpconnect.

The lrt_tpconnect function establishes a half-duplex conversational service connection.

## Return Values

If the function succeeds, it returns a descriptor that is used for referring to the connection in subsequent calls. Otherwise, it returns -1 and sets tperrno to indicate the error condition.

## Parameterization

The following argument(s) can be parameterized using standard parameterization: svc

## Example

In the following example, the lrt_tpconnect function establishes a conversational service connection, cd.

Copy code

    char* data_0;
    char* data_1;
    int cd;
    lrt_tpconnect("AUDITC", NULL, 0, TPSENDONLY);
    data_0 = lrt_tpalloc("STRING", "", 80);
    lrt_strcpy(data_0, "t"); // get teller balances for bank app
    data_1 = lrt_tpalloc("STRING", "", 1024);
    lrt_tpsend(cd,data_0,0,TPRECVONLY,&revent);
    lrt_tprecv(cd,&data_1,&olen,TPNOCHANGE,&revent);
    lrt_strcpy(data_0, "a"); // get account balances for bank app
    lrt_tpsend(cd,data_0,0,TPRECVONLY,&revent);
    lrt_tprecv(cd,&data_1,&olen,TPNOCHANGE,&revent);
    lrt_tpdiscon(cd);
    // take down conversational client connection
    // can't call lrt_tpsend or lrt_tprecv on this connection any more.

Tips to improve your search results... VuGen Function Reference Version 26.1-26.3 Function Reference 26.1-26.3 All View Local Help Center View Online Help Center Version: