Use TraceSet to start or stop tracing.
TraceSet may also be entered as Trace[Set].
Optional Operands
OPER specifies whether tracing is to be started or stopped. Specify "On", "Y[es]", or "Start" to start tracing, "Of[f]", "N[o]", or "Stop" to stop tracing.
Default: On.
DEST specifies where trace records are to be written. Specify "File" if records are to be written to a workstation file. Specify "BIM" if records are to be written to the BIM-EDIT/XP trace server. Specify "xp" if records are to be written to BIM-EDIT/XP running on another PC.
Default: File.
NAME If DEST is specified as "File", NAME specifies the workstation file name. If DEST is specified as "xp", NAME specifies the IP address of the workstation running BIM-EDIT/XP where trace records are to be sent. The IP address can either be specified in dotted decimal notation (nn.nn.nn.nn) or as an Internet domain name (e.g., bimoyle.com).
Default: If DEST is specified as "File", C:\BIMEDIT\USER\DEFAULT\TRACE.DAT (assuming BIM-EDIT/XP was installed on the C drive in directory BIMEDIT, and assuming this is the DEFAULT user). If DEST is specified as "xp", NAME must be provided.
If trace records are to be written to BIM-EDIT/XP running on another workstation, that workstation must have previously issued the TraceListen command.
The C:\BIMEDIT\DEBUG\TRACE.DAT file can easily be displayed by invoking the TraceList command.
Tracing, especially to another workstation, can be very useful when debugging procedures. Simply issue TraceListen from the other workstation, then issue a command on your workstation similar to the following:
=> trace ,xp,63.225.12.35
BIM-EDIT/XP support staff may at times request that you trace directly to a workstation accessible to a BIM technician. In such a case, simply enter:
=> trace ,bim
BIM-EDIT/XP communicates via TCP/IP with machine editxp.com (currently IP address 63.224.27.217) on ports 5380, 5382, and 5384, during trace and dump uploads, and during release downloads (see ReleaseDownload). If a firewall is installed, the firewall must be configured to allow such connections.
Return Codes
OK Successful.
Examples
Trace to the default file:
=> trace
Trace to file TRACE001.DAT in the current directory:
=> trace ,file,trace001.dat
Trace to the BIM-EDIT/XP trace server:
=> trace ,bim
Trace to Jim's PC (assume name JIMSPC resolves to a valid IP address):
=> trace ,xp,jimspc
Turn off tracing:
=> trace off