utomsgout [{ -i|-r output-file-name }] [-w][{ -o|-l }] [-f function-name] [-n number] [-t logical-terminal-name] [-s service-group-name [,service-name]...] MCF-send-message-file-name

Edits the send message information output by the online tester and outputs the information to standard output. Or, outputs the information to the specified file when the -r option is specified.

A command error occurs if the command is entered while OpenTP1 is writing send messages to the specified MCF send message file.

There are two types of options:

• Options for changing the output format:
  -i and -r
  
• Options for selecting output message files:
  -f, -l, -n, -o, -s, -t, and -w
  

When an option with a flag argument is specified more than once, the last specified option is valid.

• -i
  Lists send messages in abbreviated form.
  This option cannot be specified with the -r option.
  
• -r output-file-name ~<pathname>
  Specify the name of the file to which the specified messages are to be output. The messages are output in the data format of an MCF receive message file. Therefore, the output file can be used without modification as an MCF receive message file.
  This option cannot be specified with the -i option. If the -r and -i options are both omitted, segment information and send message information are output to standard output.
  
• -w
  Edits and outputs only the messages that are not output by the -r option.
  When this option is omitted, all messages are edited and output.
  
• -o
  Outputs only the oldest message among the editable messages.
  This option cannot be specified with the -l option. If the -o and -l options are both omitted, all messages are output.
  
• -l
  Outputs the most recent message among the editable messages.
  This option cannot be specified with the -o option. If the -l and -o options are both omitted, all messages are output.
  
• -f function-name
  Outputs messages collected for the specified function. The following function names can be specified:
  

  send

  dc_mcf_send function

  reply

  dc_mcf_reply function

  execap

  dc_mcf_execap function

  sendrecv

  dc_mcf_sendrecv function

  sendsync

  dc_mcf_sendsync function

  The dc_mcf_resend function cannot be specified in this option because send messages are not resent (rewritten) by the dc_mcf_resend function when the MCF simulator is used.
  
• -n number
  Selects output messages by number. To check message numbers, specify the -i option to display an abbreviated listing of all send messages.
  This option takes precedence when specified with options other than -i or -r.
  
• -t logical-terminal-name ~<identifier of 1-8 characters>
  Outputs messages sent to the specified logical terminal.
  
• -s service-group-name ~<identifier of 1-31 characters>
  service-name ~<identifier of 1-31 characters>
  Outputs messages sent in a specified service. Specify both the service group name and service name, delimiting the two names with a comma (,).
  Two or more services can be specified for a service group. Delimit the service names with commas. Do not insert a space or symbol before or after the comma.
  Both the service group name and service name must be specified. If no service name is specified, the send message information of all the services in the specified service group is edited and output.
  When this option is omitted, send message information is output for all services in all the service groups.
  

• MCF-send-message-file-name ~<pathname>
  Specify the name of the MCF send message file containing the send messages.
  

(a) -i and -r options omitted

1. Information on the edited and output send messages:
   
   • Time at which the messages were collected (hour:minute:second)
   • Message size (up to 10 digits)
   • Logical terminal name (up to 8 characters)
   • Service group name of the sent messages (up to 31 characters).
     **** is displayed when the service group name is unknown.
     
   • Service name of the sent messages (up to 31 characters).
     **** is displayed when the service name is unknown.
     
   • One of the following function names for which the messages were collected:
     dc_mcf_send function
     dc_mcf_reply function
     dc_mcf_execap function
     dc_mcf_sendrecv function
     dc_mcf_sendsync function
     
   • One of the following segment types:
     M
     Middle segment
     L
     Last segment
     
   • Map name.
     **** is displayed when no map name is returned.
     
2. Relative location
3. Dump display (hexadecimal)
4. ASCII character display.
   A period (.) is displayed when ASCII character display is impossible.
   

• Output example
  

  

(b) -i option specified

1. Message number in the file
2. Function for which the message was sent:
   

   send

   dc_mcf_send function

   reply

   dc_mcf_reply function

   execap

   dc_mcf_execap function

   sendrecv

   dc_mcf_sendrecv function

   sendsync

   dc_mcf_sendsync function

3. Service group name of the sent messages (up to 31 characters).
   **** is displayed when the service group name is unknown.
   
4. Service name of the sent messages (up to 31 characters).
   **** is displayed when the service name is unknown.
   

• Output example
  

  

• The send messages collected by the MCF simulation functions are written to the MCF send message file when a function is issued. The messages remain in the file if a rollback occurs.
• When the -r option is specified in the utomsgout command, the segment type is displayed as [M...]L. For example, a logical message consisting of the three segments F, M, and L is actually output as M, M, L. However, this output can be used without modification as input for the online or offline tester.