utftrcpic trace-file-name service-group-name [service-name [data-file-name]]

Retrieves offline tester trace information by key from a trace file and outputs the information to standard output.

• trace-file-name ~<pathname>
  Specify the name of the trace file that contains the offline tester trace information.
  
• service-group-name ~<identifier of 1-31 characters>
  As the key information, specify the name of the service group that contains the trace information to be retrieved.
  
• service-name ~<identifier of 1-31 characters>
  As the key information, specify the name of the service that contains the trace information to be retrieved.
  When specification is omitted, trace information is retrieved by service group.
  
• data-file-name ~<pathname>
  Specify the name of a data file as the key information if you want to restrict the retrieved trace information to a specific data file used at service execution.
  

1. Time and function information:
   
   • Time at which the service group was activated (hour:minute:second)
   • Name of C function
   • Name of COBOL program
   • Request code
   • DML statement name
2. Argument information:
   (IN) indicates contents specified with the function argument by the UAP. (OUT) indicates contents returned by the function to the UAP. arg name (OUT)=NULL is displayed when the address of the character string area is a null character.
   
3. Information on data and data length:
   Data contents are displayed for the specified data length in 40 bytes per line. The format when a specification is incorrect or incomplete is as follows:
   

   Example:

   When the data address is a null character:

   data name(IN)=NULL

   When the data length is zero:

   data name(IN)=

4. Option flag information:
   
   • Option flag name
   • COBOL flag name
   • COBOL flag type
   If a specification is incorrect, the code of the incorrect flag is displayed and *** is displayed as the COBOL flag name and flag type.
   

   Example:

   option flags(IN)=00000001 DCDAM_FILE_EXCLUSIVE [exclusive:B] 00000006 [***]

5. Return value information:
   
   • Definition name of C return value
   • Decimal display of C return value
   • Decimal display of COBOL return code

Output example

1. Message indicating offline tester startup and trace information collected at SPP startup
2. Trace information collected at subcommand input (test start)
3. Trace information collected at service execution
4. Trace information collected at data file read
5. Trace information collected at subcommand input (test end)
6. Trace information collected at SPP termination when offline tester ends

• Offline tester trace information is retrieved from the start to the end of each service.
• The retrieval range of the trace information differs according to the user response when prompted for input of the read or write subcommand or for input of a file name during service execution.
  The table below shows how the user response determines the retrieval range.
  

  Input prompt	Response (command input)	Trace information retrieval
  read or write subcommand	read or write subcommand	Trace information is also retrieved after subcommand input.
  	ps subcommand	Command input information and the command execution result are not retrieved.
  	end subcommand	Trace information is not retrieved after subcommand input.
  	Invalid command	Command input information and error messages are not retrieved.
  File name	ps subcommand	Command input information and the command execution result are not retrieved.
  	end subcommand	Trace information is not retrieved after subcommand input.
  	Command other than ps or end subcommand	Trace information is also retrieved after subcommand input.