3.3.1 Service request data files

Organization of this subsection
(1) RPC request data file
(2) XATMI request data file

(1) RPC request data file

An RPC request data file stores the data passed to the service function for the service specified by the utosppsvc command when using the client UAP simulator with an RPC interface. A single file contains one set of data.

(a) File structure

[Figure]

(b) File contents
ItemPositionLength (bytes)Contents
Data length04Length of the data to be passed to the service function. (1 to specified value of DCRPC_MAX_MESSAGE_SIZE)
Response area length44Length of the response area to be passed to the service function. (1 to specified value of DCRPC_MAX_MESSAGE_SIZE)
Data8nData to be passed to the service function.
(c) Notes

(2) XATMI request data file

An XATMI request data file stores the data passed to the service function for a requested service when using the client UAP simulator with an XATMI interface. A single file contains one set of data.

(a) File structure

[Figure]

(b) File contents
ItemPositionLength (bytes)Contents
Call type08Type of function calling a service:
call
call from tpcall function
acall
call from tpacall function
connect
call from tpconnect function
Buffer type88Buffer type, specified as one of the following character strings:
  • X_OCTET
  • X_COMMON
  • X_C_TYPE
Buffer subtype1616Buffer subtype, specified as a string of up to 16 characters. Specify a null character when specifying X_OCTET as the buffer type.
Flags324Flags to be passed to the service function, specified as a hexadecimal and restricted by the specified call type:
0x00000000​
0 (for call and acall only)
0x00000004​
TPNOREPLY (for acall only)
0x00000008​
TPNOTRAN
0x00000100​
TPNOCHANGE (for call and acall only)
0x00000800​
TPSENDONLY (for connect only)
0x00001000​
TPRECVONLY (for connect only)
TPNOTIME and TPSIGRSTRT are always set at service requests. TPNOBLOCK is not set.
Data length364Length of the data to be passed to the service function (0-524288).
Specify zero when no data is passed. The buffer type and subtype specifications are ignored when zero is specified.
Data40nData to be passed to the service function
(c) Notes