11.2.2 Service response data files

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

(1) RPC response data file

When using the server UAP simulator with an RPC interface, the RPC response data file stores the response data returned to the client UAP when a service request is made to the simulate SPP. 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 returned to the UAP making the service request. (0-2147483647​)
Data4nData to be returned to the UAP making the service request.
(c) Notes

(2) XATMI response data file

When using the server UAP simulator with an XATMI interface, the XATMI response data file stores the response data returned to the client UAP when a service request is made to the simulate SPP. A single file contains one set of data.

(a) File structure

[Figure]

(b) File contents
ItemPositionLength (bytes)Contents
Buffer type08Buffer type, specified as one of the following character strings:
  • X_OCTET
  • X_COMMON
  • X_C_TYPE
Buffer subtype816Buffer subtype, specified as a string of up to 16 characters. Specify a null character when specifying X_OCTET as the buffer type.
Service termination code244One of the following hexadecimal values of rval in the tpreturn function. The value is set in the tperrno area.
0x04000000​L
TPSUCCESS
0x20000000​L
TPFAIL
Return code284Hexadecimal value of rcode in the tpreturn function. The value is set in the tpurcode area.
Data length324Length of the data to be returned to the UAP making a service request. (0-524288)
Specify zero when no data is passed. The buffer type and subtype specifications are ignored when zero is specified.
Data36nData to be returned to the UAP making the service request.
(c) Notes

(3) TxRPC response data file

When using the server UAP simulator with a TxRPC interface, the TxRPC response data file stores the response data returned to the client UAP when a service request is made to the simulate SPP. A single file contains one set of data.

(a) File structure

[Figure]

(b) File contents
ItemPositionLength (bytes)Contents
System area012Area used by the offline tester. Do not use this area.
Data length124Total length of the data to be specified for a data part and of the return value (0 to specified value of DCRPC_MAX_MESSAGE_SIZE - 16).
Return value16mReturn value of the service function. The data type and size are specified in the interface definition of the txidl command. Do not specify a return value for the void type service function.
Data16+mnArgument data to be returned to the client. Specify an argument for which the out attribute is specified in the parameter declaration of the interface definition of the txidl command. 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