Version 2 Release 3 z/OS - IBM · 6/24/2019 · z/OS Version 2 Release 3 DFSMS Object Access Method Planning, Installation, and Storage Administration Guide for Object Support IBM

z/OSVersion 2 Release 3

DFSMS Object Access Method Planning,Installation, and Storage AdministrationGuide for Object Support

IBM

SC23-6866-30

Note

Before using this information and the product it supports, read the information in “Notices” on page597.

This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications untilotherwise indicated in new editions.

Last updated: 2019-06-24© Copyright International Business Machines Corporation 1986, 2019.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract withIBM Corp.

Contents

Figures................................................................................................................. xi

Tables..................................................................................................................xv

About This Document..........................................................................................xixRequired product knowledge.................................................................................................................... xixz/OS information........................................................................................................................................xixHow to Read Syntax Diagrams.................................................................................................................. xix

How to send your comments to IBM................................................................... xxiiiIf you have a technical problem.............................................................................................................. xxiii

Summary of changes.......................................................................................... xxvSummary of changes for z/OS Version 2 Release 3.................................................................................xxvSummary of changes for z/OS Version 2 Release 2...............................................................................xxviiSummary of changes for z/OS Version 2 Release 1.............................................................................. xxviii

z/OS Version 2 Release 1 summary of changes.............................................................................. xxviii

Chapter 1. Understanding the Object Access Method.............................................. 1Comparing multiple OAM and classic OAM configurations.........................................................................2Collections....................................................................................................................................................3Application programming interface (OSREQ macro).................................................................................. 4System-managed storage for data and space management......................................................................4Moving objects throughout the hierarchy....................................................................................................6Hardware and software interaction with OAM............................................................................................ 6Parallel Sysplex® and OAM...........................................................................................................................7

OAMplex..................................................................................................................................................8Shipping request limitations for larger data objects............................................................................. 9OAMplex restrictions.............................................................................................................................. 9OAMplex and file systems.................................................................................................................... 10

OAM components.......................................................................................................................................11Protecting against inadvertent object deletion.........................................................................................11CBROAMxx PARMLIB member statements...............................................................................................12

SETDISK statement for file systems used by OAM............................................................................. 12SETOAM statement for object tape volumes.......................................................................................13SETOPT statement for options.............................................................................................................13SETOSMC statement for OSMC processing......................................................................................... 13SETTLIB statement for tape library settings....................................................................................... 13OAMXCF statement for parallel sysplexes.......................................................................................... 14ONLYIF statement for parallel sysplexes............................................................................................ 14

ISMF library management role within OAM.............................................................................................. 14Installation storage management policy overview...................................................................................14SMS constructs and ACS routines............................................................................................................. 16

Understanding the storage group construct........................................................................................17Understanding the storage class construct.........................................................................................24Understanding the management class construct............................................................................... 31Understanding the data class construct..............................................................................................32ACS routines......................................................................................................................................... 33

OAM address space................................................................................................................................... 34

iii

MEMLIMIT for OAM....................................................................................................................................35OTIS address space................................................................................................................................... 35Optical storage...........................................................................................................................................36

Optical disk cartridges......................................................................................................................... 37Optical recording techniques............................................................................................................... 37Optical volumes....................................................................................................................................38Optical media types..............................................................................................................................40Optical disk drives................................................................................................................................ 40Optical libraries.................................................................................................................................... 41

Tape storage...............................................................................................................................................44Tape capacity and compaction............................................................................................................ 49Tape capacity and performance scaling.............................................................................................. 50Performance segmentation considerations........................................................................................ 50KB tracking........................................................................................................................................... 51Tape encryption support...................................................................................................................... 52Tape volumes........................................................................................................................................53Tape drives............................................................................................................................................57Tape libraries........................................................................................................................................ 59

Object tape and optical volume management.......................................................................................... 59Recycling tape and optical volumes.................................................................................................... 60Deleting tape and optical volumes...................................................................................................... 60Deleting recovered tape and optical volumes..................................................................................... 60

Chapter 2. Planning for OAM installation.............................................................. 61Setting up the planning team.................................................................................................................... 61Analyzing your business environment.......................................................................................................62

Grouping objects.................................................................................................................................. 62Establishing performance objectives...................................................................................................63Identifying management cycles...........................................................................................................64Concluding the business analysis phase............................................................................................. 68

Analyzing your processing environment................................................................................................... 68Hardware.............................................................................................................................................. 68Software................................................................................................................................................70

Estimating resource requirements............................................................................................................71General requirements.......................................................................................................................... 71DASD storage........................................................................................................................................72Object storage on removable media....................................................................................................77Concluding resource estimation.......................................................................................................... 80

Planning to use a file system..................................................................................................................... 80Security configuration for the file system............................................................................................81

Preparing the physical environment......................................................................................................... 83Preparing for installation and customization............................................................................................ 83Planning to program applications for OAM............................................................................................... 84Planning to administer OAM...................................................................................................................... 84Preparing to operate OAM......................................................................................................................... 84OAM planning case study.......................................................................................................................... 85

Object characterization........................................................................................................................ 85Resource estimation.............................................................................................................................87

Chapter 3. Migrating, installing, and customizing OAM.......................................... 95Verifying hardware and software prerequisites........................................................................................ 95Preparing the processing environment..................................................................................................... 96Preparing for migration or installation...................................................................................................... 96

