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

(2) File contents

Item	Position	Length (bytes)	Contents
Common area	0	36	Area shared with the XATMI send data file. Specify a space or null character.
Buffer type	36	8	Buffer type, specified as one of the following character strings: X_OCTET X_COMMON X_C_TYPE
Buffer subtype	44	16	Buffer subtype, specified as a string of up to 16 characters. Specify a null character when specifying X_OCTET as the buffer type.
Event flag	60	4	One of the following hexadecimal values as the string to be passed to the tprecv function: 0x00000000L 0 0x00000001L TPEV_DISCONIMM 0x00000002L TPEV_SVCERR 0x00000004L TPEV_SVCFAIL 0x00000008L TPEV_SVCSUCC 0x00000020L TPEV_SENDONLY
Data length	64	4	Length 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.
Data	68	n	Data to be passed to the tprecv function

(3) Notes

The items in the XATMI receive data file are related to the arguments of the message receive function (tprecv function) as follows:
tprecv(.....,data,len,.....,revent) 1. 2. 3.
1. Data stored in the buffer allocated by buffer type and subtype
2. Data length
3. Event flag
XATMI receive data files for the online tester cannot be used.
Do not use a plus sign (+) in the file name. Also, do not use ps or end as the file name.
An error occurs when the specified data is less than the specified data length. Data that exceeds the data length is truncated.
Create the receive data in execution units. If the tprecv function is executed more than once in a service, create all the data required for the number of executions. If the tprecv function is executed more times than the number of data items, the system assumes that data from the tpreturn function was received and an error occurs at each execution that exceeds the number of data items.
The XATMI receive data file opens and closes by service unit.
When the buffer type and subtype are specified, the values specified for the data length and data must be the same as the data structure value defined for the stubs.
Boundary alignment is performed for the data structure specified for the stubs (the total length is an integer multiple of 4). For this reason, the user must consider the alignment portion when creating an XATMI receive data file.

11.2.3 XATMI receive data file

(1) File structure

(2) File contents

(3) Notes