HP 3000 Manuals HP 3000 Manuals
Using the LOG Configurator
You use the LOG configurator to display information about system and user
logging, print log files, and choose which events the system will record.
To enter the LOG configurator
You make all system and user logging changes from with the LOG
configurator, which is one of the SYSGEN modules. To enter the LOG
configurator, do as follows:
1. At the MPE prompt, start SYSGEN by entering:
SYSGEN
2. At the SYSGEN prompt (sysgen>), start the LOG configurator by
entering:
sysgen>LOG
You will see a list of the commands available to you in the LOG
configurator. (See the example below.) To issue a command, you
can either enter the full name or you can enter the abbreviated
version shown in parentheses.
___________________________________________________________________________
| |
| |
| 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 |
| |
___________________________________________________________________________
Example 4-1. Activating the LOG Configurator
To display on-line help
Use the HELP command to get information about the commands available to
you in the LOG configurator.
* To display a complete list of commands and a brief explanation of
each one, at the log> prompt enter:
log>HELP
* To display information about one of the LOG configurator commands,
at the log> prompt enter HELP followed by the command name. For
example, to get help on the SLOG command, enter:
log>HELP SLOG
To show current LOG values
Use the LOG configurator's SHOW command to display current LOG values on
the system console or to print them offline. At the LOG prompt (log>),
enter:
log>SHOW parameters
SHOW has the following parameters:
[ {SLOG}]
SHOW [[COMMAND =] {ULOG}] [[DEST =] OFFLINE]
[ {ALL }]
--------------------------------------------------------------------------------------------
| | |
| Parameter | Definition |
| | |
--------------------------------------------------------------------------------------------
| | |
| 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. |
| | This is the default parameter. |
| | |
--------------------------------------------------------------------------------------------
| | |
| 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 SYSGEN |
| | or using OCLOSE closes SYSGLIST and prints the file. |
| | |
--------------------------------------------------------------------------------------------
To see partial logging information.
You can use the SHOW command to see only the values for system logging or
user logging (instead of for both). For example, to display the current
status of user logging processes, enter:
log>SHOW ULOG
The LOG configurator displays the minimum, maximum, current, and default
values for your system. (See the example below.)
_______________________________________________________________________
| |
| |
| log>SHOW ULOG |
| configurable item max min current |
| ----------------- ------- ------- ------- |
| # of user logging processes 64 2 64 |
| # users per logging process 1024 1 128 |
| |
_______________________________________________________________________
Example 4-2. Showing User Logging Processes
To see all logging information.
To display all currently configured values, you can enter:
log>SHOW
Or, you can enter:
log>SHOW ALL
The LOG Configurator displays the minimum, maximum and current value for
user log events and the name, number and status (OFF or ON) of system log
events.
To print current logging information.
Instead of displaying logging information on the console, you can print
it offline. To do so, add the DEST=OFFLINE parameter to the end of the
command line. For example, to print a copy of system logging data,
follow these steps:
1. Send the output of the SHOW command to the file SYSGLIST by
entering:
log>SHOW SLOG DEST=OFFLINE
2. Close the file SYSGLIST and print the information by entering:
log>OCLOSE
Note that you can also exit the LOG Configurator to close and print
SYSGLIST.
To log system events
System logging keeps a running log of certain resources so that you can
monitor their use by accounts, groups and users. You can use system
logging for billing purposes or simply to see an overview of system use.
To determine which events are logged, you use the SLOG command to turn
them on or off.
SLOG has the following parameters:
SLOG (SL) [[ON =] event#,...] [[OFF =] event#,...]
NOTE You can turn off all events except the following three which are
always on: system up record (event 101), I/O record (event 111),
and diagnostic information record (event 150).
Before you change the system logging configuration, enter the SHOW SLOG
command to see which events are currently ON or OFF. Your console will
display something like the example on the next page.
___________________________________________________________________
| |
| |
| log>SHOW SLOG |
| |
| system log events event # status |
| ----------------- ------- ------ |
| System logging enabled 100 OFF |
| System up record 101 ON |
| Job initiation record 102 OFF |
| Job termination record 103 OFF |
| Process termination record 104 OFF |
| NM file close record 105 OFF |
| System shutdown record 106 ON |
| Power failure record 107 ON |
| I/O error record 111 ON |
| Physical mount/dismount 112 OFF |
| Logical mount/dismount 113 OFF |
| Tape labels record 114 OFF |
| Console log record 115 ON |
| Program file event 116 ON |
| NCS spooling log record 120 ON |
| Architected interface record 130 0N |
| Password changes 134 ON |
| System logging configuration 135 ON |
| Restore logging 136 ON |
| Printer access failure 137 ON |
| ACD changes 138 ON |
| Stream initiation 139 ON |
| User logging 140 ON |
| Process creation 141 ON |
| Chgroup record 143 ON |
| File open record 144 ON |
| Maintenance request log 146 OFF |
| 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 |
| Chdir 161 OFF |
| Process Adoption 162 OFF |
| File Owner Change 163 OFF |
| log> |
| |
___________________________________________________________________
Example 4-3. Sample Configured Values
To enable an event.
For any of the system log event are listed as OFF when you issue the SHOW
command, you can quickly enabled them. To do so, note the number of the
event that you want to enable and use the ''SLOG'' command.
For example, to enable stream initiation (event 139), at the log> prompt
enter:
log>SLOG 139
Or, you can enter:
log>SLOG ON=139
Suppose that you have enabled event 139 (stream initiation), and a user
JOHN in the group DOE of the PAYROLL account logs on with the session
name JREPORT. If he streams the job file JTEST.TESTGP.TESTACCT that was
logged on as #J12, the system logs the following information:
__________________________________________________________________
| |
| |
| USER: JOHN GROUP: DOE |
| ACCOUNT: PAYROLL JSNAME: JREPORT |
| INPUT LDEV: 21 DEV NAME: TERM |
| JOB FILE NAME: JTEST.TESTGP.TESTACCT |
| LOGON J/S TYPE: JOB LOGON J/S NAME: 12 |
| |
__________________________________________________________________
To disable an event.
To disable an event, you enter the SLOG command with the OFF parameter,
followed by the number of the event you want to disable. For example, to
disable the console log record (event 115), enter:
log>SLOG OFF=115
To disable all system logging.
To disable all system logging (except those events always monitored by
MPE, which you cannot turn off), specify event 100. For example:
log>SLOG OFF=100
To review one event recorded in the system log file.
You can use the LOGTOOL utility to review entries in the system log file
for a particular event. To do so, follow these steps:
1. List the names of the log files currently on your system. At the
MPE prompt, enter:
:LISTFILE LOG@.PUB.SYS
Note the number of the last log file in the list (other than
LOGDCC). You will use it in step 5.
2. Start the system diagnostic utility. At the MPE prompt, enter:
:SYSDIAG
3. Run the LOGTOOL utility. Enter:
DUI >RUN LOGTOOL
4. To review the current logfile, use the SWITCHLOG command to close
it and open a new one.
DUI >SWITCHLOG
5. List the information for a specific event in the log file that you
want to review. For example, if the last log file displayed with
the LISTFILE command was LOG00017 and you want information about
event 139, enter:
DUI >LIST LOG=17;TYPE=139
Or, if the last log file was LOG00017 and you then issued the
SWITCHLOG command, to see the most recent log file you would
enter:
DUI >LIST LOG=18;TYPE=139
In a moment, you will see the contents of the system log files for
event 139. If event 139 was disabled, you are informed that no
messages are found.
To control user logging
User logging provides a means for system users and subsystems to record
additions and modifications to databases and other files that use
application programs. As system manager, you determine the maximum
number of logging processes and the maximum number of users per logging
process.
Use the ULOG command to configure the user logging process parameters.
ULOG has the following parameters:
ULOG (UL) {[NLOGPROCS =] number processes allowed }
{[USERSPERPROC =] users per logging process}
--------------------------------------------------------------------------------------------
| | |
| Parameter | Definition |
| | |
--------------------------------------------------------------------------------------------
| | |
| NLOGPROCS | Controls the user logging ID (LID) table size. The minimum number |
| | of processes is 2 and the maximum is 64. The changes take effect |
| | when you perform an UPDATE CONFIG or an INSTALL with a system load |
| | tape that contains the new table size. If you lower NLOGPROCS, |
| | the system will not record any of the current logging ID |
| | information onto the system load tape. If you increase NLOGPROCS |
| | or leave it unchanged, the current information is copied to tape. |
| | |
--------------------------------------------------------------------------------------------
| | |
| USERSPERPROC | Controls the maximum number of users assigned to each configured |
| | logging process. The minimum number of users per logging process |
| | is 1 and the maximum is 1024. |
| | |
--------------------------------------------------------------------------------------------
For example, to set the number of logging processes to 40, enter:
log>ULOG 40
Or you can enter:
log>ULOG NLOGPROCS=40
To set the number of users per process to 40, enter:
log>ULOG USERSPERPROC=40
Or, you can enter:
log>ULOG ,40
To print a log
To read and analyze your logs, you must print your log files. To do
this, you use the LOGTOOL utility program in the following set of steps:
1. At the MPE prompt, enter the SYSDIAG command.
2. At the diagnostic user interface prompt (DUI>), enter
DUI>RUN LOGTOOL
3. Check the status of all system log files by entering:
LOGTOOL>STATUS
4. Choose a file to print and enter the LIST command followed by the
log number and the OUTFILE parameter. For example, to print log
27 (which appears as LOG00027 in the list), enter:
LOGTOOL>LIST LOG=27 OUTFILE=LP
5. Exit LOGTOOL by entering EXIT at the LOGTOOL> prompt.
6. Exit the diagnostic user interface by entering EXIT at the DUI>
prompt.
NOTE If 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 happens, you can enter
CTRL Y to break the process. Refer to the Online Diagnostic
Subsystem Utilities Manual (09740-90021) for more information
about LOGTOOL.