DFSMSdfp Storage Administration Reference

Transcription

1 z/os DFSMSdfp Storage Administration Reference SC

2

3 z/os DFSMSdfp Storage Administration Reference SC

4 Note Before using this information and the product it supports, be sure to read the general information under Notices on page 421. Third Edition, March 2004 This edition applies to Version 1 Release 5 of z/os (5694-A01) and to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces SC IBM welcomes your comments. A form for readers comments may be proided at the back of this publication, or you may address your comments to the following address: International Business Machines Corporation Department 55JA, Mail Station P South Road Poughkeepsie, NY United States of America FAX (United States & Canada): FAX (Other Countries): Your International Access Code IBMLink (United States customers only): IBMUSM10(MHVRCFS) Internet mhrcfs@us.ibm.com World Wide Web: 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: Title and order number of this document Page number or topic related to your comment When you send information to IBM, you grant IBM a nonexclusie right to use or distribute the information in any way it beliees appropriate without incurring any obligation to you. Copyright International Business Machines Corporation 1986, All rights resered. US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Figures xi Tables x About This Document xii Required product knowledge xii Referenced documents xii Accessing z/os DFSMS documents on the Internet xix Using LookAt to look up message explanations xix Accessing z/os licensed documents on the Internet xix Notational Conentions xx Summary of Changes xxiii Summary of Changes for SC z/os Version 1 Release xxiii New Information xxiii Deleted Information xxiii Chapter 1. Introducing the Storage Management Subsystem Understanding the Storage Management Subsystem Using the Interactie Storage Management Facility Defining your Storage Management Policy Preparing for the Storage Management Subsystem Running SMS in a Parallel Sysplex Enironment Basic Terms and Definitions The Concept of System Grouping Running SMS on Mixed DFSMS Releases Chapter 2. Preparing for the Storage Management Subsystem Allocating Control Data Sets Calculating the Size of Storage and Actie Control Data Sets Calculating the Size of a COMMDS Selecting Volumes for Control Data Sets Allocating an SCDS Allocating an ACDS Allocating a COMMDS Modifying the SYS1.PARMLIB Data Set Starting the SMS Address Space Accessing the Storage Administrator Primary Option Menu Planning for VSAM Record-Leel Sharing Chapter 3. Creating the Base Configuration Planning the Base Configuration Defining the Base Configuration Specifying the Default Management Class Specifying the Default Unit Specifying the Default Deice Geometry Specifying the DS Separation Profile Specifying Systems and System Groups in the SMS Complex Defining the Base Configuration for VSAM Record-Leel Sharing Using Cache Structures Defining Cache Sets Completing the Base Configuration Copyright IBM Corp. 1986, 2004 iii

6 Chapter 4. Defining Storage Groups Understanding Storage Groups DASD Storage Groups DASD Volume Status for Data Sets Object and Object Backup Storage Groups OAM Collection Names Tape Storage Groups Planning Storage Groups for Data Sets Planning Storage Groups for OAM Object Collections Defining Storage Group Attributes Defining a VIO Storage Group Defining a Pool Storage Group Assigning DASD Storage Groups to Data Sets Defining a Dummy Storage Group Defining a Copy Pool Backup Storage Group Defining an Object Storage Group Defining the Object Backup Storage Groups Defining Object or Object Backup Storage Group Status Assigning an OAM Object Collection to a Storage Group Defining a Tape Storage Group Defining Tape Storage Group Status Defining Additional Storage Groups Listing Volumes in a Storage Group Chapter 5. Defining Management Classes Understanding Management Classes Default Management Class OAM Management Classes Describing Management Classes Planning Management Classes Defining Management Class Attributes Defining Management Class Expiration Attributes Defining Management Class Migration Attributes Defining Management Class Backup Attributes Defining Object Class Transistion Attributes Defining Aggregate Backup Attributes Assigning Management Classes Defining Additional Management Classes Chapter 6. Defining Storage Classes Understanding Storage Classes Storage Classes for Data Sets Storage Classes for Objects Planning Storage Classes Defining Storage Class Attributes Defining Performance Objecties Defining Aailability Defining Accessibility Defining the Guaranteed Space Attribute Defining Guaranteed Synchronous Write Defining Use of the Coupling Facility for VSAM Record-Leel Sharing Assigning Storage Classes Defining Additional Storage Classes SMS Volume Selection for Data Set Allocation Conentional Volume Selection Striping Volume Selection i z/os V1R5.0 DFSMSdfp Storage Administration Reference

