Altering the priority of DFSMShsm queued requests

You can use the DFSMShsm ALTERPRI command to alter the priority of queued requests. You can alter the priority of the following request types: ABACKUP, ARECOVER, BACKDS, BACKVOL, DELETE, FRBACKUP, FREEVOL, FRRECOV, MIGRATE, RECALL, and RECOVER. You cannot alter the priority of BACKVOL CDS commands and requests that have already been selected for processing. You should use the ALTERPRI command to alter the priority of queued requests on an as-needed basis. The ALTERPRI command only works for queued requests and will have no effect on any new requests.

The HIGH parameter of the ALTERPRI command, which is the default, alters the specified request so that it has the highest priority on its respective queue. Conversely, the LOW parameter alters the request so that it has the lowest priority on its respective queue. The mutually exclusive REQUEST, USER, or DATASETNAME parameters indicate which requests DFSMShsm should re-prioritize. (Use the QUERY REQUEST command to determine the request number to issue on the ALTERPRI command.) DFSMShsm re-prioritizes all queued requests that match the REQUEST, USERID, or DATASETNAME criteria specified on the ALTERPRI command.

The BACKVOL STORAGEGROUP, BACKVOL VOLUMES, FRBACKUP DUMP, FRBACKUP DUMPONLY, and FRRECOV DSNAME commands, and requests for single volume recovery from incremental backups, each generate multiple requests, all with the same request number. An ALTERPRI REQUEST command issued to re-prioritize one of these requests alters the priority of all requests generated for the command that are queued at the time of ALTERPRI processing.

Note: To re-prioritize a recall request on the Common Recall Queue, issue the ALTERPRI command on the same host that originated the recall request.

The DATASETNAME keyword is not supported when you issue an ALTERPRI command against a FRRECOV DSNAME request. When an ALTERPRI DSNAME command is issued, and a FRRECOV DSNAME request for the same data set exists on the queue during ALTERPRI processing, the FRRECOV DSNAME request is skipped. To alter the priority of a FRRECOV DSNAME request, use the REQUEST keyword.

The following command alters all requests for a particular data set so that they have the highest priority on their respective queues:

ALTERPRI DATASETNAME(dsname)

The following command alters all requests with a particular request number so that they have the highest priority on their respective queue:

ALTERPRI REQUEST(reqnum) HIGH

The following command alters all requests issued by a particular user so that they have the lowest priority on their respective queues:

ALTERPRI USERID(userid) LOW