Examples of how to code the HOLD command

The following examples present different ways to code the HOLD command.

Note: Any values specified here are only examples and should not be interpreted as the values to be used for your system.

Preventing space management and recall

In this example, DFSMShsm prevents processing of automatic space management, space management by command, and recall and deletion of migrated data sets.
   HOLD MIGRATION RECALL

Preventing all DFSMShsm functions and logging

In this example, DFSMShsm prevents processing of all DFSMShsm functions, including logging.
   HOLD ALL LOG

Ending the report function

In this example, DFSMShsm stops the report function at the end of the current unit of work. No more REPORT commands are started.
   HOLD REPORT

Ending all recalls from tape

In this example, DFSMShsm stops all recalls from tape.
   HOLD RECALL(TAPE)

Ending all recalls from tape submitted by an interactive TSO user

In this example, DFSMShsm stops all recalls from tape submitted by an interactive TSO user. DFSMShsm allows recalls from tape that are submitted from a batch job to process.
   HOLD RECALL(TAPE(TSO))

Preventing placement and selection of recall requests in the CRQ

In this example, DFSMShsm prevents the host from placing recall requests in the common recall queue (CRQ) and selecting recall requests from the CRQ.
   HOLD COMMONQUEUE(RECALL)

Preventing placement of recall requests in the CRQ

In this example, DFSMShsm prevents the host from placing recall requests in the CRQ, but the host selects recall requests for processing from the CRQ.
   HOLD COMMONQUEUE(RECALL(PLACEMENT))

Preventing selection of recall requests from the CRQ

In this example, DFSMShsm prevents the host from selecting recall requests for processing from the CRQ, but the host places recall requests in the CRQ.
   HOLD COMMONQUEUE(RECALL(SELECTION))

Ending all tape copying

In this example, DFSMShsm stops all tape copying.
   HOLD TAPECOPY

Ending all tape replacement

In this example, DFSMShsm stops all tape replacement.
   HOLD TAPEREPL

Preventing backup function from running

In this example, DFSMShsm prevents the backup function from running.
   HOLD BACKUP

Preventing the fast replication backup function from running

In this example, DFSMShsm prevents new FRBACKUP commands from processing. When you issue this command, DFSMShsm completes any FRBACKUP requests that have already started.
   HOLD FRBACKUP

Preventing the fast replication recovery function from running

In this example, DFSMShsm prevents new FRRECOV commands from processing. When you issue this command, DFSMShsm completes any FRRECOV requests that have already started.
   HOLD FRRECOV

Preventing the automatic volume and automatic secondary space management functions from running

In this example, DFSMShsm prevents the automatic volume and automatic secondary space management functions from running. Command migration can still run.
   HOLD MIGRATION(AUTO)

Preventing processing of a specific function at the end of the data set

In this example, DFSMShsm stops backup processing at the end of the data set currently being processed.
   HOLD BACKUP ENDOFDATASET

Preventing dump processing

In this example, DFSMShsm prevents the dump function from running. Dumps currently in progress complete.
   HOLD DUMP
Note: This is equivalent to HOLD DUMP ENDOFVOLUME.

Ending dump processing

In this example, DFSMShsm stops all dumps the next time DFSMSdss reads or writes a record. Dumps in progress are stopped and invalidated.
   HOLD DUMP ENDOFDATASET

Preventing automatic dump processing

In this example, DFSMShsm prevents the automatic dump function from running. Any automatic dumps currently in progress complete, but no new automatic dumps start. Command dumps can still run.
   HOLD DUMP(AUTO)

Preventing the expire backup versions function from running

In this example, DFSMShsm stops deleting backup versions at the end of the current data set.
   HOLD EXPIREBV

Preventing aggregate backup

In this example, DFSMShsm stops backing up aggregated data sets after completion of any currently running aggregate backup.
   HOLD ABACKUP(PAY1) EOD

Preventing aggregate recovery

In this example, DFSMShsm stops recovering aggregated data sets after completion of any currently running aggregate recovery.
   HOLD ARECOVER(PAY1.C.C01V0001)

Preventing automatic backup and command data set backups to DASD

In this example, DFSMShsm holds automatic backups and command data set backups directed to ML1 DASD. Command data set backups to tape continue processing.
   HOLD BACKUP(AUTO DSCOMMAND(DASD))

Preventing automatic backup and command data set backups to tape

In this example, DFSMShsm holds automatic backups and command data set backups directed to tape. Command data set backups to ML1 DASD continue processing.
   HOLD BACKUP(AUTO DSCOMMAND(TAPE))

Interrupting command data set backup to change output tapes

In this example, you have tapes that are scheduled to be taken offsite for disaster backup and you need to switch the output tapes used by command data set backup.
   HOLD BACKUP(DSCOMMAND(SWITCHTAPES))