Using QMGTOOLS and the dumpcsvfsmapinfo macro in STRSST

Answer

These instructions describe how to use a combination of the utilities in QMGTOOLS and the dumpcsvfsmapinfo macro to collect disk fragmentation information every 15 minutes. Additional steps are aso included if a custom sign-on display is being used.

First, ensure that the PTF that provides the macro is applied and that the latest version of QMGTOOLS is installed. The PTF can be applied immediately and provides only the macro.

o PTFs - MF63073 (R720) and MF63132 (R730)

o QMGTOOLS - http://www-01.ibm.com/support/docview.wss?uid=nas8N1011297

1) FTP this save file to the partition and restore it:

RSTOBJ OBJ(*ALL)
SAVLIB(QMGTOOLS)
DEV(*SAVF)
SAVF(library/savf)

nm.savf

** Or, create program QMGTOOLS/NM from this source. Source of program QMGTOOLS/NM program:

        PGM        PARM(&DELAY &MACROLIB &MACRO)                
         DCL        VAR(&DELAY) TYPE(*CHAR) LEN(4)              
         DCL        VAR(&MACROLIB) TYPE(*CHAR) LEN(10)          
         DCL        VAR(&MACRO) TYPE(*CHAR) LEN(10)              
 REPEAT:                                                        
         CALL       PGM(QMGTOOLS/VTMAAMAIN) PARM('*START    ' +  
                      '*CUSTOM   ' '  DISPLAY   QTILIB    Y' +  
                      '  SSTDUMPS  QTILIB    N' +                
                      &MACRO &MACROLIB 'N')                      
         DLYJOB     DLY(&DELAY)                                  
         GOTO       CMDLBL(REPEAT)                              
 ENDPGM                                                          

2)  Macro Setup:  

Follow these instructions exactly and be sure to press enter and the appropriate function keys.  
Note that the OS user id and password must be able to signon with the SST id specified or this will not work.  

QMGTOOLS/VTMAACMD FUNCTION(*SETUP) DTAPRF(NM) DTAPRFLIB(QGPL)  <enter>

Fill out the screen as follows using your operating system and SST credentials.  

                  SST AA macro setup (VTMSSTCFG)          
                                                         
Type choices, press Enter.                                      
                                                         
Signon user ID . . . . . . . . .   yourOSid      User ID        
Signon user pass . . . . . . . .   yourOSpwd     User pass      
Verify signon user pass  . . . .   yourOSpwd     User pass      
SST user ID  . . . . . . . . . .   yourSSTid     User ID        
SST user password  . . . . . . .   yourSSTpwd    User pass      
SST verify user password . . . .   yourSSTpwd    User pass      
Virtual device . . . . . . . . .   *AUTO         Device name    
Data area prefix . . . . . . . . > NM         Prefix      
Data area prefix library . . . . > QGPL          Library  

Press Enter, then fill out the Macro 1 information as below.    

Press Enter, then fill out the Macro 1 information as below.    

                          AA Macros                              
                                                                   
Macro 1 :  dumpcsvfsmapinfo                                                      
Options :                               

Press F6 to update.

                                                                   
3) CRTLIB QTILB <enter>

4) Submit the job that will run the macro every 15 minutes and using the . The output will be members in database file QTILIB/SSTDUMPS
SBMJOB CMD(CALL PGM(QMGTOOLS/NM) PARM('0900' 'QGPL' 'NM'))
JOB(NM)
JOBQ(QSYS/QSYSNOMAX)

5) A new member will be added to the file QTILIB/SSTDUMPS every 15 minutes. Each record in the member represents a disk unit and will report the fragmentation.
Here's one method to look at the last member that was added:

DSPPFM FILE(QTILIB/SSTDUMPS) MBR(*LAST)
                 

Note the first column, 32, 31, 30, and 29 are the disk units. And, 61.63, 64.38, 62.75, and 59.64 are the corresponding fragmentation.

6) If the data is requested by IBM, save and send the QTILIB/SSTDUMPS file.




Additional steps if a custom sign-on screen is being used.

a) Create the new subsystem:

CRTSBSD SBSD(QTILIB/QINT)
POOLS((1 *BASE) (2 *INTERACT))
SGNDSPF(*QDSIGNON)

b) Add the workstation entry for MACRO:

ADDWSE SBSD(QTILIB/QINT)
WRKSTN(MACRO)
JOBD(QGPL/QDFTJOBD)

c) Add a routing entry:

ADDRTGE SBSD(QTILIB/QINT)
SEQNBR(9999)
CMPVAL(*ANY)
PGM(QSYS/QCMD)
CLS(QGPL/QINTER)

d) Start the new subsystem:
STRSBS QTILIB/QINT

e) Prevent the workstation from going to the normal interactive subsystem:
ADDWSE SBSD(QSYS/QINTER)
WRKSTN(MACRO)
AT(*ENTER)

Replace step 2 with this version, specifying MACRO for the virtual device.
QMGTOOLS/VTMAACMD FUNCTION(*SETUP) DTAPRF(NM) DTAPRFLIB(QGPL)  <enter>

Fill out the screen as follows using your operating system and SST credentials.  

                  SST AA macro setup (VTMSSTCFG)          
                                                         
Type choices, press Enter.                                      
                                                         
Signon user ID . . . . . . . . .   yourOSid      User ID        
Signon user pass . . . . . . . .   yourOSpwd     User pass      
Verify signon user pass  . . . .   yourOSpwd     User pass      
SST user ID  . . . . . . . . . .   yourSSTid     User ID        
SST user password  . . . . . . .   yourSSTpwd    User pass      
SST verify user password . . . .   yourSSTpwd    User pass      
Virtual device . . . . . . . . .   MACRO         Device name    
Data area prefix . . . . . . . . > NM         Prefix      
Data area prefix library . . . . > QGPL          Library  

Press Enter, then fill out the Macro 1 information as below.    

Press Enter, then fill out the Macro 1 information as below.    

                          AA Macros                              
                                                                   
Macro 1 :  dumpcsvfsmapinfo                                                      
Options :                               

Press F6 to update.