High-level installation and migration checklists................................................................................. 97 1 Changing DB2 installation parameters......................................................................................... 100 2 Changing CICS installation parameters........................................................................................101 3 Configure the z/OS Unix file system..............................................................................................103

iv

4 Modifying the installation exit to manage deleted objects.......................................................... 104 5 Changing system libraries............................................................................................................. 104 6 Creating DB2 databases for object tables and directories.......................................................... 149 7 Creating the OAM configuration database....................................................................................154 8 Merging object tables and OCDB for an OAMplex........................................................................ 154 9 Creating and binding DB2 packages............................................................................................. 155 10 OSR application plans................................................................................................................. 155 11 OSMC application plans.............................................................................................................. 156 12 LCS, ISMF, and OSR application plans........................................................................................157 13 Verifying DB2 installation............................................................................................................158 14 IPL the system.............................................................................................................................159 15 Specifying the SMS definitions and programs used by OAM..................................................... 160 16 Running the OAM Installation Verification Program for object support.................................... 178 17 Adding new tape devices to the OAM object tape configuration...............................................179 18 Global z/OS UNIX configuration for OAM usage.........................................................................179

Specialized OAM installation procedures............................................................................................... 179Procedures for moving OAM to another system................................................................................179Merging OAMs into an OAMplex.........................................................................................................180Adding OAM systems to an existing OAMplex...................................................................................180

Chapter 4. Administering OAM........................................................................... 183Monitoring and maintaining the OAM configuration using ISMF............................................................184

ISMF library management................................................................................................................. 184Typical ISMF library management procedures................................................................................. 184

Monitoring and maintaining optical volumes..........................................................................................188ISMF Mountable Optical Volume Application................................................................................... 188Handling OAM scheduling errors....................................................................................................... 196

Monitoring and maintaining SMS construct definitions..........................................................................197Changing SMS construct definitions.................................................................................................. 197

Monitoring DB2 databases...................................................................................................................... 200DB2 RUNSTATS utility........................................................................................................................ 200DB2 STOSPACE utility........................................................................................................................ 201SQL statements.................................................................................................................................. 201

Tuning OAM..............................................................................................................................................201Tuning OAM connections to DB2....................................................................................................... 201Tuning the DB2 databases................................................................................................................. 202Tuning object retrieval response time............................................................................................... 208Recalling objects to disk.................................................................................................................... 209Tuning the storage management cycle..............................................................................................210Balancing library usage......................................................................................................................212Using appropriate transport classes within XCF............................................................................... 212

Measuring OAM transaction performance using SMF............................................................................ 213OAM SMF record subtypes.................................................................................................................215OAM SMF start and end time accuracy..............................................................................................217

Establishing recovery procedures...........................................................................................................217Recovering DB2 databases................................................................................................................ 217Recovering file system directories.....................................................................................................217Recovering single objects from removable media............................................................................ 218Recovering an entire optical cartridge or tape volume..................................................................... 218Accessing backup objects automatically.......................................................................................... 219

Using the Move Volume utility.................................................................................................................219Preparation of the Move Volume utility environment....................................................................... 221Reusing recycled tape and optical volumes......................................................................................228Deleting recycled tape and optical volumes from OAM....................................................................229Starting tape recycle.......................................................................................................................... 230

Expiring tape and optical volumes.......................................................................................................... 230Expiring tape volumes in object or object backup storage groups...................................................230

v

Expiring optical volumes in object or object backup storage groups............................................... 232Using the OAM Object Tape Volume Return to MVS Scratch exit routine.........................................233Synchronizing OAM scratch tape....................................................................................................... 236

Processing object expiration................................................................................................................... 237Destroying and deleting expired data..................................................................................................... 238

Diagnosing nondeletion/expiration of objects during OSMC processing......................................... 238Checking CBRHADUX.........................................................................................................................239Objects not selected for expiration processing by OSMC................................................................. 239Diagnosing unexpected results of object movement during OSMC processing...............................240

Invoking the OSREQ macro through the OSREQ TSO/E command processor.......................................243OSREQ TSO/E command syntax........................................................................................................ 243OSREQ TSO/E command processor return codes.............................................................................252

3995 optical service information messages...........................................................................................253

Chapter 5. Operating OAM and OTIS address spaces and OSMC functions............255Overview of operator tasks......................................................................................................................255Message format conventions.................................................................................................................. 256Overview of operator commands............................................................................................................ 257Starting OTIS............................................................................................................................................259Starting OAM............................................................................................................................................259Operator command applicability in a multiple OAM configuration........................................................ 261

MVS LIBRARY command applicability...............................................................................................263Starting OSMC functions..........................................................................................................................263

Starting the storage management cycle............................................................................................266Starting the library space management cycle...................................................................................268Starting the DASD space management cycle for an individual storage group................................. 270Starting the OAM Volume Recovery utility........................................................................................ 270Starting object recovery for single objects........................................................................................276Starting the tape recycle utility..........................................................................................................278Starting the Move Volume utility........................................................................................................278

Starting temporary diagnostic messages for file system errors originating from an OSREQ request.. 286Starting automatic access to backup copies of objects......................................................................... 287Varying optical drives and libraries......................................................................................................... 290

Varying an optical drive online or offline........................................................................................... 290Varying a real optical library online or offline....................................................................................291

Entering an optical disk into an optical library........................................................................................292Entering an unlabeled optical disk into a 3995 optical library......................................................... 293Entering a labeled optical disk into an optical library....................................................................... 295

