OpenTP1 Version 7 Programming Reference C Language

[Contents][Index][Back][Next]

dc_mcf_sendsync - Send a synchronous message

Format

For details on the format, see the explanation in the applicable OpenTP1 Protocol manual.

Description

The function dc_mcf_sendsync() sends a logical message to other system, during the processing of an active UAP. Once the function dc_mcf_sendsync() is called by a UAP, it waits until the message is written in the output queue and is completely sent to the logical terminal designated in the function. In this way, the sending of a logical message is synchronized with the call of the function dc_mcf_sendsync() from the UAP.

The function sends a segment of a logical message. If the logical message consists of one segment, the function dc_mcf_sendsync() must be called only once. If the logical message consists of multiple segments, the function dc_mcf_sendsync() must be called as many times as the segments to send the logical message.

The maximum length of a single message segment that can be sent is 32 kilobytes. Note that the actual value might be smaller depending on the protocol. For details, see the applicable OpenTP1 Protocol manual.

The MCF area which holds the segment to be sent by the function dc_mcf_sendsync() consists of the area used by the MCF and the area actually holding the message segment to be sent.

The values to be specified for the arguments and the return values vary with the communication protocol in use. For details, see the applicable OpenTP1 Protocol manual.