Commands

This topic 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.

DFSMShsm command changes in z/OS V2R2

Table 1. DFSMShsm: Summary of changed commands in z/OS V2R2
Command name Description and reason for change
BACKVOL Start of change
  • The new DUMPCLASS parameter now allows a MINSTACK keyword, to define the minimum number of dump copies that can be placed on a tape volume.
  • MAXSTACK has been added as an alias for the STACK parameter.
Reason for change: Distributed tape processing enhancements
End of change
DEFINE Start of change
  • The new DUMPCLASS parameter now allows a MINSTACK keyword, to define the minimum number of dump copies that can be placed on a tape volume.
  • MAXSTACK has been added as an alias for the STACK parameter.
Reason for change: Distributed tape processing enhancements
End of change
FRBACKUP Start of changeThe MESSAGEDATASET parameter has been added, allowing you to specify the date and time used in the name of the fast replication message data set.
Reason for change: Message simplification
End of change
FRRECOV COPYPOOL Start of changeThe MESSAGEDATASET parameter has been added, allowing you to specify the date and time used in the name of the fast replication message data set.
Reason for change: Message simplification
End of change
HMIGRATE
  • The TRANSITION and MOVE parameters have been added to allow you to specify whether the data set should go through transition or move processing.
  • Start of changeOptional MANAGEMENTCLASS, STORAGECLASS, STORAGEGROUP subparameters have been added to the TRANSITION parameter.End of change
Reason for change: Storage tiers enhancements
LIST Start of changeThe LIST DUMPCLASS command now shows the minimum and maximum stack values for both DEFINE and BACKVOL.
Reason for change: Distributed tape processing enhancements
End of change
MIGRATE Start of change
  • BOTH, MIGRATIONONLY, and TRANSITIONONLY parameters are added for VOLUME processing to indicate that only migrations should be processed, only transitions should be processed, or that both should be processed.
  • Start of changeOptional MANAGEMENTCLASS, STORAGECLASS, STORAGEGROUP subparameters have been added to the TRANSITION and TRANSITIONONLY parameters.End of change
  • STORAGEGROUP parameter is added to request that migrations or class transitions be performed at the storage group level.
  • MOVE parameter is added for the MIGRATE DATASETNAME, MIGRATE STORAGEGROUP and MIGRATE VOLUME commands, to indicate that the data set should go through move processing.
Reason for change: Storage tiers enhancements
End of change
QUERY Start of changeThe DUMP parameter has been added to the QUERY COMMONQUEUE command to display active and queued requests in the DFSMShsm common dump queue.
Reason for change: Distributed tape processing enhancements
End of change
SETSYS Start of change
New parameters have been added for use with COMMONQUEUE to allow DFSMShsm hosts to participate in a common dump queue.
Reason for change: Distributed tape processing enhancements
The MAXDUMPTASKS parameter now accepts a value of 0, which allows a host running in a common dump queue to submit requests, while preventing the common dump queue from using its available dump tasks for processing.
Reason for change: Distributed tape processing enhancements
The MESSAGEDATASET parameter has been added for use with FASTREPLICATION to allow messages for fast replication backup, dump, and recover to be recorded in a unique data set.
Reason for change: Message simplification
End of change
UPDTCDS Start of changeThe UPDTCDS command has been added to let you update the expiration date of copy pool dump copies.
Reason for change: Serviceability and usability enhancements
End of change

DFSMShsm command changes in z/OS V2R1

Table 2. DFSMShsm: Summary of changed commands in z/OS V2R1
Command name Description and reason for change
DEFINE 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.
Reason for change: Serviceability and usability enhancements
FRBACKUP The ALL subparameter has been added 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.
Reason for change: Multiple Incremental FlashChopy target support
FRRECOV 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.
Reason for change: Fast replication enhancements
LIST 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.
Reason for change: Serviceability and usability enhancements
QUERY The output returned from the QUERY ACTIVE(TCBADDRESS) command has been changed to include the tape volser, device address, and task name.
Reason for change: Serviceability and usability enhancements
SETSYS
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.
Reason for change: Storage tiers support
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.
Reason for change: Migration subtasking support
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.
Reason for change: Serviceability and usability enhancements
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.
Reason for change: Serviceability and usability enhancements

DFSMShsm command changes in z/OS V1R13

Table 3. DFSMShsm: Summary of changed commands in z/OS V1R13
Command name Description and reason for change
ONLYIF More than one value for 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.
Reason for change: DFSMShsm usability enhancements
SETSYS
ONDEMANDMIGRATION parameter indicating that the On Demand Migration function should be used instead of Interval Migration on SMS volumes.
Reason for change: DFSMShsm space management performance improvements
FASTREPLICATION (VOLUMEPAIRMESSAGES(YES|NO)) parameter is added to suppress or display ARC1801 messages.
Reason for change: An easier way to control the ARC1809I messages
RELEASE RECALL(DASD) parameter, used to release recalls from DASD volumes while continuing to hold recalls on tape volumes.
Reason for change: Enhancement to RELEASE RECALL
The default on FASTREPLICATION(PREFERRED | REQUIRED | NONE) has been changed to NONE.
Reason for change: DFSMShsm usability enhancements
Parent topic: DFSMShsm summary of interface changes