Submitting the GFTAVMA JCL

After you have determined the filtering and report keywords you want to use for your volume mount analyzer run, you must submit the GFTAVMA job. To submit the GFTAVMA job, you:

Copy the JCL member, GFTAVMAP, from SYS1.SAMPLIB
Change only the indicated fields
Submit the GFTAVMA JCL for execution using the TSO SUBMIT command

Note: It is crucial to change only the indicated fields. If you use this JCL as is, you ensure the space calculation is accurate. GFTAVMA uses system determined block size and average record allocation. Since SORT is invoked multiple times, it is important not to have RLSE on the SORTxxxx and XTRCxxxx files.

For more information on using JCL, see z/OS MVS JCL Reference.


//GFTAVMA  JOB (ACCT#,'ACCOUNTING-INFORMATION'),'PROGRAMMER NAME',    1 
//         MSGCLASS=A,MSGLEVEL=(1,1),USER=&SYSUID,NOTIFY=&SYSUID
//*
//GFTAVMA PROC HLQ=,               * GFTAXTR FILE HIGH LEVEL QUALIFIER
//             RUN=,               * GFTAXTR FILE LOW  LEVEL QUALIFIER
//             REGVMA=6144K,       * DEFAULT REGION FOR 'GFTAVMA'
//             TAPES='20000,3000', * DEFAULT NUMBER OF TAPE MOUNTS
//             UNIT=SYSDA,         * DEFAULT ESOTERIC UNIT NAME
//             FILTERS=1000        * MAXIMUM NUMBER OF FILTERS
//*********************************************************************
//*                                                                   *
//*           GFTAVMA -- VOLUME MOUNT ANALYSIS PROGRAM                *
//*                                                                   *
//*********************************************************************
//*                                                                   *
//* THIS JCL IS USED TO RUN THE 'GFTAVMA' ANALYSIS PROGRAM. THIS      *
//* PROGRAM HAS THE CAPABILITY TO ANALYZE TAPE USAGE DATA FROM SMF.   *
//*                                                                   *
//* 'GFTAVMA' USES THE INPUT FILE PRODUCED BY THE 'GFTAXTR' PROGRAM.  *
//* 'GFTAVMA' WILL TERMINATE PROCESSING IF NO RECORDS WERE FOUND IN   *
//* THE INPUT FILE (I.E., THE 'XTRIN' DD) FROM THE 'GFTAXTR' UTILITY. *
//*                                                                   *
//*********************************************************************
//*
//VMA    EXEC PGM=GFTAVMA,REGION=&REGVMA,PARM='FILT#(&FILTERS)'  2 
//SORTIN   DD UNIT=&UNIT,
//            SPACE=(1000,(&TAPES)),AVGREC=U
//SORTOUT  DD UNIT=&UNIT,
//            SPACE=(1000,(&TAPES)),AVGREC=U                     3 
//SORTWK01 DD UNIT=&UNIT,
//            SPACE=(350,(&TAPES),,CONTIG,ROUND),AVGREC=U
//SORTWK02 DD UNIT=&UNIT,
//            SPACE=(350,(&TAPES),,CONTIG,ROUND),AVGREC=U
//SORTWK03 DD UNIT=&UNIT,
//            SPACE=(350,(&TAPES),,CONTIG,ROUND),AVGREC=U
//SYSOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//VMACHART DD SYSOUT=*                                4 
//VMAINCL  DD DUMMY,DCB=(DSORG=PS,RECFM=VB)
//VMAEXCL  DD DUMMY,DCB=(DSORG=PS,RECFM=VB)           5 
//VMACNTL  DD DUMMY
//VMAFLTRS DD UNIT=&UNIT,
//            SPACE=(10,(&TAPES),RLSE),AVGREC=U
//XTRCIN   DD UNIT=&UNIT,
//            SPACE=(1000,(&TAPES)),AVGREC=U
//XTRCOUT  DD UNIT=&UNIT,
//            SPACE=(1000,(&TAPES)),AVGREC=U
//XTRCWK01 DD UNIT=&UNIT,
//            SPACE=(350,(&TAPES),,CONTIG,ROUND),AVGREC=U
//XTRCWK02 DD UNIT=&UNIT,
//            SPACE=(350,(&TAPES),,CONTIG,ROUND),AVGREC=U
//XTRCWK03 DD UNIT=&UNIT,
//            SPACE=(350,(&TAPES),,CONTIG,ROUND),AVGREC=U
//XTRIN    DD DISP=SHR,DSN=&HLQ..GFTAXTR.&RUN

1 Substitute your own JOB statement.

2 During initialization, GFTAVMA obtains enough memory to store up to 1000 user-specified filters. If you need to use more than 1000 filters during GFTAVMA processing, you can set the value of the FILT#(&FILTERS) parameter on the EXEC statement in 6 . The FILTERS parameter allows you to specify the number of filters that you want to supply as input to filter your SMF data. You can change the FILT# value by changing the FILTERS specification. The valid range is 100 to 21474836.

If you remove the PARM='FILT#(&FILTERS)' from the VMA EXEC statement, GFTAVMA defaults to 10,000.

3 All SORT/WORK files defined by the SORTxxx and XTRCxxx prefixed DD statements are sized according to the values supplied on the TAPES parameter. During GFTAVMA processing, DFSORT does not release space automatically on each call. Therefore, do not use the RLSE sub-parameter of the DD SPACE parameter for these JCL statements. See the note in the comments block regarding setting the TAPES parameter. These values supply the space quantities for all files required during the GFTAVMA run.

