3.3.3 XATMI receive data file

An XATMI receive data file stores the messages received by the UAP in the tprecv function when making the conversational service paradigm. A single file can contain a number of data items which are passed consecutively to the tprecv function.

Create an XATMI receive data file for each service.

Organization of this subsection
(1) File structure
(2) File contents
(3) Notes

(1) File structure

[Figure]

(2) File contents

ItemPositionLength (bytes)Contents
Common area036Area shared with the XATMI send data file. Specify a space or null character.
Buffer type368
  • Buffer type, specified as one of the following character strings:
  • X_OCTET
  • X_COMMON
  • X_C_TYPE
Buffer subtype4416Buffer subtype, specified as a string of up to 16 characters. Specify a null character when specifying X_OCTET as the buffer type.
Event flag604One of the following hexadecimal values as the event flag to be passed to the tprecv function:
0x00000000​
0
0x00000001​
TPEV_DISCONIMM
0x00000002​
TPEV_SVCERR
0x00000004​
TPEV_SVCFAIL
0x00000008​
TPEV_SVCSUCC
0x00000020​
TPEV_SENDONLY
Data length644Length of the data to be passed to the tprecv function (0-524288).
Specify zero when no data is passed. The buffer type and subtype specifications are ignored when zero is specified.
Data68nData to be passed to the tprecv function

(3) Notes