trdfile

Purpose

     Contains the Token-Ring diagnostics log.

Description

     When Token-Ring diagnostics is running, warning and error
     messages that are sent as  a result of error analysis and
     informational messages  indicating changes in  the Token-
     Ring diagnostics  parameters or in the  Token-Ring status
     are logged  in a  file.  The /etc/trdconf  file specifies
     the default  file where  Token-Ring messages  are logged.
     The  installed  /etc/trdconf  file contains  the  default
     Token-Ring     diagnostics    log     file    name     of
     /usr/adm/ras/trdfile.

     Token-Ring diagnostics messages are  placed in one of two
     log files.  The Token-Ring  diagnostics creates the names
     of the  two files by adding  to the end of  the file name
     found  in /etc/trdconf   the number  from the  Token-Ring
     device name plus ".0" and  ".1".  For example, for device
     token0 the log files are named trdfile0.0 and trdfile0.1.

     Messages are first  added to file.0 until  it reaches the
     maximum  allowable length  as specified  in /etc/trdconf.
     At  that  point,  Token-Ring diagnostics  closes  file.0,
     renames file.0 to file.1, and  opens a new file.0.  Thus,
     the newest records are always in file.0.

     For  information on  messages  placed  in the  Token-Ring
     diagnostics  log file,  see the  description of  messages
     from   the   data   messages  area   in   &ldq.Token-Ring
     Diagnostics&rdq.  in Managing  the AIX  Operating System.
     Information  in  the  log   file  is  identical  to  that
     described,  with  one  exception;   a  3-byte  header  is
     appended to the front of each line of data.  For messages
     that do  not contain variable  data, the message  line is
     preceded  by 10&bla..  For  messages  that have  variable
     data, the message is preceded by 11&bla. and the variable
     data is preceded by 2&bla.&bla..

Files

     /usr/adm/ras/trdfile
     /etc/trdconf

Related Information

     In this book:  "trdconf."

     &ldq.Token-Ring  Diagnostics&rdq.  in  Managing  the  AIX
     Operating System.

     The trdiag command in  AIX Operating System Commands Ref-
     erence.