zos v1r9.0 dfsmsrmm reporting

7/22/2019 zOS V1R9.0 DFSMSrmm Reporting

1/373


2/373


3/373

z/OS

DFSMSrmmReporting

SC26-7406-07


4/373

Note

Before using this information and the product it supports, be sure to read the general information under Notices on page323.

Eighth Edition, September 2007

This edition applies to Version 1 Release 9 of z/OS (5694-A01) and to all subsequent releases and modificationsuntil otherwise indicated in new editions.

This edition replaces SC26-7406-06.

IBM welcomes your comments. A form for readers comments may be provided at the back of this publication, oryou may address your comments to the following address:

International Business Machines CorporationDepartment 55JA, Mail Station P1812455 South RoadPoughkeepsie, NY 12601-5400United States of America

FAX (United States & Canada): 1+845+432-9405FAX (Other Countries):

Your International Access Code +1+845+432-9405

IBMLink (United States customers only): IBMUSM10(MHVRCFS)Internet e-mail: [email protected] Wide Web: http://www.ibm.com/servers/eserver/zseries/zos/webqs.html

If you would like a reply, be sure to include your name, address, telephone number, or FAX number.

Make sure to include the following in your comment or note:v Title and order number of this documentv Page number or topic related to your comment

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in anyway it believes appropriate without incurring any obligation to you.

Copyright International Business Machines Corporation 1992, 2007. All rights reserved.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.
http://www.ibm.com/servers/eserver/zseries/zos/webqs.htmlhttp://www.ibm.com/servers/eserver/zseries/zos/webqs.html


5/373

ContentsFigures . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

About This Document . . . . . . . . . . . . . . . . . . . . . . xvRequired product knowledge . . . . . . . . . . . . . . . . . . . . xvReferenced documents . . . . . . . . . . . . . . . . . . . . . . xvAccessing z/OS DFSMS information on the Internet . . . . . . . . . . . xvUsing LookAt to look up message explanations . . . . . . . . . . . . . xvUsing IBM Health Checker for z/OS . . . . . . . . . . . . . . . . . xviNotational conventions . . . . . . . . . . . . . . . . . . . . . . xvi

How to read syntax diagrams . . . . . . . . . . . . . . . . . . xviHow to abbreviate commands and operands . . . . . . . . . . . . . xixHow to use continuation characters . . . . . . . . . . . . . . . . xixDelimiters . . . . . . . . . . . . . . . . . . . . . . . . . . xixCharacter sets . . . . . . . . . . . . . . . . . . . . . . . . xix

Summary of Changes . . . . . . . . . . . . . . . . . . . . . xxiSummary of Changes for SC26-7406-07 z/OS Version 1 Release 9 . . . . . xxi

New Information . . . . . . . . . . . . . . . . . . . . . . . xxiChanged Information . . . . . . . . . . . . . . . . . . . . . xxii

Summary of Changes for SC26-7406-06 z/OS Version 1 Release 8 . . . . . xxiiNew Information . . . . . . . . . . . . . . . . . . . . . . . xxiiChanged Information . . . . . . . . . . . . . . . . . . . . . xxii

Summary of Changes for SC26-7406-05 z/OS Version 1 Release 7 . . . . . xxiiNew Information . . . . . . . . . . . . . . . . . . . . . . . xxiiChanged Information . . . . . . . . . . . . . . . . . . . . . xxii

Summary of Changes for SC26-7406-04 z/OS Version 1 Release 6 . . . . . xxiiiNew Information . . . . . . . . . . . . . . . . . . . . . . . xxiiiChanged Information . . . . . . . . . . . . . . . . . . . . . xxiii

Summary of Changes for SC26-7406-03 z/OS Version 1 Release 5 . . . . . xxiiiNew Information . . . . . . . . . . . . . . . . . . . . . . . xxiiiChanged Information . . . . . . . . . . . . . . . . . . . . . xxiii

Summary of Changes for SC26-7406-02 z/OS Version 1 Release 3 . . . . . xxiiiNew Information . . . . . . . . . . . . . . . . . . . . . . . xxivChanged Information . . . . . . . . . . . . . . . . . . . . . xxiv

Summary of Changes for SC26-7406-01 z/OS Version 1 Release 3 . . . . . xxivNew Information . . . . . . . . . . . . . . . . . . . . . . . xxivChanged Information . . . . . . . . . . . . . . . . . . . . . xxiv

Chapter 1. Creating DFSMSrmm Reports . . . . . . . . . . . . . . . 1Using the DFSMSrmm ISPF Dialog and RMM TSO Subcommands . . . . . . 1

Using the DFSMSrmm Inventory Management EDGHSKP Utility . . . . . . . 2Using the EDGRPTD and EDGAUD Report Utilities . . . . . . . . . . . . 2Using the DFSMSrmm EDGRRPTE EXEC . . . . . . . . . . . . . . . 3Using DFSORT and the DFSORT ICETOOL Utility . . . . . . . . . . . . 3Using the DFSMSrmm Application Programming Interface . . . . . . . . . 3

Chapter 2. Using the DFSMSrmm Report Generator . . . . . . . . . . 5Setting up the Report Generator for Your Installation . . . . . . . . . . . 6Steps for Using the Report Generator . . . . . . . . . . . . . . . . . 7Running a Report Generator Report . . . . . . . . . . . . . . . . . 7Specifying Libraries for the Report Generator . . . . . . . . . . . . . . 10

Copyright IBM Corp. 1992, 2007 iii


6/373


7/373

REPORT04: Inventory List by Data Set Name . . . . . . . . . . . . 96REPORT05: Inventory of Data Sets Including Used Kilobytes . . . . . . . 98REPORT06: Inventory of Volume Serial Numbers by Location . . . . . . 99REPORT07: Inventory of Data Set Names by Location . . . . . . . . . 101REPORT08: Inventory of Bin Numbers by Location . . . . . . . . . . 103REPORT09: List all Data Set Names Residing in a Loan Location . . . . 105REPORT10: List all Volume Serial Numbers Residing in a Loan Location 106

REPORT11: List MultiVolume and MultiFile Sets . . . . . . . . . . . 108REPORT12: Movement Report by Data Set Name . . . . . . . . . . 109REPORT13: Movement Report by Bin Number . . . . . . . . . . . . 111REPORT14: Movement Report by Volume Serial Number . . . . . . . . 113REPORT15: Inventory List By Volume Including Volume Count . . . . . . 114REPORT16: List All Duplicate Volume Serial Numbers . . . . . . . . . 116REPORT17: Inventory of Stacked Volumes by Percent Active . . . . . . 117

Chapter 6. Using DFSMSrmm with DFSORT . . . . . . . . . . . . . 119Using DFSORTs ICETOOL . . . . . . . . . . . . . . . . . . . . 119

Creating DFSMSrmm SMF Audit Record Reports . . . . . . . . . . . 120Producing Commands and Reports from the Extract Data Set . . . . . . 122

Using Symbols with DFSORTs ICETOOL and DFSORT . . . . . . . . . 123How Symbols Help . . . . . . . . . . . . . . . . . . . . . . 123Using Symbols . . . . . . . . . . . . . . . . . . . . . . . 124SYMNAMES and SYMNOUT DD Statements . . . . . . . . . . . . 125SYMNAMES Statements . . . . . . . . . . . . . . . . . . . . 126Symbols in DFSORT Statements . . . . . . . . . . . . . . . . . 127Symbols in ICETOOL Statements . . . . . . . . . . . . . . . . 128SMF Audit Report Using DFSORT Symbols . . . . . . . . . . . . . 128

Chapter 7. Using DFSMSrmm-Supplied Sample Reports . . . . . . . . 131Creating Monthly Archives from Weekly Audit Reports . . . . . . . . . . 132

EDGJAUDM Input and Output . . . . . . . . . . . . . . . . . . 132EDGJAUDM Customization . . . . . . . . . . . . . . . . . . . 132EDGJAUDM Examples . . . . . . . . . . . . . . . . . . . . 133

Creating Weekly Archives from Daily Audit Reports . . . . . . . . . . . 134EDGJAUDW Input and Output . . . . . . . . . . . . . . . . . . 134EDGJAUDW Customization . . . . . . . . . . . . . . . . . . . 134EDGJAUDW Examples . . . . . . . . . . . . . . . . . . . . 135

Creating RMM Subcommands of Barcode Scanned Volumes . . . . . . . 137EDGJBCAV Input and Output . . . . . . . . . . . . . . . . . . 137EDGJBCAV Customization . . . . . . . . . . . . . . . . . . . 137EDGJBCAV Examples . . . . . . . . . . . . . . . . . . . . . 138

Auditing the Tape Library Audit Using a Barcode Scanner . . . . . . . . . 138EDGJCOMB Input and Output . . . . . . . . . . . . . . . . . . 138EDGJCOMB Customization . . . . . . . . . . . . . . . . . . . 138EDGJCOMB Examples . . . . . . . . . . . . . . . . . . . . 139

Creating RMM CHANGEVOLUME Subcommands for Volumes in StorageLocations . . . . . . . . . . . . . . . . . . . . . . . . . . 140EDGJCVB Input and Output . . . . . . . . . . . . . . . . . . 140EDGJCVB Customization . . . . . . . . . . . . . . . . . . . 140EDGJCVB Examples . . . . . . . . . . . . . . . . . . . . . 140

Creating a Data Set Report Sorted by Data Set Name . . . . . . . . . . 141EDGJDSN Input and Output . . . . . . . . . . . . . . . . . . 141EDGJDSN Customization . . . . . . . . . . . . . . . . . . . 141EDGJDSN Examples . . . . . . . . . . . . . . . . . . . . . 142

Creating a Report of Volumes Returned to Scratch . . . . . . . . . . . 143EDGJNSCR Input and Output . . . . . . . . . . . . . . . . . . 143

Contents v

||


8/373

EDGJNSCR Customization . . . . . . . . . . . . . . . . . . . 143EDGJNSCR Examples . . . . . . . . . . . . . . . . . . . . 143