Ejecting an optical disk............................................................................................................................296Specifying the shelf location..............................................................................................................297Associating pseudo libraries..............................................................................................................297Removing the optical disk cartridge.................................................................................................. 298

Mounting an optical disk on an operator-accessible drive.....................................................................298Demounting and removing an optical disk cartridge from an operator-accessible drive......................298Labeling an optical disk on a 3995 operator-accessible drive...............................................................299Relabeling a 3995 optical disk volume................................................................................................... 302Reformatting a 3995 optical disk............................................................................................................303Displaying status......................................................................................................................................306

Displaying OAM Status.......................................................................................................................306Displaying OAM XCF status................................................................................................................314Displaying OSMC summary status.....................................................................................................316Displaying OSMC task status............................................................................................................. 318Displaying drive online/offline connectivity...................................................................................... 322Displaying drive detail status.............................................................................................................324Displaying library online/offline connectivity.................................................................................... 327Displaying library detail status.......................................................................................................... 332Displaying Storage Group Status....................................................................................................... 335

vi

Displaying volume status................................................................................................................... 344Displaying volumes that have LOSTFLAG set....................................................................................352

Displaying SETDISK, SETOAM, SETOPT, SETOSMC, and SETTLIB parameters.....................................353Displaying outstanding OAM messages.................................................................................................. 357Querying summary and detail information for pending and active requests........................................ 357Scheduling an SVC dump for the OAM address space........................................................................... 363Restarting the OAM address space......................................................................................................... 364Using the UPDATE command to set SETOAM, SETOSMC, and SETOPT values..................................... 366

Updating SETOAM values...................................................................................................................367Updating SETOPT values....................................................................................................................370Updating SETOSMC values................................................................................................................ 371

Using the UPDATE command to set OAMXCF values............................................................................. 373Updating fields in the DB2 Volume Table and the Tape Volume Table.................................................. 374Auditing a volume.................................................................................................................................... 376Remapping an optical library...................................................................................................................377Removing one or all OAM subsystems from the OAM configuration......................................................377Refreshing OTIS DB2 Tasks.....................................................................................................................377Stopping OAM functions.......................................................................................................................... 378

Stopping OAM.....................................................................................................................................379Stopping OSMC...................................................................................................................................379Stopping OSMC processing for a storage group................................................................................380Stopping the Move Volume utility......................................................................................................380Stopping a volume recovery that is in progress................................................................................ 380Stopping automatic access to backup...............................................................................................381Stopping recycle processing.............................................................................................................. 383Stopping display of diagnostic messages for file system related errors originating from an

OSREQ request..............................................................................................................................383Stopping OTIS..........................................................................................................................................383

Appendix A. Sample optical hardware configurations......................................... 3853995 Optical Library Dataserver............................................................................................................. 385

Configurations for the 3995-1xx models.......................................................................................... 386Configurations for the 3995-Cxx models.......................................................................................... 387Defining 3995 device numbers..........................................................................................................390

Sample ISMF session for an IBM 3995 Optical Library Dataserver.......................................................395Defining real 3995 libraries............................................................................................................... 398Defining pseudo libraries................................................................................................................... 405Defining additional optical libraries...................................................................................................405

Defining optical drives............................................................................................................................. 406Defining additional optical disk drives...............................................................................................410

Maintaining and modifying optical libraries and optical drives..............................................................410Altering a 3995 optical library........................................................................................................... 410Changing the 3995 library connectivity.............................................................................................413Altering an optical disk drive............................................................................................................. 416Copying optical library and drive definitions..................................................................................... 416Deleting an optical library.................................................................................................................. 417Deleting an optical disk drive.............................................................................................................418Using DELETE FORCE to delete an optical library or optical drive....................................................419

Appendix B. Sample library members.................................................................421Changing system libraries....................................................................................................................... 421

CBRAPROC......................................................................................................................................... 422CBRIPROC.......................................................................................................................................... 423CBRCTI00...........................................................................................................................................423

Creating object databases.......................................................................................................................423CBRIALC0........................................................................................................................................... 424CBRIALCX........................................................................................................................................... 426

vii

CBRIALCY........................................................................................................................................... 428CBRILOB.............................................................................................................................................429CBRISQL0...........................................................................................................................................432CBRISQLX...........................................................................................................................................435CBRISQLY........................................................................................................................................... 437

OAM configuration database................................................................................................................... 438Sample migration jobs....................................................................................................................... 438CBRSAMPL..........................................................................................................................................438CBRSMR1B......................................................................................................................................... 445CBRSMR1D......................................................................................................................................... 446CBRSMERG......................................................................................................................................... 448CBRSG100..........................................................................................................................................453

Application plans..................................................................................................................................... 461CBRPBIND..........................................................................................................................................461CBRIBIND and CBRIGRNT.................................................................................................................461CBRHBIND and CBRHGRNT.............................................................................................................. 461CBRABIND and CBRAGRNT...............................................................................................................462

OAM installation verification program and OAMUTIL.............................................................................464CBRSAMIV..........................................................................................................................................465CBRSAMUT......................................................................................................................................... 466

Automatic class selection....................................................................................................................... 469CBRHSC.............................................................................................................................................. 469CBRHMC............................................................................................................................................. 472CBRHSG..............................................................................................................................................478

Appendix C. Example file system configuration for OAM usage............................ 481

Appendix D. Understanding OAM databases....................................................... 483Object storage databases........................................................................................................................483

Object directory tables.......................................................................................................................485Object storage tables......................................................................................................................... 488

