WSFORMAT Command

The WSFORMAT command is the Winsock trace formatter. The WSFORMAT command accepts the binary trace input from a serial port, file, or OS/2 pipe, and converts the input into a readable format that can then be displayed on-screen or written to a file, serial port, or OS/2 pipe.

Syntax

─WSFORMAT────┬─────────────────────────┬──────────────────────
               ├─┬────────────────┬──────┤
               │ ├─input_filename─┤      │
               │ ├─COM1───────────┤      │
               │ ├─COM2───────────┤      │
               │ ├─COM3───────────┤      │
               │ └─COM4───────────┘      │
               │      ┌─WSTRACE────────┐ │
               └─ -p ─┼────────────────┼─┘
                      └─input_pipename─┘

      ┌─WSFORMAT.DMP──────────────────┐
─────┼───────────────────────────────┼─────────────────────────
      └─ -f formatted_output_filename─┘

      ┌─WSTRACE.DMP────────────────┐
─────┼────────────────────────────┼───────────────────────────
      └─ -b binary_output_filename─┘

Parameters

input_filename

Specifies the file name of the input file containing the trace information to format. COM1, COM2, COM3, and COM4 may be used to accept trace data from a serial port.

Specifies the pipe name of the OS/2 pipe that contains the trace data to format. Pipe names do not have to include a \PIPE\ prefix. If input_pipename is not specified with the -p parameter, the pipe name defaults to WSTRACE.

Specifies the file name of the file that the formatted trace output will be written to. If formatted_output_file is not specified with the -f parameter, the file name defaults to WSFORMAT.DMP in the current directory.

Specifies the file name of the file that will receive a copy of the binary information being formatted. This can be used to save a copy of the trace information coming from a serial port or pipe. If binary_output_file is not specified with the -b parameter, the output file name defaults to WSTRACE.DMP in the local directory.

Notes:

• If the -f option is not specified, the formatted trace output is written to the screen.

• When specifying a serial port as the Winsock trace device, be sure that the serial port settings match on both ends of the line. The OS/2 MODE command lets you set the serial port settings. For more information about the MODE command, see the OS/2 Command Reference or enter:

  help mode

  in an OS/2 session.