7 Possible Reasons for Volume Selection Failure Chapter 7. Defining Data Classes Understanding Data Classes Planning Data Classes Defining Data Class Attributes Defining Record and Space Attributes for Data Class Defining Volume and Data Set Attributes for Data Class Specifying Attributes to Handle Space Constraints During Allocation Defining VSAM Attributes and Specifying Media Types for Data Class Defining Shareoptions and RLS Attributes for Data Class Specifying Attributes for Data Set Reuse and Loading Specifying Attributes for Backup-While-Open (BWO) and Recoery Assigning Data Classes Specifying Data Classes outside ACS Routines Processing Data Class Attributes in JCL Defining Additional Data Classes Chapter 8. Defining Aggregate Groups Understanding Aggregate Groups Planning Aggregate Groups Defining Aggregate Groups Defining Aggregate Group Attributes Editing Aggregate Group Attributes Backing up and Recoering an Aggregate Group Defining Additional Aggregate Groups Chapter 9. Defining Copy Pools Planning a Copy Pool Defining a Copy Pool Steps for Defining a Copy Pool Defining a Copy Pool Backup Storage Group Chapter 10. Defining ACS Routines Understanding ACS Routines Using ACS Routines for Data Sets Created by z/os Network File System and Distributed FileManager/MVS Restrictions on Using ACS Routines Creating ACS Routines Translating ACS Routines Browsing the Results of a Translation BROWSING the Results of an Unsuccessful Translation Validating ACS Routines or an Entire SCDS Validating an ACS Routine Validating an Entire SCDS Translating and Validating in a Sysplex Enironment Testing ACS Routines ACS Test Usage Creating ACS Test Cases Running ACS Test Cases ACS Routines Inoked for Copying and Importing Data Sets ACS Routines Inoked for Restoring, Recalling, Recoering, and Conerting Data Sets ACS Routine Enironments JCL DD Statement (Batch), and Dynamic Allocation Volume Reference Contents

8 Data Set Stacking Non-Data Set Stacking Allocations Tape Management System Support Access Method Serices DFSMShsm DFSMSdss DFSMSrmm ISMF OAM Processing of SMS Classes and Storage Groups Displaying ACS Object Information Deleting an ACS Object from an SCDS Chapter 11. Actiating Storage Management Subsystem Configurations 171 Manually Actiating the First Storage Management Subsystem Configuration 171 Step One: IPL Each System in the SMS Complex Step Two: Prepare One System Step Three: Actiate the Configuration from One System Step Four: Actiate SMS on the Other Systems Automatically Actiating a Storage Management Subsystem Configuration 172 Displaying storage management subsystem information Controlling DFSMSts processing Monitoring application programs that use DFSMSts Changing DFSMSts status Changing Storage Management Subsystem Parameters Parameters of the SETSMS Operator Command Considerations when changing Storage Management Subsystem Configurations OAM Considerations when Changing SCDSs Chapter 12. Maintaining the Storage Management Subsystem Displaying SMS and OAM Information Displaying Information about the Actie Configuration Displaying SMS TRACE Information Displaying Storage Group Status Using the DISPLAY SMS Command 179 Displaying OAM Status in a Parallel Sysplex Displaying the Caching Statistics Displaying Storage Group Status Using ISMF Displaying Volume Status Using ISMF Displaying Volumes Using the DISPLAY SMS Command Displaying the Deice Status Listing SMS Classes, Aggregate Groups, Storage Groups, and Libraries Using ISMF Listing with View and Sort Listing Data Classes Listing Storage Groups, Management Classes, Storage Classes, Aggregate Groups, Libraries and Dries Altering Data Set Associations Altering SMS components Altering Storage Groups Redefining Volumes Among Storage Groups Altering Management Classes Altering Storage Classes Altering Data Classes Altering Copy Pools Altering Aggregate Groups i z/os V1R5.0 DFSMSdfp Storage Administration Reference

