OpenTP1 Version 7 Tester and UAP Trace User's Guide

[Contents][Index][Back][Next]

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
Item Position Length (bytes) Contents
Data length 0 4 Length of the data to be returned to the UAP making the service request. (0-2147483647)
Data 4 n Data 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
Item Position Length (bytes) Contents
Buffer type 0 8 Buffer type, specified as one of the following character strings:
  • X_OCTET
  • X_COMMON
  • X_C_TYPE
Buffer subtype 8 16 Buffer subtype, specified as a string of up to 16 characters. Specify a null character when specifying X_OCTET as the buffer type.
Service termination code 24 4 One of the following hexadecimal values of rval in the tpreturn function. The value is set in the tperrno area.

0x04000000L
TPSUCCESS

0x20000000L
TPFAIL
Return code 28 4 Hexadecimal value of rcode in the tpreturn function. The value is set in the tpurcode area.
Data length 32 4 Length 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.
Data 36 n Data 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
Item Position Length (bytes) Contents
System area 0 12 Area used by the offline tester. Do not use this area.
Data length 12 4 Total 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 value 16 m Return 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.
Data 16+m n Argument 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