11.2.3 XATMI receive data file

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

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 type368Buffer 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 string to be passed to the tprecv function:
0x00000000​L
0
0x00000001​L
TPEV_DISCONIMM
0x00000002​L
TPEV_SVCERR
0x00000004​L
TPEV_SVCFAIL
0x00000008​L
TPEV_SVCSUCC
0x00000020​L
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