Liren Large Software Subsidy 14/14.iso/s/s005/16.ddi/RAS/OS2_HELP_TRACEFMT.HLP

OS/2 Help File | 1993-04-22 | 11.7 KB | 363 lines

ΓòÉΓòÉΓòÉ 1. Help for the Trace Formatter ΓòÉΓòÉΓòÉ

Use the OS/2 System Trace Formatter to determine which trace points have been
logged by an OS/2* system.  The Trace Formatter also processes the data
associated with those trace points.

The Trace Formatter uses unformatted trace event data to produce formatted
output describing information logged by the system.  You can then save the
trace data in a file.  Major and minor codes tell you from where in the system
the logged information came.  The Process ID (PID) indicates which process
caused the event to be logged.

This utility is intended to be used with the assistance of your Service
Representative.  A Service Representative can help you set up a system for
system trace, start system trace, and run the Trace Formatter to capture and
save the trace events in a file.  You can then send the events that have been
saved in a file to your Service Representative for analysis.

Related information:

Configuring Your System


ΓòÉΓòÉΓòÉ <hidden> OS/2 ΓòÉΓòÉΓòÉ

Trademark of the IBM Corporation.


ΓòÉΓòÉΓòÉ 2. Configuring Your System ΓòÉΓòÉΓòÉ

Your system must be properly configured to perform system trace.  Your
CONFIG.SYS file must include either the TRACE= or TRACEBUF= statements.  If you
specify TRACE=ON in the CONFIG.SYS file, the system begins logging trace events
from start-up time.  If you specify TRACE=OFF in the CONFIG.SYS file, you must
start tracing by entering the TRACE command at a command prompt.

If you specify the TRACEBUF= statement in the CONFIG.SYS file, you indicate the
amount of space the system reserves to hold trace events.  You can specify a
size in the range of 1K to 63K.  If you do not include a TRACEBUF statement,
the system uses a default buffer size of 4K.  Refer to the TRACE Utility in the
OS/2 Command Reference for more information on these statements and their
syntax.

Note:   It is recommended that you not include these statements in the
        CONFIG.SYS file if you will not be using system trace.

You can use the Trace Formatter on a system that is not configured for system
trace.  However, you can use as input only unformatted system trace data that
has been previously saved in a file.


ΓòÉΓòÉΓòÉ 3. Help for File ΓòÉΓòÉΓòÉ

Use the choices on the File menu to view, retrieve, save, or print trace data
or to close the Trace Formatter.


ΓòÉΓòÉΓòÉ 4. Help for Open ΓòÉΓòÉΓòÉ

Use Open to retrieve and then format unformatted trace data that has been
previously stored in a file.


ΓòÉΓòÉΓòÉ 5. Help for Retrieve System Trace Buffer ΓòÉΓòÉΓòÉ

Use Retrieve system trace buffer to retrieve and then format the data that is
currently in the system trace buffer.  When this operation is performed, a copy
is made of the data in the system trace data buffer, and the system trace data
buffer is cleared.  The Trace Formatter then holds the only copy of the new
trace data.  If you will need the data at a later time, save it with the Save
unformatted data choice on the Save as menu.

You can select this choice only if your system is currently configured for
system trace.


ΓòÉΓòÉΓòÉ 6. Help for Save As ΓòÉΓòÉΓòÉ

Use the choices on the Save as menu to store the trace data to a file.  You can
save the data in a formatted or unformatted form.  You can also save a summary
of the trace data.  You can choose to have the summary grouped by event code or
by process ID.


ΓòÉΓòÉΓòÉ 7. Help for Save Unformatted Trace Data ΓòÉΓòÉΓòÉ

Use Save unformatted trace data to save the trace data in its unformatted form.
This is helpful if it might be necessary to format the data at a later time.


ΓòÉΓòÉΓòÉ 8. Help for Save Formatted Trace Data ΓòÉΓòÉΓòÉ

Use Save formatted trace data to save the formatted trace data.


ΓòÉΓòÉΓòÉ 9. Help for Save Summary by PID ΓòÉΓòÉΓòÉ

Use Save summary by Process ID to save a summary of the trace data that is
grouped by process ID.


ΓòÉΓòÉΓòÉ 10. Help for Save Summary by Major Code ΓòÉΓòÉΓòÉ

