Share this page

# lrt_tpbroadcast

Communication Functions

Broadcasts notification by name.

int lrt_tpbroadcast( char *lmid, char *usernam e, char *cltname, char *data, long len, long flags );

lmid | Target client id.
username | User name.
cltname | Client name.
data | Data to send with the broadcast.
length | Length of data.
flags | Valid flags: TPNOBLOCK - Request not sent if blocking condition exists. TPNOTIME - Caller immune to blocking timeouts. TPSIGRSTRT - Any interrupted system calls are re-issued afterlrt_tpbroadcast.

The lrt_tpbroadcast function allows a client or server to send unsolicited messages to registered clients within the system.

## Return Values

If the function ends with an error, it returns -1 and sets the error code in tperrno.

## Parameterization

The following argument(s) can be parameterized using standard parameterization: lmid, username, cltname

## Example

The following example uses lrt_tpbroadcast to notify user Smith that a fatal error occurred.

Copy code

    char* data_0;
    data_0 = lrt_tpalloc("STRING", "", 1024);
    strcpy(data_0, "Fatal error!");
    lrt_tpbroadcast("SITE1", "Smith", "bankapp", data_0, 0, 0);

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: