Updates and Enhancements to IBMTOOLS Libraries May 02, 2018 * Use ISPF 3.13 to compare new JCL to your old JCL to find changes. * Replace entire old CNTL and LOAD with new. * Suggest looking at this file about every 30 days. * BATMAGIC is for IBM and Business Partner use only. 02May2018 The version 1.1 of the doc "VEHSTATS user manual" is available. 01May2018 VEHSTATS, version label - 18121-13.40 - changes to convert the values of the columns "Queue GiB_to PreMig", "Queue GiB_to Copy" and "Queue GiB_to Recv" in the reportHOURFLOW to numbers with fractional parts in case not big value & USEGB=ON; - changes to show the values of the program parameters that impact on the content of the reprort HOURFLOW in the page headers; - changes to fix bad content of the reports HOURFLAT and HOURFLOW if SELECTDOW parameter is specified; - changes not to print too many dummy lines (16 max) in case absence of historical records - report HOURFLAT. Otherwise only 1 special line is printed. 18Apr2018 VEHSTATS, version label - 18108-04.50 - Changes to fix the possible 0C4 abend when the dataset for the report HOURFLOW is closing. 16Apr2018 COMPARSE, version label - 18104-08.54 - changes to improve readable of the protocol SYSLIST: 1) the lines of the protocol are numbered; 2) the lines with control statements have additional number; 3) the messages about parsing errors are output in the line following after the line with mistaken control statement; 4) in 2 cases the message about error is output to SYSLIST instead the job log; 5) the message about the totals of the parsing process is output at the end of the protocol SYSLIST - Changes to implement preliminary check if DD statements are specified or not. The message is output to job log if not. - the programs BVIRPRPT, CHKCOPY, COPYRFSH, CPYHIST, CPY7680H, CPY7680R, RCVRPVOL, RESETSG, TCDBMCH, TCDB2BVR, BVIRPOOL, COPYVTS VESYNC, VTSREL05 have been re-build to make sure that the latest version of COMPARSE is used (no functional changes). 27Mar2018 VEHSTATS, version label - 18086-09.59 - implementation of the correct formulas to convert: 1) from MiB to MB(GB): the values of the fields Active Data of General Use Pool container (x32 records); 2) from 1000 MiB units to GB: the values of Total Size of Migrated Data of Cache Partition Container (x30 records); - incorrect name of H32GUPnn report header has been fixed (the bug after the modification in February of 2018). 27MAR2018 TAPEWISE. Support SMF 21 records when tape volume exceeds 68 GB: - Take into account the values of bytes, read/written by the device, if SMF21MFV is ON (for the volumes greater 68 GB); - Fill the field 'CH_MB SIZE' (report MBS); - Extend 'COMP RATIO' to two decimal digits (hundredths) for the reports DSN, HRS, MBS, MNT, VOL. 27Feb2018 VEHSTATS, version label - 18058-11.27 - reports H32GUPnn: 1) taking into account all "Library Pooling GUP Media Containers" that have not zero counts for scratch and private media; 2) overflow logic is added to conversion of the most of the fields of the report lines; 3) changes in the logic for creation new report page: another page is created if the coming x32 record contains the values of the fields that differ from the values of the fields from the header of the page; 4) the column that shows the number of non empty of "Library - Pooling GUP - Media Containers" except shown in the reportline has been added (is to print if >0); 5) size of the report line is increased to 197 bytes; - report H32CSP: 1) now items of CSP container with zero and non-zero media number are output; 2 new page header created if the order of media types is changed; - report H20VIRT: 1) expansion of the columns AHEAD MAX, AHEAD AVG, BEHIND MAX and BEHIND AVG has been done; 2) the overflow logic has been added to conversion logic of the most of the fields; 3) size of the report line is increased to 190 bytes; - report DAYSMRY: wrong measure units for the counters "GiB Read", "GiB Write", "Tot GiB Xfer" have been corrected (now GiB). 20Feb2018 COPYRFSH. Add the "delay" between LMPOLICY and COPYRFSH commands. This "delay" might be needed to get finished the command "LIBRARY LMPOLICY" (if MC or SC are specified) before the command "LI REQ COPYRFSH". 16Feb2018 PRESTAGE. The incorrect coding PARM field in the job PRESTAGE has been fixed. 14Feb2018 VEHSTATS. The lists of counters for HOURFLAT and other "order" based reports - ORDERALL, ORDERC25, ORDERV12, ORDER6CL, ORDER8CLS: Media 3592JA is commented out and 3592JD is un-commented. So, now JB, JC, JD (plus JJ, JK for *ALL/*6CL/*8CL lists) will be processed by default, otherwise you should update the lists manually (as before). 12Feb2018 PRESTAGE, version label - 18043-10.49 - Introduce additional option to generateDSN field with usage TSO USERID instead hardcoded "VTSxxxxx". The USERID is may be specified via PARM field (keyword USERID is mandatory): // EXEC PGM=PRESTAGE,PARM='USERID=XXXXXXXX' - to line up the program logic with its description the conversion of the logical volume sizes from MiB to MB has been added (the previous versions of the program interpret logical sizes from VOLFILE as MB); - the logic that check if the DD statements specified or not has been added. Error messages will be issued if not. The message IEC130 about the absence of the LISTIN DD will not appear any more; - set up the default values for some input parameters has been added. - new messages about program behavior have been added; - changes to show small logical volume sizes with fractional part in the job log messages have been added; - the PRESTAGE job template has been modified to reflect the chages and to make the comments more visible and readable easier. 09Feb2018 VEHAUDIT. Increase the number of positions for the size of the files. Thus, the valid values will be shown in the most case, sometimes USEGB parameter could be specified for too large values, USETB hardly would be needed. 02Feb2018 VEHAUDIT. Fix data overflow. Fix wrong report when "OWN" is specified. Add MBBASE parameter to convert the sizes to MiB/GiB (base 1024) or MB/GB (base 1000). Add USEGB and USETB parameters to specify when the values of megabytes are too large. 02Feb2018 BATMAGIC. The new value of LICENSE for Batch Magic jobs: TAPE=(01FEB2019,.......) 23Jan2018 VEHSTATS, version label - 18023-11.22 - fixed the bugs that rarely distorted the values of the columns in (in case GRID or SHOP option): in the report H20VIRT - the column PCT_OF 15Sec INTVLS in the reports H32TDUnn - the columns MOUNTED MIN, MOUNTED MAX, MOUNT_SECS MIN - non-functional changes for future purposes. VEHSCAN, version label - 18023-08.33 - add printing the field in x32 historical record that not printed in previous versions; - printing several obsoletes fieds from x30 record has been removed; - VEHDOC member in .IBMTOOLS.CNTL has been updated in accordance to the changes above. 16Jan2018 EXPIRE. New value EXPIRE=01FEB2019 9278848 ; JCL lib updated now. 12Jan2018 BVIRGGM,BVIRMES,BVIRPHY,BVIRPIT,BVIRPLNN,BVIRPOOL,BVIRPTP,BVPITRPT these "2-steps" jobs to extract BVIR historical data are updated in such a way, that the first job issues the second job (to the internal reader), so the problem, when sometimes the second job is starting earlier than the first one, is gone (as this was done for the jobs BVIRHSTx earlier, in May, 2017). 18Dec2017 initial version of the doc "VEHSTATS user manual" is available. 13Dec2017 VEHSTATS, version label - 17347-09.42: - extent of detail columns in the reports DAYSMRY, COMPARE, MONSMRY from 10 to 14 characters. Now the record lenghts for them are: * 160 bytes for DAYSMRY; * 765 bytes for COMPARE; * 195 for MONSMRY. - the number of the columns in the reports MONSMRY has been increased from 10 to 12 per a report page to collate all months of a year; - the bug ih the page size logic for the reports DAYSMRY and MONSMRY has been fixed - page sizes may vary by 1 before the fix; - the logic to print SECTION header based on the content of the header text has been replaced with the logic that does not depend on the header text for the reports DAYSMRY, COMPARE, MONSMRY - removed the limit of 60 months for the report MONSMRY; - cosmetic changes in the jobs VEHSTPS, VEHSTPO; - the ORDER with space line SECTION title has added to order lists ORDER8CL, ORDER6CL, ORDERV12, ORDERC25. 21Nov2017 Decoder. The new version of this document is available (file name: TS7700.VEHSTATS.Decoder.V21e.pdf): - Add "uncompressed data" to the description of the fields "CHANNEL BLOCKS WRITTEN FOR THESE BLOCKSIZES" in the report H20VIRT; - Change the report name H30TVC1 to H30TVCx (in this document) to show that it could be up to 8 reports, H30TVC1 - H30TVC8; - The Description of the fields in the reports H21ADP0x and H21ADPXX is improved; - Add the mention of the report H32TDU34; - Refresh the reports H21ADPSU, AVGRDST and DAYSMRY; - "DAYSMRY - Report Order" removed; - Add the reports DAYHSMRY, WEKHSMRY, MNTHSMRY; - Add the report H30COMP - Compression Container; - Add the description of "Common Header related fields"; - Move the fields (counters) of "order based" reports to the separate table. 13Nov2017 VEHSCAN, version label - 17317-05.01: Add parameter VTSNUM to have a possibility to specify cluster's serial number(s). 08Nov2017 VESYNC and VEHAUDIT. Call FORMPGMS dynamically (to reduce the size of load modules). 04Nov2017 VEHAUDIT and FORMPGMS. Fix CRTDATE (Creation Date) when RMM(X) is the input catalog. 01Nov2017 VEHSTATS, version label - 17304-11.00: - improvement of the logic defining the boundaries of hours and days; - fix the potential problem of array index overflow; - the jobs VEHSTPO, VEHSTPS, VEHSTSO have been updated for info actualization and improving readability. 23Oct2017 EXPORT. Recompile program XPORTCAT to avoid S0C9 - just in case if anybody still use the job EXPORT. 04Oct2017 TAPEWISE. Prevent endless loop, when the error http://www-01.ibm.com/support/docview.wss?crawler=1&uid=isg1OA51325 is not yet fixed in the system. 29Sep2017 EXPIRE. New value EXPIRE=01OCT2018 81239904 ; JCL lib updated now. 29Sep2017 VEPSCAN and VEPSTATS. Support the fields "Ahead count" and "Behind count" (record X01 - Vnode PIT General Information Container). 13Sep2017 VEHSTATS, version label - 17256-10.00: - HOURFLAT report: fix 0C4 abend in case an empty report as the result of HRSDATE & HREDATE filter; - HOURXFER report: changes to avoid printing garbage values in case processing small quantity of intervals. 05Sep2017 VEHSTATS, version label - 17248-01.25: - changes to print value of CODE LEVEL like 8.040.165.8802 (with 3 digits in the Modification subfield) properly. As the result of these changes and due to the fact that the columns in the reports DAYSMRY, COMPARE and MONSMRY have 10 pos. only the actual CODE LEVEL may be replaced with the "**********" literal in these reports; - COMPARE report: changes to display MSER for every cluster in the headers of the report columns; - HOURFLOW report: UTCPLUS or UTCMINUS is added to the second line of the report page header; - small non-functional changes to fix some mistypes and bugs and to improve the code. 30Aug2017 VESYNC. Improve the logic to skip the header lines in MES files. Use data set **.DTLRPT instead of SYSOUT=* (by default) for detailed report. VEHAUDIT. Copy the volume's names, which are inconsistent or have no copies, to the file MESERRPT (together with corrupted volumes, see the change from 08Jan2016). 28Aug2017 VEHSTATS, version label - 17240-04.04: - the logic to clean up the output buffers for the reports DAYHSMRY, HOURFLAT, MNTHSMRY and WEKHSMRY has been added to avoid appearing garbage symbols in case specific ORDER list; - the logic to fill-in the output buffers with the literals "NO ORDER" has been removed for the reports listed above; - not functional changes to avoid abend with code S878-10 in case when the option SPLITCLUSTERS is ON. 25Jul2017 VEHSTATS, version label - 17206-04.44: - The bug caused 0C9 abend in case processing a big historical input file has been fixed; - Incorrect values of percentage fields in the report HOURXFER in case processing a big historical input file have been fixed. 17Jul2017 The document "VEHAUDIT._How_to_read_the_report_DTLRPT" is modified: "S" before the value of EXPDATE means the volume is "scratch". Volume's "categories" are added also. The new version of the document is available now. 27Jun2017 VEHSTATS, version label - 17178-11.54 Add support the fields from the Compression Method Containers for order based reports - for future use. 26Jun2017 VEHSTATS. Add the new report H30COMP - the content of "Compression container" - for future use. 21Jun2017 VEHSTATS, the report H30TVCx. Change the field name "TOTAL TVC GB FLASH" (Total used flash cache) to "TOTAL GB DR FLASH" (to show that this "FLASH" refers to "Flash Copy for Disaster Recovery"). 20Jun2017 Decoder. The new version of this document is available (file name: TS7700.VEHSTATS.Decoder.V21d.pdf): - The report DAYSMRY: fill the column "Field Type" (where it was still not filled yet) - H30TVCx: Change the column name 'TOTAL P-MIGRD GB' to 'TOTAL MIGRD GB' - Add the report HOURXFER 19Jun2017 Jobs $FTPGETD, $FTPGETT, FTPTOOLS, SENDDATA - the following statements are added - to remind how to allow secure FTP: //* Uncomment next line for Secure-FTP //*FTP EXEC PGM=FTP,PARM='-a TLS',REGION=5M 08Jun2017 VEHSCAN. Support the new fields "Compression container" from Hnode HSM Historical Record (x30) - for future use. 31May2017 VEHSTATS, version label - 17151-11.00 New version of the report AVGRDST - the section with the detailed data about Cache Miss Mounts for every cluster is added - the section with the info about Cache Miss Mount Times distribution for every cluster is added - now VEHSTATS set return code = 4 if unsupported ORDERs are detected 22May2017 VEHSTATS, the report H30TVCx. Change the column name 'TOTAL P-MIGRD GB' to 'TOTAL MIGRD GB' (what should correspond to the field name 'Total Size of Migrated Data'). 22May2017 Education. Katja Denefleh suggests to public her presentation sheets, which she uses for the initial customer's education for TS7700. You can find it in the file "TS7700_Starting_with_VEHSTATS.pdf". 16May2017 EXPIRE. New value EXPIRE=01JUN2018 45369568 ; JCL lib updated now. 16May2017 BVIRHSTx. The jobs to extract BVIR historical data are updated. Now the second job will be created (sent to the MVS internal reader) in the last step of the first job. So, the problem, when sometimes the second job is starting earlier than the first one, is gone. 10May2017 VEHSTATS, version label - 17130-12.49 - the logic to validate input statistical records has been added. If a corrupted record is detected then a special info message is output into the report RECLIST. Also a message with quantity of corrupted messages is output into the job syslog; - the static accumulation arrays for the reports DAYXFER and HOURXFER are replaced with dinamical arrays. The reports are not created by if the allocation requests are not succeded; - changes in the titles and header of the tables from the reports DAYXFER and HOURXFER to make them clearer; - more tests are added to validate compatible report options. The reports DAYXFER and HOURXFER are not created if one of options SHOP or GRID is specified. 08May2017 GGMSORT. Fix the potential abend of the job GGMSORT in the systems, where SYNCSORT (instead of DFSORT) is used - the member GGMSRT1 in the library **.IBMTOOLS.CNTL is corrected. 03May2017 VEHSTATS, version label - 17123-11.33 VEHSTATS. Fix incorrect value of the column Max_Confgd_Thr in the report HOURFLAT in case not full set of the statistical records for an interval 26Apr2017 VEHAUDIT. Add the calculation of the volume sizes by media categories (CURRENT CATEGORY). Example (at the bottom of the report VEHAUDIT.DTLRPT): CATEGORY NUMBER SCRATCH SIZE_GB 000E 85 4 000F 167698 392745 0002 52212 17894 001F 5 1 Total 220000 410644 21Apr2017 COPYRFSH. Fix possible ABEND S013-48 - add FREEPOOL after CLOSE. 19Apr2017 VEHSTATS_MODEL_v21: Fix the slide 129 "Acive Data Stored by Day" (Shown dates were wrong). 18Apr2017 VEHSTATS, version label - 17108-07.30 The new version of DAYSMRY report has been developed: - the field "Type" of the report is restored. The field now contains 3 characteristics - the field "Unit" is added to every detail line of the report. The field contains measure unit for the metric (counter) which values are in the report line. - the legend that describe the mnemonics from the fields "Type" and "Unit" is output at the bottom of the report 18Apr2017 VEHSTATS. Fix S0C4 if just a few "ORDER" parameters are specified. 15Apr2017 VEHSTATS, version label - 17105-06.30 - convertions to GB are added for the sizes and the amounts of data resident in cache for every cache patition (the conversion is exceuted only for CP0 in prev. versions) The change is impacted on the reports H30TVC2-8 and on the counters of the summary reports (ORDER based reports) related to cache partion sizes and amouns of resident data (like PGx GB in TVC) 14Apr2017 VESYNC. Fix the selection of volumes by Management class (INCMC) and Storage Group (STOREGROUP). 14Apr2017 VESYNC. Add one more parameter to manage the selection of volumes for COPYRFSH: INCLUDE_VOLUMES_AFTER_JOIN; (abbr: INCLUDE) Select only the volumes, which do not have a copy, have data on other cluster(s) and have not been accessed since JOIN/MERGE operation (data_inconsistence = 'Y', data_level = '94' or MES_FLAG='W', and data_level_current > 100). If this parameter is commented out, then ALL volumes, which are inconsistent and have data, will be selected (data_inconsistent = 'Y' and data_level_current > 100). 29Mar2017 ISSUECMD. Fix typo in the job (comma after PROC TOOLHLQ=TOOLID); - concatenate APF lib and LOAD lib in the STEPLIB statement; - add comment that PARM='0' is not needed (used for the test). 18Mar2017 VEHSTATS, version label - 17077-08.04 - fix the mistypes in IDs of the orders designed for R4.0 but frozen then - ' DEV xx WRT FR' replaced with ' DEV xx WRT TO'. The list ORDERPDC is updated as well; - changes in some submodules without changes in functionality to ensure further development. 13MAR2017 COPYRFSH. The value by default of the parameter MAXRECALL is changed from 10,000 to 3,000. 07Mar2017 COPYRFSH, ISSUECMD. Comments about the usage of the parameter LRDELAY are updated: LRDELAY is used to: - delay command submission - so LI LMP for MC or SC has time to finish before COPYRFSH - so production impact and contention is minimized. - make use of multitasking and improve command submit time. LRDELAY=S N; S seconds delay between N library request commands (S - value between 1 - 60, N - value between 1 - 65535). LRDELAY=3; 3 seconds delay between each library request command. LRDELAY=3 10; 3 seconds delay between 10 library request commands. Examples follow with time estimates for 3,000 volumes (5,000 recommended max): - LRDELAY=3 1; 3,000 volumes * 3 / 1 / 60 = 150 minutes to issue commands. Contention minimized, no multitasking. - LRDELAY=3 10; 3,000 volumes * 3 / 10 / 60 = 15 minutes to issue commands. Contention minimized, some multitasking. - LRDELAY=3 100; 3,000 volumes * 3 / 100 / 60 = 1.5 minutes to issue commands. Contention minimized, effective use of multitasking. - LRDELAY=2 100; 3,000 volumes * 2 / 100 / 60 = 1 minute to issue commands. May experience some contention, effective use of multitasking. - LRDELAY=3 500; would be excessive use of multitasking. 06Mar2017 COPYRFSH, ISSUECMD. Add subparameter N for the parameter "LRDELAY= S NŮ;", where S - seconds, N - number of "LI REQ" commands after which the delay S seconds is occured. (N = 1 by default). Note. if you specify something like LRDELAY= 3 10000; then there will be practically no delay - up to your risk !!! 03Mar2017 COMPARSE. Withdraw the change from 23Jan2017: "Change the default date of K_SDATESMF to 01Jan1971 instead of 01Jan1995". K_SDATESMF will be 01Jan1995 by default again. (TAPEWISE was affected). 02Mar2017 VEHSTATS, version label - 17061-10.33 - The bug when the columns Cache_TotMiB/s, To_TVC_By_Cpy and Fr_TVC_By_Cpy are calculated incorrectly for GRID and SHOP options has been fixed (summary reports); - the columns Read_Comp, Write_Comp and Total_Comp of the summary reports are calculated more precisely now; - changes in some submodules without changes in functionality to simplify further development. 27Feb2017 VEHSTATS_MODEL_v21: - The headers for the charts about "3592 Cartridges" are changed, also cartridge type is taken now as it is in HOURFLAT file (instead of "hardcoded" labels). - PPT file, section "Capacities: Cartridges used" is expanded with the list of all known cartridges. Note. If you want to use PPT file, you should save XLS file under the name VEHSTATS_MODEL.xls (and keep untouched version VEHSTATS_MODEL_v21.xls for reuse). 24Feb2017 VEHSTATS. Discovered that the logic for the paremeter GERMANMONTH were lost in the program in June of 2015. As nobody has asked us about them from that moment it has been decided not to restore the logic and to remove the parameter from the jobs VEHSTPO, VEHSTPS and VEHSTSO. 23Feb2017 TAPEWISE. The jobs TAPEWIPO, TAPEWIPS and TAPEWISO: add parameters STIME/ETIME to specify time for the selection period when needed. VEHAUDIT. Improve calculation of the number of existing copies of the volumes. 15Feb2017 VEHSTATS_MODEL_v21. xls and ppt (Graphing Package). A lot of "cosmetic" changes are done, mostly in header lines for the charts. 15Feb2017 GGMSORT. Update sort statements in order to process only the records for Primery pool from VOLUME MAP file (VOLFILE). 13Feb2017 VEHSTATS/ORDER6CL. 4 fields are added to the list ORDER6CL: ORDER=' MAX AHEAD '; ORDER=' AVG AHEAD '; ORDER=' MAX BEHIND '; ORDER=' AVG BEHIND '; 08Feb2017 VEHSTATS, version label - 17039-04.10 - The logic to check if the ORDERs in the input are supported by the program are added. If unsupported order is detected then VEHSTATS output the message into syslog. Example: VEHSTATS: order " TVC SIZE " is not supported. IGNORED. 08Feb2017 VOLLIST. Fix RECFM in DETAIL report. (The value of the field RECFM in detail report was wrong in some cases). 06Feb2017 BATMAGIC. The new value of LICENSE for Batch Magic jobs: TAPE=(01FEB2018,7D6A4551,1D861954) 06Feb2017 EXPIRE. New value EXPIRE=01FEB2018 9274304 ; JCL lib updated now. 06Feb2017 FORMPGMS. Fix conversion of EXPIRATION DATE when DATEFORM=A is specified. 01Feb2017 VEHSTATS_MODEL (Graphing Package). Some improvements are done: - Change GiB to GB in some charts. - Rename two charts to "Data to Migrate" and "Data to Copy" (Slides 101 and 110). - Provide the loading of content from cell A35.. to A3.. for HOURFLAT file. 25Jan2017 VEHSTATS, version label - 17025-08.00 The bug that cased abend OC4 in case non-standard LRECL value for the input file with RECFM=U has been fixed. 25Jan2017 Decoder. The new version of this document is available (file name: TS7700.VEHSTATS.Decoder.V21c.pdf). 23Jan2017 VEHAUDIT. Set the value 01Jan1971 for SDATE instead of 01Jan1995. (in case if customer have very old data sets and forget to specify appropriate value SDATE - the old data sets could be missing in the report). 21Jan2017 VEHSTATS. Several bugs have been fixed: - the bugs due to which the columns Avg_Phy_Mntd,Max_Phy_Mtime Avg_Phy_Mtime, Avg_Virt_Drvs from order based reports did calculate incorrectly for SHOP and GRID options; - the bug in processing x20 records for SHOP and GRID options. Impacted on the column VIRTUAL_DRIVES MOUNTED AVG of the report H20VIRT; - the bug in processing x32 records. Impacted on the columns MOUNT_SECS MIN of the report H32TDUnm. 20Jan2017 VEHSTATS_MODEL (Graphing Package). XLS and PPT files have been updated again: to make the charts more precise with GiB/GB/MiB/MB in header lines. Two more charts are added - "Read Compression Ratio" and "Daily Data Received from other Clusters". 13Jan2017 VEHSTATS_MODEL (Graphing Package). XLS and PPT files have been slightly updated and have the names VEHSTATS_MODEL_v21 (xls and ppt): The following charts are recovered from one of the previous versions for the section "Daily charts": - Daily Cache Data Flows (Calculated); - Daily Cache Data Flows (from VEHSTATS); - Daily Cluster Utilizations. The new chart is added for the section "Daily charts": - PG0 and PG1 GB in TVC. Note. The file VEHSTATS_MODEL_Day.ppt was simply a part of VEHSTATS_MODEL.ppt and will not be supported. VEHSTATS. Update the lists ORDERV12 and ORDERC25 (in *.IBMTOOLS.JCL) in order to match them with the list of the fields needed for "Graphing Package" VEHSTATS_MODEL.xls (as well as for VEHSTATS_MODEL_v21.xls); - DAYHSMRY report - the bug in FILLR logic has been fixed (sometimes extra FILLR line was generated). 06Jan2017 VEHSTATS. Improve the duplication logic to avoid possible looping and to get clear reports. 05JAN2017 VEHSTATS. Update the list ORDER6CL in order to match that list with the list of the fields needed for "Graphing Package". 29Dec2016 VEHSTATS. - the following cache partitions ORDERs are not supported more and have been removed from the lists ORDERALL and ORDERPTT: +------------------+ | "PG0 NUMPFRRM n" | | "PG0 SIZPFRRM n" | | "PG1 NUMPFRKP n" | | "PG1 SIZPFRKP n" | +------------------+ (totally 32 orders removed); - the following ORDERs are not supported more and removed from the lists ORDERALL, ORDERC25, ORDERV12 and ORDER6CL: +------------------+ | "PG0_NUMPFRRMV " | | "PG0_SIZPFRRMV " | +------------------+ - the following ORDERs are introduced and inserted into the lists ORDERALL, ORDERC25, ORDERV12 and ORDER6CL: +------------------+ | "PG1_NUMPINNED " | | "PG1 SIZPINNED " | | "PG1_NUMPFRRMV " | | "PG1_SIZPFRRMV " | +------------------+ (may be not active in a particular list); - the following ORDERs are introduced to replace the obsolete ORDERs which mnemonics do not reflect their contents: +------------------+--------------------------+ | new ORDERs | replaced obsolete ORDERs | +------------------+--------------------------+ | '%HOST_WR_TH_TA' | ' %HST_WR_TH_P0' | | ' AVG_WR_TH_TA' | ' AVHSTWR_TH_P0' | | ' %COPY_TH_TA' | ' %CPY_THR_P0 ' | | 'AVG_COPY_TH_TA' | ' AVCPY_THR_P0 ' | | 'AVG_OVER_TH_TA' | ' AVALL_THR_P0 ' | | ' %DEF_CP_TH_TA' | ' %DFRCPTHR_P0 ' | | 'AVG_D_CP_TH_TA' | ' AVDFRCPTHR_P0' | | 'BAS_D_CP_TH_TA' | ' BSDFRCPTHR_P0' | | 'HSTWR_THRSN_TA' | ' HSTWRTHR_REAS' | | ' COPY_THRSN_TA' | ' COPYTHR_REAS ' | | 'DCOPY_THRSN_TA' | ' DFRCPTHR_REAS' | +------------------+--------------------------+ | 'HSTWR_THRSN_P0' | ' WRT THROT RSN' | | ' COPY_THRSN_P0' | ' CPY THROT RSN' | | 'DCOPY_THRSN_P0' | 'DCPY THROT RSN' | | 'BAS_D_CP_TH_P0' | 'BASE DCP THROT' | +------------------+--------------------------+ the lists ORDERALL, ORDERC25, ORDERPTT, ORDERV12, ORDER6CL have been updated; - reports H30TVC2-7: the values of the fields in the section DATA RETENTION are set to "na" because they do not have sense for the tape attached partitions; - H30TVC1 report: the values of the colunms with sizes from the section DATA RETENTION are output with a fractional part in case when a values less then 10Gib; - HOURFLOW report: VEHSTATS will not be abended if a QUEUE size value is bigger than 999999 - the literal '******' are put into the corresponding column instead and a warning message is put into the job log; 16Dec2016 VEHSTATS. Avoid "ABEND U0032" when "CP0 partition size" = 0. 15Dec2016 VEHSTATS. Report H30TVCx - fix counter "SIZEGB PINNED" - convert it to GB (was shown in MB). 13Dec2016 VEHAUDIT. Don't build REMOVE command (to remove volumes in status EXIST) for those clusters, where MES file is not opened (or rather not specified in DD BVIRMES). 07Dec2016 BVIRGGM. Change the length of extracted file to 400 (instead of 640). 05Dec2016 TAPEWISE, report ACTRPT. Change the logic to search 'Account Number' in the record SMF type 30 (to fix bug for some systems). Add message 'CANNOT USE MNTRPT AND ACTRPT TOGETHER'. 02Dec2016 VEHSTATS (version label: 16336-07.40). The changes are the following: - the updated version collects configuration info by scanning the input and does mapping for x33 records without DEFDLs (are ignored now). Therefore the program is able to process correctly the cases when a GRID configuration is changed in reported period; - duplication detection logic: the BVIR records with the non-standard timestamp are also considered as duplicates if the difference between their timestamp and the timestamp of the presious normal set of BVIR records with the same grid, cluster and record type are less then 900 seconds; - depending on the content of x33 records the program evaluates if it is able to define the actual cluster list for every x33 record and output warning messages into joblog and sets different return codes (described in the text of the VEHSTA* jobs in IBMTOOLS.jcl library); - more statistics are output into joblog including statistics on the number of the processed records by types - more info for investigation purposes are put into RECLIST report 01Dec2016 VEHSTATS. The report H33GRID: Correct header lines - they could be wrong in case REPORT=SHOP and there are several Grids with different number of clusters. 30Nov2016 VEHSTATS. The report H30TVCx: report 'TOTAL CACHE PARTITION INFORMATION' for R3.2 and higher. 29Nov2016 VEHSTATS/HYDR33. Add the counters to show REMOTE WRITE/REMOTE READ activities by clusters (Not applicable for REPORT=GRID or SHOP). TAPEWISE. Prevent S0C9 when REPORT=OUT is specified (in the job VOLREUSE). 21Nov2016 VESYNC. Change the logic to select the volumes for COPYRFSH. The volumes are now chosen when all 3 conditions are true: - MES_FLAG in MESFILE (Volume Status Information) is 'W' and - DATA_INCONSISTENT is 'Y' - DATA_LEVEL_CURRENT > 100. For the old versions (code level earlier 8.3) the logic "if MES_FLAG = Y" is remained). Please see the document "WHITE PAPER - TS7700 BULK VOLUME INFORMATION RETRIEVAL" for the description of these fields). 18Nov2016 VEHSTATS. - The bug when the content of some fields of x33 BVIR records might be lost has been fixed. The bug might impact on some counters in the order based reports - The bug when not initialized array items might be used has been fixed. The bug might impact on the content of the counters related to the data clusters exchange. 14Nov2016 FORMCATS. Prevent the error, when two or more COMMON TAPE CATALOGs are concatenated in one DD statement. Add RECFM=UM as possible value. (This concerns all jobs where COMMON TAPE CATALOG could be specified as concatenated data sets) 11Nov2016 Decoder. The new version of this document is available (file name: TS7700.VEHSTATS.Decoder.V21b.pdf). 02Nov2016 EXPIRE. New value EXPIRE=01NOV2017 91254170 ; JCL lib updated now. 02Nov2016 VEHSTATS. The report H33GRID: Remove the counters "MiB_FR x--y TVC_BY_COPY" in case just one cluster in the grid. 28Oct2016 VEHSTATS. The report H30TVCx: Change the header 'TOTAL CACHE INFORMATION' to 'TOTAL CACHE PARTITION INFORMATION'. 25Oct2016 VEHSTATS. - Calculate the total number of PG0 + PG1 UNMIGRATED LVOLS in the report H30TVCx. - Take into account all Cache Partitions for the report AVGRDST (not just CP0), and accumulate only the intervals, where "Cache miss mount" has been occurred. COPYRFSH. The comments for the job are improved. 19Oct2016 BVIRPRPT. Fix abend S0C9 when amount of data is zero. 17Oct2016 VEHSTATS. Improvement of the VTSNUM logic not to lose the info from x33 records about data exchange for all clusters. 11Oct2016 VEHSTATS. Modification of the changes done on Oct 07th, 2016. 10Oct2016 VEHSTATS. ORDERALL list of the counters for HOURFLAT and other "order" based reports: the counter SYNC (Number of SYNC mounts) is moved from it's position between SCRATCH (Number of SCRATCH mounts) and RD HIT( Number of READ HITS in Cache) to the position just before the counter AVG SYNC SEC (Average SYNC mount time) (in order to not to stay among other mounts because SYNC mounts are not summarized in TOT MNTS (Total number of mounts)). 08Oct2016 VEHSTATS. The report H30TVCx - extend the field %RLTV_IMPAC_VALUE by 1 position to show bigger values (just in case) 07Oct2016 VEHSTATS. Fix support of 3592 JZ Media and 3592 JL Media: 3592 JZ Media - hex code was x30 - it should be x2A 3592 JL Media - hex code was x31 - it should be x2B (Otherwise they are reported as "unknown") 06Oct2016 VEHSTATS. Exclude SYNC LEVEL MOUNTS from the counters TOT NUM MNTS (total number of mounts) and AVG MNT SEC (average mount time) (because SYNC LEVEL MOUNT is transformed in the end into other kind of mount -"hit", "miss" etc) VEHSTATS. The report H33GRID: set the counters LVOLS_TO_TVC_BY_SYNC_COPY and MiB_TO_TVC_BY_SYNC_COPY to 'na' because the source fields are not yet supported. COPYRFSH. Don't issue command LI REQ,...,COPYRFSH if parameter LIBNAME is not specified (then PARTRFSH/LIBPART could be specified in order to issue the sequence of commands LI REQ,libpart,PARTRFSH) 03Oct2016 VEHAUDIT. Fix SDATE/EDATE selection bug. 23Sep2016 LIBMANGR. Add parameters SDATE, INCJOB/EXCJOB for filtering data sets. The job LIBMANGR is updated as well: undocumented parameters INCDSN, EXCLIB, INCVOL are added. 23Sep2016 BVIRT2B, CPYHIST, VEHSCAN (version id: 16266-13.27) - modules are rebuilt due to changes in the macros used for the development 23Sep2016 VEHSTATS (version id: 16266-13.23): - implementation the support of the stat fields introduced in the release 4.0 of microcode; - redesign changes without changes in the functionality; - cosmetic changes in H32CPS report - changes in H32GUPxx report not to take into an account field values if the media type is 0; - implemented 4 new orders for general usage: ORDER=' VV IN TVC'; NUMBER VIRTUAL VOLUMES IN TVC ORDER=' GB IN TVC'; AMOUNT OF VIRTUAL VOLUMES IN TVC ORDER='LVOLS ON TAPES'; NUMBER OF LOGICAL VOLUMES ON TAPES ORDER=' GB ON TAPES'; AMOUNT OF LOGICAL VOLUMES ON TAPES The orders are added to ORDERALL list but not activated; - changes not to use rubbish data in x33 records in some situations; - fixed the bug when the titles of some Hxx reports shows next cluster id instead the current; - fixed 2 bugs happen seldom caused the program abends 16Sep2016 COPYRFSH. Change to fix problem with calculation data amount recalled in cache and total data amount in cache - not to issue commands LI RQ,...,COPYRFSH,... in case PARTRFSH option. 13Sep2016 COPYRFSH. Change to expand the edit mask for TOTALING values in final messages. 01Sep2016 BVIRPRPT. Change the logic to calculate the date to universal (to avoid problem after year 2017). 30Aug2016 BVIRPRPT. Expand the columns in the report to have enough room for larger numbers of GiBs. 25Aug2016 VEHSCAN. Fix the field names for Grid Historical Record (X33). 25Aug2016 VEHSTATS. Fix the column names in H33GRID report: MiB_XFR MiB_XFR MiB_XFR MiB_XFR FR_DL TO_DL <==> TO_DL FR_DL RMT_WR RMT_RD RMT_WR RMT_RD 23Aug2016 VEHSTATS & VEHSCAN. Convert the field "Device Serial Number" (Physical Device Container) from ASCII to EBCDIC. 16Aug2016 VEHSTATS. Fix the counters "MIB_TO_TVC_BY_DEF_COPY" and "MIB_TO_TVC_BY_RUN_COPY" in H33GRID report. 09Aug2016 VEHSTATS. Split the reports H30TVCx by partition 0 and "tape attached" partitions. - Rework "Throttling counters. - Add the columns "TOTAL CACHE INFORMATION" and "DATA RETENTION INFORMATION". 04AUG2016 VOLLIST. - Skip SCRATCH volumes in the report VOLCUA, if parameter SCRATCHALSO is not specified. - Eliminate header lines in the report VOLCUA by parameter LINES. Just to remind: Parameter LINES = 9999 skips all header lines (except the first headers) for all VOLLIST reports. 08Jul2016 EXPIRE. New value EXPIRE=01AUG2017 62639466 ; JCL lib updated now. 30Jun2016 VEHAUDIT. Add parm EXCLOC/INCLOC for the selection by OUTCODE Examples: INCLOC= VTS01; Include just these OUTCODEs INCLOC= VTS02; Include just these OUTCODEs *EXCLOC= VTS03; Exclude these OUTCODEs 24Jun2016 VEHSTATS (version id: 16175-11.21). - implemented the reports H32PD01-H32PD04 for visualization the content of Physical Device Containers introduced in the release 4.0 of microcode. - DD statements H32PD01, H32PD02, H32PD03, H32PD04 are added to the step RPTSTEP of the jobs VEHSTPO, VEHSTPS, VEHSTSO 23Jun2016 VEHSCAN. Descriptions of several fields were updated in VEHDOC member in xxx.IBMTOOLS.CNTL library 20Jun2016 VOLLIST, ORPHANS, EXPDIST. Fix possible S0C4 abend. 10Jun2016 VEHSTATS (version id: 16160-13.03). - redesign is done to calculated correctly more statistics in order based reports for GRID and SHOP option. Now all order based reports (HOURFLAT, DAYHSMRY, WEKHSMRY, MNTHSMRY, DAYSMRY, MONSMRY, COMPARE) and reports HOURXFER & DAYXFER are build on the base only QTR records in the both HRS and QTR options; - implemented "delayed interval logic": a record that has non standard timestamp is processed as a record with standard timestamp if it is "late" less then for 30 second; - any DD statement for a report file may be omitted - the program will issue a message and will continue without creating the particular report; - added issuing a WTO warning message if x33 records with different record length preset in the input - STATSU and STATSVB files can be both U or VB; - implemented output of messages with the run statistic info; - BVIR records sleeted for further processing are marked in the RECLIST report; - fixed a bug when some field decimal values remains with "." instead "," in case EUROFORMAT option; - summarizing rules for GRID and HRS is lined up with each other and are changed in some cases es (impacted only on HnnXXXX reports) - fixed a bug when the values for "MiB_TO TVC_BY COPY" and "MiB_TO GRID_BY GGM" are calculated incorrectly; 10Jun2016 VEHSCAN (version id: 16159-10.27). - added issuing a WTO warning message if x33 records with different record length preset in the input - added fuzzy logic for mapping between cluster # and Grid-Clauser container index in case non standard layout of a x33 record - several not critical bugs are fixed 20May2016 TAPEWISE. Print only summary (totals) in the report MBSRPT if parameter DETAIL=N is specified (The jobs TAPEWIPO, TAPEWIPS, TAPEWISO are updated - just comment is added). 20MAY2016 BVIRRPT. - Fix 25 GB Virtual Tapes - correct selection by INC/EXCDSN when DSNAME = 18May2016 TAPEWISE. Print the info the number of of Mounts and GiB read/written by TGROUP and by SYSID. This info is created at the buttom of the report MBS, when parameter MBS is specified. Example: |----------------------|------------------------------ |TOTAL INFO BY TGROUP | ALL 3490 3590 |----------------------|------------------------------ | TOTAL SPECIFIC MOUNTS| 9521 9517 4 | TOTAL SCRATCH MOUNTS | 17828 17823 5 | TOTAL MOUNTS | 27349 27340 9 | | | TOTAL GIB READ | 11850 11787 63 | TOTAL GIB WRITTEN | 39786 39774 12 | TOTAL GIB | 51636 51561 75 |----------------------|------------------------------ (The info "by SYSID" is looking similar) 12May2016 BVIRRPT. Support media 4Tb, 7TB and 10Tb. The job BVIRRPT is changed also: - samples for the new media tapes are added; - DD's DTLRPT, JOBRPT, DSNRPT and CUARPT are changed from "SYSOUT=*" to the corresponding data sets. 04May2016 VOLLIST. Parameter "FROM " was added for GRPDSN, which allows to exclude data sets OLDER than specified data. Example: GRPDSN=HLQ1.HLQ2.HLQ3*.V*.** FROM 03APR2016; GRPDSN=HLQ1.HLQ2.HLQ3*.F*.** FROM 02JAN2014; The "V" files, OLDER than 03APR2016, will be skipped from all reports and the "F" files, OLDER than 02JAN2014, will be skipped as well. 28Apr2016 ORDER6CL. Enable the following two GGM fields: ORDER='DATA XF BY GGM'; AMOUNT OF THE DATA TRANSFERED DURING GGM ORDER=' MIB/S BY GGM'; SPEED DURING GGM 22Apr2016 FORMPGMS. Fix RMM calculation of FSTVOL (To avoid possible Abend S0C7). 18Apr2016 VEHSTATS. Fix an inaccuracy in the build of the module VEHSTATS 18Apr2016 VEHSTATS. Fix counters on reports H30TVCx ROLLING_AV_MAX -TIME_IN_CACHE 4HR 48HR 35DA -ON_THE_HOUR-- 1.2Y 1.2Y 1.2Y when the value exceeds 365 days. 18Apr2016 VEHSTATS. The changes are done to make the coluns PGx_4Hr_Av_Min, PGx_48H_Av_Min and PGx_35D_Av_Min in in the order based reports to show end of interval values 15Apr2016 VEHSCAN. Support the new fields for Release 4.0 (LIBRARY - PHYSICAL DEVICE CONTAINER) 11Apr2016 TAPEWISE. Report MON (monthly mounts) - improve selection by parms. 30Mar2016 VEHSTATS. Fixed the problem when several columns in the report H33GRID are calculated incorrectly for HRS and GRID options 18Mar2016 EXPIRE. New value EXPIRE=01APR2017 26826072 ; JCL lib updated now. 18Mar2016 VESYNC. Fix CDATE and EDATE if they are missing in MES file. 14Mar2016 VEHSTATS. The new ORDER=' AVG SYNC SEC' is implemented in the program (version 16074-06.00). The order is added into the lists: ORDERALL (active) and ORDERC25, ORDERV12, ORDER6CL (commented) 11Mar2016 VEHSTATS. 3 mistypes in the ORDERALL list in the PRIMED section are fixed. 10Mar2016 COPYRFSH. - Issue command PARTRFSH, if CONSNM NE '0000' too (was missing). - Issue NEWMCNM (MGMTCLAS) and NEWSCNM (STORECLASS) in one command. 10Mar2016 VEHSTATS. Support parm EUROFORMAT (comma) for the fields: Avg_Sec_DCThrt, ThrDlyMx_15Sec, ThrDlyAv_15Sec, Base_DCp_Throt (which was missing by chance). 09Mar2016 VEHSTATS. Count Avg_Scr_Mt_Sec separately from Sync mounts. 24Feb2016 VEHSCAN. - the output the new field "Sunset Media Reclaim Threshold" (introduced with Rel 3.3 microcode) is added - the output of the original "Percent Host Write Throttle on Tape Attached Cache Partitions", "Percent Copy Throttle on Tape Attached Cache Partitions", "Percent Deferred Copy Throttle on Tape Attached Cache Partitions" instead the additional fields is implemented 23Feb2016 SORTSMF. Support parameter TIMEZONE with value '-'. Examples how parameter TIMEZONE could be specified now: TIMEZONE= SYSA +07:00:00; adjusts all TIMESTAMPS for this SYSID by 7h TIMEZONE= SYSB -07:00:00; adjusts all TIMESTAMPS for this SYSID by -7h TIMEZONE= SYSC 04:00:00; adjusts all TIMESTAMPS for this SYSID by 4h 18Feb2016 VEHSTATS. Fix the bug due to that the values of the columns "Avg_Behind_Cnt", "Max_Confgd_Thr", "P-Mig_Throt","Base_DCp_Throt" "PGx_4Hr_Av_Min", "PGx_48H_Av_Min", "PG0_35D_Av_Min" calculated incorrectly The change also impacted on the reports H30TVCx,H20VIRT, DAYXFER and HOURXFER 17Feb2016 COPYRFSH and PRESTAGE. Parameters PARTRFSH and LIBPART are added in order to issue LIBRARY REQUEST PARTRFSH for each logical volume to reflect the new target partition. The command PARTRFSH is applicable only for TS7720TA. Two parameters (both) should be specified to allow PARTRFSH commands creation: LIBNAME and PARTRFSH. (The job PRESTAGE is updated). Example: LI REQ, XXXX, PARTRFSH, ZZZZZZ The new cache partition defined in the logical volume (ZZZZZZ) storage class on the distributed library XXXX will be assigned to the volume. (See PARTRFSH in "IBMů Virtualization Engine TS7700 Series z/OS Host Command Line Request User's Guide Version 3.2"). 17Feb2016 BATMAGIC. The new value of LICENSE for Batch Magic jobs: TAPE=(01FEB2017,786A4551,65DF5CAD) 16Feb2016 The samples of the jobs for an encrypted transmission data to IBM FTP server (see "method 5" in IBMTOOLS.JCL(SENDDATA)) are added: IBMTOOLS.JCL($MTFTPS) - for sending data and IBMTOOLS.JCL($MTFTPR) - for receiving. 12Feb2016 VEHSTATS. Fix the bug due to that the values of the columns "Tot_Mgrtd_Gb_x" for patitions calculated incorrectly. The change also fixed the column "TOTAL MIGRATD GB" in H30TVCx 10Feb2016 The new method for an encrypted transmission data from an user to IBM FTP server (method 5) is added to IBMTOOLS.JCL(SENDDATA) VEHSCAN: cosmetic change in IBMTOOLS.CNTL(VEHDOC) is done 09Feb2016 VEHSTATS. Fix the bug that inpacted on the columns "WRTHR %RLTV IMPAC", "CPTHR %RLTV IMPAC", "DCTHR SEC /IO" of the report H21ADPSU. The columns may have had wrong values before. 01Feb2016 VEHSTATS. Fix counter Sync_Mnts (for "HRS" reports) 29Jan2016 VEHSCAN. The field 'DELAY % OF INTERVAL' contains 0 always after the previous changes. Fixed. 28Jan2016 TAPEWISE. Add the new report MONRPT - Monthly total phisycal mounts by SYSID and DEVICE TYPE (multi LPARS are supported). The jobs for TAPEWISE are updated as well. Example: ******** REPORT=MONRPT (16027) OSL=******* FROM = 29NOV2015 @ 18:45:02 ___ SYSID TGROUP 2015 DEC 2015 NOV TOTAL CCF1 3490 11654 418 12072 TOTAL 11654 418 12072 CCF5 3490 13687 365 14052 3590 4 0 4 TOTAL 13691 365 14056 TOTAL 25345 783 26128 19Jan2016 VEHAUDIT. Add counters with Category codes at the end of the report DTLRPT. Example: CATEGORY NUMBER SCRATCH ---- 45283 100F 173785 1002 96215 + 200F 1270 2002 720 + 400F 347 4002 14653 (categories, which are specified as SCRATCH by parameter SCRCAT, are marked by sign "+". "----" means no category) 15Jan2016 VESYNC. Correct "BAD" dates in the columns CRTDATE and EXPDATE of DTLRPT report. 13Jan2016 COPYRFSH. Add INCVOL/EXCVOL functionality. With the parameters INCVOL/EXCVOL you may select (or exclude) logical volumes placed on specified physical volumes. JCL COPYRFSH is updated as well. Example: INCVOL= P20000 P29999; INCLUDE LVOLS ON THESE PHYSICAL VOLSERS EXCVOL= P40000 P49999; EXCLUDE LVOLS OH THESE PHYSICAL VOLSERS NOTE 1. VOLUME MAP file(s) must be specified to get INCVOL/EXCVOL parameters effective. NOTE 2. You should specify here the PHYSICAL volsers. 08Jan2016 EXPIRE. New value EXPIRE=08JAN2017 2354928 ; JCL lib updated now. VEHAUDIT. Print MES records with flag showing "volume is corrupted" into a separate file MESERRPT. The reports MLTCPY and TOSYNC are corrected. Also some bugs are fixed, like "BAD" date in the column "LAST RMVDATE" in some cases. VEHSTATS. Add parameter NOHOUR24 to suppress conversion of time 00:00 to 24:00 of previous day, i.e. the old style will be used. The conversion (00:00 --> 24:00) will be done by default. The remaining 3 reports (H32CSP, H32GUPnn, H32TDUmm) support conversion "00:00-->24:00" now. Some cosmetic changes are done. VOLLIST. Suppress hex zeroes (set to blanks) in the column OUTCODE/BLKCNT in the report DTLRPT when the field "Location" in Catalog is set to hex zeroes. 30Dec2015 VEHSCAN: - Fix 0C4 problem in case if FIELDS DD statement is not specified. - merge VEHSCANU and VEHSCANV modules. From this moment LOAD library contains VEHSCAN module and 2 aliases for it - VEHSCANU & VEHSCANV. - collect info about clusters by scanning the input file with BVIR records so the program no need DEFDL commands at all. - record limits for DOCDATA and FIELDS datasets are eliminated. - the member VEHDOC (CNTL library) is put in order, several fields are added. - the member VEHFLD (CNTL library) is not maintained any more. the job VEHSCAN is updated to run without FIELDS DD statement by default. 28Dec2015 VEHSTATS. Parameter HOUR24 is added in the jobs for VEHSTATS (VEHSTPO, VEHSTPS and VEHSTSO) to specify conversion of time 00:00 to 24:00 of the previous day. This makes the reports more accurate. Parameter HOUR24 is active by default in the jobs. 14DEC2015 VEHAUDIT. Substitute library NAME instead of library ID when LI REQ commands are creating to remove volumes with STATUS 'E' (see FINDE option). To specify library NAME, parameter DEFDL must be used as follow: DEFDL= nnnnn c family libname; or DEFDL= nnnnn c , libname; (to show that 'family' name is not specified). 08Dec2015 VEHAUDIT, COPYRFSH, PRESTAGE, RCVRPVOL, RESETSG - Fix S0C7 if 25GB volumes 08Dec2015 VEHAUDIT. Fix data selection when no tape catalog 04Dec2015 VEHSTATS: HOURFLAT report:extra symbols beetween the fiels in the header of a detailed row in case combination compress mode with GRID of SHOP 27Nov2015 TAPEWISE. - Report HRSRPT: the fields "Mb/Sec" are expanded from 3 digits to 4 ("overflow" starts to appear as transfer speed is growing...) - Report JOBFLAT: the record length is changed from 190 to 195 (the last field was not visible) Note: The jobs TAPEWIPO, TAPEWIPS and TAPEWISO are updated! 26Nov2015 VEHSTATS: - 14 ORDER statements that had been removed in the version from 19Aug2015 are restored on 11Sep2015 are not supported again; - these ORDERs are removed from the list ORDERALL, ORDERV12, ORDER6CL, ORDERC25 - the monthly flat report is developed; the report is generated if the DD MNTHSMRY (MNTHSCLx for split clusters) is activated in jobs (the DD statements are added to the jobs VEHSTPO, VEHSTPS, VEHSTSO) - the support for 400+ ORDER statements to show cluster activities for every partition. The statements are collected in the list ORDERPTT - the accumulation logic for the BVIR fields of '30' type record that show "ages" for PG0 and PG1 is changed - impacted on columns of the H30TVCx and 18 fields in the ORDER based reports (like "PGx_4Hr_Av_Min", "PGx_48HAv_Pmig" ...) - the logic for the field "Max_Confgd_Thr" & "Attmpt_Thruput" in the ORDER based reports is aligned with the logic of the corresponding columns of the report H20VIRT 26Nov2015 EXPDIST. Report expiration dates by media types gathering from catalog. Difference with old EXPDIST: Media type names are not hardcoded in the program, but they are taken from catalog. 22Nov2015 The jobs for GGM (Grid to Grid Migration) are reworked. 19Nov2015 VEHAUDIT. Add parameter NOSCRATCHALL to exclude from the report all SCRATCH volumes that have been deleted and waiting for DELETEEXPIRED either. 12Nov2015 EXPDIST. Extend the length of counters from 7 chars to 9 10Nov2015 VEHSTATS and some other tools. Remove conversion time 00:00:00 (midnight) to 24:00:00 (as this change affects some already existing user's programs for post-processing of the reports). 03Nov2015 VEHSTATS and some other tools. Convert time 00:00:00 (midnight) to 24:00:00 of the previous day. 20Oct2015 EXPIRE. New value EXPIRE=20OCT2016 87128076 ; JCL lib updated now. VEHSTATS. - Changes to support new type of drive (E08) and new media types (JD, JZ, JL). Commented ORDER statements for the new media types are added into the ORDER list members. - The logic to separate output flat files by parameter SPLITCLUSTERS is improved: there is no need to specify all DDs for the files, only for those, which you want to get. 06Oct2015 VEHSCAN, VEPSCAN, VEPSTATS, BVIRPRPT, TAPEWISE. Support new E08 drive and JD and JL media. 'X10 FICON 4 PORT (HANKIE)' is added as well. 30Sep2015 Add the jobs for GGM (Grid to Grid Migration). VEHSTATS. Support GGM counters in H33GRID report. You can see an introduction in the document ggmintro.txt 15SEP2015 VEHAUDIT. CPYDST report: - Add blanks before "100.0%" to separate the columns - Improve the counters for Family 11Sep2015 VEHAUDIT. CPYDST report: You may specify family names for clusters, then you will get statistics for RPO (recovery point objective) for each family definition (minimal and maximal time needed to do the copy of logical volume to family) 11Sep2015 VEHSTATS. HOURFLAT, DAYHSMRY, WEKHSMRY reports: - 14 ORDER statements that have been removed in the version from 19Aug2015 are returned back to the reports. 28Aug2015 VEHSTATS. H30TVCx report: Fix unexpected results after previous changes. Add blanks before the coluns TOTAL NUM MNTS and FAST NUM MNTS COMPARE report: change the logic to dispalay the values of the the fields correctly in case SHOP or GRID option with the changes in the accumulation logic for the report counters. 26Aug2015 VESYNC. Fix USELASTREF; parameter. (Was USE4ASTREF;) 24Aug2015 VEHAUDIT. A new option added - create the list of LI REQ commands to remove the volumes with the status 'E' in case FINDE option. Into VEHAUDIT job a commented //*REMOVE DD ... statement is added that should be activated if this function is requested. 20Aug2015 VEHSTATS. Don't attempt to open HOURFCLn, DAYHSCLn, or WEKHSCLn unless SPLITCLUSTERS parm used to eliminate IEC130I messages. 19Aug2015 VEHSTATS. H30TVCx report: - the fields: NUMBER_PREFER_KEEP, SIZEGB_PREFER_KEEP, NUMBER_PINND_LVOLS, SIZEGB_PINNED_LVOLS from the section PREFERENCE_GROUP_0_EXTENDED and the fields NUMBER_PREFR_RMOVE, SIZEGB_PREFER_REMOVE, NUMBER_PINND_LVOLS, SIZEGB_PINNED_LVOLS from the section PREFERENCE_GROUP_1_EXTENDED are removed because they have no sense(after the discussion with the MC developers); - blanks are inserted to separate the fields in the sections; - the "overflow" logic is added: in case lack of place to display a field properly '****' will be put into; - the values for the columns SIZEGB_PREFER_REMOVE, SIZGB_WAIT and SIZEGB_PREFER_KEEP are to be shown in GiB; - the field WAIT_MINS introduced instead WAIT_SECS; - 14 ORDER statements that had initially been implemented to display the fields mentioned in item 1 are not supported in the ORDER based reports more (will be ignored by VEHSTATS); 18Aug2015 VEHAUDIT. Fix test for tape catalog present w/ SDATE/EDATE filter. 17Aug2015 VEHSTATS. Fix the problem with the counter Week_RDHIT in previous version 14Aug2015 VEHSTATS. Improvemet the logic for Attmpted Thruput changes to make the program more stable in non-standard cases - DAYSMRY and WEKHSMRY: calculate week end date correctly in case incomplete week - HOURFLAT: for the last interval of a day to show 24:00:00 of a current date instead 00:00:00 of a following date - ORDER based reports: correction the locic for the fields: ThrDlyMx_15Sec, ThrDlyAv_15Sec, Pct_Int_w_TDly, Avg_Ahead_Cnt, Max_Ahead_Cnt, Avg_Behind_Cnt, Max_Behind_Cnt improvement the logic for Avg_CPU_Util, Avg_Disk_Util, Avg_Virt_Drvs in case shortened hour intervals - improvment the logic to define end of an HOUR interval in case when an interval with time 00:00:00 is missing between days 07Aug2015 COPYRFSH. Change allowed minimal value of LRDELAY from 3 sec to 1 sec. 29Jul2015 EXPIRE. New value EXPIRE=31JUL2016 63546846 ; JCL lib updated now. COPYRFSH. Add ERRORLOG file to track erroneous input records COPYRFSH. Add message about reached MAXGB and MAXRECALL VEHSTATS. Show value '0K' instead of just 'K' in the reports H30TVCn 20Jul2015 VEHSTATS. PO, PS, SO have extra cluster DDs commented out as default so they don't allocate empty files. User activates if using SPLITCLUSTERS. 20Jul2015 VEHSTATS. DAYSMRY report: some totals for the 1st week of the report were "overflowed". Fixed. 17Jul2015 VEHSTATS. HOURFLAT report: an extra leading symbol in the field End_Time in case combination a compress option and DATEFORM=J removed * repots based on the ORDER stat-ts: changed the logic for 'PHY DEVT MODEL' - now the type and model of phisical drive are included into the field value * ORDERV12 statemet list: removed duplicated statement 'PHY DEVT MODEL' 10Jul2015 COPYRFSH. Add more counters to show the total amount of data VEHAUDIT. Fix to avoid Abend S001 which might happen in some systems VEHSTATS. The new parameter SPLITCLUSTERS has been added for VEHSTATS program (jobs VEHSTPO, VEHSTPS and VEHSTSO), which can be used to split "flat" files (HOURFLAT, DAYHSMRY and WEKHSMRY) by clusters 06Jul2015 COPYRFSH. Add a WTO count at EOJ for total MB/GB that will be copied as a result of the LI REQ commands that were issued. 02Jul2015 VEHSTATS. The new parameter CSVDELIMITER has been added for VEHSTATS program, which may be used to specify CSV delimiter for the flat files HOURFLAT, DAYHSMRY and WEKHSMRY (see an examples in the jobs to run VEHSTATS) 29Jun15 VESYNC. Add the new filter parameters INCMC for MGMTCLASS 24Jun15 VEHSTATS. new versions of 6 VEHSTATS repots based on the ORDER stat-ts support the full list of them related to the microcode v3.2 as well * now the line titles in vertical reports (COMPARE, DAYSMRY, MONSMRY) and colunm titles in the FLAT reports are same for the same ORDER * in 50+ titles literal "...MiB_s" are replaced with "...MiB/s" * in case if USEGB is indicated: - the titles for MiBnm_By_Copy are switched to GiBnm_By_Copy - the titles for POOL_nn_MB_WRT are switched to POOL_nn_GibWRT - the titles for POOL_nn_MB_RD are switched to POOL_nn_GibRD in the repots based on the ORDER stat-ts * temporary the field "Type" is not supported in DAYSMRY 22Jun15 VEHAUDIT. Only test create date/time filter if tape cat data available. 18Jun15 ISSUECMD. Program ISSUECMD and job ISSUECMD are changed in order to set delay LRDELAY seconds between issied commands 16Jun15 COPYRFSH. Add the parameter MAXDR - to split the commands into up to 4 streams for possible parallel mount of physical volumes 08Jun15 ORPHANS. Add the new filter parameters INCPGM and EXCPGM 28MAY15 VESYNC. Support EVENONLY and ODDONLY parameters 25MAY15 VEHAUDIT. Cosmetic changes in header lines 18May15 ORPHANS. Add the new filter parameters INCDSN/EXCDSN and INCVOL/EXCVOL 15May15 VEHAUDIT. Correct COPYDIST report. Calculate the length of DTLRPT dynamically (i.e no need to specify LRECL for DTLRPT DD anymore) 11May15 VEHAUDIT. Improvement - cluster 7 is supported now 06May15 FORMCATS. Fix S0C9 WHEN XVPHYS_USED IS TOO HIGH IN RMMEXTR 30Apr14 EXPIRE. New value EXPIRE=30APR2016 35687014 ; JCL lib updated now. 30Apr15 VESYNC. Fix S0C9 WHEN XVAPPUSE IS TOO HIGH IN RMMEXTR 29Apr15 VEHAUDIT. Add the flag against the volumes which have "Remote Mount" (report DTLRPT) Add parameter RMTONLY to see only the volumes with Remote Mount. JCL lib is updated. 14Apr15 VEHAUDIT. Change HHHH:MM to HHHH:MM: for large times. 14Apr15 PRESTAGE. Fix CONSOLE parm when ROUTEn is not specified 13Apr15 VEHSTATS. Report H21ADPSU - the number of Throughput ranges is increased up to 60 intervals. 10Apr15 VEHAUDIT. Only use consistent lvols for create date if no TMC. Show date/time filters in report heading. 09Apr15 VEHSTATS. Fix SYNC mounts reported individually, but not added to TOT. 08Apr15 VEHSCAN and VEHSTATS. Fix x'32' fields for R1.7 active data (counter Active_GB) 06Apr15 VEHSTATS. Fix time if REPORT=HRS but only 1 15 min interval selected. 31Mar15 VEHSTATS. Distribution in 100 MiB/sec increments for the attempted throughputs, each line has an individual % and an accumulative %. The number of throughput increments is increased to 30. 18Mar15 VOLLIST. Add SORTSEQ=RETPD logic to SUMRPT. 17Mar15 VOLLIST. Add SORTSEQ=EXPDTE logic to DTLRPT. 13Mar15 ORDER. ORDERXFR, ORDER6CL change CPU UTIL to AVG CPU UTIL. 10Mar15 SMFILTER. Avoid the second call of parameters check program (previous version could cause 0C4) 02Mar15 PRESTAGE. Add subparameters CONSOLE and XEQ to parameter ROUTEn 27Feb15 VEHSTATS. Logic for order " PGM VERSION" added 3.2 to HOURFLAT, DAYHSMRY and WEKHSMRY reports. Version added HOURFLAT header Fixed duplication clolumn CPU_Util% in WEKHSMRY 25Feb15 FORMCATS. Calculate compressed volume size for RMM Extract X records. Had only been calculated for D & V records. 23Feb15 VEHSTATS. Fields are added to DAILYFLAT - mainly R3.2 related Fix possible overflow of Active_Gb. Edit mask for field values is extended Added logic to show mask "overflow" - literal '>9999999999999' is to be output in this case 13Feb15 VEHSTATS. Create reports H21ADP01, 02, 03 when 'HOST BUS ADAPTER TYPE' (HVAHDTYP) is X'00', but 'HOST BUS ADAPTER STATE' (HVAHDSTE) is > X'00' 12Feb14 EXPIRE. New value EXPIRE=15FEB2016 13351408 ; JCL lib updated now. 11Feb15 VOLLIST. Make empty data sets (reports) eligible to be migrated. 06Feb15 TAPEWISE. Don't limit blksize * blkcnt to 5 times 3490 capacity. 05Feb15 PRESTAGE. Add comments about preventing S047 abend. 05Feb15 VEHSTATS. Fix overflow of Active_Gb. 04Feb15 LICENSE. New value for the Batch Magic jobs BMPACKT & S. TAPE=(01FEB2016,9C715F08,315365DF) 02Feb15 PRESTAGE. Add comments about always using CACHFILE. 30Jan15 PRESTAGE. Add comments about setting RECLPG0 to ENABLE. 27Jan15 COPYRFSH. Add comments to clarify target cluster. 23Jan15 VEHSTATS. Fix SHOP & GRID summary reporting. Active_Gb might still overflow. Looking at that next. 22Jan15 VEHSTATS. Several more R3.2 fields added to HOURFLAT. 20Jan15 VEHAUDIT. CLnONLYCOPY was reporting only copy even if inconsistent. 19Jan15 PRESTAGE. More comments about use of TOSTAGE DD. 15Jan15 TAPEWISE. Fix AUDRPT wasn't filtering by DETAIL=nnn. (Recalls) 14Jan15 ORDERALL. Be sure all available fields are shown. 13Jan15 FTPTOOLS. Make it work to replaced members in existing libraries. 13Jan15 ORDERALL. Remove duplicate lines. 13Jan15 VEHSTATS. Remove test WTO messages. 12Jan15 ORDERALL & ORDER6CL. Change 3595JR reference to 3952JR. 08Jan15 TAPEWISE. Fix S013-20 if MOUNTMON data used. 06Jan15 VEHSTATS. Chg H20VIRT to ThrDlyMx_15Sec ThrDlyAv_15Sec. 06Jan15 RESETSG. Control parm should be MAXMB, not MAXGB. *MAXMB=1000000; LIMIT MEGABYTES RECALLED TO CACHE (DFLT 4000000,4TB) 06Jan15 FORMCATS. Fix FSTVOL logic for RMM extract X records. 20Dec14 Support the value "LASTMONTH- nnn" for Parms SDATE/ EDATE and HRSDATE / HREDATE 20Dec14 New PARM NOSHIFT32BYTES; in the job VEHSCAN - activate if reading SORTED file from VEHSTATS 12Dec14 SMFILTER. Fix rare loop processing SMF 14 extended segments. 09Dec14 VEHSTATS. COMP values missing for port 2 on H21ADPnn reports. 08Dec14 VEHAUDIT. TS7720 volumes less than 10000 bytes were calculated to be 0.00 MB which was then treated as a scratch and not reported. 29Nov14 VEHSTATS. Fix occasional S0C4 abend, moving data beyond end of buffer. 21Nov14 EXPIRE. New value EXPIRE=15NOV2015 95578780 ; JCL lib updated now. 06Nov14 EXPDIST. Count encrypted 3592 as 3592, not UNKN. 03Nov14 VEHSTATS. Fix S0C1 if H30TVCn (2-8) are missing with R3.2 data. 29Oct14 VEHSTATS. Fix MiB_To_TVC_By_Copy missing for CL0. 28Oct14 VESYNC. Allow inconsistent volumes to be flagged as needing copy. 15Oct14 FORMCATS. S0C9 with older version RMM Extract file. 09Oct14 VEHSTATS. If input file is missing several days of data, HOURFLAT generated intervals will have bad DOW and date. One or two hours missing is okay, multiple days got messed up. Now fixed. 02Oct14 VEHSTATS. Initial reporting for R3.2 statistics. More to come. 01Oct14 VEHSTPO, VEHSTPS. Fix SA00 abend in H33GRID copy step. LRECL was expanded beyond what copy program was expecting. 19Sep14 VEHSTATS. H33GRID now reports cluster doing remote mount. Note that the LRECL changed for VEHSTPS and VEHSTPO. See new JCL. 09Sep14 TAPEWISE. Get rid of binary 0 at end of some report lines. 04Sep14 VEHAUDIT. Provide ability to detect & report lvols removed from a full TS7720 cache but not deleted from rest of grid. New REMOVEDONLY parm allows reporting just the removed volumes. 25Aug14 VEHSCANx. New fields added for dumping. 21Aug14 VEHAUDIT. RPTSCRONLY will now only report scratched volumes that are waiting for DELETEEXPIRED to occur. If it has been scratched and erased (deleted) it won't be reported. This allows you to see how much space is occupied in cache by scratched, not deleted volumes. NOSCRATCH will report the volume in cache until it is deleted. 20Aug14 VEHAUDIT. Fix RPTSCRONLY not reporting just scratches. 14Aug14 TVCBYDSN. Fix high order truncation of MB size in cache. 14Aug14 VEHAUDIT. Fix high order truncation of BVIR_MBSIZE. 12Mar14 TVCBYDSN. Add parm for SELEXP=PASTEXP to allow reporting just lvols in TVC that are expired. 12Mar14 VEHSTATS. Fix H33GRID MB and LVOLS copied by RUN, DEF, & SYNC were reversed. Now correct. 10Mar14 AMATERSE. Replace TRSMAIN with AMATERSE. 02Mar14 HPDMTOT. Ignore Client file records. 01Mar14 HPDMTOT. Update comments to indicate must be no carriage control. 24Feb14 VEHAUDIT. More comments about using DSN=NULLFILE. 19Feb14 VESYNC. Added sort field to have TOSYNC come out in volser sequence if NOTMC used. 19Feb14 VESYNC. Allow selection filtering by STOREGROUP. If R3.0+, SGNAME in MESFILE is used, else value in tape catalog if available. 18Feb14 FORMCATS. RMM extract data for volumes opened just before midnight and closed after midnight had the VOL & DSN records in the wrong order so data sets didn't show up in VOLLIST with SHOWDSN parameter. 14Feb14 FORMCATS. Previous TMCATLG sequence was original tapecat id number then volser sequence. If multiple tapecats were processed and there were duplicate volsers because obsolete ranges hadn't been deleted and you told BATMAGIC to delete duplicates, the analyst had to know which tapecats to read in first because BM kept the last occurance. Now, the TMCATLG sequence is volser, then create date so BM will keep the most recently created volumes. Obsoletes will be dropped. Re-run J1COLECT to get the revised sequence. Reading the previous TMCATLG to create a new one will create the proper sequence. 14Feb14 VOLLIST. Only count VOL records as duplicates if SHOWDSN used. 12Feb14 VOLLIST. Fixed date headings if EURO or MMDDYY format was requested. 12Feb14 SYNCDOC. Updated to indicate that COPYRFSH is an alternative for PRESTAGE so host mounts are not needed. 11Feb14 VEHAUDIT. New parms to select, by cluster, just lvols in TVC that do not have a copy on a pvol. 11Feb14 VOLLIST. SIDS SEEN was duplicating 4 values on second line. 09Feb14 VEHAUDIT. Allow scratch category to be set by SCRCAT if no TMC data. 06Feb14 VEHSTATS. Don't allow REPORT=HRS and QTR at same time. 05Feb14 TVCBYDSN. New MISMATCHONLY filter to compare CRTDATE to INTVC_DATE. 31Jan14 VEHSTATS. New stats for R3.1. H30TVC1 & G33GRID lrecl changed. 29Jan14 HPDMTOT. New tool to total ExHPDM used blocks and calculate total GB required to hold these files. 28Jan14 CBM4PC. New LICENSE.INI value TAPE=(01FEB2015,98715F08,2BCF5C5B) 27Jan14 BATMAGIC. New LICENSE value TAPE=(01FEB2015,98715F08,2BCF5C5B) license.ini for CBM4PC.EXE 24Jan14 TVCBYDSN. Added highest TMC date seen to total line for validation. 21Jan14 TVCBYDSN. IN_TVC DATE on reports off by 1 day in 2013. 20Jan14 BATMAGIC. R7.7.1 correction for R3.1 TS7740 sustained throughput. 06Jan14 VEPSTATS. Allow reporting up to 496 logical devices for R3.2. now. 06Jan14 EXPIRE. New value EXPIRE=08JAN2015 2352656 ; JCL lib updated now. 26Dec13 BATMAGIC. R7.7.0 updates for R3.0 & R3.1 throughputs. 25Nov13 VEHSTATS. Fix RMT RD & WR on HRS reports wasn't the sum of the four individual QTR values. It was always larger than the sum. 22Nov13 VEHSTATS. Fix HOURFLOW reported serial. Fix H32GUPnn MB_WR truncation if >999999 per interval (HRS or QTR). 14Nov13 VEHAUDIT. Fix S0C4 abend with R3.1 MESFILE(s). 14Nov13 BVIRPRPT. Fix S0C4 abend when record overran defined storage area. 13Nov13 PRESTAGE. Don't build recalls for backup copies of lvols. 13Nov13 BVIRPRPT. Re-linkedit to make authorized (AC=1). 12Nov13 BVIRPRPT. Provide UTCMINUS & UTCPLUS logic for date/time stamps. 06Nov13 VEHSTATS. Fix Tot_Mnts should not have been counting Sync mounts as additional mounts. They are a mount option. 05Nov13 BATMAGIC. R7.6.6 to correct balanced workloads. 02Nov13 VTSSTATS. Add WTO about IGNORETIME parm if host & LM clocks are off. 25Oct13 VEHSTATS. Fix debug code that caused S0C4 abend. 07Oct13 EXPIRE. New value EXPIRE=08OCT2014 83435082 ; JCL lib updated now. 03Oct13 LASTLIST. Correct missing semi colon that caused parm error on GRPDSN. 02Oct13 VEHSTATS. Change H30TVC1 Util heading from <--R3.0 PGA--> to __>R3.0.0062__ to clarify when the values became available. 26Sep13 BVIR jobs. Made all two job members so they would work for JES2/JES3. 25Sep13 SMFVSTMC. Flag volumes doing DISP=MOD and also MFMV volumes. 25Sep13 VOLLIST. Acum_GB column on VOLCRT.BYCRT was being truncated. 25Sep13 VEHSTATS. New HRSDATE= and HREDATE= range to limit HOURFLAT to a sub- set of the entire interval days for Jim Fisher's spread sheets. 24Sep13 FORMCATS, SMFVSTMC. Removed compressed MB calculation for ARCCTL in CA1 tape catalog. Found that first data written to HMIGTAPE volumes determined the compression percent and it wasn't updated if more data was MODed on later. Compressed bytes is now 0 so Batch Magic will calculate compressed volume size based on total SMF compressed size for the WORKLOAD. 19Sep13 VEHAUDIT. MC, SC, SG, DG names with R3.1 were a bit messed up. 19Sep13 VEHAUDIT. LVOLs smaller than 10000 bytes were not reported on DTLRPT. 19Sep13 TAPEWISE. DSNRPT & DSNFILE were not being created when requested. 17Sep13 VEHSTATS. Fix HOURFLAT CLn_Rmt_Rd_MiB. Using the USEGB parm was mistakenly changing it to CLn_RmtRdMiB/s. Same for CLn_Rmt_Wr_MiB. 16Sep13 VEHSTATS. Modify H20VIRT heading from MAX_THRPUT to MAX_THRPUT R2.2 to indicate what release started supplying the value. 07Sep13 FORMCATS. Test CA1 COMPRESS% field to be sure it is less than 100 before using it to calculate compressed data set size. Bad data. 07Sep13 VOLLIST. Add COMP_MB column to SUMRPT for RMM, CA1, Control-T. 07Sep13 FORMCATS. Change compressed MB size calculation for CA1 so TMCATLG file can be read into VOLLIST, J2SMFTMC, etc without trying to recalculate and messing up the compressed MB since the field had already been calculated. 06Sep13 TapeWise. Updated 3590ERROR parm to indicate it is used for 3592 also. 06Sep13 BVIR jobs. Block final output files from BVIRPHY, BVIRMES, & BVIRVTS to conserve space. BVIRHST & BVIRPIT files must remain RECFM=U. 04Sep13 TapeWise. SYSRPT footer legend now shows up to 40. Had been 12. 04Sep13 SMFILTER. Modified to do WTO for up to 32 SYSIDs seen. Had been 24. 04Sep13 VEHSTATS. Several reports had x'00' in unused areas instead of space which messed up line control for PC browser. z/OS had no problem. 04Sep13 TapeWise. Fix TGROUP was truncated to 7 characters in #IORPT headings. 03Sep13 VEHAUDIT. Change comment about needing to activate //TMCATLG DD as DSN=NULLFILE if don't have any tape catalog data as input. 03Sep13 VEHSTATS. More elaboration on some wording for previous VEHSTATS going updates back to 19Apr13. 21Aug13 SMFVSTMC. Picked up create time as an added check to see that TMC and SMF are reporting the same volume data. 21Aug13 FORMCATS. Picked up compressed volume size from CA1 TMC so now CA1, Control-T, and RMM report compressed volume bytes that BM uses. 20Aug13 VEHSTATS. Elaborated on some wording for previous VEHSTATS updates going back to 19Apr13. 15Aug13 VOLLIST. Changed REPORT= parm to not request LRF with initial run since it needs the BDATE=DDMONYYYY which is reported on VOLLIST detail from first run. 14Aug13 VEHAUDIT. DTLRPT CMP_PCT now shows as ???? if calc value >9999. 13Aug13 VEHAUDIT. DTLRPT CMP_PCT high order truncated. 09Aug13 ORDER6CL&V12. Added Throughput Delay sec at end of HOURFLAT. 09Aug13 $$TAILOR. Updated for new USERHLQT=USERID parm. 08Aug13 All JCL creating tape files. Added USERHLQT for customers doing allocation based on dsname rather than UNIT. Should not affect any other users so no changed needed unless you want to use USERHLQT to allocate to a different device than USERHLQ does. 08Aug13 VEHSTATS. For REPORT=GRID, 4HR_Avg_Min, 48HR_Avg_Min, & 35DA_Avg_Min had been reporting the minimum minutes value, but now it is showing max on the flat files. 02Aug13 ORDER6CL. Delete duplicate Avg CPU Util. 02Aug13 MAXRECALL. Document that limit is 65535. 02Aug13 VEHSTATS. Restore EOI_MiB_to_CPY, MAX_MiB_to_CPY, EOI_MiB-to_MIG, MAX_MiB-to_MIG to DAYHSMRY since a previous change dropped them from ORDER6CL. 30Jul13 ISSUECMD. Add JCL sample for tool to issue MVS commands from SYSIN. 29Jul13 VOLLIST. Fixed a few bad records in CRTRPT & LRFRPT w/SORTSEQ=TOTAL. 29Jul13 TMCREUSE. Change comment about EDATE value to use. 29Jul13 VOLLIST. Change column heading presentation on LRFRPT. 0 - 30 31 - 90 91 - 180 181 - 365 366 -1095 26Jul13 VOLLIST. Force BDATE= required if LRFRPT requested. 25Jul13 VEHSTATS. Fix MONSMRY POOL Media Type was wrong if multiple types were defined, but only one was actually used. 24Jul13 VOLLIST. New LRFRPT - LastRef days ago by pgmname. 22Jul13 TCDBMCH. New parm - IGNORENOTMC. 19Jul13 TCDBMCH. New parms - INCVOL, EXCVOL, NOSCRATCH. 19Jul13 VEHAUDIT. On DTLRPT, don't show removal policy unless lvol in TVC. 15Jul13 BATMAGIC. R7.6.5 which is now 64 bit to process larger SMF files. 15Jul13 VEHSTATS. Fix so all references to Active_GB show the same 1000MiB value which corresponds with how TVC size is reported & sold. Previous GB calculation was MiB/1024 to give GiB. 12Jul13 VTSSTATS. New IGNORETIME parm to process SMF94 records even if the host & Lib Mgr times are > 30 minutes different. Otherwise, ABEND U=0024. 10Jul13 BATMAGIC. Fix MEDIA= ETC_500JK should be MEDIA= ETC_500. 09Jul13 FORMCATS. Fix missing MCNAME for CA1 TMC single file volumes. 08Jul13 VEHSTATS. Changed R3.0 PGA1 to R3.0.0063 on H20VIRT THRPUT_DELAY. 08Jul13 EXPIRE. New value EXPIRE=08JUL2014 56440314 ; JCL lib updated now. 27Jun13 BATMAGIC. Change example SIZE=441 to SIZE=408 for DS3K in VH772n4n. 27Jun13 VEHSTATS. Added notation to H20VIRT to indicate that THROUGHPUT DELAY became available in R3.0 PGA1. 23Jun13 FORMCATS, VOLLIST. After May 30 change for VEHSTATS, if DATEFORM=J was used, then K_BIRTH was also set ON which caused volume birth date to be used instead of data set create date for volumes. 12Jun13 VEHAUDIT. Fix which lvols get reported to MLTCPY and TOSYNC files. Added comments to JCL defining what is in MLTCPY, STALE, & TOSYNC. 11JUN13 ORDERALL. Replace ' CACHE TOT MBS' with ' TOT TVC MIB/S' to restore missing field. 10JUN13 ORDERALL. Updated with some missing new fields put in ORDERV12. 10JUN13 VEHAUDIT. Report MC, SC, SG, DC values from R3.0 BVIR VOLUME STATUS. 07JUN13 VEHAUDIT. COPYTIME=HH:MM:SS ONLY REPORT LONGER COPY TIMES (00<=HH<=99) Also, fix copy time truncation if > 99 hours. 05Jun13 VEHSTATS. Fix UTC_OFFSET reported in DAYHSMRY flat file. Garbage value was initially reported. 05Jun13 VEHSTATS. COMPARE & MONSMRY - change Days w/Activity to Host Use Days. Previously was counting every day that had a statistics record. Now counting days that had host activity. 30May13 VEHSTATS. New DATEFORM for flat files to allow user to pick format as J=JULIAN, A=AMERICAN, E=EUROPEAN, OR I=ISO. 30May13 VEHAUDIT. Parm, NOSCRATCH, didn't eliminate all SCRATCH from DTLRPT. 27May13 VEPSTATS & VEPSCAN. Report new fields for R3.1. 23May13 J2SMFTMC. Drop scratch volumes in TMCATLG. Caused size difference. 23May13 J2SMFTMC. Made sure CUA and CRTDATE were equal for matched volsers so you can now look at the data for the entire SMF interval compared to the TMCATLG volume that are still active. 21May13 VEHSTATS. Put cache data transfer fields on DAYHSMRY flat file as: Cache_TotMiB/s, To_TVC_Dev_Wr, Fr_TVC_Dev_Rd, To_TVC_By_Cpy, 13May13 Fr_TVC_By_Cpy, To_TVC_Recall, Fr_TVC_PreMig 13May13 VESYNC. Don't select MES_FLG = M unless lvol is inconsistent. 13May13 FORMCATS. Fix S0C7/S0C9 with RMMEXTR trying to pick up compressed volume bytes from older versions where the field didn't exist. 10May13 VESYNC. New SCRCAT control parm to ignore scratch vols if no TMC. 10May13 PRESTAGE. Add SMSHONOR parameter if UNIT=/nnnn specified. 06May13 VEHSTATS. R3.0.063 report separate fields for CPU & Disk utilization. 06May13 FORMCATS. Re-fix volume MB for ControlM-T tape catalog data. 02May13 VOLLIST. SRTSEQ=CREATE now creates rpt in crdate, fstvol, volseq. 01May13 VOLLIST. Include SIDS SEEN on SUMRPT. 29Apr13 VTSSTATS. Fix PTP reporting if one VTC is taken offline. 28Apr13 BATMAGIC. R7.6.4 maintenance to reduce memory usage. 26Apr13 VEHSTATS. Fixed H20VIRT MAX_THRPUT reporting for micro code R2.2. Value of 0 before R2.2 meant reporting not available (na). Starting with R2.2 a value of 0 means MAX throughput available. 20Apr13 VEHSTATS. Add Max_Clus_Util to H30TVC1 and HOURFLAT. 19Apr13 VEHSTATS. Add THROUGHPUT DELAY Microsecs to H20VIRT report. This is the time delay that was used to limit the throughput so it doesn't exceed the configured maximum throughput. 18Apr13 BATMAGIC. R7.6.3 fixed for NOTMS='DUMMY,' failed. 17Apr13 SMFILTER. Display (WTO) SYSIDs seen in SMF data. 12Apr13 BATMAGIC. R7.6.3 maintenance release. 11Apr13 SMFVSTMC. Add LINES=9999 logic. Allow just matches with size difference greater than nn to be reported. 09Apr13 EXPIRE. New value EXPIRE=08APR2014 28945280 ; JCL lib updated now. 05Apr13 SMFVSTMC. Add MATCHONLY parm and fix run totals. 03Apr13 SMFVSTMC. Now named J2SMFTMC. Fixed date/time for missing 21s. 02Apr13 SMFVSTMC. Added filters for job, pgm, dsn, etc. 29Mar13 SMFVSTMC. New tool to compare TMC volume size to SMF 21 written size. 28Mar13 TVCBYDSN. Show .01 rather than .00 for data sets less than 9999 bytes. 19Mar13 PRESTAGE. Fix not generating recall jobs. 17Mar13 VOLLIST. Fix S0C9 with RMM extract file. 17Mar13 FORMCATS. INCVOL= nnnnnn xxxxxx; each value must be 1-6 chars. 15Mar13 FORMCATS. Close SYSPRINT before abend to allow reason message to be displayed. 14Mar13 VOLLIST. Correct S0C7 abend with SORTSEQ=TOTAL. 13Mar13 VOLLIST. BYCRT wasn't accumulating GB if USEGB parm was active. 13Mar13 ORPHANS. Was showing too many data sets because DAYSAGO wasn't being picked properly after recent parameter control block update. 08Mar13 VOLLIST. Added COMP/VOL_MB column to DTLRPT. Currently, only RMM & Control-M/Tape are reporting compressed volume MB. As I find the value for the other tape catalogs, I will add them. 08Mar13 BATMAGIC. R7.6.2 maintenance release. 07Mar13 VEHSTATS. Put UTC offset specified in HOURFLAT. 05Mar13 VOLLIST. Have BYCREATE report descending. Most recent to oldest. 05Mar13 FORMCATS. Fix volume MB for ControlM-T tape catalog data. 04Mar13 FORMCATS. Fix S0C7 with RMM extract in VOLLIST, etc. 28Feb13 VEHSTATS. Add Max CPU, Agv Disk, Max Disk Util to HOURFLOW. 27Feb13 VEHSTATS. Cache Xfer fields added at end of ORDERV12. 27Feb13 VEHSTATS. Fixed HOURFLOW GRID= if multiple grids reported at once. 26Feb13 VOLLIST. Fixed LINES=9999 messed up spacing for LINES=65500; 24Feb13 VEHAUDIT. New SEQ=OWNER (owning cluster) is now available. 22Feb13 VEHSTATS. H30TVC1 has separate CPU & Disk utilizations w/R3.0 PGA. LRECL & BLKSIZE changed to get entire report line. 21Feb13 VOLLIST. Fix when both TMCATLG and original tape catalog are read in at the same time creating duplicate records. 21Feb13 VOLLIST. Fix Control-M/Tape issue with ADRDSSU volume size reporting. 15Feb13 LICENSE. Update LICENSE member used by BMPACKT & BMPACKS. 11Feb13 VOLLIST. New REPORT=CRT showing estimate of Copy Export pvols needed. User needs to filter by CE workload. 09Feb13 VEHAUDIT. Provide way of identifying lvols with only 1 copy. 06Feb13 VOLLIST. Fix S0C7 with SORTSEQ=TOTAL. 01Feb13 BATMAGIC. New License: TAPE=(01FEB2014,94715F08,264B52D7) 30Jan13 VEHSTATS. Set COMPARE report mount seconds to 0.0 if none. 18Jan13 VEHSTATS. Update COMPARSE module to allow PRIPOOL & SECPOOL parms. 14Jan13 VEHSTATS. Fix FILLR lines on DAYHSMRY if first cluster is NOT CL0. 12Jan13 VEHSTATS. Back to CLIDMSER and logic changes to handle same MSER on multiple clusters. DEFDL required if clusters are not sequential starting with 0. New ORDERC25 for grid with four clusters (2,3,4,5). 08Jan13 VEHAUDIT. Add comments about using BLKSIZE control parm. 07Jan13 VEHSTATS. Change flat file heading from CLIDMSER to CLIDDLSN. Value was changed a while back to accommodate user grid with same serial number on multiple clusters. Now headings match the data. 07Jan13 EXPIRE. New value EXPIRE=08JAN2014 2351520 ; JCL lib updated now. 26Dec12 BATMAGIC. Maintenance release 7.6.0. 11Dec12 VEHAUDIT. Add CURR_CTGY (current category) value to DTLRPT. Also direct DTLRPT to disk file rather than sysout. LRECL changed. 11Dec12 VEHSTATS. Fix S002-5C abend caused by exceeding GETMAIN area. 06Dec12 VEHSTATS. Do WTO for each new Grid/Cluster and check for consecutive clusters, otherwise issue message indicating DEFDL needed and abend. 03Dec12 VOLLIST, etc. Fix BLKSIZE example to not use NNNNNN. 03Dec12 EXPDIST. Fix truncation in UNKN GB column. 28Nov12 VEHSTATS. Don't generate 0 record on HOURFLAT if interval is only 1 second late. 26Nov12 VEHSTATS. Don't count secondary pool lvols or MB in Active_LVOLS or GB 26Nov12 VEHSTATS. Fixed MiB_To_TVC_By_Copy value on H33GRID and MiBRecv_By_CLn on flat files. 25Nov12 VOLLIST. Fixed SIZRPT high order GB total truncated. 21Nov12 VOLLIST. Fixed S0C9 with MBBASE=1000; and large volumes. 19Nov12 VEHSTATS. Fixed logic where new R3.0 fields messed up Max_Clus_Util for older releases. 16Nov12 VEHSTATS. Fixed DLSER logic stopped working after DLSN replaced MSER. 14Nov12 VEHSTATS. Fixed 10:00:00 & 20:00:00 appearing twice on all sysout reports plus Hours showing as 26.00 on DAYHSMRY. Bug was introduced with 01Nov12 enhancement. 13Nov12 COPYRFSH. Fix MAXRECALL was only working for 7740 recalls. There was no limit applied to IN CACHE 7720 recalls. Now MAXRECALLS applies to (7740_recalls + 7720_incache). 12Nov12 BATMAGIC. Maintenance release 7.5.10. 06Nov12 VEHSTATS. Fix several reports if clusters have same serial number. 01Nov12 VEHSTATS. Better accumulate and report HRS when there are missing intervals. 12:15:00 & 12:30:00 only will now report as 13:00:00. The HOURFLAT file will fill in missing intervals with 0 values. 23Oct12 BATMAGIC. Maintenance release 7.5.9. 23Oct12 FORMCATS. Issue WTO if active VOL record found without any DSNs. 19Oct12 VEHSTATS. Fix S0C9 in HYDRDSH2 when cluster down part of time. 19Oct12 CPY7680H. Fix S0C7 when missing data field. 12Oct12 FORMCATS. Don't ignore ZARA volumes with STAT_1 value 'E'. 08Oct12 EXPIRE. New value EXPIRE=08OCT2013 83395180 ; JCL lib updated now. 05Oct12 VESYNC. Allow MES flag value M volumes to be identified as needing a peer copy in case MCNAME CCP values hadn't been changed prior to a new cluster being activated. 01Oct12 VEHAUDIT. Show CCP value for inconsistent lvols also. 27Sep12 CHKCOPY. Fix excessive wait if multiple copies requested. Also, add logic to require multiple copies or any copy. 15Sep12 VEHSTATS. Correct Active GB. Was 1000*1000*1024, now 1000*1000*1000. 03Sep12 ORPHANS. Add LASTREF_DATE to DTLRPT. 31Aug12 CHKCOPY. Linkedit with AC=1 to prevent SB78 abend. 29Aug12 FORMPGMS. Ensure both VOL & DSN records are present. If not? Abend. 29Aug12 VEHSTATS. Set LINES=nn to default to 58 if parm omitted. 28Aug12 FORMPGMS. Test LRECL to be sure right files are being read in on DD. 27Aug12 ORPHANS. Added MBBASE control parm and logic. 24Aug12 COPYRFSH. Show where STIMER WAIT is issued between LI commands if commands are actually sent to sysout rather than being issued. 22Aug12 FORMPGMS. Better identify 3592 with TLMS. 20Aug12 STAT7680. Fix reporting same first interval over and over. 20Aug12 CPY7680H. Fix S002-18 abend. 20Aug12 VEHSTATS. Fix so DCThrot is reported as Sec rather than mSec. Temp debug set it to mSec if USEGB was specified. 17Aug12 VEHAUDIT. Added CMP_PCT, MCNAME, LRFDATE, GRIDMB to DTLRPT. //DTLRPT DD SYSOUT=*,DCB=(RECFM=FBA,LRECL=280) //* USE LRECL=218 FOR 2 CLUSTERS, 249 FOR 3 CLUSTERS, 280 FOR 4 //* USE LRECL=311 FOR 5 CLUSTERS, 342 FOR 6, 373 FOR 7, 404 FOR 8 10Aug12 BATMAGIC. Maintenance release 7.5.8. 09Aug12 FORMCATS. Added MC, SG, SC, DC to reformatted tape catalog records so they would be available to any program processing TMCs. 08Aug12 COMPARSE. Have invalid control parm abend rather than set COND CODE. 02Aug12 VEHSTATS. Added SYNC mode mounts at end of ORDERV12 & ORDER6CL 02Aug12 VEHAUDIT. Added OUTCODE to DTLRPT. //DTLRPT DD SYSOUT=*,DCB=(RECFM=FBA,LRECL=251) //* USE LRECL=189 FOR 2 CLUSTERS, 220 FOR 3 CLUSTERS, 251 FOR 4 //* USE LRECL=282 FOR 5 CLUSTERS, 313 FOR 6, 344 FOR 7, 375 FOR 8 01Aug12 VOLLIST. For dup volsers, indicate ACTIVE ONLY or ACTIVE AND SCRATCH. 01Aug12 BVIRPRPT. Identify TS1140 drives. 26Jul12 VEHAUDIT. Fixed match between TMC, MES, CAC, & VOL records and added DEV_ADDR column to DTLRPT. 25Jul12 TAPEWISE. JOBRPT added TCB & SRB CPU utilization if SMF 30s present. 25Jul12 IOSTATS. IOREPORT added TCB & SRB CPU utilization. 23Jul12 VEHSTATS. Change Avg_CPU_Util to Avg_Clus_Util in flat files. 16Jul12 VEHSTATS. Fix S013 abend if COMP or FLOW not requested by VEHSTPO. 09Jul12 EXPIRE. New value EXPIRE=09JUL2013 56738940 ; JCL lib updated now. 06Jul12 FORMCATS. Fix bad blksize values in TLMS catalog for specific customer 05Jul12 COPYRFSH. Allow STORECLASS=NEWSCNM as well as MGMTCLAS=NEWMCNM. 12Jun12 VEHAUDIT. New DTLRPT sequence for overall CCP or creating DLI. 11Jun12 VEHSTATS. If BVIRHSTx stats were pulled for the same period, but from different clusters, they weren't being detected as duplicates. 11Jun12 BVIRHSTx. Updated comments about pulling stats from cluster that has been down for an extended period. 11Jun12 COPYRFSH. Change invalid LIB REQ command to LI REQ. 08Jun12 VEHAUDIT. New option, SEQ=CCP, totals GB by CCP value. 01Jun12 VEHSTxx. Set USEGB as the default for the HOURFLOW report. 29May12 FORMCATS. Fix DATEFORM=I not catching really should be =A. 25May12 BATMAGIC. Maintenance release 7.5.7. 23May12 PRESTAGE. Allow multiple mounts to occur concurrently when using a TS7720 as the source for peer copies. 17May12 TapeWise. Test for overflow in SMF 21 MB written field. 14May12 VEHSTATS. Report Data_Res_Cache as base 1000 to agree with TVC size. Also show Active_GB in back-end pools as base 1000 for easier conversion to TS7720 requirement. 11May12 OFFSITE. Fix GB calculation to match VOLLIST. Introduce BASE=1000 parm 09May12 PRESTAGE. New NOPILOT parameter to not generate pilot DD if DAA used. 07May12 VEHSTATS. Don't allow REPORT=GRID & REPORT=FLOW at the same time. 04May12 COMPARSE. Allow INCVOL=A*; to work as designed. Parser was giving an error unless 2 characters were used before *. 03May12 VEHSTATS. New HOURFLOW report showing TVC data transfer. 03May12 VEHSTATS. Report TVC Size as base 1000 as it used to before R2.1. 09Apr12 VEHSTATS. Remove some debug WTO messages. 09Apr12 EXPIRE. New value EXPIRE=09APR2013 29240640 ; JCL lib updated now. 05Apr12 BATMAGIC. Maintenance release 7.5.6. 04Apr12 VEHSTATS. Fix H30TVC1 PG1 GiBToCopyOut high order digit truncation. 28Mar12 BVIRRPT. Limit UNKNOWN MEDIA messages to 10. 21Mar12 ORDERV12. Fixed so old CPU request would also work. 20Mar12 ORDERV12. Both HOURFLAT & DAYHSMRY now have Avg & Max CPU_Util%. 19Mar12 ORDERV12. Added Max & Avg CPU utilization on DAYHSMRY.TXT. 19Mar12 ORDERV12. Added CPU utilization as last field on HOURFLAT.TXT. 18Mar12 MOUNTMON. New ALERT for long drive allocation. See MNTGROUP member. 05Mar12 COPYRFSH. Use delay between issuing LIB REQ commands. 05Mar12 COPYRFSH. Now allows new MCNAME to be set before COPYRFSH issued. 05Mar12 VEHSTATS. H32GUPnn was missing SDE, RDONLY, UNAVAIL counts. 29Feb12 TapeWise. Fix for new SMF 21 MB read & written fields. 28Feb12 BMPACK. Issue error message if output has SB37 and end with CC=99. 20Feb12 VEHSTATS. Fixed missing column headings on H33GRID if current grid ran as stand alone cluster for a few days before becomming a grid. 14Feb12 BVIRPRPT. Change WTO messages to indicate GiB instead of GB. 11Feb12 CPYHIST. Linkedit with AC=1 to prevent S047 abend when writing to SMF. 08Feb12 VOLLIST. Fix size difference for VOL vs DSN records when MBBASE=1000. 07Feb12 FORMCATS. Fix DATEFORM=J failing to detect ISO format dates. 06Feb12 LICENSE. New for BMPACKS & BMPACKT. TAPE=(01FEB2013,90715F08,20C74953) 30Jan12 TAPEWISE. Change RPT headings to indicate mount only counted if opened 25Jan12 UNZIP. Windows 7 users will need to download the four .XMI files instead of the single .EXE file. 19Jan12 CPYHIST. Bad date for 01Jan12 if stats are cut on EXACTLY 00:00:00. Only affected BVIRHSTS which writes to SMF log. 18Jan12 BATMAGIC. Version 7.5.5 new LICENSE. 17Jan12 VEHSTATS. Fix media counts on COMPARE report if input data is a mixture of R2.0.118 and earlier releases and GRID or SHOP used. 09Jan12 EXPIRE. New value EXPIRE=12JAN2013 3517056 ; JCL lib updated now. 04Jan12 FORMCATS. Added identification of TS1140 media types for RMM.