Use Save summary by major code to save a summary of the trace data that is
grouped by major code.


ΓòÉΓòÉΓòÉ 11. Help for Print ΓòÉΓòÉΓòÉ

Use the choices on the Print menu to print trace data.  You can print formatted
trace data or you can print a summary of the data.  You can choose to group the
summary by event code or by process ID.


ΓòÉΓòÉΓòÉ 12. Help for Print Formatted Trace Data ΓòÉΓòÉΓòÉ

Use Print formatted trace data to print the formatted trace data.


ΓòÉΓòÉΓòÉ 13. Help for Print Summary by PID ΓòÉΓòÉΓòÉ

Use Print summary by Process ID to print a summary of the trace data that is
grouped by process ID.


ΓòÉΓòÉΓòÉ 14. Help for Print Summary by Major Code ΓòÉΓòÉΓòÉ

Use Print summary by major code to print a summary of the trace data that is
grouped by major code.


ΓòÉΓòÉΓòÉ 15. Help for Exit ΓòÉΓòÉΓòÉ

Use Exit to close the Trace Formatter window.  If a copy of unformatted trace
data is being used, be sure to save it if the data might be needed at a later
time.


ΓòÉΓòÉΓòÉ 16. Help for View ΓòÉΓòÉΓòÉ

Use the choices on the View menu to display trace data.  You can display
formatted trace data or you can display a summary of the data.  You can choose
to group the summary by event code or by process ID.


ΓòÉΓòÉΓòÉ 17. Help for View Formatted Data ΓòÉΓòÉΓòÉ

Use View formatted data to display the formatted trace data.


ΓòÉΓòÉΓòÉ 18. Help for View Summary by PID ΓòÉΓòÉΓòÉ

Use View summary by Process ID to display a summary of trace data that is
grouped by process ID.


ΓòÉΓòÉΓòÉ 19. Help for View Summary by Major Code ΓòÉΓòÉΓòÉ

Use View summary by major code to display a summary of trace data that is
grouped by major code.


ΓòÉΓòÉΓòÉ 20. Message: Not Logging Data ΓòÉΓòÉΓòÉ

The system is not configured for system trace.  Your CONFIG.SYS file does not
contain either the TRACE= or TRACEBUF= statements.  If you wish to use system
trace, you will need to add one or both of these statements to your CONFIG.SYS
file and restart your system.

Because the system is not configured for system trace, the Trace Formatter can
accept only trace data that has been previously stored to a file.  To obtain
data previously stored to a file, select the Open choice from the File pull
down.  For further information, refer to the Command Reference.


ΓòÉΓòÉΓòÉ 21. Message: No Data Retrieved ΓòÉΓòÉΓòÉ

You attempted to retrieve system trace data from either the system trace buffer
or a file, and there was no data to retrieve or the attempt failed.

If you start the Trace Formatter without specifying a file name, the Trace
Formatter attempts to retrieve data from the system trace buffer.


ΓòÉΓòÉΓòÉ 22. Message: Print Started ΓòÉΓòÉΓòÉ

Your request to print has completed successfully.  The Print ID number can be
used to send the print job to the Print Manager.


ΓòÉΓòÉΓòÉ 23. Question: Do You Want to Exit? ΓòÉΓòÉΓòÉ

If you select the Yes pushbutton, the Trace Formatter ends.  Before you do
this, you might want to save any data that has been retrieved from the system
trace buffer.  If you save this data to a file, you can format the data later.

If you select the No pushbutton, the Trace Formatter resumes.


ΓòÉΓòÉΓòÉ 24. Question: Overwrite Data? ΓòÉΓòÉΓòÉ

If you select the OK pushbutton, the Trace Formatter attempts to replace the
current data with data from the source you specified.  The current data will be
lost unless you have previously stored it to file.  If you select the Cancel
pushbutton, the current data remains untouched and the retrieve function does
not continue.  *********


ΓòÉΓòÉΓòÉ <hidden> Help for Print ΓòÉΓòÉΓòÉ

 1. Select a printer from the printer list.
 2. Select the Print pushbutton.

For a detailed explanation of each field, select from the list below:

o Printer
o Print pushbutton
o Cancel pushbutton


ΓòÉΓòÉΓòÉ <hidden> Help for Printer ΓòÉΓòÉΓòÉ

