OpenTP1 Version 7 Programming Reference C Language

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

dc_mcf_reply - Send a response message

Format

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

Description

The function dc_mcf_reply() sends a logical message in response to other system. It sends a response to the logical terminal from which a message was received by the function dc_mcf_receive().

The function dc_mcf_reply() can be called only by MHPs whose application type is ans or cont.

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

The application which is under MCF control (MHP service function) allows the MCF to send a message after the function dc_mcf_reply() is issued to send the logical message to its end and the MHP terminates normally. In this way, message sending by the function dc_mcf_reply() is asynchronous with MHP processing.

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_reply() consists of the area used by the MCF and the area actually holding the message segment to be transmitted in response.

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.