log3display(1M)                                             log3display(1M)

NAME
     log3display - evaluate log data

SYNOPSIS
     $LOGPATH/bin/log3display [-cevlusSwh] -oX [logfile ...]

DESCRIPTION
     The log3display command selects the log data from log files, formats
     it using structure IDs, and displays it on the screen.

OPTIONS
     -c compno[,compno2][,comp1-comp2]
             This option is used to select components at the evaluation
             stage. A maximum of 64 entries can be made.

             Example: -c 1000,34,500-100,2,2222-3333

     -e errno[,errno2][,err1-err2]
             This option is used to select component error numbers (T-Log
             2.0: subtype) at the evaluation stage. A maximum of 64 entries
             can be made.

             Example: -e 1,5,10-65

     -v level[,level2][,lev1-lev2]
             This option is used to select the severity of errors at the
             evaluation stage. A maximum of 64 entries can be made.

             Example: -v 0-9

     -l yy[mm[dd[HH[MM[SS]]]]]
             Any log data recorded earlier than the specified date is ignored.

             Example: -l 92

             This entry is synonymous with 920101000000.

     -u yymmddHHMMSS
             Any log data recorded after the specified date is ignored.

             Example: -u 901231235959

             The following is interpreted: 31. Dec. 1990  23:59:59

     -s applictext
             The name of a certain application can be specified with this
             option. No other applications are affected.

     -S structid
             This option can be used to specify a structure ID, which cor-
             responds to the structure ID (STRUCT statement) in the
             description file log3struct(4).



Page 1                       Reliant UNIX 5.44                Printed 11/98

log3display(1M)                                             log3display(1M)

     -w width
             Line length of screen output. The line is generally 76 charac-
             ters long. Other values can be defined using this option.

             Example: -w 132

     -h      The command syntax is displayed.

     -oX     Formatting of screen output. The log data is output on the
             screen (standard output stdout) as separate lines with a
             number of fields, with the fields on each line separated by
             the octal "\030" (CAN). The sequence and format of the fields
             is as follows:

             Date of entry           YYMMDD
             Time of entry           hhmmss
             Date of last retry      YYMMDD
             Time of last retry      hhmmss
             Number of retry         Number
             Current number          Number
             User text=Module name   Text
             Release version         Text
             Severity of errors      Number or text
             Error number            Number
             Component number        Number
             Process ID              Number
             System name             Text
             Message text            Text

             All data is output as ASCII readable tests. All characters
             less 040 (blank) are mapped to blanks. Line feeds in the mes-
             sage text are flagged with "~".

     logfile This specification is used to select log files at the evalua-
             tion stage. If several entries are made, they must be sepa-
             rated by blanks (not commas).

             If a log file is not specified, log3display transfers all log
             files defined under the #LOGFILE block in the administration
             file log3admin(4).

             If a specified file is not available, log3display attaches all
             typical Logging V3.0 endings [0-8]log one after another to the
             file names, and then tests these names.










Page 2                       Reliant UNIX 5.44                Printed 11/98

log3display(1M)                                             log3display(1M)

FILES
     LOGPATH=/opt/log3
          Installation directory for Logging V3.0

     $LOGPATH/log3admin
          Configuration file: Assignment of applications to log files

     $LOGPATH/log3struct
          Configuration file: Assignment of structure IDs to output formats

     $LOGPATH/name[0-8]log
          Log files

SEE ALSO
     log3logger(1M), syslogd(1M), log3admin(4), log3(5).







































Page 3                       Reliant UNIX 5.44                Printed 11/98