Object administration database..............................................................................................................490Storage class identifier table............................................................................................................. 490Management class identifier table.................................................................................................... 491Collection name identifier table........................................................................................................ 491

OAM configuration database................................................................................................................... 492Library table (OLIBRARY)...................................................................................................................494Drive table (DRIVE)............................................................................................................................ 496Slot table (SLOT)................................................................................................................................ 498Volume table (VOLUME).....................................................................................................................499Deleted objects table (DELOBJT)...................................................................................................... 504Tape volume table (TAPEVOL)........................................................................................................... 504File system delete table (FSDELETE)................................................................................................ 512

Appendix E. OAM System Management Facility records.......................................515OAM SMF record header..........................................................................................................................515OAM SMF record product section............................................................................................................516OSREQ activity subtypes 1–10 data section format.............................................................................. 517OSMC storage management activity (subtypes 32–35).........................................................................531OSMC single object recovery utility (subtype 36)...................................................................................537OSMC library space management (subtype 37)..................................................................................... 544OSMC RECALL to the disk sublevel (subtype 38)................................................................................... 545Immediate backup copy (subtype 39)....................................................................................................547OSMC tape recycle (subtype 40).............................................................................................................550LCS optical library/drive VARY online/offline (subtypes 64–67)............................................................551LCS optical cartridge entry, eject, label, audit, mount, and demount (subtypes 68–73)......................554LCS optical write, read, logical delete, physical delete (subtypes 74–77)............................................ 559

viii

LCS tape write and read request (subtypes 78–79, and 88)..................................................................564OAM tape volume demount (subtype 87)...............................................................................................567LCS file system write, read, delete (subtypes 90-93)............................................................................ 569Invoking the SMF PARMLIB member......................................................................................................570

Changing SMF recording.................................................................................................................... 571DASD space allocation.............................................................................................................................572

Appendix F. Auto-delete installation exit............................................................ 573Auto-delete installation exit (CBRHADUX)............................................................................................. 573

Installing and replacing the CBRHADUX installation exit................................................................. 573Writing the CBRHADUX exit.....................................................................................................................573

Input................................................................................................................................................... 574Output.................................................................................................................................................574Coding restrictions............................................................................................................................. 575Registers on entry to the auto-delete exit routine............................................................................ 575Auto-delete installation exit parameter list...................................................................................... 575Registers on return from the CBRHADUX installation exit................................................................576Sample auto-delete installation exit................................................................................................. 577

Appendix G. Accessibility.................................................................................. 593Accessibility features.............................................................................................................................. 593Consult assistive technologies................................................................................................................ 593Keyboard navigation of the user interface.............................................................................................. 593Dotted decimal syntax diagrams.............................................................................................................593

Notices..............................................................................................................597Terms and conditions for product documentation................................................................................. 598IBM Online Privacy Statement................................................................................................................ 599Policy for unsupported hardware............................................................................................................599Minimum supported hardware................................................................................................................600Programming interface information........................................................................................................600Trademarks.............................................................................................................................................. 600

Glossary............................................................................................................ 601

Index................................................................................................................ 617

ix

Figures

1. Object storage hierarchy............................................................................................................................... 5

2. OAM Interactions with Software and Hardware...........................................................................................7

3. Overview of the Installation Storage Management Policy......................................................................... 15

4. DB2 Storage Decision Tree......................................................................................................................... 23

5. Conceptual Overview of Storing a Primary Object..................................................................................... 26

6. Conceptual Overview of Storing a First Backup Copy of an Object........................................................... 28

7. Conceptual Overview of Storing a Second Backup Copy of an Object.......................................................30

8. Storing an Object on Optical Media through an OSREQ STORE Request.................................................. 34

9. Write-Once, Read-Many (WORM) Recording Technique............................................................................38

10. Rewritable Magneto-Optic (MO) Recording Technique........................................................................... 38

11. Real Optical Library...................................................................................................................................42

12. Example of Using Class Transitions and ACS Routines to Change Management Classes...................... 65

14. CBROAMxx PARMLIB member sample using SETOAM......................................................................... 110

16. CBROAMxx PARMLIB Member Samples Using the SETOPT Statement and Optional Parameters......130

18. CBROAMxx PARMLIB Member Samples Using the SETOSMC Statement and Optional Parameters...139

22. Another Drive is Started When DRIVE STARTUP THRESHOLD is Exceeded......................................... 161

23. CBROAMxx PARMLIB Member Samples Using the ONLYIF Statement and Optional Parameters...... 181

24. CBROAMxx PARMLIB Member Samples Using the OAMXCF Statement and Optional Parameters.... 181

25. Confirm Library Audit Request Panel..................................................................................................... 186

26. Mountable Optical Volume Selection Entry Panel................................................................................. 189

27. Mountable Optical Volume List, Columns 14 through 16......................................................................191

28. Mountable Optical Volume List, Columns 17 through 21......................................................................191

29. Confirm Optical Volume Audit Panel...................................................................................................... 195

xi

32. Example of a Normal Completion of Recovery of a Backup Tape Volume............................................ 274

33. Example of a Normal Completion of Recovery of an Optical Volume without All Backup Copies........275

34. Example of a Limited Completion of Recovery of a Backup Volume Due to Error Condition............... 275

35. Object Storage Group and Volume Relationship....................................................................................279

36. Example of Messages Returned after a Normal Completion of MOVEVOL........................................... 284

