Invoking the Trace Customizer

The Trace Customizer is a protect mode only program and must therefore be run under OS/2. TRCUST may be invoked to combine TFF files or to process a TSF. The syntax for combining TFF files is as follows:

    [d:][path]TRCUST [d:][path]tffsource /C=[d:][path]tffdest [/Wn]

where:

TRCUST

is the name of the Trace Customizer program. A drive and path may optionally be specified to explicitly define the location of the Trace Customizer program, otherwise the program is searched for in the current directory, followed by looking along the path defined by the PATH environment variable.
[d:][path]tffsource
is the name of a file containing fully qualified (including extensions) pathnames of TFF files to combine. Each TFF file must use the same major code and each filename in the tffsource file is separated by white space. This will combine all TFF files for the same major code into a single TFF file. If duplicate minor code format definitions are found, the first format definition for the minor code remains valid, the duplicates are discarded and a warning message is issued. If no path is provided the tffsource file is searched for in the current directory, followed by using the current value of DPATH.
[d:][path]tffdest
is the name of the trace format destination file to store the combined trace format definitions.
/Wn
(optional) is the level of error messages to be displayed, where n can be 0, 1, or 2. The possible message levels are shown below along with the messages that each displays:

Level

Messages
0
fatal and severe messages
1
fatal, severe, and error messages
2
all (fatal, severe, error, and warning) messages
A message level of 2 is the default.

An example of a tffsource file for using the combine TFF files option of TRCUST is:

\TFF\PROG1\TRC00C2.TFF \TFF\PROG2\TRC00C2.TFF\TFF\PROG3\TRC00C2.TFF \TFF\PROG4\TRC00C2.TFF

To invoke TRCUST to combine TFF files using the above file as input (assume filename is \TFF\PROG\TFF00C2) and output the combined format statements into file \TFF\PROG\TR\TRC00C2.TFF is:

TRCUST \TFF\PROG\TFF00C2 /C=\TFF\PROG\TRC00C2.TFF

The syntax for processing a TSF file is as follows:

   [d:][path]TRCUST [d:][path]tsf [[d:][path]tdf] [/M=mapfile] [/Wn]

where:

TRCUST

is the name of the Trace Customizer program. A drive and path may optionally be specified to explicitly define the location of the Trace Customizer program, otherwise the program is searched for in the current directory, followed by looking along the path defined by the PATH environment variable.
[d:][path]tsf
is the name of the trace source file. If no file extension is provided then an extension of TSF is assumed. If no path is provided the trace source file is searched for in the current directory, followed by using the current value of DPATH.
[d:][path]tdf
(optional) is the name of the trace definition file to store the dynamic tracepoint definitions. If not specified, the TSF filename is used with an extension of TDF. If no file extension is provided then an extension of TDF is assumed.
/M=mapfile
(optional) defines mapfile as the MAP file for this module. The name may be qualified by a drive/directory, otherwise it will be searched for in the current directory followed by the path specified by the DPATH environment variable. If specified as an option, the MAP file must exist and the filename extension must be MAP or TRCUST will abort processing. The mapfile will only be used if a symbol is not found in the symbolic debug information stored in the executable module.
/Wn
(optional) is the level of error messages to be displayed, where n can be 0, 1, or 2. The possible message levels are shown below along with the messages that each displays:

Level

Messages
0
fatal and severe messages
1
fatal, severe, and error messages
2
all (fatal, severe, error, and warning) messages
A message level of 2 is the default.

---

[Back: File Naming and Location]
[Next: Symbolic Debug Support]