utoxsppsvc [-f send/receive-control-file-name] service-name typed-buffer-definition-file-name XATMI-request-data-file-name [XATMI-response-data-file-name]

Requests an XATMI interface SPP to execute a specified service. A command error occurs if the utoxsppsvc command is executed for a UAP other than an SPP that uses XATMI.

This command cannot be used for a simulate MHP.

• -f send/receive-control-file-name ~<pathname>
  For an interactive service request, specify the name of the send/receive control file that defines the send and receive procedures.
  

• service-name ~<identifier of 1-31 characters>
  Specify the name of the service to be executed.
  
• typed-buffer-definition-file-name ~<pathname>
  Specify the name of the typed buffer definition file that defines typed buffer information.
  
• XATMI-request-data-file-name ~<pathname>
  Specify the name of the XATMI request data file that contains the input data passed when a service is requested (when connection is established).
  
• XATMI-response-data-file-name ~<pathname>
  Specify the name of the XATMI response data file for storing the receive data during service execution and the response data after service execution.
  If this command argument is omitted, the response data is deleted.
  When an existing output file is specified, its contents are overwritten. If the specified file does not exist, the online tester creates the file.
  

• Only one service request can be made interactively.
• Set the type of service request function (request/response or conversational service paradigm) in call_kind in the XATMI request data file.
• The -f option is ignored if specified for the request/response service paradigm. If the -f option is omitted for the conversational service paradigm, a command error occurs.
• Service requests from within a transaction cannot be simulated.
• No error occurs if the send/receive control file contains no valid lines, but the command terminates immediately after the request for establishing connection.
• If no receive data or response data is received, no XATMI response data file is created. Provided at least one item of data is received, the file is created even if an error subsequently occurs. The data up to the error remains in the file.
• The data in the XATMI receive or XATMI response data file is invalidated if the data length specified for the file differs from the typed buffer length specified in the typed buffer definition file.
• The following conditions occur if the buffer length managed by the SPP differs from the typed buffer length specified in the typed buffer definition file:
  
  1. Service request error at utoxsppsvc command execution
  2. Data receive error at utoxsppsvc command execution
  3. Data receive error in the SPP
• If an XATMI response data file already exists, its contents are deleted when the utoxsppsvc command starts. No data remains in the file, even if no data is output.