System Startup, Configuration, and Shutdown Reference Manual
> Chapter 6 Modifying Logging ConfigurationsEntering the LOG Configurator |
||||||||||||||||||||||||||||||
|
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 FacilityThe 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 ValuesThe 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 128To 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 EventsSystem 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.
Logging User EventsUser 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.
log>ULOG 40 ** Number of Processes **or log>ULOG USERSPERPROC=40 ** Number of Users per Process ** Clearing Log Configuration ChangesIf 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 ChangesUsing 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 ConfiguratorUse 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 ConfiguratorUse 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 FileTo 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>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 FileIf 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_nameThe 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:
|