Entering the LOG Configurator
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Glossary | |
| Index | |
| E0802 Edition 7 | |
| E0201 Edition 6 ♥ | |
| E0796 Edition 5 |
sysgen>LOG
** LOG configurator commands **
show (sh) slog (sl) ulog (ul)
clear (cl)(c) exit (ex)(e) help (he)(h) hold (ho)
oclose (oc) redo
log>
Using the LOG Configurator Help Facility
The help facility enables you to quickly identify the function and syntax of those LOG configurator commands and options for performing the multiple operations that define or change logging processes. To obtain a list of the commands available for use in the LOG configurator, enter HELP at the LOG configurator prompt as shown in Example 6-2. Example 6-2 LOG Configurator Help
log>HELP
** LOG configurator commands **
show (sh) slog (sl) ulog (ul)
clear (cl)(c) exit (ex)(e) help (he)(h) hold (ho)
oclose (oc) redo
log>
To display the syntax for each available command, enter HELP ALL as
shown in Example 6-3.
Example 6-3 LOG Configurator HELP ALL
log>HELP ALL
command (abb) parameter=value
------------- ---------------
show (sh) [command = SLOG|ULOG|ALL]
[dest = OFFLINE]
slog (sl) [on = event#,...]
[off = event#,...]
ulog [nlogprocs = number processes allowed]
[usersperproc = users per logging process]
log>
Entering HELP commandname provides help for a specific
command:
log>HELP SHOW
show (sh) [command = SLOG|ULOG|ALL]
[dest = OFFLINE]
Showing Current LOG Values
The SHOW command displays the LOG values as currently set. SHOW has the following parameters:
SHOW [COMMAND = SLOG ]
ULOG ]
ALL ]
[DEST = OFFLINE ]
SLOG lists the state of the system logging events.
ULOG lists the number of user logging processes and users per logging
process currently configured.
ALL lists all the information associated with the LOG configurator.
OFFLINE redirects the output of the SHOW command to the SYSGEN
listing file, SYSGLIST. Using OFFLINE does not immediately
generate a printout. The information is sent to SYSGLIST until you
either enter the OCLOSE command or exit the configurator. Exiting the
configurator or using OCLOSE closes SYSGLIST and prints the file.
Using SHOW without using any parameters, is the same as specifying
SHOW ALL. In addition, the value entered for the ULOG
parameter includes the minimum, maximum, current, and default values.
To show the current user logging process in Example 6-4, enter SHOW ULOG:
Example 6-4 Showing User Logging Processes
log>SHOW ULOG
configurable item max min current
----------------- ------- ------- -------
# of user logging processes 128 2 64
# users per logging process 1140 1 128
To view all currently configured values, as shown in Example 6-5, enter
SHOW ALL:
Example 6-5 Showing All Configured Values
log>SHOW ALL
configurable item max min current
----------------- ------- ------- -------
# of user logging processes 128 2 64
# users per logging process 1140 1 128
system log events event # status
----------------- ------- ------
System Logging 100 ON
System Up 101 ON
Job Initiation 102 OFF
Job Termination 103 OFF
Process Termination 104 OFF
NM File Close 105 OFF
System Shutdown 106 ON
Power Failure 107 ON
I/O Error 111 ON
Physical Mount/Dismount 112 OFF
Logical Mount/Dismount 113 OFF
Tape Label 114 OFF
Console Log 115 ON
Program File Event 116 ON
Native Mode Spooling 120 ON
File Quarantine Event 121 OFF
Chdir 127 OFF
Process Adoption 128 OFF
File Owner Change 129 OFF
Architected Interface 130 OFF
Additional Processor Launch 131 ON
Password Change 134 OFF
System Logging Configuration 135 OFF
Restore 136 ON
Printer Access Failure 137 OFF
ACD Change 138 ON
Stream Initiation 139 ON
User Logging 140 ON
Process Creation 141 OFF
Security Configuration Change 142 OFF
Chgroup 143 ON
File Open 144 OFF
CI Command Logging 145 OFF
Maintenance Request 146 ON
UPS Monitor Event Logging 148 OFF
Diagnostic Information 150 ON
High Priority Machine Check 151 ON
Low Priority Machine Check 152 ON
Directory Open/Close Logging 155 OFF
CM File Close 160 OFF
Logging System Events
System logging records the use of certain resources by accounts, groups, and users. System logging can be used for several purposes, such as billing or obtaining an overview of system use. System logging describes system use by creating a running log of actual events, correlating the event with a job and session. The system manager chooses which events to enable or disable by setting an event number to ON or OFF. (Refer to the preceding example for a list of event numbers and their definitions.) The SLOG command enables and disables the selected system logging events. SLOG has the following parameters:
SLOG (SL) [ON = event#,... ]
[OFF = event#,... ]
Enable the logging of an event by entering SLOG event#,...:
log>SLOG 100 (Event 100 enabled)
or
log>SLOG ON=100 (Event 100 enabled)
Disable the logging of an event by entering SLOG OFF=event#,...:
log>SLOG OFF=100 (Event 100 disabled)
Entering SLOG without ON enables logging. Entering SLOG
without an event number causes an error:
log>SLOG
(error - no parameters are specified)''
Logging event 100 is a special case. If 100 is off, no logging
(except that forced on by MPE/iX) takes place.
 |
NOTE: Some events are permanently set to ON. Currently, events 101, 111, 146, and 150 are forced on by MPE/iX.MPE/iX is shipped from the factory with event number 116 "Program File Event" turned ON. Hewlett-Packard recommends that customers leave this event turned ON, as it can be useful for detecting potentially incompatible (and rare) runtime events. |
Logging User Events
User logging provides a means for system users and subsystems to record additions and modifications to databases and other files using application programs. The system manager determines the maximum number of logging processes and the maximum number of users per logging process. The ULOG command configures the user logging process parameters. ULOG has the following parameters:
ULOG (UL) [NLOGPROCS = numberprocesses allowed ]
[USERSPERPROC = usersperloggingprocess]
NLOGPROCS controls the user logging ID (LID) table size. Lowering
NLOGPROCS loses all current logging ID information from the tape
created by SYSGEN. If NLOGPROCS remains unchanged or increases, the
current logging ID information is copied to tape. The minimum and maximum number
of processes allowed are 2 and 128, respectively.
USERSPERPROC specifies the maximum number of users assigned to each
configured logging process. The minimum and maximum number of users per logging
process are 1 and 1140, respectively.
|
NOTE: Changing NLOGPROCS takes effect when a tape is created and an UPDATE CONFIG or INSTALL is conducted. Refer to Chapter 3 "System Startup Functions" for information on installing or updating the operating system. |
log>ULOG 40 ** Number of Processes **or
log>ULOG USERSPERPROC=40 ** Number of Users per Process **
Clearing Log Configuration Changes
If you desire to clear all LOG configuration changes made, enter the CLEAR command at the LOG configurator prompt.
log>CLEAROnce a SYSGEN> KEEP is done, the changes kept become permanent and CLEAR does not remove them.
Holding and Saving Configuration Changes
Using the system logging and user logging commands described in the following sections changes the LOG configuration specified in the SYSGEN command line or global BASEGROUP command. These changes are temporary and are easily lost if not properly saved. Saving configuration changes is a two-step procedure. After you alter a configuration, you must, first, hold the changes before exiting the configurator. Second, use the global module KEEP command to save the changes. To hold changes, enter the HOLD command at the LOG configurator prompt:
log>HOLDYou can work in a SYSGEN configurator, hold the changes, and continue working in other SYSGEN configurators before saving the changes. To save the changes, hold all desired changes, exit to SYSGEN's global module, and issue the KEEP command:
sysgen>KEEP newgroupnameRefer to Chapter 4 "Using the System Generator (SYSGEN)" for additional information on using the KEEP command.
Entering an MPE Command from the LOG Configurator
Use the colon (:) to introduce an MPE command from the LOG configurator. To issue an MPE command, enter the command along with the colon. For example,
log>:SHOWTIME
THU, APR 20, 1989, 2:55PM
log>
Exiting the LOG Configurator
Use the EXIT command to terminate the LOG configurator and return to the SYSGEN global module. Exit may be abbreviated EX or E. To end working in the LOG configurator, enter EXIT at the LOG configurator prompt:
log>EXIT sysgen>
Printing a Log File
To analyze your logs and to read what you are logging, you must print your log files. To do this, use the LOGTOOL utility program. Enter RUN LOGTOOL. In order to print a log, issue the following:
RUN LOGTOOL
LOGTOOL>LIST LOG=log# OUTFILE=LP
LOGTOOL>EXIT
RUN LOGTOOL LOGTOOL>status LOGTOOL>list log=0027 outfile=LPIf you do not specify the OUTFILE parameter, the log prints on your terminal screen. Typically this report is very long and ties up your terminal for quite some time. If this does happen, you can enter CTRL Y to break the process.
Printing a Subset of a Log File
If you like, you can filter the output of LOGTOOL utility to show you information about only a specific user or users. The syntax for this is shown below.
LIST {LOG=log_name} [;JSNAME=job/session_name
;USER=user_name [...]
;ACCOUNT=account_name
The input for these commands should be no longer than 80 characters. Default
for all parameters is the wildcard @.
For example, to select log records from log files 1 through 5, with log
information about password changes (log type 134), and user identification
JTEST,MARIA.PAYROLL, you would enter the following.
>LIST LOG=1/5;TYPE=134;JSNAME=JTEST;USER=MARIA;ACCOUNT=PAYROLLThis selection option is valid for the log types listed below:
102 Job Initiation
103 Job Termination
104 Process Termination
105 NM File Close (also 160)
112 Physical Mount/Dismount
113 Logical Mount/Dismount
114 Tape Label
115 Console Log
116 Program File Event
120 Native Mode Spooling
130 Architected Interface
134 Password Change
135 System Logging Configuration
136 Restore
137 Printer Access Failure
138 ACD Change
139 Stream Initiation
140 User Logging
141 Process Creation
143 Chgroup
144 File Open
|
Chapter 6 Modifying Logging Configurations |
Chapter 7 Modifying Miscellaneous Configuration Elements |