9 Altering the SCDS on Different DFSMS Releases Copying SMS Components Deleting DASD Volumes from the System Deleting DASD Volumes from Storage Groups Deleting Storage Groups Deleting or Moing System-Managed Data Sets from the Storage Group 208 Preenting Job Failures Deleting SMS Classes Conerting Volumes to SMS Chapter 13. Recoering Storage Management Subsystem Information 213 Recoering Control Data Sets Recoering an SCDS Recoering an ACDS Recoering a COMMDS Recoering from a Systems Failure in the SMS Complex Recoering the SMS Address Space Canceling the SMS Address Space Chapter 14. Protecting the Storage Management Subsystem Identifying the Resource Owner and Extracting the Default Classes Protecting ISMF Functions Locating Module Names for ISMF Applications Locating Module Names for ISMF Functions Locating Module Names for Line Operators and Commands Protecting Modules Storage Administration (STGADMIN) Profiles in the FACILITY Class Command and Keyword Related Profiles Authority to Actiate a Storage Management Subsystem Configuration 230 Storage Administrator FACILITY Class Profiles for DFSMSdss FIELD Resource Class How Authorization and Protection of Classes Differ Authorizing the Storage and Management Classes Protecting the Control Data Sets Authorizing for TSO/E and ISPF Storage Administrator Authorization Chapter 15. Administering VSAM Record-Leel Sharing Preparing for VSAM Record-Leel Sharing Determining Hardware Requirements Understanding the Product Enironment for VSAM RLS Determining Applications That Can Use VSAM RLS Ensuring Same Systems Connectiity Planning for Aailability Defining Sharing Control Data Sets Defining CF Cache Structures Defining the CF Lock Structure Modifying the SYS1.PARMLIB IGDSMSxx Member Establishing Authorization for VSAM RLS Using dsstimeout Defining CF Cache Structures in the SMS Base Configuration Defining Storage Classes for VSAM RLS Defining VSAM RLS Attributes in Data Classes Actiating VSAM RLS Enabling VSAM RLS Processing Enabling a Data Set for VSAM RLS Processing Contents ii

10 Monitoring the Coupling Facility for VSAM RLS Displaying CF Information Changing the Size of Coupling Facility Cache Structures Changing the Size of Coupling Facility Lock Structures Changing IGDSMSxx Parameters to Support the Coupling Facility Changing the State of Coupling Facility Cache Structures and Volumes 259 Selecting Data Sets for Coupling Facility Statistical Monitoring Recoering VSAM RLS Processing Recoering the CF Lock Structure Recoering a CF Cache Structure Recoering the SMSVSAM Serer Address Space Recoering a Shared Control Data Set Falling Back from VSAM RLS Processing Fallback Rules and Considerations Fallback Procedure Chapter 16. Writing ACS Routines Constants Simple Mask Rules Simple Mask Examples Data Set Mask Rules Data Set Mask Examples Read-Write Variables Using Read-Write Variables with Volume Reference (VOL=REF) Using Read-Write Variables with Data Set Stacking Read-Only Variables Using Read-Only Variables Constraints When Using Read-Only Variables Comparison Operators Comparison Rules Boolean Expressions Special Functions Determining Distributed FileManager/MVS Data Set Creation Requests 282 Statements PROC Statement FILTLIST Statement SET Statement DO Statement IF Statement SELECT Statement EXIT Statement WRITE Statement END Statement Sample ACS Routine Appendix A. Quick Reference to ISMF Commands and Line Operators 295 Appendix B. SETCACHE Functions and Deice Information Maintaining the Media Characteristics of a Volume Modifying DASD Storage Control Characteristics Modifying Caching Characteristics Modifying Duplexing Characteristics Modifying Destaging Characteristics Submitting Jobs Proiding Remote Authorization Codes iii z/os V1R5.0 DFSMSdfp Storage Administration Reference

11 Appendix C. Space Utilization and Capacity Planning Using the Data Collection Application Appendix D. Using Data Set Separation Oeriew Syntax for Creating a Data Set Separation Profile Steps for Creating a Data Set Separation Profile Creating Multiple Data Set Separation Profiles Using Data Set Separation with Generation Data Groups and Striping Enironmental Conditions Affecting Data Set Separation Factors Affecting Code Path Length Appendix E. Using NaiQuest How to Start NaiQuest Terminology Methods for Collecting Test Data ISMF Lists DCOLLECT Data SMF Data VMA Data Data Classification Methodology Testing ACS Routines Setting Up the Test Enironment Testing Procedures NaiQuest Testing Scenario Performing Storage Administration Tasks in Batch How to Run Storage Administration Tasks in Batch Sample JCL for Batch NaiQuest CLISTS and REXX EXECS Storage Group Volume Add/Delete: ACBQBAI ACS Routine Translate: ACBQBAO SCDS Validation: ACBQBAO Test ACS Routines: ACBQBAIA Generate Test Cases from ISMF-saed Data Set Lists: ACBQBAG Generate Test Cases from DCOLLECT Data: ACBQBAG Generate Test Cases from SMF Data Generate Test Cases from VMA Extract Data: ACBQBAO ACS Test Listings Comparison: ACBQBAC Enhanced ACS Test Listing: ACBQBAX Update Test Cases with Expected Results: ACBQBAU Generate Report from ISMF-saed Data Set List: ACBQBAR Generate Report from ISMF-saed DASD Volume List: ACBQVAR Generate Report from ISMF-Saed Tape List: ACBQBAR Generate Data Set Report from DCOLLECT Data: ACBQBAR Generate Model Commands from ISMF-saed List: ACBQBAM Creating DFSMS Online Reports Creating Data Set Reports from Saed ISMF Lists Creating Volume Reports from Saed ISMF Lists Creating Customized Tape Reports from Saed ISMF Lists Data Set Report from DCOLLECT Data DASD Volume Report from DCOLLECT Data SMS Configuration Report from DCOLLECT Data Additional Storage Administration Functions QSAVE and QRETRIEV Commands: Saing and Retrieing ISMF Selection Criteria Creating Model Commands Contents ix

