HP 3000 Manuals

HP Performance Collection Software User's Manual (for MPE Systems)

Using UTILITY to Filter Log Files 

You can use the UTILITY program to process alarms against an existing
Performance Collection Software log file to decide if the log file
contains situations that you will want to study in more detail.  While it
is easy to perform this operation interactively, as described earlier, it
might be best to perform this task in a more automated fashion.

To facilitate the batch capability of Performance Collection Software
alarms, the UTILITY program will save the alarm summary results in Job
Control Words (JCWs) which can be interrogated by standard MPE Job
Control Language.

Two Job Control Words are created and set for each alarm defined in the
PARM file.

   *   RXALARMCOUNTn is set to the number of times the alarm was
       triggered or was repeated (n is the sequence number of the alarm
       in the PARM file).

   *   RXALARMTIMEn is set to the number of minutes for which the nth
       alarm was active.

   *   RXSCANHOURS is set to indicate the total number of hours
       Performance Collection Software data was scanned.


NOTE  The individual alarms need not be listed during the SCAN in order
      to set the JCW values.


The following batch job will (1) extract the last week's data from the
raw log files, (2) scan it using the UTILITY program, then (3) DSCOPY it
to a central system for analysis if it is interesting.

     !JOB SCOPE.SYS,SCOPE
     !RUN EXTRACT                  (Extract the last week's data)
     LOG LOGGLOB.SCOPE.SYS
     START TODAY-7
     OUTPUT RXLOG,PURGE
     GLOBAL BOTH
     APPLICATION BOTH
     PROCESS DETAIL
     DISCSPACE DETAIL
     EXTRACT
     EXIT
     !RUN UTILITY                  (Now scan the extracted file.)
     LOG RXLOG
     PARM PARMALRM                 (PARMALRM contains alarm definitions.)
     DETAIL OFF                    (Save paper, don't list details.)
     ALARMS OFF                    (Don't list individual alarms.)
     SCAN                          (Scan the log file.)
     EXIT                          (UTILITY is done, the JCWs have been set.)
     !SETJCW INTERESTING=0         (Set my own JCW to "uninteresting.")
     !IF RXALARMCOUNT1>0 THEN      (If alarm 1 went off even 1 time.)
     ! SETJCW INTERESTING=1        (I am interested.)
     !ENDIF
     !IF RXALARMTIME2>60 THEN      (IF alarm 2 was ON for more than one hour.)
     ! SETJCW INTERESTING=2        (I am interested.)
     !ENDIF
     !IF INTERESTING>0 THEN        (IF I am interested.)
     ! REMOTE HELLO SCOPE.SYS,SCOPE;DSLINE=CENTRAL (Ship it to central.)
     ! DSCOPY RXLOG TO THISONE,CENTRAL;MOVE
     ! REMOTE BYE
     !ENDIF                        (Otherwise do nothing.)
     !EOJ

MPE/iX 5.0 Documentation