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

Transcription

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

2 Note Before using this information and the products it supports, read the information in Appendix B, on page 319. First Edition May 2007 This edition applies to Version 1 Release 1 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 book...1 What does this book contain?...1 Acronyms...2 Chapter 2. Installation...3 Installation overview...3 Software requirements...3 Advanced Reporting for DFSMShsm data sets...3 Data set naming conventions...3 Advanced Reporting for DFSMShsm data set descriptions...4 Extended ACS masking characters and your EBCDIC code tables...4 Data supplied as input to either batch programs or ISPF panels...4 Product output...4 Do not change distributed ISPF panels...5 Advanced Reporting for DFSMShsm configuration...6 Step 1: Customize member ARHJMAIN...7 Step 2: Customize PARMLIB member ARHCMD Step 3: APF authorize the SARHLOAD library...7 Step 4: Start the ARHJMAIN task...7 Step 5: Start Advanced Reporting for DFSMShsm...7 Step 6: Complete the Advanced Reporting for DFSMShsm customization...8 ARHCMD00 configuration values...10 Syntax rules...10 Continuation rules...10 Comments...10 ARHCMD00 keyword syntax and descriptions...11 Required parameters...11 Optional parameters...12 Chapter 3. Advanced Reporting for DFSMShsm overview...21 Concepts and facilities...21 Online features overview...22 Reports from the control data sets...23 Special reporting...23 Reports from the log file...24 Support activities...24 Batch processing options...25 Extended ACS masking characters and your EBCDIC code tables...25 Specification and display of EBCDIC characters...25 Data supplied as input to either batch programs or input to ISPF panels...25 Do not change distributed ISPF panels...26 Product output...26 Filtering pattern masks...26 Chapter 4. The Command Processor...29 Commands overview...29 Issue commands for individual table entries...30 Deleting a table entry permanently...30 TAG and UNTAG commands for an entire table...31 RUN and BATCH commands for tagged items...31 Save and retrieve or re-execute commands...31 Using the Line Command Processor feature...32 Line command L from the filtered view panel...33 PF7 from the LineCmds pop-up panel...35 PF6 from the LineCmds pop-up panel...36 PF5 from the LineCmds pop-up panel...37 TAG and UNTAG commands on a filtered view panel...38 BATCH command on a filtered view panel...39 RUN command...41 Chapter 5. PC extension for the Daily Statistics Record...43 Install the Daily Statistics Record programs on the mainframe...44 Install the Daily Statistics Record program on the PC...45 iii

4 Processing the ARHHSMutils.xla add-in...47 Load and format the DSR data...47 Open a data workbook...47 Display sheet list...47 Load comma delimited data...48 Add more charts...48 The DSR record...48 Field names...50 The DSR record charts...51 Chapter 6. The Format and Save feature...53 Overview of Format and Save...53 Symbolics and constants...53 Header and trailer formats...54 The FORMAT OPTIONS command...54 Format Interactively...57 Format batch...63 Format JCL...69 Chapter 7. Data set recovery...73 Chapter 8. Processing migration/backup log file data...77 Generate a view of the migration/backup information...77 Filter the migration/backup data...78 Migrate/backup filter fields...79 Filter arguments...80 Filter example...81 TOTAL, SAVE, PRINT, or SORT the filtered migration/backup data...84 TOTAL facility...84 SAVE and PRINT facilities...84 SORT facility...85 Create a plan...87 Internal labels for plan categories...91 Exercise a plan...92 List and retrieve plan execution results...93 Chapter 9. Advanced Reporting for DFSMShsm support activities...97 Generate Master...97 Display Last Master...99 Chapter 10. Online batch process Select online plans for batch Batch JCL build Chapter 11. Control data set reports MCDS Information MCDS SMS summary MCDS migration volume summary MCDS DSNAME search panel MCDS filter panel MCDS detail panels Additional MCDS detail options 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 BCDS detail interactive options Display BCDS plans Display BCDS files OCDS Information OCDS inventory options OCDS inventory interactive options OCDS filter panel Display OCDS plans Display OCDS files Tape DSName detail display Tape DSName detail options Chapter 12. HSM health reports How health reports work HSM health reports About the HSM health reports database Analyze health reports HSM health SMS/HSM mounted volume report HSM health migration reports HSM health backup reports HSM volume group reports Chapter 13. Volume dump information Dump volume information menu Dump class information Dump volume information View volume dump summary information Filter volume dump detail Display dump volume detail plans Display filtered dump volume sequential files iv

