Home

FDREPORT Concepts & Facilities Guide

Contents

1. Co sueUsED UseWede iedaed suere eve BvesUsed pakuaej BYTESFRE Bytes Free calculated Continued APPENDIX MCDS Field Name FDREPORT Field Name Field Description Po USED Percentage Used calculated Percentage Free calculated MCDSCNAM LSTAR Last Used ttttrr SMS Storage Class SMS Management Class SMS Dataset Flag Byte Number of Times Dataset was Migrated SIDE MIRO _______ ESSE uM For DATATYPE BCDS the BCDS dataset record is described by the IBM MCB macro and the mapping Is PS Abs BewsmceBakup iWae Days since Last Reference calculated CS BvrEs Boa 8S 2go INNOVATION l DATA PROCESSING Corporate Headquarters Innovation Plaza 275 Paterson Avenue Little Falls New Jersey 07424 1658 Tel 973 890 7300 Fax 973 890 7147 support fdrinnovation com sales fdrinnovation com www innovationdp fdr com European Offices FRANCE GERMANY NETHERLANDS UNITED KINGDOM amp Nordic Countries 191 avenue Aristide Briand OrleansstraDe 4a Brouwerstraat 8 Clarendon House 94230 Cachan 81669 M nchen 1315 BP Almere 125 Shenley Road Borehamwood Herts WD6 1AG Tel 33 1 49 69 94 02 Tel 49 089 489 0210 Tel 31 036 534 1660 Tel 44 0208 905 1266 Fax 33 1 49 69 90 98 Fax 49 089 489 1355 Fax 31 036 533 7308 Fax 44 0208 905 1428 frsales fdrinnovation
2. pM UP ALISTATS Alias Stats 3 CHAR BCS E C YES Alias is Currently Active NO Alias is Not Currently Active SECURITY Dataset RACROUTE Status E DSCB Dataset Protected by a Specific Profile NODS No Decision Returned by SAF NONE No Protection PROFILE Dataset Protected by a Generic Profile DSNFLAGS Dataset attributes 4 CHAR E C RLS Record Level Sharing Supported 1 E X x pem gt eee xx zx d see gt lt lt the width of the size tracks fields will be 6 if the FATDISK option is enabled the format and width of byte fields varies depending on the value of the BYTEFORMAT operand the format and width of date fields varies depending on the value of the DATEFORMAT operand if the expiration date is 99 000 or 99 365 or above this is set to 65535 this field supports selection via a mask see the VOL operand in Section 54 13 N gt gt wf 4 5 APPENDIX TABLE 6 lists the FIELDs that can be obtained from the directory of a Partitioned Dataset or an Extended Partitioned Dataset via FAMS DESCRIPTION LEN ATTR SOURCE DIRBINFO RN NUM DIRBLOCK DIRBFREE DIRFREE DIRBLOCK Number of PDS Directory Blocks DIRB FAMS DIRBEREE Number of Free PDS Directory Blocks DIRB FAMS DIRBUSED Number of Used PDS Directory Blocks DIRB FAMS DIRFREE Percentage of PDS Directory Blocks Not Used GEN DIRUSED Percentage of PDS Directory Blocks In
3. FDREPORT SRS PANELS 3 2 Dataset Reporting Producing a dataset report with SRS begins at the SRS Dataset Selection Panel This is a multi screen menu that has the dataset name and the other FDREPORT selection field names from tables 1 7 in the Appendix in the form of prompts in the left hand column A AS BUS S EEG DNE COMMAND gt SCROLL gt PAGE IE db 1810 SELECTION VALUE ESRB SORY SOURCE ETECDS DSNAME VOL SOURCE A CATALOGN ARCDSN DEFAULTS IJ BOSE VOLSQ DATES CRDATE VVVVV gt gt ix Q Q um I lt I D di Q Mo M Mo E M N VEV NON ON EV To use a particular selection criterion the user just enters the desired value against the appropriate prompt under the SELECTION VALUE heading This includes the use of a full or masked dataset name For example on the panel below the user selects all those datasets that have a name beginning RTS and that reside on 3390 EAVs identified by FDREPORT as 3390 A The SOURCE field allows the user to state the source of the data equivalent to the DATATYPE parameter Available settings are CATALOG CATVTOC VOLUME VTOC EXTRACT EXTRACT and ARCHIVE ARCHIVE In the last two cases the user can name the Extract File or ABR Archive Control File he wishes to report from This has an added advantage in that users can also report from a named ABR Applic
4. EEE EEE Js 444 4 lt lt lt DSIND Dataset Indicators Printed in Hex 2 HEX VTOC E E X for Selection Use TVTC LASTV x 80 Last Volume RACF x 40 Discrete Profile PASSA x 10 Read Write Password PASSW x14 Write Password UPDAT 02 Dataset Updates TVTC SECAFLAG Secondary Allocation Flags 5 CHAR VTOC E JA X X BLK Allocated in Blocks TVTC CON Contiguous CONTIG CYL Allocated in Cylinders FIV 5 largest Extents ALX MAX Largest Extend MXIG RND Rounded to Cylinders ROUND TRK Allocated in Tracks Continued APPENDIX TABLE 1 lists the FIELDs available from the dataset s DSCB in the VTOC If a VSAM cluster is being reported some of the information may be found in the VVDS or catalog NAME DESCRIPTION TEN ama SOURCE SECXFLAG Secondary Allocation Extension Flag 3 CHAR VTOC TVTC ABL Average Block Length BYT Bytes KBY Kilobytes MBY Megabytes SECXVALU Secondary Allocation Extension Value XLSTAR ttttttttrrr Track Used to 123 Extents May be Printed TVTC Dataset Extents with extent type each Extent will be Stacked up to 123 Extents May be Printed BPTR Format 1 DSCB Pointer to Format 2 3 DSCB VTOC LMJOB Last Modifying JOB for ASM2 users LE FLAG1 Dataset Flag Byte Extended Format 7 CHKPTDSN Checkpointed Dataset COMPRESS Dataset is Compressable LARGE Dataset May Exceed 65535 Tracks LSTAR Dataset Last Block Pointer Specify as LSTAR X ttt
5. The XSELECT control statement to locate these datasets would be as follows XSELECT DSORG EF VOLG PROD SIZE gt 1000 NOEXTENT gt 4 The next example assumes that the user is doing an SMS conversion and he wants to identify any datasets that are ineligible for SMS He is looking for any datasets on his PROD volumes that are either not cataloged are cataloged but to the wrong volume or which are unmoveable XSELECT CATALOG NO VOLG PROD_ Uncataloged Datasets XSELECT CATALOG ERR VOLG PROD Datasets cataloged to wrong volumes XSELECT DSORG U VOLG PROD Unmoveable Datasets FDREPORT also accepts XEXCLUDE statements Suppose it has been decided that the volume PRODTS is not going to be converted to SMS Taking the previous example the user would alter the report so that it excludes datasets from PRODTS XEXCLUDE VOL PRODTS XSELECT CATALOG NO VOLG PROD XSELECT CATALOG ERR VOLG PROD XSELECT DSORG U VOLG PROD FDREPORT FUNDAMENTALS 1 6 Extended Selection and SMS Information So far we have only shown some very basic selection with the XSELECT parameter However as described in section 54 13 of the FDREPORT manual this parameter can also be used to do significantly more complex selection providing extra facilities in three main areas Firstly in combination with the XDSN operand XSELECT allows users to select on dataset names by using very powerful wild character and wild level filtering From something as basic
6. II TABLE 7 lists the FIELDs available from IAM dataset Control Block for IAM datasets These are in addition to the FIELDs available from the VTOC TABLE 1 and the fields that are normally reserved for VSAM IAMINFO Includes DSORG RECFM MAXLRECL LRECL BLKSIZE CISIZE IAMUSE Includes RECORDS UPDATES INSERTS DELETES OVERFLOW OVERUSED OVER IAMINDIC IAM Indicators ENHANCED E Enhanced IAM format DATACOMP D Data Compressed KEYCOMP K Keys Compressed Used 96 of the Independent Overflow Records APPENDIX TABLE 8 lists the FIELDs that can be obtained from the volume level record Data is gathered and summarized from the LSPACE SVC VTOC VTOC index and VVDS 10 m r m o 9 pd LL el el dD Dd dd ep C CE ze 244 5 5 5 5 5 mame fuen Tarra ounce VLDEFAUL Volume report defaults includes 83 VLVOLSER VLDEVTYP VLUNIT VLINDSTA VLUSEATR VLUSERS VLALOTRK VL UTRKS VLFRETRK VLLRGCYL VLLRGTRK VLFREEXT VLFRAGIN VLVOLSER Volume Serial Dataset Resides On 6 CHAR VTOC JA VLUNIT Device Address the Volume is On EFE CHAR LN E sss cs Daves L ues vtvoup Disk Volume ID _ 4 CHAR LBLTK JE GEN VL FTRKS Percentage of Disk Volume Free 3 NUM VTOC 3 VTOC VLs FDSCB Percentage of DSCBs Free Within the 3 VTOG isUDSC
7. N lt gt gt lt APPENDIX TABLE 8 lists the FIELDs that can be obtained from the volume level record Data is gathered and summarized from the LSPACE SVC VTOC VTOC index and VVDS VLDSOIAM Number of Indexed Sequential Dass 87 Num VLDSOPO NumberofPariionedDalases eT NUM VTOC VLDSOPOE VLDSOPS Extended Datasets Dataset Organization CNN O1 O1 ATTR _ SOURCE VLDSCBI VLDSCB2 MIC VLDSCB3 Luc VLDSCB4 ai VLDSCBS VLDSCB6 uc VLDSCB7 mo VLDSOAM 58 VLDSODA VLDSOEF mee VLDSOHFS luis 1 1 1 1 1 1 1 1 1 1 1 1 1 VLFRAGIN Now SPC VFRECYL WumberofUrusedOyindas s NUM LSPC VLFREBYT 7 NUM VLFREEXT SP0 VLFRETRK VLFREVCI mee VLTOTVCI ae VLFREVIR EC VLUSEVIR SEN VLTOTVIR BEN VLALOSTA Volume Allocation Status CHAR UCB ALLOC Allocated ONLINE Online Not allocated or SYSRES SYSRES System Residence Volume UNLOAD Unload pending O1 tone 3 e Pipl Donne COG CG Status of Indexed VTOC 6 CHAR LSPC X V ACTIVE Indexed VTOC Active NONE No Indexed VTOC YES Indexed VTOC Not Active Continued APPENDIX TABLE 8 lists the FIELDs that can be obtained from the volume level record Data is gathered and summarized from the LSPACE SVC VTOC VTOC ind
8. Percentage of OSCBs Used Winn ne TOC 8 NUM vroc VL FINDX Percentage of VTOC Index Records Free 3 NUM VTIX VLS amp UINDX __ Percentage of VTOC Index Records Used 3 VLs FVVDS _ Percentage of VVDS Control intervals Free 3 VVDS VLALOCYL Number of Allocated Cylinders 5 VTOC Number of Allocated Tracks 50 VTOC VLALOBYT Number of Allocated Bytes VLALTRKS Number of Alternate Tracks on the Volume 5 DEVT VLAVGTRK Average File Size in Tracks NUM VTOC vLavGByT__ Average File Size in Bytes VTOC VLBYTRK_ Track Capacity in Bytes 5 NUM DEVT VLCYLVOL Number of Cylinders per Volume 5 DEVT VLTRKCYL NumberofTracksperCyinder e VLBYTCYL Number of Bytes per Cylinder DEVT VLTRKvOL Number of Tracks per Volume 57 NUM j DEVT JA vugvrVOL Number of Bytes per Volume NUM DEVT EN VLDIRBTR NumberofPDSDirectoryBlocks per Track 3 DEVT ___ Number of VTOC DSCBs per Track 3 NUM DEVT LE vLpscB Total Number of DSCBs NUM JA IS numerare osoa wr roe A D VLDSCBO Number of FORMAT 0 DSCBs VTOC X X S Continued X 41915449 lt lt lt lt lt lt litre gt
9. e Printed in IEHLIST format e Written to an Extract File or Machine Readable File e Used for JCL Creation This Guide will concentrate on the first of these types of output but the other types will be discussed in later sections FDREPORT FUNDAMENTALS 1 5 Basic Selection Criteria Basic selection criteria can be used to determine which datasets are to be included in the FDREPORT generated report As has already been mentioned the Appendix of this Guide and Section 54 31 of the manual show the fieldnames that can be used as selection criteria Some additional criteria are also available under the XSELECT control statement as documented in section 54 13 of the manual As an example of using these selection criteria if a report is required for just a single dataset the dataset name would be used as the main selection criterion XSELECT DSN ABC MYDATA To display information about a group of datasets that have a similar name a Groupname parameter DSG could be used XSELECT DSG PIK VOLG PROD The statement above would display information about all datasets that have names starting with the characters PIK not necessarily as a fully qualified level and which are on a volume with a volser starting PROD Let s now suppose that the user wants to display information about any ICF VSAM datasets that reside on volumes beginning with PROD which are 1000 tracks or more in size and which are in four or more extents
10. involve directing FDREPORT to various sources of information about individual datasets DATATYPE VOLDATA on the other hand allows FDREPORT to gather and report information on whole DASD Volumes For more information on using DATATYPE VOLDATA see Section 2 2 later DATATYPE MCDS BCDS Users of DFHSM can instruct FDREPORT to gather and report on information stored in the MCDS and BCDS control datasets This is done by coding DATATYPEZMCDS or DATATYPE BCDS For more information on reporting on DFHSM control files see Section p2 3 later Sources of Data FDREPORT VOLDATA MCDS BCDS ADVANCED FDREPORT 2 2 Volume Level Reporting Datatype Voldata As mentioned in the previous section FDREPORT can produce reports for volumes as well as individual datasets This is done with a combination of DATATYPE VOLDATA and the VLxxxxxx fields listed in Table 8 in the Appendix In this example DATATYPE VOLDATA is used to look at production volumes VOL ZPROD Y reporting on the VOLSER Unit Address and Device Type together with the percentage used for the VOLUME TU the VTOC DU the VTOCIX IU and the VVDS 9o VU TITLE LINE PRODUCTION VOLUME USAGE XSELECT VOL PROD SORT FIELD VLVOLSER REPORT FIELD VLVOLSER VLUNIT VLDEVTYP VL UTRKS V L oSUDSCB VL AUINDX VL7 SUVVDS PRINT DATATYPE VOLDATA PRODUCTION VOLUME USAGE VOLSER UAD 8TU ZDU 2VU PRODO7 143 3390 37 42 12 45 PROD12 148 3390 76 167 6
11. DIS 54 PROD82 56 36 PROD2T 46 03 PROD45 31 25 16 PRODOS 20 11 FDREPORT SRS PANELS 3 4 FDRViEWS FDRVIEWS is a separate cost option which builds on the foundation of FDREPORT to provide a user friendly question and answer method of generating reports It offers a Windows GUI interface through which reports can be viewed in various graphical formats graphs charts etc or as an Excel spreadsheet Its automated report distributions and alert system can warn you about certain conditions that could be a potential cause for problems such as VI OCs nearing 100 or DFSMS Storage Groups approaching a pre determined threshold e d Orem com CUN Vn Comm wa Groupings Breakdown PRODiSMSStorgrp PROD6 SMS Storgrp Giga Bytes 0096 1 50 8002 E3330 01 08002 1050790 51 50 9007 00p 9 21 50 6007 2 0 8002 00 090 12 60 9052 ees G0 R00r 2 50 WOOK 50 800 AON 52 90 8007 eorex 7 533007 IEZI 2 0800 15201 605502097 Report Distribution The reports generated by FDRVIiEWS be made available to key personnel within your organization without the need to give them access to the main GUI interface Application administrators department managers programmers etc can all be granted access to view reports through the web based Report Distribution feature which is accessed through a standard internet b
12. FDR UPSTREAM ENCRFLSQ Encryption Original Backup File Seq CRYP ENCRKEY Encryption Key CHAR CRYP ENCRPROF Upstream Profile Name CHAR CRYP H ENCRTIME Backup Time hhmmss 8 NUM CRYP X Continued APPENDIX file otherwise it is from the ABR backup subsystem If COPY or OLDBACKUP was specified there may be more than one line of this information available REPORT will list them on multiple lines SELECT XSELECT will test against all copies of the fields S TABLE 4 lists dataset backup information from the ABR system E If DATATYPE ARCHIVE was specified this information is from the archive control E C T NAME DESCRIPTION ama SOURCE ENCRTYPE Encryption Type CHAR CRYP AES128 AES with 128 Bit Key AES192 AES with 192 Bit Key AES256 AES with 256 Bit Key AESFAST AES with 128 Bit Key CIPHER Transformation Substitution SUBSTITUTE Character Substitution ENCRVOL Volume Serial Number Encrypted 6 CHAR CRYP mE SPLEBDSN _ Encrypt Bkup Dsname ABR Split Format CHAR CRYP a the format and width of date fields varies depending on the value of the DATEFORMAT operand 2 if the expiration date is 99 000 or 99 365 or above this is set to 65535 3 this field supports selection via a mask see the VOL operand in Section 54 13 this field is four bytes by default or five bytes if FIVEBYTESBKFS is enabled APPENDIX TABLE 5 lists the FIELDs that can be
13. ABRCYCLE Current ABR Cycle Number MODL ABRIND ABR Indicators 5 CHAR VTOC A Always Backup Never Archive Current ABR Backup Exists Normal Backup Never Archive Archive Requested Exclude from ABR Processing Reports Only Not for Selection No Current ABR Backup Exists Instant backup is pending SNAP SPLIT PSPLIT FCOPY has been done but the point in time image has not yet been copied to a backup file only in a report line for an ABR model DSCB Multi Volume Dataset Old Backup Recording is Enabled U Updated Since Last ABR Backup ABRHITRS ABRLOTRS ADATE ATIME JEN ADAYS ARCDSN Archive Control File Name ARCFLAGS Includes ARCFLAG 1 ARCFLAG2 ARCFLAG 1 ARCHIVE Control File Flag 1 5 CHAR ARCH FIVEVOL F Backup Over 5 Vols MULTIVOL M Multi Volume Dataset RESTORED H Restored from ARCHIVE ARCHIVE Control File Flag 2 5 CHAR ARCH ee ARCFLAG2 CLUSTER Entry for ICF Cluster DELETE D Entry Flagged for Deletion NOTCAT N Backup Not Cataloged RECALL A Archived for Auto Recall ARCTTR TTR Used for Auto Recall 6 HEX ARCH zenrne BM mo qq 0 0 sese lt lt ACTTTR Actual TTR of Record in ARCHIVE Control File ARCH BKINFO Includes 1 CHAR BKDATE BKSUFFIX BKFILENO BKVOL Continued APPENDIX TABLE 4 lists dataset backup information from the ABR system If DATATYPE ARCHIVE was specified this information is from the archive co
14. PO MY DATASET CNTL1 20 PO MY DATASET LOAD 30 PO OTHER DATASET 60 PS DATA FILE REAL1 20 5 OLD SMALL BS EC om 90 Es 2 ike tO FDREPORT FUNDAMENTALS 1 10 Summaries FDREPORT also provides the facilities for including summaries A summary consists of column totals for fields that are numeric and occurrence counts for non numeric fields The SUMMARY command which is used to state the fields that are to be summarized defaults to printing the summary at the end of the listing Extra summaries can also be produced as subtotals at control breaks if required This is controlled by the BREAK parameter on the SORT command So extending the previous example still further let s alter the report so that it produces a summary on all fields printed in the report both at control breaks and at the very end of the report The BREAK SSP parameter the SORT statement indicates that control breaks are to consist of one blank line and sub totals The SUMMARY statement defines which fields are to be summarized each time and also creates a summary at the end of the report XSELECT VOL IDPV50 REPORT FIELDS DSORG DSN SIZE SORT FIELDS DSORG SEQUENCE A BREAK SSP SUMMARY FIELD DSORG DSN SIZE PRINT The report on this occasion would look like the following example Notice how the DSORG and DSN fields are summarized by occurrence while the SIZE field is summarized as a total DS
15. as the following to select all files beginning with TAB XSELECT XDSN TAB to more complex filtering where datasets are being selected if they have a three character first level qualifier beginning T and the characters YM in any position in any other qualifier XSELECT XDSN T YM Also included in the XSELECT parameter is the ability to select by a specific or masked DASD unit address or generic or esoteric unit names Expanding the above example a user could report on the same filtered dataset name but only on certain volumes XSELECT XDSN 7T YM UNIT 140 Specific Unit Address Or XSELECT XDSN 7T YM UNIT214 Masked Unit Address Or XSELECT XDSN 7T YM UNIT 3390 Generic Unitname Or XSELECT XDSN T YM UNIT SYSDA Esoteric Unitname The second type of extended selection in XSELECT is the ability to use logical operators such as GT greater than LT less than and NE not equal rather than just equals The full set of available operators is given in section 54 13 of the FDREPORT manual which also confirms which of the logical operators apply to each of the fieldnames Users should note that this includes DSN DSG XDSN VOL VOLG STORGRP and UNIT parameters Extending the previous example further a user could use logical operators to narrow the selection by selecting just those datasets that are between 100 and 200 tracks in size XSELECT XDSN T YM SIZE
16. com desales fdrinnovation com nisales fdrinnovation com uksales fdrinnovation com frsupport fdrinnovation com desupport fdrinnovation com nlsupport fdrinnovation com uksupport fdrinnovation com C E PTS amp FACILITIES G U IDE July 2010
17. generated by ABR from information contained in the VTOC Catalog or the VVDS DESCRIPTION SIZEINFO Includes SIZE SIZEFREE SIZE Size of the Dataset in Tracks BYTES Size of the Dataset in Bytes KB MB MAXSIZE Maximum Size of Dataset in Tracks if All Secondary Allocations Taken SIZEFREE Number of Tracks Unused for Dataset E NUM GEN and VSAM Actual Free Tracks Others Zero 0 NUM N SIZEUSED Number of Tracks Used for Dataset PS and VSAM Actual Used Tracks All Others Total Allocated Space NUM VVDS G JA X TRKC BYTESUSE Bytes Used in the Dataset BLKSTRK Number of Blocks per Track BYTESTRK TRKCYL LUN C NN MN PRIBYTES Jee NEN NN SECBYTES NOM GEN A Pe ET ia 50 BYTESFRE 2 Max Track Capacity of Device in Bytes VTOC CAPBYTES Bytes Size of Allocated Space if Used at Track Capacit FREE Percentage of Free Space in Dataset USED Percentage of Used Space in Dataset FREEEXT Number of Allocated Extents Containing No Data GEN USEDEXT Number of Allocated Extents Containing Data GEN A X X CAPUSED Percentage of Capacity Utilization based on 3 NUM GEN allocation and BLKSIZE CATALOG Indicates if Dataset is Cataloged 3 CHAR C E E X X This can be Expensive to Collect if a Large Number of Datasets are to be Reported YES Cataloged to this Volume NO Not Cataloged at All ERR Cataloged to An
18. mm ss GEN OL Volume Serial Dataset Resides on V CHAR VTOC E FILESEQ File Sequence Number tape only CAT UNIT Device address the Dataset is on 3 4 CHAR GEN DEVTYPE BEN DEVCLASS BEN UCBSTATS l LE UCBID UNITNAME ave VOLID EBEN INDEXNUM of Index Level in the Dataset or Cluster Name 3 NUM USER that is Extracted into Field INDEX CHAR DSN CLUS INDEX Extracted Level from Dataset or Cluster Name CHAR NTMIGRAT HSM Only Number of Times Dataset has been SYSID SMF System ID Where FDREPORT was Run 4 CHAR mT tte tt tet det tome im eee lll PPP GEG GE E meas SMEEEEEEEEEBEBEEEEEEE ERE EB ER E E E REEL Migrated MCDS or Backed Up BCDS Continued APPENDIX TABLE 5 lists the FIELDs that can be generated by ABR from information contained in the VTOC Catalog or the VVDS DESCRIPTION ATTR SOURCE SOURCE Source of this Data Record CHAR E ARCHIVE BCDS CATALOG rResvor Nero tracts on his Voume MEE HANG e CERANO oe _ Contro Uni Subsystem tenter a feon E x X V RECONFLG FOREPORT Product Version 8 GEN UM GEN RECTYPE FDREPORT Data Record Type N X Volume Record Dataset Component Record Volume Summary Record Prior Compressed Data Record Prior Active Fields Record Compressed Data Record Active Fields Record RR E ee r ee EL
19. 11 Adding Customized Titles to the Report Most reports are of little use unless they contain a title It is sometimes also necessary to provide a better explanation of some all of the columns in the report These things can be done with the TITLE and HEADING commands The report layout can further be improved with the SPn parameter on the REPORT FIELD statement which can be used to override the default spacing between individual columns So taking the ineligible SMS datasets example we used earlier TITLE LINE SMS PROJECT SUMMARY OF INELIGIBLE DATASETS HEADING LINE 1 ODD DATASET RESIDES LAST USED ON XSELECT CATALOG NO VOLG PROD XSELECT CATALOG ERR VOLG PROD XSELECT DSORG U VOLG PROD XSELECT DSORG AM DSORG7 EF VOLG PROD REPORT FIELD DSN VOL SP6 LRDATE SORT FIELD LRDATE SEQUENCE A A title has now been added to the report and the column headings for the DSN VOL and LRDATE fields have been altered to ODD DATASET RESIDES ON and LAST USED ON respectively Up to three heading lines could be used over each column Note also the use of SP6 to request six spaces between the last two columns to space it correctly under the new longer customized heading The resulting report is now much clearer and its meaning more apparent SMS PROJECT SUMMARY OF INELIGIBLE DATASETS ODD DATASET VERY OLD DATASET PRODOL 2008 100 UNMOVEABLE DSET PRODTS EXISTING UNCAT DATA PRODXX 200 132 RECENT WRONGCAT
20. 15 PROD18 14 3390 66 35 23 78 In this next example we are reporting on the MOUNT the USAGE and the SMS volume STATUS of every online volume TITLE LINE VOLUME STATUS REPORT REPORT FIELD VLVOLSER VLUNIT VLDEVTYP VLUUSEATR VLMOUSTA VLSMSTAT VLSMSVST PRINT ENABLE ONLINE DATATYPE VOLDATA VOLUME STATUS REPORT VOLUME 00 STORAGE RESIDENT NONE DBLRG1 3195 5390 PRIVATE RESIDENT MANAGED ENABLED DBLRG3 3176 3390 PRIVATE RESIDENT MANAGED ENABLED In this final example we look at volumes with disabled VTOC Indexes VLINDSTA YES TITLE LINE DISABLED VTOC INDEXES XSELECT VLINDSTA YES REPORT FIELD VLVOLSER VLINDSTA PRINT ENABLE ONLINE DATATYPE VOLDATA DISABLED VTOC INDEXES HE MIO Ix TSO134 YES MVS002 YES DB2RES YES ADVANCED FDREPORT 2 3 Reporting on the DFHSM control files Datatype MCDS BCDS As mentioned earlier users of DFHSM can also use FDREPORT to report on information stored in the DFHSM control datasets the MCDS and the BCDS This is done using the DATATYPE MCDS or DATATYPE BCDS parameters together with the fields listed in Tables 9 and 10 in the Appendix In this first example we are using DATATYPE MCDS to instruct FDREPORT to report on DFHSM migrated datasets as recorded in the MCDS Table 9 Information such as the date and time that the dataset was migrated by HSM is included in the report together with details of the original datasets DSORG and allo
21. 2 NUM CRDATE EXPDATE LRDATE CRDATE Creation Date AE NUM 0 VTOC CAT 1 1 pm romeo gt lt 199111119 ee jj nj enne lt lt U EXPOATE NUM VTOC CAT LRDATE Last Reference Date NUM VTOC X VVDS NOEPV Number of Extents for Dataset NUM VTOC A X S TVTC NOBDB Number of Bytes in Last Directory Block NUM VTOC GIA TVTC SYSCODE System Code Field in DSCB 13 CHAR VTOC A X V TVTC DCBINFO Includes MIX DSORG RECFM BLKSIZE LRECL Continued APPENDIX VVDS or catalog S TABLE 1 lists the FIELDs available from the datasets DSCB in the VTOC If a E VSAM cluster is being reported some of the information may be found in the L E C T DESCRIPTION Jien Arr SOURCE LEN DSORG Dataset Organization 3 CHAR VTOC E AM All VSAM TVTC DA BDAM ICF VSAM Hierarchical File System Open Edition Innovation Access Method ISAM Partitioned PDS PDSE PDS Extended Physical Sequential PS Extended Format Large Sequential Unmovable may be appended to all other forms UN Undefined RECFM Record Format 5 CHAR VTOC E E X IX TVTC OPTCD Option Code Byte 2 HEX VTOC EE X X TVTC BLKSIZE Dataset Block Size LRECL Dataset Logical Record Size KEYLEN Dataset Key Length KP Dataset Relative Key Position X S E L E C T E T e JJ Z 2 2 Z C C C C 4 lt lt lt lt 39533333
22. AL2 certified product that can be licensed as an option to FDRPAS or separately It can quickly and securely erase many z OS disk volumes in parallel allowing you to erase your data in the minimum elapsed time Multiple levels of erasure are available See also FDRERASE OPEN INTRODUCTION IAM FATS FATAR and FATSCOPY complete Innovation s 2 05 product range e AM is Innovation s alternative to VSAM KSDS ESDS and as a cost option AIX and RRDS files IAM consistently provides 50 80 reductions in EXCPs Batch Elapsed Times and Online Response Times as well as a 20 40 reduction in CPU usage compared to VSAM Due to its advanced file structure IAM typically requires 30 70 less DASD space than VSAM to hold the same amount of data e AM PLEX is a cost option to IAM that allows applications to concurrently execute and update IAM files on multiple LPARs Systems that are part of a 2 05 sysplex e FATS FATAR is a set of multi purpose tape subsystem Media Integrity tools that allow for online tape certification verification analysis and erasure of tapes e FATSCOPY provides automated tape stacking and conversion including Tape to VTS VTS to Tape and VTS to VTS conversions The UPSTREAM family builds on the strengths of the FDR Storage Management system and extends Innovation s range of products beyond the boundaries of z OS FDR UPSTREAM provides a fast safe and reliable solution to backing up Open Systems data from file
23. DESCRIPTION ATTR SOURCE P U N C hel VVRSTATS Indicates VVDS errors for this Dataset up to 2 CHAR VVDS may be displayed NONE No Errors DPLR Multiple Identical VVR NVR Records MLTR Multiple Non Identical VVR NVR Records MLTQ Multiple VVR Q Records EXTM Extent Mismatch Between VVR DSCB NVVR No VVR NVR Record or all matching records have errors Lg S O R T CMPCANDV Number Candidates Cataloged to Component CAT X X V CMPVOLCT Number Volumes Cataloged to this Component CMPVOLTL Total Volumes Cataloged to this Component fA X SECURFLG Security Flags E ems mE X RACF Discrete RACF Profile OWNC Ownership Cluster SECVERMO Security Verification Module 8 CHAR VVDS E IV SPACEFLG Space Allocation Flag oe X V CYLINDERS KILOBYTES MEGABYTES RECORDS TRACKS wmexror ExentCountiromWRTypesocel 7 GHAR WS X V 1 this field supports selection via a mask see the VOL operand in Section 54 13 APPENDIX TABLE 3 lists the additional FIELDs available for a dataset on an SMS managed volume For non SMS datasets these fields will be blank NAME DESCRIPTION ama SOURCE SMSCLASS Includes 26 CHAR STORCLAS DATACLAS MGMTCLAS ues x pp sees dx abb MN LLL s wascar E X e xc x DATACLAS SMS Data Class CHAR VVDS CAT peter ae een E IER STORGRP S
24. DS PRODCI BOLO 122 T FDREPORT FUNDAMENTALS 1 12 Running The Supplied Health Check Reports When the FDREPORT program library is installed from the product tape it is also accompanied by another PDS called the JCL library which contains a copy of each example job in the product manual In addition to the members containing these JCL examples there are also some members in the library called HCHECKx where x is a number from 1 9 These contain some additional FDREPORT examples Their purpose is two fold To provide real life examples of the facilities available within FDREPORT As well as the standard features like Selection Sorting and Summarizing the HCHECKx members also make extensive use of some of the more advanced FDREPORT features that we will be discussing in PART TWO of this Guide You ll see examples of various DATATYPE settings as discussed in section 2 1 and you ll also see the extensive utilization of the combination of RPTYPE DATA and DATATYPE EXTRACT to create and use Extract files as discussed in section 2 5 Some of the HCHECKx members also use the Punch facility that we look at in section 2 6 to create complete JCL streams To provide a HEALTH CHECK on your installed DASD All of the HCHECKx reports have been designed to look for specific problems both at the dataset level and the volume level See the tables on the next page for a list of the type of problems that are reported The HCHECKx r
25. EPORT FIELDS and other formatting statements are ignored Forms of Output ONE CEN FDREPORT ADVANCED FDREPORT RPTYPE XREF RPTYPE XREF causes FDREPORT to print the report in the same format as the PRINT BACKUP XREF command of FDRABRP Again XSELECT statements are honored but REPORT FIELDS and other formatting statements are ignored Users may refer to the FDR User Manual section 53 for examples of the FDRABRP report layouts RPTYPE DATA This is similar to RPTYPE NONE in that no actual report is produced However FDREPORT creates an EXTRACT FILE containing the dataset records of all datasets selected in this execution The extract file is written to SYSUT2 in an internal Innovation format See section 2 5 for more information on creating and using Extract Files RPTYPE SELPCH This is also similar to RPTYPE NONE and RPTYPE DATA in that no actual report is produced However with this option you can write or punch as it is known information on each dataset selected within the report This information can then be combined with additional pieces of free format text See section 2 6 for more information on creating and using Punch Output 2 5 Using Extract Files To Generate Multiple Reports oo far this Guide has only shown examples of creating one report per execution of FDREPORT Several reports can however be printed each time This is achieved by coding additional sets of PRINT and other control stateme
26. FDREPORT C EP TS amp FACILITIES G U IDE gue INNOVATION DATA PROCESSING FDREPORT t a b o f c o n t e n t s D EE Pe 2 PART ONE FDREPORT Fundamentals essen emen enne ener nennen nennen 5 1 1 The Importance of DASD Management 6 122700019 MEE ee m m T ee ee ee eee T To FDREPORT NTOdUCHOM nn EE REEE T 1 4 Sources of Information and Types of 8 E T UU 10 1 6 Extended Selection and SMS Information 11 1 7 Specify Which Fields To Display 12 1 8 Setting Defaults and the Print Command 13 We LISTING MERERETUR LITTERE 13 E 15 1 11 Adding Customized Titles to the 16 1 12 Running the Supplied Health Check 17 PART TWO Advanced 19 2 1 Accessing Other Sources of Information 20 2 2 Volume Level Reporting 22 2 3 Reporting on the DFHSM control files Dataty
27. GE 100 SIZE LE 200 Alternatively taking the ineligible SMS datasets example from earlier a Not Equal test expressed as can be used to select ineligible datasets including Non ICF VSAM XSELECT CATALOG NO VOLG PROD XSELECT CATALOG ERR VOLG PROD XSELECT DSORG U VOLG PROD XSELECT DSORG AM DSORG7 EF VOLG PROD The third and final set of extra facilities is related to SMS XSELECT can use SMS CLASS names and STORAGE GROUP names as selection criteria Having used FDREPORT to isolate datasets that are ineligible for conversion to SMS users can then use FDREPORT to confirm that the remaining datasets were correctly converted Any of the SMS class names stored in a datasets VVDS entry can be used as a selection criterion For example to report on all datasets that now have an SMS Management Class of LATEMIG and which reside on volumes in Storage Group DBPROD XSELECT STORGRP DBPROD MGMTCLAS LATEMIG FDREPORT FUNDAMENTALS 1 7 Specifying Which Fields To Display The XSELECT statement is used to determine which datasets will be included in the report To specify what information is to be printed for those datasets a REPORT FIELD statement is coded This allows users to generate reports containing only the information required Any of the fields in tables 1 7 in the Appendix can be chosen and they will be displayed in the order listed in the FDREPORT FIELD statement Fields can be STACKed so that one col
28. MS Storage Group on which the Milli Dataset Resides SMSFLAGS SMS flag byte in DSCB unu S X MANAGED S SMS Managed NOBCS N Not Cataloged REBLOCK Reblockable DADSMCRT D DADSM Assigned Blksize PDSE PDS Extended PDSEX HFS Hierarchial File System STRIPE Extended Format EF ATTREXTN Extended Attribute EA LASTBKUP SMS Last Backup Date and Time HSM 13 CHAR VVDS NVSAMATR SMS NONVSAM Attributes X V ACTGDG Active GDG Generation DEFGDG Deferred GDG Generation ROLGDG Rolled out GDG gGeneration PDSE PDS Extended POSIX HFS Hierarchial File Sys NVSAMFLG SMS NONVSAM Flags CHAR VVDS ATTREXT Extended Attribute EA EXTEND Extended Format EL 23 Mecovom sWSmemeyDdr s oum Te HE SOR OWN OMS Hee cs Owen NE Js SUBGFLAG SWS Subset Fag Byer one wes fe pe ee ee E EROA ee ee this field supports selection via a mask see the VOL operand in Section 54 13 APPENDIX TABLE 4 lists dataset backup information from the ABR system If DATATYPE ARCHIVE was specified this information is from the archive control file otherwise it is from the ABR backup subsystem If COPY or OLDBACKUP was specified there may be more than one line of this information available REPORT will list them on multiple lines SELECT XSELECT will test against all copies of the fields DESCRIPTION ATTR SOURCE ABRGEN Current ABR Generation Number MODL
29. ORG DSN SIZE lens VSAM DATASETI1 100 VSAM DATASET2 200 SUBTOTAL DSORG RE DSN 2 300 IE PROD PAYROLL GOO1 20 Js PROD PAYROLL G006 30 TS ALPHA PARTS list 15 TS Do UE GI IR 60 SUBTOTAL DSORG 15 DSN 4 SIlzkh 125 PO MY DATASET CNTLI 20 PO MY DATASET LOAD 30 PO OTHER PO DATASET 60 SUBTOTAI DSORG PO DSN 3 110 PS DATA FILE REAL1 20 PS OLD SMAI iit 15 BS BILIG o Suo 90 BS OTHER EPS efile 10 SUBTOTAL DSORG PS DSN 4 133 FINAL TOTALS VALUE SUMMARY OF DSORG TOTAL NUMBER OF VALUES 4 DOORC MH 2 TS DOSE PS 4 153 SIZES t 670 FDREPORT FUNDAMENTALS Another useful application of SORT and SUMMARY is summarizing reports according to the prefix or other index levels of the dataset name This works by a combined use of the INDEX parameter on the SORT SUMMARY command and the INDEXNUM parameter on the PRINT or DEFAULT statement For example to list some datasets and then summarize by high level prefix XSELECT VOL IDPV50 REPORT FIELDS DSN SIZE SORT FIELDS INDEX SEQUENCE A BREAK SSP SUMMARY FIELD INDEX SIZE PRINT INDEXNUM 1 Alternatively to run the same report but summarize by the third level index XSELECT VOL IDPV50 REPORT FIELDS DSN SIZE SORT FIELDS INDEX SEQUENCE A BREAK SSP SUMMARY FIELD INDEX SIZE PRINT INDEXNUM 3 1
30. RG DEVTYPE SMAI Mie TEST 4 IS ENIMS ODD DATA 0 ES MY Es Ie IES 15 Cab DO This final example of an XSELECT shows a report of datasets beginning with CRITICAL that have been used in the last four days Included in the report are the Creation Date and the Last Reference Date XSELECT XDSN CRITICAL VOLG PROD1 LRDAYS lt 4 REPORT FIELD DSN CRDATE LRDATE FDREPORT FUNDAMENTALS 1 8 Setting Defaults and the Print Command FDREPORT has a large number of additional processing options most which can be controlled by parameters coded on either a DEFAULT or PRINT control statement These are described in the manual in sections 54 10 and 54 19 respectively Some options are unique to the DEFAULT statement only If no parameters are coded many will assume a default value which has been defined in the FDREPORT Global Options table or which has been hard coded into FDREPORT itself Some of the available options are BYTEFORMAT to express dataset size in Bytes Kb or Mb DATEFORMA to specify the format of printed dates LINECNT to control the number of lines per page PAGEWIDTH to control the number of characters per line DATATYPE to set the source of input data see section 2 1 later RPTYPE to request the type of report output required see section 2 4 later Users should note that while the DEFAULT statement is optional and is usually one of the first control statements coded the PRINT statement is
31. S RETRIEVE UPDATES INSERTS DELETES HIALORBA m 1 emmmeeem enr CATNAME CI CICA CISIZE eee ee a TRKSCA CLUSATTR VSAM Cluster Attributes 24 CHAR VVDS CAT ATL Tape Volume Catalog ATTREXT Extended Attribute EA EXTEND Extended Format EF FORMAT Formatted Pagespace PAGESPACE Pagespace SWAPSPACE Swapspace TIMESTAMP Timestamps Exist VERIFYREQ Verify is Required ee mtr tt _ E a a ze 7e COMPTYPE VSAM Component type 5 CHAR VVDS CAT E X Base Cluster Data INDEX Base Cluster Index AIXDATA AIXDA Alternate Index Data AIXINDEX AIXIN Alternate Index Index Continued APPENDIX TABLE 2 lists the FIELDs available from the VVDS or ICF catalog for ICF VSAM clusters This is in addition to the FIELDs available from the VTOC TABLE 1 For non VSAM datasets these fields will contain blanks Those fields that show a source of IAM are also valid for IAM files those that show IAM are valid only for enhanced IAM files NAME DESCRIPTION ATTR SOURCE 24 COMPATTR VSAM Component Attributes AR VVDS VVDS CAT RCVY Recovery REPL Replicate RUS Reusable SPED Speed SPND Spanned WCK Write check VOLCFLAG VSAM Volume Flag CANDWSPACE Candidate with Space EXTENTSYNC Extents Do Not Match VTOC GUARSPACE SMS Guaranteed Space OVERFLOWVOL Overflow Volume PRIMEVOLUME Prime V
32. UE Attribute Byte Two 24 CHAR VVDS CAT CATALOGBUSY Catalog Busy CATALOGLOCK Catalog is Locked COMPNOTUSE Component is Not Usable INTERNALDSN Internal System Dataset REGSHROPT1 Share Options 1 REGSHROPT2 Share Options 2 REGSHROPT3 Share Options 3 REGSHROPT4 Share Options 4 LN AXRKP LI SHROPT wpe BAIAE OG UA ER ee eee JS a OWNER VSAM Owner Identification 8 CHAR VVDS CAT TIMESTMP CASPLIT Number of Control Area CA Splits 8 NUM VVDS coniu oePur Number of Conto tena G Solis 5 NUM wos CMM LN E ATTR2 X X A X CISPLITR INDEXLEV 2 EXCPS DELETES INSERTS RECORDS RETRIEVE UPDATES VSFREBYT VVRVRBA Actual Relative Byte Address of VVR in VVDS 8 HEX VVDS o mmoeeom verre Gi Et Rt i a it a Et at Et ie eR Be Be i Be iO 79 T9999 ists sss BE Continued APPENDIX For non VSAM datasets these fields will contain blanks Those fields that show a source of IAM are also valid for IAM files those that S TABLE 2 lists the FIELDs available from the VVDS or ICF catalog for ICF VSAM E clusters This is in addition to the FIELDs available from the VTOC TABLE 1 L E C show IAM are valid only for enhanced IAM files T
33. Use GEN MEMBERS Number of Members in PDS NUM DIRB FAMS DIRISPF ISPF Member List Equivalent Activates GEN MEMNAME MEMBABAS MEMBCURR MEMBCRDT MEMBLMDT MEMBLMTI MEMBINTR MEMBMODR MEMBVFM MEMBID MEMBABAS DIRE MEMBAMOD 3 DIRB MEMBATTR PDS PDSE Member Load Module Attributes 19 CHAR DIRB AC1 Authorization Code 1 NOEX Not Executable Load Module Member List Activates MEMNAME MEMBABAS MEMBSTOR MEMBTTR MEMBAMOD MEMBRMOD MEMBATTR MEMBSSI LANE 2 OL Only Loadable DIRLKED PDS Member List Equivalent Activates MEMNAME MEMBABAS MEMBTTR MEMBVFM MEMBCRDT MEMBLMDT MEMBLMTI MEMBCURR MEMBINTR MEMBMODR MEMBID DIRPDS REFR Refreshable RENT Reentrant REUS Serially Reusable MEMBCRDT PDS PDSE Member Creation Date yyddd 6 NUM DIRB MEMBCURR PDS PDSE Member Current Record Count DIRB MEMBENTR PDS PDSE Member Load Module Entry Point 8 DIRB Ho oo e e umm a a E e e E LR RN REC Continued APPENDIX TABLE 6 lists the FIELDs that can be obtained from the directory of a Partitioned Dataset or an Extended Partitioned Dataset via FAMS DESCRIPTION Arm SOURCE wEMBID PDSPOSEMemberid om pe MEMBMOD PDS PDSE Member Last Wod Number NUM be MEMBMODR PDS PDSE Member Modified Record Cout 5 NUM bs m E IMEMESTOH EORUM
34. able Datasets e Datasets existing as only a catalog entry HCHECK2 Reports For VSAM Tuning Analyst e SMS Volume status e SMS Volumes with disabled VTOCIXs e Datasets SMS Attributes Information On PDSE Datasets e Uncataloged Datasets On SMS Volumes e Non Managed Datasets On SMS Volumes e Datasets Ineligible For SMS Management HCHECK5 Reports For VSAM Tuning Analyst e Space Occupied By Largest VSAM Files e Clusters With High Inserts e Clusters with high CI CA Splits e Clusters With Or More Index Levels Multi Extent Multi volume VSAM Files Clusters e Overallocated VSAM Clusters HCHECK8 Project or DASD Management Reports e Summary Of Dataset Types e Space Occupied By An Application e Space Summarized By Index e DASD Utilization By Esoteric Unit Name e DASD Utilization By SMS Storage Group Name e DASD Utilization By Volser Group Devtype Reports on PDS Efficiency e Disks With Potential Performance Problems e Multi Extent VSAM Datasets e Multi Extent Non VSAM Datasets e Multi Volume Datasets e Datasets Likely To Get Sx37 Abends HCHECK6 Reports on PDS Efficiency Basic Stats On PDS Datasets Multi Extent PDS Datasets e PDSs With Limited Freespace e PDSs With Limited Free Directory Blocks e PDSs With Excess Free Space e Space Reclaimable By PDS Compression HCHECK9 Miscellaneous Reports Reports for the ABR Administrator Reports
35. apShot Copy EMC TimeFinder Hitachi Shadowlmage and IBM FlashCopy FDRINSTANT also enhances the performance of other utilities in the FDR Family such as FDRCOPY and FDRMOVE e FDRCRYPT offers encryption services for all FDR and ABR backups as well as sequential output created by an IDCAMS REPRO FDRCRYPT protects these backups against unauthorized access by anyone who does not possess the proper encryption keys e FDRDRP is an extension to ABR which can reduce full volume recovery time by up to 80 e FDRPAS FDRMOVE provide non disruptive or minimally disruptive movement of data from one disk to another either within the same disk subsystem or across different subsystems Data can be moved non disruptively at the volume level with FDRPAS or it can be moved non disruptively or with minimal disruption at the data set level with FDRMOVE These products are particularly useful for migrating and or consolidating data from smaller disks to larger disks e g 3390 3s to 3390 9 27 54s and EAVs e COMPAKTOR and FDRREORG offer intelligent and powerful reorganization processes for whole DASD volumes and for PDS VSAM and IAM data sets e FDREPORT and FDRVIEWS provide extensive customized DASD Management Reporting to suit many needs and purposes You can run your reporting as a z OS batch job or through TSO ISPF panels with FDREPORT or you can use a Windows based user interface available through FORViIEWS e FDRERASE V5 4 L70 is an E
36. ation Control File As in batch FDREPORT the SRS user can specify the information that is to be displayed and the order in which it is to be sorted This is achieved by entering a report position in the REPORT field and a sort parameter in the SORT field In the panel below the report will contain the dsname creation date and volser with the columns in that order and the report will be sorted by creation date in ascending order oldest to newest SEE gt DATASET SELECTION c COMMAND gt SCROLL gt PAGE 1910 SELECTION VALUE REE Orn SORT SOURCE PTRECDS DSNAME VOL SOURCE CATALOGN ARCDSN VIO Piel BIS VAS gt D E 2 em JH JH D H eu DEFAULTS ONG aR DEVI we BI VOLSQ DATES CRDATE FDREPORT SRS PANELS The result of the selections in the previous panel would then be displayed on the user s screen in the SRS Dataset List Panel Note that the selected fields of Dsname Crdate and Volser are being displayed and the entries are sorted by ascending Crdate as requested oes cara cS amp DATASET COMMAND gt SCROLL gt PAGE COMMAND DATASET NAME CRDATE VOLSER DREPORT 20037036 MVSOOL Ris Chik 2008 234 TSO004 8 7 Ober ning 2008 OTO DEV020 RPS VoAM F
37. cation Only datasets beginning with USERT1 will be included in the report The MCDS which has been named on the MCDSCLUSTER parameter will be dynamically allocated TITLE LINEZ HSM MIGRATED DATASETS DEFAULT MCDSCLUSTER HSM MCDS XSELECT XDSN USER1 REPORT FIELD DSN VOL DSORG SIZE SIZEFREE ADATE ATIME ADAYS PRINT DATATYPE MCDS HHSM MIGRATED DATASETS SOLOER WENT ADDIT aries vee USER1 TEST ESDS SMS802 EF i 0 ZOO or ae 1055 USER1 OTHER SMS001 PS 100 95 OCS 25 1070 And in the next example we are using DATATYPE BCDS to instruct FDREPORT to report on datasets backed up by DFHSM as recorded in the BCDS Table 10 Information such as the date and time that the dataset was backed up by HSM is included in the report together with details of the original datasets DSORG and allocation and the volume on which it resided when it was backed up Again only datasets beginning with USERT will be included in the report The BCDS has been named on the BCDSDD card within the JCL BCDSDD DD DISP SHR DSN HSM BCDS SYSIN DD TITLE LINE HSM BACKUP OF DATASETS XSELECT XDSN USER fk REPORT FIELD DON VOL DSOCRG SI1ZE ADATE AT IME AADAYS PRINT DATATYPE BCDS HSM BACKUP OF DATASETS eee ET WIN pn ORG Eee etme USER1 FILE1 SMS800 PS 5 ONO ONS 20 15 SS che USERI ANOTHER 5 5010 4 0 ADVANCED FDREPORT 2 4 Other Forms Of Output As well as a traditional print
38. ciently with volumes being very underutilized It does however have the advantage that applications can be very self contained and users can be made more directly responsible for the DASD space they consume For example a team would have to explicitly request and justify the use of another disk if the first one they were allocating was filled Under pooling systems a larger number of volumes can be shared between many project teams or applications This has the effect of relieving the space constraints on each team It also removes their level of responsibility for managing the media This becomes the responsibility of the DASD Administrator who will ensure that space is not being wasted and that individual application teams are not using excessive amounts of DASD The second effect of pooling is that it makes it difficult to predict exactly where datasets will be allocated at any given time This can sometimes be regarded as an advantage but it also presents problems when doing the type of I O tuning mentioned earlier Also in disaster recovery situations it becomes harder to recover from DASD problems when it is not clear what data has been lost A final point about pooling is that it is essentially a pro active system whereby datasets are allocated in accordance with rules established by the DASD Administrator However dataset requirements can be very individual and they can change with time so it is impossible to eliminate the poss
39. e lala MEN NN NEL EL LIC 4441454 5 4 1 169 VLDCEFLG VLDCEFL8 gt gt S gt gt gt S DX Continued APPENDIX TABLE 8 lists the FIELDs that can be obtained from the volume level record Data is gathered and summarized from the LSPACE SVC VTOC VTOC index and VVDS DESCRIPTION N ATTR SOURCE VLCMTBYT Cylinder Managed Number of Total Bytes 1 NUM VLCMTCMG Cylinder Managed Number of Total Managed NUM Cylinders VLCMTTMG Cylinder Managed Number of Total Managed 1 E Tracks VLCYLADR Address of Start of Cylinder Managed Space NEN VLDSCB8 Format 8 DSCB Count NUM VLDSCB9 Format 9 DSCB Count VLMINACY Cylinder Managed Minimum Cylinder Allocation VLSPRETN SPACE CHAR LSPACE DSCBO FRVIR Z C C LILLLLLLLLLLLLLL ___ sese 229 PETE TET A Lille EAS EAS AS Z C lt FRAGI CYLMS Type of Information Returned by LSPACE VLTM FTK VLTM TOT VLTM UTK VLTMABYT NUM GEN GEN GEN LSPACE VLTMALOC VLTMALOT VLTMFBYT VLTMFRAG VLTMLFCY VLTMLFTK VLTMNFCY VLTMNFTK VLTMNFXT VLTMTBYT VLTMTCMG Track Managed Number of Total Managed Cylinders VLTMTTMG Track Managed Number of Total Managed 1 B Tracks VLTMTTRK E IM ug LI 1 the width of these fields will be 6 if the FATDISK option is enabled or 7 if the LARGEDISK option is enabled 2 the format and width of byte fields varies dep
40. ed report FDREPORT also allows for other forms of output to be created This is controlled with the RPT YPE parameter on either a DEFAULT or a PRINT command The RPTYPE settings that are available for selection are as follows RPTYPE GENERATE This is the default and hence rarely coded It causes FDREPORT to generate the report as specified by the REPORT FIELDS and other formatting statements RPTYPE NONE RPTYPE NONE causes the detail report to be suppressed Only the summaries are printed RPTYPE OSVTOC With this option the detail report of the selected datasets is printed showing the same information as shown on IEHLIST LISTVTOC although the layout is different RPTYPE TABLE This generates a report that is designed to be written to a dataset and later read by some other text processing program The XSELECT and REPORTFIELD statements are still honored but the report is written without page titles and column headings and with just a single space between columns RPTYPE ABRVTOC This produces a report in the same format as the PRINT VTOC command of the FDRABRP program one of the reporting utilities of ABR XSELECT statements are honored but REPORT FIELDS and other formatting statements are ignored RPTYPE ARCHIVE This option is intended for use when DATATYPE ARCHIVE is also specified and results in the report being generated in the same format as the PRINT ARCHIVE command of FDRABRP As above XSELECT statements are honored but R
41. ems such as VTOCs nearing 100 See the separate FDRVIEWS Concepts amp Facilities Guide for more details Any comments or suggestions regarding this guide can be directed to support fdrinnovation com And don t forget to visit our website for additional and up to date information on all Innovation products www innovationdp fdr com Copyright 2010 Innovation Data Processing Fundam FDREPORT FUNDAMENTALS 1 1 The Importance of DASD Management Reporting Ideally every computer installation will actively monitor its DASD usage to ensure that their DASD Management policy is being correctly implemented and that expensive DASD space is being used effectively A reporting tool is essential to help obtain this information However because all installations are different there is no single approach to DASD Management and thus no single set of reports that is universally correct and applicable In practice the variety between different installations DASD Management policies is a result of many factors including the size and history of the installation the way it has grown and the needs of its user community DASD Management policy is implemented in the number and type of the DASD devices which are installed by a large variety of local standards and by the way space is allocated to users either by a volume ownership or a pooling scheme This will be mirrored by the diverse range of reports that need to be run b
42. ending on the value of the BY TEFORMAT operand and the FATDISK option and whether the LARGEDISK option is enabled this field supports selection via a mask see the VOL operand in Section 54 13 10 10 10 EE OO O O O O OI O O O BAS BAS BAS BAS BAS BAS BAS BAS BAS BAS BAS AS C APPENDIX FDREPORT HSM REPORTING HSM REPORTING FDREPORT customers who are also using IBM s DFSMShsm DASD management system or its older version DFHSM can use FDREPORT to read the database files created by HSM and report on their contents The HSM datasets supported by FDREPORT are MCDS information on migrated datasets BCDS information on backups of current datasets This allows you to use all the power and flexibility of FDREPORT to generate reports about the data that HSM is managing With the exception of HSMCECSZ HSMIGVOL and NTMIGRAT there are no new field names defined when reporting from HSM data Instead data fields from the HSM records and calculated values are mapped into standard FDREPORT field names For DATATYPE MCDS the MCDS dataset record is described by the IBM MCD macro and the mapping is uk Ducem vox We Satie 0000 PS pevweg DskDeWeye eg 8990 migration leve __ DassmeeOrsion abdaed _ 00 Expiration calculated umavs Days since Last Reference aud 00 awe ays since Migration calculate
43. eports have been created so that they can be run with a minimum of change they usually only require the addition of an appropriate job card All of the reports default to reporting against all ONLINE DASD volumes However because they are constructed using standard FDREPORT control statements and JCL they can easily be tailored to provide more specific or targeted reporting if required When run as a complete suite the HCHECKx reports really can give your installed DASD oystem a complete and very thorough Health Check FDREPORT FUNDAMENTALS The following lists give you an idea of the types of reports produced by the HCHECKx jobs See section 54 02 in the FDREPORT manual for complete information on all the Health Check reports HCHECK1 DASD With Potential Problems e Disk Volumes More Than 8096 Full e IBM Fragmentation Index Worst First e Volume Mount amp Use Status e SMS VTOCIX Status e VTOC VVDS VTOCIXs More Than 80 Full e VVDS in Multiple Extends e VTOCs VVDSs With Logical Errors HCHECK4 Reports For Capacity Analyst Disks With Potential Wasted Space Total Space Available allocated and used e Overallocation In All Datasets e Datasets Not Referenced in 60 Days e Datasets With Inefficient Blocksizes HCHECK7 Datasets That Offend Standards e Uncataloged Datasets e Wrongly Cataloged Datasets e Datasets With Undefined DSORG e Empty PS PO VSAM Datasets e Unmove
44. et of ISPF panels is supplied with ABR and it includes a reporting option panel A 1 Option 6 on the reporting panel permits a TSO user to enter the name of a canned report much like the REPORT parameter in the examples above The FDRLIB library defaults to an installation determined library name and FDREPORT output is displayed on the screen Any dataset name or groupname parameters and any volume or volume group parameters that are specified in other fields on the reporting panel are used as additional XSELECT statements to the FDREPORT execution Panels FDREPORT SRS PANELS FDRViEWS is a separate cost option which builds on the foundation of FDREPORT and SRS to provide a user friendly question and answer method of generating reports It offers a Windows GUI interface through which reports can be viewed in various graphical formats graphs charts etc or as an Excel spreadsheet See the separate FDRVIEWS Concepts amp Facilities Guide for more details 3 1 Introduction To S R S In section 2 7 we mentioned the basic ISPF panels that allow end users to run canned reports We are now going to take a look at a much more powerful amp flexible way of running FDREPORT in TSO foreground the Search Reporting and Services dialog or SRS for short The SRS panels permit a menu driven execution of FDREPORT and enable the end user to exploit the same wide range of selection criteria as a batch driven FDREPORT Data ca
45. ex and VVDS DESCRIPTION ATTR SOURCE VLMOUSTA Volume Mount Status CHAR UCB RESERVED Volume Dismountable RESIDENT Volume Non Dismountable VLUSEATR Volume Use Attribute 7 CHAR UCB PRIVATE Allocated if specific PUBLIC Temporary non specific STORAGE Non temporary non specific Volume SMS State 7 CHAR VTO INITIAL Volume Initialized for SMS MANAGED Volume SMS Managed NONE No SMS Processing Volume SMS Status 12 CHAR SMS DISABLED ALL DISABLED NEW ENABLED NONE QUIESCED ALL QUIESCED NEW visMssTG Volume SMS Storage Group name fa fonan SM VLSMSHTR sus VESMSLTR 5 VLOPENDC Uca VLLRGCYL Ea VLLRGTEK SPC VLLRGBYT SPC VLUSERS Number of Current Allocations to Volume UCB VLVTIXTR Number of Tracks Allocated to the VTOC Index VTOC lt VLSMSTAT SUEEEEEEEEE E EE E RU E ae RR RR LS SERERE E Ek s MM RR RR EEEE VLSMSVST VLVTOCTR OG VLVVDSTR VLVVDSXT me VLABRGEN MODE VLABRCYC MODE VLABRHTR MODE VLABRLTR MODE VLABRINT Initialized for ABR Processing YES or NO VTOC VLABROPT ABR Volume Processing Options 7 CHAR MODL C Cycle Table is Active N Never Archive from this Volume S Scratch Permitted T ABR Thresholds are Enabled X Copy 1 Expiration Date from RETPD Y Copy 2 Expiration Date from RETPD Instant Backup Attempted zero Volume Not Initialized for ABR Continued APPENDIX TABLE 8 lists the FIELDs that can be obtained from the volume level
46. for FDRPAS FDRMOVE planning e Reports for the IAM Administrator ADVANCED FDREPORT 2 1 Accessing Other Sources Of Information As discussed earlier FDREPORT is capable of obtaining information from many sources in addition to its default of initially scanning disk VTOCs The user can determine the source of the data by coding a DATATYPE parameter on either a DEFAULT or a PRINT control statement The DATATYPE settings that are available for selection are as follows DATATYPE VTOC This is the default and it tells FDREPORT to initially scan the contents of VTOCs of the disks selected by either DISKx DD s the VOL VOLG parameters coded on XSELECT statements or all the online volumes if ENABLE ONLINE has been coded on a DEFAULT or PRINT statement For datasets found in these VTOCs FDREPORT will then refer to BCS catalog or VVDS as required to process the XSELECT REPORT and SORT statements With this selection a of the report fields in Tables 1 7 in the Appendix are available and the fields from Table 4 that refer to the ABR Incremental Backup system DATATYPE CATALOG With this setting FDREPORT will scan the system catalogs for dataset entries that match the selection criteria Only the information which is in the catalog entry itself is available principally the dataset name the OWNER the volume serial and the device type DATATYPE CATVTOC This option extends DATATYPE CATALOG by making the same initial scan of t
47. he FDRViEWS Concepts amp Facilities Guide for more details FDRViEWS CONCEPTS amp FACILITIES GUIDE Letter 3 FDREPORT SRS PANELS This Page Intentionally Left Blank APPENDIX The following tables show the fields that can be used by FDREPORT and their primary source of information See section 54 31 in the FDR User Manual for full details and a description of how each of these fields can be used for the various FDREPORT functions such as Selection Sorting Summarizing and Punching Note Some of the values in the Len column are blank because the lengths of these fields e g dates byte etc can be tailored by optional FDREPORT formatting Parameters TABLE 1 lists the FIELDs available from the dataset s DSCB in the VTOC If a VSAM cluster is being reported some of the information may be found in the VVDS or catalog SOURCE VTOC VVDS VTOC VTOC VTOC DESCRIPTION LEN ATTR SN Dataset Name VSAM Component Name CHAR SPLDSN Dataset Name on Two Lines CHAR SDSN Dataset Name First 20 bytes only CHAR Two Lines First 20 bytes only GDGBASE EAR SPLGDGB GDG Base Name on Two Lines CHAR SGDGBASE GDG Base Name First 20 bytes only CHAR VTOC VVDS VTOC VVDS CAT CAT CAT DEFAULTS Includes 9 MIX SPLDSN VO DSORG RECFM BLKSIZE LRECL SIZE SIZEFREE Y FREE DSSN Volume Serial Stored in DSCB 6 VTOC TVTC vois NUM DATES Includes
48. he system catalogs but then extracting additional information from the VTOCs and VVDSs DATATYPE ARCHIVE ABR users who have implemented an Archiving Migration system or who are using Application Backup can run reports against the control files used in these systems by using DATATYPE ARCHIVE This parameter allows the user to create reports by using the fields in Table 4 in the Appendix as well as some fields from Tables 1 and 5 that are saved in the control files e the disk volser and the datasets DSORG BLKSIZE LRECL SIZE and SIZEFREE Note Although ABR incorporates its own utility for reporting information about these datasets program FDRABRP FDREPORT has greater flexibility in selection and report layout ADVANCED FDREPORT DATATYPE CATARCH ABR users can use this option to select datasets via the catalog like DATATYPE CATALOG but then obtain additional information on those datasets from the ABR Archive Control File This option can be useful for cross checking the information held by the ABR Archiving system against the MIGRAT catalog entries for datasets which have been archived migrated by ABR and are available for auto recall DATATYPE EXTRACT This option allows FDREPORT to obtain its information from an Extract File which has previously been created via RPTYPE DATA For more information on creating and using Extract files see Section 2 5 later DATATYPE VOLDATA All of the previous settings of DATATYPE
49. ibility that datasets will be created that are outside the scope and capabilities of the established rules It is very likely that such exceptional datasets will be allocated on inappropriate DASD volumes or with incorrect attributes To detect these problems and to allow them to be corrected it is essential to use a reporting system on a reactive basis So in summary all levels of staff need to be able to obtain information related to DASD usage from Managers and Capacity Planners to DASD Management personnel Performance Specialists Systems Programmers Disaster Recovery planners and pooling or SMS Administrators FDREPORT is just the tool they need to achieve this 1 3 FDREPORT Introduction FDREPORT is an extremely powerful and flexible DASD Management report generator It is designed to enable users to create their own customized DASD Management reports Unlike other reporting programs FDREPORT collects the raw data from the various sources and it also then performs the actual report generation FDREPORT is capable of displaying almost any field from the VTOC VVDS and Catalog and using these fields as the basis for the report selection criteria Users of Innovation s DASD Management system can utilize FDREPORT to access and report on information contained in the ABR control files DFHSM users can benefit from the same power and flexibility by accessing and reporting on information stored in the MCDS and BCDS con
50. ifferent report definitions that can then be run by end users without requiring them to have any special training in FDREPORT The EXECUTE statement has only two parameters EXECUTE REPORT reportname FDRLIB libraryddname The reportname is the name of a member within a library which is named on a DD statement pointed to by FDRLIB libraryname defaults to FDRLIB The member can contain any FDREPORT control statements As an example an SMS administrator could easily obtain a report of datasets that are ineligible for SMS conversion sorted by dataset name simply by specifying EXECUTE REPORT NOTSMS The NOTSMS member in the library pointed to by the FDRLIB DD would contain all the FDREPORT statements required to locate the ineligible datasets and print the sorted list XSELECT CATALOG NO VOLG PROD XSELECT CATALOG ERR VOLG PROD XSELECT DSORG U VOLG PROD REPORT FIELD DSN VOL LRDATE SORT FIELD DSN SEQUENCE A PRINT The EXECUTE statement can be preceded by XSELECT statements allowing for the flexible selection of datasets but in a fixed and pre determined report format XSELECT CATALOG NO VOLG PROD SELECT CATALOG ERR VOLG PROD XSELECT DSORG U VOLG PROD EXECUTE REPORT NOTSMS In this case the NOTSMS member would only contain REPORT FIELD DSN VOL LRDATE SORT FIELD DSN SEQUENCE A PRINT As well as simplifying FDREPORT control statements and JCL this facility can also be used to run reports in TSO foreground A s
51. it 2009 T56 MiGRAT gt DUME SD Sh 20097254 DHV ONN Rro OT BE AON Pro dies 250010 Esc BIDS ZU DS 2 EIS RS 11 AOMORI ZA MIGRAT On the far left hand side of the panel you will see that there is a COMMAND field just like a normal ISPF display This command field can be used to invoke a variety of functions for one or more of the datasets that are being displayed on the dataset list These commands include e SRS services such as I Info M Member List FDR ABR services such as REORG RECALL COPY Normal ISPF functions like Edit and Browse e TSO commands including DELETE LISTDS LISTCAT and RENAME CLISTs and REXX execs These commands can all be used in the left hand command column S amp DATASET Lion COMMAND gt SCROLL gt PAGE COMMAND DATASET NAME CRDATE VOLSER RESALE DREPORT 2008 036 MVS OOI RECALL EIN MG 2008 234 MIGRAT T DES OULD EIE 2009 010 DEMORO REORG RS VSAM 2009 156 MVS023 BACKUP DUMP DSN 2009 2 52 DEVONS JID IEE OTHER Eline 200933 15 npo RESO EESTCAT RTS OTHER VSAM 2910 003 DEW OZ RECALL RTS PDSE DSN MIGRAT FDREPORT SRS PANELS 3 3 Volume Reporting The other category of information available via SRS is volume data and is equivalent to a DATATYPE VOLDATA report in a batch execution of FDREPORT To create volume data reports under SRS the user g
52. lexibility it follows that users will code a number of control statements and parameters to define what the report should contain and what its layout should be The remainder of this Concepts and Facilities Guide describes how FDREPORT is used and highlights some of its key features Sample control statements are shown to illustrate how the reports can be generated and some of the sections of this Guide also show sample report output Since users can fully control their own report contents and layout the samples should not be regarded as exactly representing the reports that are generated in practice Important This Guide is not intended to be a complete description of FDREPORT For full details users should refer to the FDR user manual Section 54 1 4 Sources of Information and Types of Output As outlined in the preceding section FDREPORT obtains information from DSCBs in DASD VTOCs from BCS User Catalogs and from VVDS datasets In addition it can also generate extra information such as FREE figures which may not be directly available in the above locations but can be derived or calculated FDREPORT can also obtain PDS directory information volume related information and information from the ABR Incremental Backup and Archive recording mechanisms and from DFHSM s MCDS and BCDS control datasets FDREPORT FUNDAMENTALS Details of approximately 250 fieldnames that FDREPORT uses and the data entities to which they refer are sh
53. mandatory PRINT causes the actual data collection and report generation to proceed as controlled by all preceding control statements For this reason PRINT is usually the last control statement coded So to continue building our ineligible SMS datasets report example let s assume that the user wants to print 50 lines per page left align the title but not print a timestamp on the report XSELECT CATALOG NO VOLG PROD XSELECT CATALOG ERR VOLG PROD XSELECT DSORG U VOLG PROD XSELECT DSORG AM DSORG7 EF VOLG PROD REPORT FIELD DSN VOL LRDATE PRINT LINECNT 50 TITLE LEFT TIMESTAMP NO 1 9 Sorting The Listing We ve already seen how the XSELECT and REPORT FIELD control statements are the ones that control most of FDREPORT s processing However some additional statements are required to add some extra features and to fully customize the report output The SORT control statement is probably the most useful of these allowing the report output to be sorted in whichever order is required Taking the example report from the end of section 1 7 let s suppose that the user now wishes to ensure that the most recently referenced datasets are listed first This is done by asking for the report to be sorted in descending order SEQUENCE D of the LRDATE XSELECT XDSN CRITICAL VOLG PROD1 LRDAYS lt 4 REPORT FIELD DSN CRDATE LRDATE SORT FIELD LRDATE SEQUENCE D PRINT FDREPORT FUNDAMENTALS Taking another earlier example thi
54. n be extracted from the same sources and the user has the same control over the layout of the report the data that is displayed and the sort order A report containing the selected datasets and the desired information is immediately presented to the user as a Dataset List panel rather than being printed as in the case with a standard batch driven report The Dataset List panel contains a command field allowing TSO commands such as EDIT or BROWSE Clists or ABR backup restore commands to be entered amp executed The SRS user can save his selection criteria and re use them later The Dataset List can also be saved and re displayed as well as being printed As an alternative to obtaining dataset information SRS can also use the volume related criteria that we looked at in section 2 2 DATAYPE VOLDATA to display information in a Volume List Again the user can determine the information that is to be displayed in the list together with the eventual layout of the list and the order of entries contained within it It is not possible in a document such as this to present SRS in any great detail or to show many samples of the panels that can be used However although a comprehensive description can be found in sections 54 50 to 54 60 of the product manual we will now attempt to give you a brief introduction to its power and flexibility ke MCDS BCDS SELECT FDREPORT
55. ntrol file otherwise it is from the ABR backup subsystem If COPY or OLDBACKUP was specified there may be more than one line of this information available REPORT will list them on multiple lines SELECT XSELECT will test against all copies of the fields TVTOCDSN Backup DSN for RPTYPE TVTOC CHAR GEN OLDBKUP ABR Old Backup of ABR Backup Displayed GEN BKCYCLE Cycle of ABR Backup Displayed VTOC CAT BKGEN Generation of ABR Backup Displayed VTOC CAT BKDATE Backup Date ARCH CAT BKDAYS Days Since Backup GEN BKEXDATE _ Backup or Archive Expiration Date ARCH CAT G DESCRIPTION ATTR SOURCE 4 BKEXDAYS _ Days Until Expiration of Backup or Archive GEN BKFILENO File Seq Number of Backup or Archive ARCH CAT ive This is the Last Index Level in the Name BKTAPCNT GEN BKVOL ARCH AI BKXVOL 139 BKDEVCLS BKDEVTYP GEN BKDSNS GEN ENCRDEF Includes ENCRPROF ENCRDATE ENCRFLGS ENCRTYPE ENCRBVOL ENCRBDSN ENCRBDAY EHE ENCRBDSN ERE ENCRBVOL Original First Backup Volume CHAR CRYP ENCRDATE _ Backup Date yyyyddd CRYP ENCRFLGS _ Encryption Flag Byte CHAR CRYP MASTERKEYAPPLIED Master Key Used DELETE Record Marked for Deletion FDRCAMS Encrypted by FDRCAMS m feel en ee lt gt m GENERATEDKEY Key was Generated PUBLICKEYAPPLIED Public Key Used TAPEFILE Backup File Resides on Tape UPSTREAM Created with
56. nts The following example prints a disaster recovery report and then an ineligible SMS datasets report in one execution of FDREPORT Notice the presence of the CANCEL command between the two reports This cancels all of the previous FDREPORT statements TITLE LINE DISASTER RECOVERY PROJECT RECENTLY USED DATASETS HEADING LINE 1 DATASET CREATION DATE WHEN USED LAST XSELECT XDSN CRITICAL VOLG PROD1 LRDAYS 4 REPORT FIELD DSN CRDATE LRDATE SORT FIELD LRDATE SEQUENCE D PRINT CANCEL TITLE LINE SMS PROJECT SUMMARY OF INELIGIBLE DATASETS HEADING LINE 1 ODD DATASET RESIDES LAST USED ON HEADING LINE 2 XSELECT CATALOG NO VOLG PROD XSELECT CATALOG ERR VOLG PROD XSELECT DSORG U VOLG PROD XSELECT DSORG AM DSORG EF VOLG PROD REPORT FIELD DSN VOL SP6 LRDATE SORT FIELD CRDATE SEQUENCE A PRINT LINECNT 50 SUM INDEX TITLE LEFT TIMESTAMP NO When running several reports that use the same source of information and which select the same datasets it is better to reduce the overheads by creating and using an Extract File ADVANCED FDREPORT Let s suppose that an SMS administrator wishes to isolate some critical uncataloged datasets from volumes beginning PROD1 He wants to list them by dataset name showing the volume they reside on and sorting them by dataset name However he also then wants to list them again but this time
57. oes to the SRS Volume Selection Panel which is a multi screen menu containing volser and other volume selection field names from Table 8 in the Appendix As before the user can insert selection criteria and report layout and sorting parameters in the various Volume Selection panel fields The following example reports on all volumes in SMS storage group GENERAL that have a volser starting PROD The report will show the disk volser the percentage of free space on the volume and the percentage of free space within the VTOC The report will be sorted so that volumes with most freespace appear first S DATASET SELECTION 5 COMMAND gt SCROLL gt FIELD SELECTION VALUE REPORT SORT NER AO TRES ER SUISSE NETS IDE EID YA STORGRP MO MO V VLSFTRKS VLSUTRKS VLSFDSCB VLSUDSCB VLSFINDX VLSUINDX MISERERI VLALOTRK VVVVVV VV The resulting report will look like the one below Clearly the three volumes at the top of the report are very under allocated and represent a potential waste of disk space Another volume PROD21 is only about half full but it has very limited free space remaining in the VTOC It will soon be impossible to allocate new datasets on this volume even though there are ample free tracks cene Roo DATASET SELECTION COMMAND gt SCROLL gt PAGE COMMAND VOLSER SETERS 6FDSCB PROD42 SS 80 PRODS3 gal 67
58. olume RELCIADDR Relative Cl Addressing IMBD Imbedded CH DSNEIFLG VSAM Dataset Extended Info Flag CHAR VVDS G Extended Addressability gt 4GB R Relative Cl Addressing CH IXD Indexed AMDATTR VSAM Cluster Attributes from AMDSB AR VVDS IAM ESDS ES IMBED IM KEYRANGE KE KSDS KS ORDERED OR RRDS RR REPLICATE RE SPANNED SP WRITECHECK WR KRNG Keyrange AMDATTR3 VSAM Cluster Attributes from AMDSB CHAR VVDS IAM LINEAR LI LOADED LO NONUNIQUE NO SHRBCS SH Shared Catalog VARIABLE VA Variable RRDS NIXD Non Indexed NUMD Relative ORD Ordered AIXATTR Attribute of Alternate Index 7 CHAR VVDS IAM AIX This is an AIX UPGRADE AIX with UPGRADE Attribute E LLL Lees doom ROS seres LI eon qp Continued APPENDIX TABLE 2 lists the FIELDs available from the VVDS or ICF catalog for ICF VSAM clusters This is in addition to the FIELDs available from the VTOC TABLE 1 For non VSAM datasets these fields will contain blanks Those fields that show a source of IAM are also valid for IAM files those that show IAM are valid only for enhanced IAM files NAME DESCRIPTION LEN source ATTR1 Attribute Byte One 24 CHAR VVDS CAT ERASE Erase when Deleted INHIBIT Access for Read Only RECOVERY Control Areas Preformatted REUSEABLE Can be Reopened as New SPEED Control Areas Not Preformatted TEMPEXPORT Portable Copy Has Been Made TRACKOVER Track Overflow UNIQ
59. on incorrect volumes e Any datasets which do not conform to installation standards f freespace on DASD is badly fragmented Detail reports are also helpful to Performance Analysts Since the configuration and I O loading of the DASD subsystem has a fundamental effect on the overall system performance Performance Analysts need to be aware of DASD contents and their usage It is sometimes necessary to move data around to balance DASD 1 0 loads and Channel Utilization and a good reporting tool makes this task much simpler At another level detail reports can also be used by systems programming or support staff to monitor the overall health of the DASD subsystem Running appropriate reports at regular intervals can help to detect volumes or sensitive datasets such as VTOCs VVDSs and VTOC Indexes which are becoming dangerously full or which require corrective action FDREPORT FUNDAMENTALS 1 2 Pooling Systems The need for a good DASD Management Reporting System is magnified when a DASD Pooling mechanism is being used Pooling is implemented either by simple UNITNAME specification or more comprehensively by DFSMS and other OEM allocation control packages Pooling has two main effects that are significant Firstly it eliminates the practice of volume ownership where typically one or more disks are given to a project team for their exclusive use This traditional volume ownership can result in DASD space being used ineffi
60. oth on a regular basis to monitor space usage and for ad hoc problem solving For these reasons the report generators employed must be flexible and easy to use but also provide comprehensive and accurate information With these needs in mind reports might be described as falling into two categories summary and detail as follows Summary reports would be used by Management such as Data Processing Managers and by Capacity Planners who would need to see overall figures to help them evaluate and predict growth trends With these summary reports it should be possible to predict the effect of changes in DASD requirements caused by alterations in the DASD Management policy or in the general increase or decrease of DASD space usage i e new applications being introduced or removed The outcome of using a good DASD Management Reporting Program is that DASD usage can be made as efficient as possible Purchases of new DASD can be closely matched to requirements not lagging behind or leading them Purchasing new DASD too early can be a mistake and prove to be very expensive Purchasing new DASD too late can be very disruptive Detail reports can be used by a wider range of staff from end users to Management to confirm that the DASD Management policy is being correctly implemented on an individual volume or dataset basis For example detail reports can show e Whether space is being wasted in over allocated datasets e f datasets
61. other Volume ONL Only Cataloged Not in VTOC UNK Error Reading Catalog CAN Cataloged to Candidate Volume DRF Disk Read Failure C AT CATTTR DSCBTTR from Catalog used by ABR to indicate HEX AT A X X auto recall 6 NM E X X AT A X X CATVOL Volume Where the Dataset is Cataloged CHAR CATVOLCT Number of Unique Non Candidate Volumes 3 NUM C Where the Dataset is Cataloged E HEO I E E E ERG GE S B NC MU Continued APPENDIX TABLE 5 lists the FIELDs that can be generated by ABR from information contained in the VTOC Catalog or the VVDS DESCRIPTION E ATTR SOURC CANDVOLC Number of Unique Candidate Volumes where 3 NUM the Dataset is Cataloged CATVOLTL Total Number of Unique Volumes where the NUM Dataset is Cataloged DSNALCNT Number of Catalog Aliases for this Dataset CAT DSNALIAS An Alias for This Dataset indexed by RELALCNT 44 CHAR CAT RELALCNT Relative Alias Number CAT GDGENTRY GDG Active Entry Count CAT GDGFLAGS GDG Base Flags CHAR CAT EMPTY NOEMPTY vTOC GEN Tc GEN GEN GEN GEN NOEXTENT GEN CAT CAT SCRATCH NOSCRATCH GDGGENER GDGLIMIT GDGRELGN GDGVERSN GDGLADAT Last Altered Date GDGBASE only yyddd GDGLADAY CRDAYS EXPDAYS LRDAYS iN PROTECT Reports on Type of Protection Indicates if RACF 4 CHAR VTOC or PASSWORD Protected RUNDATE Date of FDREPORT Execution 3 GEN RUNTIME Time of FDREPORT Execution hh
62. own in the Appendix of this guide and in section 54 31 of the FDREPORT manual These fieldnames represent entities that can be displayed most of which can also be used as selection or exclusion criteria By default FDREPORT first scans disk VI OCs to obtain dataset records It then obtains additional information from VVDSs and Catalogs for datasets found in the VTOCs As an alternative users can direct FDREPORT to e Extract dataset records directly from the catalog Extract dataset records from the catalog then get additional information from disk VTOCs e Extract dataset records from the catalog then get additional information from the ABR Archive Control File Extract dataset records directly from the ABR Archive Control File e Extract volume related information e Extract information from the DFHSM MCDS and or BCDS control datasets Use dataset records already collected and accumulated in an Extract File This Guide will primarily deal with the default operation but some of the alternative sources of information will also be discussed in later sections T Jm cu VTOC VTOCIX BCDS SELECT FDREPORT Displayed Reports Printed Reports Job Streams The above diagram summarizes the main FDREPORT facilities Once extracted the data can then be sorted and formatted for several types of output e Printed as a normal report e Formatted for display on screen
63. pe MCDS BCDS 23 24 OInDISFTIFOFms or UO 24 2 5 Using Extract Files to Generate Multiple 25 ee E 26 2 7 Using Pre Defined 28 PART THREE FDREPORT SRS Panels 29 Set MUO GUC ONTO UT UT 30 SEZEBI ii Mero mil R o E ETT 31 VOUM REDOUN TTE 33 mi C 34 auccm anam MEUM MEIN MTM EM 35 PART FOUR Append eenritissckrs 37 INTRODUCTION For more than 35 years Innovation Data Processing has been producing high quality Storage Management Software During this time its products have evolved into today s high speed safe reliable storage management solutions for z OS and non z OS data It started with the FDR Storage Management Family for which thousands of licenses have now been sold worldwide The FDR Family is the complete Storage Management solution for z OS e FDR has become the industry standard for fast reliable backups of z OS data while ABR adds a layer of automation to provide advanced backup facilities like Incremental Backup Application Backup and Archiving FDRINSTANT provides near 24x7 backup of offline volumes created by DASD Subsystem features like Oracle Sn
64. record Data is gathered and summarized from the LSPACE SVC VTOC VTOC index and VVDS NAME DESCRIPTION ATTR SOURCE VLCCA Channel Connect Address Zur VLCTLMDL DASD Controller Model Number Mensa tev ge P AS _ VLDCEACT Device Characteristics Active Features CCC Extended Remote Copy CFW Cache Fast Write DCA Dual Copy Active DFW DASD Fast Write TKC Track Caching Device Characteristics Flag 2 CHAR CSW Compare Swap Bit DPX Duplex Device PKC Pack Change in Process PHI Primary Duplex Device PVM Non Full Pack VM Minidisk SEC Secondary Duplex Device SHR Device Sysgen d Shared SSV Subsystem is Valid Device Characteristics Flag 8 CHAR CYMG Cylinder Managed Space Exists F8F9 Format 8 amp Format 9 can Exist ELLE LR oor E E 8 VLIDLBYT Idle Waste Bytes 15 NUM VTOC A VLIDLTRK _ Idle Waste Tracks MRAR eJ NEMPE p 3T d Ured Ta DVLCMABYT Jr ou Managed rice Bye INIM ENS d 0 E RUNE UU RU RR UN VLCMNFXT Cylinder Managed Number of Free Extents ILLE J 7enrmox isis 1 sees Ce K
65. rowser htt p idpukpco050 views html Windows Internet Explorer GEO E Peto iid c0080 views ond 4211 dk Favortes Took 2 Eo door Tos FORViews tegof Chicago All Reports Date s and Time s of Report Report Sections a Fragmentation Index Usage For EUO9 volumes 2009 a Tables Poteehoal Wasted Space For EUO9 volumes Grouped Volume Usage Grouped Dy Volume Usage Range Volumes GT S0 Freespace For EU09 volumes 3 SMS To Volume X Ref Sorted By Volume Usage SSID To Volume FDREPORT SRS PANELS 3 5 Summary The FDREPORT product enables a huge range of DASD Management reports to be generated for use by e End Users e DASD Administrators e Disaster Recovery Planners e Capacity Planners e MIS Managers It provides technical reports that describe e The current status of data on DASD e The current status of the DASD themselves Free format reports e Are easy to produce e Provide customized reports e Meet exact user needs e Can be run as batch reports or under TSO via SRS The FDREPORT report generator e Ensures DASD is used efficiently e Minimizes waste e s Simple Powerful And Comprehensive The separately licensed FDRVIEWS product builds on the foundation of FDREPORT to provide e Windows GUI interface Reports in various graphical formats Alerts Report Distribution See t
66. s time the datasets ineligible for SMS report the following alteration will sort the report into dataset name order XSELECT CATALOG NO VOLG PROD XSELECT CATALOG ERR VOLG PROD XSELECT DSORG U VOLG PROD XSELECT DSORG AM DSORG7 EF VOLG PROD REPORT FIELD DSN VOL LRDATE SORT FIELD DSN SEQUENCE A PRINT This could produce DATA VOLSER EXISTING UNCAT DATA PRODXX RECENT WRONG CAT DS PRODCI Ag Lore T gt UNMOVEABLE FILE PRODTS NOG VERY OLD DATASET PRODOL 2008 100 The SORT control statement has another parameter BREAK with which a user can request the insertion of Control Breaks This parameter also specifies what action occurs at the control break such as a page eject a one line space or the printing of summary subtotals The control break occurs whenever the data in the corresponding SORT FIELD changes As an example suppose a user wishes to list all datasets on a particular volume sorted by DSORG and dataset name with control breaks inserted to separate the different DSORGs In this case the control break just consists of one blank line as controlled by the BREAK SP parameter XSELECT VOL IDPV50 REPORT FIELDS DSORG DSN SIZE SORT FIELDS DSORG SEQUENCE A BREAK SP PRINT This could produce pons pos 212E EF VSAM DATASET1 100 EF VSAM DATASET2 200 es PROD PAYROCG GOOT 20 IS PROD PAYROLL G0O06 30 IES ALPHA PARTS 15 is ZERO INVOICE REPL 60
67. servers and workstations Backups are transmitted across a network connection to disk or tape on the z OS host FDR UPSTREAM Linux on System z offers a high performance solution for backing up your Linux on System z clients e Ifthe Open Systems data is resident on an EMC Symmetrix DMX or V Max with Enterprise Storage Platform ESP FDRSOS and FDR UPSTREAM SOS provide additional performance enhancements to the backup and restore process by utilizing high speed mainframe channels e UPSTREAM Reservoir is designed for those users who wish to take advantage of the many strengths provided by FDR UPSTREAM but would prefer to use an Open Systems environment e g Windows AIX Linux SUN Solaris for hosting the backup management engine FDRERASE OPEN completes the Innovation product range FDRERASE OPEN is an EAL2 certified product that can quickly and easily erase any disk attached to an Intel x86 or compatible system attached via a SCSI SATA SAS FIBRE or an IDE ATA or USB connection The data on these disks may have been created by any one of a range of operating systems including Windows UNIX Linux Solaris and NetWare Multiple levels of erasure are available as well as PRINT and VERIFY options to check that the data has been successfully erased INTRODUCTION Each of the Innovation products are described in a range of Concepts amp Facilities Guides In this particular guide we take a look at FDREPORT FDREPORT is a
68. showing the dataset organization and sorted by creation date XSELECT XDSN CRITICAL VOLG PROD1 CATALOG NO PRINT RPTYPE DATA to create the Extract File REPORT FIELD DSN VOL SORT FIELD DSN SEQUENCE A PRINT DATATYPE EXTRACT lt to use the Extract File REPORT FIELD DSN DSORG CRDATE SORT FIELD CRDATE SEQUENCE A PRINT DATATYPE EXTRACT lt lo use the Extract File again FDREPORT RPTYPE DATA Extract File FDREPORT DATAT YPE EXTRACT 2 6 Punch Output Another extremely useful feature in FDREPORT is the ability to create card images as output instead of a printed report These card images can contain a mixture of fixed text amp data extracted from report fields There are numerous potential uses for this including the generation of simple control statements for later processing by other utilities or the creation of complete JCL streams In this next example a user wants to catalog all of his currently non cataloged datasets He will run FDREPORT to find these uncataloged datasets using CATALOG NO and then instead of producing a report he will use the Punch feature to automatically generate the IDCAMS DEFINE NONVSAM control statements required to catalog them In his FDREPORT JCL he will code a SYSPUNCH to point to a Punch dataset where the card images will be written SYSPUNCH DD DSN punch output DISP CATLO Y SPACE TRK 5 UNIT SYSALLDA His control statements would then be as follows RPTYPE SELPCH ins
69. tput DISP CATLG SPACE TRK 5 UNIT SYSALLDA FDRLIB DD DSN punch masks file DISP SHR SYSIN DD XSELECT CATALOG NO VOLG DEV REPORT FIELD DSN VOL DEVTYPE PUNCH MASK MASK1 ECHO PRINT RPTYPE SELPCH In our next example a user wants to create the IDCAMS JCL to delete some old VSAM files ff I EXEC PGM FDREPORT REGION 0M 4S Y SPRANT DD SYSOUT x SYSOUT A INTRDR FDRLIB DD DSN USER1 FDREPORT DISP SHR SYSIN DD XSELECT XDSNZOLDFILES PUNCH MASK IDCDEL ECHO PRINT DATATYPE CATALOG RPTYPE SELPCH The IDCDEL member in the USER1 FDREPORT library would contain the following statements which would produce one occurrence of the lines between the PREFIX and ENDPREFIX commands and then one DELETE PURGE line for each selected dataset thus creating a single IDCAMS job to do all the deletes PREFIX IDELETE JOB ACCT CLASS M MSGCLASS xX FT DELETE EXEC PGM IDCAMS ENT DD SYSOUT x ENDPREF X DELETE lt NAME gt PURGE ADVANCED FDREPORT 2 Using Pre Defined Reports Another advanced function of FDREPORT is the ability to allow users to generate comprehensive reports by specifying only one control statement This is done using the EXECUTE statement which causes FDREPORT to execute a set of control statements that have previously been created and then stored in a PDS member This facility allows DASD Administrators for example to set up a wide range of d
70. trol datasets FDREPORT also provides volume related information and can generate other information that is not directly available from any of the above sources FDREPORT FUNDAMENTALS In the report generation process users have the ability to control the report contents layout spacing control breaks and summaries With this wide range of information available and because of the control over report contents FDREPORT can generate an almost infinite variety of reports that meet the most demanding user requirements With this immense power and flexibility FOREPORT can do simple things like provide basic information on selected datasets or clusters Alternatively it can be used for more complex tasks such as isolating certain datasets that do not conform to standards or for Disaster Recovery planning Here are just a few examples of the kinds of report that can be generated with FDREPORT A list of datasets with a given prefix Alist of TSO LIST datasets e VSAM datasets on selected volumes e Poorly blocked datasets e Datasets backed up or migrated by DFHSM e PDSs that are full e Poorly organized VSAM clusters e Datasets likely to suffer Sx37 abends e Multi Volume datasets e Dataset SMS information e Datasets ineligible for SMS e DASD volumes with a large amount of spare capacity e DASD volume Mount and SMS status e Wasted Space on volumes e DASD Volumes with potential VTOC or VVDS problems As FDREPORT has such f
71. trr RSVD1 Reserved Field offset 61 x 3D the format and width of date fields varies depending on the value of the DATEFORMAT operand 2 these fields will be two columns larger if the FATDISK option is enabled this field supports selection via a mask see the VOL operand in Section 54 13 the length of the DEFAULTS field is either 72 74 or 76 depending on whether FATDISK and LARGEDISK are both disabled 72 FATDISK is ENABLED LARGEDISK is DISABLED 74 or both are ENABLED 76 3 4 a APPENDIX TABLE 2 lists the FIELDs available from the VVDS or ICF catalog for ICF VSAM clusters This is in addition to the FIELDs available from the VTOC TABLE 1 For non VSAM datasets these fields will contain blanks Those fields that show a source of IAM are also valid for IAM files those that show IAM are valid only for enhanced IAM files DESCRIPTION ATTR SOURCE CLUSTER ICF VSAM Cluster Name 44 CHAR VTOC VVDS C SPLCLS ICF VSAM Cluster Name on Two VVDS SCLUSTER Cluster Name First 20 bytes only CHAR VVDS VSAMID Includes 62 CHAR VVDS CAT SPLCLS SPLDSN VOLSER VSAMINFO Includes DSORG RECFM MAXLRECL LRECL CISIZE TRKSCA CICA 5 HIUSERBA CISPLIT CASPLIT TIMES Includes 17 N CRTIME LRTIME MIX Includes 8 NUM UM CRTIME Time of Creation hh mm ss NUM VVDS IAM LRTIME Time of Last Reference hh mm ss 8 NUM VVDS IAM VSAMUSE RECORD
72. tructs FDREPORT to create Punch output instead of a normal report XSELECT CATALOG NO VOLG DEV REPORT FIELD DSN VOL DEVTYPE PRINT RPTYPE SELPCH ADVANCED FDREPORT By default card images for datasets selected would be written to SYSPUNCH in the format SELECT DSN datasetname VOL volser These statements could be used by ABR However the format can be altered using a Punch Mask Below we see a Punch Mask being used to create the DEF NVSAM statements our user requires to catalog his non cataloged datasets DEF NVSAM NAME lt DSN gt DEVICETYPE lt DEVTYPE gt VOLUMES lt VOL gt When the card images are written to SYSPUNCH the values between the chevrons lt and gt will be substituted with the FDREPORT supplied data If for example one of the uncataloged datasets was called UNCAT DSET and it resided on volume SCR999 which is 3390 then the following card image would be written to the Punch dataset DEF NVSAM NAME UNCAT DSET DEVICETYPE 3390 VOLUMES SCR999 Several hundred of the above control statements may have been created These statements can then be used as SYSIN to an IDCAMS job to actually perform the cataloging operation Punch Mask definitions can be stored as members in a PDS To use a Punch Mask the user simply has to code an FDRLIB DD in the JCL to point to the PDS and a PUNCH MASK statement in the FDREPORT control statements to select the actual Punch Mask member FISYSPUNCGCH DD DSN punch ou
73. umn can contain two fields placed one on top of the other on adjacent lines An earlier example showed the isolation of datasets on PROD volumes that were not eligible for SMS management For these datasets if the user wished to display the dataset names the volume they are on and the last reference date the full example becomes XSELECT CATALOG NO VOLG PROD XSELECT CATALOG ERR VOLG PROD XSELECT DSORG U VOLG PROD XSELECT DSORG AM DSORG7 EF VOLG PROD REPORT FIELD DSN VOL LRDATE The report produced would resemble DEIN VOLSER ERDA TE UNCAT DATASET PRODO1 Zu 1800 UNMOVEABLE DSET POLO 135 As another example consider the report that selected all datasets that are on Storage Group DBPROD and have Management Class LATEMIG Possibly the user might want to find out what Data Class they have XSELECT STORGRP DBPROD MGMTCLAS LATEMIG REPORT FIELD DSN DATACLAS Or possibly some small datasets have accidentally been assigned a Data Class of BIGFILES which should only apply to sequential files over 500 tracks The user needs to find out their secondary allocation and type their DSORG and the type of DASD they reside on XSELECT DATACLAS BIGFILES SIZE lt 500 REPORT FIELD DSN SECALLOC SECAFLAG DSORG DEVTYPE The above XSELECT statement selects datasets that have the Data Class of BIGFILES and which are less than 500 tracks in size The report from this would be as follows DSN SECAL SECAF DSO
74. z OS DASD Management reporting tool that reports from a variety of sources including VTOCS VVDSs Catalogs DFSMS and the control files belonging to ABR and DFSMShsm It produces customised reports on DASD related issues in detail and or summary format and in the form of z OS batch reports or online TSO ISPF displays FDREPORT is a high performance reporting tool which makes efficient use of z OS resources It can run during the day without any noticeable impact on other z OS applications or users It can typically report on 1 000s of DASD volumes in just a few minutes In PART ONE of this guide we discuss why a product like FDREPORT is necessary and then we look at the basic reporting procedures used in the product PART TWO looks at FDREPORT s advanced reporting capabilities including using extract files generating special output and reporting on DFHSM s control files PART THREE provides an overview of the FDREPORT s online reporting the ISPF based Search Report amp Services SRS panels FDRViEWS FDRVIEWS is a separate cost option which builds on the foundation of FDREPORT to provide a user friendly question and answer method of generating reports It offers a Windows GUI interface through which reports can be viewed in various graphical formats graphs charts etc or as an Excel spreadsheet Its automated report distribution and alert system can warn you about certain conditions that could be a potential cause for probl

Download Pdf Manuals

Related Search

Related Contents

ArtView AT10X-RK28WP tablet  PROGRAMME  NEOSTAR - Heatcraft Europe  Price List 2015  PSK-53210A/63210A  HRIS USER`S MANUAL - Algonquin College  TL-SL1226(ES) - TP-Link  Manuel 130 RC Turbo  Dépliant - 24Pharma  Sistema Integral de Atención Ciudadana (SIAC) Guía del Usuario  

Copyright © All rights reserved. Failed to retrieve file