12 COPYFILT Macro: COPYLIB Facility for FILTLISTs Appendix F. Accessibility Using assistie technologies Keyboard naigation of the user interface z/os Information Notices Programming interface information Trademarks Glossary Index x z/os V1R5.0 DFSMSdfp Storage Administration Reference

13 Figures 1. ISMF Primary Option Menu for Storage Administrators Actiating an SMS Configuration System Grouping Concept Relationship among SCDSs and ACDSs in an Installation CDS Application Selection SCDS Base Define panel SCDS Base Define panel CDS Application Selection for VSAM RLS Cache Set Update Panel for VSAM RLS Formula for Deriing Optimum Number of Stripes Defining a Storage Group Defining VIO Storage Group Attributes Defining Pool Storage Group Attributes Defining Pool Storage Group System Status Defining Volume System Status Defining Dummy Storage Group Attributes Defining Dummy Storage Group Volume Serial Numbers Defining Copy Pool Backup Storage Group Attributes Defining Object Storage Group Attributes Defining Object Backup Storage Group Attributes Defining Object or Object Backup Storage Group System Status Defining Tape Storage Group Attributes Defining Tape Storage Group System Status Management Class Application Selection Panel for Storage Administrators, Page 1 of Management Class Application Selection Panel for Storage Administrators, Page 2 of Defining Management Class Expiration Attributes Defining Management Class Migration Attributes Defining Management Class Backup Attributes Defining Object Class Transition Attributes Defining Aggregate Backup Attributes Defining a Storage Class Defining Storage Class Attributes, Page 1 of MSR Capabilities Allocation of Primary and Secondary Space for Multiolume Data Sets Defining Storage Class Attributes, Page 2 of Example of Ealuation Process for Volume Selection Defining a Data Class Defining Data Class Record and Space Attributes Defining Data Class Volume and Data Set Attributes Defining Data Class Shareoptions and RLS Attributes Aggregate Group Application Selection Aggregate Group Define, Page 1 of Aggregate Group Define, Page 2 of Editing an Aggregate Group Selection Data Set- Example Pool Storage Groups and Copy Pool Backup Storage Groups Copy Pool Application Selection Define Panel, Page 1 of Copy Pool Define, Page 2 of Writing an ACS Routine Inoking the ISPF/PDF Editor Translating an ACS Routine Browsing the Results of an ACS Translation Generating an ACS Translation Listing Copyright IBM Corp. 1986, 2004 xi

14 54. Browsing the Results of an Unsuccessful ACS Translation Validating an ACS Routine Browsing the Results of an ACS Routine Validation Validating an SCDS ACS Test Case Selection panel Creating ACS Test Cases, Page 1 of Creating ACS Test Cases, Page 2 of Creating ACS Test Cases, Page 3 of Creating ACS Test Cases, Page 4 of Testing an ACS Routine Results of Testing an ACS Routine Example of REF=ST Values when Using VOL=REF Example of REF=NS Values when Using VOL=REF Example of Failing VOL=REF Values That Are Not Valid Example of a Storage Class ACS Routine for Read-Only Variables Example of a Storage Group ACS Routine for Read-Only Variables Example of a Storage Class ACS Routine Specifying Both Volume Reference and Unit Affinity Displaying ACS Object Information Deleting ACS Objects Displaying Information about the Actie Configuration Displaying Trace Information DISPLAY SMS,STORGRP Command Syntax Displaying Storage Group Status Information Displaying Storage Group Volume Status Information Displaying Cache and DASD Fast Write Information Displaying Storage Group Status for Each System/System Group Displaying the SMS Volume Status Displaying Status Information for Indiidual DASD Volumes DEVSERV S,430 Output DEVSERV QPAVS Display Content DS QP,D123,3 Output DS QP,D2FF,VOLUME Output DS QP,D222,VOLUME Output DS QP,D6FF,UNBOX Output DS QP,D5EF,UCB Output DS QP,SSID=1401 Output DS QP,D345 Output DS QP,D621 Output DS QP,D6F4 Output DS QP,F60 Output DS P,A000 Output DS QD,D407,RDC Output Specifying Data Class View Criteria, Page 1 of Specifying Data Class View Criteria, Page 2 of Specifying Data Class View Criteria, Page 3 of Specifying Data Class Sort Criteria, Page 1 of Specifying Data Class Sort Criteria, Page 2 of Specifying Data Class Sort Criteria, Page 3 of Displaying a List of Data Classes Moing a Volume from One Storage Group to Another Altering a Management Class Altering a Storage Class, Page 1 of Altering a Storage Class, Page 2 of Copy Pool Alter panel Aggregate Group Alter, Page 1 of Aggregate Group Alter, Page 2 of xii z/os V1R5.0 DFSMSdfp Storage Administration Reference

