Commands

Table 1 identifies the new and changed DFSMShsm commands. DFSMShsm commands are documented in z/OS DFSMShsm Storage Administration and z/OS DFSMShsm Managing Your Own Data.

Table 1. DFSMShsm: Summary of changed commands
Command name Release Description Reason for change
BACKVOL z/OS® V1R12 New: The DUMP parameter has been updated to allow stacking up to 255 dump copies on a single dump volume. Dump stacking enhancements
DEFINE z/OS V2R1 New: The DUMPCLASS parameter now allows a RECOVERRESET keyword, which specifies whether or not the data-set-changed indicator in the VTOC is reset for all data sets that are restored during full-volume recover processing. Serviceability and usability enhancements
z/OS V1R12 New: The DUMPCLASS parameter has been updated to allow stacking up to 255 dump copies on a single dump volume. Dump stacking enhancements
FRBACKUP z/OS V2R1 New: ALL subparameter for FCINCREMENTAL and FCINCREMENTALLAST, to specify that an incremental copy pool version is to be created and all subsequent copy pool backup copies should also be incremental Multiple Incremental FlashChopy target support
FRRECOV z/OS V2R1 New: The NEWNAME(newdsname) parameter has been added, allowing DFSMShsm to use a new, fully-qualified data set name for the recovered backup version or dump copy. Fast replication enhancements
z/OS V1R12 New: A set of new parameters have been added to the FRRECOV COPYPOOL command. The FROMDUMP parameter and DUMPCLASS subparameter allow recovery of a copy pool or volumes within a copy pool from a dump backup copy. The PARTIALOK parameter allows recovery from a partial dump version. The RESUME parameter allows control over resuming a previously failed recovery attempt. Multi-task volume recovery from dump enhancements
New: The FORCE parameter has been added allowing recovery from a DASD backup copy that has an incomplete dump copy. DFSMS fast reverse restore enhancements
LIST z/OS V2R1 New: The SELECT(RECYCLETAKEAWAY) subparameter has been added to the LIST TAPETABLEOFCONTENTS command, to display the volumes that were not completely recycled because they were taken away by recall or another DFSMShsm task. Serviceability and usability enhancements
z/OS V1R12 New: The FCFRRINCOMPLETE and INCOMPLETERECOVERY have been added to the LIST COPYPOOL SELECT command to request information about an FRBACKUP DASD copy (FCFRRINCOMPLETE) and to request information about copy pool FRBACKUP versions that have not been recovered completely (INCOMPLETERECOVERY). DFSMS fast reverse restore enhancements
Changed: LIST COPYPOOL(cpname) output includes: a new FASTREPLICATION state (FCFRRINCOMPLETE), fast reverse restore status field (FCFRR=), and recovery complete status field (RECOVERYINCOMPLETE=). This new output is displayed when OUTDATASET, SYSOUT, or TERMINAL is specified as the destination for the output. DFSMS fast reverse restore enhancements
ONLYIF z/OS V1R13 New: More than one hostid can be specified, each separated by a comma. Also, a group of commands can be conditionally executed when surrounded by the new BEGIN and END operators. DFSMShsm usability enhancements
QUERY z/OS V2R1 Changed: The output returned from the QUERY ACTIVE(TCBADDRESS) command will now include the tape volser, device address, and task name. Serviceability and usability enhancements
z/OS V1R12 Changed: The QUERY COPYPOOL command output, in message ARC1820I, will display applicable "background copy percent-complete" (PCT-COMP) information for full-volume FlashCopy® pairs with an incomplete background copy. DFSMS fast reverse restore enhancements
SETSYS z/OS V2R1 New: The CLASSTRANSTION(EVENTDRIVENMIGATION(Y|N)) parameter has been added, to specify settings for class transitions during interval migration and on-demand migration windows. The additional SERIALIZATIONEXITS(Y|N) subparameter indicates whether the user data set serialization error exits will be used during event driven migration. Storage tiers support
New: The MIGRATIONSUBTASKS(YES|NO) parameter had been added, allowing DFSMShsm to run multiple subtasks concurrently under each migration task. The additional ADDITIONALSUBTASKS(nn) subparameter allows you to dynamically change the number of additional subtasks that the system can use. Migration subtasking support
New: The RECYCLETAKEAWAYRETRY(YES | NO) parameter has been added, allowing DFSMShsm to automatically generate a new RECYCLE command for a tape when the original recycle must terminate due to the takeaway process, or when the tape is in use by the another DFSMShsm task. Two additional subparameters, MAXRETRYATTEMPTS(nn) and DELAY(ssss), allow you to set the maximum number of recycle retry attempts and to set the delay interval in seconds between recycle attempts, respectively. Serviceability and usability enhancements
New: The (TAPECOPY | RECYCLE) subparameter has been added to both the BACKUP and the MIGRATION parameters of the SETSYS DUPLEX command. It specifies whether, after an error occurs on the duplex alternate tape and the alternate tape is demounted and discarded so that DFSMShsm can continue to write to the original tape, a tapecopy or a recycle will be immediately attempted. Serviceability and usability enhancements
z/OS V1R13 New: ONDEMANDMIGRATION parameter indicating that the On Demand Migration function should be used instead of Interval Migration on SMS volumes. DFSMShsm space management performance improvements
New: FASTREPLICATION (VOLUMEPAIRMESSAGES(YES|NO)) parameter, used to suppress or display ARC1801 messages. An easier way to control the ARC1809I messages
New: RELEASE RECALL(DASD) parameter, used to release recalls from DASD volumes while continuing to hold recalls on tape volumes. Enhancement to RELEASE RECALL
Changed: The default on FASTREPLICATION(PREFERRED | REQUIRED | NONE) has been changed to NONE. DFSMShsm usability enhancements
z/OS V1R12 New: Five new parameters (BACKUP, CDSBACKUP, DUMP, MIGRATION, and RECOVERY) have been added to the SETSYS DSSXMMODE command to provide expanded, more granular control of the DFSMSdss cross memory interface. Expanded control of the DFSMSdss cross memory interface
New: The FCRELATION parameter has been added to the SETSYS FASTREPLICATION command specifying whether an extent-level or a full-volume-level FlashCopy relationship is to be established for fast replication backup and recovery of volumes. DFSMS fast reverse restore enhancements
New: MAXDUMPRECOVERTASKS parameter specifying the maximum number of volume recovery from dump tasks DFSMShsm can concurrently process. Multi-task volume recovery from dump enhancements
New: USECYLINDERMANAGEDSPACE parameter specifying whether to allow use of cylinder managed space for migration copies and backup versions. EAV enhancement for z/OS V1R12