You can prevent all or part of DFSMShsm’s functions from running
without stopping DFSMShsm. You can also interrupt all or part of the
functions after they have begun running. For those functions that
process on a volume basis (backup, dump, migration, and recover),
you can choose whether to interrupt the function at the end of the
data set currently being processed or at the end of the volume currently
being processed. You use the HOLD command to prevent or interrupt
DFSMShsm processing.
To prevent or interrupt all DFSMShsm processing, issue the following
command:
HOLD ALL
Note: HOLD ALL does not
control the hold level of the common recall queue (CRQ) placement
and selection functions. To place a hold on the CRQ, specify HOLD
COMMONQUEUE, with its optional subparameters.
To queue all aggregate backup processing and prevent any new commands
from being processed, issue the following command:
HOLD ABACKUP
To queue all aggregate recovery processing and prevent any new
commands from being processed, issue the following command:
HOLD ARECOVER
To interrupt AUDIT command processing after it finishes the current
data set, issue the following command:
HOLD AUDIT
To interrupt or prevent all backup processing, issue the following
command:
HOLD BACKUP
Backup is held by this command at the end of the data set currently
being processed.To hold automatic backup processing but allow command
backup processing, issue the following command:
HOLD BACKUP(AUTO)
Automatic backup is stopped by this command at the end of the data
set currently being processed, but command backup processing continues
and is allowed to start new data sets or volumes.
To interrupt or prevent backup processing at the end of the volume
currently being processed, issue the following command:
HOLD BACKUP ENDOFVOLUME
To specify that a host should neither place
requests on nor select requests from the common recall queue, issue
the following command. After you issue HOLD COMMONQUEUE, any requests
already in the CRQ remain available for processing by hosts that are
connected to the CRQ. If no CRQ hosts are available, and the request
is a WAIT, it fails. The originating host processes all recall requests
that are received after you issue HOLD COMMONQUEUE.
HOLD COMMONQUEUE or HOLD COMMONQUEUE(RECALL)
To specify that the host should not place any additional requests
onto the CRQ, issue the following command. After you issue this command,
the host places all new recall requests in the local queue and continues
to select requests to process from the CRQ. The host selects the highest
priority request available in the local and common recall queues.
When the highest priority request in the local queue and the highest
priority request in the CRQ match, the host selects the request from
the local queue. If you specify this command on all hosts, then all
hosts place new recall requests in the local queue, but continue to
select requests to process from the CRQ.
HOLD COMMONQUEUE(RECALL(PLACEMENT))
To specify that a host should continue to place but not select
recall requests in the CRQ, issue the following command. After you
issue this command, if a host places a request in the local queue
because the CRQ is unavailable, the host processes that request. If
you specify this command on all hosts, all WAIT requests in the CRQ
fail because no host is available to process them.
HOLD COMMONQUEUE(RECALL(SELECTION))
To prevent or interrupt dump processing, issue the following command.
Dump processing stops at the end of the volume currently being processed.
HOLD DUMP
To prevent or interrupt automatic dump processing, issue the following
command. Automatic dump processing stops at the end of the volume
currently being processed. Processing initiated by DUMP commands is
allowed to start.
HOLD DUMP(AUTO)
To specify no data movement, issue the following command.
Note: The SETSYS EMERGENCY command does not affect the placement
of recall requests onto the common recall queue by the host with the
command in effect, as other active hosts can process those requests.
SETSYS EMERGENCY
To interrupt dump processing at the end of the current unit of
work being processed (typically a number of tracks or a cylinder),
issue the following command:
HOLD DUMP ENDOFDATASET
To interrupt expiration of backup
data sets by the EXPIREBV command, issue the following command. Expiration
of backup versions ends when the data set that is being processed
expires.
HOLD EXPIREBV
To prevent fast replication from processing any new FRBACKUP commands,
issue the following command. No new fast replication backup commands
are selected for processing.
HOLD FRBACKUP
To prevent fast replication from processing any new FRRECOV commands,
issue the following command. No new fast replication recover commands
are selected for processing.
HOLD FRRECOV
To interrupt or prevent processing by the LIST command, issue the
following command. LIST command processing stops immediately. This
command can be useful if a list command is returning a large amount
of data to your terminal and you want to interrupt the process. In
such a case, the operator may be required to issue the HOLD command.
HOLD LIST
You can prevent DFSMShsm from making entries in the DFSMShsm log.
Even though the log entries are prevented, DFSMShsm continues to make
entries in the activity logs. To prevent entries into the DFSMShsm
log, issue the following command:
HOLD LOG
To interrupt or prevent all migration processing, issue the following
command. All migration stops at the end of the data set currently
being processed.
HOLD MIGRATION
To interrupt or prevent only automatic volume space management
and automatic secondary space management, issue the following command.
Automatic volume space management and automatic secondary space management
stops at the end of the data set currently being processed, but migration
caused by commands is allowed to start.
HOLD MIGRATION(AUTO)
To interrupt migration at the end of the volume currently being
processed, issue the following command:
HOLD MIGRATION ENDOFVOLUME
To prevent all recall processing, including no more processing
from an already mounted migration tape, issue the following command.
Note: In a common recall queue (CRQ) environment, with the HOLD
RECALL command in effect, the host is not eligible to select requests
from the CRQ.
HOLD RECALL
To prevent all recall processing from tape volumes (except those
from already mounted migration tapes) but allow recall processing
from DASD volumes, issue the following command.
Note: In
a CRQ environment, with the HOLD RECALL(TAPE) command in effect, the
host is not eligible to select requests requiring tape from the CRQ.
HOLD RECALL(TAPE)
To prevent recall processing from tape volumes when the RECALL
command is issued by a TSO user but to allow all other recall processing,
issue the following command.
Note: In a CRQ environment,
with the HOLD RECALL (TAPE(TSO)) command in effect, the host is not
eligible to select requests requiring tape and TSO from the CRQ.
HOLD RECALL(TAPE(TSO))
To prevent all recover processing, including no more processing
from an already mounted backup tape, issue the following command:
HOLD RECOVER
To prevent recover processing for data sets on tape backup (except
those from already mounted backup tapes) and dump volumes but to allow
recover processing for data sets on DASD backup volumes, issue the
following command:
HOLD RECOVER(TAPEDATASET)
To interrupt or prevent recycle processing, issue the following
command. Recycle processing stops at the end of the data set being
processed.
HOLD RECYCLE
To interrupt or prevent REPORT command processing, issue the following
command:
HOLD REPORT