Creating a Report of Rack Prefixes . . . . . . . . . . . . . . . . . 145EDGJRACK Input and Output . . . . . . . . . . . . . . . . . . 145EDGJRACK Customization . . . . . . . . . . . . . . . . . . . 145EDGJRACK Examples . . . . . . . . . . . . . . . . . . . . 145

Obtaining Information about Lost Volumes . . . . . . . . . . . . . . 146

EDGJRECL Input and Output . . . . . . . . . . . . . . . . . . 146EDGJRECL Customization . . . . . . . . . . . . . . . . . . . 146EDGJRECL Examples . . . . . . . . . . . . . . . . . . . . . 147

Recovering Lost Volumes . . . . . . . . . . . . . . . . . . . . 147EDGJRECV Input and Output . . . . . . . . . . . . . . . . . . 147EDGJRECV Customization . . . . . . . . . . . . . . . . . . . 147EDGJRECV Examples . . . . . . . . . . . . . . . . . . . . 148

Creating Reports on Owners Sorted by Name and by Department . . . . . 149EDGJROWN Input and Output . . . . . . . . . . . . . . . . . 149EDGJROWN Customization . . . . . . . . . . . . . . . . . . . 150EDGJROWN Examples . . . . . . . . . . . . . . . . . . . . 150

Creating Volume Reports . . . . . . . . . . . . . . . . . . . . . 151EDGJRVOL Input and Output . . . . . . . . . . . . . . . . . . 151EDGJRVOL Customization . . . . . . . . . . . . . . . . . . . 151EDGJRVOL Examples . . . . . . . . . . . . . . . . . . . . . 152

Creating a List of DFSMSrmm SMF Volume Records . . . . . . . . . . 154EDGJSMF Input and Output . . . . . . . . . . . . . . . . . . 154EDGJSMF Customization . . . . . . . . . . . . . . . . . . . 154EDGJSMF Examples . . . . . . . . . . . . . . . . . . . . . 155

Creating a Summary of SMF Records . . . . . . . . . . . . . . . . 156EDGJSMFP Input and Output . . . . . . . . . . . . . . . . . . 156EDGJSMFP Customization . . . . . . . . . . . . . . . . . . . 156EDGJSMFP Examples . . . . . . . . . . . . . . . . . . . . 156

Creating a Report about Volumes in Storage Locations . . . . . . . . . 157EDGJVLT Input and Output . . . . . . . . . . . . . . . . . . . 157EDGJVLT Customization . . . . . . . . . . . . . . . . . . . . 157EDGJVLT Examples . . . . . . . . . . . . . . . . . . . . . 157

Creating a Report about Volumes Moving to Storage Locations . . . . . . 159EDGJVLTM Input and Output . . . . . . . . . . . . . . . . . . 159EDGJVLTM Customization . . . . . . . . . . . . . . . . . . . 159EDGJVLTM Examples . . . . . . . . . . . . . . . . . . . . . 159

Creating Volume Reports Sorted by Volume Serial Number . . . . . . . . 160EDGJVOL Input and Output . . . . . . . . . . . . . . . . . . 160EDGJVOL Customization . . . . . . . . . . . . . . . . . . . . 161EDGJVOL Examples . . . . . . . . . . . . . . . . . . . . . 161

Chapter 8. Creating REXX EXECs . . . . . . . . . . . . . . . . . 165Using Sample REXX EXECs . . . . . . . . . . . . . . . . . . . 165

EDGXMP1 VOLCHAIN EXEC . . . . . . . . . . . . . . . . . . 166EDGXMP2 DSNLIST EXEC . . . . . . . . . . . . . . . . . . . 168

Appendix A. DFSORT Symbols for Use with DFSMSrmm . . . . . . . 171EDGACTSY : Activity File Symbols . . . . . . . . . . . . . . . . . 171EDGEXTSY: Extract Data Set Symbols . . . . . . . . . . . . . . . 175EDGSMFSY: SMF Record Symbols . . . . . . . . . . . . . . . . . 194

Appendix B. DFSMSrmm Mapping Macros . . . . . . . . . . . . . 239General-use Programming Interface Mapping Macros . . . . . . . . . . 239

Extract Data Set Data Set Name Record: EDGRDEXT . . . . . . . . . 240

vi z/OS V1R9.0 DFSMSrmm Reporting


9/373

Extract Data Set Header Record: EDGRHEXT . . . . . . . . . . . . 243Extract Data Set Vital Record Specification Record: EDGRKEXT . . . . . 244Extract Data Set Owner Record: EDGROEXT . . . . . . . . . . . . 247Extract Data Set Software Product Record: EDGRPEXT . . . . . . . . 249Extract Data Set Rack Record: EDGRREXT . . . . . . . . . . . . 250Extract Data Set Storage Location Shelf Location Record EDGRSEXT 251Extract Data Set Volume Report Record: EDGRVEXT . . . . . . . . . 253

Extract Data Set Extended Data Set Name Record: EDGRXEXT . . . . . 259SMF Audit Record Header Information: EDGSMFAR . . . . . . . . . 269SMF Security Record Information: EDGSMFSR . . . . . . . . . . . 270

Product-sensitive Programming Interface Mapping Macros . . . . . . . . 271ACTIVITY File Record Macro: EDGACTRC . . . . . . . . . . . . . 271Conversion Library Information: EDGCLREC . . . . . . . . . . . . 280SMF Action Record Information: EDGSAREC . . . . . . . . . . . . 287SMF Data Set Information: EDGSDREC . . . . . . . . . . . . . . 289SMF Vital Record Specification Information: EDGSKREC . . . . . . . . 294SMF Owner Information: EDGSOREC . . . . . . . . . . . . . . . 297SMF Software Product Information: EDGSPREC . . . . . . . . . . . 300SMF Library Shelf Location Information: EDGSRREC . . . . . . . . . 302SMF Storage Location Shelf Location Information: EDGSSREC . . . . . 304SMF Volume Information: EDGSVREC . . . . . . . . . . . . . . 306

Appendix C. List of DFSMSrmm Samples . . . . . . . . . . . . . . 319

Appendix D. Accessibility . . . . . . . . . . . . . . . . . . . . 321Using assistive technologies . . . . . . . . . . . . . . . . . . . 321Keyboard navigation of the user interface . . . . . . . . . . . . . . . 321z/OS information . . . . . . . . . . . . . . . . . . . . . . . . 321

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . 323Programming interface information . . . . . . . . . . . . . . . . . 324Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . 324

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . 325

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

Contents vii

||


10/373

viii z/OS V1R9.0 DFSMSrmm Reporting


11/373


12/373

51. Defining a Report that Shows Column Totals . . . . . . . . . . . . . . . . . . . . 3752. ICETOOL Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3753. Multi-part Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3854. Sample VRS Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4355. Sample VRSS Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4356. Sample RETDATE Report . . . . . . . . . . . . . . . . . . . . . . . . . . . 4557. Sample RETDS Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

58. Sample MATCHVRS Report . . . . . . . . . . . . . . . . . . . . . . . . . . . 4859. Sample MATCHVS Report . . . . . . . . . . . . . . . . . . . . . . . . . . . 4960. Sample SUBCHN Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5061. Sample SUBCHNS Report . . . . . . . . . . . . . . . . . . . . . . . . . . . 5162. JCL for EDGJACTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5263. Example of JCL for EDGRPTD to Create Inventory Reports, Movement Reports, and Scratch List

Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6164. EDGRPTD EXEC Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 6165. INSTBIN Report Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6666. INSTOWN Report Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . 6767. INSTVOL Report Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6868. FMSTBIN Report Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6969. FMSTOWN Report Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . 7070. RDYTOSCR Report Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . 7071. TOSTOWN Report Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . 7172. TOSTRCK Report Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . 7173. NEWSCR Report Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . 7374. SCRLIST Report Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7475. JCL for EDGAUD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7576. EDGAUD EXEC Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 7577. EDGAUD SYSIN Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 7778. Example of JCL for using the SELECT SYSIN . . . . . . . . . . . . . . . . . . . . 7779. Report of Access to Secure Volumes . . . . . . . . . . . . . . . . . . . . . . . 8080. Audit Trail Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8281. Report Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8782. Data Control Block (DCB) Information for Each Report File . . . . . . . . . . . . . . . 8883. Creating a Report Security Header . . . . . . . . . . . . . . . . . . . . . . . . 8884. Defining a CCARD DD Statement . . . . . . . . . . . . . . . . . . . . . . . . 8885. Sorting by Volume Serial Number and Volume Status . . . . . . . . . . . . . . . . . 8986. Sorting by Volume Serial Number, Volume Status, and Temporary Errors, Excluding Volumes

without Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8987. REPORT01 Report Header . . . . . . . . . . . . . . . . . . . . . . . . . . . 9088. REPORT01 Report Header Modified . . . . . . . . . . . . . . . . . . . . . . . 9089. REPORT01 Column Headings . . . . . . . . . . . . . . . . . . . . . . . . . . 9090. REPORT01 Column Headings Modified . . . . . . . . . . . . . . . . . . . . . . 9091. REPORT01 Returned Values . . . . . . . . . . . . . . . . . . . . . . . . . . 9092. REPORT01 Returned Values Modified . . . . . . . . . . . . . . . . . . . . . . . 9193. Sample REPORT01 Output: Pull List for SCRATCH Tapes Sorted by Volume Serial Number 92

94. Sample REPORT02 Output: Pull List for SCRATCH Tapes Sorted by Data Set Name. . . . . . 9495. Sample REPORT03 Output: Inventory List by Volume Serial Number . . . . . . . . . . . 9696. Sample REPORT04 Output: Inventory List by Data Set Name . . . . . . . . . . . . . . 9797. Sample REPORT05 Output: Inventory of Data Sets Including Used Kilobytes . . . . . . . . 9998. Sample REPORT06 Output: Inventory of Volume Serial Numbers by Location . . . . . . . . 10199. Sample REPORT07 Output: Inventory of Data Set Names by Location . . . . . . . . . . 103

