HP 3000 Manuals

x4logview [ Managing HP X.400 Administrator's Guide ] MPE/iX 5.0 Documentation


Managing HP X.400 Administrator's Guide

x4logview 

Format and display the error log messages.

Syntax 
________________________________________________________________________
|x4logview [-htd][-a time][-b time][-p pid][-c class] [logfile]        |
________________________________________________________________________

            

Parameters 

-h                  Display procedure history for each error.

-t                  Do not display trace records.

-d                  Display dump rather than formatted errors.

-a  time            Select messages after specified time.

-b  time            Select messages before specified time.

-p  pid             Display specified PID (process Id).

-c  class           Display specified class (repeatable).

 logfile            Log file to display.

Description 

Output can be restricted to those from a particular class or classes by
using one or more -c options (in any order).  Multiple -c options are
ORed to form the class filter (any message which falls into any listed
class is displayed).  Error classes and their ID numbers are listed under
Error Classes.

Error messages from a particular process can be displayed by using the -p
option.  Only one -p option may be specified.

The -a option restricts output to those messages logged after the
specified time (up to and including the most recent).  The -b option
restricts output to those messages logged before the specified time (i.e.
from the first message logged in this file up to and including the last
one logged before the specified time).  By using both the -a and -b
options, the output can be restricted to any slice of time represented in
the log file being viewed.  Valid time formats are:

     hhmm
     MMddhhmm
     yyMMddhhmm
     any valid UTC time

where:

     mm = minutes
     hh = hours
     dd = day
     MM = month
     yy = year

UTC time may take any of the following forms:

     yyMMddhhmmss      - local time
     yyMMddhhmmss[Zz]  - GMT time
     yyMMddhhmmss+hhmm - GMT time plus offset
     yyMMddhhmmss-hhmm - GMT time minus offset.

Filter options (except -c, as noted above) are ANDed to form the error
message filter.  For example,

        x4logview -c 5 -c 6 -p 23435 -a 1130 -b 1330

displays all messages from either class 5 or 6 from process 23435 which
were logged at or after 11:30 AM today but before 1:30 PM.

In addition to the error log message filter options described above,
other options control what is displayed.  The -h option causes a
procedure history to be included with each error message.  The -t options
restricts the output to error messages only (Note that procedure tracing
must be enabled before any such records are logged to the error log file.
See x4setclass in this appendix).  Finally, the -d option causes error
records to display in internal error log format, with no NLS output.
This option is primarily for HP internal use.

Error Classes 

CLASS                            Numeric ID
---------                        ----------------

RTS Critical Errors              1
RTS Non-critical Errors          2

MTA Critical Errors              5
MTA Non-critical Errors          6

Encoder Critical Errors          13
Encoder Non-critical Errors      14

Decoder Critical Errors          17
Decoder Non-critical Errors      18

x4xfer Critical Errors           21
x4xfer Non-critical Errors       22

Remote Shell Critical Errors     25

x4admin Critical Errors          26

Example Usage 

The following causes all errors to display starting at the beginning of
the error log:

      x4logview

The following causes only error classes 5 and 6 to display:

      x4logview -c 5 -c 6

The following causes all errors from classes 1, 5 and 26 logged from
process 198 between 10:30 AM (local time), March 10th, 1989 and 5:00 PM
(GMT time), April 30th, 1989.  Procedure histories are included with each
error message:

       x4logview -h -c 1 -p 198 -c 5 -c 26 -a 8903101030 -b
       890430170000Z

Example Output 

     [1926] 07/05-14:25:54 - RTS Non-critical Error
     [1926]
     [1926] unexpected session event number -2  (X4ERR 3288)
     [1926] Source code file (incoming.c), Line 845



MPE/iX 5.0 Documentation