15 110. Copy Entry Panel Confirm Delete Request Panel Example of Global Connectiity in a Parallel Sysplex Example of Insufficient Connectiity in a Parallel Sysplex Example for Creating Sharing Control Data Sets Using IDCAMS CDS (Control Data Set) Application Selection for VSAM RLS Coupling Facility Cache Set Definition for VSAM RLS Example of CF Cache Structure Definition in Base Configuration Defining a Storage Class for VSAM RLS Defining Storage Class Attributes for VSAM RLS Example of Constraints when Using the &ALLVOL and &ANYVOL Read-Only Variables Example Showing &JOB Read-Only Variable Example Showing &PGM Read-Only Variable Example Showing &USER Read-Only Variable Example of a FILTLIST Statement Using the INCLUDE and EXCLUDE Example of a DO Statement Examples of IF Statements Example of a SELECT Statement Example of an EXIT Statement Example of an END Statement Production ACS Routine for Storage Class Entry Panel for the Data Collection Application, Page 1 of Entry Panel for the Data Collection Application, Page 2 of Entry Panel for the Data Collection Application, Page 3 of ISMF Primary Option Menu for Storage Administrators NaiQuest Primary Option Menu Typical Data Types TSO Data Type with Data Subtypes Test Case Generation Selection Menu Test Case Generation from Saed ISMF List Entry Panel Test Case Generation from DCOLLECT Data Entry Panel Test Case Generation from SMF Data Entry Panel Test Case Generation from VMA Extract Data Entry Panel NaiQuest Primary Option Menu ACS Test Listings Comparison Entry Panel Enhanced ACS Test Listing Entry Panel Test Case Update with Test Results Entry Panel Testing Example Flowchart Batch Testing/Configuration Management Selection Menu SYS1.SACBCNTL member ACBJBAOB JCL for Batch Functions Sample JCL for ACBJBAI Sample JCL for ACBJBAI Sample JCL for ACBJBAIA Sample JCL for ACBJBAJ Sample JCL for ACBJBAIB Sample JCL for ACBJBAC Sample JCL for ACBJBAOS Sample JCL for ACBJBAIC Sample JCL for ACBJBAG Sample JCL for ACBJBAG Sample JCL for ACBJBAI Sample JCL for ACBJBAOW Sample JCL for ACBJBAC Sample JCL for ACBJBAX Sample JCL for ACBJBAU Figures xiii

16 166. Sample JCL for ACBJBAOD Sample JCL for ACBJBAOF Sample JCL for ACBJBAOT Sample JCL for ACBJBARD Sample JCL for ACBJBAM NaiQuest Primary Option Menu SMS Report Generation Selection Menu Data Set Report from Saed ISMF List Entry Panel DASD Volume Report from Saed ISMF List Entry Panel Tape Volume Report from Saed ISMF List Entry Panel Data Set Report from DCOLLECT Data Entry Panel DASD Volume Report from DCOLLECT Data Entry Panel SMS Configuration Report from DCOLLECT Data Entry Panel Data Set Selection Entry Panel Model Commands Generation Selection Menu Model Commands Generation from Saed ISMF List Entry Panel Model Commands Generation from DCOLLECT Data Entry Panel Copy FILTLISTs Entry Panel xi z/os V1R5.0 DFSMSdfp Storage Administration Reference

