IBM Tivoli Advanced Reporting for DFSMShsm. User s Guide. Version 2 Release 2 SC

Transcription

1 IBM Tivoli Advanced Reporting for DFSMShsm User s Guide Version 2 Release 2 SC

2 Note Before using this information and the products it supports, read the information in Appendix B on page 419. First Edition December 2008 This edition applies to Version 2 Release 2 of IBM Tivoli Advanced Reporting for DFSMShsm and to all subsequent editions and modifications until otherwise indicated in new editions. Copyright Mainstar Software Corporation ii

3 Contents Contents...iii Chapter 1. About this guide...1 What does this guide contain?...1 Acronyms...3 Chapter 2. Installation...5 Installation overview...5 Software requirements...5 Advanced Reporting for DFSMShsm data sets...5 Data set naming conventions...5 Advanced Reporting for DFSMShsm data set descriptions...6 Extended ACS masking characters and your EBCDIC code tables...6 Data supplied as input to either batch programs or ISPF panels...6 Product output...6 Do not change distributed ISPF panels...7 Advanced Reporting for DFSMShsm configuration...8 Step 1: Customize member ARHJMAIN...9 Step 2: Customize PARMLIB member ARHCMD Step 3: APF authorize the SARHLOAD library...9 Step 4: Start the ARHJMAIN task...9 Step 5: Start Advanced Reporting for DFSMShsm...9 Step 6: Complete the Advanced Reporting for DFSMShsm customization.10 ARHCMD00 configuration values...11 Syntax rules...11 ARHCMD00 keyword syntax and descriptions...12 Optional parameters...14 Chapter 3. Advanced Reporting for DFSMShsm overview...25 Concepts and facilities...25 Advanced Reporting for DFSMShsm Advanced Reporting for DFSMShsm classic...27 Extended ACS masking characters and your EBCDIC code tables...31 Specification and display of EBCDIC characters...31 Filtering pattern masks...32 Chapter 4. Using the HSM Host Information reports...35 HSM Host Information report...35 Control Data Sets report...36 Log Data Sets report...37 Active Allocations report...38 Mounted Volumes report...38 MWE Queue Contents report...40 SETSYS Values report...41 Exit Information report...41 ENQ Information report...42 Memory Information report...43 Patches report...43 Automatic Backup Data report...44 Automatic Migrate Data report...44 Automatic Dump Data report...45 Issuing HSM commands...45 Function Return/Reason Codes report...46 Activity Logs report...46 DFSMShsm Functions report...47 Chapter 5. Using the CDS reports...49 HSM Control Data Sets report...50 HSM CDS Users report...50 HSM CDS Backups report...51 Migrated Data Sets report...52 Backup Data Sets report...54 Backup Versions report...55 HSM Backup Data Sets report...56 Tape Data Sets report...57 Dump Data Sets report...58 Migrate Dsns Need Bkup report...59 Migration Volumes report...60 Backup Volumes report...62 Dump Volumes report...63 Dump Versions report...64 Tape Volumes report...65 Tape Copy Needed report...66 ML1 Volume Free Space report...67 Volumes Eligible for Backup report...67 Authorized Users report...68 Dump Classes report...69 Daily Statistics report...70 Daily Function Statistics report...71 Volume Statistics Records report...72 Daily Volume Statistics Function report...73 iii

4 Volume Summary Information report...74 DFSMS Class Summary Information report.75 Chapter 6. Using the storage reports...77 Unit Names report...77 Volume Information report...78 Storage Groups report...79 Chapter 7. Using the DFSMS Information reports...81 SMS Base Configuration report...81 Storage Groups report...82 Storage Classes report...83 Management Classes report...84 Data Classes report...85 Aggregate Groups report...87 SMS Volumes report...88 Class Summary Information report...89 Chapter 8. About the Advanced Reporting for DFSMShsm classic interface...91 Chapter 9. Performing administrative tasks...93 Customizing the processing parameter settings...93 Changing JCL parameter settings...94 Overriding Advanced Reporting for DFSMShsm data set names...94 Creating Advanced Reporting for DFSMShsm files...95 Selecting plans to run in batch mode...97 Building JCL for batch processing...98 Testing user access to HSM commands...99 Listing PARMLIB data set members Listing PLAN data set members Listing COMMAND data set members Chapter 10. Viewing product information..103 Viewing version and release level data Listing data sets used during Advanced Reporting for DFSMShsm processing Listing data sets allocated to the Advanced Reporting for DFSMShsm address space Listing enqueues held by the Advanced Reporting for DFSMShsm address space Displaying address space virtual storage information Displaying product message documentation Displaying product work data set information Displaying RCDS status information Chapter 11. Viewing volume level data Migration Volumes report Backup Volumes report Dump Volumes report Dump Versions report Tape Volumes report Tape Copy Needed report Mounted Volumes report ML1 Volume Free Space report Volume Statistics Records report Daily Volume Statistics report Volumes Eligible for Backup report Primary DASD Volumes report Volume Summary report Chapter 12. Viewing data set level data Displaying migration information Displaying backup information Displaying backup versions information Displaying tape information Displaying dump information Migration Dsns Need Bkup report Migrating a data set to a migration volume 120 Making a backup copy of a data set Recalling a migrated data set Recovering a backed up data set Deleting a migrated data set Deleting a backup copy of a data set Listing catalog data for a data set Deleting a data set from DASD Browsing a data set Viewing a data set Editing a data set Chapter 13. Using the Health reports SMS/HSM Mounted Volume reports HSM Migration reports HSM Backup reports HSM Volume Dump reports Storage Group Summary report Section II Using the Advanced Reporting for DFSMShsm Classic Interface Chapter 14. The Command Processor Commands overview Issue commands for individual table entries Deleting a table entry permanently TAG and UNTAG commands for an entire table RUN and BATCH commands for tagged items iv

5 Save and retrieve or re-execute commands Using the Line Command Processor feature Line command L from the filtered view panel PF7 from the LineCmds pop-up panel PF6 from the LineCmds pop-up panel PF5 from the LineCmds pop-up panel TAG and UNTAG commands on a filtered view panel BATCH command on a filtered view panel RUN command Chapter 15. PC extension for the Daily Statistics Record Install the Daily Statistics Record programs on the mainframe Install the Daily Statistics Record program on the PC Processing the ARHHSMutils.xla add-in The DSR record Field names The DSR record charts Chapter 16. The Format and Save feature 157 Overview of Format and Save Symbolics and constants Header and trailer formats The FORMAT OPTIONS command Format Interactively Format batch Format JCL Chapter 17. Data set recovery Chapter 18. Processing migration/backup log file data Generate a view of the migration/backup information Filter the migration/backup data Migrate/backup filter fields Filter arguments Filter example TOTAL, SAVE, PRINT, or SORT the filtered migration/backup data TOTAL facility SAVE and PRINT facilities SORT facility Create a plan Internal labels for plan categories Exercise a plan List and retrieve plan execution results..197 Chapter 19. Advanced Reporting for DFSMShsm support activities Generate Master Display Last Master Chapter 20. Online batch process Select online plans for batch Batch JCL build Chapter 21. Control data set reports MCDS Information MCDS SMS summary MCDS migration volume summary MCDS DSNAME search panel MCDS filter panel MCDS detail panels Display MCDS plans Display MCDS files BCDS Information BCDS SMS summary panel BCDS backup volume summary panel BCDS DSNAME search panel BCDS filter panel BCDS detail panel Display BCDS plans Display BCDS files OCDS Information OCDS inventory options OCDS filter panel Display OCDS plans Display OCDS files Chapter 22. HSM health reports How health reports work HSM health reports About the HSM health reports database HSM health SMS/HSM mounted volume report HSM health migration reports HSM health backup reports HSM volume dump reports HSM storage group summary reports Chapter 23. Volume dump information Dump class information Dump volume information View volume dump summary information Filter volume dump detail Display dump volume detail plans Dump tape information Dump volume tape filter option Display volume dump tape plans Display dump tape sequential files v

6 Dump volume DSName processing Dump volume DSName filter option Display volume dump DSName plans Display volume dump DSName sequential files Chapter 24. Log file reports Migration/backup options Migration return code summary ML1 to ML2 return code summary Backup return code summary Migration/backup filter Display migration/backup plans Display migration/backup filtered flat files Recall/recovery options Recall return code summary Recover return code summary Filter options for recall/recover Display recall/recover plans Display recall/recover filtered flat files Extent reduction summary Recycle return code summary Recycle activity panel Recycle detail Log message summary Log file message summary Browse all messages Summarize by DFSMShsm functions Log file messages filter options Tape usage summary Return code reason code tables Backup return codes Backup reason codes Daily space manager Appendix A. Messages Messages for Advanced Reporting for DFSMShsm Appendix B. Notices Trademarks Appendix C. Using the Advanced Reporting for DFSMShsm interfaces About the ISPF interface ISPF scroller commands SAVE command FORMAT command About the FORMAT command member About the console interface Using the Advanced Reporting for DFSMShsm API API members and parameters Using non-ispf methods to invoke the API API report generation parameters Index vi

7 Chapter 1. About this guide The primary audience for this User s Guide is the software installer and the IT applications groups. This document might also be of interest to Storage Administrators and System Programmers responsible for performing, managing, and monitoring catalog backup and maintenance functions. What does this guide contain? This guide provides the necessary information and instructions to successfully use Advanced Reporting for DFSMShsm. This first section of this guide contains the following chapters: Chapter 1, About this guide, describes the guide s contents and organization and explains documentation conventions used throughout the guide. Chapter 2, Installation, provides instructions for installing and configuring Advanced Reporting for DFSMShsm. Chapter 3, Advanced Reporting for DFSMShsm overview, provides an overview of the design, functionality, and operational requirements for Advanced Reporting for DFSMShsm. Chapter 4, Using the HSM Host Information reports, describes the reports available for displaying detailed information about your site s DFSMShsm hosts, including which hosts are active on a system, which control data sets and ARCLOG data sets are being used by DFSMShsm, which volumes are being used in DFSMShsm processing, enqueues being held by DFSMShsm, exits being used by DFSMShsm, and so on. Chapter 5, Using the CDS reports, describes the reports available for displaying detailed information about the backup, migration, and offline control data sets used by DFSMShsm to store status information about the data sets under its control. Chapter 6, Using the storage reports, describes the reports available for displaying detailed storage information, such as the units available to a system, volume information, and storage group information. Chapter 7, Using the DFSMS Information reports, describes the reports available for displaying SMS configuration information, and storage group, storage class, management class, data class, aggregate group attribute information, and SMS volume information for the system. 1

8 Chapter 8, About the Advanced Reporting for DFSMShsm classic interface, explains where you can find information about using the classic interface provided by previous versions of Advanced Reporting for DFSMShsm. Chapter 9, Performing administrative tasks, describes the commands available for managing Advanced Reporting for DFSMShsm, including customization of processing parameters, managing batch processing plans, generating JCL for batch processes, testing user access to HSM commands, and browsing member lists for the PARMLIB and plan data sets. Chapter 10, Viewing product information, tells you how to access product version and release level information, list the data sets used by Advanced Reporting for DFSMShsm during processing, list the data sets allocated to the Advanced Reporting for DFSMShsm address space, list the enqueues being held by the product address space, and the virtual storage being used by the product address space. Chapter 11, Viewing volume level data, describes how to display and manipulate backup and migration volume information, version information for volumes with full volume dumps, tape volume information, free space information for migration level 1 volumes, and primary DASD volume information. Chapter 12, Viewing data set level data, describes how to display and manipulate information for data sets residing on a migration volume, display data set backup information, display information about data sets residing on a tape volume, and list catalog information for a data set. You can also use these commands to migrate a data set from DASD to a migration volume, create a backup copy of a data set, recall a migrated data set to primary DASD, recover a backup copy of a data set, delete a data set residing on a primary or migration volume, and browse, view, or edit the contents of a partitioned or physical sequential data set. Chapter 13, Using the Health reports, describes the reports available for displaying DFSMShsm or SMS information about the volumes mounted on the system. The second section of this guide contains the chapters relevant to users of the Advanced Reporting for DFSMShsm classic interface: Chapter 14, The Command Processor, describes the interface to TSO command processing that allows you to invoke actions using the data elements in the various Dialog Manager Table entries, and to format data elements into batch control statements. Collectively, this functionality is referred to as the Command Processor. Chapter 15, PC extension for the Daily Statistics Record, provides examples of usage and functionality of the PC Extension, which allows data from the Daily Statistics Record to be placed into spreadsheets. Chapter 16. The Format and Save feature, discusses the Format and Save feature, giving examples of usage and functionality. 2 User s Guide

9 Chapter 17, Data set recovery, discusses how to display a list of backup generations of a data set requiring recovery. Chapter 18, Processing migration/backup log file data, demonstrates the extended facilities of Advanced Reporting for DFSMShsm, using Migration/Backup data extracted from HSM LOGY. Chapter 19, Advanced Reporting for DFSMShsm support activities, contains an overview of the main menu s Display Last Master and Generate Master options. Chapter 20, Online batch process, explains the Batch JCL Builds for Onlines option and the Select Online Plans for Batch option from the main menu s Batch Processing section. Chapter 21, Control data set reports, provides detail about the MCDS information, BCDS information, and OCDS information options from the main menu s Reports From The Control Data Sets section. Chapter 22, HSM health reports, provides an overview of the Health reports function and discusses the main menu s HSM Health Reports option. Chapter 23, Volume dump information, discusses the main menu s Volume Dump Information option. Chapter 24, Log file reports, provides detail on the main menu s Reports From the Log File options. The appendices contain reference material. Acronyms ARH Product acronym for Advanced Reporting for DFSMShsm Chapter 1. About this guide 3

10 4 User s Guide

11 Chapter 2. Installation Installation overview This chapter contains the following information: An overview of product distribution, product files, configuration activities, and authorization requirements you will use to install and apply maintenance for Advanced Reporting for DFSMShsm Instructions for configuring Advanced Reporting for DFSMShsm for your site ARHCMD00 configuration values This section provides the software and authorization requirements and product distribution information for Advanced Reporting for DFSMShsm. Software requirements Advanced Reporting for DFSMShsm requires the following software levels: z/os V1R6, V1R7, V1R8, V1R9, or V1R10 DFSMShsm running on z/os Advanced Reporting for DFSMShsm data sets Product data sets are created by modifying, and then executing, the install JCL. Some additional data sets might need to be created during product configuration. Data set naming conventions You can choose any high level qualifier names for the Advanced Reporting for DFSMShsm product data sets during installation. You will also supply that hlq name to the batch procedure JCL members contained in the sample library in a later step in the installation procedure. Note: Consider keeping intact the data sets created during product installation. These original data sets can then serve as backups, should the renamed data sets become lost or corrupted. 5

12 Advanced Reporting for DFSMShsm data set descriptions hlq.sarhcmds This library contains the logic for Advanced Reporting for DFSMShsm to issue and interface HSM commands with the product. hlq.sarhplns This library contains the predefined and user defined filters for gathering information in the product. Extended ACS masking characters and your EBCDIC code tables Most Advanced Reporting for DFSMShsm commands allow BCS, VVDS, data set and volume specification using filtering masks. Any of these filtering pattern entries can be specified with the extended ACS masking characters whose usage is described in this section. Data supplied as input to either batch programs or ISPF panels For product code shipped in binary, when specifying input where the product takes special action based on specific characters, the user is responsible for entering the EBCDIC character peculiar to their code tables that results in the binary value for the EBCDIC character shown in this document according to the U.S.A. EBCDIC code set. For instance, if an exclamation mark (! ) is called for, and your code tables do not translate the! character to a hexadecimal 5A, you must enter the character that will translate to a 5A. Product output Depictions of product output shown in the product manuals are based on the U.S.A. EBCDIC code set. Actual output might vary if your EBCDIC code tables are different. 6 User s Guide

13 Do not change distributed ISPF panels Other programs might reference ISPF panel attribute bytes. A panel change involving an attribute byte will not be consistent with the program code. Mask * (Single) He x 5C Description Can be used before and/or after an item to designate a wild-card character position. Consider the following example: *PROD an item is selected if the last four character end in PROD regardless of the starting characters. Using the * character before and after an item (*ZREM*) means that item is to be selected if any character string matches ZREM in its name. Note: You can not use an * in the middle portion of a single item (except for data set names). Use the % character (see below) for that purpose. % 6C Denotes a single character place-holder value, which can be alphanumeric or any special character. The % character can be used in any position order. Consider the following example: CRM%%ER6 an item is to be selected if it is 8-characters in length and the first three characters are CRM and the last three characters are ER6. The two middle placeholder values can be any characters. < 4C Similar to the % value, the < character denotes a place-holder value for only alpha characters. The < character can be used in any position order. Consider the following example: CR<<ER* an item is to be selected if the first two characters are CR, the 3 rd and 4 th characters must be alpha, the 5 th and 6 th characters are ER, and any remaining characters allowed. > 6E Similar to the % value, the > character denotes a place-holder value for only numeric characters. The > character can be used in any position order. Consider the following example: CR>>ER* an item is to be selected if the first two characters are CR, the 3 rd and 4 th characters must be numeric, the 5 th and 6 th characters are ER, with any remaining characters allowed. Chapter 2. Installation 7

14 Mask He x Description 4F Denotes a multiple character place-holder value for alphanumeric characters. The character can be used only in the final position of the mask to represent any number of alphanumeric characters. Consider the following example: ARH.PROD1017. An item is to be selected if the first three characers are ARH, followed by a period (. ), followed by the characters PROD1017, followed by a period (. ), followed by one or more alphanumeric characters. Note: The Advanced Reporting for DFSMShsm classic interface does not support the use of this masking character. ** (Double ) 5C5 C Allows compatibility with standard ACS and DFSMSdss filtering masks. Only used for partially qualified data set names. The * or ** characters can be used in any qualifier position to denote a wild-card node. Consider the following example: CRFM*.*VER.** a data set entry is to be selected if it has at least two qualifiers and the 1 st qualifier starts with CRFM, the 2 nd qualifier must end with VER, and any remaining qualifiers. Note: As with common data set name masking, any combination of *, **, %, < and/or > characters can be used for the item mask value.! 5A Similar to the % value, the! character denotes a place-holder value for only national characters. The! character can be used in any position order. National characters # $ Advanced Reporting for DFSMShsm configuration This section provides instructions for configuring Advanced Reporting for DFSMShsm. The following table summarizes the installation process. Step Description Where to find instructions 1 Customize member ARHJMAIN. Page 9 2 Customize PARMLIB member ARHCMD00. Page 9 3 APF authorize the SARHLOAD library. Page 9 4 Start the ARHJMAIN task. Page 9 5 Use CLIST ARHSTART to enter Advanced Reporting for DFSMShsm. 6 Complete the customization by using the Customization Menu. Page 9 Page 10 8 User s Guide

15 Step 1: Customize member ARHJMAIN To customize the sample library member ARHJMAIN: 1. Change the STEPLIB to point to the library that contains the ARH modules. 2. Change the PARMLIB to point to the library that will contain the Advanced Reporting for DFSMShsm parameter members. 3. Add the new JCL to a system PROC library. This JCL can also be run as a batch job, but it is recommended that you run it as a started task. 4. Follow the instructions in Step 2: Customize PARMLIB member ARHCMD00 to continue the configuration. Step 2: Customize PARMLIB member ARHCMD00 To customize PARMLIB member ARHCMD00: 1. Change the data sets listed in the member to point to appropriate Advanced Reporting for DFSMShsm libraries. 2. Change the job card lines to something appropriate for your site. Note: See ARHCMD00 configuration values for a complete list of available parameters. 3. Follow the instructions in Step 3: APF Authorize the SARHLOAD library to continue the configuration. Step 3: APF authorize the SARHLOAD library After you have completed steps 1 and 2, add the SARHLOAD library to the APF library list. Then continue the configuration by following the instructions in Step 4: Start the ARHJMAIN task. Step 4: Start the ARHJMAIN task After you have completed steps 1, 2, and 3, start task ARHJMAIN on every system on which users will access Advanced Reporting for DFSMShsm. Note: You do not need to start ARHJMAIN on systems where Advanced Reporting for DFSMShsm will not be run. Step 5: Start Advanced Reporting for DFSMShsm After you have completed steps 1 4, the ARHJMAIN task should be started and active on the systems from which Advanced Reporting for DFSMShsm will be accessed. On each system where ARHJMAIN is started, invoke the SARHCLST library s ARHSTART member to display Advanced Reporting for DFSMShsm s main panel. Chapter 2. Installation 9

16 MAINMENU IBM Tivoli Advanced Reporting for DFSMShsm V2R :48 Command ===> Scroll ===> PAGE Main Menu: Row 1 of 11 Report Name Description 1 HSM Host Information Information on DFSMShsm Hosts 2 Reports From the CDSs Reports from DFSMShsm Control Data Sets 3 Storage Reports Reports on System Storage 4 DFSMS Information Information about DFSMS 5 Classic Reports Classic Reporting Data 6 Administrative Tasks Administrative Functions 7 Product Information Product Information 8 Volume Level Data Volume Level Information 9 Data Set Level Data Data Set Level Information 10 Health Reports Reports on DFSMShsm health Note: You do not need to add the Advanced Reporting for DFSMShsm SARHCLST library to any TSO concatenations. Step 6: Complete the Advanced Reporting for DFSMShsm customization After you have completed steps 1 5, you can finish the customization process by following the instructions provided by the product itself. To complete the customization, perform these steps: 1. Select the Administrative Tasks option from the main menu to display the Administrative Menu panel. 2. Select the Customization option from the Administrative Menu to display the Customization Menu panel. 3. Select the JCL Parameters option from the Customization Menu to display the JCLPARMS panel. 4. On the JCLPARMS panel, make the appropriate specifications for your site, the save your specifications. 5. Use the END function key to display the Customization Menu panel. If you plan to use Advanced Reporting for DFSMShsm V2.2 to generate reports, configuration is complete; otherwise, if you plan to use the classic interface to generate reports, continue the configuration process by completing steps 6 and If you plan to use the Advanced Reporting for DFSMShsm classic interface to generate reports, select the Create Product Files option from the Customization Menu. 7. When the Create Product Data Sets panel appears, use the online help as a guide as you use the panel to create and format the extraction data sets used by the Advanced Reporting for DFSMShsm classic interface reports. 10 User s Guide

17 Custom Advanced Reporting for DFSMShsm V2R :30 Command ===> Create Product Data Sets (Job Submission is the preferred method.) These options will create the extraction data sets used in the classic ARH reports. 1. Submit job to format MCDS A. Format MCDS online 2. Submit job to format BCDS B. Format BCDS online 3. Submit job to format OCDS C. Format OCDS online 4. Submit job to format LOGX/Y D. Format LOG data online 5. Submit job for Health Reports 6. Submit job for Volume Dumps F. Format Volume Dumps online.select the appropriate menu options and provide the necessary information to complete the customization. ARHCMD00 configuration values This section describes the structure of the ARHCMD00 PARMLIB member, its syntax rules, and its keyword syntax and descriptions. Important: If you change any of the configuration values in this PARMLIB member, be aware that you must restart ARHJMAIN before the changes take effect. Syntax rules Member ARHCMD00 consists of token assignment statements that are organized by sections. The general format for a token statement is: Keyword = Parameter Or Keyword = (Parameter1, Parameter2,, Parametern) Leading blanks from the beginning of the logical card-image records are allowed for all statements. Syntax scan processing locates the first non-blank character in each logical record. The entire length of the 80-byte logical record is considered for valid data. Do not renumber the ARHCMD00 member; sequence numbers assigned in columns 73 through 80 will cause errors. Continuation rules Continuation is assumed to occur whenever data crosses from one line to another, such as when you specify multiple values for the same parameter. An example of this situation follows: ParameterKeyword=(value1, value2, value3, value4, value5) Chapter 2. Installation 11

