z/OS DFSMShsm Managing Your Own Data
Previous topic |
Next topic
|
Contents
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
z/OS DFSMShsm Managing Your Own Data
SC23-6870-00
Abstract for DFSMShsm Managing Your Own Data
z/OS Version 2 Release 1 summary of changes
Introduction
Introduction to DFSMShsm
What is space management?
What is availability management?
What is a storage device hierarchy?
Where does DFSMShsm store my data?
What is the storage management subsystem?
What you do with DFSMShsm
Security
What is RACF protection?
What is password protection?
Non-VSAM data sets
VSAM data sets
How are DFSMShsm commands protected?
Methods of performing tasks
Using ISMF to perform tasks
Invoking ISMF
Building a data set list
Specifying line operators
Receiving feedback from ISMF
Entering line operator modes
Using DFSMShsm user macros
Space management
How does DFSMShsm manage space?
Automatic volume space management and automatic secondary space management
Recall
Can I perform space management tasks?
Availability management
How does DFSMShsm ensure data availability?
Backup
Recovery
Can I perform availability management tasks?
Space management and availability management capabilities
Space-saving functions
Partitioned data set compression
Deletion of temporary data sets
Release of overallocated space
Deletion of expired data sets
Extent reduction
Reblocking
Expiration of backup versions
Associated data sets
How does DFSMShsm know where my data sets are located?
Control data sets
Journal data set
How do I know where my data sets are located?
Understanding syntax diagrams and using DFSMShsm commands
How to read syntax diagrams
Symbols
Syntax items
Syntax examples
Using DFSMShsm commands
Positional parameters
Keyword parameters
Abbreviating commands and parameters
Delimiters
Line continuations
Comments
Notational conventions
Specifying data set names
Specifying data set passwords
Example of a DFSMShsm user command
Interacting with DFSMShsm
TSO HELP command
TSO Attention key
Incompatibilities caused by DFSMShsm
IEHMOVE utility
IDCAMS considerations
Submitting commands in batch mode
Example JCL for submitting an DFSMShsm command
Introduction to DFSMShsm user tasks
What tasks can I perform using DFSMShsm user commands?
How do I perform the task?
DFSMShsm user tasks
HALTERDS: Changing data set parameters
Using ISMF
Using TSO
Syntax
Required parameters
dsname: Specifying the name of the data set being altered
Explanation
Abbreviations
Defaults
Restrictions
Optional parameters
FREQUENCY and SYSFREQUENCY: Specifying the frequency for creation of backup versions for changed data sets
Explanation
Abbreviations
Defaults
Restrictions
VERSIONS and SYSVERSIONS: Specifying the number of backup versions to maintain
Explanation
Abbreviations
Defaults
Restrictions
Examples of different ways to code the HALTERDS command
Altering data set parameters for maximum backup versions and minimum frequency when using a BCDS record length of 6544 or more
Altering data set parameters for maximum backup versions and minimum frequency when using a BCDS record length of 2040
Altering data set parameters for installation-specified versions and maximum frequency
Altering data set parameters for specified versions and frequencies
Altering parameters for a list of data sets for installation-specified versions and frequency
HBACKDS: Backing up data sets
Using ISMF
Using TSO commands
Backing up a data set
Syntax
Required parameters
dsname: Specifying the name of one or more data sets to be copied for backup
Explanation
Abbreviations
Defaults
Restrictions
Optional parameters
CHANGEDONLY: Specifying whether to back up only changed data sets
Explanation
Abbreviations
Defaults
DATE: Specifying the address of a field containing the date
Explanation
Abbreviations
Defaults
Restrictions
EXTENDRC: Requesting an extended set of return and reason codes
Explanation
Abbreviations
Defaults
Restrictions
GENVSAMCOMPNAMES: Overriding SETSYS DSBACKUP(GENVSAMCOMPNAMES)
Explanation
Abbreviations
Defaults
Restrictions
NEWNAME: Specifying a backup version of a specified data set
Explanation
Abbreviations
Defaults
Restrictions
RETAINDAYS: Specifying a number of days to retain a backup copy
Explanation
SPHERE: Specifying whether components of a VSAM data set will be backed up with the base cluster
Explanation
Abbreviations
Defaults
Restrictions
TIME: Specifying the address of a field containing the time
Explanation
Abbreviations
Defaults
Restrictions
UNIT: Specifying the type of device
Explanation
Abbreviations
Defaults
Restrictions
VOLUME: Specifying the volume where the data set resides
Explanation
Abbreviations
Defaults
Restrictions
WAIT and NOWAIT: Specifying whether to wait for the HBACKDS command to be completed
Explanation
Abbreviations
Defaults
Restrictions
TARGET: Specifying the media target of the backup data set
Explanation
Abbreviations
Defaults
Restrictions
CC: Tailoring concurrent copy backups for SMS and non-SMS data sets
Explanation
Abbreviations
Defaults
Restrictions
Examples of different ways to code the HBACKDS command
Backing up a data set and not waiting for completion
Backing Up a Password-Protected Cataloged Data Set and Waiting for Completion
Backing Up Data Sets with the Same User Prefix Using an Asterisk in the Data Set Name and Not Waiting for Completion
Backing Up a Data Set and Requesting the Extended Return and Reason Codes
Backing up a data set that is targeted to DASD and waiting for completion
Backing up a data set that is targeted to tape and that uses concurrent copy as the preferred backup method
Backing up a data set with a specified retention period
Using inline backup
Invoking inline backup
HBDELETE: Deleting backup versions
Using ISMF
Using TSO
Deleting backup versions of a data set
Syntax
Required parameters
ALL: Deleting all backup versions
DATE TIME: Deleting a backup version that was created on a specific date and time
VERSIONS: Specifying the number of the backup versions to be deleted
dsname: Specifying the name of the data set backup versions to be deleted
Optional parameters
FROMVOLUME: Specifying the volume on which the data set resided when the backup versions were created
Examples of different ways to code the HBDELETE command
HCANCEL: Canceling a queued request
Cancel queued requests
Syntax
Required parameters
Optional parameters
REQUEST: Specifying the DFSMShsm request number to be canceled
Explanation
Abbreviations
Defaults
Restrictions
USERID: Specifying that all requests submitted by a particular user be canceled
Explanation
Abbreviations
Defaults
Restrictions
DATASETNAME: Specifying that all requests submitted to process a particular data set be canceled
Explanation
Abbreviations
Defaults
Restrictions
Examples of different ways to code the HCANCEL command
Canceling a request number
Canceling all requests submitted by a particular user
Canceling all requests submitted to process a particular data set
HDELETE: Deleting migrated data sets
Using ISMF
Using TSO
Syntax
Required parameters
dsname: Specifying the data set to delete
Explanation
Abbreviations
Defaults
Restrictions
Optional parameters
PURGE: Specifies deletion of migrated data sets within their retention periods
Explanation
Abbreviations
Defaults
Restrictions
WAIT and NOWAIT: Specifying whether to wait for the data set to be deleted
Explanation
Abbreviations
Defaults
Restrictions
EXTENDRC: Requesting an extended set of return and reason codes
Explanation
Abbreviations
Defaults
Restrictions
Examples of different ways to code the HDELETE command
Deleting a migrated data set that is still within its retention period
Deleting a migrated data set and waiting for completion
Deleting a group of migrated data sets and not waiting for completion
Deleting a password-protected migrated data set and not waiting for completion
Deleting two migrated data sets and not waiting for completion
Deleting a data set and requesting to see the extended return and reason codes
HLIST: Listing information from the BCDS and MCDS
Listing information from the BCDS and MCDS in TSO
Syntax
A: HLIST Optional Parameters
B: HLIST Optional Parameters
C: HLIST Optional Parameters
Required parameters
BACKUPVOLUME: Requesting a list of backup volume entries
Explanation
Abbreviations
Defaults
Restrictions
DATASETNAME and LEVEL: Requesting a list of data set entries
Explanation
Abbreviations
Defaults
Restrictions
MIGRATIONVOLUME, MIGRATIONLEVEL1, MIGRATIONLEVEL2, PRIMARYVOLUME, and VOLUME: Requesting a list of primary and migration volume entries
Explanation
Abbreviations
Defaults
Restrictions
USER: Requesting a list of user entries
Explanation
Abbreviations
Defaults
Optional parameters
BACKUPCONTROLDATASET, MIGRATIONCONTROLDATASET, and BOTH: Controlling the source of information listed
Explanation
Abbreviations
Defaults
Restrictions
INCLUDEPRIMARY: Requesting a list of entries for a data set that has migrated even though the data set might have been recalled
Explanation
Abbreviations
Defaults
Restrictions
OUTDATASET, SYSOUT, and TERMINAL: Specifying the location of output for the list
Explanation
Abbreviations
Defaults
Restrictions
SELECT: Requesting a list of only those data set entries that meet selection criteria
Explanation
Abbreviations
Defaults
Restrictions
SELECT(ACTIVE | RETAINDAYS): Selecting entries based on specification of the RETAINDAYS keyword
SELECT(AGE): Selecting entries based on data set use
Explanation
Abbreviations
Defaults
Restrictions
SELECT(MIGRATIONLEVEL1 | MIGRATIONLEVEL2 | VOLUME(volser)): Selecting entries based on the volume where the data set resides
Explanation
Abbreviations
Defaults
Restrictions
SELECT(SMALLDATASETPACKING | NOSMALLDATASETPACKING): Selecting entries based on whether the data sets migrated to an SDSP data set
Explanation
Abbreviations
Defaults
Restrictions
SELECT(VSAM): Specifying the data set organization
Explanation
Abbreviations
Defaults
Restrictions
SUMMARY: Requesting a summary only
Explanation
Abbreviations
Defaults
Restrictions
Examples of different ways to code the HLIST command
Listing the data set entries from the MCDS and printing them at the terminal
Listing the data set entries for data sets from the BCDS
Listing the entry for a backup volume
Listing the entries for data sets of selected age and sending the output to an output data set
Listing all migration volume entries from the MCDS
Listing the data set entries for data sets residing in a small-data-set-packing data set of a specific volume
Listing the data set entries for all level 1 volumes and sending the output to a terminal
Sample lists from the HLIST command
Listing volume entries
Listing backup volume entries
Listing data set entries from the migration control data set
Listing data set entries from the backup control data set
Listing entries of the latest backup version on backup volumes
Listing data set entries from both control data sets
Listing user authorization status entries
Listing a summary of data set entries
HMIGRATE: Migrating data sets
Using ISMF
Using TSO commands
Syntax
Required parameters
dsname: Specifying the name of the data set that is to migrate
Explanation
Abbreviations
Defaults
Restrictions
Optional parameters
MIGRATIONLEVEL2: Specifying migration of a data set directly to a level 2 volume
Explanation
Abbreviations
Defaults
WAIT and NOWAIT: Specifying whether to wait for data set migration
Explanation
Abbreviations
Defaults
Restrictions
EXTENDRC: Requesting an extended set of return and reason codes
Explanation
Abbreviations
Defaults
Restrictions
Examples of different ways to code the HMIGRATE command
Causing multiple data sets to migrate and not waiting for completion
Causing a password-protected data set to migrate
Causing data sets to migrate to level 2 volumes and not waiting for completion
Causing multiple data sets to migrate to level 2 volumes and not waiting for completion
Migrating a data set and requesting to see the return codes and reason codes
HQUERY: Listing pending requests
Using TSO commands
Syntax
Required parameters
Optional parameters
DATASETNAME: Specifying a list of requests by data set name
Explanation
Abbreviations
Defaults
Restrictions
REQUEST: Specifying a list of requests by request number
Explanation
Abbreviations
Defaults
Restrictions
Examples of different ways to code the HQUERY command
Listing pending requests for a data set
Listing all pending requests for your user identification
Listing pending requests by request number
Messages from the HQUERY command
HRECALL: Recalling data sets
Using ISMF
Using TSO commands
Recalling one or more data sets with TSO
Syntax
Required parameters
dsname: Specifying the name of the data set to be recalled
Explanation
Abbreviations
Defaults
Restrictions
Optional parameters
DAOPTION: Selecting target volume track length
Explanation
Abbreviations
Defaults
EXTENDRC: Requesting an extended set of return and reason codes
Explanation
Abbreviations
Defaults
Restrictions
UNIT: Specifying the type of unit for the receiving volume
Explanation
Abbreviations
Defaults
Restrictions
VOLUME: Specifying the volume to receive the recalled data set
Explanation
Abbreviations
Defaults
Restrictions
WAIT and NOWAIT: Specifying whether to wait for the data set to be recalled
Explanation
Abbreviations
Defaults
Restrictions
Examples of different ways to code the HRECALL command
Recalling two SMS-managed data sets and not waiting for completion
Recalling a group of data sets and not waiting for completion
Recalling a data set and requesting to see the return code and reason code
Recalling a password-protected data set to a specific volume and waiting for completion
Recalling two non-SMS-managed data sets to a DFSMShsm-managed volume and not waiting for completion
Recalling a non-SMS-managed DA (BDAM) data set to a volume with a different track length than that of the last level 0 volume
HRECOVER: Recovering data sets
Using ISMF
Using TSO
Recovering a backup version or a dump copy of a data set
Syntax
Required parameters
dsname: Specifying the name of the data set to be recovered
Explanation
Abbreviations
Defaults
Restrictions
Optional parameters
DAOPTION: Selecting target volume track length
Explanation
Abbreviations
Defaults
EXTENDRC: Requesting an extended set of return and reason codes
Explanation
Abbreviations
Defaults
Restrictions
FROMVOLUME: Specifying the volume from which the backup version or dump copy of a data set was created
Explanation
Abbreviations
Defaults
Restrictions
GENERATION, DATE, and VERSION: Specifying the particular data set backup version to recover
Explanation
Abbreviations
Defaults
Restrictions
NEWNAME: Specifying a new data set name for the recovered data set
Explanation
Abbreviations
Defaults
Restrictions
REPLACE: Specifying that the recovered data set version is to replace any existing data set of the same name
Explanation
Abbreviations
Defaults
Restrictions
TOVOLUME: Specifying the volume to receive the recovered data set
Explanation
Abbreviations
Defaults
Restrictions
UNIT: Specifying the type of unit for the receiving volume
Explanation
Abbreviations
Defaults
Restrictions
WAIT and NOWAIT: Specifying whether to wait for the data set to be recovered
Explanation
Abbreviations
Defaults
Restrictions
Examples of different ways to code the HRECOVER command
Recovering a specific data set by generation number and waiting for completion
Recovering a data set and requesting to see the return code and reason code
Recovering a non-SMS password-protected data set, renaming it, and waiting for completion
Recovering a non-SMS data set to replace an existing data set and not waiting for completion
Recovering a DA (BDAM) data set to a volume with a different track length than the last L0 volume from which the backup version was created
DFSMShsm application programming interface
Using DFSMShsm user macros
Register usage for return codes
Supported unit types and their UCBs
Asynchronous processing with DFSMShsm
ARCFMWE: Freeing up storage in common storage area
Syntax
Required parameters
Optional parameters
Usage notes
ARCHBACK: Backing up a specific data set
Syntax
Required parameters
Optional parameters
Usage notes
ARCHBDEL: Deleting a backed up version of data sets
Syntax
Required parameters
Optional parameters
Usage notes
ARCHDEL: Deleting migrated data sets
Syntax
Required parameters
Optional parameters
Usage notes
ARCHMIG: Migrating data sets
Syntax
Required parameters
Optional parameters
Usage notes
ARCHRCAL: Recalling a data set
Syntax
Required parameters
Optional parameters
Usage notes
ARCHRCOV: Recovering a data set
Syntax
Required parameters
Optional parameters
Usage notes
ARCHSEND: Sending a command to DFSMShsm
Syntax
Required parameters
Optional parameters
Usage notes
ARCXTRCT: Extracting data from DFSMShsm
Syntax
Required parameters
DATA: Extracting the data into an extract buffer
DEFINE: Defining a DSECT for the data returned
FREE: Free the extract buffer
Optional parameters
Usage notes
DFSMShsm and ISMF line operator reference summary
Return codes from DFSMShsm commands
Return codes from the default set
Return codes from the extended set
Return codes from user macros
Individual macros and their messages
Copyright IBM Corporation 1990, 2014