100. Sample REPORT08 Output: Inventory of Bin Numbers by Location . . . . . . . . . . . . 104101. Sample REPORT09 Output: List all Data Set Names that Reside in a Loan Location . . . . . 106102. Sample REPORT10 Output: List all Volume Serial Numbers that Reside in a Loan Location 107103. Sample REPORT11 Output: List all MultiVolume and MultiFile Sets . . . . . . . . . . . . 109104. Sample REPORT12 Output: Movement Report Including the First Data Set Name . . . . . . 111

x z/OS V1R9.0 DFSMSrmm Reporting

||

||


13/373

105. Sample REPORT13 Output: Movement Report Including the First Data Set Name Sorted by BinNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

106. Sample REPORT14 Output: Movement Report Including the First Data Set Name Sorted byVolume Serial Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

107. Sample REPORT15 Output: Inventory List of Volumes Including the Volume Count . . . . . . 115108. Sample REPORT16 Output: List all Duplicate Volume Serial Numbers . . . . . . . . . . . 117109. Sample REPORT17 Output: Inventory of Stacked Volumes by Percent Active . . . . . . . . 118

110. Sample ICETOOL JCL for Processing SMF Records . . . . . . . . . . . . . . . . . 121111. Sample DISPLAY Report (VREPT DD) . . . . . . . . . . . . . . . . . . . . . . 121112. Sample ICETOOL JCL for Processing Extract Records . . . . . . . . . . . . . . . . 122113. Sample RMM TSO Subcommands (COMMANDS DD) . . . . . . . . . . . . . . . . 123114. Sample OCCUR Report (OCCRPT DD) . . . . . . . . . . . . . . . . . . . . . . 123115. Symbol Data Set (ACCOUNTS.SYMBOL) . . . . . . . . . . . . . . . . . . . . . 125116. Sample ICETOOL JCL for Processing SMF Records Using Symbols . . . . . . . . . . . 129117. EDGJAUDM: Sample List of a Monthly Audit Report Sorted by Volume . . . . . . . . . . 133118. EDGJAUDM: Sample List of a Monthly Audit Report Sorted by Rack Number . . . . . . . . 133119. EDGJAUDM: Sample List of a Monthly Audit Report Sorted by User ID . . . . . . . . . . 134120. EDGJAUDW: Sample Report of a Weekly Audit Report Sorted by Volume . . . . . . . . . 135121. EDGJAUDW: Sample Report of a Weekly Audit Report Sorted by Rack Number . . . . . . . 136122. EDGJAUDW: Sample Report of a Weekly Audit Report Sorted by Userid . . . . . . . . . . 137123. EDGJBCAV: Sample Input of Barcode-Scanned Volumes . . . . . . . . . . . . . . . 138124. EDGJBCAV: Sample Output of RMM ADDVOLUME Subcommands from Barcode Scanned

Volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138125. EDGJCOMB: Sample List of Volumes Found in the Extract Data Set Only . . . . . . . . . 139126. EDGJCOMB: Sample List of Volumes in the Location Library Only . . . . . . . . . . . . 139127. EDGJCOMB: Sample List of Volumes in the Library and the Extract Data Set . . . . . . . . 139128. EDGJCVB: Sample Output of RMM CHANGEVOLUME Subcommands for Volumes in Storage

Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141129. EDGJCVB: Sample Report of Volume Counts by Location . . . . . . . . . . . . . . . 141130. EDGJDSN: Sample Report of Data Sets Sorted by Name . . . . . . . . . . . . . . . 142131. EDGJDSN: Sample Report of Data Set Counts by Status . . . . . . . . . . . . . . . 142132. EDGJNSCR: Sample Report of New Scratch Volumes . . . . . . . . . . . . . . . . 144133. EDGJNSCR: Sample Report of the Number of New Scratch Media by Media . . . . . . . . 144134. EDGJRACK: Sample Report of Rack Prefixes with Volume Count . . . . . . . . . . . . 145135. EDGJRECL: Sample Report of a List of Lost Volumes . . . . . . . . . . . . . . . . 147136. EDGJRECV: Sample list of RMM ADDVOLUME Subcommands for Lost Volumes . . . . . . 149137. EDGJROWN: Sample Report of Owners Listed by Last Name . . . . . . . . . . . . . 150138. EDGJROWN: Sample Report of Owners Listed by Department . . . . . . . . . . . . . 151139. EDGJRVOL: Sample Report of Volumes Sorted by Volume Serial Number . . . . . . . . . 152140. EDGJRVOL: Sample Report of Volumes Sorted by Rack Number . . . . . . . . . . . . 153141. EDGJRVOL: Sample Report of Volumes Sorted by Security Level . . . . . . . . . . . . 153142. EDGJRVOL: Sample Report of Volumes Sorted by Owner . . . . . . . . . . . . . . . 153143. EDGJRVOL: Sample Report of Volumes Sorted by Expiration Date . . . . . . . . . . . . 154144. EDGJSMF: Sample Report of a List of All DFSMSrmm SMF Volume Records . . . . . . . . 155145. EDGJSMFP: Sample Report of SMF Audit Record Counts by Record Number . . . . . . . . 156

146. EDGJVLT: Sample Report of Volumes in Storage Location . . . . . . . . . . . . . . . 158147. EDGJVLT: Sample Report of Volume Counts by Location . . . . . . . . . . . . . . . 158148. EDGJVLTM: Sample Report of Volumes Moving to Storage Locations . . . . . . . . . . . 159149. EDGJVLTM: Sample Report of Volume Counts by Location . . . . . . . . . . . . . . . 160150. EDGJVOL: Sample Reports of Volumes Sorted by Volume Serial Number . . . . . . . . . 161151. EDGJVOL: Sample Report of Volume Counts by Status . . . . . . . . . . . . . . . . 162152. EDGJVOL: Sample Report of Volume Counts by Pending Release Status . . . . . . . . . 163153. VOLCHAIN EXEC Sample REXX EXEC . . . . . . . . . . . . . . . . . . . . . . 166154. DSNLIST EXEC Sample REXX EXEC . . . . . . . . . . . . . . . . . . . . . . 168

Figures xi

||


14/373

xii z/OS V1R9.0 DFSMSrmm Reporting


15/373

Tables

1. Character Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx2. Special Characters Used in Syntax . . . . . . . . . . . . . . . . . . . . . . . . xx3. Report Generator Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . 354. Data Sets Used for Inventory Management Reports . . . . . . . . . . . . . . . . . . 395. Date Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416. DFSMSrmm Report Utilities and Samples . . . . . . . . . . . . . . . . . . . . . . 597. EDGRPTD Return Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648. EDGAUD Return Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 839. DFSMSrmm Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

10. DFSMSrmm-Supplied Reports . . . . . . . . . . . . . . . . . . . . . . . . . 13111. DFSMSrmm Sample Reporting Jobs . . . . . . . . . . . . . . . . . . . . . . . 319

Copyright IBM Corp. 1992, 2007 xiii


16/373

xiv z/OS V1R9.0 DFSMSrmm Reporting


17/373

About This Document

This document tells you how to create reports for DFSMSrmm resources. It isintended for storage administrators, system programmers, and applicationprogrammers who are responsible for implementing, customizing, and usingDFSMSrmm. A topic about using DFSORT ICETOOL symbols, which becameavailable with DFSORT Release 14, is included. Using ICETOOL symbols cansimplify report writing.

For information about accessibility features of z/OS, for users who have a physicaldisability, see Appendix D, Accessibility, on page 321 .

Required product knowledgeTo use this document effectively, you should be familiar with:v Using DFSMSrmm Utilitiesv Using DFSORTs ICETOOLv Using ISPFv

Writing REXX EXECsv Using TSO Commands

Referenced documentsThese documents have additional information about DFSMSrmm:

Document Title Order Number

z/OS DFSMSrmm Application Programming Interface SC26-7403

z/OS DFSMSrmm Diagnosis Guide GY27-7619

z/OS DFSMSrmm Guide and Reference SC26-7404

z/OS DFSMSrmm Implementation and Customization Guide SC26-7405

These documents have additional information about DFSORT:

Document Title Order Number

z/OS DFSORT Application Programming Guide SC26-7523

z/OS DFSORT: Getting Started SC26-7527

Accessing z/OS DFSMS information on the InternetIn addition to making softcopy information available on CD-ROM, IBM providesaccess to z/OS softcopy information on the Internet. To view, search, and print z/OSinformation, go to the z/OS Internet Library:http://www.ibm.com/servers/eserver/zseries/zos/bkserv/

Using LookAt to look up message explanationsLookAt is an online facility that lets you look up explanations for most of the IBM

messages you encounter, as well as for some system abends and codes. UsingLookAt to find information is faster than a conventional search because in mostcases LookAt goes directly to the message explanation.

Copyright IBM Corp. 1992, 2007 xv
http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2g360.pdf/http://dgt2g360.pdf/http://dgt2g360.pdf/http://dgt2g360.pdf/http://dgt2r360.pdf/http://dgt2r360.pdf/http://dgt2r360.pdf/http://dgt2r360.pdf/http://dgt2r360.pdf/http://dgt2c860.pdf/http://dgt2c860.pdf/http://dgt2c860.pdf/http://dgt2c860.pdf/http://dgt2c860.pdf/http://dgt2c860.pdf/http://ice1ca20.pdf/http://ice1ca20.pdf/http://ice1ca20.pdf/http://ice1ca20.pdf/http://ice1ca20.pdf/http://ice1cg20.pdf/http://ice1cg20.pdf/http://ice1cg20.pdf/http://ice1cg20.pdf/http://www.ibm.com/servers/eserver/zseries/zos/bkserv/http://www.ibm.com/servers/eserver/zseries/zos/bkserv/http://ice1cg20.pdf/http://ice1ca20.pdf/http://dgt2c860.pdf/http://dgt2r360.pdf/http://dgt2g360.pdf/http://dgt2a160.pdf/


18/373

You can use LookAt from these locations to find IBM message explanations forz/OS elements and features, z/VM , VSE/ESA , and Clusters for AIX and Linux:v The Internet. You can access IBM message explanations directly from the LookAt

