Using the LOGTOOL Utility [ Manager's Guide to MPE/iX Security ] MPE/iX 5.0 Documentation
Manager's Guide to MPE/iX Security
Using the LOGTOOL Utility
To invoke LOGTOOL enter:
SYSDIAG
DUI > RUN LOGTOOL
For detailed information on any command enter HELP followed by the
command. For example:
LOGTOOL> HELP LIST
The following is a sample of commands you would use 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. If you wish to obtain data from your current logfile enter the
following to close it and open a new one:
LOGTOOL> SWITCHLOG
5. Display logfile record types (you may skip this step if you already
are familiar with types) :
LOGTOOL> TYPES
6. Display the logfile analysis. The following command accomplishes
three things: 1 - Specifies the numbers of the logfiles you wish to
examine (see results of above LISTFILE command), 2 - Specifies the
logging event types you wish to examine (see results of above TYPES
command) and 3 - Produces a formatted listing of information from the
logfiles.
SYSDIAG>LIST LOG=9/14,17,20,22;TYPE=111,146
The LOG parameter restricts analysis to logfiles LOG0009 through LOG0014
and LOG0017 and LOG0020 and LOG0022. The LOG parameter may be entered as
a range of numbers such as 9/14, as a string of numbers such as 17,20,22
(or a single number), or as a combination range and string (as in the
example).
The TYPE parameter says to select data only for event types 111 and 146
(I/O errors and maintenance requests).
7. If you do not wish to see the analysis on your terminal screen, but
would rather write the records to an output file, use the ;OUTFILE
parameter as follows (Otherwise, proceed to step 8):
SYSDIAG>LIST LOG=9/14,17,20,22;OUTFILE=MYFILE;TYPE=111,146
The output file to which the analysis will be written in this example is
MYFILE. You may choose any name but it must begin with an alphabetic
character.
Please remember that the output file will be written 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.
8. Terminate LOGTOOL:
LOGTOOL> EXIT
DUI > EXIT
COMMAND SUMMARY
Three categories of LOGTOOL commands are:
* System Log File Commands (SLF)
* Memory Log File Commands (MLF)
* Miscellaneous Commands (MC)
The following is a list and brief description of commands available in
LOGTOOL.
Table 7-2. 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". |
| | | |
-----------------------------------------------------------------------------------------------
MPE/iX 5.0 Documentation