4 The CHART keyword is optional. When specified, the CHART keyword causes the GFTAVMA program to create a sequential data set referenced by the VMACHART DD statement.

In the GFTAVMAP JCL member, the VMACHART DD is allocated to a SYSOUT file. To override this specification, specify the CHART keyword after 7 and insert the following DD statement after the EXEC statement in 6 :


//VMA.VMACHART DD DSN=your.data.set,DISP=(NEW,CATLG),
//   DCB=(LRECL=80,RECFM=FB),SPACE=(TRK,(1,1))

This statement directs the CHART output to a sequential data set that you can use to create charts using the graphics package of your choice.

If you do not request CHART, GFTAVMA does not put any output in the SYSPRINT file.

See CHART Keyword for more information about the CHART keyword. See Example of Chart Output for examples of the output that CHART generates.

5 The SPLIT keyword is optional. Use SPLIT to filter out a large list of excluded data sets once rather than filtering them out each time.

The SPLIT keyword creates two optional sequential data sets. These data sets are identified by the VMAINCL and VMAEXCL DD statements in the GFTAVMA JCL. In the GFTAVMAP JCL member, GFTAVMA PROC has assigned these DD statements as dummy.

To use SPLIT, you must override these dummy assignments. To override the current GFTAVMA DD assignments, use the following DD statements to redirect them to a direct access or tape data set.

Place the DD statements for SPLIT after the EXEC GFTAVMA statement ( 6 ) in the sample JCL, and specify the SPLIT keyword after the VMA.VMACNTL DD statement ( 7 ).

 //VMA.VMAINCL  DD DSN=your.sequential.data.set.for.includes,
 //             DCB=(LRECL=316,RECFM=VB,DSORG=PS),
 //             DISP=(NEW,CATLG),
 //             SPACE=(.....),
 //             UNIT=...
 //*
 //VMA.VMAEXCL  DD DSN=your.sequential.data.set.for.excludes,
 //             DCB=(LRECL=316,RECFM=VB,DSORG=PS),
 //             DISP=(NEW,CATLG),
 //             SPACE=(.....),
 //             UNIT=...

For subsequent GFTAVMA runs, update the XTRIN DD statement to point to either the included or excluded data set.

See SPLIT Keyword for more information.

//********************************************************************
//*                                                                  *
//*   YOU MUST SET "?HLQ" AND "?RUN" PROC PARAMETERS TO SPECIFY THE  *
//*       INPUT DATA SET FROM THE 'GFTAXTR' RUN                      *
//*                                                                  *
//*       THE FOLLOWING DEFAULT VALUES ARE IN THE "GFTAVMA" PROC:    *
//*                                                                  *
//*            REGVMA=6144K        *  DEFAULT REGION FOR 'GFTAVMA'   *
//*            TAPES='20000,3000'  *  DEFAULT NUMBER OF TAPE MOUNTS  *
//*            UNIT=SYSDA          *  DEFAULT ESOTERIC UNIT NAME     *
//*            FILTERS=1000        *  MAXIMUM NUMBER OF FILTERS      *
//*                                                                  *
//*  NOTES:                                                          *
//*    1) TO SET THE 'TAPES' VALUE PROPERLY FOR CORRECT SPACE        *
//*       ESTIMATES ON ALL DD STATEMENTS IN THIS PROC, USE THE       *
//*       NUMBER OF TYPE 21 RECORDS IN THE INPUT SMF SAMPLE AS       *
//*       THE VALUE.  THE 2ND VALUE SHOULD BE SPECIFIED AS A         *
//*       SAFETY VALVE FOR OVERFLOW.  FOR EXAMPLE, IF THE INPUT      *
//*       SAMPLE HAD 28,653 TYPE 21 RECORDS, ONE MIGHT SET THE       *
//*       TAPES='30000,5000'                                         *
//*                                                                  *
//*    2) THE 'FILTERS' VALUE WILL ALLOW THE GFTAVMA PROGRAM TO      *
//*       ACQUIRE STORAGE FOR THE FILTER KEYS.  YOU SHOULD           *
//*       ESTIMATE THE MAXIMUM NUMBER OF INCLUDE/EXCLUDE FILTER      *
//*       KEYS THAT YOU WILL SPECIFY IN THE GFTAVMA ANALYSIS RUN.    *
//*                                                                  *
//********************************************************************
//*
//       PEND
// EXEC GFTAVMA,HLQ=?HLQ,RUN=?RUN            6 
//*
//********************************************************************
//*                                                                  *
//*  PUT YOUR 'GFTAVMA' KEYWORDS AFTER THE "VMACNTL" DD STATEMENT    *
//*  BELOW.                                                          *
//*                                                                  *
//********************************************************************
//*
//VMA.VMACNTL DD *

        7

6 Specify the name of your GFTAXTR output data set, XTRCIN.

7 Specify keywords and filters here for the GFTAVMA run. These keywords are all optional. If you do not specify keywords or filters in the JCL, GFTAVMA analyzes all the input from GFTAXTR and only generates the summary reports, which are created for every run.

Note: z/OS DFSMS Implementing System-Managed Storage describes the recommended order for requesting the detailed reports. Read these recommendations before you run GFTAVMA.