17 Tables 1. Volumes Listed in a Specified Storage Group Comparing Retention Period Attributes D/T3990 SMS Cache Candidate Tokens for Sequential and Direct Requests Combinations for Requesting Point-in-Time Copy Deices Volume Selection Preferences Applying Data Class Attributes to Record Organization (Recorg) Results of Output Listing Disposition Allocation, IMPORT, and COPY Conditions RESTORE, RECALL, RECOVER, CONVERTV, and FORCENONSMS Conditions Values for &UNIT ACS Read-Only Variable AFFing DD Volser Values DFSMSrmm Read-Only Variables Module Names for ISMF Applications Module Names for ISMF Functions Module/CLIST Names for ISMF Line Operators, Part Module/CLIST Names for ISMF Line Operators, Part Module/CLIST Names for ISMF Line Operators, Part Module/CLIST Names for ISMF Commands Effect of MAXSYSTEM Value on Lock Table Entry Size CF Lock Structure Sizing Examples Using Read-Write Variables in ACS Routines Read-Only Variables Indexing Functions for Read-Only Variables Read-Write Variable Assignments ISMF Commands ISMF Line Operators SYS1.SACBCNTL Sample JCL Library Member List CLISTs and REXX EXECs for Storage Administration Tasks Using ACBQBA12 Parameters ACBQBAI4 Parameters ACBQBAID Parameters Copyright IBM Corp. 1986, 2004 x

18 xi z/os V1R5.0 DFSMSdfp Storage Administration Reference

19 About This Document Required product knowledge This document introduces system programmers and storage administrators to the IBM Storage Management Subsystem (SMS) and storage management concepts. More importantly, it describes in detail how to define, initialize, and maintain SMS and how to manage storage with the IBM Interactie Storage Management Facility (ISMF). This document is intended for system programmers and storage administrators like you who manage storage under DFSMS. As its title indicates, this section summarizes specific changes to the current release. If you are new to SMS and ISMF, you should start with Chapter 1, Introducing the Storage Management Subsystem, on page 1 so that you can familiarize yourself with the products first. You can also refer to the publications listed in Referenced Publications on page xii for further information on storage management concepts and ISMF applications. For information about the accessibility feature of z/os, for users who hae a physical disability, see Appendix F, Accessibility, on page 419. To use this document effectiely, you should be familiar with: Storage management concepts ISMF applications Referenced documents DFSMS Data Set Serices (DFSMSdss ) DFSMS Hierarchical Storage Manager (DFSMShsm ) Deice Support Facility (ICKDSF) Object access method (OAM) The following publications are referenced in this document: Publication Title Character Data Representation Architecture Reference and Registry CICS Recoery and Restart Guide CICS Transaction Serer for z/os Migration Guide CICS Transaction Serer for z/os Release Guide Deice Support Facilities User s Guide and Reference IBM 3495 Tape Library Dataserer Introduction IBM 3495 Tape Library Dataserer Operator s Guide IBM Enterprise Storage Serer Introduction and Planning Guide IBM Enterprise Storage Serer User s Guide International Technical Support Centers Implementing Concurrent Copy z/os MVS System Messages, Vol 1 (ABA-AOM) z/os MVS System Messages, Vol 2 (ARC-ASA) z/os MVS System Messages, Vol 3 (ASB-BPX) z/os MVS System Messages, Vol 4 (CBD-DMO) Order Number SC SC GC GC GC GA GA GC SC GG SA SA SA SA Copyright IBM Corp. 1986, 2004 xii

20 Publication Title z/os MVS System Messages, Vol 5 (EDG-GFS) z/os MVS System Messages, Vol 6 (GOS-IEA) z/os MVS System Messages, Vol 7 (IEB-IEE) z/os MVS System Messages, Vol 8 (IEF-IGD) z/os MVS System Messages, Vol 9 (IGF-IWM) z/os MVS System Messages, Vol 10 (IXC-IZP) MVS/ESA SML: Managing Data MVS/ESA SML: Managing Storage Groups z/os DFSMS Access Method Serices for Catalogs z/os DFSMS Adanced Copy Serices z/os DFSMS: Implementing System-Managed Storage z/os DFSMS Installation Exits z/os DFSMS Introduction z/os DFSMS: Managing Catalogs z/os DFSMS Migration z/os DFSMS OAM Application Programmer s Reference z/os DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support z/os DFSMS OAM Planning, Installation, and Storage Administration Guide for Tape Libraries z/os DFSMS: Using Data Sets z/os DFSMS: Using the Interactie Storage Management Facility z/os DFSMSdfp Diagnosis Reference z/os DFSMSdss Storage Administration Guide z/os DFSMSdss Storage Administration Reference z/os DFSMShsm Data Recoery Scenarios z/os DFSMShsm Storage Administration Guide z/os DFSMSrmm Implementation and Customization Guide z/os ISPF Dialog Deeloper s Guide and Reference z/os ISPF User s Guide Volume I z/os MVS Initialization and Tuning Guide z/os MVS JCL Reference z/os MVS JCL User s Guide z/os MVS Setting Up a Sysplex z/os MVS Programming: Sysplex Serices Guide z/os MVS System Commands z/os MVS System Management Facilities (SMF) z/os Parallel Sysplex Application Migration z/os Security Serer RACF Security Administrator s Guide z/os TSO/E Customization Storage Subsystem Library Master Bibliography, Index, and Glossary Order Number SA SA SA SA SA SA SC SC SC SC SC SC SC SC GC SC SC SC SC SC GY SC SC GC SC SC SC SC SA SA SA GC SA SA SA SA SA SA GC xiii z/os V1R5.0 DFSMSdfp Storage Administration Reference