37. Example of Messages Returned after a Normal Completion with Contention......................................285

38. Example of Messages Returned after a Limited Completion.................................................................285

39. Example of Messages Returned after a Not Available Completion....................................................... 286

40. Sample of DISPLAY SMS,OSMC,TASK(WG360A)................................................................................... 322

43. Sample Hardware Configuration—IBM 3995 Models 131, 132, 133, 111, 112, 113.......................... 386

44. Sample Hardware Configuration—IBM 3995 Models C3A, C32, and C12............................................ 387

45. Sample Hardware Configuration—IBM 3995 Models C3A and C34......................................................388

46. Sample Hardware Configuration—IBM 3995 Model C3A, C36, and C16.............................................. 389

47. Sample Hardware Configuration—IBM 3995 Model C3A, C38 and C18............................................... 390

48. ISMF Primary Option Menu.....................................................................................................................396

49. Library Management Selection Menu.....................................................................................................396

50. Optical Library Application Selection Panel...........................................................................................397

51. 3995 Library Define Panel for LIBRARY1 (Page 1 of 2)......................................................................... 398


53. 3995 Library Define Panel for LIB1C (Page 1 of 2)................................................................................401

54. 3995 Library Define Panel for LIB1C (Page 2 of 2)................................................................................402



57. 3995 Library Define Panel for LIBRARYA (Page 1 of 2)......................................................................... 403

58. 3995 Library Define Panel for LIBRARYA (Page 2 of 2)......................................................................... 404

xii

59. 3995 Library Define Panel for LIBRARYB (Page 1 of 2).........................................................................404

60. 3995 Library Define Panel for LIBRARYB (Page 2 of 2).........................................................................405

61. Pseudo Library Define Panel for PSEUDO1............................................................................................ 405

62. Optical Drive Application Selection Panel..............................................................................................406

63. 3995 Drive Define Panel for LIB1D1...................................................................................................... 407

64. 3995 Drive Define Panel for LIB2D1...................................................................................................... 408

65. 3995 Drive Define Panel for LIBAD1......................................................................................................408

66. 3995 Drive Define Panel for LIBBD1......................................................................................................409

67. 3995 Drive Define Panel for OPA1......................................................................................................... 409

68. 3995 Drive Define Panel for OPDRV1.....................................................................................................410

69. 3995 Library Alter Panel (Page 1 of 2)................................................................................................... 411




73. Conversion Confirmation Panel.............................................................................................................. 415

74. 3995 Drive Alter Panel............................................................................................................................416

75. Copy Entry Panel.....................................................................................................................................417

76. Deleting an Optical Library..................................................................................................................... 418

77. Deleting an Optical Disk Drive................................................................................................................ 419

78. Object Storage Group Database Structure.............................................................................................484

79. LOB Storage Structure............................................................................................................................ 489

80. Object Administration Database Structure............................................................................................ 490

81. OAM Configuration Database................................................................................................................. 493

xiii

Tables

1. Summary of media selection for object storage.........................................................................................24

2. Management class examples for objects................................................................................................... 32

3. Optical devices that OAM supports............................................................................................................ 36

4. Tape storage configurations........................................................................................................................45

5. Tape media and MEDIATYP values............................................................................................................. 53

6. Storage class service levels for a variety of business needs..................................................................... 63

7. Data set name qualifiers and descriptions for each...................................................................................72

8. Variables used in DASD formulas............................................................................................................... 73

9. DASD device characteristics....................................................................................................................... 73

10. Example of calculations for determining DASD requirements................................................................ 74

11. CBROAM space recommendations...........................................................................................................75

12. OAMADMIN space recommendations......................................................................................................76

13. Formulas for calculating storage requirements....................................................................................... 77

14. Effective optical volume usage for ibm optical disk media......................................................................79

15. Commands for completing the security configuration.............................................................................82

16. Object characteristics............................................................................................................................... 85

17. Storage calculations for the object storage database data sets............................................................. 89

18. Sample storage space calculation results................................................................................................90

19. Optical resource requirements for library resident data......................................................................... 92

20. The number of tape cartridges needed per workday...............................................................................93

21. Checklist for new installation or migration to a new release of OAM...................................................... 96

22. Determining maximum permitted block size......................................................................................... 121

23. Example of the TAPECOMPACTION / NOTAPECOMPACTION Selection Process................................. 126

xv

24. Recommended values for DRIVE STARTUP THRESHOLD..................................................................... 162

25. Constructs verified or changed through ACS Routines Invoked by the &ACSENVIR variables—AllOAM environments...................................................................................................................................168

26. Constructs verified or changed through acs routines invoked by the &ACSENVIR variables—Change environment only........................................................................................................................ 169

27. Remap results that appear in the VOLUME ERROR STATUS column.....................................................187

28. Discrepancies REMAP resolves between the outboard inventory and the OAM configurationdatabase...................................................................................................................................................188

29. Auditing results that appear in the VOLUME ERROR STATUS column.................................................. 194

30. Generic AUDIT messages....................................................................................................................... 195

31. Specific AUDIT messages.......................................................................................................................196

32. Record subtypes and descriptions......................................................................................................... 215

33. Examples of data movement with the Move Volume utility.................................................................. 221

34. How to migrate from old media types to new media types...................................................................223

35. Registers on entry to the exit routine..................................................................................................... 235

36. ARCTVEXT parameter list....................................................................................................................... 235

37. ARCTVEXT parameter list....................................................................................................................... 236

