TRACE(1,C)                  AIX Commands Reference                   TRACE(1,C)



-------------------------------------------------------------------------------
trace



PURPOSE

Starts the trace function.

SYNTAX


         +-------------+   +- /etc/trcprofile -+
trace ---| +---------+ |---|                   |---|
         +-| -o name |-+   +----- profile -----+
          ^+---------+|
          +-----------+


DESCRIPTION

The trace command starts the trace function in the background.  This trace
function provides a base for debugging the system.  The trace command monitors
the occurrence of selected events in the system and records on disk important
data specific to each of these events.  You can format this output with the
trcrpt command.

Any user or program that needs the trace process enabled for debugging or error
determination can start the trace command.  When starting trace, you must
provide a profile.  This allows you to tailor the output of the trace session
to individual needs.  The default profile is /etc/trcprofile.

There may be more than one trace profile in the file system at a time.  The
trace profile contains the classes of events that you can select to trace,
listed by event class and by a descriptive label.  See "Example" for a sample
profile.  You may keep different profiles to trace different combinations of
event classes.  The trace command also takes additional information about the
trace session from the configuration file /etc/rasconf (see AIX Operating
System Technical Reference for a discussion of this file).  You set the name
and size of the output file in this configuration file.

In a multiuser environment, the trace command records all system events, not
just events at one virtual terminal.

FLAGS

-o  name       Specifies the name of the log file into which the trace demon
               stores the trace data.

EXAMPLE





Processed November 8, 1990        TRACE(1,C)                                  1

TRACE(1,C)                  AIX Commands Reference                   TRACE(1,C)



  *****************************************************************************
  * SYSTEM TRACE PROFILE
  *****************************************************************************
  * To set trace on for an event class, remove the comment mark (*) from the
  * first column of the line containing the event you wish to trace.
  * Add a comment mark (*) in the first column of lines containing event types
  * you wish to stop tracing.

  ***** Event
  *     Type    Description

  *****         Applications


  *****         AIX Extensions
  *       36      Config

  *****         AIX System Calls
  *       60      Shared Memory
  *       61      Messages
  *       62      Semaphores
  *       63      Signals
  *       64      Time
  *       65      File system
  *       66      File Handling
  *       67      Directory Handling
  *       68      Process

FILES

/etc/trcprofile         Default profile.
/usr/adm/ras/trcfile    Output file defined in /etc/rasconf.
/etc/rasconf            Configuration file.

RELATED INFORMATION

See the following commands:  "trcstop" and "trcrpt."

See the rasconf configuration file in AIX Operating System Technical Reference.

See the discussion of trace in AIX Operating System Programming Tools and
Interfaces.













Processed November 8, 1990        TRACE(1,C)                                  2