21 Accessing z/os DFSMS documents on the Internet In addition to making softcopy documents aailable on CD-ROM, IBM proides access to unlicensed z/os softcopy documents on the Internet. To iew, search, and print z/os document, go to the z/os Internet Library: Using LookAt to look up message explanations LookAt 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. Using LookAt to find information is faster than a conentional search because in most cases LookAt goes directly to the message explanation. You can use LookAt from the following locations to find IBM message explanations for z/os elements and features, z/vm, and VSE: The Internet. You can access IBM message explanations directly from the LookAt Web site at Your z/os TSO/E host system. You can install code on your z/os or z/os.e 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 Serices running OMVS). Your Windows workstation. You can install code to access IBM message explanations on the z/os Collection (SK3T-4269), using LookAt from a Windows DOS command line. Your wireless handheld deice. You can use the LookAt Mobile Edition with a handheld deice that has wireless access and an Internet browser (for example, Internet Explorer for Pocket PCs, Blazer, or Eudora for Palm OS, or Opera for Linux handheld deices). Link to the LookAt Mobile Edition from the LookAt Web site. You can obtain code to install LookAt on your host system or Windows workstation from a disk on your z/os Collection (SK3T-4269), or from the LookAt Web site (click Download, and select the platform, release, collection, and location that suit your needs). More information is aailable in the LOOKAT.ME files aailable during the download process. Accessing z/os licensed documents on the Internet z/os licensed documentation is aailable on the Internet in PDF format at the IBM Resource Link Web site at: Licensed documents are aailable only to customers with a z/os license. Access to these documents requires an IBM Resource Link user ID and password, and a key code. With your z/os order you receied a Memo to Licensees, (GI ), that includes this key code. 1 To obtain your IBM Resource Link user ID and password, log on to: To register for access to the z/os licensed documents: 1. z/os.e customers receied a Memo to Licensees, (GI ) that includes this key code. About This Document xix

22 Notational Conentions 1. Sign in to Resource Link using your Resource Link user ID and password. 2. Select User Profiles located on the left-hand naigation bar. Note: You cannot access the z/os licensed documents unless you hae registered for access to them and receied an confirmation informing you that your request has been processed. Printed licensed documents are not aailable from IBM. You can use the PDF format on either z/os Licensed Product Library CD-ROM or IBM Resource Link to print licensed documents. A uniform notation describes the syntax of commands. This notation is not part of the language; it is merely a way of describing the syntax of the commands. The command syntax definitions in this document use the following conentions: [ ] Brackets enclose an optional entry. You can, but need not, include the entry. Examples are: [length] [MF=E] An OR sign (a ertical bar) separates alternatie entries. You must specify one, and only one, of the entries unless you allow an indicated default. Examples are: [REREADLEAVE] [length's'] { } Braces enclose alternatie entries. You must use one, and only one, of the entries. Examples are: BFTEK={SA} {KD} {addressso} Sometimes alternatie entries are shown in a ertical stack of braces. An example is: MACRF={{(R[CP])}{(W[CPL])} {(R[C],W[C])}} In the example aboe, you must choose only one entry from the ertical stack.... An ellipsis indicates that the entry immediately preceding the ellipsis might be repeated. For example: (dcbaddr,[(options)],...) A indicates that a blank (an empty space) must be present before the next parameter. UPPERCASE BOLDFACE Uppercase boldface type indicates entries that you must code exactly as shown. These entries consist of keywords and the following punctuation symbols: commas, parentheses, and equal signs. Examples are: CLOSE,,,,TYPE=T MACRF=(PL,PTC) xx z/os V1R5.0 DFSMSdfp Storage Administration Reference

23 UNDERSCORED UPPERCASE BOLDFACE Underscored uppercase boldface type indicates the default used if you do not specify any of the alternaties. Examples are: [EROPT={ACCSKPABE}] [BFALN={FD}] Lowercase Italic Lowercase italic type indicates a alue to be supplied by you, the user, usually according to specifications and limits described for each parameter. Examples are: number image-id count. About This Document xxi

24 xxii z/os V1R5.0 DFSMSdfp Storage Administration Reference