38. ARCTVEXT return codes......................................................................................................................... 236

39. OSREQ TSO command processor functions...........................................................................................244

40. OSREQ TSO/E command processor optional keywords........................................................................ 245

41. RETCODE2 values for OSREQ RETRIEVE............................................................................................... 250

42. RETCODE2 values for OSREQ STORE..................................................................................................... 252

43. Valid SETOAM keywords on the UPDATE command.............................................................................. 367

44. Valid SETOPT keywords on the UPDATE command...............................................................................370

45. Valid SETOSMC keywords on the UPDATE command............................................................................371

46. Field values for optical volumes.............................................................................................................375

47. Field values for object tape volumes......................................................................................................375

xvi

48. PCA card speed setting to match CPU channel speeds.........................................................................386

49. Optical libraries and their associated drive names and drive device types.......................................... 406

50. Object storage database naming conventions.......................................................................................483

51. Object directory table............................................................................................................................. 485

52. Object directory table field contents......................................................................................................486

53. Valid values for ODSTATF........................................................................................................................488

54. Object storage table................................................................................................................................488

55. LOB storage table....................................................................................................................................489

56. Storage class identifier table.................................................................................................................. 491

57. Management class identifier table......................................................................................................... 491

58. Collection name identifier table............................................................................................................. 491

59. Collection name identifier table contents..............................................................................................492

60. Library table column description............................................................................................................494

61. Drive table column description...............................................................................................................497

62. Slot table column description.................................................................................................................498

63. Volume table column description...........................................................................................................499

64. Deleted object table column description............................................................................................... 504

65. Tape volume table column description.................................................................................................. 505

66. Description of file system delete table (FSDELETE).............................................................................. 512

67. Header format for OAM SMF records..................................................................................................... 515

68. Product section format for OAM SMF subtypes..................................................................................... 516

69. OSREQ activity subtypes 1-10 data section format.............................................................................. 518

70. Valid subtype data section fields for OSREQ functions......................................................................... 530

71. Format of the subtype data section for subtypes 32–35...................................................................... 531

72. Format of the subtype data section for subtype 36...............................................................................538

xvii






78. Valid subtype data section fields for subtypes 64–67.......................................................................... 554





83. Format of subtype data section for subtypes 78–79............................................................................ 564

84. Format of subtype data section for subtype 87.....................................................................................567

85. Format of subtype data section for subtypes 90-93............................................................................. 569

86. Auto-delete parameter list, CBRADUP...................................................................................................575

87. Auto-delete return codes, CBRADUP.....................................................................................................577

xviii

About This Document

This document introduces OAM and explains how to do the following tasks:

• Plan for the installation of OAM.• Install OAM.• Customize OAM.• Administer OAM.• Operate OAM.

This document discusses using OAM's object support which you can use to manage objects on disk (DB2or file system), optical, and tape volumes. For information on using OAM to manage tape librarydataservers, see the z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for TapeLibraries.

This document is for the system programmers, storage administrators, and system operators whoperform these tasks.

Required product knowledgeTo use this document effectively, you should be familiar with:

• Data Facility Storage Management System (DFSMS)• Customer Information Control System (CICS®)—optional, depending on your installation• IBM DATABASE 2™ (DB2®)• Information Management System (IMS)—optional, depending on your installation• Interactive Storage Management Facility (ISMF)• Network File System (NFS)--optional, depending on your installation• zFS--optional, depending on your installation• z/OS UNIX--optional, depending on your installation• File systems--optional, depending on your installation

z/OS informationThis information explains how z/OS references information in other documents and on the web.

When possible, this information uses cross document links that go directly to the topic in reference usingshortened versions of the document title. For complete titles and order numbers of the documents for allproducts that are part of z/OS, see z/OS Information Roadmap.

To find the complete z/OS® library, go to IBM Knowledge Center (www.ibm.com/support/knowledgecenter/SSLTBW/welcome).

How to Read Syntax DiagramsThere is one basic rule for reading the syntax diagrams: Follow only one line at a time from the beginningto the end and code everything you encounter on that line.

The following rules apply to the conventions that are used in the syntax diagrams for all the OAMcommands:

• Read the syntax diagrams from left to right and from top to bottom.

© Copyright IBM Corp. 1986, 2019 xix

http://www.ibm.com/support/knowledgecenter/SSLTBW/welcomehttp://www.ibm.com/support/knowledgecenter/SSLTBW/welcome

• Each syntax diagram begins with a double arrowhead (►►) and ends with opposing arrows (►◄).• An arrow (─►) at the end of a line indicates that the syntax continues on the next line. A continuation

line begins with an arrow (►─).• Commands and keywords are shown in uppercase letters.• Some commands and keywords have alternative abbreviations; these appear as part of the stack for

that command or keyword. For example, the alternative abbreviation for DISPLAY is D.DISPLAY

D

• Where you can choose from two or more keywords, the choices are stacked one above the other. If onechoice within the stack lies on the main path, a keyword is required, and you must choose one. In thefollowing example you must choose either DETAIL or STATUS.

DETAIL

STATUS

• If a stack is placed below the main path, a keyword is optional, and you can choose one or none. In thefollowing example, PURGE, KEEP, and LOCATION are optional keywords. You can choose any one of thethree.

PURGE

KEEP

LOCATION

• Where you can choose from two or more keywords and one of the keywords appears above the mainpath, that keyword is the default. You may choose one or the other of the keywords, but if none isentered, the default keyword is automatically selected. In the following example you may choose eitherDETAIL or STATUS. If neither is chosen, STATUS is automatically selected.