18 Comments Both line mode and block mode commenting are supported: An asterisk (*) in column-1 marks the entire line as a comment. A line that is entirely blank can also be considered a comment. Entire lines, blocks of lines, or portions of a line can be commented by beginning the comment with a '/*' and terminating the comment with a '*/'. ARHCMD00 keyword syntax and descriptions Required parameters CLIST_DSN Name(s) of the product library containing CLIST/REXX members. Default value Syntax Acceptable values Example None CLIST_DSN=clist.dsn.name Specify any valid data set name. CLIST_DSN=ARH.SARHCLST COMMANDS_DSN Name(s) of the product library containing COMMANDS members. Default value Syntax Acceptable values Example None COMMANDS_DSN=commands.dsn.name Specify any valid data set name. COMMANDS_DSN=ARH.COMMANDS MLIB_DSN Name(s) of the product library containing the message members. Default value Syntax Acceptable values Example None MLIB_DSN=messages.dsn.name Specify any valid data set name. MLIB_DSN=ARH.SARHMENU 12 User s Guide

19 OPFX Operational prefix for allocations. Used as the high level qualifier during file allocation. Default value Syntax Acceptable values Example None OPFX=hlq1.hlq2 Specify any valid high-level qualifier, 1-20 bytes. OPFX=ARH.WORK PLANS_DSN Name(s) of the product library containing PLANS members. Default value Syntax Acceptable values Example None PLANS_DSN=plans.dsn.name Specify any valid data set name. PLANS_DSN=ARH.PLANS PLIB_DSN Name(s) of the product library containing ISPF panels. Default value Syntax Acceptable values Example None PLIB_DSN=panels.dsn.name Specify any valid data set name. PLIB_DSN=ARH.SARHPENU SAMPLIB_DSN Name(s) of the product library containing sample members. Default value Syntax Acceptable values Example None SAMPLIB_DSN=sample.dsn.name Specify any valid data set name. SAMPLIB_DSN=ARH.SARHSAMP Chapter 2. Installation 13

20 Optional parameters ARCLOGX Name(s) of the LOG X data sets. Default value Syntax Acceptable values Example None ARCLOGX=dsn.name or ARCLOGX=(dsn.name1,dsn.name2,,dsn.namen) Specify any valid data set name. ARCLOGX=HSM.SYS1.LOGX ARCLOGY Name(s) of the LOG Y data sets. Default value Syntax Acceptable values Example None ARCLOGY=dsn.name or ARCLOGY=(dsn.name1,dsn.name2,,dsn.namen) Specify any valid data set name. ARCLOGY=HSM.SYS1.LOGY BAKCAT Name of first or only Backup Control Data Set. Default value Syntax Acceptable values Example None BAKCAT=dsn.name Specify any valid data set name. BAKCAT=HSM.SYS1.BCDS BAKCAT2 Name of the second Backup Control Data Set. Default value Syntax Acceptable values Example None BAKCAT2=dsn.name Specify any valid data set name. BAKCAT2=HSM.SYS1.BCDS2 14 User s Guide

21 BAKCAT3 Name of the third Backup Control Data Set. Default value Syntax Acceptable values Example None BAKCAT3=dsn.name Specify any valid data set name. BAKCAT3=HSM.SYS1.BCDS3 BAKCAT4 Name of the third Backup Control Data Set. Default value Syntax Acceptable values Example None BAKCAT4=dsn.name Specify any valid data set name. BAKCAT4=HSM.SYS1.BCDS4 HEALTH_DAYS Number of days for an action not to occur before it is reported as a problem. Default value 3 Syntax HEALTH_DAYS=number Acceptable values Specify any integer in the range Example HEALTH_DAYS=10 HEALTH_LIMIT Number of errors allowed on a device before it is reported as a problem. Default value 3 Syntax HEALTH_LIMIT=number Acceptable values Specify any integer in the range Example HEALTH_LIMIT=15 Chapter 2. Installation 15

