Home

pilot/smf

1. EXAMPL2 EXEC PGM RDSMF17 PARM SYS1 LINKLIB This example will report on only dsnames that start with HSS IL z T5 ENSE TCI JOBSTATS JOB ff EXPL EXEC PGM RDSMF 17 REGION 2M SMFIN DD DSN MYTYPE17 SMF DISP SHR Input file SMF17A DD SUCUS Report by DSN SMF17 DD SYSOUT Report DATE TIME SORTWKO1 DD SPACES Crib 10 10 RESE Sort work space SORTWKO2 DD SPACH Qi LO 10 RLS Sort work space f SSCSORURT DD SYSOUT Sort information 14 Required JCL for RDSMF 17 44 PILOT User s Guide Axios Products Inc RDSMF18 This program produces a report of the data sets renamed by date and time The report has the following fields DAY The day of the week the job executed DATE The date JES terminated the job TIME The time JES terminated the job SYSID The SMF system ID where the job exe cuted JOBNAME The name of the job on the job card November 1 2007 VOLUME The name of the pack on which the data set resides OLD DSNAME The original data set name NEW DSNAME The current data set name Required JCL The PARM field can be used to reduce the number of data sets to report on A generic search is done on the value in the PARM field Figure 15 contains an example of the EXEC statement and required JCL for this program ONLYSYS1 EX EC PGM RDSMF18 PARM SYS1 This example will report o
2. Control Statement Format The PILOT SMF processing options are specified on free form control statements All keywords are separated by commas Key words may appear between columns two and seventy one inclusive The statement may be continued to the next card No special continuation character is required Multiple output file control card groups are separated by the word READSMF with at least one blank before and after the keyword READ SMF The first group will direct the output to SYSUT2 the second to SYSUT3 the third to SYSUT4 etc The READSMF keyword can be eliminated if SYSUT2 is the only output file Comments may be specified on any control card by placing an asterisk in column one making the entire card a comment or leaving at least one blank on any control card past column seventeen If the asterisk is omitted or incorrectly specified the step will be terminated with a completion code of 16 Figure 1 on page 7 contains some examples of the control statements When the SYSIN data set is specified as DUMMY all default options are used and only SYSUT2 is used 1 2 3 4 6 123456789012345678901234567890123456789012345678901234567890 READSMF START 1 2 98 END 1 2 98 SELECT 70 74 Notice the parameters start in column two and that dE 2 S 4 GET RMF RECORDS GET RMF RECORDS is a comment 6 123456789012345678901234567890123456789012345678901234567890 GET RMF RECORDS START 1 2 98 END 1 2
3. 14 PELOTA assess pe Vee Eee eee v sss v ess vds Rl a E performance considerations s oo o4 o9 ved Seed eye EER EEE OE Y 3 G3 3 ee EEE Ys 27 A 22 nisu Ras dd dardo a ee ae T TTT 33 e eye yy eee yyy vow iih mr DS LIIS MESE Z7 24931 55 03 jus M FC 39 j PE o SE E eee ee 14 BV oo peda dee L DDR RR RR RR RR RR RR RP RR RR DR das 14 e o ity do sr te ee Sr de do o da oe de De fo RI 33 41 43 qni aora RD oboe q 33 44 refiro Ud Ro cT 33 43 D GSS he ks id A A ss 33 35 36 54 56 PILOT User s Guide Axios Products Inc November 1 2007 POSTINI os pts ai a apaga app L dis 33 47 CM ts di r dede di de de Di o a MM di ii o ee eee ie e o eee eee eee ee ee 22 47 90 MED PELES A A rau 33 48 e e o eae Da a E O ce tru Na ek oe T 33 39 40 BONG og LLP LLS dd a AP i 33 49 50 ncn A A AA AAA AAA ee e ea a o e 7 9 15 17 18 22 25 30 35 36 51 54 FOQUINCC 16b 2 4 9 6 2 909 9 6 9 9 6 9 9 6 9 9 5 9 0 0 aks rss sias 23 24 35 40 42 51 i Te 7 14 15 A ee a a q 30 eo cc vw ww We oe ee voy reg i XX Rae Vix dr AI LA Se 1 2 L 3 3 ER 10 14 17 18 20 24 27 29 51 33 35 49 51 54 nns PPP AAS AE Ai a ate ib ae a ea TTE 42 43 51 52 ul cana rr eee eee eee eee ee ee 38 40 43 48 50 onn ee eee ee A ao Gr dr Do fo Mo Di ue a tor ur a me ee a dy 43 52 Spa je 66 UR RR 9 9 9 209 A DR nas 33 22 zi XT 1 23 24 Start 7 9 14 22 25 27 30 33 35 37 42 44 45 47 50 54 statistics UB sv wy Sele ee VW Ud E
4. 41 42 47 CX sk k k k k k k k k k Oy Oy dy L 13 12 20 23 25 27 29 33 25 51 53 34 O la Bice B CD ME cata RP uM ERE UE wee Baca Bus 12 PILOT SMF 55 Axios Products Inc November 1 2007 ICE ss d rs d i a i i dd a ki ii ii 34 43959543 9 9 99 99 9 3 X99 4 39 uo a e TTT O B general descpIDLION sey LPL e ee yee be EE EE YES EES ESS a o a e 17 inv ii a RR ES E EN DLL 25 47 DM dae LL L LL LL L LL a L aaa ere L BISIDDP option r cae EROR S NUR na aa a i S ee a aa a i 3 24 nur PR DR QD DR DDD RR Dq GR UR eed oven hes 14 15 ju Ma TR O p de 0 00 0 di lis 2 13 17 18 21 23 25 35 40 42 54 JODAS y Y lees wee ee E ux uU Wr gs 12 13 35 37 41 44 49 Key VOR PIPETTES ED eyes A linkage COnvVenti s 264 as a Cee EXC RUE 3 da ee ewe Vea S os d AT MD ICD RETE 39 mandatory KeyWords vuv vu v vu eee a vet aa a is eee Yee ee a 9 multiple CUIDE yr 24551451445441441415 45 ki RRRS ee ee ee R L7 DEN UMAS X 45 DONA Jal ee E E EEE EEEE da E ee 25 namber disse pus o a ul ele te fee a ea RR ae a A ee as 39 E ee RR 22 sinit a TTT 45 oJ L S i A is 41 42 DRE IU PNE ee ee eee i i ii 222325 72922 7 7 2212 772 12 39 optional keywords n 11 OUTRO eae ee en RN i T Dag 445 es e L 713 17 18 20 21 23 25 35 37 39 42 51 53 34 parameters s aenean S e bee a a bee ey cad I AS PAES pipe pres N LLA eee eatese ses LLA 408448 19 20 paseo parameters e iai ii i ai E UR GR i i a i i E 18 Kla Us cuu ls PN eee RD e RR ees I LE 13
5. If a HISTORY DD card is present the Statistics Log is written as a member in a partitioned data set if the HISTORY option is active 7 The statistics log is always written to SYSPRINT 8 An Exception log is written if bad input records are encountered PILOT SMF 3 Axios Products Inc November 1 2007 4 PILOT User s Guide Axios Products Inc The completion codes PILOT SMF returns at the end of a step inform the user as to whether or not the request was serviced These completion codes refer to step termi nation and not the User Exit return codes Condition codes of step termination Completion Codes Meaning CC 0 PILOT SMF completed suc cessfully CC 4 If SYSUTI is a VSAM data space then the SYSUTn DCB parameters must be defined November 1 2007 Completion Codes CC 00 CC 16 If SYUTUI is a seguential data set PILOT SMF completed suc cessfully The DCB parameters were not specified for SYSUTn and the DCB parameters from SYSUTI were used No records were extracted Messages RSMF001E and RSMFO03 are issued Indicates that a control statement syntax error has occurred or Sort failed No records are extracted Refer to the error message s to determine the problem Sort is used to identify and delete duplicate records when the NODUP option is specified PILOT SMF 5 Axios Products Inc November 1 2007 6 PILOT User s Guide Axios Products Inc November 1 2007
6. In this example PILOT SMF will call a user exit named EXITOI This routine was located through the STEPLIB DD card reference to data set MYLIB There is no third parameter STEP EXEC PGM READSMF PARM EXITOI ONLYPRODUCTION In this example PILOT SMF will call a user exit named EXITOI The address of the parameter ONLYPRODUCTION will be passed via register 1 as the third parameter of the parameter list Assembly Language Example Figure 2 on page 19 contains an example of a user exit in assembler language Axios Products Inc November 1 2007 EXITO1 CSEG SAVER EARI L IZ 0 RAL Address of Record L R3 4 R1 Address of Output Area L R4 8 R1 Address of Parms ADD DS OH LA R15 4 ADD THIS NEW RECORD RETURN R14 R12 RC R15 LEAVE DS OH LA R15 0 LEAVE THIS RECORD RETURN R14 R12 RC R15 DELETE DS OH LA R15 8 DELETE THIS RECORD RETURN R14 R12 RC R15 END EXITO1 Hacc Seo 2 Assembly Language Sample Exit PILOT SMF 19 Axios Products Inc COBOL Program Example A sample exit program in COBOL is provid ed in figure 3 on page 20 November 1 2007 ENTIFICATION DIVISION OGRAM ID EXITOL THOR JOHN DOE T JE leal E WRITTEN JAN 1983 COMBATE RKS HIS EXIT MODIFIES RECORDS EW RECORDS FOR OTHE DATA DIVISION 01 RECORD 4 02 01 02 A TY 02 FI 02 MESS 02 FI
7. The total number of I O service units the job accumulated ELAPSED TIME The elapsed time the job accumulated from start to end Required JCL Figure 10 on page 36 shows you the JCL required to run this report PILOT SMF 35 Axios Products Inc November 1 2007 VIRTSTAT JOB TYPE4 EXEC PGM READSMF PARM RDSMF4 REGION 2M ff SSOP AL DD DSN MYTYPE4 SMF DISP SHR Input file VA AS NAS UI DD DUMMY SMF4 DD SYSOUT Report FILE SORTWKO1 DD SPACE GG OPA SIE Sort work space SORTWKO2 DD SPACE Quis O KORES E Sort work space T ASAS Win DD SYSOUT Sort information SYSPRINT DD SYSOUT READSMF LOG SYSIN DD READSMF ST 0000000 E 9999999 SEL 4 34 GET ALL TYPES INCLUDING TSO 10 Required JCL for RDSMF4 36 PILOT User s Guide Axios Products Inc RDSMF5 RDSMFS reports job wide resource usages It runs as a stand alone program This report can be generated in Job Name or Date Time sequence See the JCL example RDSMFES produces a report with the follow ing fields DATE STARTED The date JES began execution of the job TIME STARTED The time JES began execution of the job DATE ENDED The date JES terminated the job TIME ENDED The time JES terminated the job JOBNAME The name of the job on the JOB card SYSID The SMF system ID where the job exe cuted CC The completion code the job received at termin
8. is a VSAM data set If you choose to use the DDNAME parameter replace SYS UTn with the DDNAME value s you have coded on the READSMEF control cards EXCEPT This data set is used as an output file for exception records SNAP This data set is only used if an S002 abend is intercepted The record that caused the S002 abend is written to this file in dump format SYSIN This data set is used to supply the input control cards If dummied defaults are used HISTORY This data set is a PDS with RECFM FBA and LRECL 80 If present and if SYS UTI specifies a data set a copy of the Statistics Log for this run will be written to a new member of this data set If SYSTU1 is a dummy data set this data set will be used to determine the input volumes to be used to satisfy the selection criteria provided on the READSMF control cards PILOT SMF 23 Axios Products Inc November 1 2007 SMFDMP EXEC PGM READSMF PARM EXITO1 DATA y Ai The parameter is optional as explained in the f fr ser Exale section ox als guide STEPLIB DD User exit library if READSMF not in Linklist SYSPRINT DD SYSOUT A JF SST DD Input data set SYSUTn DD Output data set EXCEPT DD SYSOUT A SNAP DD SYSOUT A SYSIN DD HISTORY DD History library PDS optional 5 Required JCL for PILOT SMF 24 PILOT User s Guide Axios Products Inc If the NODUP option is used additional JCL is
9. t t rl r2 where e t is a valid SMF record type to be extracted e rl r2 is a range of valid SMF record types 10 PILOT User s Guide November 1 2007 SELECT ALL where e ALL will cause all SMF records within the START END periods to be extracted ALL is the default when SYSIN is specified as DUM MY Examples READSMF START 1998001 END 1998007 SEL 4 5 70 77 Extract record types 4 and 5 and record types 70 through 77 for Jan 1 1998 through Jan 7 1998 READSMF START 02 07 1998 END 02 07 1998 SELECT ALL Extract all records for Febru ary 7 1989 READSMF START 01 21 1998 17 END 01 22 1998 08 SEL 4 5 70 77 Extract record types 4 and 5 and record types 70 through 77 for Jan 21 1998 at 5 P M through Jan 22 1998 at 8 A M Axios Products Inc The following keywords are optional ACCOUNT ACC This option can be used to find account numbers in the account section of a job related record SMF types 4 5 30 34 and 35 or in the user identification field of SMF records The storing of the account number is done by using an SMF exit to place the account number in SMF record types that contain a user identification field refer to the MVS SMF Manual for further information Records which do not contain a user identification field or an account field will not be processed if their record types are requested using the SELECT keyword Account numb
10. 98 SELECT 70 74 The control cards above show GET RMF RECORDS as a comment This example shows three output files with different selection criteria READSMF START 00000 END 99999 SELECTALL READSMF START 00000 END 99999 SELECT 70 79 READSMF START 00000 END 99999 SELECT 4 5 6 ALL TYFES TO SYSUT2 ONDA RME GEO Ses eS ACCOUNT TO SYSUT4 1 Sample Control Statements PILOT SMF 7 Axios Products Inc November 1 2007 8 PILOT User s Guide Axios Products Inc There are three keywords that must be specified if a SYSIN data set is provided They are START END and SEL ECT If more than one output file is to be created then the READSMF keyword is also required READSMF Separates the control groups for each output file and is required when more than one output file is needed This parameter can be omitted only when there is only one output file This key word is available to maintain compatibil ity with prior releases START ST Specifies the starting date and optional time of day to begin to extract data The format of the parameter is YYYYDDD HH MM SS or MM DD YYYY HH MM SS where e YYYYDDD is the starting year and Julian day from which to extract data It is required e MM DD YYYY is the date in month day and year format e HH MM SS is the starting time and is optional November 1 2007 Mandatory Keywords The time of day parameter can be speci
11. EU AVR raa seus dol ECL 1 e eo PAS eee eee ee Pee ee eee E 343444494065 I5 es A storage requirements A AAA A a S A EAN 13 27 jug a J m 41 SUMMERS ev ee ee RO E IN RA 41 43 apu nnam xg SySid llle eee 14 37 39 41 42 44 49 SYNE 204 44 4 411949 9 499944 4 494949 eee ds Eros RM 23 249 29 30 32 34 BUSDEHML ev vvv VV VV VY Vv vus yv la ob REM M SE 2M T DR RR eS TI 39 system ooo ooo ooo err n nnns 2 3 12 14 27 35 37 39 41 42 44 49 SL sura oorr 1 3 5 12 14 21 23 25 27 29 30 36 52 54 SVMs e eee a aa EN EA E 30 DD time ssa r ks ss ss E MM 13 15 21 29 33 35 37 42 44 49 51 53 ame ended oa tetas pp e a a aa S cR Odor a cda a aa 37 tme started 3 243 xd ae te tee eee SM er e a e ee DS E fi o OTT 13 36 43 52 UDE coo ooo ooo s 10 12 13 20 22 29 31 33 41 42 47 49 51 53 54 NES a eae as a Se a p r 39 n a A TTT AE USET EXI AA 29 35 51 DO Vi a r r ere IN tee eee t 3 353 SEE TTT 41 42 volume lt S 22 30 41 45 49 51 PILOT SMF 57 Axios Products Inc November 1 2007 58 PILOT User s Guide
12. ME DAIWA SIME INITORMATTON ON ATG TSO PACKS DSNSTATS JOB TYPE14 EXEC PGM RDSMF 14 REGION 2M SMF IN DD DSN TYPE14 TY SMF14 DD SYSOUT SMF14S DD SYSOUT SMFLOG DD SYSOUT SORTWKOn DD SPACE CYL 10 10 RLSI SYSOUT DD SYSOUT SMFCTL DD Ea PE15 TYPEG67 SMF DISP SHR Input DETAIL Report SUMMARY Report Information on run Sort work space SOI SrimE cmo Volume control card 13 Required JCL for RDSMF14 PILOT SMF 43 Axios Products Inc RDSMF17 RDSMF17 produces two reports The SMF17 file is a report of the data sets scratched by date and time SMFI7A is a report sorted by data set name Both reports have the following fields DAY The day of the week the job executed DATE The date JES terminated the job TIME The time JES terminated the job SYSID The SMF system ID where the job exe cuted November 1 2007 JOBNAME The name of the job on the JOB card VOLUME The name of the pack on which the data set resides DSNAME The data set name that was scratched Required JCL The PARM field can be used to reduce the number of data sets to report on A generic search is done on the value in the PARM field Figure 14 shows examples of the EXEC statement and the required JCL for this program ONLYSYS1 EXEC PGM RDSMF17 PARM SYS1 This example will report on only dsnames that start with US B
13. Products Inc November 1 2007 32 PILOT User s Guide Axios Products Inc The following additional programs are included to format SMF records RDSMF4 This program formats type 4 records job and step related information RDSMFS This program formats type 5 records job related information RDSMF6 This program formats type 6 records job printing information RDSMF14 This program formats types 14 15 and 64 records open close data set access and EXCPS for VSAM and non VSAM RDSMF17 This program formats type 17 records scratch data set RDSMF18 This program formats type 18 records rename data set RDSMF26 This program formats type 26 records job printing information RDSMF40 This program formats type 40 records EXCPs for dynamic allocation data sets November 1 2007 Additional Modules RDSMF57 This program formats type 57 records JES2 SYSOUT transmission records RDSMF67 This program formats type 67 records VSAM and ICF catalog activity RDSMFVXT This program is a user exit to reduce type 14 15 and 64 record types to be passed to RDSMF14 TYP305 This program is a user exit provided to choose only the subtype 5 Job end record of the SMF type 30 records It can be used to reduce the number of type 30 records not processed by SMFPC30 GENMONTH This program will manage a PILOT SMF control card member in a PDS Each time the member is processed through this program the
14. RDSME57 reports job printing information It runs as a stand alone program RDSMFS7 produces a report with the fol lowing fields DAY The day of the week the job executed DATE The date JES terminated the job TIME The time JES terminated the job SYSID The SMF system ID where the job exe cuted JOBNAME The name of the job on the job card November 1 2007 ORGNODE Original network node ID EXENODE Execution network node ID XMITID SYSOUT transmitter system ID XMITDEV SYSOUT transmitter device name RECORDS Actual number of logical records trans ferred Required JCL An example of the JCL required to run this program is found in figure 18 JOBSTATS JOB TYPE57 EXEC PGM RDSMF57 REGION 2M SMFIN DD DSN MYTYPE57 SMF DISP SHR Input file SMF57 DD SYSOUT Report by date time SORTWKO1 DD SPACE CN 10 1 0 SB Sort work space SORTWKO2 DD SPACES Curb 10 LO SEN Sort work space SMS OUR DD SYSOUT Sort information 18 Reguired JCL for RDSMF57 48 PILOT User s Guide Axios Products Inc RDSMF67 RDSMF67 produces a report from record types 61 65 66 and 67 The SMF67 file is a report of the data sets cataloged to a VSAM or ICF catalog sorted by DSNAME This report is useful when catalog activity is needed to rebuild a catalog The report has the following fields DAY The day of the week the job executed DATE The date JES t
15. The History file can be used to dynamically allocate the input file for specific selection criteria Please refer to the definition of the SYSUTI data set in the Required JCL section on page 23 This option is only active when a HISTORY DD card is present in the JCL The History data set must e bea PDS e have the DCB attributes LRECL 80 and RECFM FBA The BLKSIZE may be any multiple of 80 When using ISPF to browse the data set ISPF will space the lines using the control characters specified in column one PILOT SMF generates names for each run by using the Julian date of the time of exe cution If PILOT SMF is run more than once using the same History data set PI LOT SMF will append a letter or number to the name i e D098121 D098121A etc This option will create an image of the Statistics Log for each run Note that the November 1 2007 History Option Julian date is in the form CYYDDD where C 0 for 1900 s dates and C 1 for 2000 s dates An example of the History file directory and the contents of a member are shown in figure 4 on page 22 Upgrading From Earlier Releases If you are upgrading PILOT from a release prior to V1 7 please remember to run the History File Conversion Program The instructions for doing this are in the PILOT V1 7 Conversion Guidelines document This conversion program will rebuild the History file with the new member naming convention and will convert the 2 digit ye
16. 454 3833R323433B33433334433G04 3343 17 Linkage Conventions ssepe ee eee kak kak k ERED ER Kk k ks 17 Passing Parameters iaa a ae eo eR RR ee K eR aa RN 18 PILOT SMF i Axios Products Inc November 1 2007 Assembly Language 424 4444 ks k ss i does oko xo ped 18 COBOL Program Example naue L Sa bee ee bee Y RR E seas 20 History Option usu A A AAA 33 V3 CEU DA a UR Ue oA 21 Required JC Lou ur au eden pecu doa a Bw oe paid eo erg pia ca oo e RR 23 NODUPICL sn cs a a a a ai iai a 22 Pestonmnanee Considerations vee eee yee See eee VV eo ee yo ye ks A E s 27 Storage Requirements cee eee eee dX E PO RD Yo ys 27 Block Size and BUENO sussa cae eae A eA EUR a a ea 27 Additional Considerations 2 0 0 as P Statistics b 29 Additional Modules 1 20 0 as EE ROSE m L Sr r r r r r k a IA 33 RDSMES DESSES b dote s dott ui date d as 37 RDSMED 2 eaaa aaa Ae A a A Mele ae rin Na Me A 39 E AA 41 RDSMFI A ARI 44 ROS eras bis L Ss kir br E i a S ee ee fd ra E 45 EDS aro rios pap a A ai a E ie i A 46 RDSMERN S uda wd a i d rs eng od cepe SEA oa de 47 RDSWE c pH KIT 48 RDSMEGT o2 21 94 ratua 5044 Jig bode quias deir e duri Gots 49 RDSMEVX De cesia A A ere op ea inge loi eroi di ia cado 51 TYP305 50 4 3 3 r i 3 9 4 3 2 359 9 4 1953 9 3 3 0 9 3 2 3 3 i 22 GBNNMOBNTILA vu sr eee S Yo E a k aca dio aca So ariete a ME de d 53 CICSAVIL poros oras qae qd
17. 5 Axios Products Inc November 1 2007 26 PILOT User s Guide Axios Products Inc November 1 2007 Performance Considerations Storage Reguirements PILOT SMF requires a minimum of 2M in the MVS XA ESA and OS 390 environments due to the SMF data set 32K block size This will be sufficient to execute all functions In the case where a user exit is invoked the exit s region size must be added to the minimum region requirements Per formance will improve as memory is added to reduce I O Optimum block size and buffers need to be specified When running other PILOT programs as user exits up to 4M may be needed If the NODUP option is used the following items must also be considered e the SORT region size the number of sort work files SORT will utilize whatever storage is avail able This however does not necessarily mean better performance Factors such as the number of records to be sorted will effect the selection of a region size In general a minimum value of 2M must be specified If a large number of records are to be sorted you should review the SORT reference manual for guidelines on region size specification The statistics log contains information to help monitor resources used in daily runs You can adjust the region size and the BUFNO parameter of the DCB the PILOT SMF default is 20 to conserve resources Block Size and BUFNO PILOT SME uses QSAM as it s access meth od to perform it s I O
18. Inc November 1 2007 Example READSMF ST 10 1 1999 E 10 31 1999 SEL 70 79 TIME M WEEKDAYS Select record types 70 79 for the month of October using the RMF interval time with out weekend data PILOT SMF 15 Axios Products Inc November 1 2007 16 PILOT User s Guide Axios Products Inc General Description PILOT SMF provides an exit for a user written program to analyze and modify each SMF record to delete SMF records and to add additional records A sample assembler routine is provided with the distribution materials Additional user exits are provided in object form and are described in the section Additional Modules on page 33 in this manual Linkage Conventions The conventions to be followed when using this interface are Assembler programs Register 1 contains the address of a parameter list where 0 R1 the address of the SMF record 4 R1 the address of an output area for the exit to add records 8 R1 the address of parameters to be passed to the exit COBOL programs A linkage section must be present in the user programs with 01 levels for input and output records Furthermore the procedure division must be defined using the records defined in the linkage section By using the COBOL keyword November 1 2007 User Exit RETURN CODE the exit indicates the action to be taken with the record passed by PILOT SMF The PARM option of the EXEC statement in
19. L 10 10 SE Sort work space SORTWKO2 DD SPACH Crib 1 09 LO IS E Sort work space SYSOUT DD SYSOUT Sort information 16 Reguired JCL for RDSMF26 46 PILOT User s Guide Axios Products Inc RDSMF40 RDSMF40 produces a report of the data set EXCP activity by date and time The report has the following fields DAY The day of the week the job executed DATE The date JES terminated the job TIME The time JES terminated the job SYSID The SMF system ID where the job exe cuted November 1 2007 JOBNAME The name of the job on the JOB card DEVTYPE The type of device UNIT The unit address of the pack EXCPS The number of blocks transferred to storage Required JCL The PARM field can be used to reduce the number of jobs to report on A generic search is done on the value in the PARM field An example of the JCL to use this program is provided in figure 17 ONLYSYS1 EXEC PGM RDSMF40 PARM TSU This example will report on only jobs that start with TSU JOBSTATS JOB TYPE40 EXEC PGM RDSMF40 REGION 2M SMF IN DD DSN MYTYPE40 SMF DISP SHR Input file SMF40 DD SYSOUT Report DATE TIME SORTWKO1 DD SPACE Curb UL 150 RS El Sort work space SORTWK02 DD SPACE ub 110 110 RS Sort work space SMS OU DD SYSOUT Sort information 17 Required JCL for RDSMF40 PILOT SMF 47 Axios Products Inc RDSMF57
20. LA ETIES ENG ES EY SN SUID WEE TAGES LO 139 50 ECT ALL ISMF S SYS1 MAN2 S JD SAS LINK TO IFASMFDP WAS SUCCESSFUL PILOT V1M5 BACKUP SMFTODAY G0329V00 DISK RECORDS QUIE HS EENE AS JEFE S rey 21919 RENA ie dE IRS FOR Oo SSE SxS uz 203 86 AL SS 1 169 376 18 84 48 81 Dia 4 Example of the History File in SPF 22 PILOT User s Guide Axios Products Inc Figure 5 on page 24 illustrates the job control statements required for the running of PILOT SMF STEPLIB This statement defines the libraries containing the PILOT SMF program and the user exit SYSPRINT This statement is used to define the PILOT SMF Statistics Log which includes information error and warning messages SYSUTI This statement defines a physical sequen tial file or a VSAM ESDS in VBS format SYS1 MAN x data sets If this file is specified as DUMMY and the HISTORY DD card is present then the selection criteria and the History file members will be used to determine the appropriate input file and the file will be dynamically allocated SYSUTn These statements define one or more physical sequential or a VSAM ESDS data sets only SYSUT2 may be VSAM in VBS format A total of 8 data sets may be define with n 2 9 If the DCB parameters are omitted when SYS UTn is a PS file the SYSUT1 DCB attributes are used DCB parameters must always be specified when SYSUTI November 1 2007 Required JCL
21. LLE LINKAGE Ol IN R OZ 18 02 I 02 R OL QUI 02 Jair 01 PARM 02 02 PROCEDU PERT HE Z9 to lo ge fng B 235 D R U A A ER PIC 9 2 PIC X PIC X o PILE 8 o SUE x Bal Ino le Jj A 28 29 leal Q ORA E po PIG g 1 Pm JEJE RD TEXT BTC OX 154900 x X bo ll El leal l O E leal O O E ER PILE L0G o IU Z2np rn R RM LIST PIC X 100 E DIVISION USING IN R R R EC TYPE 4 THEN FORM NEWREC THROUGH N MOVE 4 TO RETURN CODE GOBACK ELSE MOVE O TO RETURN CODI GOBACK NEWREC E EE PASSED FROM PILOT SMF AND CREATES COMP VALU juger PILE 2 Omm R COBOL PROGRAMS leal ES AOUTSRE CI BARMSIJ S EWREC EXIT L MOVE RECORD 4 TO OUT REC NEWREC EXIT MOVE PARM LIST TO MESSAGE 3 COBOL Language Exit Program Sample 20 PILOT User s Guide Axios Products Inc The History option is used to accumulate a history of all PILOT SMF runs giving the statistical information about each run This option is useful when tracking the migration or archiving of SMF data to a weekly monthly or yearly tape The History option is required when the ISMF option is speci fied
22. PILOT SMF Axios Products Inc 353 Veterans Highway Suite 204 Commack NY 11725 Sales Administration 800 877 0990 info axiosproducts com Technical Support 631 864 3666 support axiosproducts com Telecopier Fax 631 864 3693 www axios com Preface This publication contains information necessary for the operation of PILOT a family of proprietary program products used for performance management and capacity planning It provides data processing managers system programmers and capacity planners with information reguired to use this product This manual describes e The use of PILOT SMF as an accounting data base extractor e The use of PILOT SMF user exit with COBOL and Assembler language programs e The use of PILOT SMF to manage SMF file migration utilizing the History and VSAM options e The JCL necessary to use PILOT SMF Information in this publication is subject to significant change THIS MANUAL IS PROVIDED FOR THE SOLE AND EXCLUSIVE USE OF THE CUSTOMER THE MATERIAL CONTAINED IN THIS MANUAL IS CONFIDENTIAL AND SHOULD BE SO TREATED COPIES MAY BE PURCHASED FROM AXIOS PRODUCTS INC ANY UNAUTHORIZED REPRODUCTION OF THIS MANUAL IS PROHIBITED Seventh Edition November 27 This edition applies to Version 1 7 of the PILOT program products and to all subsequent versions and modifications until otherwise indicated in new editions or newsletters Copyright 1987 2007 Axios Products Inc All rights reserved Axio
23. START and END settings will be advanced to the start and end date of the next month CICSAVIL This program is a user exit to reduce type 4 and 30 step records to be passed to RDSMF4 or SMFPC30 PILOT MVS This will produce an availability report PILOT SMF 33 Axios Products Inc November 1 2007 34 PILOT User s Guide Axios Products Inc RDSMF4 RDSMF4 is a resource usage report which is especially valuable for understanding virtual storage usage It runs as an exit to READ SMF RDSMF4 produces a report with the following fields START DATE The date JES began execution of the job START TIME The time JES began execution of the job END DATE The date JES terminated the job END TIME The time JES terminated the job SID The SMF system ID where the job exe cuted JOBNAME The name of the job on the JOB card STEPNAME The name of step on the EXEC card PGMNAME The program name on the PGM pa rameter on the EXEC card CC The completion code the job received at termination November 1 2007 MAX VIRT The maximum potential virtual storage for a private area VIRT The maximum amount of private area virtual storage used SYST The maximum amount of LSQA and SWA work area used within the private area TOTAL CPU SERVICE The total number of CPU service units the job accumulated TOTAL MSO SERVICE The total number of main storage service units the job accumulated TOTAL I O SERVICE
24. TIVE LINK TO IFASMFDP WAS SUCCESSFUL SYSUT2 VOLUME S EXCPS DSN PILOT V1M5 BACKUP SMFTODAY G0329V00 APIO11 1 800 UNIT DISK DATE AND TIME RANGE FOR RECORDS OUTPUT FILE SYSUT2 START WEDNESDAY 08 25 1999 1999 237 17 09 54 END FRIDAY OPEP PUSS TOSH BS a BAL 12 RECORDS READ 14 811 RECORDS EXTRACTED LAL ALA TYPE 4 RECORDS 203 TYPE 5 RECORDS 86 TYPE 6 RECORDS 3 TYPE 10 RECORDS il TYPE 14 RECORDS 3L z 337 TYPE 15 RECORDS 1 169 TYPE 17 RECORDS 376 TYPE 18 RECORDS 7 TYPE 19 RECORDS 19 TYPE 20 RECORDS 84 TYPE 21 RECORDS 4 TYPE 23 RECORDS 48 TYPE 26 RECORDS 8 TYPE 30 RECORDS gg TYPE 32 RECORDS 48 TYPE 34 RECORDS 14 TYPE 35 RECORDS 14 TYPE 40 RECORDS TESS TYPE 41 RECORDS 295 TYPE 42 RECORDS 2 DA TYPE 45 RECORDS TYPE 60 RECORDS 298 TYPE 61 RECORDS 13 TYPE 62 RECORDS 149 TYPE 64 RECORDS 28 TYPE 65 RECORDS 210 TYPE 66 RECORDS 7 TYPE 80 RECORDS 65 TYPE 88 RECORDS 44 TYPE 89 RECORDS 97 TYPE 90 RECORDS 4 TYPE 92 RECORDS 2 470 8 Statistics Log Part 1 30 PILOT User s Guide Axios Products Inc November 1 2007 TENG TES 00 RECORDS 294 dE SC TE OL RECORDS 22 EEPE 02 RECORDS 98 TYPE VO RECORDS 180 TENG Ie 18 RE CORDS MY TYPE 200 RECORDS 4 EXCEPTION RECORDS 0 STATISTICS FOR JOB DUMPMANZ STEP DUMP CEU TQ ID TRL ee 416K SYS USED ISIZOT MCCS 5 334 PILOT SMF C 1983 1999 9 Statistics Log Part 2 PILOT SMF 31 Axios
25. The best per formance is attained by having a combined specification of 240K of data in memory This is the number at which QSAM will start to achieve the most CPU IO overlap Half track blocking will not only cause fewer EXCPS but will better utilize DASD space A 3380 device a 23K block size with 20 buffers will give 460K of data in memory A 3390 device a 27K block size with 20 buffers will give 540K of data in memory When running PILOT SMF in a ESA envi ronment with DFP 3 1 or higher use system determined block size by specifying block size 0 Additional Considerations The NS parameter will provide better per formance in a heavily loaded system Users with multiple step jobs that utilize PILOT SMF to pass data from one step to another should use a disk data set instead of tape for SYSUT2 If a BLKSIZE parameter is not specified the default BLKSIZE taken from SYSUTI will be used and a system 002 abend may occur This occurs when the tape block size exceeds PILOT SMF 27 Axios Products Inc November 1 2007 the disk track capacity e g the 3350 maximum blksize is 19069 28 PILOT User s Guide Axios Products Inc Figures 8 and 9 on pages 30 and 31 contain an example of the statistics log The first line provides the version and level number of PILOT SMF and the date and time of the run Message PILOT221I displays the SYSIN control card statements used for each output file The next section mark
26. VSM will be written to the output file The example in figure 20 on page 52 will report on only data set names that start with SYS1 regardless of the volume on which it resides PILOT SMF 51 Axios Products Inc November 1 2007 N Ww Bs O1 o 123456789012345678901234567890123456789012345678901234567890 PRODO1 PRODO2 ES OR GET DSN INFORMATION ON PRODO1 AND PRODO2 GET DATA SET INFORMATION ON ALL TSO PACKS 20 Sample JCL for RDSMFVXT Limiting DSNAMES SMF EXEC PGM READSMF PARM RDSMFVXT R STEPLIB DD DSN PILOT LOADLIB DISP SHR hire Pis THE FOLLOWING DD STATEMENTS ARE FOR READSME Valis SYSPRINT DD SYSOUT EXCEPT DD SYSOUT ISSO DD DSN MONTHLY SMF 0 UNIT TAP SY SUT DD DSN ONLY MYPACK SMF T141564 UNIT SYSDA 7 SPACE CYL 30 10 RLSE SYSIN DD READSMF START 01 01 1998 END 01 20 1998 SELECT 14 15 64 e a Pis THE FOLLOWING DD STATEMENT ARE FOR RDSMFVXT AS SMFLOG DD SYSOUT SMFCTL DD PROD PVSM EGION 2M gc DIES POD 21 Sample JCL for RDSMFVXT 52 PILOT User s Guide Axios Products Inc TYP305 TYP305 is a user exit provided to reduce the amount of SMF type 30 records to process It will ignore all other record types except for subtype 5 This will save resources when these records are passed to other programs to be processed This is ver
27. ar dates to 4 digit notation PILOT SMF 21 Axios Products Inc November 1 2007 Menu Functions Utilities Help VIEW RATO EAV IE NATO PRESO RA Command gt Name VV MM Created DVO SVS Sits D099243 D099243A D099244 D099245 D099250A D099250B plo Bait Con pirm Menu Utilities VIEW PELOS YILAN ASI gt LIES LONE UDS Command gt 000001 1AXIOS PRODUCTS NC PILOT SMF 000002 KLM TECHNICAL 000003 000004 ORUN DATE TUESDAY 08 3 000005 QPILOTZZLT CONTROL CARD SI POR 000006 000007 START 0000000 END 9999999 SEL 000008 0 000009 0 n GE auum S un vx OAR dO OOOO SAS O UMSS ECOS 000011 SCPMV5 409 U 010 010 8182 OPL LOTOUT EEE MIO E EO NR Ae VOTO TST OSes A VOLUMET S EXCPS DS 000014 API011 00 Y OS Sy A um 3m AND UR dE Mb da RANGE 000016 OSTART WEDNESDAY 08 25 1999 d 000017 END FRIDAY 08 27 1995 a 000018 RECORDS READ 14 811 000019 RECORDS EXTRACTED 14 811 000020 000021 TIPE 4 RECORDS 000022 TYRE 5 RECORDS 000023 TOPE 6 RECORDS 000024 TYRE FO RECORDS 000025 TIPE 14 RECORDS 000026 TIRE TS RECORDS 000027 TOPE TEREC ORES Si 000028 TIRE rS RECORDS 000029 TLES ES RECORDOS 000030 TIRE 20 RECORDS 000031 TUPE 21 RECORDS gt 000032 TIRE 23 RECORDS 000033 TLIRE Z6 RECORDS 000034 TIPE S0 RECORDS Row 00001 of 00054 Scroll gt CSR Changed Size Init Mod ID Compilers Test Help E N 02400 Columns 00001 00072 Scroll gt CSR READSMF V1 M7 0 YONG Wo 7 SPEC
28. ation November 1 2007 PG The performance group the job was assigned to for execution JOB CLASS The job execution class TOTAL SERVICE The total number of service units the job accumulated during execution CPU TIME The total number of CPU service units the job accumulated TOTAL SRB TIME The total SRB time the job accumulated TOTAL I O The total number of I O s the job accumulated ELAPSED TIME The elapsed time the job accumulated from start to end Reguired JCL Figure 11 on page 38 contains the JCL reguired to run this report PILOT SMF 37 Axios Products Inc November 1 2007 JOBSTATS JOB TYPES EXEC SMF IN DD SMF5 DD SMF5A DD SORTWKO1 DD SORTWK02 DD SMS o WE DD PGM DSN MYTYP SYSO SYSO SPAC SRAC SYSO RDSMF UT UT meses 5 REGION 2M 17 10 10 R E CY UT 17 LO 10 R E5 SMF DISP S IS HR iS Bal Jgal Input file Report by JOBNAME Report by DATE TIME Sort work space Sort work space Sort information 11 Required JCL for RDSMF5 38 PILOT User s Guide Axios Products Inc RDSMF6 RDSMF6 reports job printing information It runs as a stand alone program RDSMF6 produces two reports one by Job Name and one by Date Time with the following fields DAY The day of the week the job executed DATE The date JES terminated the job TIME The
29. be specified by in serting an asterisk to create a mask The format of the keyword is JOBNAME namel name2 where name and name2 are the jobs to be selected if all other criteria START END etc are met Namel or name2 can have a mask specified That is JOBNAME N will extract all records with job names that start with the character N Job P D123 will extract all records with job names that start with P and end with D123 Examples READSMF ST 1998001 E 1998001 Axios Products Inc SELECT 4 5 JOBNAME TEST1 Extract type 4 and 5 records for 1998001 that have the job name TEST1 READSMF START 1 1 1998 END 12 31 1998 SELECT 4 5 JOBNAME TEST1 TSU1 APP01J SYS01 Extract SMF types 4 and 5 for 1998 with the job names listed READSMF ST 1998001 E 1998365 SEL ALL JOB TSO CICS CICSNODE Extract all records for 1998 with JOBNAME beginning with TSO or CICS and the CICS region with the VTAM APPLID of CICSNODE NODUP This keyword specifies that all duplicate records will be deleted This is accom plished by a link to SORT All records that are selected are given to SORT through an E15 exit After the SORT an E35 exit is used and each returned record is compared with the previous record If the record is a duplicate the duplicate will be deleted Records are sorted by SMF date time and type The time used is the time the SMF record was moved to the SMF buf
30. data set opened PS PO or VSAM DEVICE UNIT The type of device 3330 3350 3375 3380 etc on which the data set resides and the UCB address VOLSER The volume on which the data set resides ACCESSES The number of times the data set was accessed EXCPS The number of blocks transferred to main memory from the device for this data set Reguired JCL The PARM field can be used to reduce the number of data sets for reporting A generic search is done on the value in the PARM field 42 PILOT User s Guide November 1 2007 Examples ONLYSYS1 EXEC PGM RDSMF14 PARM SYS1 This example will report on only dataset names that start with SYS1 EXAMPL2 EXEC PGM RDSMF14 PARM SYS1 LINKLIB The above example will report on data set names which start with SYS1 LINK LIB The SMFCTL DD card reduces the data by volume If you wish all volumes found to be processed then SMFCTL DD card must be defined as DUMMY Syntax rules 1 Volume names begin in column one 2 Volume names may be generic with an 3 Volume control cards must be in alphanumeric order 4 Comments may be placed past col umn eight Required JCL Figure 13 on page 43 shows an example of the JCL and control cards used with this program Axios Products Inc 1 2 S 4 November 1 2007 6 123456789012345678901234567890123456789012345678901234567890 PRODO1 GET DSN INFORMATION ON PRODO1 AND PRODO2 PRODO2 ES O
31. desd SP HR er Sot ag dew SR dew e s 54 lu goede as eee edd ss DR a II 23 ii PILOT User s Guide Axios Products Inc PILOT SMF allows users to selectively extract SMF records and optionally manage SMF migration and the archiving of SMF files PILOT SMF has two input files SYSIN This data set is used to supply the control cards that specify the PILOT SMF processing you require SYSUTI This data set specifies the file from which the SMF records will be extracted This file can be dynamically allocated when used in conjunction with the History file See the History Option on page 22 in this manual PILOT SMF has five output files SYSPRINT This data set provides statistical informa tion about the processing performed as well as informational warning and error messages SYSUT2 This is the output file produced by PI LOT SMF and contains the SMF records extracted from SYSUTI based on the selection criteria you provided November 1 2007 Introduction SYSUTn These data sets define additional output files where n 2 through 9 Multiple output files containing records extracted from SYSUTI and are based on the selection criteria you provided These are the default names for the output files and are referred to as SYSUTn in this manual EXCEPT This data set is an optional report of all invalid records found on SYSUTI SNAP This data set is optional and contains a copy of the invalid records
32. ed FILE STATUS provides information on the SYSUTI and SYSUTn files The volumes EXCPs I O done to each file the data set names and unit type DISK or TAPE are listed Message PILOTOO7I indicates that the ISMF parameter was specified to initialize the MAN data set after dumping and that this was successful November 1 2007 Statistics Log The title DATE AND TIME RANGE FOR RECORDS OUTPUT FILE states that the START is the earliest record found within the requested range and END is the latest record found within the requested range Records read extracted show the number of records read versus the number of records extracted If the NODUP option is specified with a user exit that adds records the number of records extracted will be equal to the sum of the records extracted from the input file plus the records added by the user exit The records extracted refers to the original SYSUTI file The records added do not show up in this field A separate field RECORDS ADDED provides this information PILOT SMF 29 Axios Products Inc November 1 2007 AXIOS PRODUCTS INC PILOT SMF READSMF V1 M7 0 XA6 0 7 KLM TECHNICAL SPECIALTIES INC RUN DATE TUESDAY asas AVMs Qs 1013 59 PILOT221I CONTROL CARD S FOR SYSUT2 START 0000000 END 9999999 SELECT ALL ISMF EE SE ATORES SYSUT1 VOLUME S EXCPS DSN SYS1 MAN2 SCPMV5 409 UNIT DISK PILOTOO7I ISMF OPTION AC
33. erminated the job TIME The time JES terminated the job SYSID The SMF system ID where the job exe cuted JOBNAME The name of the job on the JOB card ACTION What action was taken on the catalog entry scratched uncataloged etc For ICF catalogs IN VVR was inserted UP VVR was updated DE VVR was deleted TYPE The type of catalog entry cluster data index or nonvsam VOLUME Volume name where the data set resides November 1 2007 DSNAME The cataloged data set name Required JCL The PARM field can be used to reduce the number of jobs to report on A generic search is done on the value in the PARM field An example of the JCL required to run this program is provided in figure 19 PILOT SMF 49 Axios Products Inc November 1 2007 ONLYSYS1 EXEC PGM RDSMF 67 PARM TSU This example will report on only data sets that start with TSU JOBSTATS JOB TYPE67 EXEC PGM RDSMF 67 REGION 2M SME IN DD DSN SMF61 SMF65 SMF66 SMF67 DISP SHR Input file SMF67 DD SYSOUT Report by DSNAME SORTWKO1 DD SEA BS ib 10 10 RLS Sort work space SORTWKO2 DD SPACE Gris AMO ARIAS EN Sort work space SYSOUT DD SMS QUIE Sort information 19 Required JCL for RDSMF67 50 PILOT User s Guide Axios Products Inc RDSMFVXT RDSMFVXT is a user exit provided to reduce the amount of SMF type 14 15 and 64 to process This will save reso
34. ers must adhere to the following syntax e a maximum of 50 account numbers may be specified e the list must be enclosed in parenthe sis regardless of the number of ac count numbers specified the account numbers must be sepa rated by commas e amask may be used to select account numbers The Account number may be specified as 1 A specific value e g 9000 November 1 2007 Optional Keywords 2 A non specific reguest by inserting an in place of each digit that is to have a variable value 0 9 e g 9 all account numbers 900 999 Examples READSMF START 1 3 1998 END 1 3 1998 SELECT ALL ACCOUNT 34 Extract all data for 1 3 1998 that has account numbers with 34 as third and fourth digits e g 0034 0934 READSMF START 1998001 END 1998365 SELECT ALL ACCOUNT SYS0034 PROD0059 Extract all records for 1998 with account numbers SYS0034 or PROD0059 DDNAME DD This keyword specifies the output DD name for a control card group This option will direct output to the DD name specified instead of the default output DD name SYSUTn All information in the log referring to that file will be associated with the default name PILOT SMF 11 Axios Products Inc November 1 2007 EXCLUDE JOBNAME EXL JOB This keyword specifies the SMF record type s to be excluded See the MVS Systems Management Facilities manual for valid record types This option over
35. fer except types 4 5 30 34 and 35 November 1 2007 These types contain the time of the JOB STEP termination Refer to the MVS SMF manual for further information The user exit gets control after the sort so that accounting program exits are accurate The only additional JCL re quired are DD cards for SORT work files and messages Additional virtual storage is needed for this option Please refer to the Performance Considerations discussion on page 27 for storage requirements and NODUP JCL on page 25 for additional information Example READSMF START 3 1 1998 END 3 31 1998 SELECT ALL NODUP Extract all records for 3 1 1998 to 3 31 1998 and delete all duplicate records This keyword specifies that PILOT SMF should run as a non swapable address space This will improve performance in a heavily loaded system Consult the Systems Programmer or Technical Sup port staff at your installation for infor mation regarding the use of this option PEAKTIME This keyword specifies a time period to be extracted between the START and END parameters This allows you to extract the same period across multiple days PILOT SMF 13 Axios Products Inc The format is PEAKTIME hh mm HH MM where e hh mm is the time of day beginning the period in hour and minute format 00 00 23 59 e HH MM is the time of day ending the period e When the start time is greater than the end time periods will c
36. fied three ways 1 YYYYDDD HH or MM DD YYYY HH the day and hour 2 YYYYDDD HH MM or MM DD YYYY HH MM the day hour and minute 3 YYYYDDD HH MM SS or MM DD YYYY HH MM SS the day hour minute and second When SYSIN is defined as DUMMY the default value is START 0000000 meaning that records will not be selected by starting date For compatiblity with earlier releases START 00000 is also accepted END E Specifies the end date and optional time of day to stop extracting data The format of the parameter is YYYYDDD HH MM SS or MM DD YYYY HH MM SS where e YYYYDDD is the ending year and Julian day e MM DD YYYY is the date in month day year format PILOT SMF 9 Axios Products Inc e HH MM SS is the end time of the data on the date specified This is optional The time of day parameter can be speci fied three ways 1 YYYYDDD HH or MM DD YYYY HH the day and hour 2 YYYYDDD HH MM or MM DD YYYY HH MM the day hour and minute 3 YYYYDDD HH MM SS or MM DD YYYY HH MM SS the day hour minute and second When SYSIN is defined as DUMMY the default value is END 9999999 This means that records will not be limited to an end date or time For compatiblity with earlier releases END 99999 is also accepted SELECT SEL Specifies the SMF record type s to be selected See the MVS Systems Man agement Facilities manual for the valid record types The format of the keyword is SELECT
37. ias e dac ace TS 2 17 18 assembly L Li EDS LARA E Rd 3 362 18 19 capacity planning sara AREIA REAR ENT DRE EOS P 5 35 37 re C E E Ean E E A 12 13 54 COOOL EEN 2 17 18 20 COMP sd ea a ARE EA RAR RA READ RE 20 completion codes 545454 kus kkkkiikknikiieskiiasiijesssiesiiaa 2 control statement format aa 7 Galia L 025555 RCA KAA KAA KA E ME RE RE AA A aaa AT o A as ASR AAA Saara SRA E ASTRA es AT ddl ak 4225 54 Aka k koka aki 9 10 13 20 22 29 30 33 35 37 42 44 49 A Rr ris Be S Bri LD Ar E a Ai poa 37 RIC started 434999999994 89 9995394934 9444395222 7542245 452275 3 37 day sss 9 10 14 39 41 42 44 49 di usse cedat anas 3 9 11 13 17 18 21 23 25 36 38 40 42 48 50 54 HII 2 ARA RR NEAR AE E RAE A EDD IOTIO OR TUM ai 28 defa ll assrrrraarraRa RARA AR AA k kak ka beeen 4 1 9 11 120 8T LEVIES ss da doe ond ee ORE URGE e RRS ce RD ne ek doo a RR as 41 42 ASMA anna RARE AEE GRASS ADA NAALL ADA LE 44 45 49 50 Lela a RA RI ee eR ee eR RSA Sa eee RoR Raia Amas 41 42 dynamic allocation ss aka od e eee xn ox 3x o e Y d doy Xx d 22 22 end 545444554 k kiss kiss 5 7 9 14 19 22 25 30 33 35 37 41 42 52 54 end date kp ak kak kkkkka kak ko ak k ka aa ak k ee ee 9 10 33 35 41 2 EXCEDE 444 E EEERERERREREEEERERRZZAZAZSZZ42 72243 1 12 13 23 25 52 54 CAUTELAR AAA E AAA AA AAA AREA AAA EA 12 14 BXCDS 3111331223333 Ad al AS
38. n only dsnames that start with SYS1 EXAMPL2 EXEC PGM RDSMF18 PARM SYS1 LINKLIB The abov xample will report on only dsnames that start with SSI LIVNI JOBSTATS JOB f f WOR ALS EXEC PGM RDSMF18 REGION 2M SMFIN DD DSN MYTYPE18 SMF DISP SHR Input file SMF18 DD SMS OMS Report DSN DATE TIME SORTWKO1 DD PACHA GMT MOMO RESP Sort work space SORTWKO2 DD SEACE Qi 10 10 RESE Sort work space SMS OU DD SYSOUT Sort information 15 Required JCL for RDSMF18 PILOT SMF 45 Axios Products Inc RDSMF26 RDSMF26 reports job printing information It runs as a stand alone program RDSMF26 produces a report with the fol lowing fields DAY The day of the week the job executed DATE The date JES terminated the job TIME The time JES terminated the job SYSID The SMF system ID where the job exe cuted November 1 2007 JOBNAME The name of the job on the job card XMTDEV Job transmitter device name FORM The FORM of the output data set to be printed LINES The number of lines to be printed spoo led BYTES Actual number of bytes transferred Required JCL Figure 16 illustrates the JCL for this pro gram JOBSTATS JOB TYPE26 EXEC PGM RDSMF26 REGION 720K SME IN DD DSN MYTYPE26 SMF DISP SHR Input file SMF26 DD SYSOUT Report by date time SORTWKO1 DD SPACE CY
39. on tool as well as a performance tool For example Find the user who wrote to a dataset with the wrong block size or the user who updated a particular dataset at 2 00 am last night The fields of the detail report are DS NAME The data set name that was closed by a user DATE The date JES terminated the job TIME The time JES terminated the job SYSID The SMF system ID where the job exe cuted JOBNAME The name of the job on the job card DSORG The type of data set opened PS PO or VSAM OPENED Describes if the data set was opened for input or output FMT Record format November 1 2007 LRECL The logical record length the dataset was opened closed BLKSIZE The block size of the dataset the time it was open closed DEVICE UNIT The type of device 3330 3350 3375 3380 etc on which the data set resides and the UCB address VOLSER The volume on which the data set resides EXCPS The number of blocks transferred to main memory from the device for this data set The fields of the summary report are DSN NAME The data set name that was closed by a user STR DATE The first date of a record found accessing this data set TIME The time of day of the STR DATE END DATE The last date of a record found accessing this data set PILOT SMF 41 Axios Products Inc TIME The time of day of the END DATE SYSID The SMF system ID where the job exe cuted DSORG The type of
40. re 22 contains and example of the JCL to produce an availability report CICS4 EXEC PGM READSMF PARM CICSAVIL REGION 2M STEPLIB DD f THE FOLLOWING DD STATEMENTS ARI SYSPRINT DD SYSOUT EXCEPT DD SYSOUT ASAS Top DD V SXSUT2 DD DSNSPI LOT LDOADLIIS DES ES Sal E FOR READSME DSN MONTHLY SMF 0 UNIT TAPE DISP OLD DSN ONLY CICSSMF TYPE4 UNIT SYSDA m SPACE CYL 30 10 RLSE DISP CATLG SYSIN DD READSMF START 01 01 1999 END 01 31 1999 SELECT 4 J PRODUCE REPORT USING RDSMF4 TYPE4 EXEC PGM READSMF PARM RDSMF4 COND 4 LT SMS ina DD SMS 82 DD DUMMY SMF4 DD SYSOUT SORTWKO1 DD SBACE lt CL 10 10 SORTWKO2 DD SPACE CYL 10 10 SYSOUT DD SYSOUT SYSPRINT DD SYSOUT SNS AN D amp READSMF ST 0000000 E 9999999 SI DEN ONE e SS MENE E4 SMF DISP SHR RLSE RLSE un EL 4 22 Sample JCL for CICSAVIL 54 PILOT User s Guide Axios Products Inc November 1 2007 Index ACCESSES ssa RA REA ARA ADA a 42 ASCO sa RASA ASA SATA ee eee eS 253 SEAL RAE k TA 7 11 ALU a earn 444 RARA ARANA ARRANCAR AST 17 39 49 additional considerations as zi additional modules 4444 k k k kak EAR A E A E 22 nc cs 5545422422442452452444 2204420114455 kaka 25 32 assemble
41. reguired for SORT In some installations sort files may be dynamically allocated Consult your technical support group or Systems Programmer for additional infor mation Figure 6 on page 25 illustrates the job control statements that must be added to the reguired job stream when you use the NODUP option SORTLIB This data set is used to load sort modules if SORT is not in a linklist data set November 1 2007 NODUP JCL SYSOUT This data set is used for SORT MERGE messages SORTWKOn These data sets are work files for SORT Dynamic Allocation Example The example in figure 7 on page 25 illus trates the same function but assumes that the sort files are dynamically allocated It will select all jobs run on July 5 1999 PILOT will dynamically allocate the input file using the History file as explained in the prior section The SORT work data sets will also be dynamically allocated SORTLIB DD DSN SYS1 SORTLIB DISP SHR SSCSIOYURT DD SYSOUT A SORTWKOn waere m i i 6 NODUP JCL Example ff STEPI EXEC PGM READSMF REGION 2M STEPLIB DD User Exit Library if reguired SYSPRINT DD SMS OIEA S SUTL DD DUMMY S STT DD Output data set PCIA DD SYSOUT A RISTORY DD Audit library with members of prior executions SES i DD READSMF START 07 05 1999 END 07 05 1999 SELECT 5 NODUP 7 Sample of NODUP and Dynamic Allocation PILOT SMF 2
42. rides the SELECT keyword If the same record type is specified in both keywords it will be excluded The format of the keyword is EXCLUDE t t r1 r2 where e t isa valid SMF record type e rl r2 is a range of valid SMF re cord types Example READSMF START 1 1 1998 END 1 31 1998 SELECT 70 79 EXCLUDE 76 Extract record types 70 through 77 except type 76 for Jan 1 1998 through Jan 31 1998 ISMF This keyword specifies that the system SMF data set read on SYSUTI is to be initialized after it is processed A Write To Operator is issued to verify that this option was chosen The HISTORY option must also be used so that an audit trail is maintained Users can browse the history data set to determine when the SMF data set was dumped to what vol umes etc 12 PILOT User s Guide Specifies that records containing job related information refer to the MVS SMF Manual for further information can be selected by the JOBNAME specified on the job card Records that do not contain a job name will not be extracted For SMF type 110 records CICS records the VTAM APPLID is used to select the CICS region The following syntax is required e Up to eight characters per name e If more than one is specified then each name must be separated by commas and the entire list must be enclosed in parenthesis e If only one name is specified the parenthesis are not needed e The name may
43. ross multiple days and exclude the time between the end time and start time This is useful for batch tuning Examples READSMF ST 1 4 1998 E 1 7 1998 SEL 70 75 TIME M PEAKTIME 13 00 14 00 Select record types 70 through 75 for the peak period of 1 PM to 2 PM for the week of January 4 through 7 1998 using the RMF interval time READSMF ST 10 1 1998 E 10 31 1998 SEL 70 75 TIME M PEAKTIME 2000 0300 Select record types 70 though 75 for the peak period 8PM to 3AM for the month of October PW1 Specifies the password for SYSUTI for password protected VSAM data sets 14 PILOT User s Guide November 1 2007 PW2 Specifies the password for SYSUT2 for password protected VSAM data sets SYSTEM SYSID SID Specifies the SMF identification of the CPU from which the record was written Example READSMF ST 1999001 08 E 1999001 17 SELECT ALL SYSTEM A032 Extract all data on 1999001 that ran on system A032 be tween 8 A M and 5 P M TIME This keyword specifies the time field to use to extract data Your options are R The system reader time This is the time the job was read into the system M The RMF interval start time types 70 79 W The time the record was moved to the SMF buffer as explained in the NODUP option This is the default if TIME is omitted WEEKDAYS NOWEEKENDS NOWKNDS This keyword specifies that the weekend data is not to be selected Axios Products
44. s Products Inc November 1 2007 Contents ich 2323444444444 4X L KK GU EX AA 1 Functional Description 5 225225 eed e ee bbe eed deeb eae a eae eae as 2 Completion Odes rsss DEDE edad ead d eod ad eda ER 2 Control Statement Format ks 7 Mandatory Keywords LL ks sk sk k sk k k ke k ond d d R4 FE E Rond PE i dod Rod 3 9 READSME kaka k an ehhh A A K A k KAA AKA KAA AA ANA DATA DE AE 9 STAR L5554444444 510005 eee ee 223 a ia S 9 BINDS aaa eee ECA A 445444 ka nana ka a Ara Aikikai AKA a 9 DEL CE 4452545455454555555545555i555 45 in k in a i 2 2 10 Optional Keywords 4 kak k renas or rs xj ne won 11 ACCOUNT r kia eee ee e ei aa 11 DDBANMB soda te hae ahead a darda las lanar tasca tangas da ad EXCLUDE e 22h heeenhraheneaeahanacaenanacnensaaentanans 12 ISME rsrs AR A RR RA 12 JOBNAME 24 pia AAA EA PROS PER PERE ARES SMA ARE LE NODO sms docu baaa dara rd oe Be dd Bid Boa Ae R 12 BR oatetathseaRAORPRASRERASRATSSRSSTASSReSASSSASSSTARSSSS 13 PEAKIIME 2222 2k RARRRRARAS DERE REED ERE ORO RR S APEG RS 13 Wa RARA ARA RARA A ARA ER NUS ER e Ra AS eee 14 PY 24255554444444444444415555 ee 45 tS ada i keis aridas 14 SYSTEM scan narra 14 TME 2425 ra pa oa Bla BO ca Re E DC ee 14 WEEKDAYS 2426252265 750 0 202 Ge ORR STR AKA AAS AAS 14 NOWBERENDS 2224444225444 5558 452454444545 1033391322304 14 NOWBNDS 224626245488 an aran tanii ANIMALE SAS 14 DC oer a rr re ana Aaa AKA Kaki RA RARA ARA AD As 17 General Description 22522222
45. that were found on SYSUTI HISTORY This data set is optional and contains the same information written to the SYS PRINT data set stored as a member of a partitioned dataset PILOT SMF 1 Axios Products Inc November 1 2007 2 PILOT User s Guide Axios Products Inc Here is an overview of how PILOT SMF works 1 PILOT SMF processes all control state ments from the file SYSIN The syntax is checked the options are analyzed and the processing parameters are set If SYSIN is specified as SYSIN DD DUMMY all input records are extract ed PILOT SMF reads the input file SYS UT1 which contains SMF records gen erated by the operating system Each record is compared with the options requested to determine if it is to be written to an output file If PILOT SMF is installed with an In stallation Exit each record that meets the criteria specified in SYSIN will be passed to the Installation Exit for processing November 1 2007 Functional Description 4 If the user has specified a User Exit each record that meets the criteria specified by SYSIN will be passed to the User Exit program for processing 5 If the record meets the selection criteria is not a duplicate of an earlier record when the NODUP option is used and the Installation or User Exit has not re quested that the record be deleted if exit s are active the record will be written to the output data set s SYS UTn 6
46. the JCL will specify the module name of the exit to be executed by READSMF A STEPLIB DD card must be included or the exit must be a member in a LINKLIST data set so READSMF can load the exit into memory If the exit is not in a LINKLIST or STEPLIB data set then READSMF issues message RSMF0016E MODULE NOT FOUND and terminates with a completion code of 16 Add or Delete Records The following convention is used in READ SMF for a user exit Upon return to READSMF the exit must specify a return code in register 15 COBOL programs must move one of the values to RETURN CODE The following are valid return codes 0 Write the SMF record the record may have been modified to the output file 4 Add a record to the output file using the second address passed to the exit Also write the SMF record to the output file PILOT SMF 17 Axios Products Inc 8 Delete the input record Do not write it to the output file Passing Parameters Assembly language parameters are passed using the third argument in the parameter list see Assembly language example COBOL uses the third 01 linkage section entry as shown in the COBOL program example In both cases the user has the option of passing up to 92 characters of parameter data following the exit program name and a comma on the EXEC JCL statement 18 PILOT User s Guide November 1 2007 Examples COBEXIT EXEC PGM READSMF PARM EXITOI STEPLIB DD DSN MYLIB DISP SHR
47. time JES terminated the job SYSID The SMF system ID where the job exe cuted JOBNAME The name of the job on the job card SYSOUT CLASS Class of output data sets NUMBER DSNS The number of data sets to be printed November 1 2007 FORM The FORM of the output data set to be printed FCB The FCB if any used to print the job UCS The UCS Print train if any used to print the job LOCATION The Location of where the job is to be printed NUMBER LINES The number of lines to be printed spool ed OPERATOR Action taken by operator for the job if any Required JCL Figure 12 on page 40 shows the JCL needed to run this program PILOT SMF 39 Axios Products Inc November 1 2007 JOBSTATS JOB TYPE6 EXEC SMF IN DD SMF6 DD SMF6A DD SORTWKO1 DD SORTWK02 DD SMS o WE DD PGM DSN MYTYP SYSO SYSO SPAC SRAC SYSO RDSMF UT UT meses 6 REGION 2M 17 LO 10 R E CY UT 17 LO 10 R E6 SMF DISP S SI HR iS Eal Jgal Input file Report by JOBNAM Report DATE TIME Sort work space Sort work space Sort information Ea 12 Required JCL for RDSMF6 40 PILOT User s Guide Axios Products Inc RDSMF14 RDSMF 14 formats record types 14 15 and 64 which will produce detail and summary reports of data set activity This report can be used as problem determinati
48. urces when these records are passed to other programs to be processed This is very useful when a report of a particular data set or volume is needed for a large time period This exit does not format the data it acts as a filter by communicating to READSMF to write the current SMF record to the output file refer to section User Exit on page 17 in this manual for more information Data Reduction Methods 1 Specify a full or partial data set name as a parameter A parameter is passed to the user exit using standard conventions as described in the section User Exit Linkage Conventions to reduce the num ber of data sets for reporting A generic search is performed on the value of the parameter passed 2 Specify volume s using the SMFCTL file The SMFCTL DD card reduces the data by volume November 1 2007 If you wish not to limit volumes then SMFCTL DD card must be defined as DUMMY Syntax rules a Volume names begin in column one b Volume names may be generic with an c Volume control cards must be in alphanumeric order d Comments may be placed past col umn eight 3 If both a data set name partial or full and volumes are specified a volume record will be written to the output file only if it satisfies both criteria Reguired JCL The example in figure 21 on page 52 dem onstrates the technigue to reduce SMF data for particular volumes In this example vol umes that start with PROD and P
49. y useful when a report is produced by SMFPC30 This exit does not format the data it acts as a filter by communicating to READSMF to write the current SMF record to the output file refer to section User Exit on page 17 in this manual for more information Data Reduction Methods November 1 2007 GENMONTH GENMONTH is a utility program to update a PDS member which contains PILOT SMF control cards The first card in the member must contain the READSMF keyword followed by the START and END key words formatted in the mm dd yyyy format Each time the program is run the member is updated such that the Start and End dates are the first and last of the next month This enables you to create a monthly accumulation job stream that can run every month without editing Your PILOT Source Library contains sample JCL for this facility and a sample control card member PILOT SMF 53 Axios Products Inc CICSAVIL CICSAVIL is a user exit provided to reduce the number of SMF type 4 and 30 records to process This will save resources when these records are passed to other programs to be processed This is very useful for creating a CICS availability report The exit will only select type 4 records with the program DFHSIP November 1 2007 It acts as a filter by communicating to READSMF to write the current SMF re cord to the output file refer to section User Exit on page 17 in this manual for more information Figu

pilot/smf

Contents

Download Pdf Manuals

Related Search

Related Contents