5 Dump tape information Dump volume tape filter option Display volume dump tape plans Display dump tape sequential files Dump volume DSName processing Dump volume DSName filter option Display volume dump DSName plans Display volume dump DSName sequential files Chapter 14. Log file reports Migration/backup options Migration return code summary Migration detail Migrate return code options 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 Recall return code detaill Return code reason code display panel Recall return code options Recover return code summary Recover return code detail Return code reason code display panel 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 Build A message filter plan Display message filter plans Display filtered message flat files Tape usage summary Return/reason code tables Backup return codes Backup reason codes Daily space management Appendix A. Messages Messages for Advanced Reporting for DFSMShsm Appendix B. Notices Trademarks Index v

6 vi

7 Chapter 1. About this book 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 book contain? This guide provides the necessary information and instructions to successfully use Advanced Reporting for DFSMShsm. This book contains: Chapter 1, About this book, 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, 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 5, 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 6. The Format and Save feature, discusses the Format and Save feature, giving examples of usage and functionality. Chapter 7, Data set recovery, discusses how to display a list of backup generations of a data set requiring recovery. Chapter 8, Processing migration/backup log file data, demonstrates the extended facilities of Advanced Reporting for DFSMShsm, using Migration/Backup data extracted from HSM LOGY. Chapter 9, Advanced Reporting for DFSMShsm support activities, contains an overview of the master panel s Display Last Master and Generate Master options. 1

8 Chapter 10, Online batch process, explains option B2 JCL Build, and option B1 Selecting Plans to Run in Batch, from the master panel s Batch Processing section. Chapter 11, Control data set reports, provides detail about options C1 MCDS information, C2 BCDS information, and C3 - OCDS information, from the master panel s Reports From The Control Data Sets section. Chapter 12, HSM health reports, provides an overview of the Health reports function and discusses the master panel s option H1 - HSM Health Reports. Chapter 13, Volume dump information, discusses the master panel s Option V1 Volume Dump Information. Chapter 14, Log file reports, provides detail on the master panel s Reports From The Log File options. Appendix A, Messages, documents the informational, error, and warning messages for Advanced Reporting for DFSMShsm. Appendix B, Notices, provides license, copyright, and trademark information. Acronyms ARH Product acronym for Advanced Reporting for DFSMShsm 2 User s Guide

9 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, or V1R8 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. 3

10 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. 4 User s Guide

11 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 Hex Description * (Single) 5C 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 5

12 Mask Hex Description ** (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. 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. Step 1: Customize member ARHJMAIN on page 7 2 Customize PARMLIB member ARHCMD00. Step 2: Customize PARMLIB member ARHCMD00 3 APF authorize the SARHLOAD library. Step 3: APF authorize the SARHLOAD library on page 7 4 Start the ARHJMAIN task. Step 4: Start the ARHJMAIN task on page 7 5 Use CLIST ARHSTART to enter Advanced Reporting for DFSMShsm. 6 From the Advanced Reporting for DFSMShsm master panel, select menu option S6. Step 5: Start Advanced Reporting for DFSMShsm on page 7 Step 6: Complete the Advanced Reporting for DFSMShsm customization on page 8 6 User s Guide

13 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 SARHPARM member ARHCMD00 To customize SARHPARM 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. Chapter 2. Installation 7

14 On each system where ARHJMAIN is started, invoke the SARHCLST library s ARHSTART member to display Advanced Reporting for DFSMShsm s main panel. Mstr Pnl Advanced Reporting for DFSMShsm :28 S6 Reports from Control Data Sets Special Reporting C1. MCDS Information H1. HSM Health Reports C2. BCDS Information V1. Volume Dump Information C3. OCDS Information Support Activities Reports from Log File S1. Display Last Master L1. Migration/Backup Options S2. Set JCL Parameters L2. Recall/Recovery Options S3. DFSMShsm Task Information L3. Extent Reduction Summary S4. Generate Master L4. Recycle Return Code Summary S5. Recover Dataset L5. Log Message Summary S6. Step By Step Customization L6. Tape Usage Summary L7. Return/Reason Code Tables Batch Processing L8. Daily Space Management B1. Select Plans for Batch B2. Batch JCL Build 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, select the Step by Step Customization option (S6) from the main panel to display the Advanced Reporting for DFSMShsm Customization panel. The Custom panel appears, as shown in the following figure. 8 User s Guide

15 Custom Advanced Reporting for DFSMShsm :08 Update Parameter Settings Data Set Adjustments 1. Set JCL Parameters D1. Rename PLANS/COMMANDS Members 2. Override ARH Data Sets 3. Override Control Data Sets 4. Override Log Data Sets 5. Set Health Report Parameters Create Product Data Sets (Job Submission is the preferred method.) 6. Submit job to format MCDS A. Format MCDS online 7. Submit job to format BCDS B. Format BCDS online 8. Submit job to format OCDS C. Format OCDS online 9. Submit job to format LOGX/Y D. Format LOG data online 10. Submit job for Health Reports 11. Submit job for Volume Dumps F. Format Volume Dumps online To complete the customization, execute option D1 to rename the members in the SARHPLNS and SARHCMDS data sets from their shipped names of ARHxxxxx to their functional names. Perform this option once only, after the product is installed. For this option to complete execution successfully, you should be the only user accessing the SARHPLNS and SARHCMDS data sets. Custom Advanced Reporting for DFSMShsm :30 Update Parameter Settings Data Set Adjustments 1. Set JCL Parameters D1. Rename PLANS/COMMANDS Members 2. Override ARH Data Sets 3. Override Control Data Sets 4. Override Log Data Sets 5. Set Health Report Parameters Create Product Data Sets (Job Submission is the preferred method.) 6. Submit job to format MCDS A. Format MCDS online 7. Submit job to format BCDS B. Format BCDS online 8. Submit job to format OCDS C. Format OCDS online 9. Submit job to format LOGX/Y D. Format LOG data online 10. Submit job for Health Reports 11. Submit job for Volume Dumps F. Format Volume Dumps online.select the appropriate menu options and provide the necessary information to complete the customization. Chapter 2. Installation 9

16 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) 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 '*/'. 10 User s Guide