This list shows the printers you can use.


ΓòÉΓòÉΓòÉ <hidden> Help for Print ΓòÉΓòÉΓòÉ

Select the Print pushbutton to print the trace data.


ΓòÉΓòÉΓòÉ <hidden> Help for Open ΓòÉΓòÉΓòÉ

 1. Select the arrow to the right of the Drive list to display all the drives
    on your system.
 2. Select a drive from the Drive list.
 3. Select a directory from the Directory list.
 4. Select a file name from the File list or type in a file name and select the
    Open pushbutton to display the file you want to view.

For a detailed explanation of each field, select from the list below:

o Open filename
o Type of file
o Drive
o File
o Directory
o Open pushbutton
o Cancel pushbutton


ΓòÉΓòÉΓòÉ <hidden> Help for Open Filename ΓòÉΓòÉΓòÉ

Type the name of the file you want to open in the Open filename field and
select the Open pushbutton.


ΓòÉΓòÉΓòÉ <hidden> Help for Type of File ΓòÉΓòÉΓòÉ

Select the arrow to the right of the Type of file field to display the
available file types.  The Trace Formatter has set this field for all file
types.


ΓòÉΓòÉΓòÉ <hidden> Help for Drive ΓòÉΓòÉΓòÉ

The Drive list displays the drives on your system.  Select the drive that
contains the files you want to view.


ΓòÉΓòÉΓòÉ <hidden> Help for File ΓòÉΓòÉΓòÉ

The File list displays all the files in the directory you selected from the
Directory list.  Select the file you want to open.


ΓòÉΓòÉΓòÉ <hidden> Help for Directory ΓòÉΓòÉΓòÉ

The Directory list displays the directories on the selected drive.  Select a
directory to display the list of files from that directory in the File list
box.


ΓòÉΓòÉΓòÉ <hidden> Help for Open ΓòÉΓòÉΓòÉ

Select the Open pushbutton to view the file you selected and read unformatted
trace event data from the file.


ΓòÉΓòÉΓòÉ <hidden> Help for Cancel ΓòÉΓòÉΓòÉ

Select the Cancel pushbutton if you decide not to change the current settings.


ΓòÉΓòÉΓòÉ <hidden> Help for Save As ΓòÉΓòÉΓòÉ

 1. Select the arrow to the right of the Drive list to display all the drives
    on your system.
 2. Select a drive from the Drive list.
 3. Select a directory from the Directory list.
 4. Select a file name from the File list or type in a file name and select the
    Save pushbutton to save the file you want.

For a detailed explanation of each field, select from the list below:

o Save as filename
o Save file as type
o Drive
o File
o Directory
o Save pushbutton
o Cancel pushbutton


ΓòÉΓòÉΓòÉ <hidden> Help for Save as Filename ΓòÉΓòÉΓòÉ

Type the name of the file you want to save in the Save as filename field and
select the Save pushbutton.


ΓòÉΓòÉΓòÉ <hidden> Help for Save File as Type ΓòÉΓòÉΓòÉ

Select the arrow to the right of the Save file as type field to display the
available file types.  The Trace Formatter has set this field for all file
types.


ΓòÉΓòÉΓòÉ <hidden> Help for Drive ΓòÉΓòÉΓòÉ

The Drive list displays the drives on your system.  Select the drive that
contains the files you want to save.


ΓòÉΓòÉΓòÉ <hidden> Help for File ΓòÉΓòÉΓòÉ

The File list displays all the files in the directory you selected from the
Directory list.  Select the file you want to save.


ΓòÉΓòÉΓòÉ <hidden> Help for Directory ΓòÉΓòÉΓòÉ

The Directory list displays the directories on the selected drive.  Select a
directory to display the list of files from that directory in the File list
box.


ΓòÉΓòÉΓòÉ <hidden> Help for Save ΓòÉΓòÉΓòÉ

Select the Save pushbutton to save the information you requested in the file
name you specified.


ΓòÉΓòÉΓòÉ 25. Key Assignments for TRACEFMT ΓòÉΓòÉΓòÉ

When two key names are joined by a plus sign (+), use these two keys together.
Hold down the first key and press the second key.

There are no specific key assignments for TRACEFMT.  To see the list of keys
for the operating system, select the following topic.

Related information:

Key Assignments