Entering the LOG Configurator

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.

To set the number of processes or users per process, enter ULOG followed by the number of processes or users:

   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>CLEAR 

Once 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>HOLD 

You 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 newgroupname 

Refer 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:

Enter HELP after the LOGTOOL prompt for more information. The STATUS command reports on the status of all system log files.

The following example shows the use of the STATUS command in the sequence of printing a log.

   RUN LOGTOOL 
   LOGTOOL>status
   LOGTOOL>list log=0027 outfile=LP

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 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=PAYROLL

This 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