STATUS

DETAIL

• Words or names in italicized, lowercase letters represent information that you supply. The values ofthese variables may change depending on the items to which they refer. For example, volser refers tothe serial number of a volume, while storgrp_name refers to the name of a storage group.

• You must provide all items enclosed in parentheses ( ). You must include the parentheses. In thefollowing example, you must supply the volume serial number (volser) and it must be enclosed inparentheses.

DISPLAY

D

SMS, VOLUME

VOL

( volser)

You would code this as follows:

D SMS,VOL(volser)

The variable volser is the serial number of the volume you wish to display.• The repeat symbol shown below indicates that you can specify keywords and variables more than once.

The repeat symbol appears above the keywords and variables that can be repeated. For example, whena comma appears in the repeat symbol, you must separate repeated keywords or variables with acomma.

In the following example, you may specify the library_name and one or more system identificationnumbers (system_id) that are separated by commas. You must enclose the name of the library and all ofthe system IDs in parentheses.

xx About This Document

( library_name

,

,

system_id

)

You would code this as follows:

(library_name, system_id, system_id, system_id)

The variable library_name is the name of the library you are working with, and system_id names threedifferent instances of system identification numbers.

• Some diagrams contain syntax fragments, which serve to break up diagrams that are too long, toocomplex, or too repetitious. Syntax fragment names are in mixed case and are shown in the diagramand in the heading of the fragment. The fragment is placed below the main diagram.

Syntax fragment name

Syntax fragment name1ST_KEYWORD,2ND_KEYWORD,3RD_KEYWORD

About This Document xxi

xxii z/OS: DFSMS Object Access Method Planning, Installation, and Storage Administration Guide for ObjectSupport

How to send your comments to IBM

We invite you to submit comments about the z/OS product documentation. Your valuable feedback helpsto ensure accurate and high-quality information.

Important: If your comment regards a technical question or problem, see instead “If you have a technicalproblem” on page xxiii.

Submit your feedback by using the appropriate method for your type of comment or question:Feedback on z/OS function

If your comment or question is about z/OS itself, submit a request through the IBM RFE Community(www.ibm.com/developerworks/rfe/).

Feedback on IBM® Knowledge Center functionIf your comment or question is about the IBM Knowledge Center functionality, for example searchcapabilities or how to arrange the browser view, send a detailed email to IBM Knowledge CenterSupport at [email protected].

Feedback on the z/OS product documentation and contentIf your comment is about the information that is provided in the z/OS product documentation library,send a detailed email to [email protected]. We welcome any feedback that you have, includingcomments on the clarity, accuracy, or completeness of the information.

To help us better process your submission, include the following information:

• Your name, company/university/institution name, and email address• The following deliverable title and order number: z/OS DFSMS OAM Planning, Installation, and

Storage Administration Guide for Object Support, SC23-6866-30• The section title of the specific information to which your comment relates• The text of your comment.

When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute the commentsin any way appropriate without incurring any obligation to you.

IBM or any other organizations use the personal information that you supply to contact you only about theissues that you submit.

If you have a technical problemIf you have a technical problem or question, do not use the feedback methods that are provided forsending documentation comments. Instead, take one or more of the following actions:

• Go to the IBM Support Portal (support.ibm.com).• Contact your IBM service representative.• Call IBM technical support.

© Copyright IBM Corp. 1986, 2019 xxiii

http://www.ibm.com/developerworks/rfe/http://www.ibm.com/developerworks/rfe/mailto:[email protected]:[email protected]://support.ibm.com

xxiv z/OS: DFSMS Object Access Method Planning, Installation, and Storage Administration Guide for ObjectSupport

Summary of changes

This information includes terminology, maintenance, and editorial changes. Technical changes oradditions to the text and illustrations for the current edition are indicated by a vertical line to the left ofthe change.

Summary of changes for z/OS Version 2 Release 3

This edition contains updates for Version 2 Release 3 (V2R3).

New information

This edition includes the following new information:

• Added to show comparison of classic and multiple OAM configurations. See “Comparing multiple OAMand classic OAM configurations” on page 2 for more information.

• Update to provide guidance on interacting with multiple OAM address spaces. See “Operator commandapplicability in a multiple OAM configuration” on page 261 for more information.

• Added new section describing encoding scheme necessary for OAM packages. See “DB2 defaultencoding scheme” on page 101 for more information.

• Added new section describing MVS LIBRARY Command Applicability. See “MVS LIBRARY commandapplicability” on page 263 for more information.

Changed information

This edition includes the following topics that contain changed information:

• Changed by removing catalog reference. See “Collections” on page 3 for more information.• Changed by removing sentence regarding instances of OAM in an OAMplex. See “OAMplex” on page 8

for more information.• Changed by removing list item regarding OAM DB2 database. See “OAMplex restrictions” on page 9

for more information.• Changed by updating CBR1100I OAM status. See “Displaying OAM Status” on page 306 for more

information.• Changed by differentiating between a classic OAM configuration and a multiple OAM configuration. See

“OAM address space” on page 34 for more information.• Changed by updating introductory paragraph to discuss configuration implications and remove catalog

references. See “OTIS address space” on page 35 for more information.• Changed by removing the 'Catalogs' list item. See “Setting up the planning team” on page 61 for more

information.• Changed by updating the table describing OAM product section fields. See “OAM SMF record product

