HPlogo MPE/iX System Utilities Reference Manual > Chapter 13 LOGTOOL

LOGTOOL Operation

MPE documents

Complete PDF
Table of Contents
Index

To invoke LOGTOOL enter:

  SYSDIAG
  DUI > RUN LOGTOOL

For detailed information on any command enter HELP followed by the command name. For example, to see information about the LIST command, enter:

  LOGTOOL> HELP LIST

To display data from a set of system log files:
  1. Log on as MANAGER.SYS or with SM, OP or DI capability.

  2. List the names of log files currently on your system before invoking LOGTOOL:

    
      LISTFILE LOG@.PUB.SYS
    
    

  3. Invoke LOGTOOL:

    
      SYSDIAG
      DUI > RUN LOGTOOL
    
    

  4. To get data from your current logfile enter the following command to close it and open a new one:

    
      LOGTOOL> SWITCHLOG
    
    

  5. If necessary, display logfile record types. (You may skip this step if you already are famililar with types):

    
      LOGTOOL> TYPES
    
    

  6. Display the analysis for specified logfiles as a formatted list.

    
      SYSDIAG>LIST LOG=9/14,17,20,22;TYPE=111,146
    
    
    You may enter the LOG parameter as a range of numbers such as 9/14, as a string of numbers such as 17,20,22, or as a combination range and string. (In this example, LOGTOOL will analyze logfiles LOG0009 through LOG0014 and LOG0017 and LOG0020 and LOG0022.)

    The TYPE parameter specifies the event types you want analyzed. (In the example, types 111, I/O errors, and type 146, maintenance requests, was specified.)

    If you do not wish to see the analysis on your terminal screen, but prefer to write the records to an output file, you would use the ;OUTFILE parameter as follows:

    
      SYSDIAG>LIST LOG=9/14,17,20,22;OUTFILE=MYFILE;TYPE=111,146
    
    
    In this example, the output file MYFILE. You may choose any name so long as it begins with an alphabetic character. LOGTOOL writes the output file to the DIAG group of the SYS account. You may use any HP3000 text editor to examine the output file. You may also copy it with the COPY command or the FCOPY utility.

  7. Exit the LOGTOOL utility:

    
      LOGTOOL> EXIT
      DUI > EXIT
    
    

COMMAND SUMMARY


There are three categories of LOGTOOL commands: System Log File Commands (SLF), Memory Log File Commands (MLF), and Miscellaneous Commands (MC). They are briefly described in the following table.

Table 13-1 LOGTOOL Commands

Name Category Description
DISPLAYLOG(SLF)Displays I/O entries as information is logged.
EXIT(MC)Exits LOGTOOL and returns user to DUI.
HELP(MC)Gives help on running LOGTOOL.
LAYOUT(SLF)Reads in a layout file.
LIST(SLF)Lists contents of a system log file.
MEMCLR(MLF)Clears the memory logging process log files.
MEMRPT(MLF)Displays the contents of the memory log file.
MEMTIMER(MLF)Alters the timer value of the memory error logging process.
PURGESYSLOG(SLF)Deletes the specified system log files from the disc.
PURGEWORK(SLF)Deletes the specified work files from the disc.
REDO(MC)Edits any of the last four lines of text entered.
SELECT(SLF)Selects specified records from the system log files.
STATUS(SLF)Reports on the status of all system log files.
SUSPEND(MC)Suspends LOGTOOL and returns control to the DUI.
SWITCHLOG(SLF)Causes the system to start a new system log file.
TYPES(SLF)Describes the system log file "types".

Logging system events


The following list shows the types of system log events that you can track. To do so, you enable a log event by turning it ON in SYSGEN.

Table 13-2 SYSGEN System Logging

System Log Events Event Type
System logging enabled100
System up record101
Job initiation record102
Job termination record103
Process termination record104
NM file close record205
System shutdown record106
Power failure record107
Spooling log record108
I/O error record111
Physical mount or dismount112
Logical mount or dismount113
Tape labels record114
Console log record115
Program file event116
New commercial spooling120
Architected interface130
Password changes134
System logging configuration135
Restore logging136
Printer access failure137
ACD changes138
Stream initiation logging139
User logging140
Process creation141
Chgroup record143
File open record244
Maintenance request log146
UPS Monitor event logging148
Diagnostic information record150
High-priority machine check152
Low-priority machine check152
Directory open/close logging155
CM file close record160
Chdir161
Process Adoption162
File Owner Change163

All log information is kept in records. Each record begins with a standard header and ends with identification information which varies for each log type. For detailed information about the format of the log records, read the Manager's Guide to MPE/iX Security.




Chapter 13 LOGTOOL


Chapter 14 MKNOD