View Metrics Setup and Use

Products

• OM View

Issue/Introduction

This document will explain the full procedure for setting up and using the View Metrics function.

 

Environment

View 14.0

Resolution

Please use the following steps:

• If using ISPF/TSO as the interface for the Metrics:
   
• Add the SARSMPT program name to the TSO Authorization Table, found in the IKJTSOxx member of SYS1.PARMLIB. The SARSMFT program name must be added to the AUTHTSF section.
   
• Run SARINIT, with SMFTYPE=nnn (where nnn is from 128 to 255), to designate a SMF record type that is not currently used elsewhere, which View will use to create its SMF records.
• Identify the current SMF dump file in use on the system where the Metrics program will be running.
• Use one of the following JCL streams to create a SMF file to be input to the Metrics program (SARMET01): 
  

  
  //XXXXXXXX JOB ...
  //IEFPROC  EXEC PGM=IFASMFDP,REGION=4M
  //SYSPRINT DD  SYSOUT=*
  //INDD1    DD  DISP=SHR,DSN=SYS1.MAN1
  //DUMPOUT  DD  DSN=xxxxxx.xxxxxx.SMFDUMP,
  //   DISP=(,CATLG),SPACE=(CYL,(500,20,RLSE),
  //   DCB=(LRECL=32756,BLKSIZE=32760,RECFM=VBS,BUFNO=45),
  //   UNIT=uuuu,VOL=SER=vvvvvv
  //SYSPRINT DD SYSOUT=*
  //SYSIN    DD DUMMY
  //
  
  //XXXXXXXX JOB ...                                                              
  //IFASMFDL EXEC PGM=IFASMFDL                                        
  //SYSPRINT DD SYSOUT=*                                           
  //DUMPOUT  DD DSN=xxxxxx.xxxxxx.SMFDUMP0,                          
  //    DISP=(,CATLG),SPACE=(CYL,(500,20,RLSE),                            
  //    DCB=(LRECL=32756,BLKSIZE=32760,RECFM=VBS,BUFNO=45),
  //    UNIT=uuuu,VOL=SER=vvvvvv
  //SYSIN    DD *                                                  
  LSNAME(IFASMF.SysID.STREAM,OPTIONS(DUMP)) 
  OUTDD(DUMPOUT,TYPE(nnn))                                              
  /*                                                                    
  //* IDCAMS REPRO THE ACTIVITY FILE TO A FLAT FILE                           
  //*===================================================================
  //STEP0001 EXEC PGM=IDCAMS,REGION=2048K                               
  //SYSPRINT DD SYSOUT=*                                                
  //INDD  DD DISP=SHR,DSN=xxxxxx.xxxxxx.SMFDUMP0                          
  //OUTDD DD DSN=xxxxxx.xxxxxx.SMFDUMP1,
  //    DISP=(,CATLG),SPACE=(CYL,(500,20,RLSE),                           
  //    DCB=(LRECL=32756,BLKSIZE=32760,RECFM=VBS,BUFNO=45),
  //    UNIT=uuuu,VOL=SER=vvvvvv
  //SYSIN DD *                                                          
       REPRO OUTFILE(OUTDD) INFILE(INDD)                                
  /*                                                                    
  //                                                                                           
   

   
• To run the Metrics process, use JCL similar to the following:
   

  //XXXXXXXX JOB ...
  //SORT     EXEC PGM=SARMET01
  //STEPLIB  DD  DISP=SHR,DSN=VIEW.CVDELOAD     <=== MODIFY, IF USED
  //SYSPRINT DD  SYSOUT=*                                           
  //SYSIN     DD *                                                  
  SMFTYPE=nnn,DATE=1yyddd-1yyddd,TIME=0000-2359,RPT=FILE
  SMFTYPE=nnn,DATE=1yyddd-1yyddd,TIME=0000-2359,RPT=ACCS
  SMFTYPE=nnn,DATE=1yyddd-1yyddd,TIME=0000-2359,RPT=CHNG                                 
  SMFTYPE=nnn,DATE=1yyddd-1yyddd,TIME=0000-2359,RPT=DELE            
  SMFTYPE=nnn,DATE=1yyddd-1yyddd,TIME=0000-2359,RPT=USER            
  SMFTYPE=nnn,DATE=1yyddd-1yyddd,TIME=0000-2359,ELAP=01,RPT=LOAD    
  /*                                                                
  //SMFIN     DD DISP=SHR,DSN=XXXXXX.XXXXXX.SMFDUMP1                
  //USERSMF   DD DUMMY                                              
  //*USERSMF   DD DSN=xxxxxx.xxxxxx.METRICS.USERSMF,DISP=(,CATLG,DELETE), 
  //*             SPACE=(CYL,(1,1),RLSE),UNIT=SYSDA,VOL=SER=vvvvvv  
  //ACCS      DD SYSOUT=*                                           
  //DELE      DD SYSOUT=*                                           
  //USER      DD SYSOUT=*                                           
  //LOAD      DD SYSOUT=*                                           
  //SYSOUT    DD SYSOUT=*                                           
  //PRINTER   DD SYSOUT=*                                           
  //SORTWK01  DD UNIT=SYSDA,SPACE=(CYL,(1,1),RLSE)                  
  //SORTWK02  DD UNIT=SYSDA,SPACE=(CYL,(1,1),RLSE)                  
  //SORTWK03  DD UNIT=SYSDA,SPACE=(CYL,(1,1),RLSE) 
  //SYSUDUMP  DD SYSOUT=*
  //  
                                              

For the control cards:

SMFTYPE=nnn,DATE=1yyddd-1yyddd,TIME=0000-2359,RPT=FILE

SMFTYPE=nnn,DATE=1yyddd-1yyddd,TIME=0000-2359,RPT=ACCS

SMFTYPE=nnn,DATE=1yyddd-1yyddd,TIME=0000-2359,RPT=CHNG

SMFTYPE=nnn,DATE=1yyddd-1yyddd,TIME=0000-2359,RPT=DELE

SMFTYPE=nnn,DATE=1yyddd-1yyddd,TIME=0000-2359,RPT=USER

SMFTYPE=nnn,DATE=1yyddd-1yyddd,TIME=0000-2359,ELAP=nn,RPT=LOAD

 

• nnn is the SMFTYPE (128 to 255) as defined in the SARINIT parameters. yyddd is a Julian date, used in a range
   
• The control card with RPT=FILE, used in conjunction with the JCL statement "//USERSMF DD ...", specifies the File that contains the View Metrics SMF records output.
   
• The control cards with RPT=ACCS, RPT=CHNG, RPT=DELE, and RPT=USER, will generate Access, Change, Delete, and User reports, respectively.
   
• The control card with ELAP=nn (00-99) is used for the Load report, where nn indicates the elapsed time (in days) from the time of a disk delete of a report to the reload of the report to the disk layer.

For more detailed information, including the contents of the SMF records, and for samples of the different reports that are created, please see the "Metrics" chapter, in the View Reference Guide.