OpenTP1 Version 7 TP1/Client User's Guide TP1/Client/W, TP1/Client/P

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

2.7 XATMI interface facility

An RPC can send and receive a limited length of data. Large data such as images may exceed the specified RPC data length. TP1/Client uses the interactive service, an XATMI interface facility, for sending and receiving data.

Communication by the interactive service divides large data into units called packets. Thus, the complete data is sent by sending these packets.

To start the interactive service communication, issue the tpalloc function to allocate typed buffer. When the buffer is allocated, issue the tpconnect function to establish connection the same way as for normal message exchange. Issue the tprecv function and tpsend function of the XATMI interface facility to send and receive messages. To terminate message exchange, issue the tpdiscon function to disconnect the connection, and then issue the tpfree function to release the typed buffer. A return value is sent if an error occurred during interactive service.

The interactive service communication is the only XATMI interface facility available for TP1/Client.

The following figure shows the process flow of communication by the XATMI interface facility interactive service.

Figure 2-32 Process flow of communication by interactive service

[Figure]

Organization of this section
2.7.1 Interactive service
2.7.2 Interactive service time monitoring
2.7.3 Receiving events
2.7.4 Communication data type
2.7.5 Notes on using the XATMI interface facility