17 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 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 Chapter 2. Installation 11

18 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 Optional parameters ARCHLOGX 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 12 User s Guide

19 ARCHLOGY 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 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 Chapter 2. Installation 13

20 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 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'',' 14 User s Guide

21 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='//*' 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='//* ' Chapter 2. Installation 15

22 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 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 16 User s Guide

23 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 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 Chapter 2. Installation 17

24 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 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=MC User s Guide

25 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=SC002 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 Chapter 2. Installation 19

26 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=VOL User s Guide

27 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. 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 selection and filtering options allow you to view HSM from a high level, and then zoom in on problem areas in great detail. Advanced Reporting for DFSMShsm allows the person responsible for managing HSM to implement corrective actions based on the information retrieved and presented by Advanced Reporting for DFSMShsm. HSM activity, error, and exception information can be customized in a way that is the most suitable for solving HSM problems. Advanced Reporting for DFSMShsm features further allow you to define and take corrective actions within the product, improving your ability to control and adjust the HSM environment effectively. 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. 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. 21

28 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 Master Panel menu option you can use to display a list of backup generations of a data set requiring recovery. Online features overview This is the Master Panel. It is the first panel displayed at startup. Mstr Pnl Advanced Reporting for DFSMShsm :49 Scroll ==> Reports from Control Data Sets Special Reporting C1. MCDS Information H1. HSM Health Reports C2. BCDS Information V1. Volume Dump Information C3. OCDS Information Support Activities Reports from Log File S1. Display Last Master L1. Migration/Backup Options S2. Set JCL Parameters L2. Recall/Recovery Options S3. DFSMShsm Task Information L3. Extent Reduction Summary S4. Generate Master L4. Recycle Return Code Summary S5. Recover Dataset L5. Log Message Summary S6. Step By Step Customization L6. Tape Usage Summary L7. Return/Reason Code Tables Batch Processing L8. Daily Space Management B1. Select Plans for Batch B2. Batch JCL Build The Master Panel options are separated into five groups: Support Activities, Reports From the Control Data Sets, Reports From the Log File, Special Reporting, and 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. 22 User s Guide

29 Reports from the control data sets Advanced Reporting for DFSMShsm s master panel offers the following options for control data set reporting: C1 C2 C3 Special reporting 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 109 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 129 of this guide and 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 125 of this guide and to Chapter 2, Installation, for further information Advanced Reporting for DFSMShsm s master panel provides the following special reporting options: H1 V1 Select this topic to access the Health Reports feature. Refer to Chapter 12, 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 13, Volume dump information, for more detailed information about this feature. Chapter 3. Advanced Reporting for DFSMShsm overview 23