25 Summary of Changes This document contains terminology, maintenance, and editorial changes. Technical changes or additions to the text and illustrations are indicated by a ertical line to the left of the change. You might notice changes in the style and structure of some content in this document for example, headings that are more task-oriented, notes with headings that are more specific and clear in their intent, additional index entries for easier information retrieal, and procedures that hae a different look and format. The changes are ongoing improements to the consistency and retrieability of information in our documents. Summary of Changes for SC z/os Version 1 Release 5 New Information Deleted Information This document contains information preiously presented in z/os Version 1 Release 3 DFSMSdfp Storage Administration Reference. SC The following sections summarize the changes to that information. This edition includes the following new information: The maximum number of stripes for an extended format sequential data set has been increased from 16 to 59. DFSMS supports 384TRACK recording technology for mountable tape media cartridges. OAM supports cycle start time, cycle end time, and OSMC processing system attributes for object backup storage groups. DFSMS supports the multi-tiered storage group function for conentional olume selection. When you enable this function, SMS selects olumes in the order the storage groups are listed by the ACS storage group selection routines. You can specify Multi-Tiered SG (Y) in the storage class to enable this function. DFSMS supports the RACF FACILITY profile STGADMIN.IFG.READVTOC.olser, which controls the ability to obtain READ access to the VTOC or VTOC index. DFSMS supports the SMS copy pool construct. You can use a copy pool to define a set of storage groups that are processed collectiely for fast replication functions such as FlashCopy and SnapShot. DFSMShsm manages full-olume fast replication backup ersions using copy pool backup storage groups. DFSMS supports the SETSMS SAVESCDS command, which you can use to sae the actie ACDS as an SCDS if the current SCDS and its backup are lost. DFSMS supports the GDS_RECLAIM keyword in the IGDSMSxx member of PARMLIB. You can use this keyword to preent SMS from performing GDS reclaim processing automatically. You can use DFSMS in DFSMSts mode. DFSMS supports the software support for the IBM TotalStorage tape system 3592 Model J. Change the number of seconds that the DSS component of SMS will wait during backup processing for quiesce data set requests to complete (DSSTIMEOUT). The following information was deleted from this edition: Deleted the section for Modifying the SYS1.PARMLIB data set. You can find the information in the z/os MVS Initialization and Tuning Guide. Copyright IBM Corp. 1986, 2004 xxiii

26 Deleted the section for Parameters of the SETSMS operator command. You can find the information in the z/os MVS Initialization and Tuning Guide. xxi z/os V1R5.0 DFSMSdfp Storage Administration Reference

27 Chapter 1. Introducing the Storage Management Subsystem This chapter introduces the Storage Management Subsystem (SMS). In doing so, it explains arious applications of the Interactie Storage Management Facility (ISMF) so that you can use them to define your storage management policy and manage your SMS configurations. In addition, it proides an oeriew of the preparatory tasks for implementing SMS and explores considerations for running SMS in a Parallel Sysplex enironment and on mixed DFSMS releases. Understanding the Storage Management Subsystem The Storage Management Subsystem (SMS) is a DFSMS facility designed for automating and centralizing storage management. Using SMS, you can describe data allocation characteristics, performance and aailability goals, backup and retention requirements, and storage requirements to the systems. SMS improes storage space use, allows central control of external storage, and enables you to manage storage growth more efficiently. With SMS, you can easily manage conersion between deice types and ultimately moe toward system-managed storage. Using the Interactie Storage Management Facility The Interactie Storage Management Facility (ISMF) proides a series of applications for storage administrators to define and manage SMS configurations. You can use these applications to: Define SMS base configuration information. Define, alter, delete, or copy indiidual SMS classes, storage groups, aggregate groups, optical libraries, optical dries, and tape libraries. Display parameters and alues of indiidual SMS classes, storage groups, aggregate groups, mountable optical olumes, optical dries, mountable tape olumes, tape libraries and optical libraries. Generate, sae and manage lists of SMS classes, storage groups, aggregate groups, mountable optical olumes, optical libraries, optical dries, mountable tape olumes and tape libraries. Edit ACS routines. Define, alter, and execute ACS test cases. Validate the correctness and completeness of an SMS configuration. Actiate an SMS configuration. Display, define, alter, or delete storage group information pertaining to specific olumes using AUDIT, EJECT, ALTER, and RECOVER (RECOVER is for optical olumes only). Produce data set, olume, or capacity planning measurement data. Maintain mountable optical olumes and mountable tape olumes. Use DFSMSrmm to maintain tape olumes. Use the DFSMS NaiQuest tool to perform enhanced testing of your ACS routines, and to perform many storage management tasks in batch, such as: Updating and testing your base configuration Translating and testing your ACS routines Generating test cases from preiously collected DCOLLECT data Copyright IBM Corp. 1986,