WSTRACE Command

The WSTRACE command enables and disables Winsock tracing in an OS/2 session.

Syntax

              ┌─on──┐
─WSTRACE────┼─────┼───┬───────────────────┬───────────────────
              └─off─┘   ├─┬──────────┬──────┤
                        │ ├─filename─┤      │
                        │ ├─COM1─────┤      │
                        │ ├─COM2─────┤      │
                        │ ├─COM3─────┤      │
                        │ └─COM4─────┘      │
                        │      ┌─WSTRACE──┐ │
                        └─ -p ─┼──────────┼─┘
                               └─pipename─┘

      ┌─64───────────┐
─────┼──────────────┼─────────────────────────────────────────
      └─ -b buffsize─┘

Parameters

on

Turns tracing on. This is the default.

Turns tracing off.

Specifies the file name of the file that the trace output will be written to. COM1, COM2, COM3, and COM4 may be used to direct the trace to a serial port.

Specifies the pipe name of an OS/2 pipe that the trace output will be written to. Pipe names do not have to include a \PIPE\ prefix. If pipename is not specified with the -p parameter, the pipe name defaults to WSTRACE.

Specifies the size of the global trace buffer. If the -b parameter is not specified, the buffer size defaults to 64 KB.

Notes:

• When neither filename nor pipename is specified, trace output is written by default to the file WSTRACE.DMP in the local directory.

• When a pipe or COM port is specified as the destination for tracing information, start the WSFORMAT command in an OS/2 session on the destination device before running the Winsock application to be traced.

• 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.