OpenTP1 Version 7 Programming Reference C Language

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

dc_mcf_recvsync - Receive a synchronous message

Format

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

Description

The function dc_mcf_recvsync() receives a logical message from other system during the processing of an active UAP. When the function dc_mcf_recvsync() is called by a UAP, it searches the input queue for a message sent from the logical terminal name specified in it and receives the message. If there is not such a message, the function waits until an appropriate message arrives. In this way, the reception of a logical message is synchronized with the call of the function dc_mcf_recvsync() from the UAP.

The function receives a segment of a logical message. If the logical message consists of one segment, the function dc_mcf_recvsync() must be issued only once. If the logical message consists of multiple segments, the function dc_mcf_recvsync() must be called as many times as the segments to receive the logical message.

The maximum length of a single segment that can be received is 1 megabyte. 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 received by the function dc_mcf_recvsync() consists of the area used by the MCF and the area actually holding the received message segment.

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.