z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support
Previous topic |
Next topic
|
Contents
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support
SC23-6866-00
Abstract for DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support
z/OS Version 2 Release 1 summary of changes
Understanding the Object Access Method
Collections
Application programming interface (OSREQ macro)
System-managed storage for data and space management
Moving objects throughout the hierarchy
Hardware and software interaction with OAM
Parallel Sysplex and OAM
OAMplex
Shipping request limitations for larger data objects
OAMplex restrictions
OAMplex and file systems
OAM components
Protecting against inadvertent object deletion
CBROAMxx PARMLIB member statements
SETDISK statement for file systems used by OAM
SETOAM statement for object tape volumes
SETOPT statement
SETOSMC statement for OSMC processing
SETTLIB statement for tape library settings
OAMXCF statement for parallel sysplexes
ONLYIF statement for parallel sysplexes
ISMF library management role within OAM
Installation storage management policy overview
SMS constructs and ACS routines
Understanding the storage group construct
Using Object, Object Backup, and Tape storage groups
Defining an Object or Object Backup Storage Group
Assigning Tape Storage Groups
Assigning Object Storage Groups
Assigning Object Backup storage groups
Determining which media to use for backup copies
Allocating a scratch tape for the tape storage group
Using the DATACLASS parameter to determine compaction
Using the TAPEUNITNAME parameter for volume allocation to a stand-alone drive
Object tape data set low-level qualifier
Using SETOAM to direct objects to a specific device type for an object storage group
Grouping devices (esoteric unit names)
Using DB2 with object storage groups
Conceptual overview of storing a primary object to DB2 sublevel
Understanding the storage class construct
Media selection for object storage
Conceptual overview of storing a primary object
Conceptual overview of storing a first backup copy of an object
Conceptual Overview of Storing a Second Backup Copy of an Object
Object storage on the shelf
Understanding the management class construct
Understanding the data class construct
Determining data class during scratch tape allocation
Ignoring TDSI data class information for a stand-alone allocation
ACS routines
OAM address space
MEMLIMIT for OAM
OTIS address space
Optical storage
Optical disk cartridges
Optical recording techniques
Write-once, read-many recording technique
Magneto-optic rewritable recording technique
Optical volumes
Optical volume types
Scratch volumes
Grouped volumes
Backup volumes
Optical media types
Optical disk drives
Library-resident optical disk drive
Operator-accessible optical disk drive
Multifunction optical disk drives
Optical libraries
Real optical libraries
Pseudo optical library concept
Defining optical volumes in pseudo libraries
Associating ejected optical volumes with pseudo libraries
Mounting a shelf-resident optical volume on an operator-accessible drive
Failing read/write requests for pseudo libraries
Tape storage
Tape capacity and compaction
Tape capacity and performance scaling
Performance segmentation considerations
KB tracking
Tape encryption support
Tape volumes
Larger logical volume size support in the Virtual Tape Server
3592 media considerations
Logical worm considerations
Tape volume types
Group and backup volumes
Scratch volumes
Format of the object data on the tape media
Tape drives
Using dynamic allocation for tape drives
Failing dynamic allocation and z/OS allocation recovery
Retrying or canceling a volume mount
Retrieving objects on devices compatible with the tape data format
Tape libraries
Object tape and optical volume management
Recycling tape and optical volumes
Deleting tape and optical volumes
Deleting recovered tape and optical volumes
Planning for OAM installation
Setting up the planning team
Analyzing your business environment
Grouping objects
Object storage groups
Collections
Establishing performance objectives
Identifying management cycles
Understanding storage management cycles
Checking for object deletion
Determining class transition and backup requirements
Developing appropriate management classes
OSMC processing management in an OAMplex
Automatic OSMC processing of storage groups
Manual OSMC processing of storage groups
Concluding the business analysis phase
Analyzing your processing environment
Hardware
Device considerations for larger data objects
Auxiliary storage and real storage considerations
Grouping tape devices
Considering storage configurations
Deferring hardware ordering until after work load analysis
Software
System software
Custom applications
Software prerequisites
Estimating resource requirements
General requirements
DASD storage
System paging
Object databases
Data set name qualifiers
Variables
Constants
Formulas
OAM configuration database
OAM administration database
Object storage on removable media
Constants
Formulas
Cartridges per day
Adjusting for storage groups and active drives
Effectively using optical volume space
Cartridges per year
Shelf-resident cartridges
Determining library requirements
Libraries for library-resident cartridges
Libraries for maximum retrieval rate
Libraries for storage management cycle processing
XCF resource estimation
Concluding resource estimation
Planning to use a file system
Security configuration for the file system
Preparing the physical environment
Preparing for installation and customization
Planning to program applications for OAM
Planning to administer OAM
Preparing to operate OAM
OAM planning case study
Object characterization
Establishing performance objectives and availability requirements
Establishing collections and constructs
Coding ACS routines to implement class transitions
Resource estimation
DASD resources
Calculating DASD storage for an object storage database
Calculating the number of objects stored on DASD, optical, and tape
Optical resources
Estimating the number of libraries required for maximum retrieval rate
Tape resources
Migrating, installing, and customizing OAM
Verifying hardware and software prerequisites
Preparing the processing environment
Preparing for migration or installation
High-level installation and migration checklists
1 Changing DB2 installation parameters
LOB support
Buffer pools and max connects
EDM pools
DB2 group buffer pools
Date and time routines
2 Changing CICS installation parameters
3 Configure the z/OS Unix file system
4 Modifying the installation exit to manage deleted objects
5 Changing system libraries
SETDISK statements for file system sublevel
SETDISK parameters
SETOAM statements for object tape storage
SETOAM keyword definitions for global level
SETOAM keyword definitions for STORAGEGROUP subparameters
SETOPT statements for options
Sample SETOPT statement
SETOPT keyword definitions
SETOSMC statements for use in the OSMC environment
SETOSMC keyword definitions
SETTLIB statement for tape library settings
ONLYIF statements in an OAMplex
OAMXCF statements in an OAMplex
OAMXCF keyword definitions
5h Updating the PROCLIB
6 Creating DB2 databases for object tables and directories
Object databases
Understanding object databases
Understanding the database creation jobs
7 Creating the OAM configuration database
8 Merging object tables and OCDB for an OAMplex
9 Creating and binding DB2 packages
10 OSR application plans
Creating the OSR application plan
Granting authority
11 OSMC application plans
Creating the OSMC application plans
Granting authority
12 LCS, ISMF, and OSR application plans
Creating the LCS, ISMF, and OSR application plans
Granting authority
13 Verifying DB2 installation
14 Defining user catalogs
Performance considerations
15 IPL the system
16 Specifying the SMS definitions and programs used by OAM
Translating the business analysis into technical definitions
Naming conventions
Storage group parameters
DRIVE STARTUP THRESHOLD
Exceeding the DRIVE STARTUP THRESHOLD
Improving performance with low DRIVE STARTUP THRESHOLD value
VOLUME FULL THRESHOLD
MARK VOLUME FULL AT FIRST WRITE-FAILURE OPTION
CYCLE START TIME and CYCLE END TIME
OSMC processing system name
OAM deletion protection
OAM retention protection
OAM cataloged procedure parameter (MAXS)
Storage class and management class parameters
ACS routine input variables
Storing objects in a collection
Creating OAM definitions with ISMF
Defining an SCDS
Defining storage groups and relating the libraries to the storage groups
Defining storage groups to direct data to specific optical media types
Defining storage classes
Defining data classes
Defining management classes
Defining automatic class selection
Validating and activating the SMS configuration
17 Run the OAM Installation Verification Program for object support
18 Adding new tape devices to the OAM object tape configuration
Global z/OS UNIX configuration for OAM usage
Specialized OAM installation procedures
Procedures for moving OAM to another system
Merging OAMs into an OAMplex
Adding OAM systems to an existing OAMplex
Administering OAM
Monitoring and maintaining the OAM configuration using ISMF
ISMF library management
Typical ISMF library management procedures
Defining an optical library or optical disk drive
SCDS activation and restart
Deleting an optical library or optical disk drive
Altering an optical library or optical disk drive
Auditing an optical library
Remapping an optical library
Types of discrepancies that REMAP resolves
Monitoring and maintaining optical volumes
ISMF Mountable Optical Volume Application
Generating a mountable optical volume list
Completing the Mountable Optical Volume Selection Entry panel
Final step: Generating the list
Viewing and sorting a list
Maintaining and verifying the volume list
Verifying optical volumes using audit
AUDIT messages
Ejecting optical disks
Recovering optical disks
Handling OAM scheduling errors
Message history for AUDIT commands
ISMF log entries about rejected requests
Errors after a request is scheduled
Monitoring and maintaining SMS construct definitions
Changing SMS construct definitions
Maintaining storage class definitions
Maintaining management class definitions
Maintaining object storage group definitions
Modifying data class definitions
Modifying default storage and management classes
The CHGCOL procedure
Manual procedure
Changing ACS routines
Monitoring DB2 databases
DB2 RUNSTATS utility
DB2 STOSPACE utility
SQL statements
Tuning OAM
Tuning OAM connections to DB2
Tuning the DB2 databases
Segmented table spaces
Partitioning table spaces
Partitioning object storage tables
Partitioning the 4 KB object storage tables
Partitioning the 32 KB object storage tables
Partitioning the LOB storage structures
Tuning object retrieval response time
Recalling objects to disk
Tuning the storage management cycle
Considerations for larger data objects
Balancing library usage
Using appropriate transport classes within XCF
Measuring OAM transaction performance using SMF
OAM SMF record subtypes
OAM SMF start and end time accuracy
Establishing recovery procedures
Recovering DB2 databases
Recovering file system directories
Recovering single objects from removable media
Recovering an entire optical cartridge or tape volume
Recovering collection name catalog entries
Accessing backup objects automatically
Using the Move Volume utility
Preparation of the Move Volume utility environment
Preparing object and object backup storage groups
Updating the SETOPT OPTICALREINITMODE or SETOAM TAPERECYCLEMODE keyword
Updating and activating an SCDS
Minimizing or quiescing contending system activity
Analyzing resources and tuning OAM for MOVEVOL usage
MAXS considerations for MOVEVOL processing
DRIVE STARTUP threshold considerations for MOVEVOL processing
DB2 index considerations
Reusing recycled tape and optical volumes
Recycling tape volumes
Recycling optical volumes
Deleting recycled tape and optical volumes from OAM
Starting tape recycle
Expiring tape and optical volumes
Expiring tape volumes in object or object backup storage groups
Expiring optical volumes in object or object backup storage groups
Using the OAM Object Tape Volume Return to MVS Scratch exit routine
Dynamic exits facility
Adding the installation exit routines to CBRUXTVS_EXIT
Modifying the installation exit routine
Displaying the installation exit routine
Processing requirements for the installation exit
Writing the exit routine
Registers on entry to the exit routine
Registers on exit
Parameter list
Data area
Return codes
Synchronizing OAM scratch tape
Enabling SETOAM OAMSCRATCHSYNCH mode
Manually updating the OUNITNAM and DATACLAS fields in the TAPEVOL table
Processing object expiration
Destroying and deleting expired data
Diagnosing nondeletion/expiration of objects during OSMC processing
Checking CBRHADUX
Objects not selected for expiration processing by OSMC
Management class and expiration attribute definitions
Collection entry not found in the collection table
Inconsistencies between the catalog and the collection table
Documentation for your IBM representative
Diagnosing unexpected results of object movement during OSMC processing
Objects not moved to a new storage level during OSMC processing
Objects not selected for class transition processing
Collection entry not found in the collection table
Inconsistencies between the catalog and the collection table
Check management class definitions
Check management class and storage class ACS routines
Check storage class definitions
Documentation for your IBM representative
Invoking the OSREQ macro through the OSREQ TSO/E command processor
OSREQ TSO/E command syntax
OSREQ TSO/E command processor return codes
3995 optical service information messages
Operating OAM and OTIS address spaces and OSMC functions
Overview of operator tasks
Message format conventions
Overview of operator commands
Starting OTIS
Starting OAM
Starting OSMC functions
Starting the storage management cycle
Starting the storage management cycle for all storage groups
Starting the storage management cycle for a selected set of storage groups
Starting the library space management cycle
Starting the DASD space management cycle for an individual storage group
Starting the OAM Volume Recovery utility
Starting a recovery for an optical or tape volume
Statistics provided by the Volume Recovery utility
Normal completion of recovery of a backup tape volume
Normal completion of recovery of an optical volume without all backup copies
Limited completion of recovery of a backup volume due to error condition
Deleting a recovered tape or optical volume
Starting object recovery for single objects
Starting the tape recycle utility
Starting the Move Volume utility
Move volume scenarios
Moving objects from a source volume
Moving objects and recycling the source volume
Recycle completion messages for rewritable tape volumes
Recycle completion messages for rewritable optical volumes
Recycle completion messages for WORM optical volumes
Moving objects and deleting the source volume
Statistics provided by the Move Volume utility
Normal completion
Normal completion with contending system activity
Limited completion
Not available completion
Status of the source volume
Status of the objects following the completion of the utility
Starting temporary diagnostic messages for file system errors originating from an OSREQ request
Starting automatic access to backup copies of objects
Varying optical drives and libraries
Varying an optical drive online or offline
Varying a real optical library online or offline
Entering an optical disk into an optical library
Entering an unlabeled optical disk into a 3995 optical library
Entering a labeled optical disk into an optical library
Ejecting an optical disk
Specifying the shelf location
Associating pseudo libraries
Removing the optical disk cartridge
Mounting an optical disk on an operator-accessible drive
Demounting and removing an optical disk cartridge from an operator-accessible drive
Labeling an optical disk on a 3995 operator-accessible drive
Relabeling a 3995 optical disk volume
Reformatting a 3995 optical disk
Displaying status
Displaying OAM Status
Displaying OAM XCF status
Displaying OSMC summary status
Displaying OSMC task status
Displaying drive online/offline connectivity
Displaying drive detail status
Displaying library online/offline connectivity
Displaying library detail status
Displaying Storage Group Status
Displaying volume status
Optical Volume Status
Object Tape Volume Status
Displaying volumes that have LOSTFLAG set
Displaying SETDISK, SETOAM, SETOPT, SETOSMC, and SETTLIB parameters
Displaying outstanding OAM messages
Querying summary and detail information for pending and active requests
Scheduling an SVC dump for the OAM address space
Restarting the OAM address space
Using the UPDATE command to set SETOAM, SETOSMC, and SETOPT values
Updating SETOAM values
Updating SETOPT values
Updating SETOSMC values
Using the UPDATE command to set OAMXCF values
Updating fields in the DB2 Volume Table and the Tape Volume Table
Auditing a volume
Remapping an optical library
Stopping OAM functions
Stopping OAM
Stopping OSMC
Stopping OSMC processing for a storage group
Stopping the Move Volume utility
Stopping a volume recovery that is in progress
Stopping automatic access to backup
Stopping recycle processing
Stopping display of diagnostic messages for file system related errors originating from an OSREQ request
Stopping OTIS
Sample optical hardware configurations
3995 Optical Library Dataserver
Configurations for the 3995-1xx models
Configurations for the 3995-Cxx models
Defining 3995 device numbers
Using 3995-SDA definition in HCD
Using 3995 definition in HCD
Migrating the configuration from IOCDS into IODF
Sample ISMF session for an IBM 3995 Optical Library Dataserver
Defining real 3995 libraries
Defining pseudo libraries
Defining additional optical libraries
Defining optical drives
Defining additional optical disk drives
Maintaining and modifying optical libraries and optical drives
Altering a 3995 optical library
Changing the 3995 library connectivity
Confirming a system mode conversion
Altering an optical disk drive
Copying optical library and drive definitions
Deleting an optical library
Deleting an optical disk drive
Using DELETE FORCE to delete an optical library or optical drive
Sample library members
Changing system libraries
CBRAPROC
CBRIPROC
CBRCTI00
Creating object databases
CBRIALC0
CBRIALCX
CBRIALCY
CBRILOB
CBRISQL0
CBRISQLX
CBRISQLY
OAM configuration database
Sample migration jobs
CBRSMKBO
CBRSAMPL
CBRSMB2
CBRSMPDS
CBRSMR1B
CBRSMR1D
CBRSMERG
CBRSG100
CBRSMVAF
Application plans
CBRPBIND
CBRIBIND and CBRIGRNT
CBRHBIND and CBRHGRNT
CBRABIND and CBRAGRNT
OAM installation verification program and OAMUTIL
CBRSAMIV
CBRSAMUT
Automatic class selection
CBRHSC
CBRHMC
CBRHSG
Example file system configuration for OAM usage
Understanding OAM databases
Object storage databases
Object directory tables
Object storage tables
Object administration database
Storage class identifier table
Management class identifier table
Collection name identifier table
OAM configuration database
Library table (OLIBRARY)
Drive table (DRIVE)
Slot table (SLOT)
Volume table (VOLUME)
Deleted objects table (DELOBJT)
Tape volume table (TAPEVOL)
File system delete table (FSDELETE)
OAM System Management Facility records
OAM SMF record header
OAM SMF record product section
OSREQ activity subtypes 1–10 data section format
OSMC storage management activity (subtypes 32–35)
OSMC single object recovery utility (subtype 36)
OSMC library space management (subtype 37)
OSMC RECALL to the disk sublevel (subtype 38)
Immediate backup copy (subtype 39)
OSMC tape recycle (subtype 40)
LCS optical library/drive VARY online/offline (subtypes 64–67)
LCS optical cartridge entry, eject, label, audit, mount, and demount (subtypes 68–73)
LCS optical write, read, logical delete, physical delete (subtypes 74–77)
LCS tape write and read request (subtypes 78–79, and 88)
OAM tape volume demount (subtype 87)
LCS file system write, read, delete (subtypes 90-93)
Invoking the SMF PARMLIB member
Changing SMF recording
DASD space allocation
Auto-delete installation exit
Auto-delete installation exit (CBRHADUX)
Installing and replacing the CBRHADUX installation exit
Writing the CBRHADUX exit
Input
Output
Coding restrictions
Registers on entry to the auto-delete exit routine
Auto-delete installation exit parameter list
Registers on return from the CBRHADUX installation exit
CBRHADUX return code and description
CBRHADUX messages
Sample auto-delete installation exit
Copyright IBM Corporation 1990, 2014