Monitor control

The monitor supports the MODIFY command with the following options:

Change the filter table (option I).
List the active filter table, the active output data set, the number of events recorded, the number of lost events, the ENQ delay of a systems enqueue and the RESMIL value in milliseconds (option L).
Note: The monitor measures ENQ delay and RESMIL at the time of the command. The monitor encounters the same contention for the processor and storage as does any other address space in the system. Therefore, even after the system grants the global resource request, the monitor might not receive control immediately because of processor or storage contention, and the accuracy of the ENQ delay measurement.

RESMIL is not displayed if GRS=NONE is specified in IEASYSxx or global resource serialization is in a star complex.
List the enqueue activities by MAJOR names, RNLs ACTION, if global resource serialization is active, and the approximate number of global and local requests (ENQs+DEQs) (option T).
List the RESERVE's activities by volume (option V).
Switch the active output data set (option SW).
List the active RNL's entries (option R). This option offers a function similar to the MVS™ DISPLAY GRS,RNL=ALL command.
Stop the monitor (option STOP).
Cancel the monitor if it is a batch job (option C).

To stop the monitor the MVS P JOBNAME command can be used along with the MODIFY option STOP.

Figure 1 shows all the supported options.

Figure 1. AUDIT MODIFY Command Options

     F  JOBNAME,I=xx          RE-INITIALIZE FILTER TABLE
                                    xx RANGE FROM 00 TO 09

     F  JOBNAME,L              DISPLAY INTERCEPTED SVCS
                                     ACTIVE  DDNAME & FILTER-TABLE
                                     NUMBER TRACED EVENTS
                                     NUMBER LOST   EVENTS
                                     ENQ  DELAY IN MICROSEC
                                     RESMIL        IN MILLISEC

     F  JOBNAME,T              DISPLAY THE ENQ/RES MAJOR-NAMES
                                    ACTIVITIES

     F  JOBNAME,T=MAJOR     DISPLAY THE ENQ/RES MAJOR-MINOR
                                      NAMES ACTIVITIES

     F  JOBNAME,V                DISPLAY THE VOLUMES WITH RESERVE
                                      ACTIVITIES

     F  JOBNAME,V=VOLSER     DISPLAY THE VOLUME's RESERVES


     F  JOBNAME,T=FREEMAIN   RESET THE DATASPACE's CONTENT
                     V=FREEMAIN

     F  JOBNAME,R                 LIST THE ACTIVE RNLs

     F  JOBNAME,SW              SWITCH OUTPUT DATA SET

     F  JOBNAME,STOP           STOP THE MONITOR. PARTIALLY
                                       FILLED BUFFER IS WRITTEN.

     P  JOBNAME                  STOP THE MONITOR. PARTIALLY
                                      FILLED BUFFER IS WRITTEN.

     C  JOBNAME                  ONLY IF NOT STARTED. PARTIALLY
                                      FILLED BUFFER IS NOT WRITTEN

Figure 2 shows sample output for option L if global resource serialization is in a ring configuration.

Figure 2. AUDIT MODIFY Option L Output Example

F JOBNAME,L

ISGAU008 - ISGAMF08 ACTIVE
ISGAU008 - OUTPUT1  ACTIVE
ISGAU008 - I=00004718 L=00000000 ENQ-DELAY=00009274 RESMIL=0010

I=xxx         number of events traced     L=yyy  number of lost events
ENQ-DELAY=zzz time in microsec required by a SYSTEMS ENQ to complete

Figure 3 shows sample output for option L if global resource serialization is in a star complex or GRS=NONE is specified in IEASYSxx.

Figure 3. AUDIT MODIFY Option L Output Example (GRS=NONE or GRS in Star)

F JOBNAME,L

ISGAU008 - ISGAMF08 ACTIVE
ISGAU008 - OUTPUT1  ACTIVE
ISGAU008 - I=00004718 L=00000000 ENQ-DELAY=00009274

I=xxx         number of events traced     L=yyy  number of lost events
ENQ-DELAY=zzz time in microsec required by a SYSTEMS ENQ to complete
RESMIL=wwww   not displayed if GRS=NONE is specified in IEASYSxx or
              global resource serialization is in a star complex.

You can use the MODIFY option T command to find out the major names used in the system and to verify the RNLs action. For a sample output see Figure 4 and Figure 5.

Figure 4. AUDIT MODIFY Option T Example

F ISGRUNAU,T

  DATA SPACE USED=00024906 number in bytes
  ENQDELAY=00001245 result of the command being issued. 
                    A single SYSTEMS scope ENQ/DEQ pair time is 
                    measured and this how long it took in micro seconds.

  GLOBAL=00000006 LOCAL=00000979 
  MINORS=00000170 number of unique RNAMEs
  VOLUMES=00000003  number of unique volumes specified on RESERVEs 
  MAJORS=00000029 RNL number of unique QNAMEs