Web site at www.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/.v Your z/OS TSO/E host system. You can install code on your z/OS systems to

access IBM message explanations using LookAt from a TSO/E command line(for example: TSO/E prompt, ISPF, or z/OS UNIX System Services).

v Your Microsoft Windows workstation. You can install LookAt directly from thez/OS Collection (SK3T-4269) or the z/OS and Software Products DVD Collection (SK3T-4271) and use it from the resulting Windows graphical user interface(GUI). The command prompt (also known as the DOS > command line) versioncan still be used from the directory in which you install the Windows version ofLookAt.

v Your wireless handheld device. You can use the LookAt Mobile Edition fromwww.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/lookatm.html with ahandheld device that has wireless access and an Internet browser (for example:Internet Explorer for Pocket PCs, Blazer or Eudora for Palm OS, or Opera forLinux handheld devices).

You can obtain code to install LookAt on your host system or Microsoft Windowsworkstation from:v A CD-ROM in the z/OS Collection (SK3T-4269).v The z/OS and Software Products DVD Collection (SK3T-4271).v The LookAt Web site (click Download and then select the platform, release,

collection, and location that suit your needs). More information is available in theLOOKAT.ME files available during the download process.

Using IBM Health Checker for z/OSIBM Health Checker for z/OS is a z/OS component that installations can use togather information about their system environment and system parameters to helpidentify potential configuration problems before they impact availability or causeoutages. Individual products, z/OS components, or ISV software can provide checksthat take advantage of the IBM Health Checker for z/OS framework. This bookmight refer to checks or messages associated with this component.

For additional information about checks and about IBM Health Checker for z/OS,see IBM Health Checker for z/OS: Users Guide . Starting with z/OS V1R4, z/OSusers can obtain the IBM Health Checker for z/OS from the z/OS Downloads pageat http://www.ibm.com/servers/eserver/zseries/zos/downloads/.

SDSF also provides functions to simplify the management of checks. See z/OS SDSF Operation and Customization for additional information.

Notational conventionsThis section explains the notational conventions used in this document.

How to read syntax diagramsThroughout this library, diagrams are used to illustrate the programming syntax.Keyword parameters are parameters that follow the positional parameters. Unlessotherwise stated, keyword parameters can be coded in any order. The following listtells you how to interpret the syntax diagrams:

xvi z/OS V1R9.0 DFSMSrmm Reporting
http://www.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/http://www.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/lookatm.htmlhttp://e0z2l120.pdf/http://e0z2l120.pdf/http://e0z2l120.pdf/http://e0z2l120.pdf/http://e0z2l120.pdf/http://e0z2l120.pdf/http://e0z2l120.pdf/http://e0z2l120.pdf/http://www.ibm.com/servers/eserver/zseries/zos/downloads/http://isf4cs70.pdf/http://isf4cs70.pdf/http://isf4cs70.pdf/http://isf4cs70.pdf/http://isf4cs70.pdf/http://isf4cs70.pdf/http://isf4cs70.pdf/http://www.ibm.com/servers/eserver/zseries/zos/downloads/http://e0z2l120.pdf/http://www.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/lookatm.htmlhttp://www.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/


19/373

v Read the diagrams from left-to-right, top-to-bottom, following the main path line.Each diagram begins on the left with double arrowheads and ends on the rightwith two arrowheads facing each other.

Syntax Diagram

v If a diagram is longer than one line, each line to be continued ends with a singlearrowhead and the next line begins with a single arrowhead.

LISTDATASETLD

data_set_name VOLUME(volume_serial )

1FILESEQ ( physical_file_sequence_number )SEQ

v Required keywords and values appear on the main path line. You must coderequired keywords and values.

REQUIRED_KEYWORD

If several mutually exclusive required keywords or values exist, they are stackedvertically in alphanumeric order.

REQUIRED_KEYWORD_OR_VALUE_1REQUIRED_KEYWORD_OR_VALUE_2

v Optional keywords and values appear below the main path line. You can choosenot to code optional keywords and values.

KEYWORD

If several mutually exclusive optional keywords or values exist, they are stackedvertically in alphanumeric order below the main path line.

KEYWORD_OR_VALUE_1KEYWORD_OR_VALUE_2

v An arrow returning to the left above a keyword or value on the main path linemeans that the keyword or value can be repeated. The comma means that eachkeyword or value must be separated from the next by a comma.

,

REPEATABLE_KEYWORD

v An arrow returning to the left above a group of keywords or values means morethan one can be selected, or a single one can be repeated.

About This Document xvii


20/373

,

REPEATABLE_KEYWORD_OR_VALUE_1REPEATABLE_KEYWORD_OR_VALUE_2

v A word in all uppercase is a keyword or value you must spell exactly as shown.

In this example, you must code KEYWORD .

KEYWORD

If a keyword or value can be abbreviated, the abbreviation is discussed in thetext associated with the syntax diagram.

v If a diagram shows a character that is not alphanumeric (such as parentheses,periods, commas, and equal signs), you must code the character as part of thesyntax. In this example, you must code KEYWORD=(001,0.001) .

KEYWORD=(001,0.001)

v If a diagram shows a blank space, you must code the blank space as part of thesyntax. In this example, you must code KEYWORD=(001 FIXED) .

KEYWORD=(001FIXED)

v Default keywords and values appear above the main path line. If you omit thekeyword or value entirely, the default is used.

DEFAULT

KEYWORD

v

A word in all lowercase italics is a variable . Where you see a variable in thesyntax, you must replace it with one of its allowable names or values, as definedin the text.

(1)variable

Notes:

1 An example of a syntax note.v References to syntax notes appear as numbers enclosed in parentheses above

the line. Do not code the parentheses or the number.

KEYWORD

v Some diagrams contain syntax fragments , which serve to break up diagrams thatare too long, too complex, or too repetitious. Syntax fragment names are inmixed case and are shown in the diagram and in the heading of the fragment.The fragment is placed below the main diagram.

Reference to Syntax Fragment

xviii z/OS V1R9.0 DFSMSrmm Reporting


21/373

Syntax Fragment:

1ST_KEYWORD,2ND_KEYWORD,3RD_KEYWORD

The following is an example of a syntax diagram.

DELETEOWNERDO

owner_IDnewowner

newowner

(1)NEWOWNER(new_owner_ID)

Notes:

1 Must be specified if the owner owns one or more volumes.

The possible valid versions of the RMM DELETEOWNER command are:RMMDELETEOWNERownerRMMDO ownerRMMDELETEOWNERowner NEWOWNER(new_owner)RMMDO owner NEWOWNER(new_owner)

How to abbreviate commands and operandsThe TSO abbreviation convention applies for all DFSMSrmm commands andoperands. The TSO abbreviation convention requires you to specify as much of thecommand name or operand as is necessary to distinguish it from the othercommand names or operands.

Some DFSMSrmm keyword operands allow unique abbreviations. All uniqueabbreviations are shown in the command syntax diagrams.

How to use continuation charactersThe symbol - is used as the continuation character in this document. You can useeither - or +.

- Do not ignore leading blanks on the continuation statement

+ Ignore leading blanks on the continuation statement

DelimitersWhen you type a command, you must separate the command name from the first

operand by one or more blanks. You must separate operands by one or moreblanks or a comma. Do not use a semicolon as a delimiter because any characteryou enter after a semicolon is ignored.

Character setsTo code job control statements, use characters from the character sets in Table 1.Table 2 on page xx lists the special characters that have syntactical functions in jobcontrol statements.

About This Document xix


22/373

Table 1. Character Sets

Character Set Contents

Alphanumeric AlphabeticNumeric

Capital A through Z0 through 9

National(See note)

At signDollar sign

Pound sign

