trcupdate

PURPOSE

     Updates trace format templates.

SYNOPSIS
     trcupdate [ file ] [ -o ]

DESCRIPTION

     The trcupdate  command adds,  replaces, or  deletes trace
     report  format templates  in  the  files /etc/trcfmt  and
     /usr/adm/ras/.trcevents  and  event  types  in  the  file
     /etc/trcprofile.  trcupdate  creates three undo  files in
     the     current     directory    named     file.undo.trc,
     .trcevents.undo.evt, and file.undo.pro.  These undo files
     can be used as input  to trcupdate with the -o (override)
     flag to undo the changes trcupdate has just made.

     The trcupdate  command reads three files  named file.trc,
     file.evt,  and file.pro.   The  trc  file contains  trace
     format templates; the evt file contains trace event types
     and their  corresponding hook IDs; the  pro file contains
     the event type line for the trace profile.

     The first field of each template contains an operator:

     +  To add or replace a template
     -  To delete a template.

     If the operation is +,  then the following fields contain
     the template to be replaced.  The hook ID of the template
     is also  added to  the /usr/adm/ras/.trcevents  file, and
     the  event  type  line  is added  to  the  trace  profile
     /etc/trcprofile.   If  the operation  is  a  -, then  the
     second  field contains  the hook  ID of  the template  to
     delete.    That    hook   ID    is   also    deleted   in
     /usr/adm/ras/.trcevents,  and  the  event  type  line  is
     deleted from /etc/trcprofile.

     When adding or replacing,  trcupdate compares the version
     numbers of each input template with the version number of
     the  existing template  of  the same  hook  IDs.  If  the
     version  number  of  the  input  template  is  later,  it
     replaces the  old template  with the input  template.  If
     the template does not already  exist, then it is added to
     the file.  The input file  must contain the identifier "*
     /etc/trcfmt" on the first line.

     The file.evt file contains a  table of trace system event
     types  and   hook  IDs  that  fall   under  these  types.
     trcupdate reads  in the file  /usr/adm/ras/.trcevents and
     adds in any  hook IDs from file.evt that  are not already
     accounted for or reassigns/deletes  hook IDs to the event

     type given  in the  update file.  The  first line  of the
     event/hook update file  must be:  "* /ras/.trcevents"  or
     trcupdate rejects the input file.

     The file.pro contains  the lines that are to  be added to
     or   deleted  from   /etc/trcprofile.   trcupdate   reads
     /etc/trcprofile and  adds or deletes the  specified event
     type line  from file.pro.   The first  line of  the event
     type  file must  be:   "* /etc/trcprofile"  or  trcupdate
     rejects the input file.

FLAGS

     -o Does no version number checking.

EXAMPLES

     1.  The following is a sample trc file:

           * /etc/trcfmt
           + 355 1.0 new_fmt
           - 351
           - 352

     2.  The following is a sample evt file:

           * ras/.trcevents
           350 355 356 357

FILES

     /etc/trcfmt
     /usr/adm/ras/.trcevents
     file.evt
     file.undo.evt
     file.trc
     file.undo.trc
     file.pro
     file.undo.pro

RELATED INFORMATION

     The following command: "trcrpt."

     AIX Operating System Programming Tools and Interfaces.