Standalone Logtool for MPE/iX
Name Category
Description
ALTFIELD
(SFL) Specifies which fields of a log record should be displayed in a report generated by LIST.
DISPLAYLOG
(SFL) Displays I/O entries as information is logged.
EXIT
(MC) Exits LOGTOOL and returns user to the MPE/iX user interface.
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.
SUMMARIZE
(SLF) Allows user to generate summary report based on contents of system log files.
SUSPEND
(MC) Suspends LOGTOOL and returns control to the MPE/iX user interface.
SWITCHLOG
(SLF) Causes the system to start a new system log file.
TYPES
(SLF) Describes the system log file "types."
Definitions and Conventions
All keywords, commands and options may be abbreviated to the shortest number of characters that make the reserved
word unique. Delimiters for keywords and options include spaces and/or semicolons. The delimiter for items in a list is
a comma.
The user may be prompted from time to time for certain data. If one of several specific responses is required (a YES
or NO question, for example), the valid responses will be indicated in parentheses. In all instances, a default response
is indicated in square brackets. This response may be selected simply by pressing Return. For example, a user who is
deleting a system log file might be asked the question:
Purge LOG3251.pub.sys (Y/N) [N] ?
Valid responses include Y and N. Simply pressing the Return key selects the default response, N. If the text of a
command is too long to fit on one line, the user may use continuation lines to complete entry of the command. To
accomplish this task, the user simply places an ampersand (&) character as the last character of the line. LOGTOOL will
then prompt the user for the rest of the input. A command may consist of numerous continuation lines provided that
the total length of the text entered does not exceed 255 characters. For example:
LOGTOOL>select log=100/400, 234/599 ;type= 101, 105, 109 &
LOGTOOL>name=hp7935,hp7933
The LOGTOOL prompt appears slightly different to indicate that a continuation line is expected.
Command lines may include comments if desired. The beginning of a comment is indicated by the "{" character. A "}"
or Return terminates the comment (i.e., For Return everything after the "{" is ignored). The continuation character
"&" within a comment is ignored. For example:
LOGTOOL>status { This is a comment }
LOGTOOL>select log=1,2 { This is line 1's comment } &
LOGTOOL>ldev=4 { Note the "&" above was recognized! }