30 Reports from the log file Advanced Reporting for DFSMShsm s master panel provides the following log file report options: L1 L2 L3 L4 L5 L6 L7 L8 Support activities Select this option to display return code summaries for migration activity of primary volumes. See Migration/backup options on page 249 for more detailed information about this feature. Select this option to display return code summaries for Recall/Recover activity. See Recall/recovery options on page 270 for more detailed information about this feature. 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 288 for more detailed information about this feature. Select this option to display the Recycle Return Code Summary. See Recycle return code summary on page 290 for more detailed information about this feature. Select this option to display the options available for browsing the Log File messages. See Log message summary on page 292 for more detailed information about this feature. Select this option to display the Tape Usage reports. See Tape usage summary on page 303 for more detailed information about this feature. Select this option to display an English language reference to return codes and reason codes. See Return/reason code tables on page 306 for more detailed information about this feature. 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 management on page 309 for more detailed information about this feature. Advanced Reporting for DFSMShsm s master panel provides the following support activity options: S1 S2 Selecting this option displays the summary information of the last Log File that was analyzed. Refer to page xxx for further information. 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. 24 User s Guide

31 S3 S4 S5 S6 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. 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. Selecting this option allows you to recover a specified data set. Selecting this option displays instructions for post-installation customization for Advanced Reporting for DFSMShsm. Refer to Chapter 2, Installation, for further information about performing these tasks. Batch processing options Advanced Reporting for DFSMShsm s master panel offers the following online batch process options: B1 B2 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 10, 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 10, 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. Chapter 3. Advanced Reporting for DFSMShsm overview 25

32 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. 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. 26 User s Guide

33 Mask Hex Description < 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. ** (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 27

34 28 User s Guide

35 Chapter 4. The Command Processor Commands overview 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. 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 option prompt. All other actions can be initiated either by typing the command at the active window's option prompt 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 option prompt. 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. 29

36 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. 30 User s Guide

37 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 option prompt, 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 (Other Options) at the option prompt 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 option prompt, 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 option prompt. 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 option prompt, will display the Line Command Processor pop-up panel. Alternatively, type O (Options) at the option prompt, key the appropriate option number at the pop-up panel option prompt, 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 4. The Command Processor 31

38 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: Row 1 to 11 of 25 Mig/Bkup Advanced Reporting for DFSMShsm :21 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: Row 1 to 11 of 25 Mig/Bkup Advanced Reporting for DFSMShsm :22 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

39 The following figure shows the third of these three panels: Row 1 to 11 of 25 Mig/Bkup Advanced Reporting for DFSMShsm :25 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 option prompt of the table display panel.) LineCmds Advanced Reporting for DFSMShsm 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 4. The Command Processor 33

40 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 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 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 34 User s Guide

41 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 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 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 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 4. The Command Processor 35

42 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 ARH0101X.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 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. 36 User s Guide

43 Row 1 to 10 of 10 Commands Advanced Reporting for DFSMShsm :36 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 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 4. The Command Processor 37

44 LineCmds Advanced Reporting for DFSMShsm 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 TAG 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 option prompt. 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 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

45 To untag the entire table, key UNTAG at the option prompt 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 option prompt, 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 BATCH 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 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 4. The Command Processor 39

46 After creating a batch command, the CntlCrds menu is presented. CntlCrds Advanced Reporting for DFSMShsm :31 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 option prompt, and an ISPF Browse panel will be invoked for that data set. EDIT To edit the data, key E at the option prompt, 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 option prompt 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 option prompt to submit the job. CANCEL To cancel and delete the file you just created, key C at the option prompt. 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. 40 User s Guide

47 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 option prompt of the active panel, is to key O (Other Options) at the option prompt 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 option prompt. Chapter 4. The Command Processor 41

48 42 User s Guide

49 Chapter 5. 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 6, 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 Mstr Pnl 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 ARH0101X.QABETA.ZPFX.DSROUTEX CLUSTER PURGE DELETE ARH0101X.QABETA.ZPFX.DSROUTPC CLUSTER PURGE DEFINE GDG ( NAME(ARH0101X.QABETA.ZPFX.DSROUTEX) - NOEMPTY SCRATCH LIMIT(10) ) DEFINE GDG ( NAME(ARH0101X.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. 43

50 Install the Daily Statistics Record programs on the mainframe Select the Batch JCL Build option on the Mstr Pnl panel, 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=ARH0101X.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. 44 User s Guide

51 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½ 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 ARH 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 arh0101x.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 5. PC extension for the Daily Statistics Record 45

52 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. 46 User s Guide

53 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 either highlighting one and clicking activate, double clicking on one or highlighting and clicking Enter. It was included since the format and graphing options can produce as many as 20 sheets in the workbook and we felt it was somewhat inconvenient to have to scroll back and forth among them. Chapter 5. PC extension for the Daily Statistics Record 47

54 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: 48 User s Guide

55 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 5. PC extension for the Daily Statistics Record 49