@ (Characters that can be$ represented by hexadecimal

# values X'7C', X'5B', and X'7B')Special Comma

PeriodSlashApostropheLeft parenthesisRight parenthesisAsteriskAmpersandPlus signHyphenEqual signBlank

,.

/ '()*&+-=

EBCDIC text EBCDIC printable character set Characters that can be representedby hexadecimal X'40' through X'FE'

Note: The system recognizes the following hexadecimal representations of the U.S.National characters; @ as X'7C'; $ as X'5B'; and # as X'7B'. In countries other than theU.S., the U.S. National characters represented on terminal keyboards might generate adifferent hexadecimal representation and cause an error. For example, in some countriesthe $ character may generate a X'4A'.

Table 2. Special Characters Used in Syntax

Character Syntactical Function

, To separate parameters and subparameters

= To separate a keyword from its value, for example, BURST=YES

( ) To enclose subparameter list or the member name of a PDS or PDSE

& To identify a symbolic parameter, for example, &LIB

&& To identify a temporary data set name, for example, &&TEMPDS, and, toidentify an in-stream or sysout data set name, for example, &&PAYOUT

. To separate parts of a qualified data set name, for example, A.B.C., orparts of certain parameters or subparameters, for example,nodename.userid

* To refer to an earlier statement, for example, OUTPUT=*.name, or, incertain statements, to indicate special functions: //label CNTL * //ddnameDD * RESTART=* on the JOB statement

To enclose specified parameter values which contain special characters

(blank) To delimit fields

xx z/OS V1R9.0 DFSMSrmm Reporting


23/373

Summary of Changes

This document contains terminology, maintenance, and editorial changes. Technicalchanges or additions to the text and illustrations are indicated by a vertical line tothe left of the change.

You might notice changes in the style and structure of some content in thisdocument--for example, headings that are more task-oriented and procedures thathave a different look and format. The changes are ongoing improvements to theconsistency and retrievability of information in our documents.

Summary of Changes for SC26-7406-07 z/OS Version 1 Release 9This document contains information that was previously presented in z/OS Version 1 Release 8 DFSMSrmm Reporting (SC26-7406-06).

The following section summarizes the changes to that information.

New InformationThis edition includes the following new information:v Recording format EEF2 (the abbreviation for EEFMT2, enterprise encrypted

format 2) added to these REPORTS: REPORT01: Pull List for SCRATCH Tapes Sorted by Volume Serial Number

on page 91 REPORT02: Pull List for SCRATCH Tapes Sorted by Data Set Name on

page 92 REPORT03: Inventory List by Volume Serial Number on page 94 REPORT04: Inventory List by Data Set Name on page 96 REPORT05: Inventory of Data Sets Including Used Kilobytes on page 98 REPORT06: Inventory of Volume Serial Numbers by Location on page 99

REPORT07: Inventory of Data Set Names by Location on page 101 REPORT08: Inventory of Bin Numbers by Location on page 103 REPORT09: List all Data Set Names Residing in a Loan Location on page

105 REPORT10: List all Volume Serial Numbers Residing in a Loan Location on

page 106 REPORT12: Movement Report by Data Set Name on page 109 REPORT13: Movement Report by Bin Number on page 111 REPORT14: Movement Report by Volume Serial Number on page 113 REPORT16: List All Duplicate Volume Serial Numbers on page 116

v Reporting sample REPORT17 added to obtain information about the inventory ofstacked volumes by percent active. See REPORT17: Inventory of StackedVolumes by Percent Active on page 117.

v Recording format EEFMT2 added to Appendix A, DFSORT Symbols for Use withDFSMSrmm, on page 171 and Appendix B, DFSMSrmm Mapping Macros, onpage 239.

v Key encryption key label 1 and key label 2 added to Appendix A, DFSORTSymbols for Use with DFSMSrmm, on page 171 and Appendix B, DFSMSrmmMapping Macros, on page 239.

v Mapping macro EDGCLREC added to Appendix B, DFSMSrmm MappingMacros, on page 239. See Conversion Library Information: EDGCLREC onpage 280.

Copyright IBM Corp. 1992, 2007 xxi


24/373

Changed Information



New InformationThe following information was new in this edition:v New media types EXTC and EXWTC (DFSMSrmm aliases : MEDIA9 and

MEDIA10 ) added to Appendix A, DFSORT Symbols for Use with DFSMSrmm,on page 171 and Appendix B, DFSMSrmm Mapping Macros, on page 239.

v New recording format EFMT2 added to Appendix A, DFSORT Symbols for Usewith DFSMSrmm, on page 171 and Appendix B, DFSMSrmm Mapping Macros,on page 239.

v Added information about Julian or ISO format of dates used for comparison of

dates to Chapter 2, Using the DFSMSrmm Report Generator, on page 5.v Added EFM2 to the DFSMSrmm-supplied reports in Chapter 5, Creating Reports

Using DFSMSrmm-Supplied EXECs, on page 85.

Changed InformationThe following information was changed in this edition:v DFSORT symbols for use with DFSMSrmm have been updated. See Appendix A,

DFSORT Symbols for Use with DFSMSrmm, on page 171 for the updatedsymbol files EDGACTSY, EDGEXTSY, and EDGSMFSY.

v DFSMSrmm mapping macros have been updated. See Appendix B, DFSMSrmmMapping Macros, on page 239 for changed mapping macros: EDGRHEXT,EDGRKEXT, EDGROEXT, EDGRVEXT, EDGRXEXT, EDGACTRC, EDGSAREC,EDGSDREC, EDGSKREC, EDGSOREC, and EDGSVREC.



New InformationSee Tailoring the EDGJRPT Sample JCL on page 86 for the new statement,WORKFILE, in the EDGJRPT Sample JCL.

Changed InformationThe following information was changed in this edition:v SYSALLDA devices have replaced SYSDA devices in the documentation.

xxii z/OS V1R9.0 DFSMSrmm Reporting


25/373


The following sections summarize the changes to that information.

New InformationSee EDGRPTD Report Samples on page 64 for samples of DFSMSrmm reportsthat you can create by using the DFSMSrmm EDGRPTD reporting utility.

Changed InformationThe following information was changed in this edition:v DFSORT symbols for use with DFSMSrmm have been updated. See

EDGEXTSY: Extract Data Set Symbols on page 175 and EDGSMFSY: SMFRecord Symbols on page 194.

v DFSMSrmm mapping macros have been updated. See Extract Data Set VolumeReport Record: EDGRVEXT on page 253, Extract Data Set Extended Data SetName Record: EDGRXEXT on page 259 and SMF Volume Information:EDGSVREC on page 306.



New InformationThe DFSMSrmm report generator has been enhanced to provide substringcomparison, date comparison, and customization of report output.

Changed InformationThe following information was changed in this edition:v DFSMSrmm-supplied reports display the data set expiration for data sets on

volumes.v DFSORT symbols for use with DFSMSrmm have been updated. See Appendix A,

DFSORT Symbols for Use with DFSMSrmm, on page 171 for the updatedsymbol files EDGACTSY, EDGEXTSY, and EDGSMFSY.

v DFSMSrmm mapping macros have been updated. See Appendix B, DFSMSrmmMapping Macros, on page 239 for changed mapping macros, EDGRDEXT,EDGRKEXT, EDGRSEXT, EDGRXEXT, EDGSDREC, EDGSSREC, andEDGSVREC.



Summary of Changes xxiii


26/373

New InformationThis edition includes information about the DFSMSrmm reporting sampleREPORT16 that you can use to obtain information about duplicate volumes.


DFSORT Symbols for Use with DFSMSrmm, on page 171 for the updatedsymbol files EDGEXTSY and EDGSMFSY.

v DFSMSrmm mapping macros have been updated. See Appendix B, DFSMSrmmMapping Macros, on page 239 for changed mapping macros, EDGRDEXT,EDGRKEXT, EDGRSEXT, EDGRXEXT, EDGSDREC, and EDGSVREC.



New InformationThis edition includes the following new information:v DFSMSrmm provides an ISPF-based report generator. See Chapter 2, Using the

DFSMSrmm Report Generator, on page 5 for information about how to set upthe report generator.

v DFSMSrmm supports a new extract copy of the DFSMSrmm control data set thatincludes an extended record that combines data set and volume information.

v DFSMSrmm reporting samples have been enhanced to simplify how you workwith them. See Chapter 5, Creating Reports Using DFSMSrmm-SuppliedEXECs, on page 85 for information.


DFSORT Symbols for Use with DFSMSrmm, on page 171 for the updatedsymbol files EDGEXTSY and EDGSMFSY.

v DFSMSrmm mapping macros have been updated. See Appendix B, DFSMSrmmMapping Macros, on page 239 for changed mapping macros, EDGRDEXT,EDGRKEXT, EDGRSEXT, EDGRXEXT, EDGSDREC, and EDGSVREC.

xxiv z/OS V1R9.0 DFSMSrmm Reporting


27/373

Chapter 1. Creating DFSMSrmm Reports

DFSMSrmm is a z/OS feature. You can use different ways to create DFSMSrmmreports or get DFSMSrmm information. You should select the best approach eachtime you gather your information. First, identify the kind of information you need andthe way you will read or present the information. You might find that RMM TSOsubcommands or the DFSMSrmm ISPF dialog provides the best approach.

The RMM TSO subcommands and the DFSMSrmm ISPF dialog share somesimilarities. The dialog allows you to view the information in real time and inpredefined formats. The dialog also allows you to decide dynamically which furtherdetails you want to view. You can use the RMM TSO subcommands to obtain thekind of information that you obtain when you use the DFSMSrmm ISPF dialog. Thedifference is that you cannot view the full-screen when you use the RMM TSOsubcommands. You can use the commands interactively or submit them in batch.You can save the batch job input, which allows you to reuse the commands so youcan run the job again.

Consider using the DFSMSrmm-supplied standard reports for reportingrequirements, so that you can view online or printed reports on an impromptu orregular basis. DFSMSrmm has included many standard reports that you can createusing the EDGRPTD and EDGAUD utilities or the EDGRRPTE reporting EXEC.DFSMSrmm also provides standard reports that are generated from inventorymanagement and that cover vital record specification matching and retention,run-time statistics, and control data set change activity.

Another way to produce reports is to use a sort utility like DFSORT or DFSORTsICETOOL. With DFSORT or DFSORTs ICETOOL, you can create customizedreports from the available DFSMSrmm information, such as the extract data set, theactivity file, and System Management Facility (SMF) records. Use the DFSMSrmmreport generator with utilities like DFSORTs ICETOOL to create customized reports.

You can create report definitions, save reporting jobs, and submit reporting jobsusing the DFSMSrmm report generator.

Finally, if you need to provide information from DFSMSrmm directly into anapplication or product, you can use the DFSMSrmm application programminginterface (API). You need high-level assembler knowledge and skills to implementthe API. For additional information, see z/OS DFSMSrmm Application Programming Interface .

Using the DFSMSrmm ISPF Dialog and RMM TSO SubcommandsYou can search online, using the DFSMSrmm ISPF dialog or RMM TSOsubcommands, to create lists of resources and display information recorded in theDFSMSrmm control data set. Here are some examples:v Operators can create lists of scratch volumes to be pulled for use.v Tape librarians and system programmers can create lists of software products

and the volumes on which they reside.v General users can create lists of volumes they own, such as the example in

Figure 1 on page 2:

Copyright IBM Corp. 1992, 2007 1
http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/


28/373

With the DFSMSrmm ISPF Report Generator option, you can run batch reports byselecting predefined reports or creating your own custom reports. See Chapter 2,Using the DFSMSrmm Report Generator, on page 5 for a detailed description.

With DFSMSrmm, you can use the RMM TSO SEARCH subcommands with theCLIST operand to create a data set of executable subcommands. For example, youcan create subcommands to confirm volume movement for volumes that areidentified during a SEARCHVOLUME request. See z/OS DFSMSrmm Guide and Reference for more information about the RMM SEARCHVOLUME subcommand.

Using the DFSMSrmm Inventory Management EDGHSKP UtilityDFSMSrmm provides the EDGHSKP utility to help you perform inventorymanagement. You can create reports as part of inventory management processingas described in Chapter 3, Creating Inventory Management Reports, on page 39.See z/OS DFSMSrmm Implementation and Customization Guide for informationabout DFSMSrmm inventory management processing.

Using the EDGRPTD and EDGAUD Report UtilitiesYou can create several types of standard reports by using the DFSMSrmm reportutilities EDGRPTD and EDGAUD. See Chapter 4, Creating Reports withDFSMSrmm Utilities, on page 59 for additional information. Use EDGRPTD tocreate movement, inventory, and scratch reports and EDGAUD to create security

and audit reports. EDGRPTD uses the DFSMSrmm extract data set created withEDGHSKP,PARM=RPTEXT as input. EDGAUD uses SMF records as input.

You can use the reports to perform these activities.v Identify volumes that should be moved between the removable media library and

storage locations.v Determine your volume inventory in the removable media library and storage

locations.v Identify volumes that are in transit.v Identify volumes that should be marked as moved.v Identify all accesses to volumes and changes to information recorded in the

DFSMSrmm control data set.v Separate volumes that are waiting to return to scratch from those that are private

or have other release actions pending.v Identify new scratch volumes or the entire scratch inventory.

VolumeOwner Rack Assigned Expiration S Location Dsets St Act Dest.date date R

------ -------- ------ ---------- ---------- - ------- ----- -- ----- --------VOL600AMYW01RAC50006/11/2000 11/11/2000 Y SHELF 0 URSIVOL601AMYW01RAC50106/11/2000 11/11/2000 SHELF 0 URSIVOL603AMYW01RAC50206/11/2000 11/11/2000 SHELF 0 URSIEDG3011I3 ENTRIESLISTED

Figure 1. Example of a List of Volumes Owned by a Single User

2 z/OS V1R9.0 DFSMSrmm Reporting
http://dgt2r360.pdf/http://dgt2r360.pdf/http://dgt2r360.pdf/http://dgt2r360.pdf/http://dgt2r360.pdf/http://dgt2c860.pdf/http://dgt2c860.pdf/http://dgt2c860.pdf/http://dgt2c860.pdf/http://dgt2c860.pdf/http://dgt2c860.pdf/http://dgt2c860.pdf/http://dgt2r360.pdf/http://dgt2r360.pdf/


29/373

Using the DFSMSrmm EDGRRPTE EXECDFSMSrmm provides standard reports and samples that are shipped in SAMPLIB.Use the EDGJRPT sample job control language (JCL) to run the EDGRRPTEEXEC to produce reports, using the DFSMSrmm extract data set as input. SeeChapter 5, Creating Reports Using DFSMSrmm-Supplied EXECs, on page 85 foradditional information.

Using DFSORT and the DFSORT ICETOOL UtilityYou can use DFSORT or a similar program to generate a formatted report using theDFSMSrmm extract data set, activity file, or SMF records. For example, you couldproduce a list of volumes on virtual machine (VM) with information about volumeowners. Then use DFSORTs ICETOOL utility to sort the information by volume andproduce a report, complete with title and header information. Use the DFSMSrmmISPF Report Generator to build customized reports using utilities like DFSORTsICETOOL.

You can use DFSORT symbols for fields and constants to further simplify the reportwriting process. Using symbols increases your productivity by automaticallyproviding the positions, lengths, and formats of the fields, and the values of theconstants associated with the particular records you are processing with DFSORTand DFSORTs ICETOOL. See Chapter 6, Using DFSMSrmm with DFSORT, onpage 119 for further information.

Related Reading: See Chapter 2, Using the DFSMSrmm Report Generator, onpage 5 for information about using the report generator to create customizedreports. See Chapter 6, Using DFSMSrmm with DFSORT, on page 119 forinformation about using DFSMSrmm with DFSORT.

Using the DFSMSrmm Application Programming Interface

You can use the DFSMSrmm application programming interface to obtaininformation about the resources that are defined to DFSMSrmm. See the z/OS DFSMSrmm Application Programming Interface for information about how to usethe DFSMSrmm application programming interface.

Chapter 1. Creating DFSMSrmm Reports 3
http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/http://dgt2a160.pdf/


30/373



31/373

Chapter 2. Using the DFSMSrmm Report Generator

The DFSMSrmm report generator is an Interactive System Productivity Facility(ISPF) application that you can use to create reports.v The report generator provides reports that you can run as-is or that you can

modify as you wish. You can use samples to create reports for volumes, datasets, racks, owners, and the retention and movement policies that areestablished for your installation. You can modify these samples to create tailoredreports. DFSMSrmm ships samples in SYS1.SAMPLIB. See Running a ReportGenerator Report on page 7 to run one of these reports.

v The report generator generates job control language (JCL) that is based onspecifications that you use to submit the report jobs.

To create reports with the report generator, provide any input data along with anAssembler language mapping macro to map the input data. The DFSMSrmmsamples use the DFSMSrmm extract data set, the System Management Facility(SMF) file, and the ACTIVITY file as input. DFSMSrmm mapping macros map theinput data.

The report definitions and report types specify the format and contents of reports,the input files for the reports, and the tools used to create the reports. To use ormodify a report, you work with report definitions as described in Working withReport Definitions on page 11. Create new report definitions for reports that arerequired by your users. Store the report definitions in the installation library to makethe reports available to all your users from the installation library. To create a newreport that uses input data other than the DFSMSrmm files, you work with reporttypes as described in Working with Report Types on page 21.

The report generator samples use DFSORT ICETOOL as the default tool. Thereport generator creates a DFSORT ICETOOL job that you can run in batch. SeeWorking with Reporting Tools on page 30 for information about specifying a toolfor creating reports.

You store report definitions, report types, and the reporting tools in three separatelibraries.v The product library which contains predefined report definitions, report types, and

reporting tools.v The installation library which contains any versions that your installation has

modified or created.v The user library where any new or modified versions are stored.

The DFSMSrmm report generator also uses a JCL library to save and submit theDFSMSrmm-generated report JCL to run your reports.

Define all the libraries as partitioned data sets with fixed 80 byte records. When youdo not allocate libraries, DFSMSrmm allocates the libraries automatically with aprimary and secondary space of 10 tracks and 50 directory blocks. Specify the dataset names as fully qualified names with single quotation marks or without quotationmarks and a high-level qualifier. DFSMSrmm automatically expands the data setnames to the fully qualified name including the single quotes. DFSMSrmm uses theRACF user ID as the high level qualifier for the data sets if you do not specifyNOPREFIX in the TSO profile. See Specifying Libraries for the Report Generatoron page 10 for information about setting up the libraries for the report generator.

Copyright IBM Corp. 1992, 2007 5


32/373

When you install new function APARs onto your system for the report generator andthen create or update any report types, reports, or tool definitions, you must ensurethat any other system that uses those new or updated report types, reports, or tooldefinitions also has the new function installed.

Setting up the Report Generator for Your Installation

Here are steps for setting up the report generator for your installation.1. Select the Report Options panel described in Specifying Libraries for the

Report Generator on page 10. Specify the installation library that you want touse as your user library. If you do not allocate the library, DFSMSrmmautomatically allocates the library by using a primary space and secondaryspace of 10 tracks and 50 directory blocks

2. Specify the name of the JCL library and the product library. The product libraryby default is SYS1.SAMPLIB.

3. Set up the access lists for the libraries. Provide READ authority to the users ofthe installation libraries and the product libraries.

4. Return to the Report primary panel, and select the Report Types panel. You canoptionally customize the report types shipped with DFSMSrmm and set them upfor your users as described in Working with Report Types on page 21. You canalso add new report types for data other than data that are created byDFSMSrmm. The report type contains information about a specific type ofrecord in an input data set, the Assembler language macro that defines therecord format, and basic record selection criteria. For example, the report type Extract Records for Data Sets in the product library contains information aboutthe data set record in the extract data set, the EDGRDEXT mapping macro, andthe minimum subset definition of records that are used in the report. Reporttypes contain only the base information from which report definitions arecreated.

5. Select the Report Definition panel to customize report definitions that areshipped with the product. The report definition is a report file that contains all of

the information that is needed to run a report. Each report definition in theproduct library, installation library, or user library contains the report typeinformation, reporting tool information, the data fields that are used in the report,and the sort order of the records. The report selection criteria specify the subsetof records that are used for a report. The reporting tool is a REXX EXEC thatbuilds control statements to create reports that use a reporting utility, such asDFSORTs ICETOOL. You can change the reporting tool at any time.

6. Customize the EDGRMAIN EXEC. The REXX variable names that you cancustomize all start with the characters cedggrdl. Here is the section of theEDGRMAIN EXEC that you must customize./* Initialise Report library names */ /*@09A*/address "ISPEXEC""VGETZPREFIX" /*@09A*/If length(zprefix) = 0 then /*@10C*/

edggpref = sysvar(SYSUID) /*@09A*/else /*@10C*/edggpref = zprefix /*@10C*/

cedggrdlu = ""edggpref||".REPORT.LIB" /* User Library @10C*/cedggrdlj = ""edggpref||".REPORT.JCL" /* User JCL Library @10C*/cedggrdlp = "SYS1.SAMPLIB" /* Product Library @10C*/cedggrdli = "" /* Installation Library @10A*/a. Define the installation library name and optionally customize the product

library name in EXEC EDGRMAIN. There is no installation library name inthe EXEC, so you must add the name.



33/373

b. Update the default naming convention in EXEC EDGRMAIN for the userlibrary name and the JCL library name, if necessary.

Steps for Using the Report GeneratorThe system programmer or storage administrator might have created somespecialized report definitions for your installation and placed them in the installationlibrary. You can modify the report definitions, report types, and reporting tools thatare found in the product library or the installation library. When you modify a reportdefinition, the report generator stores the modified report definitions in your userlibrary. You can create new report definitions from report types or from existingreport definitions.

These are the steps you follow to create reports by using the report generator.1. Verify the user library names and the JCL library names that are defined in the

Report Options panel. Allocate the libraries manually or automatically asdescribed in Specifying Libraries for the Report Generator on page 10.

2. Specify the product library name and the installation library name as describedin Working with Report Definitions on page 11. Obtain the names from the

person who set up the report generator for your installation.3. Select the Report Type panel to add or to change report types that are shipped

with DFSMSrmm as described in Working with Report Types on page 21.4. Select the Report Definition panel to add or to change report definitions that are

shipped with DFSMSrmm. See Working with Report Definitions on page 11 formore information.

5. Fill out the job card in the DFSMSrmm options panel6. Create the report JCL. See Running a Report Generator Report for more

information.7. Submit the report JCL.

Running a Report Generator ReportBefore you begin: Ask your system programmer or storage administrator for thename of an input data set for the report generator. You need this input data set torun your report. If you are running a DFSMSrmm-supplied report, you need an inputdata set created during the latest inventory management run. The input data setcan be a DFSMSrmm extract data set, an SMF file, or an ACTIVITY report. You canuse non-DFSMSrmm input data sets when there is a mapping of the records in theinput data set.

You can run a report that is stored in the product library by using this procedure.1. Select the REPORT option on the DFSMSrmm User Menu panel as shown in

Figure 2 on page 8. Press the ENTER key.

Chapter 2. Using the DFSMSrmm Report Generator 7


34/373

2. Type S next to the product library on the DFSMSrmm Report Definition Searchpanel shown in Figure 3. Press the ENTER key.

3. Select a report by typing G in the S column on the DFSMSrmm ReportDefinitions panel as shown in Figure 4. Press the ENTER key.

4. Specify these parameters in panel EDGPG022 as shown in Figure 5 on page 9.

Panel Help------------------------------------------------------------------------------EDGP@USR DFSMSrmmUser Menu- z/OS V1R9Option ===>R

0 OPTIONS - Specify dialog options and defaults1 VOLUME - Display list of volumes2 DATASET - Display list of data sets3 PRODUCTS- Display list of products4 OWNER - Display or change owner information5 REQUEST - Request a new volume6 RELEASE - Release an ownedvolumeR REPORT - Workwith reports

Enter selected option or ENDcommand.For more info., enter HELPor PF1.

Figure 2. Running a Report Using the DFSMSrmm User Menu Panel

Panel Help------------------------------------------------------------------------------EDGPG010 DFSMSrmmReport Definition SearchCommand===>

Report name . . Maybe generic. Leave blank for all reports.

User id . . . . Leave blank for all user ids.

Libraries (enter S): Select one or more library.User Default are all defined libraries.Installation

S Product

The following line commandswill be available when the list is displayed:A - Adda new report definition D - Delete a report definitionG - Generate and save the JCL J - Edit and manually submit the JCLN - Copy a report definition S - Display or change the report definitionT - Select a reporting tool

Figure 3. Select the Input Data Set in the Product Library Using the DFSMSrmm Report Definition Search Panel

Panel Help-------------------------------------------------------------------------------EDGPG020 DFSMSrmmReport Definitions Row1 to 2 of 2Command===> Scroll ===>PAGE

The following line commandsare valid: A,D,G,J,N,S, and T

S Name Report title Report type User id- -------- ------------------------------ ---------------------------- -------

EDGGR01Scratch tapes by volume serial Extended Extract Records D094746G SCRVOL Scratch Volume List Extract Records for Volumes D094746*******************************Bottom of data ********************************

Figure 4. Selecting a Report Using the DFSMSrmm Report Definitions Panel


|||||||||||||||||


35/373

v The input data set name is mandatory. Enter the name of the input data setfor the reporting step.

v The date format is optional. Possible date format values are: AMERICAN - dates in format MM/DD/YYYY EUROPEAN - dates in format DD/MM/YYYY ISO - dates in format YYYY/MM/DD

JULIAN - dates in format YYYY/DDD free form - The free form has a maximum length of 20 bytes and contains

DD and MM (alternatively DDD), and YY or YYYY or CYY. The C (century)is set to 1 for years after 2000. These values can contain separatorcharacters.

For dates in the year 2000 and or in the 21st century or higher, you can onlyuse the yyyy/ddd format. If you use the yyddd format, DFSMSrmm defaults tothe 20th century. DFSMSrmm uses the date format to determine a real datebased on the compare value &TODAY and the actual run date.

v Specify Y if you want to create report data rather than use an existing inputdata set. This adds an extra step in the generated JCL that creates an extractdata set. The extract step includes relevant parameters like date format andinput data set name. You can use the existing date format and input data setname. You can also change them by entering information in the SkeletonVariable_1 , Skeleton Variable_2 , and Skeleton Variable_3 fields.If you are using the &TODAY variable for dates, the date format you specifyfor Skeleton Variable_1 must match the date format specified in panelEDGPG022. If the date formats are not the same, report results can beunpredictable. Julian or ISO format of date must be used for greater thanand less than comparison of dates.

The extract step for inventory management includes the DATEFORMparameter and a name for the DFSMSrmm message data set, which then ispre-allocated by the system, unless it already exists.

5. Press the END key to create the report.6. Type J in the S column on the DFSMSrmm Report Definitions panel as shown

in Figure 6 on page 10. Press the ENTER key.

EDGPG022 DFSMSrmmReport Generation - SCRVOLCommand===>

Enter or change the skeleton variables for the generated JCL:Input data set . . . . RMM.EXTRACT

Date format . . . . . . ISO(American, European, Iso, Julian, or free form)Required if you use variable dates (&TODAY)in your selection criteria.

Create report data . . Y (Y/N)Choose Y if you want an extract step included into your generated JCL.

Additional skeleton variables, if an extract step is included:Skeleton Variable_1 . . DATEFORM(I)Skeleton Variable_2 . . D016216.RMMHSKP.MESSAGESkeleton Variable_3 . .

The skeleton selection depends on the reporting macro . . . : EDGRXEXT

Enter ENDcommandto start the report generation or CANCEL

Figure 5. Specifying the Report Generator Parameters



36/373

7. Change the DFSMSrmm-generated JCL as required and enter the SAVEcommand to save it in your JCL library.

8. Use the SUBMIT command to submit the job for batch processing.

Specifying Libraries for the Report GeneratorFollow these steps to specify the product library, installation library, or user library tobe used with the report generator.1. Select the OPTIONS option on the DFSMSrmm User Menu panel, as shown in

Figure 7. Press the ENTER key.

2. Select Option 3 on the DFSMSrmm Dialog Options Menu panel as shown inFigure 8 on page 11.

Panel Help-------------------------------------------------------------------------------EDGPG020 DFSMSrmmReport Definitions Row1 to 2 of 2Command===> Scroll ===>PAGE



EDGGR01Scratch tapes by volume serial Extended Extract Records D094746J SCRVOL Scratch Volume List Extract Records for Volumes D094746*******************************Bottom of data ********************************

Figure 6. Running Your Report Using the DFSMSrmm Report Definitions Panel

Panel Help------------------------------------------------------------------------------EDGP@USR DFSMSrmmUser MenuOption ===>0

0 OPTIONS - Specify dialog options and defaults1 VOLUME - Display list of volumes2 DATASET - Display list of data sets3 PRODUCTS- Display list of products4 OWNER - Display or change owner information5 REQUEST - Request a newvolume6 RELEASE - Release an ownedvolumeR REPORT - Workwith reports


Figure 7. Selecting the Options Option on the DFSMSrmm User Menu Panel



37/373

3. Review the library names on the DFSMSrmm Report Options panel, as shownin Figure 9. This panel shows the three libraries that you use to create reportsand the JCL library where your JCL is stored. DFSMSrmm initializes the defaultuser library name and JCL library name with your user ID and a defaultsecond-level qualifier. Your system programmer or storage administrator sets upthe names for the product library and the installation library when theDFSMSrmm report generator is installed. You can change the product libraryname, installation library name, and the user library name. If you add any

members to the product library, use member names that start with the EDGGprefix. Use the END command to save your changes.

Working with Report DefinitionsYou use report definitions to create reports with the report generator.1. Select the REPORT option on the DFSMSrmm User Menu panel. Press the

ENTER key.2. Type S next to the libraries that you want to search on the DFSMSrmm Report

Definition Search panel. Press the ENTER key. You can search for a reportdefinition by name or by user ID. If you select more than one library and pressthe ENTER key, DFSMSrmm searches the libraries starting with the user library,the installation library, and then the product library. If DFSMSrmm finds duplicatereport definition names, DFSMSrmm ignores all subsequent report definitions inthe DFSMSrmm report definition list.

Panel Help------------------------------------------------------------------------------EDGP@OPT DFSMSrmmDialog Options MenuOption ===>3

1 USER - Specify processing options2 SORT - Specify list sort options3 REPORT - Specify report options


Figure 8. Selecting the Options Option on the DFSMSrmm Dialog Options Menu Panel

Panel Help-----------------------------------------------------------------------------EDGP@OP3 DFSMSrmmReport OptionsCommand===>

Report definition libraries:User . . . . . . . . . . D094746.REPORT.LIBInstallation . . . . . .Product . . . . . . . . SYS1.SAMPLIB

User report JCL library . D094746.REPORT.JCL

DFSMSrmmallocates user libraries if they do not exist.

Figure 9. Specifying Library Names on the DFSMSrmm Report Options Panel



38/373

3. Enter a line command in the S column on the DFSMSrmm Report Definitionspanel, as shown in Figure 10 to perform one of these actions.

A Add a report definition to your user library. See Adding a ReportDefinition on page 13.

D Delete a report definition from your user library. See Deleting a ReportDefinition on page 20. If you delete a report definition that resides in

the installation library or product library, the report definition is onlyremoved from the report definition list, not from the library itself.

G Generate and save the JCL to run the report. See Running a ReportGenerator Report on page 7.

J Edit and submit the report definition for batch processing. See Runninga Report Generator Report on page 7.

N Create a new report definition that uses an existing one. See Modifyingan Existing Report Definition on page 19.

S Display or change a report definition. To change a report definition, seeChanging a Report Definition on page 16. If you change a reportdefinition that resides in the installation library or product library,DFSMSrmm stores the changed report definition in your user library, notthe installation library or product library.

T Select the reporting tool that you want to use for your report. SeeWorking with Reporting Tools on page 30. If you change a reportdefinition that resides in the installation library or product library,DFSMSrmm stores the changed report definition in your user library, notthe installation library or product library.

Panel Help------------------------------------------------------------------------------EDGPG020 DFSMSrmmReport Definitions Row1 to 17 of 17

Command===> Scroll ===>PAGEThe following line commandsare valid: A,D,G,J,N,S, and T


EDGGAUD1SMFAudit of Volumes by Volser SMFRecords for Volumes RMMEDGGAUD2SMFAudit of Volume by Rack SMFRecords for Volumes RMMEDGGR01Scratch tapes by volume serial Extended Extract Records D094746EDGGR02List of SCRATCHVolumes by Dat Extended Extract Records RMMEDGGR03Inventory List by Volume Seria Extended Extract Records RMMEDGGR04Inventory List by Dataset NameExtended Extract Records RMMEDGGR06Inventory of Volumes by Locati Extended Extract Records RMMEDGGR07Inventory of Dataset by Locati Extended Extract Records RMMEDGGR08Inventory of Bin by Location Extended Extract Records RMMEDGGR09Datasets in Loan Location Extended Extract Records RMMEDGGR10Volumes in Loan Location Extended Extract Records RMM

EDGGR11List MultiVolumeand MultiFile Extended Extract Records RMMEDGGR12MovementReport by Dataset Extended Extract Records RMMEDGGR13MovementReport by Bin Extended Extract Records RMMEDGGR14MovementReport by Volume Seri Extended Extract Records RMMEDGGR15Volume Inventory Including Vol Extended Extract Records RMMEDGGSEC1Report of Accesses to Secure V SMFSecurity Records RMM

*******************************Bottom of data ********************************

Figure 10. Selecting a Report Definition Using the DFSMSrmm Report Definitions Panel



39/373

Adding a Report DefinitionTo add a new report definition, you can modify an existing report definition or youcan create a new report definition. To use an existing report definition, seeModifying an Existing Report Definition on page 19. To add a new report definitionto your library, follow this procedure.1. Type A in the S column for any report on the DFSMSrmm Report Definitions

panel as shown in Figure 11. Press the ENTER key.

2. Enter a one to eight character report name on the popup window thatDFSMSrmm displays as shown in Figure 12. Press the ENTER key.

3. Type S in the S column on the Select Report Type panel shown in Figure 13 onpage 14 to select the report type you want to use for the new report. Press theENTER key.

Panel Help------------------------------------------------------------------------------EDGPG020 DFSMSrmmReport Definitions Row1 to 16 of 16Command===> Scroll ===>PAGE



EDGGAUD1SMFAudit of Volumes by Volser SMFRecords for Volumes RMMEDGGAUD2SMFAudit of Volume by Rack SMFRecords for Volumes RMM

A EDGGR02List of SCRATCHVolumesby Dat Extended Extract Records RMMEDGGR03Inventory List by Volume Seria Extended Extract Records RMMEDGGR04Inventory List by Dataset NameExtended Extract Records RMMEDGGR06Inventory of Volumes by Locati Extended Extract Records RMMEDGGR07Inventory of Dataset by Locati Extended Extract Records RMMEDGGR08Inventory of Bin by Location Extended Extract Records RMMEDGGR09Datasets in Loan Location Extended Extract Records RMMEDGGR10Volumes in Loan Location Extended Extract Records RMMEDGGR11List MultiVolume and MultiFile Extended Extract Records RMMEDGGR12MovementReport by Dataset Extended Extract Records RMMEDGGR13MovementReport by Bin Extended Extract Records RMMEDGGR14MovementReport by Volume Seri Extended Extract Records RMMEDGGR15VolumeInventory Including Vol Extended Extract Records RMMEDGGSEC1Report of Accesses to Secure V SMFSecurity Records RMM

*******************************Bottom of data ********************************

Figure 11. Adding a Report Definition Using the DFSMSrmm Report Definitions Panel

EDGPG021

Enter the report name . . . . SCRVOL

Figure 12. Adding a Report Definition and Specifying a Report Name



40/373

4. Type S in the S column on the Select Reporting Tool panel as shown in

Figure 14 to select the reporting tool that you want to use for the new report.Press the ENTER key.

5. Select the fields that you want in your report by typing a number in the CO

column. Begin with the number 1 on the DFSMSrmm Report Definition panel, asshown in Figure 15 on page 15.

Panel Help

----------------------------------------------------------EDGPG030 Select Report Type Row1 to 12 of 17Command===> Scroll ===>PAGE

S Report type Name- ------------------------------ --------

Extended Extract Records EDGRXEXTExtract Records for Bins EDGRSEXTExtract Records for Data Sets EDGRDEXTExtract Records for Owners EDGROEXTExtract Records for Products EDGRPEXTExtract Records for Racks EDGRREXT

S Extract Records for Volumes EDGRVEXTExtract Records for VRSs EDGRKEXTHSKPACTIVITYfile records EDGACTRCSMFRecords for Bins EDGSSRECSMFRecords for Data Sets EDGSDRECSMFRecords for Owners EDGSOREC

Figure 13. Adding a Report Definition Using the Select Report Type Panel

Panel Help-------------------------------------------------------------------------------EDGPG300 DFSMSrmmReporting Tools Row1 to 2 of 2Command===> Scroll ===>PAGE

The following line commandsare valid: A,C, and D

S Reporting tool Exec Skeleton Colspace Group sort- ------------------------------ -------- -------- -------- ----------A ICETOOL EDGRGGENEDGSGICE 3 U

SYNCTOOL EDGRGGENEDGSGSYN 3 U*******************************Bottom of data ********************************

Figure 14. Adding a Report Definition Using the Select Reporting Tool Panel



41/373

Type S in the S column on one or more fields to select a subset of input recordsfor your report and press the ENTER key. (An asterisk in the S column indicatesthat the field is already used as a record selection criteria.)

6. Enter the record selection criteria on the DFSMSrmm Report Criteria panel, asshown in Figure 16 on page 16, to select a subset of the input records for yourreport. DFSMSrmm only includes the records that meet the criteria that youspecify as input to your report. Use the Op (Operator) column to specify thelogical operator that you want to use for comparing the field contents with thevalues in the Compare value(s) column. Use the Compare value(s) column tospecify the values that you want to compare. Type the exact value that youwant to compare because the comparisons are case-sensitive. If you enter morethan 40 characters, use the I line command in the S column to add more valueson the DFSMSrmm Report Criteria panel, as shown in Figure 16 on page 16. Ifyou want to use the same field for a second criteria, press the END key afteryou have specified all compare values and select the field name again.DFSMSrmm displays the existing criteria and the field you selected. Press thePF1 key with the cursor on any input field to display a help panel that describesthe field and the values that you can use.

Panel Help------------------------------------------------------------------------------EDGPG050 DFSMSrmmReport Definition - SCRVOL Row1 to 18 of 115Command===> Scroll ===>PAGE

Report title . . . Scratch Volume ListReport footer . . IBMInternalReporting tool . : ICETOOL Report width: 187

Use ENDto save changes or CANCELSelect a field name with S to specify a field selection criterion

S COSO Field name Columnheader text CW Len Typ- -- --- -------------------- ------------------------------------ --- --- ---S G 1ARVLCDATE LASTCHANGEDATEof volume recor 32 10 C

1 RVVOLSER VOLUMESERIALNUMBER 20 6 C2 RVLCTIME LASTCHANGETIMEHHMMSSof 26 6 C3 RVEXPDTO EXPIRATIONDATE - original 27 10 C

S 4 RVEXPDT EXPIRATIONDATE - current 26 10 C5 RVLCUID LASTCHANGEUSERID of volume 29 8 C6 RVDSNAM1 FIRSTFILE DATASETNAME 44 44 C

S RVTYPE RECORDTYPE- CV 18 1 CRVPVOL PREVIOUSVOLUMEIN SEQUENCE 27 6 CRVNVOL NEXTVOLUMEIN SEQUENCE 23 6 CRVMDMVID MULTI-DSETMULT-VOLID 22 8 CRVCRDATE CREATEDATEof volume record 28 10 CRVCRTIME CREATETIMEHHMMSSof volume rec 32 6 CRVCRSID CREATESYSTEMID of volume recor 32 8 CRVLCSID LASTCHANGESYSTEMID of volume 31 8 CRVDEN RECORDINGDENSITY 17 4 CRVCOMP COMPACTIONUSED- Y/N 21 1 CRVDSNNO NUMBEROFDATASETSONVOLUME 28 4 C

Figure 15. Adding a Report Definition Using the DFSMSrmm Report Definition Panel



42/373

7. Figure 17 shows the values you have specified.

Add, change, or delete any of the values on this panel. Press the ENTER key todisplay your changes on the DFSMSrmm Report Criteria panel, as shown inFigure 16.

8. Press the END key on the DFSMSrmm Report Criteria panel, as shown inFigure 16, to save the report criteria and return to the DFSMSrmm ReportDefinitions panel that was shown in Figure 11 on page 13.

Related Reading:v

See Working with Reporting Tools on page 30.v See Running a Report Generator Report on page 7.

Changing a Report DefinitionTo change a report definition and save it in your user library, follow this procedure.1. Type S in the S column on the DFSMSrmm Report Definitions panel as shown

in Figure 18 on page 17. Press the ENTER key. If you change a reportdefinition, that resides in the product library or installation library, DFSMSrmmadds the changed report definition to your user library.

Panel Help------------------------------------------------------------------------------EDGPG060 DFSMSrmmReport Criteria - SCRVOL Row1 to 3 of 3Command===> Scroll ===>PAGE

Report title : Scratch Volume List

Use ENDto save changes or CANCELThe following line commandsare valid: B,D,N,P,R,T, and I (for details)Comparison operators: EQ=, NE, GT>, GE>=, LT


43/373

2. Select the fields that you want in your report by typing a number in the COcolumn. Begin with the number 1 on the DFSMSrmm Report Definition panel, asshown in Figure 19 on page 18. The fields are o

zos v1r9.0 dfsmsrmm reporting

Documents