00000025 IGWLHANZ SYSTEM 
00000013 SPFEDIT E*SYSTEM 
00000065 SYSDSN SYSTEM 
00000061 SYSIEFSD SYSTEM 
00000141 SYSIGGV2 E*RESERVE 
00000005 SYSIKJPL SYSTEM 
00000002 SYSIKJUA SYSTEM 
00000001 SYSVTOC E*SYSTEM 
00000001 SYSZ#SSI N SYSTEM 
00000004 SYSZAUDT N SYSTEMS 

C*  ->  RESERVE-converted       SYSTEMS   HW-RESERVE eliminated
E*  ->  RESERVE-excluded        SYSTEM    HW-RESERVE issued
I*  ->  system -included   from SYSTEM    to SYSTEMS
E*  ->  systems-excluded   from SYSTEMS   to SYSTEM
N   ->  RNL=NO     request

The command MODIFY option T=major lists the minor names used by the selected major name. For a sample output see Figure 5.

Figure 5. AUDIT MODIFY Option T=Major Example

F JOBNAME,T=SYSVTOC

Rt COUNT VOLSER  DEVNO  MAX   ELAPSED SEC  AVE    MIN    MAX   TOTAL
min.                    RES.               msec.msec.msec.sec.
--------------------------------------
00000047 SYSVTOC      RESERVE
00 00010 STSO02   STSO02                  000183 000071 000325 000001
00 00014 RUBB01   RUBB01                  000114 000046 000153 000001
00 00003 PR0002   PR0002                  000108 000057 000141 000000
00 00007 PR0001   PR0001                  000130 000068 000147 000000
00 00001 HSMMG5   HSMMG5                  000067 000067 000067 000000
00 00002 HSMMG4   HSMMG4                  000102 000047 000158 000000
00 00002 HSMMG3   HSMMG3                  000122 000061 000184 000000
00 00004 HSMMG2   HSMMG2                  000216 000166 000306 000000
00 00002 HSMMG1   HSMMG1                  000093 000050 000137 000000
00 00002 DB0002   DB0002                  000156 000152 000161 000000

The MODIFY command option V lists the volumes with RESERVE activities. For a sample output see Figure 6 and Figure 7.

Figure 6. AUDIT MODIFY Option V Example

F JOBNAME,V

COUNT    VOLSER  DEVNO  MAX   ELAPSED SEC  AVE    MIN    MAX   TOTAL
                        RES.               msec.msec.msec.sec.
00000125 STSO04  02AD   04   *00002102*   000047 000012 001546 000005
00000650 STSO02  01A6   04   *00002692*   000041 000008 002156 000027
00000773 STSO01  01AD   06   *00002626*   000046 000006 002558 000035
00000205 RUBB01  0234   03   *00002638*   000021 000006 000163 000004
00000002 RES43B  023B   01   *00001592*   000097 000089 000105 000000
00000004 PR0003  02AF   01   *00000213*   000197 000143 000231 000000
00000003 HSMMG2  01A3   01   *00001032*   000232 000183 000306 000000
00000013 HSMMG1  01A1   02   *00001032*   000089 000018 000342 000001
00000110 DB0002  01AA   02   *00001821*   000018 000006 000152 000001
00000039 DB0001  01A9   02   *00000615*   000012 000006 000119 000000
00002469 CAT430  023C   03   *00002698*   000214 000006 001243 000529

The MODIFY command option V=volser lists the RESERVE requests issued against the selected volume. For a sample output see Figure 7.

Figure 7. AUDIT MODIFY Option V=Volser Example

F JOBNAME,V=CAT430

Rt COUNT VOLSER  DEVNO  MAX   ELAPSED SEC  AVE    MIN    MAX   TOTAL
min.                    RES.               msec.msec.msec.sec.

00001352 CAT430  023C   03   *00001922*   000272 000006 001243 000369
--------------------------------------------
00 00479 SYSZVVDS CAT430                  000016 000004 000187 000007
02 00065 SYSZRACF SYS1.RACF               000033 000016 000140 000002
10 00329 SYSZJES2 CAT430SYS1.HASPCKPT     001096 001064 001243 000359
00 00479 SYSIGGV2 CATALOG.CAT430          000019 000005 000188 000009

First two digits = Rate per minute

The MODIFY command options T=FREEMAIN and V=FREEMAIN can be used to reinitialize the dataspace without stopping and restarting the monitor.

The MODIFY option R command shows the active RNL's entries used.