11.2.1 Service request data files

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

(1) RPC request data file

An RPC request data file stores the data passed to the service function for a service requested 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.
(0 - specified value of DCRPC_MAX_MESSAGE_SIZE)
Response area length44Length of the response area to be passed to the service function. (1 - 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.
0x00000000​L
0
0x00000004​L
TPNOREPLY
0x00000008​L
TPNOTRAN
0x00000100​L
TPNOCHANGE
0x00000800​L
TPSENDONLY
0x00001000​L
TPRECVONLY
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

(3) TxRPC request data file

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

(a) File structure

[Figure]

(b) File contents
ItemPositionLength (bytes)Contents
Major version02Major version number specified in the interface definition of the txidl command. Specify zero to omit this specification.
Minor version22Minor version number specified in the interface definition of the txidl command. Specify zero to omit this specification.
Data length44Length of the data to be specified for a data part (0 to specified value of DCRPC_MAX_MESSAGE_SIZE - 16).
Data8nArgument data to be passed to the service function. When setting an address in the argument, set the contents of the area indicated by the address.
Set character string #NULL## if the address is null.
(c) Notes