section” on page 516 for more information.• Changed by adding DB2ID keyword. See “OSREQ TSO/E command syntax” on page 243 for more

information.• Changed by adding new row for 'Refresh OTIS DB2 Tasks'. See “Overview of operator tasks” on page

255 for more information.• Changed by adding a discussion of classic OAM configuration versus multiple OAM configuration. See

“Analyzing your business environment” on page 62 for more information.• Changed by updating list item to address a multiple OAM configuration. See “System software” on page

70 for more information.

© Copyright IBM Corp. 1986, 2019 xxv

• Changed by removing reference to collection entries in the catalog. See “DASD storage” on page 72 formore information.

• Changed by adding a note to address the possibility of a multiple OAM configuration. See “Planning touse a file system” on page 80 for more information.

• Changed by updating paragraph to reflect removal of OAM collection entries from the catalog. See“Coding ACS routines to implement class transitions” on page 87 for more information.

• Table 21 on page 96• Changed by removing step "Defining user catalogs". See “High-level installation and migration

checklists” on page 97 for more information.• Changed by updating the statement about preparing the Unix file system hierarchy. See “3 Configure the

z/OS Unix file system” on page 103 for more information.• Changed by updating syntax and keyword descriptions to address the possibility of a multiple OAMconfiguration. See “5 Changing system libraries” on page 104 for more information.

• Changed SETDISK parameters by updating L2DIR keyword description to address the possibility of amultiple OAM configuration. See “SETDISK parameters” on page 108 for more information.

• Changed by updating keyword descriptions. See “SETOPT keyword definitions” on page 132 for moreinformation.

• Changed by adding note regarding keywords and values in a multiple OAM configuration. See “SETOSMCstatements for use in the OSMC environment” on page 138 for more information.

• Changed by updating keyword descriptions. See “SETOSMC keyword definitions” on page 140 for moreinformation.

• Changed by updating syntax and keyword descriptions. See “ONLYIF statements” on page 143 for moreinformation.

• Changed by updating description to address a multiple OAM configuration and introducing a newkeyword. See “5h Updating the PROCLIB” on page 146 for more information.

• Changed by updating description to reflect the removal of OAM collection entries from the catalog. See“8 Merging object tables and OCDB for an OAMplex” on page 154 for more information.

• Changed by adding paragraph regarding the prevention of bind errors. See “9 Creating and binding DB2packages” on page 155 for more information.

• Changed by adding &DB2SSID read-only variable to the list of read-only variables. See “ACS routineinput variables” on page 167 for more information.

• Changed by removing collection definitions from the catalog. See “Storing objects in a collection” onpage 170 for more information.

• Changed by adding the OAM DB2 SSID parameter and its associated description. See “Defining storagegroups and relating the libraries to the storage groups” on page 170 for more information.

• Changed by generalizing notes regarding the existing OAM subsystem identifications. See “Definingmanagement classes” on page 175 for more information.

• Changed by removing steps that describe copying the Integrated Catalog Facility and moving collectiondefinitions into it. See “Procedures for moving OAM to another system” on page 179 for moreinformation.

• Changed by removing reference to OAM collections. See “Merging OAMs into an OAMplex” on page 180for more information.

• Changed by including instructions for a multiple OAM configuration. See “Adding OAM systems to anexisting OAMplex” on page 180 for more information.

• Changed by reflecting changes of OAMUTIL CHGCOL utility. See “Modifying default storage andmanagement classes” on page 199 for more information.

• Changed by reflecting changes of OAMUTIL CHGCOL utility. See “The CHGCOL procedure” on page 199for more information.

• Changed by reflecting changes of OAMUTIL CHGCOL utility. See “Manual procedure” on page 199 formore information.

xxvi z/OS: DFSMS Object Access Method Planning, Installation, and Storage Administration Guide for ObjectSupport

• Changed by generalizing the existing OAM subsystem identification. See “Tuning object retrievalresponse time” on page 208 for more information.

• Changed by generalizing the existing OAM subsystem identification. See “Tuning the storagemanagement cycle” on page 210 for more information.

• Changed by removing list item referring to collection name entries in a catalog. See “Establishingrecovery procedures” on page 217 for more information.

• Changed by removing list items. See “Recovering DB2 databases” on page 217 for more information.• Changed by removing a list item. See “Documentation for your IBM representative” on page 240 for

more information.• Changed by removing a list item. See “Documentation for your IBM representative” on page 242 for

more information.• Changed by adding a note regarding the OAMUTIL REFORMAT utility. See “Reformatting a 3995 optical

disk” on page 303 for more information.• Changed by updating syntax and keywords. See “OSREQ TSO/E command syntax” on page 243 for more

information.• Changed by adding an error code for the DB2ID keyword. See “OSREQ TSO/E command processor

return codes” on page 252 for more information.• Changed by updating to add the prefix loc. to all package names. See “CBRPBIND” on page 461 for

more information.• Changed by updating table describing the OAM product section fields. See “OAM SMF record product

section” on page 516 for more information.• Changed by updating descriptions of the CBRADUP fields. See “Auto-delete installation exit parameter

list” on page 575 for more information.• Changed by adding definitions for 'OAM instance,' 'Multiple OAM configuration,' and 'Classic OAMconf

Documents

Version 2 Release 3 z/OS - IBM · 6/24/2019 · z/OS Version 2 Release 3 DFSMS Object Access Method Planning, Installation, and Storage Administration Guide for Object Support IBM