22 JOBCARD1 First line to be used when creating JCL. Default value Syntax Acceptable values Example Not applicable JOBCARD1='jobcard data' 3 to 60 bytes of data delimited by single quote (') marks. JOBCARD1='//ARHJOB JOB (Acct),''ARH job'',' JOBCARD2 Second line to be used when creating JCL. Default value Syntax Acceptable values Example Not applicable JOBCARD2='jobcard data' 3 to 60 bytes of data delimited by single quote (') marks. JOBCARD2='// MSGCLASS=A,CLASS=B,' JOBCARD3 Third line to be used when creating JCL. Default value Syntax Acceptable values Example Not applicable JOBCARD3='jobcard data' 3 to 60 bytes of data delimited by single quote (') marks. JOBCARD3='// NOTIFY=&SYSUID' JOBCARD4 Fourth line to be used when creating JCL. Default value Syntax Acceptable values Example Not applicable JOBCARD4='jobcard data' 3 to 60 bytes of data delimited by single quote (') marks. JOBCARD4='//*' 16 User s Guide

23 JOBCARD5 Fifth line to be used when creating JCL. Default value Syntax Acceptable values Example Not applicable JOBCARD5='jobcard data' 3 to 60 bytes of data delimited by single quote (') marks. JOBCARD5='//* ' MIGCAT Name of the first or only migration control data set. Default value Syntax Acceptable values Example Not applicable MIGCAT=dsn.name Any valid data set name. MIGCAT=HSM.SYS1.MCDS MIGCAT2 Name of the second migration control data set. Default value Syntax Acceptable values Example Not applicable MIGCAT2=dsn.name Any valid data set name. MIGCAT2=HSM.SYS1.MCDS2 MIGCAT3 Name of the third migration control data set. Default value Syntax Acceptable values Example Not applicable MIGCAT3=dsn.name Any valid data set name. MIGCAT3=HSM.SYS1.MCDS3 Chapter 2. Installation 17

24 MIGCAT4 Name of the fourth migration control data set. Default value Syntax Acceptable values Example Not applicable MIGCAT4=dsn.name Any valid data set name. MIGCAT4=HSM.SYS1.MCDS4 OFFCAT Name of the offline control data set. Default value Syntax Acceptable values Example Not applicable OFFCAT=dsn.name Any valid data set name. OFFCAT=HSM.SYS1.OCDS OUTPUT_CLASS SYSOUT class for report data. Default value * Syntax OUTPUT_CLASS=x Acceptable values 1-byte sysout class. Example OUTPUT_CLASS=Z PFX Prefix to be used for user work files.. Default value Syntax Acceptable values Example &SYSUID PFX=user.id.prefix 1- to 20-byte user prefix. PFX=&SYSUID._ARH 18 User s Guide

25 QW_APPL Specifies which application identifier to use when QuickRef is invoked. Default value Syntax Acceptable values Example QWIK QW_APPL=application_ID Any valid 1- to 4-letter application ID. QW_APPL=QWIK QW_NAME TSO command to be invoked for access to QuickRef information. Default value Syntax Acceptable values Example %QW QW_NAME=<clist, REXX, or other TSO command> Any valid TSO or ISPF command to be used for invoking QuickRef. Your specification must be 1-9 bytes in length. QW_NAME=%QW RCDS Specifies the name of the Reporting Control Data Set that is used to store Advanced Reporting for DFSMShsm information. Default value Syntax Acceptable values Example None RCDS=rcds.data.set.name Any valid data set name RCDS=ARH.RCDS Chapter 2. Installation 19

26 RCDS_PARMS Specifies the IDCAMS parameters used to create the Reporting Control Data Set, if it does not already exist. Default value Syntax Acceptable values Example None RCDS_PARMS=rcds_define_parameters Any valid IDCAMS statements RCDS_PARMS=( DEFINE CLUSTER(NAME(ARH.RCDS)- INDEXED SPEED- KEYS(44 0)- RECORDSIZE( )- FREESPACE(0 0)- SHAREOPTIONS(3 3)- CYLINDERS(10 10)- DATA(NAME(ARH.RCDS.DATA))- INDEX(NAME(ARH.RCDS.INDEX)) ) RLS Flag indicating whether the CDS files are RLS managed or not. Default value Syntax Acceptable values Example YES RLS=YES YES or NO. RLS=NO SMF_NUMBER Set this keyword to the number of SMF records you want written to record activity when DFSMShsm commands are invoked through the Advanced Reporting for DFSMShsm interface. Leave this keyword unset if you do not want SMF recording performed. Default value None Syntax SMF_NUMBER=n Acceptable values Any integer in the range Example SMF_NUMBER= User s Guide

27 SUMMARY_WAIT Advanced Reporting for DFSMShsm automatically gathers volume and DFSMS class information that is cross-referenced with migration and backup data in the MCDS and BCDS. Use this keyword to specify how many minutes Advanced Reporting for DFSMShsm should wait between information retrievals. Default value 720 (minutes) Syntax SUMMARY_WAIT=n Acceptable values Any integer in the range Example SUMMARY_WAIT=240 SYSOUT_CLASS SYSOUT class for job data. Default value * Syntax SYSOUT_CLASS=x Acceptable values 1-byte SYSOUT class. Example SYSOUT_CLASS=A WORKBLKSIZE Block size to be used for file allocations. Default value Zero (system determines block size) Syntax WORKBLKSIZE=number Acceptable values Any integer in the range Example WORKBLKSIZE=1000 WORKDC SMS data class name to be used for file allocations. Default value Syntax Acceptable values Example None. WORKDC=dataclas Any valid SMS data class, 1 8 bytes. WORKDC=DC001 Chapter 2. Installation 21

28 WORKMC SMS management class name to be used for file allocations. Default value Syntax Acceptable values Example None. WORKDC=mgmtclas Any valid SMS management class, 1 8 bytes. WORKMC=MC008 WORKPRI Primary allocation amount to be used for file allocations. Default value 100 Syntax WORKPRI=number Acceptable values Any integer in the range Example WORKPRI=50 WORKSEC Secondary allocation amount to be used for file allocations. Default value 100 Syntax WORKSEC=number Acceptable values Any integer in the range Example WORKSEC=10 WORKSC SMS storage class name to be used for file allocations. Default value Syntax Acceptable values Example None WORKSC=storclas Any valid SMS storage class, 1 8 bytes. WORKSC=SC User s Guide

29 WORKUNIT UNIT name to be used for file allocations. Default value Syntax Acceptable values Example SYSALLDA WORKUNIT=unitname Any valid unit name, 1 8 bytes. WORKUNIT=ARHUNIT WORKVOL Volume serial number to be used for file allocations. Default value Syntax Acceptable values Example None WORKVOL=volser Any valid volume serial number, 1 6 bytes. WORKVOL=VOL001 YEARCHK When processing dates, Advanced Reporting for DFSMShsm uses the value of this keyword to determine when to cut over to Y2K-compliant dates. Any 2- digit year larger than the value assigned to this keyword is considered to be a pre-2000 date. Default value 75 Syntax YEARCHK=75 Acceptable values Any integer in the range 1-99, inclusive. Example YEARCK=65 Chapter 2. Installation 23

30 24 User s Guide

31 Chapter 3. Advanced Reporting for DFSMShsm overview Concepts and facilities This chaper explains the concepts you need to understand when using Advanced Reporting for DFSMShsm and introduces its main features. Advanced Reporting for DFSMShsm is designed to provide a highly interactive and flexible method of managing and reporting on an HSM environment. If your site upgraded from an earlier version to Advanced Reporting for DFSMShsm 2.2, you have no doubt noticed its new, streamlined interface. Rest assured that you still have full use of the pre-2.2 interface and all of its features, which for documentation purposes, is referred to as the classic Advanced Reporting for DFSMShsm interface. The starting point for accessing all Advanced Reporting for DFSMShsm features is the Main Menu panel, shown in the following figure. MAINMENU IBM Tivoli Advanced Reporting for DFSMShsm V2R :37 Command ===> Scroll ===> PAGE Main Menu: Row 1 of 11 Report Name Description 1 HSM Host Information Information on DFSMShsm Hosts 2 Reports From the CDSs Reports from DFSMShsm Control Data Sets 3 Storage Reports Reports on System Storage 4 DFSMS Information Information about DFSMS 5 Classic Reports Classic Reporting Data 6 Administrative Tasks Administrative Functions 7 Product Information Product Information 8 Volume Level Data Volume Level Information 9 Data Set Level Data Data Set Level Information 10 Health Reports Reports on DFSMShsm health The features of the new interface and the classic interface are described in the following sections. 25

32 Advanced Reporting for DFSMShsm 2.2 The new Advanced Reporting for DFSMShsm provides these features, all of which are described in detail in the appropriate chapter of Section I in this guide: HSM host information reports Display detailed information about your site s DFSMShsm hosts, including which hosts are active on a system, which control data sets and ARCLOG data sets are being used by DFSMShsm, which volumes are being used in DFSMShsm processing, enqueues being held by DFSMShsm exits, being used by DFSMShsm, and so forth. This feature is documented in Chapter 4, Using the HSM Host Information reports. Control data set reports Provide detailed information about the backup, migration, and offline control data sets used by DFSMShsm to store status information about the data sets under its control. This feature is documented in Chapter 5, Using the CDS reports. Storage reports Display basic storage information, such as the units available to a system, volume information, and storage group information. This feature is documented in Chapter 6, Using the storage reports. DFSMS information reports Show SMS configuration information, and storage group, storage class, management class, data class, aggregate group attribute information, and SMS volume information for the system. This feature is documented in Chapter 7, Using the DFSMS Information reports. Administrative task commands Use thes commands to customize the Advanced Reporting for DFSMShsm processing parameters, manage batch processing plans, generate JCL for batch processes, test user access to HSM commands, and browse member lists for the PARMLIB and plan data sets. This feature is documented in Chapter 9, Performing administrative tasks. Product information You can view product information, such as product version and release level, a list of data sets used by Advanced Reporting for DFSMShsm during processing, a list of data sets allocated to the Advanced Reporting for DFSMShsm address space, a list of enqueues being held by the product address space, and the amount of virtual storage being used by the product address space. This feature is documented in Chapter 10, Viewing product information. Volume level data Display backup and migration volume information, version information for volumes with full volume dumps, tape volume information, free space information for migration level 1 volumes, and primary DASD volume information. This feature is documented in Chapter 11, Viewing volume level data. 26 User s Guide

33 Data set level data Display information for data sets residing on a migration volume, display data set backup information, display information about data sets residing on a tape volume, and list catalog information for a data set. You can also use these commands to migrate a data set from DASD to a migration volume, create a backup copy of a data set, recall a migrated data set to primary DASD, recover a backup copy of a data set, delete a data set residing on a primary or migration volume, and browse, view, or edit the contents of a partitioned or physical sequential data set. This feature is documented in Chapter 12, Viewing data set level data. Health reports Display information that summarizes the overall health of your DFSMShsm environment. The reports display DFSMShsm status information for volumes mounted to the system. Note: Menu option 5 provides access to the classic Advanced Reporting for DFSMShsm interface and facilities, which are described in Advanced Reporting for DFSMShsm classic on page 27. Advanced Reporting for DFSMShsm classic Advanced Reporting for DFSMShsm s classic interface provides these features, all of which are described in detail in the appropriate chapter of Section II in this guide: Classic Advanced Reporting for DFSMShsm is an interactive ISPF-based data collection and reporting product. It provides comprehensive reporting on the activity of HSM. Its inputs are the HSM LOGY data set and the HSM control data sets (CDSs). Extensive filtering and selection options allow you to view HSM from a high level and then zoom in to examine problem areas in great detail. The Line Command Processor is an Advanced Reporting for DFSMShsm interface to TSO command processing that allows you to invoke actions, such as filter and sort, against either individual line entries on a page of a Dialog Manager Table, or entire tables, or portions of tables. You can run a command stream in the TSO session, or execute commands in a batch process. Further, you can save your filtered and sorted information in a file and your filter and sort criteria in a 'plan', then store, retrieve and re-use them. Use Advanced Reporting for DFSMShsm s Batch Selection to select online extracts and submit batch execution of interactive Plans, making scheduled, unattended operation of Advanced Reporting for DFSMShsm convenient and effective. Extraction File Size Estimates is an Advanced Reporting for DFSMShsm facility that automatically computes the file sizes of the batch extracts and the online formats. Chapter 3. Advanced Reporting for DFSMShsm overview 27

34 The Format and Save feature allows you to create customized reports in practically any format imaginable. Using the Save option, these custom formats can be saved into Plans and executed in batch. Advanced Reporting for DFSMShsm has an HSM health system that reports on what management functions are expected for DASD volumes (migrate, back up, dump, and so on.) as well as what failed. SMS management of data takes precedence over HSM management criteria. A customer might have a mixed environment of SMS, HSM, or no management at all. This system considers both management techniques. In addition, it reports on DASD volumes that are migration level 1, migration level 2 or backup. Advanced Reporting for DFSMShsm also provides a main menu option you can use to display a list of backup generations of a data set requiring recovery. Classic Advanced Reporting for DFSMShsm online features overview This is the classic interface s main menu. It appears when you select option 5 from the Advanced Reporting for DFSMShsm V2.2 main menu. Classic Advanced Reporting for DFSMShsm :58 Command ===> Support Activities Reports from Control Data Sets D. Display Last Master C1. MCDS Information F. Program Function Keys C2. BCDS Information J. System JCL Parameters C3. OCDS Information K. System Data Sets C4. HSM Health Reports 0. Generate Master C5. Volume Dump Information Reports from Log File Daily Space Manager 5. Recycle Return Code Summary 2. Migration/Backup Options 6. Return Code Reason Code Tables 3. Recall/Recover Options 7. Log Message Summary 4. Extent Reduction Summary 8. Tape Usage Summary Online Batch Process P. Select Online Plans for Batch B. Batch JCL Build for Onlines The main menu options are separated into four groups: Support Activities, Reports from the Control Data Sets, Reports from Log File, and Online Batch Process. A short description of each option is provided below and a reference is given to the chapters of the User s Guide that contain full documentation. 28 User s Guide

35 Support activities Advanced Reporting for DFSMShsm s classic main menu provides the following support activity options: D F J K Selecting this option displays the summary information of the last Log File that was analyzed. Refer to Display Last Master on page 203 for further information. Selecting this option allows you to assign specific functions to the PF keys. Selecting this option displays the panel containing system required JCL conventions that interface with the online batch reporting features. Refer to Chapter 2, Installation, for further information. Selecting this option displays the panel providing access to the data sets that Advanced Reporting for DFSMShsm interfaces with, such as MCDS, BCDS, and so on. Refer to Chapter 2, Installation, for further information. 0 Selecting this option allows the installer to establish common variables so each user can use the established configuration. Refer to Chapter 2, Installation, for further information. Reports from the control data sets Classic Advanced Reporting for DFSMShsm s classic main menu offers the following options for control data set reporting: C1 C2 C3 Selecting this option reads the DFSMShsm MCDS (Migration Control Data Set) and presents the viewing options. Depending on the size of the MCDS this could take one to two minutes. This option is also used to create the initial MCDS Extraction file during configuration. See MCDS Information on page 213 of this guide and to Chapter 2, Installation, for further information. Selecting this option reads the DFSMShsm BCDS (Backup Control Data Set) and presents the viewing options. Typically, the BCDS is larger than the MCDS and might take a little longer to view. This option is also used to create the initial BCDS Extraction file during configuration. See BCDS Information on page 230 of this guide and refer to Chapter 2, Installation, for further information. Selecting this option displays the viewing options of the DFSMShsm OCDS. This CDS is read directly so only a small amount of delay is expected. The OCDS is the offline control data set that contains information about the DFSMShsm tape inventory. This option is also used to create the initial OCDS Extraction file during configuration. Refer to OCDS Information on page 247 of this guide and to Chapter 2, Installation, for further information Chapter 3. Advanced Reporting for DFSMShsm overview 29

36 C4 C5 Selecting this option accesses the Health Reports feature. Refer to Chapter 22, HSM health reports, for more detailed information about this feature. Selecting this option displays the viewing options of the DFSMShsm Dump Volume inventory. This set of panels allows you to view dump classes, the DSN detail of dumped volumes, and if a VTOC copy is established, the DSNAME contents of the Dumped Volumes. This option is also used to create the initial Dump Volume Extraction file during configuration. See Chapter 23, Volume dump information, for more detailed information about this feature. Reports from the log file Classic Advanced Reporting for DFSMShsm s classic main menu provides the following log file report options: 1 Select this option to display a summary of Daily Space Manager activity for all volumes with activity during the reporting interval contained in the log data set you have selected. Daily Space Manager will also include Interval Migration. There might be many reporting intervals for each volume. See Daily space manage on page 390 for more detailed information about this feature. 2 Select this option to display return code summaries for migration activity of primary volumes. See Migration/backup options on page 341 for more detailed information about this feature. 3 Select this option to display return code summaries for Recall/Recover activity. See Recall/recovery options on page 358 for more detailed information about this feature. 4 Select this option to display a summary report for Extent Reduction activity. It also shows Migrations and Recalls for Extent Reduction purposes. These Migrations and Recalls are not included in the normal Migration and Recall reports. See Extent reduction summary on page 373 for more detailed information about this feature. 5 Select this option to display the Recycle Return Code Summary. See Recycle return code summary on page 375 for more detailed information about this feature. 6 Select this option to display the options available for browsing the Log File messages. See Log message summary on page 377 for more detailed information about this feature. 7 Select this option to display the Tape Usage reports. See Tape usage summary on page 386 for more detailed information about this feature. 8 Select this option to display an English language reference to return codes and reason codes. See Return code reason code tables on page 388 for more detailed information about this feature. 30 User s Guide

37 Batch processing options Advanced Reporting for DFSMShsm s classic main menu offers the following online batch process options: P B Select this option to display the categories of filter and sort plans. Select the category, then the plan you want to execute in batch. See Chapter 20, Online batch process, for more detailed information about this feature. Select this option to display the Batch JCL Build Menu used to build the JCL necessary to run the extracts and plans. See Chapter 20, Online batch process, for more detailed information about this feature. Extended ACS masking characters and your EBCDIC code tables Most Advanced Reporting for DFSMShsm commands allow BCS, VVDS, data set, and volume specification using powerful filtering masks. Any of these filtering pattern entries can be specified with extended ACS masking characters (as specified on the next page). Specification and display of EBCDIC characters Data supplied as input to either batch programs or input to ISPF panels For product code shipped in binary, when specifying input where the product takes special action based on specific characters, the user is responsible for entering the EBCDIC character peculiar to their code tables that results in the binary value for the EBCDIC character shown in this document according to the U.S.A. EBCDIC code set. For instance, if an exclamation mark (! ) is called for, and your code tables do not translate the! character to a hexadecimal 5A, you must enter the character that will translate to a 5A. Do not change distributed ISPF panels Programs can reference ISPF panel attribute bytes. A panel change involving an attribute byte will not be consistent with the program code. Product output Depictions of product output shown in the product manuals are based on the U.S.A. EBCDIC code set. Actual output might vary if your EBCDIC code tables are different. Chapter 3. Advanced Reporting for DFSMShsm overview 31

38 Filtering pattern masks Mask Hex Description * (Single) 5C Can be used before and/or after an item to designate a wild-card character position. In the example: *PROD an item is selected if the last four character end in PROD regardless of the starting characters. Using the * character before and after an item (that is, *ZREM*) means that item is to be selected if any character string matches ZREM in its name. Note: You can not use an * in the middle portion of a single item (except for data set names). Use the % character (see below) for that purpose. % 6C Denotes a single character place-holder value, which can be alphanumeric or any special character. The % character can be used in any position order. In the example: CRM%%ER6 an item is to be selected if it is 8-characters in length and the first three characters are CRM and the last three characters are ER6. The two middle place-holder values can be any characters. < 4C Similar to the % value, the < character denotes a place-holder value for alphabetic characters only. The < character can be used in any position order. In the example: CR<<ER* an item is to be selected if the first two characters are CR, the 3 rd and 4 th characters must be alpha, the 5 th and 6 th characters are ER, and any remaining characters allowed. > 6E Similar to the % value, the > character denotes a place-holder value for numeric characters only. The > character can be used in any position order. In the example: CR>>ER* an item is to be selected if the first two characters are CR, the 3 rd and 4 th characters must be numeric, the 5 th and 6 th characters are ER, with any remaining characters allowed. 32 User s Guide

39 Mask Hex Description 4F Denotes a multiple character place-holder value for alphanumeric characters. The character can be used only in the final position of the mask to represent any number of alphanumeric characters. Consider the following example: ARH.PROD1017. An item is to be selected if the first three characters are ARH, followed by a period (. ), followed by the characters PROD1017, followed by a period (. ), followed by one or more alphanumeric characters. Note: The Advanced Reporting for DFSMShsm classic interface does not support the use of this masking character. ** (Double) 5C5C Allows compatibility with standard ACS and DFSMSdss filtering masks. Only used for partially qualified data set names. The * or ** characters can be used in any qualifier position to denote a wildcard node. In the example: CRFM*.*VER.** a data set entry is to be selected if it has at least two qualifiers and the 1 st qualifier starts with CRFM, the 2 nd qualifier must end with VER, and any remaining qualifiers. Note: As with common data set name masking, any combination of *, **, %, < and/or > characters can be used for the item mask value.! 5A Similar to the % value, the! character denotes a place-holder value for national characters only. The! character can be used in any position order. National characters # $ Chapter 3. Advanced Reporting for DFSMShsm overview 33

40 34 User s Guide

41 Chapter 4. Using the HSM Host Information reports When you select the HSM Host Information option from the Advanced Reporting for DFSMShsm Main Menu, the HSM Host menu panel appears, as shown in the following figure: HostMenu Advanced Reporting for DFSMShsm :17 Command ===> Scroll ===> PAGE DFSMShsm Host Reports: Row 1 of 18 Report Name Description 1 HSM Host Information Lists Active HSM Hosts 2 Control Data Sets HSM Control Data Set List 3 Log Data Sets HSM ARCLOG Data Set List 4 Active Allocations Data Sets Allocated to HSM Hosts 5 Mounted Volumes Volumes Used in HSM Processing 6 MWE Queue Contents Current HSM Work Elements 7 SETSYS Values Current SETSYS Processing Values 8 Exit Information HSM Exits in Use 9 ENQ Information Enqueues Held by HSM Hosts 10 Memory Information Virtual Memory Usage Report 11 Patches Patches Available to DFSMShsm 12 Automatic Backup Data Automatic Backup Function Data 13 Automatic Migrate Data Automatic Migrate Function Data 14 Automatic Dump Data Automatic Dump Function Data 15 Issue HSM Commands Issue Command to DFSMShsm Host 16 Function Return/Reasons Codes HSM Function Return/Reason Codes 17 Activity Logs Lists DFSMShsm Activity Logs 18 DFSMShsm Functions Lists DFSMShsm Function Status HSM Host Information report The HSM Host Information reports show detailed information about your site s DFSMShsm hosts, including which hosts are active on a system, which control data sets and ARCLOG data sets are being used by DFSMShsm, which volumes are being used in DFSMShsm processing, enqueues being held by DFSMShsm, which exits are being used by DFSMShsm, and so on. These reports are described in the following sections of this chapter. Select the HSM Host Information option from DFSMShsm Host Reports menu to create an HSM Host Information report. You can set up filters on DFSMShsm job name or DFSMShsm host ID (or both) so that the report includes only those hosts whose attributes match your filters. 35

42 Report information includes one row for each DFSMShsm host whose attributes match the specified filters. For each host, the report information includes the following: Job name and job number Host ID HSM release level and type Logging status MCTV address QCT and QCT element addresses Host AS ID Command suffix SMF number Migrate and Backup prefixes Maximum backup, migrate, dump, recall, interval migration, and recover tasks Maximum CSA usage Active and inactive request limits CSA used Control Data Sets report Percentage of allowed CSA currently being used Maximum number of work elements allowed to be in CSA Audit, autodump, autobackup, automigrate, backup, dump, list, migrate, recall, recover, recycle, and report status Tape DSN recall, tape DSN recover, tape DSN replace, and TSO tape DSN status information BCDS, MCDS, OCDS, and journal backup status information Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Use the function keys to scroll the display to show all report columns. Select the Control Data Sets option from DFSMShsm Host Reports menu to create a Control Data Sets report. You can set up filters on DFSMShsm job name, DFSMShsm host ID, control data set name, type file, RLS flag, or volume serial (or any combination of these) so that the report includes only those control data sets whose attributes match your filters. 36 User s Guide

43 Report information includes one row for each control data set whose attributes match the specified filters. For each control data set, the report information includes the following: Data set name File type Volser RLS flag Job name DFSMShsm host ID Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Use the function keys to scroll the display to show all report columns. Usage notes Log Data Sets report This report does not have a counterpart in the Advanced Reporting for DFSMShsm classic interface. Select the Log Data Sets option from DFSMShsm Host Reports menu to create a Log Data Sets report that lists and displays information about the HSM ARCLOG data sets. You can set up filters on DFSMShsm job name, DFSMShsm host ID, type file, or source product (or any combination of these) so that the report includes only those log data sets whose attributes match your filters. Report information includes one row for each log data set whose attributes match the specified filters. For log data set, the report information includes the following: Data set name Job name Type file Source product Job number Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Use the function keys to scroll the display to show all report columns. Chapter 4. Using the HSM Host Information reports 37

44 Active Allocations report Select the Active Allocations option from DFSMShsm Host Reports menu to create an Active Allocations report that lists and displays information about data sets allocated to HSM hosts. You can set up filters on DFSMShsm job name, data set name, DD name, or volume serial number (or any combination of these) so that the report includes only those data sets whose attributes match your filters. Report information includes one row for each data set whose attributes match the specified filters. For each data set, the report information includes the following: Data set name DD name Volser Member name Allocation disposition Normal and conditional dispositions of the allocation EXCP count Job name and number Mounted Volumes report Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Use the function keys to scroll the display to show all report columns. Select the Mounted Volumes option from DFSMShsm Host Reports menu to create a Mounted Volumes report that lists and displays information about the volumes used in HSM processing. You can set up filters on DFSMShsm job name, host ID, volume serial number, or volume type (or any combination of these) so that the report includes only those volumes whose attributes match your filters. Report information includes one row for each volume whose attributes match the specified filters. For each volume, the report information includes the following: Volser HSM volume type Method by which DFSMShsm uses the volume Whether migration is required on the volume Whether the volume is eligible for auto space migration 38 User s Guide

45 Whether SDSP exists and is available Whether VTOC is nearly out of space Whether the volume is eligible for auto recall Whether the volume is backed up automatically Whether the volume is eligible for command migration Unit name Total space on the volume (in tracks) Free space on the volume (in tracks) Low and high threshold on primary volume Volume device type Volume device type in hexadecimal format Maximum blocksize for device Number of cylinders on the device Number of tracks per cylinder Track length Number of 2K blocks per track Optional blocksize for 2K blocking Backup frequency (in days) Minimum age at which to migrate data from the volume Fragmentation index Reserve count Whether the volume is an ML1 overflow volume Whether the volume is in use by data set migration Processing unit ID Number of days the volume can be inactive before deletion Volser of migrate convert command Day of backup cycle for primary volume Density for tape device File sequence number of last file written to tape Address of UCB for this volume Job name and number DFSMShsm host ID Chapter 4. Using the HSM Host Information reports 39

46 MWE Queue Contents report Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Use the function keys to scroll the display to show all report columns. Select the MWE Queue Contents option from DFSMShsm Host Reports menu to create an MWE Queue Contents report that lists and displays information about the current HSM work elements. You can set up filters on DFSMShsm job name or host ID (or both) so that the report includes only those work elements match your filters. Report information includes one row for each work element whose attributes match the specified filters. For each work element, the report information includes the following: Data set name Time and date DFSMShsm queued the request Request type Name of the data set being processed Name of the requesting job DFSMShsm-assigned request number Position in the queue Status of the request TCB address and RCB address performing the processing ID of the task processing the request Whether WAIT was specified for the request Whether the request was made by a TSO user Work element entry s address Whether the data set is in a VSAM file Whether the MWE has been copied into common storage Whether the data set is to be migrated directly to ML2 Whether to wait for a volume to be mounted before retrying the request Whether the user has space management authority If the request was completed, the report shows the reason code and system ABEND code Group name for RACF ASCB address of the requestor ID of the user making the request 40 User s Guide

47 SETSYS Values report Alternate unit name Volser for the request Job name and number DFSMShsm host ID Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Use the function keys to scroll the display to show all report columns. Select the SETSYS Values option from DFSMShsm Host Reports menu to create an Active Allocations report that lists and displays information about current SETSYS processing values. You can set up filters on DFSMShsm job name or host ID (or both) so that the report includes only those SETSYS values whose attributes match your filters. Report information includes one row for each SETSYS value whose attributes match the specified filters. For SETSYS value, the report information includes the following: Keyword name Value assigned to the keyword Description of the keyword s function Job name Job number Exit Information report DFSMShsm host ID Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Use the function keys to scroll the display to show all report columns. Select the Exit Information option from DFSMShsm Host Reports menu to create an Exit Information report that lists and displays information about the exit programs used by DFSMShsm. You can set up filters on DFSMShsm job name or host ID (or both) so that the report includes only those exits whose attributes match your filters. Report information includes one row for each exit whose attributes match the specified filters. For each exit, the report information includes the following: Exit name Exit description Chapter 4. Using the HSM Host Information reports 41

48 Module s address in the DFSMShsm address space Whether the exit is currently providing services for the DFSMShsm address space Location and data set from which the module was loaded The addressing mode in which the module runs The residency mode in which the module runs Whether the module is re-entrant Whether the module is re-usable Whether the data set from which the module was loaded is APF authorized Whether the module has the authorization bit set Module use count Header data from module Job name and number Host ID ENQ Information report Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Use the function keys to scroll the display to show all report columns. Select the ENQ Information option from DFSMShsm Host Reports menu to create an ENQ Information report. You can set a filter on the DFSMShsm job name so that the report includes only those enqueues whose attributes match your filter. Report information includes one row for each enqueue whose attributes match the specified filter. For each enqueue, the report information includes the following: Major name Initial portion of the minor name Enqueue request type Name of the job requesting the enqueue ID of the address space for the job requesting the enqueue System name associated with the enqueue Request level and scope Status of the enqueue request Total number of users waiting for the resource, plus the number waiting of exclusive use and the number waiting for shared use 42 User s Guide

49 Number of resource owners TCB address associated with the enqueue SVRB address that issued the enqueue ECB address of the task that issued the enqueue request Whether the step must complete Device number associated with the enqueue The major and minor names in hexadecimal format Job name Memory Information report Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Use the function keys to scroll the display to show all report columns. Patches report Select the Memory Information option from DFSMShsm Host Reports menu to create a Memory Information report that lists and displays information about virtual memory usage. You can set up a filter on job name so that the report includes only those jobs whose attributes match your filter. Report information includes one row for each job whose name matches the specified filter. For each job, the report information includes the job name, a brief description of the job, and data related to memory usage. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Select the Patches option from DFSMShsm Host Reports menu to create a Patches report that lists and displays information about the patches applied to a DFSMShsm address space. You can set up filters on DFSMShsm job name or host ID (or both) so that the report includes only those patches whose attributes match your filters. Report information includes one row for each patch whose attributes match the specified filters. For each patch, the report information includes the following: Patch command Whether the patch is active on the DFSMShsm host The VERIFY command (if one exists) to be used with the patch A brief description of what the patch does Job number of the address space Chapter 4. Using the HSM Host Information reports 43

50 Host ID Automatic Backup Data report Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Use the function keys to scroll the display to show all report columns. Select the Automatic Backup Data option from DFSMShsm Host Reports menu to create an Automatic Backup Data report that lists and displays information about DFSMShsm s automatic backup function. Advanced Reporting for DFSMShsm retrieves this information from the BCR record in the DFSMShsm host memory. You can set up filters on DFSMShsm job name or host ID (or both) so that the report includes only the data whose attributes match your filters. Report information includes one row for each statistic whose attributes match the specified filters. For each statistic, the report information includes the following: A brief description of the statistic The value currently associated with the statistic Job name Job number of Host ID Automatic Migrate Data report Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Select the Automatic Migrate Data option from DFSMShsm Host Reports menu to create an Automatic Migrate Data report that lists and displays information about DFSMShsm s automatic migration function. Advanced Reporting for DFSMShsm retrieves this information from the MCR record in the DFSMShsm host memory. You can set up filters on DFSMShsm job name or host ID (or both) so that the report includes only the data whose attributes match your filters. Report information includes one row for each statistic whose attributes match the specified filters. For each statistic, the report information includes the following: A brief description of the statistic The value currently associated with the statistic Job name 44 User s Guide

51 Job number of Host ID Automatic Dump Data report Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Select the Automatic Dump Data option from DFSMShsm Host Reports menu to create an Automatic Dump Data report that lists and displays information about DFSMShsm s automatic dump function. Advanced Reporting for DFSMShsm retrieves this information from the DCR record in the DFSMShsm host memory. You can set up filters on DFSMShsm job name or host ID (or both) so that the report includes only the data whose attributes match your filters. Report information includes one row for each statistic whose attributes match the specified filters. For each statistic, the report information includes the following: A brief description of the statistic The value currently associated with the statistic Job name Job number Host ID Issuing HSM commands Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Select the Issue HSM Commands option from the DFSMShsm Host Reports menu to send a command to an HSM host and view the messages that result from that command. You can send any command that can be accepted by the HSEND command. Note: You may send commands to any one HSM host. If you need to send commands to more than one host, you must return to the DFSMShsm Host Reports menu and select the Issue HSM Commands option and complete the fields on the DFSMShsm Command Response panel again for each host. To isse an HSM command and view the resulting messages, complete these steps: 1. From the DFSMShsm Host Reports menu, select the Issue HSM Commands option to display the DFSMShsm Command Response panel. Chapter 4. Using the HSM Host Information reports 45

52 2. Specify an address space in the Job Name field on the DFSMShsm Command Response panel. 3. In the Host ID field, specify the identifier for the HSM host to which you want the command sent. 4. In the Command field, specify the command you want sent to the HSM host. 5. Press Enter. Function Return/Reason Codes report Activity Logs report Select the Function Return/Reason Codes option from the DFSMShsm Host Reports to display a report that provides information about backup copies of the control data sets and the journal. You can set up filters on the return code, reason code, message identifier, or type of function (or any combination of these) so that the report includes only the data whose attributes match your filters. You can also specify whether you want information for return codes only. The report information includes the following: The return code The reason code Function type Meaning of the return code Meaning of the reason code Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Use the RIGHT and LEFT function keys to scroll the display and view all columns. Select the Activity Logs option from the DFSMShsm Host Reports to display a list of activity logs available on the system. The report information includes the following: Name of the activity log data set Date on which the activity log was created Number of days elapsed since the activity log was created Volser of the volume on which the activity log resides Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. 46 User s Guide

53 DFSMShsm Functions report Select the DFSMShsm Functions option from the DFSMShsm Host Reports to display a report that provides information about backup copies of the control data sets and the journal. You can set up filters on the DFSMShsm job name or the DFSMShsm host ID (or both) so that the report includes only the data whose attributes match your filters. The report includes one row for every DFSMShsm function whose attributes match the specified filters. For each included function, the report information includes the following information: The name of the function The function s status The name of the DFSMShsm job (address space) Job number of the address space DFSMShsm host identifier Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Chapter 4. Using the HSM Host Information reports 47

54 48 User s Guide

55 Chapter 5. Using the CDS reports When you select option 2 from the HSM Report/Manager Main Menu, the DFSMShsm Reports from Control Data Sets menu panel appears, as shown in the following figure: CDSMENU IBM Tivoli Advanced Reporting for DFSMShsm V2R :25 Command ===> Scroll ===> PAGE DFSMShsm Reports From Control Data Sets: Row 1 of 30 Report Name Description 1 HSM Control Data Sets Shows the HSM Control Data Sets 2 HSM CDS Users Shows Users of the CDSs 3 HSM CDS Backups Shows CDS Backup Versions 4 Migrated Data Sets Data Set Level Migration Info 5 Backup Data Sets Data Set Level Backup Info 6 Backup Versions Lists Versions of a Backup Ds 7 HSM Backup Data Sets Lists HSM Internal Backup Dsns 8 Tape Data Sets Lists Data Sets on Tape Volumes 9 Dump Data Sets Data Sets on Dump Volumes 10 Migrate Dsns Need Bkup Migrate Dsns Needing a Backup 11 Migration Volumes Volumes Used in Migrate Commands 12 Backup Volumes Volumes Containing Backup Data 13 Dump Volumes These Contain Volume Dump Copies 14 Dump Versions Lists Versions of Dump Copies 15 Tape Volumes Tape Volume Information 16 Tape Copy Needed Tape Volumes Needing Updating 17 ML1 Volume Free Space Free Space for ML1 Volumes 18 Volumes Eligible for Backup Volumes Eligible for Backup Services 19 Authorized Users Users With Special HSM Authority 20 Dump Classes Dump Classes and Attributes 21 Daily Statistics Daily Statistics Kept by HSM 22 Daily Function Stats Daily Statistics For Functions 23 Volume Statistics Records Statistics Records for Volumes 24 Daily Volume Stats Volume Statistics By Function 25 Volume Summary Summary of Volume Usage 26 DFSMS Class Summary Summary of DFSMS Classes The HSM Host Information reports show detailed about the backup, migration, and offline control data sets used by DFSMShsm to store status information about the data sets under its control. These reports are described in the following sections of this chapter. 49

56 HSM Control Data Sets report Select the HSM Control Data Sets option from DFSMShsm Reports from Control Data Sets menu to create an HSM Control Data Sets report. You can set up filters on DFSMShsm job name, DFSMShsm host ID, control data set name, type file, RLS flag, or volume serial number (or any combination of these) so that the report includes only those control data sets whose attributes match your filters. Report information includes one row for each control data set whose attributes match the specified filters. For each control data set, the report information includes the following: Data set name File type Volser number RLS fla Job name Job number Host ID HSM CDS Users report Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Select the HSM CDS Users option from DFSMShsm Reports from Control Data Sets menu to create an HSM CDS Users report that shows information about the enqueues being held agains the control data sets being used by DFSMShsm. You can set up filters on DFSMShsm job name or the control data set name (or both) so that the report includes only enqueues whose attributes match your filters. Report information includes one row for each enqueue whose attributes match the specified filters. For each enqueue, the report information includes the following: Control data set name The request type for the enqueue Job name for the enqueue request Address space ID of the job requesting the enqueue System name associated with the enqueue The enqueue s request level and scope 50 User s Guide

57 Status of the enqueue reqeust How many users are waiting for the resource: total number, number waiting for exclusive use, and number waiting for shared use Number of resource owners for the enqueue TCB address associated with the enqueue SVRB address that issued the enqueue Whether the step must complete for the enqueue Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Usage notes HSM CDS Backups report There is no corresponding report in the Advanced Reporting for DFSMShsm classic interface. Select the HSM CDS Backups option from DFSMShsm Reports from Control Data Sets menu to create a Control Data Set Backup Information report that shows information about the backup copies of the control data sets and the journal. For each backup copy, the report information includes the following: Type of process for which HSM used the original data set. This is the name of the DD to which the data set would be allocated. Name of the backup data set Date on which the backup version was created Time at which the backup version was created Number of days elapsed since the backup data set was created Name of the DFSMShsm data set that was backed up Volser of the volume where this data set resided before being backed up Address space ID of the job requesting the enqueue System name associated with the enqueue The enqueue s request level and scope Status of the enqueue reqeust How many users are waiting for the resource: total number, number waiting for exclusive use, and number waiting for shared use Number of resource owners for the enqueue Chapter 5. Using the CDS reports 51

58 Migrated Data Sets report TCB address associated with the enqueue SVRB address that issued the enqueue Whether the step must complete for the enqueue Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Migrated Data Sets option from DFSMShsm Reports from Control Data Sets menu to create a Migrated Data Sets report that shows information about the data sets that have migration copies controlled by DFSMShsm. You can set up filters on data set name name, migration volume serial number, migration level, or migration date (or any combination of these) so that the report includes only those data sets whose attributes match your filters. Report information includes one row for each data set whose attributes match the specified filters. For each data set, the report information includes the following: Data set name Migration volume serial number Serial number of the primary volume from which the data set was migrated or to which it was recalled Date and time at which the migration copy was created and the number of days that have elapsed since the copy was created Name assigned internally by DFSMShsm to the data set containing the migration copy Whether the MCO record for the data set exists and data can be retrieved for it Whether the data set is a valid DFSMShsm migration copy Migration level on which the data set currently resides Whether the data set has been deleted Whether the data set is in a VSAM SDSP data set Percentage of space saved if the data set were compacted Date on which the data set was created and the number days elapsed since its creation Date and time at which the data set was las referenced on primary DASD and the number of days that have elapsed since the last reference on primary DASD 52 User s Guide

59 (VSAM data sets only) Date and time at which the data set was last updated and the number of days that have elapsed since the last update Data set organization Maximum blocksize (VSAM data sets only) Key length Data set record format Data set size on the primary volume, in tracks and in kilobytes Size of the latest version of the data set on the migration volume, in 2K blocks Primary volume device type Migration volume device type How many times the data set has migrated since the current MCDS record was created How many days until the data set is eligible for migration Date and time at which the data set was last recalled and the number of days that have elapsed since it was last recalled Number of volumes eligible for a directed recall of the data set Date on which the data set will expire and the number of days until the expiration date Whether the user data set was on multiple volumes when backed up Whether the data set is managed by SMS Name of the data set s DFSMS management class Number of 16K blocks the migration copy occupies on all volumes Whether the user data set contained one or more stripes Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Usage notes You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 2.2. Refer to Chapter 12, Viewing data set level data, for more information. This report contains the same information as the classic interface s Migrated Data Sets by SMS Type and Classes and Data Set Name Search reports. Refer to MCDS SMS summary on page 214 for more information about the classic report. Chapter 5. Using the CDS reports 53

60 Backup Data Sets report Select the Backup Data Sets option from DFSMShsm Reports from Control Data Sets menu to create Backup Data Sets report that shows information about the data sets tha have at least one backup copy available. You can set up filters on data set name, backup volume serial number, or the backup date (or any combination of these) so that the report includes only those data sets whose attributes match your filters. Report information includes one row for each data set whose attributes match the specified filters. For each data set, the report information includes the following: Data set name Volser for the backup volume Maximum number of backup copies to kept Date and time the backup copy was made and the number of days that have elapsed since the backup copy was made Data set organization Maximum blocksize (VSAM data sets only) Key length Record format (from the VTOC entry) Percentage of space saved if the data set were compacted Data set size on primary volume, in tracks and in kilobytes Size of latest version of the data set on the backup volume, in 2K blocks Whether the data set is managed by SMS Version number for latest backup Current number of backup versions for the cataloged data set Total number of backup versions Backup frequency (non-vsam only) Date on which the data set was last referenced and the number of days elapsed since the last reference Date on which the data set was found to be not cataloged and the number days elapsed since it was determined to be uncataloged Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. 54 User s Guide

61 Usage notes Backup Versions report You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 9.2. Refer to Chapter 12, Viewing data set level data, for more information. This report contains the same information as the classic interface s Backup Data Sets by SMS Type and Classes and Data Set Name Search reports. Refer to BCDS SMS summary panel on page 233 for more information about the classic report. Select the Backup Versions option from DFSMShsm Reports from Control Data Sets menu to create a Backup Versions report that shows information about the data sets that have one or more backup versions. You can set up filters on data set name, backup volume serial number, generation number, or version date (or any combination of these) so that the report includes only those data set versions whose attributes match your filters. Report information includes one row for each data set version whose attributes match the specified filters. For each data set version, the report information includes the following: Data set name Serial number of the volume on which the backup copy resides Generation and version numbers of the backup version Date on which the backup copy was made and the number of days elapsed since its creation DFSMShsm internal data set name for this backup version Primary volume from which the data set was backed up Whether the version was crated by BACKDS or HBACKDS command and is currently on a migration level 1 volume Whether the data set was cataloged to the primary volume when the backup version was made Whether the data set is a VSAM data set Whether the backup version is on tape Whether the data set is retired Whether a backup profile exists for the backup version Whether the data set is managed by SMS Whether the data set is expired Chapter 5. Using the CDS reports 55

62 Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Usage notes HSM Backup Data Sets report You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 9.3. Refer to Chapter 12, Viewing data set level data, for more information. This report is not available through the Advanced Reporting for DFSMShsm classic interface. Select the HSM Backup Data Sets option from DFSMShsm Reports from Control Data Sets menu to create a HSM Backup Version Data Sets report that shows information about the DFSMShsm internal data sets that contain backup information. These internal data sets contain the entire contents of the user data set that was backed up. You can set up filters on DFSMShsm data set name, user data set name, backup volser, user volser, data class name, storage class name, or management class name (or any combination of these) so that only those data sets that match your filters appear in the report. Report information includes one row for each data set version whose attributes match the specified filters. For each data set version, the report information includes the following: Data set name on the primary volume Volume from which the user data set was backed up Primary volume device type and its hexadecimal representation DFSMShsm internal data set name for this backup version Volume on which this backup copy resides Backup volume device type and its hexadecimal version Date and time at which the backup version was created and the number of days elapsed since the backup version was created Data set organization Data set s maximum block size (VSAM data sets only) Length of the key Data set record format from the VTOC record Version number for the backup copy Size of the data set on the primary volume, in tracks and in kilobytes 56 User s Guide

63 Size of the latest version of the data set on the backup volume, in 2k blocks Whether the data set was cataloged to the primary volume when the backup version was made Indicator that the version might be invalid and if so, can be scratched Indicator that the version should be erased when it is scratched Indicator that the user data set contained one or more stripes Total number of 16k blocks occupied by the backup version across all volumes The number of volumes (beyond the first) that contain the backup version Name of the DFSMS data class, storage class, and management class for the data set Data set s expiration date and the number of days elapsed since the expiration date Whether the user data set resided on multiple volumes when it was backed up Whether the version of the data set is SMS managed Type of space allocation for the user data set Secondary space allocation amount for the data set Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Usage notes Tape Data Sets report You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 9.3. Refer to Chapter 12, Viewing data set level data, for more information. This report is not available through the Advanced Reporting for DFSMShsm classic interface. Select the Tape Data Sets option from DFSMShsm Reports from Control Data Sets menu to create a Tape Data Sets report that shows information about the data sets residing on tape volumes. You can set up filters on tape data set name, tape number, or tape type (or any combination of these) so that the report includes only data sets whose attributes match your filters. Chapter 5. Using the CDS reports 57

64 Report information includes one row for each data set whose attributes match the specified filters. For each data set, the report information includes the following: Data set name Volume serial number Processing type for which DFSMShsm is using this volume Volume s capacity type Volume s unit name Whether the data set is a VSAM data set Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Usage notes Dump Data Sets report You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 9.4. Refer to Chapter 12, Viewing data set level data, for more information. This report contains the same information as the classic interface s Migration Level 2 Tapes, Spill Tapes, Cycle Tapes, Unassigned Tapes, and All Tapes in OCDS Inventory reports. Refer to OCDS Information on page 324 for more information about the classic report. Select the Dump Data Sets option from DFSMShsm Reports from Control Data Sets menu to create a Dump Data Sets report that shows information about the data sets residing on dump volumes. You can set up filters on data set name, volume serial number, dump date, or dump time (or any combination of these) so that the report includes only data sets whose attributes match your filters. Report information includes one row for each data set whose attributes match the specified filters. For each data set, the report information includes the following: Data set name, from DFSMShsm dump VTOC copy record Volume serial number Date and time at which the full-volume dump began, and the number of days elapsed since the full-volume dump began The volume s device type and hexadicmal representation of device type Volser of the migration level 1 volume where the dump copy resides Creation, expiration, and last reference dates for the data set 58 User s Guide

65 Number of data extents on the volume Data set organization Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Usage notes You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 9.5. Refer to Chapter 12, Viewing data set level data, for more information. This report contains the same information as the classic interface s Filter Volume Dump DSName Detail report. Refer to Dump volume DSName filter option on page 324 for more information about the classic report. Migrate Dsns Need Bkup report Select the Migrate Dsns Need Bkup option from DFSMShsm Reports from Control Data Sets menu to create a Migrated Data Sets Needing Backup report that shows information about the data sets residing on dump volumes. You can set up filters on data set name, migration volume serial number, migration level, data class name, storage class name, or management class name (or any combination of these) so that the report includes only data sets whose attributes match your filters. Report information includes one row for each data set whose attributes match the specified filters. For each data set, the report information includes the following: Data set name Volume serial number of the volume where the migration copy resides Volume serial number of primary volume from which the data set was migrated or to which the data set was recalled Data set organization Specific device category to which the data set should be backed up Whether the data set is in a VSAM SDSP data set Migration level on which the data set currently resides DFSMShsm internal data set name for the data set containing the migration copy Name of the DFSMS data class, storage class, and management class for the data set Date and time of the data set s most recent backup and the number of days elapsed since the most recent backup Chapter 5. Using the CDS reports 59

66 Migration Volumes report Whether the data set is managed by SMS Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Migration Volumes option from DFSMShsm Reports from Control Data Sets menu to create a Migration Volumes report that shows information about the volumes that have been used for migration activity. You can set up filters on the migration volume serial number or migration level (or both) so that the report includes only those volumes whose attributes match your filters. Report information includes one row for each volume whose attributes match the specified filters. For each volume, the report information includes the following: Volume serial number Volume s unit name Type processing for which the volume is used Migration level for which the volume is used Flags for the following: VSAM SDSP data set on the volume Automatic recall allowed Volume full Volume eligible for command migrations (Tape volumes only) DFSMShsm has written to the volume (Tape volumes only) Tape is empty (Tape volumes only) Tape is being used (Tape volumes only) Tape is unavailable (Tape volumes only) VSAM data set has migrated to the tape but the TTOC does not reflect the migration copy (Primary volumes only) Valid thresholds exist High and low thresholds of occupancy (Primary or level 2 DASD volumes only) Date and time of the most recent space management to or from the volume, and the number of days elapsed since the last space management to or from the volume Number of data sets and tracks processed during most recent volume space management 60 User s Guide

67 Total tracks on the volume Free tracks on the volume Volume s device type and hexadecimal representation of device type Maximum blocksize for the device Number of cylinders on the device and number of tracks per cylinder Maximum track length Number of 2K blocks per track (Tapes only) Percentage full, in tenths of a percent Mimum age of data sets migrated from the volume Current fragmentation index Number of days data sets on this volume must be inactive before becoming eleigible for deletion or retirement processin (Tape only) Tape density (Tape only) Date and time of the volume s most recent LSPACE, and the number of days elapsed since the volume s most recent LSPACE Whether the volume is managed by SMS Volume serial number of alternate volume Date and time when automatic primary migration was last performed, and the number of days elapsed since automatice primary migration was last performed Date and time at which volume was automatically backed up, and the number of days elapsed since the last automatic backup Date and time at which the last automatic dump was performed on the volume, and the number of days elapsed since the last automatic dump Date and time at which the last interval migration was performed on the volume, and the number of days elapsed since the last interval migration Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Usage notes You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 8.1. Refer to Chapter 11, Viewing volume level data, for more information. This report contains the same information as the classic interface s Migrated Data Sets by Migration Volume report. Refer to MCDS migration volume summary on page 215 for more information about the classic report. Chapter 5. Using the CDS reports 61

68 Backup Volumes report Select the Backup Volumes option from DFSMShsm Reports from Control Data Sets menu to create a Backup Volumes report that shows information about the volumes that DFSMShsm has used for backing up data. You can set up a filter on the backup volume serial number so that the report includes only those volumes whose attributes match your filter. Report information includes one row for each volume whose attributes match the specified filter. For each volume, the report information includes the following: Volume serial number Volume s unit name Whether the volume is full Type processing for which the volume is used Type capacity that can be used for the volume Whether DFSMShsm has written to the volume Percentage full, in tenths of a percent Date and time of first backup to the volume, and the number of days elapsed since the first backup Date and time of the last backup to the volume, and the number of days elapsed since the last backup Volume serial number of alternate volume Total tracks on the volume Free tracks on the volume Maximum track length for the device Threshold percentage of space used below which FULL flag is turned off during DASD cleanup Current fragmentation index Tape density Volume s device type and hexadecimal representation of device type Date and time when the volume was last spilled, and the number of days elapsed since the volume was last spilled Date and time when the volume was last cleaned, and the number of days elapsed since the volume was last cleaned 62 User s Guide

69 Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Usage notes Dump Volumes report You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 8.2. Refer to Chapter 11, Viewing volume level data, for more information. Select the Dump Volumes option from DFSMShsm Reports from Control Data Sets menu to create a Dump Volumes report that shows dump information from primary volumes. You can set up a filter on the dump volume serial number so that the report includes only those volumes whose attributes match your filter. Report information includes one row for each volume whose attributes match the specified filter. For each volume, the report information includes the following: Volume serial number Volume serial number of the volume from which the dump copy was created Volume s unit name Flags for the following: Volume unavailable for output selection Volume contains compacted data DFSMShsm has written to this volume Volume currently in use Volume is password protection Volume is RACF protected Tape volume exit needs to be called at DELVOL Volume contains part of at least one valid copy Volume s device type and hexadecimal representation of device type Tape density Dump class Volume expiration date and number of days until the expiration date Date and time when the dump copy was created, and the number of days elapsed since the dump copy was created Chapter 5. Using the CDS reports 63

70 Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Usage notes Dump Versions report You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 8.3. Refer to Chapter 11, Viewing volume level data, for more information. This report contains the same information as the classic interface s View Volume Dump Summary Information report. Refer to View volume dump summary information on page 300 for more information about the classic report. Select the Dump Versions option from DFSMShsm Reports from Control Data Sets menu to create a Dump Versions report that shows dump information from primary volumes. You can set up a filter on the dump volume serial number so that the report includes only those dump volume versions whose attributes match your filter. Report information includes one row for each dump volume version whose attributes match the specified filter. For each dump volume version, the report information includes the following: Volume serial number Volume serial number of the volume from which the dump copy was created Date and time when the full-volume dump began and the number of days elapsed since the full-volume dump began Flags for the following: Dump generation has a VTOC copy data set associated with it Reset option was specified for this dump generation The dump generation was created by a command-initiated request Dump generation is managed by SMS Volume is compressed Number of 2K blocks occupied by the VTOC copy data set Number of records written to VTOC copy data set Backup prefix at the time the full-volume dump began Length of the backup prefix 64 User s Guide

71 Volume serial number of migration level 1 volume on which the dump copy resides Volume s device type and hexadecimal representation of the device type Cycle date on which the full-volume dump began and number of days elapsed since the full-volume dump began Dump class Unit name Dump copy expiration date and the number of days until the dump copy expiration date is reached Tape expiration date Number of volumes containing part of this dump copy Serial numbers of volumes containing part of this dump copy Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Usage notes Tape Volumes report You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 8.4. Refer to Chapter 11, Viewing volume level data, for more information. This report contains the same information as the classic interface s Dump Class Information and Dump Volume Information reports. Refer to Dump class information (page 296), Dump volume information (page 299), and Filter volume dump detail (page 301) for more information about the classic reports. Select the Tape Volumes option from DFSMShsm Reports from Control Data Sets menu to create a Tape Volumes report that shows a list of volumes available for DFSMShsm processing. You can set up filters on tape number or tape type (or both) so that the report includes only those tape volumes whose attributes match your filters. Report information includes one row for each tape volume whose attributes match the specified filters. For each tape volume, the report information includes the following: Volume serial number Processing type for which DFSMShsm is using the volume Whether the volume is full Chapter 5. Using the CDS reports 65

72 The volume s capacity type Unit name Number of data sets on the volume Number of blocks written on the tape Volser of preceding volume that contains data belonging to first data set on the tape and volser of volume that contains data belong to the last data set on the tape Volser and unit name of the alternate volume Number of VSAM data sets on the tape Number of valid data sets on the tape Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Usage notes Tape Copy Needed report You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 8.5. Refer to Chapter 11, Viewing volume level data, for more information. This report contains the same information as the classic interface s Migration Level 2 Tapes, Spill Tapes, Unassigned Tapes, All Tapes in OCDS Inventory, and Filter Tape Volume Inventory reports. Refer to OCDS Information on page 247 for more information about the classic report. Select the Tape Copy Needed option from DFSMShsm Reports from Control Data Sets menu to create a Tape Copy Needed report that shows a list of volumes with tape copies that need to be updated. You can set up a filter on tape number so that the report includes only those tape volumes whose attributes match your filter. Report information includes one row for each tape volume whose attributes match the specified filter. For each tape volume, the report information includes the following: Volume serial number Processing type for which DFSMShsm is using the volume Date and time at which the last automatic TAPECOPY was performed on this volume and the number of days elapsed since the last automatic TAPECOPY Unit name for the alternate volume 66 User s Guide

73 Whether the volue uses new tape architecture Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Usage notes You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 8.6. Refer to Chapter 11, Viewing volume level data, for more information. This report is not available through Advanced Reporting for DFSMShsm s classic interface. ML1 Volume Free Space report Select the ML1 Volume Free Space option from DFSMShsm Reports from Control Data Sets menu to create an ML1 Volume Free Space report that shows a free space information for migration level 1 volumes. You can set up a filter on migration volume serial number so that the report includes only those tape volumes whose attributes match your filter. Report information includes one row for each migration volume whose attributes match the specified filter. For each migration volume, the report information shows the volume serial number and amount of free space (in tracks) on the volume: Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Usage notes You can also access this report from the Advanced Reporting for DFSMShsm Main Menu s option 8.8. Refer to Chapter 11, Viewing volume level data, for more information. This report is not available through Advanced Reporting for DFSMShsm s classic interface. Volumes Eligible for Backup report Select the Volumes Eligible for Backup option from DFSMShsm Reports from Control Data Sets menu to create a Volumes Eligible for Backup report that shows a primary, non-sms managed, or DFSMShsm-owned DASD volume that has been backed up or dumped by DFSMShsm. You can set up a filter on volume serial number so that the report includes only volumes whose attributes match your filters. Chapter 5. Using the CDS reports 67

74 Report information includes one row for each volume whose attributes match the specified filters. For each data set, the report information includes the following: Volume serial number Unit name Authorized Users report Indicators for whether the following processing is allowed on the volume: Whether automatic recall is allowed on the volume Whether automatic backup is allowed on the volume Whether the volume was SMS managed when it was last backed up or dumped Date and time of the last backup from the volume and the number of days elapsed since the last backup from the volume The volume s device type and its hexadecimal representation Volser of the old VTOC copy Date and time of the old VTOC copy Next volume serial number containing VTOC dump data Number of valid dump generations associated with the volume Source volume from which the dump copy was made Date and time at which the most recent dump copy was written Number of records written to the most recent dump copy Number of 2k blocks used by the last dump copy Dump class used by the most recent dump copy Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Authorized Users option from DFSMShsm Reports from Control Data Sets menu to create an Authorized Users report that shows a list of user attributes related to DFSMShsm processing. Because the report is based on the AUTH command, rather than on RACF security settings, you might not find this report useful if your site uses RACF to verify user ID authority for DFSMShsm commands. You can set up a filter on user ID so that the report includes information for only those user IDs whose attributes match your filter. 68 User s Guide

75 Report information includes one row for each user ID whose attributes match the specified filter. For each user ID, the report information includes the following: User ID Dump Classes report Volume serial number of the preferred migration volume Whether the user has space management authority Whether the user has authority to use the AUTH command Number of migrated data sets Number of migrations performed for the user and number of recalls performed for the user Maximum number of backup copies per data set to retain for this user Number of tracks used by migrated data sets Total number of tracks used Number of bytes transferred for the user Backup frequency, in days Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Dump Classes option from DFSMShsm Reports from Control Data Sets menu to create a Dump Classes report that shows a list of dump classes defined to the DFSMShsm host. You can set up a filter on dump class ID so that the report includes information for only those dump class IDs whose attributes match your filter. Report information includes one row for each dump class ID whose attributes match the specified filter. For each dump class ID, the report information includes the following: Dump class ID Flags indicating whether the following were specified when the dump class was defined: AUTOREUSE DATASETRESTORE RESET FREQUENCY Whether dump copies made to this dump class can be compressed Chapter 5. Using the CDS reports 69

76 Daily Statistics report Values specified for the dump class parameters RETPD, DAY, UNIT, and DISPOSITION Length of the DISPOSITION string Tape expiration date Number of VTOCCOPIES to create Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Daily Statistics option from DFSMShsm Reports from Control Data Sets menu to create a Daily Statistics report. You can set up a filter on date so that the report includes information for only those dates that match your filter. Report information includes one row for each date that matches the specified filter. For each date, the report information includes the following: Date Number of DFSMShsm statups on that date Number of DFSMShsm subtask ABENDs on that date Number of DFSMShsm shutdowns on that date Number of MWEs received from DFSMShsm SVC Number of times a recall was satisfied by a tape already mounted Number of times a recover was satisfied by a tape already mounted Total elapsed jobstep time, in milliseconds Number of events Time at which the last daily statistics record was written to the log Number of volume migrations performed Number of volumes backed up Number of tape backup volumes recycled Number of tape migration level 2 volumes recycled Number of system-requested volume dumps Number of volume dumps that failed Number of system-requested dump copies and number of user-requested dump copies Number of dump copies that failed 70 User s Guide

77 Queue wait time for dump requests Volume allocation wait time for dump requests How long each dump request took to process Total elapsed time for all dump requests to be processed Number of volume restores requested and the number that failed Number of data set restores requested and the number that failed Number of extent reductions Number of ABACKUPs requested and the number that failed Number of extra ML2 volume mounts by ABACKUP, due to recall takeaway Number of data sets reconnected and number of tracks reconnect to tape Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Daily Function Statistics report Select the Daily Function Statistics option from DFSMShsm Reports from Control Data Sets menu to create a Daily Function Statistics report that shows the daily statistics gathered by DFSMShsm for a specific function. You can set up a filter on date so that the report includes information for only those dates that match your filter. Report information includes one row for each DFSMShsm function on each date that matches the specified filter. For each function, the report information includes the following: Date Function description Number of non-vsam data sets processed Number tracks read and number of tracks written Number of failing requests Number of gigabytes read and number of gigabytes written Number of bytes read below 1 gigabyte and number of bytes written below 1 gigabyte Number of voluntary requests issued by user commands and the number of requests issued automatically by the system Total age of data sets processed, in days Chapter 5. Using the CDS reports 71

78 Total time elapsed between request being received and the end of processing Total time time requests were queued before processing started, in seconds Total elapsed processing time, in seconds Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Volume Statistics Records report Select the Volume Statistics Records option from DFSMShsm Reports from Control Data Sets menu to create a Volume Statistics Records report that shows information about volume activity for one day, one record per volume that is under DFSMShsm control on that day. You can set up a filter on volume serial number or date (or both) so that the report includes information for only those volumes and dates that match your filter. The report information includes the following: Volume serial number Date Volume type: primary, migration, automatic primary backup, spill backup, or offline Number of user-initiated migrations involving this volume that were forced by the system due to insufficient space Number of non-vsam data sets processed for the volume Minimum age of data sets migrated from the volume Number of allocated tracks on the volume Number of free tracks on the volume Occupancy target Occupancy before and after migration Percentage of volume space that is eligible for migration but has not been migrated How many times interval migrations have processed the volume on the date How many times interval migration has run and successfully reached the appropriate target occupancy Volume fragmentation entropy index 72 User s Guide

79 Number of seconds spent on system migrations for the volume Unit name Indicators for the following conditions: Whether a dump has been attempted on the volume Whether the most recent dump attempt on the volume failed Whether a restore has been attempted on the volume Whether the most recent restore attempt on the volume failed Number of dump copies requested for the volume Number of dump copies that failed for the volume Number of data set restores requested for the volume Number of data set restores that failed for the volume Volume capacity, in kilobytes Number of data sets reconnected Number of tracks reconnected Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Daily Volume Statistics Function report Select the Daily Volume Stats option from DFSMShsm Reports from Control Data Sets menu to create a Daily Volume Statistics Function report that shows the statistics gathered by DFSMShsm and maintained in the MCDS. You can set up a filter on volume serial number or date (or both) so that the report includes information for only those volumes and dates that match your filter. You can also specify that you want excluded from the report any record that contains only zeroes in its numeric fields. Each row in the report represents a specific function for a specific volume on a specific date. The report information includes the following: Volume serial number Date Which function was invoked under DFSMShsm for this volume on this date Number of non-vsam data sets processed Number of tracks read and number of tracks written Number of failing requests Chapter 5. Using the CDS reports 73

80 Number of bytes read below 1 gigabyte and number of bytes written below 1 gigabyte Number of voluntary requests issued by user commands Number of requests initiated automatically by the system Total age (in days) of the data sets processed by the function Total time that requests were queued before processing began Total time that requests were queued for volume mounts Total time elapsed for processing requests Whether all-zero records have been suppressed in the report Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Volume Summary Information report Select the Volume Summary option from DFSMShsm Reports from Control Data Sets menu to create a Volume Summary Information report that shows information about migration and backup data sets on online DASD volumes. The information shown in the report was gathered at specified intervals and was pulled from volumes currently online and from those listed in the MCDS and BCDS. You can set up a filter on volume serial number, volume type, or device number (or any combination of these) so that the report includes information for only those volumes that match your filters. The report information includes the following: Volume serial number Date Volume type: primary DASD, migration level 1, migration level 2, or backup Device number for the volume serial number The volume s character device and hexadecimal device types UCB address for the volume Date and time for the interval for as many as 14 intervals Number of backup data sets found for this volume and each of as many as 14 intervals Number of migration data sets found for this volume and each of as many as 14 intervals 74 User s Guide

81 Number of bytes backed up to this volume and each of as many as 14 intervals Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. DFSMS Class Summary Information report Select the DFSMS Class Summary option from DFSMShsm Reports from Control Data Sets menu to create a DFSMS Class Summary Information report that shows information about the migration and backup data sets in each DFSMS class. This data is collected from the MCDS and BCDS at specific intervals. You can set up a filter on DFSMS class name or class type (or both) so that the report includes information for only those classes that match your filter. The report information includes the following: Class name and type Interval date and time for as many as 14 intervals Number of backup data sets found for this class over as many as 14 intervals Number of migration data sets found for this class over as many as 14 intervals Number of bytes backed up to this class over as many as 14 intervals Number of bytes migrated to this class over as many as 14 intervals Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Chapter 5. Using the CDS reports 75

82 76 User s Guide

83 Chapter 6. Using the storage reports When you select the Storage Reports option from the HSM Report/Manager Main Menu, the Storage Reports menu panel appears, as shown in the following figure: StorMenu Advanced Reporting for DFSMShsm :49 Command ===> Scroll ===> PAGE Storage Reports: Row 1 of 6 Report Name Description 1 Unit Names Esoteric and Generic Unit Names 2 Volume Information Volume Level Information 3 Storage Groups Lists Storage Groups Unit Names report The HSM Host Information reports show detailed information detailed information about the units available to the system, volume information, and storage group information. These reports are described in the following sections of this chapter. Selectthe Unit Names option from the Storage Reports menu to create a Unit Names report. You can set up filters on unit name, type unit, or device class (or any combination of these) so that the report includes only those units whose attributes match your filters. Report information includes one row for each unit whose attributes that match the specified filters. For each unit, the report information includes the following: Unit name Unit type Device class associated with the unit Whether the unit is VIO-eligible Number of device classes in the unit name Number of generic device types in the unit name Number of volumes in the unit Hexadecimal representation of the first or only device class 77

84 Volume Information report Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Volume Information option from the Storage Reports menu to create a Volume Information report. You can set up filters on volume serial number, device number, storage group name, or whether the volume is SMS managed (or any combination of these) so that the report includes only those volumes whose attributes match your filters. Report information includes one row for each volume whose attributes that match the specified filters. For each volume, the report information includes the following: Volume serial number Device number for the volser Current status Character device type Hexadecimal representation of the device type Available cylinders Available tracks Total number of free tracks available and largest contiguous extent of free tracks Number of free cylinders and largest contiguous extent of free cylinders Percentage of volume being used Total free DSCBs Number of tracks per cylinder Physical size of a single track and usable length of a single track Number of free extents Number of free VTOC index records Mount attribute UCB address UCB common extension s address UCB prefix extension s address Volume indexed VTOC indicator Whether the volume is in use 78 User s Guide

85 Whether an active page data set resides on the volume Whether the volume is being shared with more than one CPU SMS status Storage Groups report SMS physical status Fragmentation index Name of the unit in which the volume belongs Name of the storage group in which the volume belongs (SMS volumes only) ID of last user to update the volume definition (SMS volumes only) Date and time when the volume definition was last updated (SMS volumes only) Track capacity Total capacity, in megabytes Total free space, in megabytes Largest free extent, in megabytes DCBs open to the volume Number of users of the volume Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Storage Groups option from the Storage Reports menu to create a Storage Groups report for the system. You can set up a filter on the storage group name so that the report includes only those storage groups whose names match your filter. Report information includes one row for each storage group whose name matches the specified filter. For each storage group, the report information includes the following: Storage group name Storage group type Status High and low thresholds Whether automatic backup processing is allowed on the group Whether automatic dump processing is allowed on the group Type of automatic migration allowed for the group Chapter 6. Using the storage reports 79

86 Guaranteed backup frequency User ID under which the storage group definition was last updated Date and time when the storage group definitioin was last updated Description of the storage group Overflow storage group value Maximum VIO data set size VIO unit type Names of dump class numbers 1, 2, 3, 4, and 5 Name of the system that performs automatic backup processing on the group Name of the system that performs automatic dump processing on the group Name of the system that performs automatic migration processing on the group OAM table space ID OAM cycle start time and OAM cycle end time, in hours Volume full threshold Name of optical or take libraries 1 through 8 Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. 80 User s Guide

87 Chapter 7. Using the DFSMS Information reports When you select the DFSMS Information option from the HSM Report/Manager Main Menu, the DFSMShsm Reports menu panel appears, as shown in the following figure: SMSMENU IBM Tivoli Advanced Reporting for DFSMShsm V2R :08 Command ===> Scroll ===> PAGE DFSMS Reports: Row 1 of 9 Report Name Description 1 SMS Base Configuration Shows basic SMS Information 2 Storage Groups Lists Storage Groups 3 Storage Classes Lists Storage Classes 4 Management Classes Lists Management Classes 5 Data Classes Lists Data Classes 6 Aggregate Groups Lists Aggregate Groups 7 SMS Volumes Lists Volumes 8 Class Summary Summary of DFSMS Classes TheDFSMS information reports display SMS configuration information and storage group, storage class, management class, data class, aggregate group attribute information, and SMS volume information for the system. These reports are described in the following sections of this chapter. SMS Base Configuration report Select the SMS Base Configuration option from DFSMShsm Reports menu to create an SMS Base Configuration report. The report information includes the following: Base configuration description User ID under which the configuration was last changed and the date and time at which the configuration was last changed System number PARMLIB suffix ASCB address AS ID ACDS data set name COMMDS data set name SCDS data set name Default management class 81

88 Default track size Default number of tracks per cylinder Default unit name Storage Groups report Storage class exit address Data class exit address Management class exit address Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Storage Groups option from DFSMShsm Reports menu to create a Storage Groups report. You can set up a filter on the storage group name so that the report includes only those storage groups whose names match your filter. Report information includes one row for each storage group whose name matches the specified filter. For each storage group, the report information includes the following: Storage group name Storage group type Status High and low thresholds Whether automatic backup processing is allowed on the group Whether automatic dump processing is allowed on the group Type of automatic migration allowed for the group Guaranteed backup frequency User ID under which the storage group definition was last updated Date and time when the storage group definitioin was last updated Description of the storage group Overflow storage group value Maximum VIO data set size VIO unit type Names of dump class numbers 1, 2, 3, 4, and 5 Name of the system that performs automatic backup processing on the group 82 User s Guide

89 Storage Classes report Name of the system that performs automatic dump processing on the group Name of the system that performs automatic migration processing on the group OAM table space ID OAM cycle start time and OAM cycle end time, in hours Volume full threshold Drive start threshold Name of optical or take libraries 1 through 8 Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Storage Classes option from DFSMShsm Reports menu to create a Storage Classes report that shows detailed information about the DFSMS storage classes available to the system. You can set up a filter on the storage class name so that the report includes only those storage classes whose names match your filter. Report information includes one row for each storage class whose name matches the specified filter. For each storage class, the report information includes the following: Storage class name Whether users can pre-allocate space for multi-volume data sets When the system returns after BSAM checks issued against PDSE members or compressed format data sets: before or after the data set has been written to a storage device Whether data processing continues after a device failure How concurrent copy affects data set placement Amount of direct access time needed, in milliseconds Specification on direct access bias for data sets in this class Amount of sequential access time needed, in milliseconds Specification on sequential access bias for data sets in this class Amount of time needed to locate, mount, and prepare media for data transfer, in milliseconds Sustained data transfer rate for striped data sets Chapter 7. Using the DFSMS Inforamtion reports 83

90 CF cache set name Indicator for relative importance of data in the storage class when it is accessed directly Indicator for relative importance of data in the storage class when it is accessed sequentially Whether DFSMS can attempt to allocate using a volume in the first listed storage group prior to allocating in the subsequent storage groups What role PAV capability plays in volume selection algorithms User ID under which the storage class definition was last updated Date and time when the storage class definitioin was last updated Description of the storage class Management Classes report Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Management Classes option from DFSMShsm Reports menu to create a Management Classes report that shows detailed information about the DFSMS management classes available to the system. You can set up a filter on the management class name so that the report includes only those management classes whose names match your filter. Report information includes one row for each management class whose name matches the specified filter. For each management class, the report information includes the following: Management class name Whether unused space can be released automatically for the data sets in the management class Maximum number of data set backups that will be kept Whether data set backups are kept after the data set is deleted How long backup versions of deleted data sets are retained When the data sets in this management class become eligible for automatic migration How data set migration to level 1 or level 2 is handled Whether the GDS expires or migrates after removal from the GDG How many of a GDG s newest generations have normal migration priority Minimum number of days between backups allowed for data sets in the management class 84 User s Guide

91 Data Classes report Whether data sets using the management class can migrate between shortage levels How many days unaccessed data sets or objects in the management class can exist before expiring Date on which the data sets or objects in the management clas expire or the number of days remaining before the data sets or objects expire Whether automatic backu is allowed for data sets or objects in this management class Whether concurrent copy can be used for incremental backups of the data sets associated with this management class Whether SMS uses the retention period or expiration date specified (by a user or a data class) for a data set Number of years, number of months, and number of days that must elapse after the creation date before class transition occurs Number of years, number of month, and number of days that must elapse after the last reference date before class transition occurs Date and time at which the management class was last updated and the user ID under which it was updated Note: Press the HELP function key to display full online help that describes the columns for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Data Classes option from DFSMShsm Reports menu to create a Data Classes report that shows detailed information about the DFSMS data classes available to the system. You can set up a filter on the data class name so that the report includes only those data classes whose names match your filter. Report information includes one row for each data class whose name matches the specified filter. For each data class, the report information includes the following: Data class name Organization of VSAM data sets allocated by the data class Record format and carriage control type assigned to non-vsam data sets allocated by the data class Logical record length used when allocating data sets in this data class, in bytes Size of each record key (non-vsam data sets) or size of each key field in a key-sequenced (VSAM) data set (VSAM data sets) Distance from record start to start of key field Chapter 7. Using the DFSMS Inforamtion reports 85

92 Unit of space used by this data class for allocations Multiplication factor used to determine allocated space Amount of space the data class allocates initially for a data set Amount of additional space the data class can allocate for a data set Number of blocks allocated for the directory of a PDS Default retention period or expiration date for data sets in this data class Maximum number of volumes that can be used to store a data set Type of allocation amount when extended format VSAM data sets begin allocation on subsequent new volumes (Key sequenced VSAM data sets only) Whether each sequence-set record is to be written as many times as possible on the first track of the data control area Whether VSAM writes each index record on one track of DASD as many times as possible (VSAM with ES, KS, LS, or RR record organization) Number of bytes allocated for each control interal in the data portion of a data set (VSAM only) In key-sequenced VSA data sets, the percentage of each control area that is set aside as free space (VSAM only) In key-sequenced VSA data sets, the percentage of each control interval that is set aside as free space How VSAM data sets are to be shared amongst regions of one system or across regions of multiple systems How VSAM data sets are to be shared among systems The format used to allocate data sets using this data class Whether extended addressability is provided Whether tape volumes or DASD data sets associated with the data class are compacted or compressed Type and format of the cartridge used for mountable tape data sets associated with the data class Number of recording tracks on the cartridge used for mountable tape data sets associated with the data class Whether scaling for performance feature is used Whether users can open the cluster repeatedly as a new cluster Whether storage allocated to the data component was formatted prior to the insertion of records during the initial load Whether data records can cross control interval boundaries Whether backup-while-open is allowed for the sphere 86 User s Guide

93 Aggregate Groups report Whether the sphere is to accessed with VSAM RLS is recoverable Whether to re-attempt allocation of data sets in the event of an allocation failure, and if so, the amount by which SMS reduces the requested space for subsequent allocation attempts How the system acquires and chooses buffering algorithms Maximum block size the system can allow when a program opens a data set for output and no value is available How VSAM RLS data (with greater than 4K control intervals defined to DFSMS CF cache structures) can be cached Maximum number of volumes DFSMS can add dynamically to an SMS managed data set Date and time at which the data class definition was last updated and the user ID under which the update occurred Description of the data class Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Aggregate Groups option from DFSMShsm Reports menu to create an Aggregate Groups report that shows detailed information about the DFSMS aggregate groups available to the system. You can set up a filter on the aggregate group name so that the report includes only those aggregate groups whose names match your filter. Report information includes one row for each aggregate group whose name matches the specified filter. For each aggregate group, the report information includes the following: Aggregate group name Prefix used for output data sets created by the backup process Name of the sequential data set that contains commands and instructions copied onto the control file volume after the backup control file Instruction data set member name Names for as many as five aggregate selection data sets and their respective members Management class associated with the aggregate group Number of aggregate output file copies to be created Accounting information, as specified on the DEFINE/ALTER panel for use in batch jobs Chapter 7. Using the DFSMS Inforamtion reports 87

94 SMS Volumes report Date and time at which the aggregate group definition was last updated and the user ID under which the update occurred Description of the aggregate group Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the SMS Volumes option from DFSMShsm Reports menu to create an SMS Volumes report that shows detailed information about the SMS volumes on the system. Report information includes one row for each SMS volume. Each row includes the following information: Volume serial number Device number for the volume serial number Volume status Device type for the volume and hexadecimal representation of the device type Number of cylinders available on the volume, number of free cylinders on the volume, and the largest contiguous extent of free cylinders on the volume Number of tracks available on the volume, number of free tracks on the volume, and the largest contiguous extent of free tracks on the volume Percentage of volume being used Number of free DSCBs on the volume Number of tracks per cylinder Track physical size Track usable length Number of free extents Number of free VTOC index records Mount attribute Address of the UCB Address of the UCB common extension Flags for the following: Volume indexed VTOC indicator Volume in use 88 User s Guide

95 Active page data set resides on the volume Volume is defined as being shared between more than one CPU Volume is managed by SMS SMS status SMS physical status Fragmentation index Name of the unit in which the volume belongs Name of the storage group in which the volume belongs Date and time at which the volume definition was last updated and the user ID under which the update occurred Track capacity Total capacity, in megabytes Total free space, in megabytes Largest free extent, in megabytes Number of DCBs open to the volume Number of users Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Class Summary Information report Select the Class Summary option from DFSMShsm Reports menu to create a Class Summary Information report that shows detailed information about the total migration and backup data sets in each DFSMS class. The report information is collected from the MCDS and BCDS at specific intervals. You can set up filters on DFSMS class name or class type (or both) so the report information includes only those classes whose attributes match your filters. Report information includes one row for each SMS class. Each row includes the following information: Class name and type Date and time for each of as many as 14 intervals Number of backup data sets found for the class in each interval Number of migration data sets found for the class in each interval Number of bytes backed up to this class in each interval Number of bytes migrated to this clsss in each interval Chapter 7. Using the DFSMS Inforamtion reports 89

96 90 User s Guide Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns.

97 Chapter 8. About the Advanced Reporting for DFSMShsm classic interface When you select option 5 from the Advanced Reporting for DFSMShsm Main Menu, the classic Advanced Reporting for DFSMShsm main menu appears: The classic interface is included in this release because so many Advanced Reporting for DFSMShsm users have used its features for years and might prefer to continue using it. For those users, the chapters in Section II of this guide provide information about using the classic interface. Chapter 14, The Command Processor, describes the interface to TSO command processing that allows you to invoke actions using the data elements in the various Dialog Manager Table entries, and to format data elements into batch control statements. Collectively, this functionality is referred to as the Command Processor. Chapter 15, PC extension for the Daily Statistics Record, provides examples of usage and functionality of the PC Extension, which allows data from the Daily Statistics Record to be placed into spreadsheets. Chapter 16. The Format and Save feature, discusses the Format and Save feature, giving examples of usage and functionality. Chapter 17, Data set recovery, discusses how to display a list of backup generations of a data set requiring recovery. Chapter 18, Processing migration/backup log file data, demonstrates the extended facilities of Advanced Reporting for DFSMShsm, using Migration/Backup data extracted from HSM LOGY. Chapter 19, Advanced Reporting for DFSMShsm support activities, contains an overview of the classic main menu s Display Last Master and Generate Master options. Chapter 20, Online batch process, explains option B Batch JCL Build for Onlines, and option P Selecting Plans to Run in Batch, from the classic main menu s Batch Processing section. Chapter 21, Control data set reports, provides detail about options C1 MCDS information, C2 BCDS information, and C3 - OCDS information, from the classic main menu s Reports From The Control Data Sets section. Chapter 22, HSM health reports, provides an overview of the Health reports function and discusses the classic main menu s option C4 - HSM Health Reports. Chapter 23, Volume dump information, discusses the classic main menu s Option C5 Volume Dump Information. 91

98 92 User s Guide Chapter 24, Log file reports, provides detail on the classic main menu s Reports From The Log File options.

99 Chapter 9. Performing administrative tasks When you select the Administrative Tasks option from the HSM Report/Manager Main Menu, the Administrative menu panel appears, as shown in the following figure: ADMNMENU IBM Tivoli Advanced Reporting for DFSMShsm V2R :43 Command ===> Scroll ===> PAGE Administrative Menu: Row 1 of 8 Report Name Description 1 Customization Customization Functions 2 Select Plans for Batch Select Plans to Run in Batch 3 Batch JCL Build Build JCL for Batch Processing 4 HSM Command Access Test User Access to HSM Commands 5 List Parmlib Members Interact With Parmlib Members 6 List PLAN Members Interact with PLAN Members 7 List COMMAND Members Interact with COMMAND Members Use the options on this menu to customize the Advanced Reporting for DFSMShsm processing parameter settings, manage batch processing plans, generate JCL for batch processes, test user access to HSM commands, and browse member lists of the PARMLIB and plan data sets. Customizing the processing parameter settings Select the Customization option on the Administrative Menu to display the Customization Menu, which is shown in the following figure. CustMenu Advanced Reporting for DFSMShsm :32 Command ===> Scroll ===> PAGE Customization Menu: Row 1 of 6 Report Name Description 1 JCL Parameters Change JCL Processing Parms 2 Data Set Name Parameters Override Data Set Names 3 Create Product Files Create Files Needed By Product Use the options on this menu to modify the parameters Advanced Reporting for DFSMShsm uses in JCL processing, override the names of the data sets used in processing, or create and populate the data sets used by Advanced Reporting for DFSMShsm for creating reports. 93

100 Changing JCL parameter settings Select the JCL Parameters option on the Customization Menu to display the JCL Parameters panel, where you can change the current value assigned to any of the JCL parameters used by Advanced Reporting for DFSMShsm processing. JclParms Advanced Reporting for DFSMShsm :54 Command ===> Scroll ===> PAGE Enter Values for the Following Command: Row 1 of 20 Parameter Used in JCL Processing: Job Card //ARHJOB Job Card // Job Card // Job Card //* Job Card //* Unit Name SYSALLDA Data Class Management Class Storage Class Space Type CYL Primary Allocation Secondary Allocation Block Size SYSOUT Class * JOB (11111),'ARH JOB CARD',REGION=8M, MSGLEVEL=(1,1),MSGCLASS=A,CLASS=A, NOTIFY=&SYSUID TYPRUN=SCAN Note: These values were set initially when the product was installed and configured; refer to Error! Reference source not found. on page 5 for more information about the initial configuration of these values. To change the parameter settings: 1. Type the new value over the old value in the appropriate field; press the HELP function key and use the online help to guide you as you specify the new values for the parameters. 2. Press Enter to save your changes. 3. Press the END function key to exit the JCL Parameters panel and display the Customization Menu. Overriding Advanced Reporting for DFSMShsm data set names Select the Data Set Name Parameters option on the Customization Menu to display the Data Set Names Override panel, where you can change the value assigned to any of the data sets used by Advanced Reporting for DFSMShsm processing. 94 User s Guide

101 DsnParms Advanced Reporting for DFSMShsm :15 Command ===> Scroll ===> PAGE Enter Values for the Following Command: Row 1 of 23 Data Set Name Overrides: PLANS Data Set PDCRUM.ARH.PLANS Commands Data Set..... PDCRUM.ARH.COMMANDS Migration CDS Migration CDS Migration CDS Migration CDS Backup CDS Backup CDS Backup CDS Backup CDS Offline CDS Log File Log File Log File Log File Log File Log File Log File Log File Log File Log File Note: These values were set initially when the product was installed and configured; refer to Installation on page Error! Bookmark not defined.for more information about the initial configuration of these values. To override the data set names: 1. Type the new value over the old value in the appropriate field; press the HELP function key and use the online help to guide you as you specify the new values for the data sets. 2. Press Enter to save your changes. 3. Press the END function key to exit the Data Set Name Overrides panel and display the Customization Menu. Creating Advanced Reporting for DFSMShsm files Select the Create Product Files option from the Customization Menu to display the Create Product Data Sets panel, where you can format and create the extraction data sets used by Advanced Reporting for DFSMShsm s classic interface. The following figure shows an example of the Create Product Data Sets panel. Chapter 9. Performing administrative tasks 95

102 Custom Advanced Reporting for DFSMShsm :32 Command ===> Create Product Data Sets (Job Submission is the preferred method.) These options will create the extraction data sets used in the classic ARH reports. 1. Submit job to format MCDS A. Format MCDS online 2. Submit job to format BCDS B. Format BCDS online 3. Submit job to format OCDS C. Format OCDS online 4. Submit job to format LOGX/Y D. Format LOG data online 5. Submit job for Health Reports 6. Submit job for Volume Dumps F. Format Volume Dumps online For most of these files, you can create and format the files using either of these methods: Have Advanced Reporting for DFSMShsm generate the JCL for you and then you submit it for execution Format the file directly in your TSO session without an opportunity to view or edit the JCL that creates and formats the file To submit a job that creates and formats the file: 1. In the Command line, type the appropriate option number and press Enter to display a submission panel, similar to the one shown in the following figure. JCLSub Advanced Reporting for DFSMShsm :45 Command ===> B Browse E Edit I Install S Submit C Cancel - Browse the JCL just created - Edit the JCL just created - Copy JCL just created to production library - Submit JCL just created - Cancel the submission of JCL just created ARH JCL has been created in the data set: ===> PDCRUM.TEMP.JCLFILE 2. If you want browse the JCL before submitting it, type B in the Command line and press Enter. When you have finished browsing the JCL, press the END function to return to the submission panel. 3. If you want to edit the JCL before submitting it, type E in the Command line and press Enter. When you have made the necessary changes to the JCL, save them and press the END function key to return to the submission panel. 4. If you want to copy the JCL to a production library, type I in the Command line and press Enter. On the Install JCL panel, make the appropriate specifications for the production library. 96 User s Guide

103 5. When the JCL is ready for submission, type S in the Command line and press Enter. To format the file directly, type the appropriate letter in the Command line and press Enter. When the file has been created and formatted, the Create Product Data Sets panel re-appears. Selecting plans to run in batch mode When you select the Select Plans for Batch option on the Administrative Menu, the Plans Menu panel appears. An example of the Plans Menu panel is shown in the following figure. PlansOnl Advanced Reporting for DFSMShsm :12 Command ===> 0 Display selected plans - Display all selected plans 1 MCDS Plans - Select MCDS plans 2 BCDS Plans - Select BCDS plans 3 OCDS Plans - Select OCDS plans 4 Log File Migrate/Backup - Select logfile migration plans 5 Log File Recall/Recover - Select logfile recall plans 6 Logfile Message Plans - Select logfile message plans 7 Dumped Volume Dsname Plans - Select dsname detail on dumps plans 8 Dumped Volume Plans - Select dump volume plans 9 Dump Volume Tape Plans - Select dump volume tape plans When you select an option from the Plans Menu, Advanced Reporting for DFSMShsm displays a list of plans of the appropriate type. An example of the OCDS plans list is shown in the following figure. PlansBat Advanced Reporting for DFSMShsm Row 1 to 5 of 5 Command ===> Scroll ===> PAGE Specify Sort Key==> Mlist Specify Sort Type=> A for Ascending or D for Descending Select Plan for batch execution. You may P (Print), or F (Create a Flat file) Command Mlist Action Title TVOL@LBL FIELDS FOR TAPE VOLUME PLANS TVOL001 DISPLAY TAPES WITH 1 YEAR OLD DATA TVOL002 DISPLAY FULL TAPES LT 50 PERCENT VALID TVOL017 PRINT L2 TAPES FULL BY PCT VALID TVOL018 PRINT TAPES WITH DATA GT 1 YEAR OLD ******************************* Bottom of data ******************************** You can sort the plan list into ascending or descending order by Mlist. To select a plan for batch processing: 1. In the Command column next to the appropriate plan, specify how you want the plan executed: type F if you want a flat file created or type P if you want it written to SYSOUT for viewing. Chapter 9. Performing administrative tasks 97

104 2. Press Enter. 3. Press the END function key to re-display the Plans Menu. 4. Type 0 (zero) in the Command line on the Plans Menu and press Enter to display a list of the plans you have selected for batch execution. Note: At this point, the plans are selected for batch execution, but they have not been executed. Use the information in Building JCL for batch processing (page 98) to execute the selected plans. Building JCL for batch processing Select the Batch JCL Build option from the Administrative Menu to display the JCL Build menu panel, where you can specify what type of JCL you want built and executed. An example of the JCL Build menu is shown in the following figure. JCLBuild Advanced Reporting for DFSMShsm :10 Command ===> 1 All Extracts - Build the extractions for ARH 2 Batch TSO plans - Build the JCL to run plans 3 LOGX/Y Format - Build the LOGX/Y Format job 4 Health Reports - Build JCL for HSM health reports 5 MCDS Format - Build JCL for MCDS extraction 6 BCDS Format - Build JCL for BCDS extraction 7 OCDS Format - Build JCL for OCDS extraction 8 Volume Dumps - Build JCL for Volume Dump reports 9 PC Download Extract - Build JCL for PC download extraction If you have previously selected plans for batch execution, you can begin building the JCL for executing them from this panel. To build JCL for batch execution: 1. Type the number of the appropriate option in the Command line and press Enter to display the JCL Submission panel. If you are building JCL for executing previously selected plans, select option If you want to browse the JCL before submitting it, type B in the Command line and press Enter. When you have finished browsing, press the END function key to return to the JCL Build panel, then go directly to step User s Guide

105 3. If you want to edit the JCL before submitting it, type E in the Command line and press Enter. When you have finished making changes, save your changes and press the END function key to return to the JCL Build panel, then go directly to step 5. The following figure shows example JCL for executing a plan. EDIT PDCRUM.H Columns Command ===> Scroll ===> ****** ***************************** Top of Data ************************ //ARHJOB JOB (11111),'ARH JOB CARD',REGION=8M, // MSGLEVEL=(1,1),MSGCLASS=A,CLASS=A, // NOTIFY=TWKALE TYPRUN=SCAN //* //* //JOBLIB DD DISP=SHR,DSN=ARH0202.JKS.LOAD // DD DISP=SHR,DSN=ARH0202.PDNEGO.LOAD // DD DISP=SHR,DSN=ARH0202X.QABETA.LOAD //IKJEFT01 EXEC PGM=IKJEFT01,REGION=8M,DYNAMNBR= //SYSPROC DD DISP=SHR,DSN=ARH0202X.QABETA.CLIST //PLANS DD DISP=SHR,DSN=PDCRUM.ARH.PLANS //COMMANDS DD DISP=SHR,DSN= PDCRUM.ARH.COMMANDS //SORTWK01 DD UNIT=SYSALLDA,SPACE=(CYL,(50)) //SORTWK02 DD UNIT=SYSALLDA,SPACE=(CYL,(50)) //SORTWK03 DD UNIT=SYSALLDA,SPACE=(CYL,(50)) //SYSOUT DD SYSOUT=* //SYSTSPRT DD SYSOUT=* //SMST1 DD DSN=ARH0202X.QABETA.OPFX.SMST1,DISP=SHR //SMST2 DD DSN=ARH0202X.QABETA.OPFX.SMST2,DISP=SHR //SMST3 DD DSN=ARH0202X.QABETA.OPFX.SMST3,DISP=SHR //BKPT1 DD DSN=ARH0202X.QABETA.OPFX.BKPT1,DISP=SHR //BKPT2 DD DSN=ARH0202X.QABETA.OPFX.BKPT2,DISP=SHR //BKPT3 DD DSN=ARH0202X.QABETA.OPFX.BKPT3,DISP=SHR //TAPTRACE DD DSN=ARH0202X.QABETA.OPFX.TAPTRACE,DISP=SHR //DEVTABLE DD DSN=ARH0202X.QABETA.OPFX.DEVTABLE,DISP=SHR //LOGFILE DD DSN=ARH0202X.QABETA.OPFX.ARHMIG,DISP=SHR //DGNFILE DD DSN=ARH0202X.QABETA.OPFX.DGNFILE,DISP=SHR //SYSTSIN DD * %ARHT0114 ARH MCDSSMS FLAT PDCRUM SYSALLDA * NULLFILE MCDS@DCT 4. If you want to copy the JCL before submitting it, type I in the Command lien and press Enter. When you have specified the appropriate information on the JCL Submission panel, press the END function key to return to the JCL Build panel, then go directly to step To submit the JCL, type S in the Command line and press Enter. Testing user access to HSM commands There might be occasions where it would be convenient to be able to see to which HSM commands a given user ID has access. You can do this from the Administrative Menu. Chapter 9. Performing administrative tasks 99

106 To test user access to HSM commands: 1. Select the HSM Command Access option from the Administrative Menu to display the User DFSMShsm Access panel. 2. On the User DFSMShsm Access panel, enter the appropriate user ID in the User ID field and press Enter to display the information for that user ID. The following figure shows the HSM command access information for user TWEAK. HSMCmdAc Advanced Reporting for DFSMShsm :55 Command ===> Scroll ===> PAGE User DFSMShsm Access: Row 1 of 49 Command Command Facility Access Type User Id ABACKUP STGADMIN.ARC.ABACKUP Read Admin TWEAK ARECOVER STGADMIN.ARC.ARECOVER Read Admin TWEAK ADDVOL STGADMIN.ARC.ADDVOL Read Admin TWEAK ALTERDS STGADMIN.ARC.ALTERDS Read Admin TWEAK AUDIT STGADMIN.ARC.AUDIT Read Admin TWEAK AUTH STGADMIN.ARC.AUTH Read Admin TWEAK BACKDS STGADMIN.ARC.BACKDS Read Admin TWEAK BACKVOL STGADMIN.ARC.BACKVOL Read Admin TWEAK BDELETE STGADMIN.ARC.BDELETE Read Admin TWEAK CANCEL STGADMIN.ARC.CANCEL Read Admin TWEAK DEFINE STGADMIN.ARC.DEFINE Read Admin TWEAK DELETE STGADMIN.ARC.DELETE Read Admin TWEAK DELVOL STGADMIN.ARC.DELVOL Read Admin TWEAK DISPLAY STGADMIN.ARC.DISPLAY Read Admin TWEAK EXPIREBV STGADMIN.ARC.EXPIREBV Read Admin TWEAK 3. Press the END function key to return to the Administrative Menu. Listing PARMLIB data set members You can use the Administrative Menu to generate a list of the members in the PARMLIB data sets. To list the PARMLIB data set members: 1. Select the List Parmlib Members option from the Administrative Menu to display the Members in the Parmlib Data Sets panel. 2. In the Member Name field on the Members in the Parmlib Data Sets panel, specify a mask that will match the member names of interest. Refer to Filtering pattern masks on page Error! Bookmark not defined.for information about specifying masking characters. 3. In the Data Set Name field, specify a mask that matches the data set names of interest. 4. Press Enter to display the member list. Use the HELP function key to guide you as you make entries and use line commands on this panel. 100 User s Guide

107 5. Press the END key to return to the Administrative Menu. Listing PLAN data set members You can use the Administrative Menu to generate a list of the members in the PLAN data sets. To list the PLAN data set members: 1. Select the List PLAN Members option from the Administrative Menu to display the Members in the Plans Data Sets panel. 2. In the Member Name field on the Members in the Plans Data Sets panel, specify a mask that will match the member names of interest. Refer to Filtering pattern masks on page Error! Bookmark not defined.for information about specifying masking characters. 3. In the Data Set Name field, specify a mask that matches the data set names of interest. 4. Press Enter to display the member list. Use the HELP function key to guide you as you make entries and use line commands on this panel. 5. Press the END key to return to the Administrative Menu. Listing COMMAND data set members You can use the Administrative Menu to generate a list of the members in the COMMAND data sets. To list the PLAN data set members: 1. Select the List COMMAND Members option from the Administrative Menu to display the Members in the Commands Data Sets panel. 2. In the True Member Name field on the Members in the Commands Data Sets panel, specify a mask that will match the member names of interest. Refer to Filtering pattern masks on page Error! Bookmark not defined.for information about specifying masking characters. 3. In the Data Set Name field, specify a mask that matches the data set names of interest. 4. Press Enter to display the member list. Use the HELP function key to guide you as you make entries and use line commands on this panel. 5. Press the END key to return to the Administrative Menu... Chapter 9. Performing administrative tasks 101

108 102 User s Guide

109 Chapter 10. Viewing product information When you select the Product Information option from the HSM Report/Manager Main Menu, the Product Menu panel appears, as shown in the following figure: PRDMENU IBM Tivoli Advanced Reporting for DFSMShsm V2R :51 Command ===> Scroll ===> PAGE Product Menu: Row 1 of 9 Report Name Description 1 Version/Release Data Product Name and Release Data 2 Product Data Sets Data Sets Used by the Product 3 Address Space Allocations A/S Active Allocation List 4 Address Space Enq Data Enqs Held by the Address Space 5 Address Space Memory A/S Current Memory Usage 6 Product Messages Product Message Documentation 7 Product Work Data Sets Data Sets Used for Processing 8 RCDS Status Information Reporting Control Data Set Information Use the options on this panel to do any of the following: View product version and release level information. List the data sets used by Advanced Reporting for DFSMShsm during processing. List the data sets allocated to the Advanced Reporting for DFSMShsm address space. List the enqueues being held by the product address space Display the amount of virtual storage being used by the product address space. View Advanced Reporting for DFSMShsm messages View information about the data sets Advanced Reporting for DFSMShsm uses to store data and generate reports View status information about the Reporting Control Data Set (RCDS) Viewing version and release level data Select the Version/Release Data option from the Product Menu to display the Product Version/Release Information panel, which shows you the Product Version/Release Information panel, as shown in the following figure. 103

110 PrdRlVer Advanced Reporting for DFSMShsm :41 Command ===> Scroll ===> PAGE Product Version/Release Information: Row 1 of 8 Product Name: Advanced Reporting for DFSMShsm Product Release: (c) Copyright Mainstar Software, Inc All Rights Reserved. 1990, 2008 *Trademark of: Mainstar* Mainstar Software, Inc This panel provides the version and release level for Advanced Reporting for DFSMShsm and shows copyright and trademark information. To exit the panel and redisplay the Product Menu, press the END function key. Listing data sets used during Advanced Reporting for DFSMShsm processing Select the Product Data Sets option from the Product Menu to display the Data Sets Being Used by this Product panel, as shown in the following figure. ProdDsns Advanced Reporting for DFSMShsm :47 Command ===> Scroll ===> PAGE Data sets being used by this product: Row 1 of 10 Line Commands are... : B V E BD BV HB LC Dsn Job Job Cmd Data Set Name Type Name Number ARH0202.JKS.LOAD STEPLIB ARH0202 S ARH0202.PDNEGO.LOAD STEPLIB ARH0202 S ARH0202X.QABETA.LOAD STEPLIB ARH0202 S ARH0202X.QABETA.CLIST CLIST ARH0202 S ARH0202X.QABETA.COMMANDS COMMANDS ARH0202 S ARH0202X.QABETA.MESSAGES MESSAGES ARH0202 S ARH0202X.QABETA.PLANS PLANS ARH0202 S ARH0202X.QABETA.PLIB PLIB ARH0202 S ARH0202X.QABETA.PARMLIB PARMLIB ARH0202 S ARH0202X.QABETA.SAMPLIB SAMPLIB ARH0202 S The Data Sets Being Used by this Product panel shows you the data set names, data set type, job name and job number. By selecting an individual data set and using the appropriate line command, you can do any of the following from this panel: Browse the data set View the data set 104 User s Guide

111 Edit the data set Display backup information for the data set Display information about the backup versions available for the data set Back up the data set Display LISTCAT information for the data set To exit the Product DSNs panel and display the Product Menu, press the END function key. Listing data sets allocated to the Advanced Reporting for DFSMShsm address space Select the Address Space Allocation option from the Product Menu to display the Data Sets Allocated to Address Space panel, as shown in the following figure. STCAlloc Advanced Reporting for DFSMShsm :58 Command ===> Scroll ===> PAGE Data Sets Allocated to address space(s): Row 1 of 5 More > Line Commands are... : LC VOL DD Cmd Data Set Name Name Volser Member Disp ARH0202.JKS.LOAD STEPLIB SMS001 SHR ARH0202.PDNEGO.LOAD SMS004 SHR ARH0202X.QABETA.LOAD SMS018 SHR ARH0202X.QABETA.PARMLIB PARMLIB SMS018 SHR SYS08247.T RA000.ARH0202.T H01 ARHLOG WORK04 NEW The Data Sets Allocated to Address Space panel shows the following information for each data set: Data set name Name of the DD statement to which the data set is allocated Serial number of the volume on which the data set resides Name of the member allocated in the data set Disposition of allocation Normal and conditional dispositions of allocation Number of EXCPs to the data set Job name for the address space Job number of the address space Chapter 10. Viewing product information 105

112 By selecting an individual data set and using the appropriate line command, you can do any of the following from this panel: Display primary volume information Display LISTCAT information for the data set To exit the Data Sets Allocated to Address Space panel and display the Product Menu, press the END function key. Listing enqueues held by the Advanced Reporting for DFSMShsm address space Select the Address Space Enq Data option from the Product Menu to display the ENQ Information for Address Space panel, as shown in the following figure. STCEnqs Advanced Reporting for DFSMShsm :12 Command ===> Scroll ===> PAGE ENQ Information for address space(s): Row 1 of 7 More > Major Minor Req Name Name Type SYSZJES2 SJB Exc ARH Advanced Reporting for DFSMShsm02.02 Exc SYSDSN ARH0202X.QABETA.PARMLIB Shr SYSDSN ARH0202.PDNEGO.LOAD Shr SYSDSN ARH0202.JKS.LOAD Shr SYSDSN SYS08247.T RA000.ARH0202.T H01 Exc SYSDSN ARH0202X.QABETA.LOAD Shr The ENQ Information for Address Space panel provides the following information for each enqueue: Major name and the first portion of the minor name Request type for the enqueue Name of the job issuing the request Address space ID of the job issuing the request System name associated with the enqueue Request level and request scope Request status Total number of users waiting for the resource, number of users waiting for exclusive use of the resource, and number of users waiting for shared use of the resource Number of resource owners for the enqueue TCB address associated with the enqueue 106 User s Guide

113 SVRB address that issued the enqueue ECB address of the task that issued the enqueue request Whether the step must complete for the enqueue Device number associated with the enqueue The major and minor names in hexadecimal format Name of the job (address space) To exit the ENQ Information for Address Space panel and display the Product Menu, press the END function key. Displaying address space virtual storage information Select the Address Space Memory option from the Product Menu to display the Address Space Memory Information panel, as shown in the following figure. STCStor Advanced Reporting for DFSMShsm :29 Command ===> Scroll ===> PAGE Address Space Memory Information: Row 1 of 31 Job Name Description Data ARH0202 Private Region Start Address ARH0202 Size of Private Region 008FA000 ARH0202 Size of Private Region (K) 9192 ARH0202 Current Top Of Private Region ARH0202 Max Size Of Private Region 008FA000 ARH0202 Max Size Of Private Region (K) 9192 ARH0202 Bytes Alloc Private Region ARH0202 Bytes Alloc Private Region (K) 192 ARH0202 Bytes Alloc LSQA And SWA ARH0202 Bytes Alloc LSQA And SWA (K) 196 ARH0202 IEFUSI Specification Of LIMIT FFFFFFFF ARH0202 IEFUSI Specification Of VVRG FFFFFFFF ARH0202 Extended Storage Details ARH0202 E-Private Region Start Address 0A ARH0202 Size of E-Private Region 75E00000 The panel displays job name (address space), a description of the type of memory, and data related to memory. To exit the Address Space Memory Information panel and display the Product Menu, press the END function key. Displaying product message documentation Select the Product Messages option from the Product Menu to display the Members in Messages Data Sets panel, which provides information about the messages generated during Advanced Reporting for DFSMShsm processing. Chapter 10. Viewing product information 107

114 You can set up filters on messaged ID, member name, or message data set name (or any combination of these) so the resulting report includes information for only those messages whose attributes match the filters. The Data Sets Allocated to Address Space panel shows the following information for each message: Message ID Name of the member containing the message Name of the data set to which the member containing the message documentation belongs The number of the concatenation in which the member containing the message documentation belongs DD name being processed MLT number Whether the member is an alias Data from the first line in the message member for the message Note: Use the HELP function key to display further information about the columns and commands available on the Members in the Messages Data Sets panel. Use the LEFT and RIGHT function keys to scroll the display to show all the columns. Displaying product work data set information Select the Product Work Data Sets option from the Product Menu to display the Data Set List panel, which provides information about data sets Advanced Reporting for DFSMShsm uses for storing report data and to generate the reports. The Data Set List panel provides the following information about each data set: Data set name Entry type for the data set Volume serial number for the first (or only) volume on which the data set resides Note: Use the HELP function key to display further information about the columns and commands available on the Members in the Messages Data Sets panel. 108 User s Guide

115 Displaying RCDS status information Select the RCDS Status Information option from the Product Information menu to display the Reporting Control Data Set Status panel, which provides information about data set Advanced Reporting for DFSMShsm uses for storing report data and to generate the reports. The RCDS is created by Advanced Reporting for DFSMShsm if you have set the RCDS and RCDS_PARMS keywords were set during product configuration (see Chapter 2, Installation for more information about these keywords). The RCDS stores DFSMShsm summary information: For each online volume, Advanced Reporting for DFSMShsm collects volume space usage and DFSMShsm information and stores information about the number of migration and backup data sets residing on those volumes. For each DFSMS class defined in the system (data, management, and storage classes), the RCDS stores information about the number of migration and backup data sets using those classes. The Reporting Control Data Set Status panel provides the following information about each data set: Description of the data found Data found Chapter 10. Viewing product information 109

116 110 User s Guide

117 Chapter 11. Viewing volume level data When you select the Volume Level Data option from the HSM Report/Manager Main Menu, the Volume Level Reports and Commands menu panel appears, as shown in the following figure: VOLCMD IBM Tivoli Advanced Reporting for DFSMShsm V2R :45 Command ===> Scroll ===> PAGE Volume Level Reports and Commands: Row 1 of 20 Report/Command Description DFSMShsm Information: 1 Migration Volumes View Migration Volumes 2 Backup Volumes View Backup Volumes 3 Dump Volumes View Dump Volumes 4 Dump Versions View Dump Volume Versions 5 Tape Volumes View Tape Volumes 6 Tape Copy Needed View Tapes Needing Copying 7 Mounted Volumes Volumes Used by DFSMShsm 8 ML1 Volume Free Space Migration Level 1 Volume Space 9 Volume Statistics Records Statistics Records for Volumes 10 Daily Volume Stats Volume Statistics By Function 11 Volumes Eligible for Backup Volumes Eligible for Backup Services Other Information: 12 Primary Dasd Volumes Volumes on Primary Dasd 13 Volume Summary Summary of Volume Usage Use the options on this menu to access the reports and commands available for displaying backup and migration volume information, version information for volumes with full volume dumps, tape volume information, free space information for migration level 1 volumes, and primary DASD volume information. Usage notes The nine reports generated by selecting options from the Volume Level Reports and Commands menu are duplicates of the reports generated by selecting options on the DFSMShsm Reports from the CDSs menu or from the HSM Host Information menu or from the Storage Reports menu. 111

118 Migration Volumes report Backup Volumes report Select the Migration Volumes option from the Volume Level Reports and Command menu to display the Migration Volumes report. The Migration Volumes report accessed from the Volume Level Reports and Command menu is the same report that is generated by selecting the Migration Volumes option from the Reports from the CDSs menu. Refer to Migration Volumes report on page 60 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Dump Volumes report Select the Backup Volumes option from the Volume Level Reports and Command menu to display the Backup Volumes report. The Backup Volumes report accessed from the Volume Level Reports and Command menu is the same report that is generated by selecting the Backup Volumes option from the Reports from the CDSs menu. Refer to Backup Volumes report on page 62 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Dump Volumes option from the Volume Level Reports and Command menu to display the Dump Volumes report. The Dump Volumes report accessed from the Volume Level Reports and Command menu is the same report that is generated by selecting the Dump Volumes option from the Reports from the CDSs menu. Refer to Dump Volumes report on page 63 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. 112 User s Guide

119 Dump Versions report Tape Volumes report Select the Dump Versions option from the Volume Level Reports and Command menu to display the Dump Version report. The Dump Versions report accessed from the Volume Level Reports and Command menu is the same report that is generated by selecting the Dump Versions option from the Reports from the CDSs menu. Refer to Dump Versions report on page 64 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Tape Copy Needed report Select the Tape Volumes option from the Volume level Reports and Command menu to display the Tape Volumes report. The Tape Volume report accessed from the Volume Level Reports and Commands menu is the same report that is generated by selecting the Tape Volumes option from the Reports from the CDSs menu. Refer to Tape Volumes report on page 65 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Tape Copy Needed option from the Volume level Reports and Command menu to display the Tape Copy Needed report. The Tape Copy Needed report accessed from the Volume Level Reports and Commands menu is the same report that is generated by selecting the Tape Copy Needed option from the Reports from the CDSs menu. Refer to Tape Copy Needed report on page 66 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Chapter 11. Viewing volume level data 113

120 Mounted Volumes report Select the Mounted Volumes option from the Volume level Reports and Command menu to display the Mounted Volumes report. The Mounted Volumes report accessed from the Volume Level Reports and Commands menu is the same report that is generated by selecting the Mounted Volumes option from the HSM Host Information menu. Refer to Mounted Volumes report on page 38 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. ML1 Volume Free Space report Select the ML1 Volume Free Space option from the Volume level Reports and Command menu to display the ML1 Volume Free Space report. The ML1 Volume Free Space report accessed from the Volume Level Reports and Commands menu is the same report that is generated by selecting the ML1 Volume Free Space option from the Reports from the CDSs menu. Refer to ML1 Volume Free Space report on page 67 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Volume Statistics Records report Select the Volume Statistics Records option from the Volume level Reports and Command menu to display the Volume Statistics Records report. The Volume Statistics Records report accessed from the Volume Level Reports and Commands menu is the same report that is generated by selecting the Volume Statistics Records option from the Reports from the CDSs menu. Refer to Volume Statistics Records report on page 72 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. 114 User s Guide

121 Daily Volume Statistics report Select the Daily Volume Statistics option from the Volume level Reports and Command menu to display the Daily Volume Statistics Functions report. The Daily Volume Statistics Functions report accessed from the Volume Level Reports and Commands menu is the same report that is generated by selecting the Daily Volume Statistics option from the Reports from the CDSs menu. Refer to Daily Volume Statistics Function report on page 73 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Volumes Eligible for Backup report Select the Volumes Eligible for Backup option from the Volume level Reports and Command menu to display the Volumes Eligible for Backup report. The Volumes Eligible for Backup report accessed from the Volume Level Reports and Commands menu is the same report that is generated by selecting the Volumes Eligible for Backup option from the Reports from the CDSs menu. Refer to Volumes Eligible for Backup report on page 67 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Primary DASD Volumes report Select the Primary DASD Volumes option from the Volume level Reports and Command menu to display the Primary DASD Volumes report. The Primary DASD Volumes report accessed from the Volume Level Reports and Commands menu is the same report that is generated by selecting the Volume Information option from the Storage Reports menu. Refer to Volume Information report on page 78 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Chapter 11. Viewing volume level data 115

122 Volume Summary report Select the Volume Summary option from the Volume level Reports and Command menu to display the Volume Summary report. The Volume Summary report accessed from the Volume Level Reports and Commands menu is the same report that is generated by selecting the Volume Summary option from the Reports from the CDSs menu. Refer to Volume Summary Information report on page 74 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. 116 User s Guide

123 Chapter 12. Viewing data set level data When you select the Data Set Level Data option from the HSM Report/Manager Main Menu, the Data Set Level Reports and Commands menu panel appears, as shown in the following figure: DSNCMD IBM Tivoli Advanced Reporting for DFSMShsm V2R :07 Command ===> Scroll ===> PAGE Data Set Level Reports and Commands: Row 1 of 27 Report/Command Description DFSMShsm Information: 1 Migration Information View Migration Data 2 Backup Information View Backup Data 3 Backup Versions View Backup Versions 4 Tape Information View Tape Information 5 Dump Information View Dump Information 6 Migrate Dsns Need Bkup Migrate Dsns Needing a Backup DFSMShsm Commands: 7 Migrate Data Set Migrate a Data Set 8 Backup Data Set Create a Backup Copy 9 Recall Data Set Recall a Migrated Data Set 10 Recover Backup Copy Recover a Backed Up Data Set 11 Delete Migration Copy Delete a Migrated Data Set 12 Delete Backup Copy Delete a Backup Version Other Commands: 13 List Catalog Data Perform a LISTCAT on a Data Set 14 Delete Data Set Delete a Data Set on Dasd 15 Browse Contents Browse a QSAM Data Set 16 View Contents View a QSAM Data Set 17 Edit Contents Edit a QSAM Data Set Use the options on this menu to view reports and access the commands available for use on individual data sets. From this menu, you can do all of the following: Display information for data sets residing on a migration volume. Display data set backup information. Display information about data sets residing on a tape volume. View dump information Identify migration data sets needing a backup List catalog information for a data set. Migrate a data set from DASD to a migration volume. Create a backup copy of a data set. 117

124 Recall a migrated data set to primary DASD. Recover a backup copy of a data set. Delete a data set residing on a primary or migration volume. Run a LISTCAT on a data set Delete a data set on DASD Browse, view, or edit the contents of a partitioned or physical sequential data set. Displaying migration information Select the Migration Information option from the Data Set Level Reports and Commands menu to display the Migrated Data Sets report. The Migrated Data Set report accessed from the Data Set Level Reports and Commands menu is the same report that is generated by selecting the Migrated Data Sets option from the Reports from the CDSs menu. Refer to Migrated Data Sets report on page 52 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Displaying backup information Select the Backup Information option from the Data Set Level Reports and Commands menu to display the Backup Data Sets report. The Backup Data Set report accessed from the Data Set Level Reports and Commands menu is the same report that is generated by selecting the Backup Data Sets option from the Reports from the CDSs menu. Refer to Backup Data Sets report on page 54 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Displaying backup versions information Select the Backup Versions Information option from the Data Set Level Reports and Commands menu to display the Backup Versions report. 118 User s Guide

125 Displaying tape information The Backup Versions report accessed from the Data Set Level Reports and Commands menu is the same report that is generated by selecting the Backup Versions option from the Reports from the CDSs menu. Refer to Backup Versions report on page 55 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Displaying dump information Select the Tape Information option from the Data Set Level Reports and Commands menu to display the Tape Data Sets report. The Tape Data Set report accessed from the Data Set Level Reports and Commands menu is the same report that is generated by selecting the Tape Data Sets option from the Reports from the CDSs menu. Refer to Tape Data Sets report on page 57 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Select the Dump Information option from the Data Set Level Reports and Commands menu to display the Dump Data Sets report. The Dump Data Set report accessed from the Data Set Level Reports and Commands menu is the same report that is generated by selecting the Dump Data Sets option from the Reports from the CDSs menu. Refer to Dump Data Sets report on page 58 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Chapter 12. Viewing data set level data 119

126 Migration Dsns Need Bkup report Select the Migrtion Dsns Need Bkup option from the Data Set Level Reports and Commands menu to display the Migration Data Sets Needing Backup report. The Migration Data Sets Needing Backup report accessed from the Data Set Level Reports and Commands menu is the same report that is generated by selecting the Migration Dsns Need Bkup option from the Reports from the CDSs menu. Refer to Migrate Dsns Need Bkup report on page 58 for more detailed information about the data in this report. Note: Press the HELP function key to display full online help that describes the report columns and the available line commands for this report. Scroll the display by using the RIGHT and LEFT function keys to show all report columns. Migrating a data set to a migration volume Select the Migrate Data Set option from the Data Set Level Reports and Commands menu to migrate one or more data sets from primary DASD to a migration volume. To migrate data sets to a migration volume: 1. Select option 6 on the Data Set Level Reports and Commands menu to display the Enter Migrate Parameters screen. 2. In the Enter Migrate Parameters screen s Data Set Name field, specify a name or mask that will identify the data sets you want migrated. Use the HELP function key to display the online help for this screen. 3. In the Wait for Completion field, type YES if you want Advanced Reporting for DFSMShsm to wait for DFSMShsm to complete the request before returning control to the user. Otherwise, specify NO. 4. In the Migration Level field, type ML1 or ML2, as appropriate. 5. Press Enter. Making a backup copy of a data set Select the Backup Data Set option from the Data Set Level Reports and Commands menu to create a backup copy of one or more data sets. To create a backup copy of a data set: 1. Select option 7 on the Data Set Level Reports and Commands menu to display the Enter HBACKDS Parameters screen. 120 User s Guide

127 2. In the Enter HBACKDS Parameters screen s Data Set Name field, specify a name or mask that will identify the data sets you want migrated. Use the HELP function key to display the online help for this screen. 3. In the Wait for Completion field, type YES if you want Advanced Reporting for DFSMShsm to wait for DFSMShsm to complete the request before returning control to the user. Otherwise, specify NO. 4. In the Target for Backup field, type TAPE, DASD, or HSM, as appropriate. 5. In the Volume Serial field, type the volser of the volume where the backup copy will reside. 6. Press Enter. Recalling a migrated data set Select the Recall Data Set option from the Data Set Level Reports and Commands menu to recall one or more migrated data sets. To recall migrated data sets: 1. Select option 8 on the Data Set Level Reports and Commands menu to display the Enter HRECALL Parameters screen. 2. In the Enter HRECALL Parameters screen s Data Set Name field, specify a name or mask that will identify the data sets you want recalled. Use the HELP function key to display the online help for this screen. 3. In the Wait for Completion field, type YES if you want Advanced Reporting for DFSMShsm to wait for DFSMShsm to complete the request before returning control to the user. Otherwise, specify NO. 4. In the Volume field, specify the volser of the volume to which you want the data sets recalled. 5. In the Unit field, specify the name of the unit that indicates what type of volume to process. 6. Press Enter. Recovering a backed up data set Select the Recover Backup Copy option from the Data Set Level Reports and Commands menu to recover backup copies of one or more data sets. To recover backed up data sets: 1. Select option 9 on the Data Set Level Reports and Commands menu to display the Enter HRECOVER Parameters screen. 2. In the Enter HRECOVER Parameters screen s Data Set Name field, specify a name or mask that will identify the data sets you want recalled. Use the HELP function key to display the online help for this screen. Chapter 12. Viewing data set level data 121

128 3. In the Wait for Completion field, type YES if you want Advanced Reporting for DFSMShsm to wait for DFSMShsm to complete the request before returning control to the user. Otherwise, specify NO. 4. In the From Volume field, specify the volser of the volume where the backup copies of the data sets reside. 5. In the Generation field, specify which relative generation of the data set you want recovered. 6. In the Date field, specify a restriction on the backup copy creation date by entering the most recent date (in YYYYDDD format) you want used for recovery. 7. In the Version Number field, specify which backup copy version you want recovered. 8. In the New Data Set Name field, specify the name you want assigned to the recovered data set. 9. In the Replace Old Data Set field, type YES if you want the old data set replaced with the recovered backup copy. Otherwise, type NO. 10. In the To Volume field, specify the volser of the volume where you want the recovered data set to reside. 11. In the Unit Name field, specify the type of volume to which you want the data set recovered. 12. Press Enter. Deleting a migrated data set Select the Delete Migration Copy option from the Data Set Level Reports and Commands menu to have DFSMShsm delete specific migrated data sets without recalling them to a primary volume. When DFSMShsm deletes the data sets, all backup versions of the data sets and the relevant information in the BCDS are maintained. To delete migrated data sets: 1. Select option 10 on the Data Set Level Reports and Commands menu to display the Enter HDELETE Parameters screen. 2. In the Enter HDELETE Parameters screen s Data Set Name field, specify a name or mask that will identify the data sets you want deleted. Use the HELP function key to display the online help for this screen. 3. In the Wait for Completion field, type YES if you want Advanced Reporting for DFSMShsm to wait for DFSMShsm to complete the request before returning control to the user. Otherwise, specify NO. 4. In the Purge Unexpired Data Set field, type YES if you want DFSMShsm to purge migrated data sets that have not yet reached their expiration date. Otherwise, specify NO. 122 User s Guide

129 5. Press Enter. Deleting a backup copy of a data set Select the Delete Backup Copy option from the Data Set Level Reports and Commands menu to have DFSMShsm delete one or more backup copies of a data set or delete specific backup versions of a data set. To delete backup versions of a data set: 1. Select option 11 on the Data Set Level Reports and Commands menu to display the Enter HBDELETE Parameters screen. 2. In the Enter HBDELETE Parameters screen s Data Set Name field, specify a name or mask that will identify the data sets you want deleted. Use the HELP function key to display the online help for this screen. 3. In the Wait for Completion field, type YES if you want Advanced Reporting for DFSMShsm to wait for DFSMShsm to complete the request before returning control to the user. Otherwise, specify NO. 4. In the From Volume Serial field, specify the volser of the volume where the backup copy or copies of the data set resides. 5. In the Version Number field, specify which backup copy version you want deleted. 6. Press Enter. Listing catalog data for a data set Select the List Catalog Data option from the Data Set Level Reports and Commands menu to run a LISTCAT command against a data set. To list catalog data for a data set: 1. Select option 12 on the Data Set Level Reports and Commands menu to display the Enter List Catalog Information screen. 2. In the Enter List Catalog Information screen s Data Set Name field, specify a name or mask that will identify the data set against which you want LISTCAT run. 3. In the Level of Entry Names field, specify the qualifier for the data set name. 4. Press Enter. Deleting a data set from DASD Select the Delete Data Set option from the Data Set Level Reports and Commands menu to delete a data set from DASD. Chapter 12. Viewing data set level data 123

130 Browsing a data set To list catalog data for a data set: 1. Select option 13 on the Data Set Level Reports and Commands menu to display the Delete a Data Set screen. 2. In the Delete a Data Sets screen s Data Set Name field, specify the name of the data set you want to delete from DASD. 3. If the data set you want deleted is uncataloged, use the Volume Serial Number field to specify the volser for the volume where the data set resides. 4. Press Enter. Viewing a data set Select the Browse Contents option from the Data Set Level Reports and Commands menu to open a BROWSE session for a data set. Note: You can use this feature only on partitioned or physical sequential data sets. To browse a data set: 1. Select option 14 on the Data Set Level Reports and Commands menu to display the Browse a Data Set screen. 2. In the Browse a Data Sets screen s Data Set Name field, specify the name of the data set whose contents you want to browse. 3. If the data set you want deleted is partitioned, use the Member Name field to specify which member of the data set you want to browse. 4. Press Enter. Select the View Contents option from the Data Set Level Reports and Commands menu to open a VIEW session for a data set. Note: You can use this feature only on partitioned or physical sequential data sets. To view a data set: 1. Select option 15 on the Data Set Level Reports and Commands menu to display the View a Data Set screen. 2. In the View a Data Set screen s Data Set Name field, specify the name of the data set whose contents you want to view. 3. If the data set you want to view is partitioned, use the Member Name field to specify which member of the data set you want to view. 4. Press Enter. 124 User s Guide

131 Editing a data set Select the Edit Contents option from the Data Set Level Reports and Commands menu to open an EDIT session for a data set. Note: You can use this feature only on partitioned or physical sequential data sets. To edit a data set: 1. Select option 16 on the Data Set Level Reports and Commands menu to display the Edit a Data Set screen. 2. In the Edit a Data Set screen s Data Set Name field, specify the name of the data set whose contents you want to view. 3. If the data set you want to edit is partitioned, use the Member Name field to specify which member of the data set you want to edit. 4. Press Enter. Chapter 12. Viewing data set level data 125

132 126 User s Guide

133 Chapter 13. Using the Health reports When you select the Health Reports option from the HSM Report/Manager Main Menu, the Health menu panel appears, as shown in the following figure: HLTHMENU IBM Tivoli Advanced Reporting for DFSMShsm V2R :35 Command ===> Scroll ===> PAGE DFSMShsm Health reports: Row 1 of 6 Report Name Description 1 SMS/HSM Mounted Volume Reports Summary of the mounted volumes 2 HSM Migration Reports Summary of migration status 3 HSM Backup Reports Summary of backup activity 4 HSM Volume Dump reports Summary of volume dump activity 5 Storage Group Summary Summary of storage groups Use the options on this menu to view the DFSMShsm and SMS information for volumes mounted to the system. The information provided by these reports might help you identify volumes that should be experiencing some level of activity, but are not. From this menu, you can do all of the following: Display a summary of mounted volumes. Display a summary of migration status. Display a summary of backup activity. Display a summary of volume dump activity. Display a synopsis of volume capacity and allocation within a storage group. SMS/HSM Mounted Volume reports Select the SMS/HSM Mounted Volume Reports option from the Health menu to display the Summary of Mounted Volumes report. The report provides the following information for the online primary DASD volumes: Volume management status, represented as a VOLRnnn value The number of volumes with the volume management status Description of the status Note: Use the HELP function key to display information about the VOLRnnn codes and a complete list of the line and primary commands available from the report panel. 127

134 HSM Migration reports HSM Backup reports Select the HSM Migration Reports option from the Health menu to display the Summary of Migration Management Status report, which shows a summary of the HSM migration management volume status. The report provides the following information about volumes that should show migration activity, but do not: Volume management status, represented as an MIGRnnn value The number of volumes with the volume management status Description of the status Note: Use the HELP function key to display information about the MIGRnnn codes and a complete list of the line and primary commands available from the report panel. Select the HSM Backup Reports option from the Health menu to display the Summary of Backup Activity report, which shows a summary of the HSM migration management volume status. The report provides the following information about volumes that should be backed up, but show no current backup activity: Volume management status, represented as a BACKnnn value The number of volumes with the volume management status Description of the status HSM Volume Dump reports Note: Use the HELP function key to display information about the BACKnnn codes and a complete list of the line and primary commands available from the report panel. Select the HSM Volume Dump Reports option from the Health menu to display the Summary of Backup Activity report, which shows a summary of the HSM migration management volume status. The report provides the following information about volumes that should have a current dump, but do not: Volume management status, represented as a DUMPnnn value The number of volumes with the volume management status Description of the status 128 User s Guide

135 Note: Use the HELP function key to display information about the DUMPnnn codes and a complete list of the line and primary commands available from the report panel. Storage Group Summary report Select the Storage Group Summary option from the Health menu to display the Summary of Storage Groups report, which shows a summary of the capacity and allocation of volumes within a storage group. The report provides the following information for each storage group: Storage group name Number of volumes in the storage group Total capacity of the storage group, in cylinders Number of free cylinders in the storage group Current occupancy percentage level for the storage group, taken as a whole Note: Use the HELP function key to a complete list of the line and primary commands available from the report panel. Chapter 13. Using the Health reports 129

136 130 User s Guide

137 Section II Using the Advanced Reporting for DFSMShsm Classic Interface 131

138 132 User s Guide

139 Chapter 14. The Command Processor The Command Processor is an interface to TSO command processing that allows you to invoke actions using the data elements in the various Dialog Manager Table entries, and to format data elements into batch control statements. These commands can be used on any of the Advanced Reporting for DFSMShsm panels that display data and filtered data. The sample panels shown in this chapter are indicative of the commands' use. You can use the Command Processor to do the following: Issue Line Commands for individual line entries one display page of a Dialog Manager Table and execute a command stream against them. Tag entire Dialog Manager tables or portions of tables and run a command stream against the tagged data in a TSO session, or execute commands in a batch process. A set of options can be used to extract and format the HSM control data set information (BCDS, MCDS, OCDS) and the HSM LOGY data for daily online use. These options can be used interactively or can be implemented in a scheduled or ad hoc batch execution. You can filter and sort information to focus on specific areas of interest or action. You can save the filtered and sorted information in a file. You can save the filter and sort criteria in a plan. You can store, retrieve, and re-use the files and plans. Commands overview Use the Command Processor to create interactive commands from display information by symbolic substitution. Commands can affect a single line of the display, or hundreds, as desired. TAG, UNTAG, RUN and BATCH can only be invoked from the active panel Command line. All other actions can be initiated either by typing the command at the active window's Command line or specifying the option's number from the Options pop-up panel, which can be displayed by typing O (Other Options) from the active panel's Command line. SORT Sort interactive displays by multiple arguments in multiple sequences. FILTER Use Boolean operators and arguments to filter displays and extracted information. PRINT Schedule the currently viewed display for batch formatting and printing to JES SYSOUT. 133

140 SAVE Save the currently viewed display to a file for further user processing. FORMAT and SAVE Create customized reports in practically any format. Use Save option to save custom formats as Plans to be executed in batch. PLAN Create plans by capturing the sort and filter criteria from the interactive session, and saving to a user PLANS library. TOTAL Display totals of appropriate (numeric) fields of any data display. TAG Tag (mark) all or individual items in a display for action by RUN or BATCH commands. UNTAG Untag (unmark) all or individual items in a display to exclude them from command processing. RUN Run TSO, MVS, HSM, and other interactive commands using stored commands for tagged display items. BATCH Create batch control statements using stored commands for tagged display items. Issue commands for individual table entries You can issue Line Command L (Line) and = (Equal) commands for individual entries. Simply key an L beside a table entry and an = sign to repeat the Line Commands, and then press Enter. A Line Command Processor pop-up panel containing a command stream of up to eight commands or command extensions will appear. Key any legitimate TSO command or user written CLIST or REXX EXEC in the pop-up panel and press Enter. The commands will then be executed instream. Deleting a table entry permanently Table entries can be deleted by scrolling to the table entry, typing X in the selection column, and pressing Enter. This removes the table item. Be careful; it is not a suppress as in ISPF Edit. 134 User s Guide

141 TAG and UNTAG commands for an entire table Line Commands can only be invoked one display page at a time, and a Dialog Manager Table can contain multiple pages of data, so we give you the TAG and UNTAG commands. To run commands against an entire table use TAG. From the Command line, key the TAG command and press Enter. Every entry in the display table will have a T in the selection column. Optionally, you can enter O at Command line and the Options pop-up panel with a numbered list of options will appear. Key the TAG option number, 7, at the pop-up panel Command line, and press Enter. All entries will be tagged for action. Individual data items can be tagged by scrolling to the table entry, typing T in the selection column, and pressing Enter. Similarly, all entries can be untagged by keying UNTAG at the Command line. Individual items can be untagged by scrolling to the table entry, blanking out the T in the selection column and pressing Enter. RUN and BATCH commands for tagged items After items in the table have been tagged, there are two commands that can be issued: RUN and BATCH. RUN and BATCH will take action only against those table entries that are tagged. Either command, keyed at the Command line, will display the Line Command Processor pop-up panel. Alternatively, type O (Options) at the Command line, key the appropriate option number at the pop-up panel Command line, and press Enter. If the RUN option was selected, the command stream you request will run in the TSO session. If the BATCH option was selected, a data set is created with the interpreted command stream for all tagged entries. An option panel is then presented where you can choose to Edit, Browse or Install the interpreted command stream to a data set of your choice. Installed command streams can then be used as input to any batch process that uses control statements as input. Save and retrieve or re-execute commands From the Line Command Processor pop-up panel, you can use PF07 to save a command to a member of a COMMAND data set that is distributed with this product, or use PF06 to retrieve a command stream from the COMMAND data set for execution. This allows you to build an inventory of correction processes unique to your environment. Chapter 14. The Command Processor 135

142 Using the Line Command Processor feature Examples of using the Line Command Processor will be shown in the next few pages. A very important feature of Advanced Reporting for DFSMShsm is the ability to issue commands using the information presented in the displays of HSM activity or status. Consider an example in which the information displayed in the following Mig/Bkup panels is the result of filtering the HSM LOGY extract file for migrations with return code 99, reason code 4. The table data is presented in three panels. Scroll left or right to view the contents. The following figure shows the first of these three panels: Mig/Bkup Advanced Reporting for DFSMShsm :06 Command ===> Scroll ===> PAGE FILTERED VIEW OF MIGRATE/BACKUP ENTER O AT OPTION FOR LIST OF OPTIONS. PANEL 1 OF 3. SCROLL RIGHT FOR MORE INFORMATION. KEY S BESIDE ENTRY FOR RETURN/REASON CODES S DSN ACTION RC RSNC TRKS AGE RMP.SMSTEST3.DATA MIGRATE RMP.TEMP4@#$ MIGRATE RMP.SMSTEST2.DATA MIGRATE RMP.TEMP2@#$ MIGRATE RMP.TEMP3@#$ MIGRATE RMP.SMSTEST3.DATA MIGRATE RMP.TEMP4@#$ MIGRATE RMP.SMSTEST2.DATA MIGRATE RMP.TEMP2@#$ MIGRATE RMP.TEMP3@#$ MIGRATE RMP.SMSTEST3.DATA MIGRATE The following figure shows the second of these three panels: Mig/Bkup Advanced Reporting for DFSMShsm :06 Command ===> Scroll ===> PAGE FILTERED VIEW OF MIGRATE/BACKUP ENTER O AT OPTION FOR LIST OF OPTIONS. PANEL 2 OF 3. SCROLL LEFT OR RIGHT FOR MORE INFORMATION. KEY S BESIDE ENTRY FOR RETURN/REASON CODES S DSN DATE TIME FM VOL TO VOL RMP.SMSTEST3.DATA :16:29 TSO001 RMP.TEMP4@#$ :16:29 TSO001 RMP.SMSTEST2.DATA :18:26 TSO002 RMP.TEMP2@#$ :18:26 TSO002 RMP.TEMP3@#$ :18:26 TSO002 RMP.SMSTEST3.DATA :13:04 TSO001 RMP.TEMP4@#$ :13:04 TSO001 RMP.SMSTEST2.DATA :14:15 TSO002 RMP.TEMP2@#$ :14:15 TSO002 RMP.TEMP3@#$ :14:15 TSO002 RMP.SMSTEST3.DATA :12:11 TSO User s Guide

143 The following figure shows the third of these three panels: Mig/Bkup Advanced Reporting for DFSMShsm :06 Command ===> Scroll ===> PAGE FILTERED VIEW OF MIGRATE/BACKUP ENTER O AT OPTION FOR LIST OF OPTIONS. PANEL 3 OF 3. SCROLL LEFT FOR MORE INFORMATION. KEY S BESIDE ENTRY FOR RETURN/REASON CODES S DSN CPU(.01) SYSID RMP.SMSTEST3.DATA DVLP RMP.TEMP4@#$ DVLP L RMP.SMSTEST2.DATA DVLP RMP.TEMP2@#$ DVLP RMP.TEMP3@#$ DVLP RMP.SMSTEST3.DATA DVLP RMP.TEMP4@#$ DVLP RMP.SMSTEST2.DATA DVLP RMP.TEMP2@#$ DVLP RMP.TEMP3@#$ DVLP RMP.SMSTEST3.DATA DVLP Line command L from the filtered view panel In this example, a LISTC (list catalog) command for a data set name is desired. Any existing TSO CLIST or REXX EXEC can be invoked. To start the process, type L (Line) in the selection column beside the data set name requiring action and press Enter. The LineCmds pop-up panel is displayed. (In addition to the Line Command L (Line), the LineCmds pop-up panel will also be presented if you specify a BATCH or RUN command at the Command line of the table display panel.) LineCmds Advanced Reporting for DFSMShsm Option==> Scroll ==> PA LINE COMMAND PROCESSOR HIT PF04 FOR FORMAT OPTIONS HIT PF05 TO DISPLAY LABELS HIT PF06 TO RETRIEVE A LIST OF COMMANDS, HIT PF07 TO SAVE THIS COMMAND TITLE===> FILTERED VIEW OF MIGRATE/BACKUP FORMAT OPTIONS FOLLOW FORMAT OPTIONS COMP NOSTRING NODICT TSO NOTOTALS NOTITLES LISTC ENT ('? When the LineCmds pop-up panel appears, the last command that was issued remains primed. In the example shown above, LISTC ENT ('? is primed. Start coding the LISTC command on the first empty line after the FORMAT OPTIONS command line. For the purpose of this example, it is assumed that you are familiar with the format of the IDCAMS LISTC command. Note: If you start coding the LISTC command on line 1, you will receive the message "ARH189C First line is reserved for FORMAT OPTIONS". Chapter 14. The Command Processor 137

144 What is desired in this case is a LISTC command for the data set marked with an L on the Mig/Bkup panel. When you do not know the appropriate label (symbolic) to code, code a? and press PF05 to view a list of LABELS from which to choose. (In this example, the? is already there in the primed command.) The Tags and Values panel will be presented showing a display of LABELS associated with Migration/Backup, as shown below. Its purpose is to display the symbolic data names of the elements of the Dialog Manager Table being presented. In this example, Migration/Backup information is being processed. Tags Vls Advanced Reporting for DFSMShsm Option==> Scroll ==> PA ENTER THE POSITIONAL TAG YOU WISH TO SUBSTITUTE BELOW TAG==> DSN ACTION ACTION DSN DSNAME RC RETURN CODE RESNC REASON CODE DATE LOG DATE TIME LOG TIME FVOL FROM VOLUME TVOL TO VOLUME TRK TRACKS MIGRATED AGE AGE OF DATA SET SYSID SYSTEM IDENTIFIER CPU CPU.01 SECS Enter END command to terminate this menu In the list of internal labels, DSN is shown as the internal symbolic associated with DSNAME. If DSN is coded on the TAG line, the symbolic /DSN, using the proper symbolic syntax, will be substituted in the command stream. Or, press PF3 (End) to return to the Line Command Processor pop-up and key the symbolic /DSN manually. Note: /DSN is the symbolic, as opposed to &DSN. This syntax is required due to internal processing restrictions. Because DSN was coded on the TAG line of the Tags Vls panel, /DSN was substituted for the question mark (?). You specify the remainder of the command. LineCmds Advanced Reporting for DFSMShsm Option==> Scroll ==> PA LINE COMMAND PROCESSOR HIT PF04 FOR FORMAT OPTIONS HIT PF05 TO DISPLAY LABELS HIT PF06 TO RETRIEVE A LIST OF COMMANDS, HIT PF07 TO SAVE THIS COMMAND TITLE===> FILTERED VIEW OF MIGRATE/BACKUP FORMAT OPTIONS FOLLOW FORMAT OPTIONS COMP NOSTRING NODICT TSO NOTOTALS NOTITLES LISTC ENT('/DSN 138 User s Guide

145 In this case, enclose DSN with the proper syntax ('/DSN'). An additional parameter 'ALL' is coded on the next command line. To continue a command to the next line, use either a plus (+) or minus (-) sign as the last character on the line; otherwise, the next line is treated as a new command and an attempt is made to execute it. LineCmds Advanced Reporting for DFSMShsm Option==> Scroll ==> PA LINE COMMAND PROCESSOR HIT PF04 FOR FORMAT OPTIONS HIT PF05 TO DISPLAY LABELS HIT PF06 TO RETRIEVE A LIST OF COMMANDS, HIT PF07 TO SAVE THIS COMMAND TITLE===> FILTERED VIEW OF MIGRATE/BACKUP FORMAT OPTIONS FOLLOW FORMAT OPTIONS COMP NOSTRING NODICT TSO NOTOTALS NOTITLES LISTC ENT('/DSN') + ALL Press Enter to execute the LISTC command for the data set name that was marked by the L in the table on the Mig/Bkup panel. If other rows of data in the table were marked with an equal (=), the command would be repeated for them. PF7 from the LineCmds pop-up panel If you are happy with the results of your command, you can save it as a member of the COMMANDS PDS. To save it, press PF07 to display a panel in which to enter information about this command. LineCmds Advanced Reporting for DFSMShsm Option==> Scroll ==> PA HIT PF04 for format options HIT PF05 to display LABELS HIT PF06 to retrieve a list of commands HIT PF07 to save this command TITLE===> FILTERED VIEW OF MIGRATE/BACKUP FORMAT OPTIONS FOLLOW FORMAT OPTIONS NOCOMP STRING DICT NOTSO TOTALS TITLES LISTC ENT('/DSN') + ALL The Commands panel for LBAK panel appears. Commands Advanced Reporting for DFSMShsm :24 Option==> Scroll ==> PAGE COMMAND TYPE==> LBAK SPECIFY CMMD NUMBER==> (101 THROUGH 9999) SPECIFY OPTIONS======> EDIT, BROWSE OR RETURN SPECIFY DESCRIPTION OF PLAN BELOW: TITLE==> NOTE: LBAK001 THROUGH LBAK100 IS RESERVED FOR SYSTEM PLANS SPECIFY USER PLAN LBAK101 TO LBAK9999 Chapter 14. The Command Processor 139

146 The particular command created in this example is for Migrate/Backup actions, so the COMMAND TYPE field is initialized with LBAK. (You must store commands within the category they were designed for; in this case LBAK.) You must fill in the fields SPECIFY CMMD NUMBER (command suffix), SPECIFY OPTION, and Title. Be sure to use a meaningful title so you can locate the plan easily from a Plan Member List. If the plan title you specify already exists, you will be prompted to overwrite or not, or to display a member list. If you specify EDIT for the SPECIFY OPTION field and press Enter, you will be placed in ISPF Edit mode so you can edit the command you have generated. EDIT ARH0202X.QABETA.COMMANDS(LBAK777) Columns Command ===> Scroll ===> PAGE ****** ***************************** Top of Data ****************************** TITLE FILTERED VIEW OF MIGRATE/BACKUP FORMAT OPTIONS COMP NOSTRING NODICT TSO NOTOTALS NOTITLES LISTC ENT('/DSN') ALL The first line of the command is for your comment. It is not part of the command. Save the results if you wish. When you end EDIT, you will return to the Commands panel with the LineCmds pop-up panel displayed. LineCmds Advanced Reporting for DFSMShsm Option==> Scroll ==> PA LINE COMMAND PROCESSOR HIT PF04 FOR FORMAT OPTIONS HIT PF05 TO DISPLAY LABELS HIT PF06 TO RETRIEVE A LIST OF COMMANDS, HIT PF07 TO SAVE THIS COMMAND TITLE===> FILTERED VIEW OF MIGRATE/BACKUP FORMAT OPTIONS FOLLOW FORMAT OPTIONS COMP NOSTRING NODICT TSO NOTOTALS NOTITLES LISTC ENT('/DSN') + ALL PF6 from the LineCmds pop-up panel To retrieve a command from the COMMANDS PDS that is associated with the data category being processed, press PF06 from the LineCmds pop-up panel. The member list panel is presented. Notice that the newly created LBAK004 command is listed here. For this example we will show LBAK777. Command LBAK004 is interesting because it has two in-stream commands, LISTC and HLIST. Type an S beside LBAK004 and press Enter. 140 User s Guide

147 Row 1 to 10 of 10 Commands Advanced Reporting for DFSMShsm :36 Option==> Scroll ==> PAGE YOU MAY BROWSE (B), EDIT (E), DELETE (D) OR SELECT (S) COMMAND MEMBER ACTION TITLE LBAK@DCT * DATA DICTINARY FOR MIGRATION/BACKUP RECORDS FROM LBAK@STD TITLE STANDARD MIGRATE BACKUP FORMAT LBAK001 LIST CATALOG FOR THIS ENTRY LBAK002 LIST BACKUP STATUS FOR THIS ENTRY LBAK003 LIST MIGRATION INFORMATION ABOUT ENTRY S LBAK004 LISTC AND LIST MIGRATION STATUS OF DATA SET LBAK009 LISTVTOC FOR DSNAMES WITH MIG FAILURES LBAK115 LISTC FOR MIGRATION FAILURE 99 RSN 4 LBAK777 TITLE FILTERED VIEW OF MIGRATE/BACKUP LBAK999 HSEND REPORT DAILY FROMDATE(2001/01/01) ODS('DCD. ******************************* BOTTOM OF DATA*************************** As a result of selecting command LBAK004, the displayed LineCmds pop-up panel is now primed with two commands, LISTC and HLIST. The same symbolic (/DSN) is used in both commands. LineCmds Advanced Reporting for DFSMShsm Option==> Scroll ==> PA LINE COMMAND PROCESSOR HIT PF04 FOR FORMAT OPTIONS HIT PF05 TO DISPLAY LABELS HIT PF06 TO RETRIEVE A LIST OF COMMANDS, HIT PF07 TO SAVE THIS COMMAND TITLE===> FILTERED VIEW OF MIGRATE/BACKUP FORMAT OPTIONS FOLLOW FORMAT OPTIONS NOCOMP STRING DICT NOTTSO TOTALS TITLES LISTC ENT('/DSN') ALL HLIST DSNAME( /DSN ) TERM MCDS PF5 from the LineCmds pop-up panel Another command in the list was LBAK009. The LineCmds pop-up panel displayed when LBAK009 is selected shows multiple symbolic values used on the same command line (/DSN and /FVOL). Again, all symbolic names (LABELS) for all data views are available for display by pressing PF05. Chapter 14. The Command Processor 141

148 LineCmds Advanced Reporting for DFSMShsm Option==> Scroll ==> PA LINE COMMAND PROCESSOR HIT PF04 FOR FORMAT OPTIONS HIT PF05 TO DISPLAY LABELS HIT PF06 TO RETRIEVE A LIST OF COMMANDS, HIT PF07 TO SAVE THIS COMMAND TITLE===> FILTERED VIEW OF MIGRATE/BACKUP FORMAT OPTIONS FOLLOW FORMAT OPTIONS NOCOMP STRING DICT NOTTSO TOTALS TITLES LISTVTOC /DSN /FVOL FORMAT TAG and UNTAG commands on a filtered view panel The following panel is used to demonstrate further capabilities for the LineCmds feature. These facilities allow you to tag all, some, or none of the table entries, and RUN or create a batch file that will interface with a batch utility. This is done with the TAG, UNTAG, RUN, and BATCH commands. Row 1 to 5 of 5 Mig/Bkup Advanced Reporting for DFSMShsm :39 Option==> TAG Scroll ==> PAGE FILTERED VIEW OF MIGRATE/BACKUP ENTER O AT OPTION FOR LIST OF OPTIONS. PANEL 1 OF 3. SCROLL RIGHT FOR MORE INFORMATION. KEY S BESIDE ENTRY FOR RETURN/REASON CODES S DSN ACTION RC RSNC TRKS AGE RMP.SMSTEST3.DATA MIGRATE RMP.TEMP4@#$ MIGRATE RMP.SMSTEST2.DATA MIGRATE RMP.TEMP2@#$ MIGRATE RMP.TEMP3@#$ MIGRATE In the above example, the command TAG has been entered at the Command line. The results (displayed below) will show all table entries with a T in the selection (S) column. This means that every entry is marked for action. Row 1 to 5 of 5 Mig/Bkup Advanced Reporting for DFSMShsm :06 Option==> Scroll ==> PAGE FILTERED VIEW OF MIGRATE/BACKUP ENTER O AT OPTION FOR LIST OF OPTIONS. PANEL 1 OF 3. SCROLL RIGHT FOR MORE INFORMATION. KEY S BESIDE ENTRY FOR RETURN/REASON CODES S DSN ACTION RC RSNC TRKS AGE T RMP.SMSTEST3.DATA MIGRATE T RMP.TEMP4@#$ MIGRATE T RMP.SMSTEST2.DATA MIGRATE T RMP.TEMP2@#$ MIGRATE T RMP.TEMP3@#$ MIGRATE User s Guide

149 To untag the entire table, key UNTAG at the Command line and all items will be untagged. To untag individual items, scroll to the entry, space over the T, and press Enter. Conversely, to tag individual items, scroll to the entry and key a T in the selection column, then press Enter. Another available function is the ability to eliminate a table entry. This is done by scrolling to the table entry and keying an X in the selection column, then pressing Enter. You can X multiple table entries. By using these facilities, you can prepare the table for the RUN and BATCH commands. BATCH command on a filtered view panel The following panel shows some individually marked table entries. When you type BATCH at the Command line, and as with the Line Command L, the LineCmds pop-up panel appears, primed with the most recently used command(s). Row 1 to 5 of 5 Mig/Bkup Advanced Reporting for DFSMShsm :06 Option==> BATCH Scroll ==> PAGE FILTERED VIEW OF MIGRATE/BACKUP ENTER O AT OPTION FOR LIST OF OPTIONS. PANEL 1 OF 3. SCROLL RIGHT FOR MORE INFORMATION. KEY S BESIDE ENTRY FOR RETURN/REASON CODES S DSN ACTION RC RSNC TRKS AGE T RMP.SMSTEST3.DATA MIGRATE RMP.TEMP4@#$ MIGRATE T RMP.SMSTEST2.DATA MIGRATE T RMP.TEMP2@#$ MIGRATE T RMP.TEMP3@#$ MIGRATE An example of the BATCH command follows. LineCmds Advanced Reporting for DFSMShsm Option==> Scroll ==> PA LINE COMMAND PROCESSOR HIT PF04 FOR FORMAT OPTIONS HIT PF05 TO DISPLAY LABELS HIT PF06 TO RETRIEVE A LIST OF COMMANDS, HIT PF07 TO SAVE THIS COMMAND TITLE===> FILTERED VIEW OF MIGRATE/BACKUP FORMAT OPTIONS FOLLOW FORMAT OPTIONS NOCOMP STRING DICT NOTSO TOTALS TITLES LISTC ENT('/DSN') ALL If this is the desired command, press Enter and a file is created containing LISTC commands for every tagged table entry, substituting the data set name in place of /DSN. Chapter 14. The Command Processor 143

150 After creating a batch command, the CntlCrds menu is presented. CntlCrds Advanced Reporting for DFSMShsm :31 Option==> Scroll ==> PAGE B BROWSE E EDIT I INSTALL S SUBMIT C CANCEL - BROWSE THE FILE JUST CREATED - EDIT THE FILE JUST CREATED - COPY FILE JUST CREATED TO PRODUCTION LIBRARY - SUBMIT JCL JUST CREATED - CANCEL AND DELETE THE FILE JUST CREATED ARH CONTROL CARDS HAVE BEEN CREATED IN THE DATA SET: ===> TWKALE.H The options available from the CntlCrds menu are as follows: BROWSE To browse the data, key B at the Command line, and an ISPF Browse panel will be invoked for that data set. EDIT To edit the data, key E at the Command line, and an ISPF Edit screen will be invoked for that data set. INSTALL If the data is satisfactory and you want to copy the data to a data set or member of a data set for later use, key I at the Command line and follow the instructions. After the copy is finished you will be returned to the previous screen. SUBMIT If you edited the LineCmds pop-up panel to add job and dsn statements to create a job that can be submitted, key S at the Command line to submit the job. CANCEL To cancel and delete the file you just created, key C at the Command line. An EDIT is requested on the CntlCrds menu. The name of the data set where the control statements have been created is shown on the panel. The data set name contains the Advanced Reporting for DFSMShsm default prefix and a suffix time stamp. To execute the newly generated command syntax, you must set up JCL for the desired function, and reference the generated data set or member you just created. 144 User s Guide

151 The following panel displays the contents of the data set containing the control statements generated using the BATCH command with tagged data. EDIT ---- TWKALE.H COLUMNS COMMAND ===> SCROLL ===> CSR ******************************* TOP OF DATA ************************ LISTC ENT('CICS.R330A.DEV.SYSMDUMP.G0298V00') ALL LISTC ENT('CICS.R330A.DEV.SYSMDUMP.G0299V00') ALL LISTC ENT('CICS.R330A.MAP.SYSMDUMP.G0395V00') ALL LISTC ENT('CICS.R330A.MAP.SYSMDUMP.G0396V00') ALL LISTC ENT('CICS.R330A.MAP.SYSMDUMP.G0397V00') ALL LISTC ENT('CICS.R330A.MAP.SYSMDUMP.G0398V00') ALL ****************************** BOTTOM OF DATA ********************** RUN command The RUN command works the same as Line Command L (line) command (that is, in each tagged item, symbolic values are substituted into the previously created command stream) and the command is executed in the TSO session. Due to the similarity of processing functionality, examples of the RUN process will not be shown here. An alternative to entering the RUN, TAG, BATCH, etc., commands at the Command line of the active panel, is to key O (Other Options) at the Command line of the active panel; the Options pop-up panel with numbered commands will be presented. You can then just key the number of the desired command at the pop-up's Command line. Chapter 14. The Command Processor 145

152 146 User s Guide

153 Chapter 15. PC extension for the Daily Statistics Record A Microsoft Excel add-in will load selected fields from the Daily Statistics Record (DSR) into spreadsheets and, optionally, graph the fields. The load of comma-delimited data is intended for use with the Format and Save feature. For more information on the Format and Save feature, see Chapter 16, The Format and Save feature. The DSR record is a single record created once each day by HSM. It consists of statistics for the overall operation of HSM and several sub-sections that have statistics regarding various HSM operations, such as primary to Level 1, backup, recycle, and so on. Two programs need to run on the mainframe shortly after midnight each day to extract the data and archive it, and to create a data set for download with a PARM-controlled number of days of the DSR. A job to automatically run these programs needs to be added to a scheduler. To automatically build this job, use the Batch JCL Build option on the main menu panel, and then the PC Download Extract sub-option. For the job to run successfully, you must define two GDG Bases in the catalog. The following sample JCL creates the necessary catalog entries. //DEFGDG JOB (11111),'job card',region=4m,msglevel=(1,1), // MSGCLASS=A,CLASS=A,NOTIFY=&SYSUID //DEFMCDS EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSOUT DD SYSOUT=* //SYSIN DD * DELETE ARH0202X.QABETA.ZPFX.DSROUTEX CLUSTER PURGE DELETE ARH0202X.QABETA.ZPFX.DSROUTPC CLUSTER PURGE DEFINE GDG ( NAME(ARH0202X.QABETA.ZPFX.DSROUTEX) - NOEMPTY SCRATCH LIMIT(10) ) DEFINE GDG ( NAME(ARH0202X.QABETA.ZPFX.DSROUTPC) - NOEMPTY SCRATCH LIMIT(10) ) /* PC code is distributed as a Microsoft Excel add-in. It will add a new dropdown menu to the Excel toolbar, with five actions: Load, format and graph the DSR Open a data workbook Present a list of the sheets in a workbook for selection Load comma delimited data into a workbook Add more charts to an existing set The load of comma-delimited data is intended for use with the Format and Save feature. 147

154 Install the Daily Statistics Record programs on the mainframe Select the Batch JCL Build option on the classic interface s main menu, and then select the PC Download Extract sub-option to display a panel that allows you to view, edit, or install the Daily Statistics Record JCL. Copy the JCL into a library and make modifications for your installation. The first step of the JCL extracts the DSR record to a data set. It will verify there are no duplicates and append yesterday s record to the file. The record that represents the current day is not saved because it is incomplete and won t be complete until midnight. There are two PARMs for the job. The first is the number of days that you would like saved. A recommendation is 365 days. The second PARM is an identifier for the system. It can be up eight characters and will be sent to the PC with the data so that if multiple systems are collected, the data set can be identified. In the example that follows, we have used a GDG for the output (DD DSROUT). This allows recovery, if for any reason the job does not run successfully. On most systems, there are 10 to 14 days of DSR records. The program will pick up missed days to the extent they are available if the job is not run for some reason. The second step copies the number of records specified in the PARM to another data set. Our intent here is that if different people need a different number of days of data, this step can be run for each of them with a different PARM. In addition, since more than about 30 days of data becomes quite large and cumbersome to graph, the job can be used to only extract part of the data available. The example uses a GDG for the output, but a normal sequential data set could be used and written over each night, since the data that creates it is unaffected by the extraction. Example JCL is shown in the following figure. //ARHJOB JOB (11111), ARH JOB CARD,REGION=8M, // MSGLEVEL=(1,1),MSGCLASS=A,CLASS=A, // NOTIFY=&SYSUID,TYPRUN=SCAN //* //* //ARH33000 EXEC PGM=ARHAI001,PARM= ARHAI0101,ARH33000,365 //STEPLIB DD DISP=SHR,DSN=ARH0202X.QABETA.LOAD //ARH33001 EXEC PGRM=ARHAI001,COND=(0,NE),PARM= ARHAI010,ARH33001,30 //STEPLIB DD DISP=SHR,DSN=ARH0101X.QABETA.LOAD When you are satisfied with the JCL, we suggest it be put into an automatic scheduler to run sometime after midnight each night. That way, each day a new data set can be downloaded; the data set will have current data until midnight of the night before. The download process is left to you. The file should be downloaded as a text file with ASCII and CRLF specified, and saved on the PC as a '.txt' or no extension file. For ease of reference, we suggest that the name on the PC include the system it came from and current date. The data will contain the system identifier that was specified in the PARM, as well as a date for each record. There will be one record, of 1000 bytes each, for each day of data downloaded. 148 User s Guide

155 Running this JCL creates a new data set called <opfx>.dsroutpc(+1) that you will download to their PC as a CSV file. Refer to the next section for more information about the download process. Install the Daily Statistics Record program on the PC The PC portion of the programs is an Excel Add-in supplied with the product named 'ARHHSMutils.xla'. It has been tested on Excel 2000 and Excel 97. Loading and graphing for all possible graphs produces 11 data and 11 graph sheets, with a total of 67 graphs. The elapsed time on a 400 mhz PC with 128 MB of memory was about 2.5 minutes. The data set produced for 30 days of data with all possible graphs was approximately 650 KB, and the raw data for the 30 days was 38 KB. To install ARHHSMutils.xla: 1. From the DOS command prompt on the PC to which you want ARHHSMutils.xla downloaded, type ftp mainframesystem (where mainframesystem is the system where you have Advanced Reporting for DFSMShsm installed on the mainframe) and press Enter. 2. When prompted by ftp, provide your mainframe user ID and and then press Enter. 3. When prompted by ftp, provide the password for your user ID and then press Enter. 4. Type cd arh0202x.qabeta.samplib (where samplib is whatever the installer named the sample library when Advanced Reporting for DFSMShsm was installed on the mainframe) and then press Enter. 5. At the ftp prompt, type lcd desktop and press Enter. 6. At the ftp prompt, type bin and press Enter. 7. At the ftp prompt, type get arhutxla ARHHSMutils.xla and press Enter. 8. At the ftp prompt, type quit and press Enter. 9. Copy the supplied file, ARHHSMutils.xla, to a library on your PC. We suggest it be a sub-directory of the directory you are going to keep the data and formatted data, although it can be in the Windows Add-in directory, or the programs Add-in directory. 10. Start Excel and open a blank workbook. On the toolbar, click Tools and select Add-Ins. The following menu will appear: Chapter 15. PC extension for the Daily Statistics Record 149

156 11. Select Browse and navigate to the directory where you copied the add-in. Select the member and click OK. It will have the suffix of.xla. The Addin menu will change to have the new add-in highlighted as shown below. 12. Click OK on the Add-in window and after a short pause the HSMUtil option will appear on the Excel Toolbar, as shown below. The add-in is now installed. 150 User s Guide

157 Processing the ARHHSMutils.xla add-in By selecting HSMUtil, a sub-menu will appear with five options. Load and format the DSR data This option will use as input the data set downloaded from the mainframe. The first step will create a new workbook and then display a box telling you to select the data set to format on the next screen. After you have selected the data set and clicked OK, the Add-in will load the data and separate it into sheets for each type of data. A box will then appear that will allow you to select any of the graphs to create. There is a set of graphs for each section of the DSR record. After selecting the graph sets you wish to format, close out of the selection screen and the Add-in will display a box indicating the name that the workbook will be saved under. The name is constructed to have the name that was initially in the PARM on the mainframe as well as the date and time. When you have finished viewing, editing, or otherwise processing the workbook, close it normally. It will ask if you want any changes saved if Excel believes there have been any. Open a data workbook This option is intended as a convenience in opening additional or new workbooks. It will again display the box asking you to select the workbook on the next screen and when it is selected, it will open it. It does no processing other than opening a workbook. Display sheet list This is a method of displaying a list of sheets in the active workbook and allowing the user to select one for display by highlighting one and clicking activate, double-clicking on one, or highlighting and clicking Enter. Chapter 15. PC extension for the Daily Statistics Record 151

158 Load comma delimited data This option is to be used with the Format and Save feature. Our customers have asked that they have a convenient method of formatting data for loading into a spreadsheet. The Format and Save will allow any data that Advanced Reporting for DFSMShsm has to be created in a comma delimited format. After it has been downloaded to a PC, the option in Excel makes it easier to load it into a spreadsheet. The DSR record Add more charts This option is intended to allow the user to add charts to a workbook that was previously created. It will check to ensure the chart selected is not there (if it is, it will ignore the request) and if not add it to the workbook. It will not automatically save changes but Excel will, of course, prompt the user on closing if needed. This topic gives a bit of background and detail about the data in the DSR record and how the formatting process divides it up. One DSR record is created each day with statistics filled in at midnight for that day. The record has a header containing HSM overall statistics, followed by 13 sections of identical format. The 13 sections each have data on one type of data processing. The sections are: Primary to level 1 migration Level 1 to level 2 migration Primary to level 2 migration Recall from level 1 to primary Recall from level 2 to primary Deletion of migrated data sets Daily backup Spill backup Recovery Recycle of backup volumes Data set deletion from user volumes Recycle of level 2 tape migration volumes Delete backup versions We have chosen to not include data from numbers 8, 9, and 11. In addition, numbers 10 and 12 have been combined. The sections we have then are shown below as displayed by the Display sheet list: 152 User s Guide

159 The HSM Overall statistics section fields are shown below. The SYS ID is added as the last column of this sheet. Excel Name Record Name Field Description REC DT DSRDT Day this record is for. STRT DSRHSMST Number of HSM startups today. ABDS DSRHSMAB Number of HSM ABENDs today. SHUT DSRHSMSH Number of HSM shutdowns today. HSM TI DSRHSMTM Step time in seconds for HSM ASCB. VMIGS DSRVLMG Number of volume migrations today. VSPMG DSRVLMSP Number of volume migrations due to lack of space. VBACK DSRVLBK Number of volumes backed up. VRECY DSRVLRC Number of tape volumes recycled today. VLTRC DSRVLRC2 Number of tape l2 volumes recycled today. SVDPS DSRVLDPS Number of system requested volume dumps. UVDPS DSRVLDPU Number of user requested volume dumps. FVDPS DSRVLDPF Number of volumes dumps that failed. SDCPS DSRCPS Number of system requested dump copies. UDCPS DSRCPU Number of user requested dump copies. FDCPS DSRCPF Number of dump copies that failed. RVLRS DSRVLRS Number of volume restores requested. FVLRS DSRVLRSF Number of volume restores that failed. Chapter 15. PC extension for the Daily Statistics Record 153