Cancel HSM Request dialog box

You use this dialog box to issue the Cancel HSM Request command to cancel active or queued DFSMShsm ("HSM") requests. Unlike other dialog boxes for the Storage Toolkit, the Options tab is not displayed in the Cancel HSM Request command dialog box. This action has no HSM command parameter options to set.

To learn about the standard capabilities of a dialog box, see Standard tabs in the dialog boxes of the Storage Toolkit. The topic includes a link to the Reference guides for commands that are used in the Storage Toolkit.

Parent topic: DFSMShsm actions in the Storage Toolkit

Accessing the Cancel HSM Request feature

The Cancel HSM Request feature is available through the DFSMShsm Status workspace for OMEGAMON® for Storage on z/OS®. You access and use the feature as follows:
  1. Navigate to the DFSMShsm Status workspace in the Navigator.
  2. Access the DFSMShsm Request Details workspace by clicking one of the blue link icons on the left side of the rows in the DFSMShsm Function Status Report table. This workspace includes the DFSMShsm Requests view that lists HSM requests.

    Or

    Access the CRQplex Requests workspace from the DFSMShsm Host Details, HSMplex CRQplex Details, or CRQplex Details workspaces. The CRQplex Requests workspace includes the CRQplex Request Report view.

  3. In the DFSMShsm Requests view or the CRQplex Request Report view, select one or more rows (HSM commands) to cancel.

    Press the Control (Ctrl) key and click multiple rows, as needed.

  4. Right-click on the selected rows to access the context menu.
  5. Select Cancel HSM Request. The Cancel HSM Request dialog box is displayed.
    Note: The menu item is available when all the items that you have selected are either queued or active. If the HSM request is queued, then the Toolkit request executes on the system from which the HSM request originated. If the HSM request is active, then the Toolkit request executes on the system on which the HSM request is processing. If the state of any selected item is complete, abended, or cancelled, the menu is not available.
  6. As needed, enter options in the fields of the General tab, Schedule tab, and JCL tab of the dialog box. Standard tabs in the dialog boxes of the Storage Toolkit describes these tabs.

    Use the Replacement JCL JOB card field in the JCL tab to assign a unique job ID to this job. If you do not do this, the batch job that is submitted to process the HSM cancel request might not run until any job that is currently executing with that job ID completes.

  7. Click OK in the dialog box to confirm your settings. A confirmation dialog box is displayed.
  8. Read the warnings in the confirmation dialog and then click OK, as appropriate.
See Warning about cancellation of HSM requests for further information.

Warning about cancellation of HSM requests

Cancelling HSM requests can have negative consequences. This section introduces some issues that you should consider before cancelling an HSM request. See z/OS DFSMShsm Storage Administration Reference (http://publibz.boulder.ibm.com/epubs/pdf/dgt2s440.pdf) for detailed information about these issues.

  • Active versus stopped: The Cancel HSM Request feature is intended for use when active HSM tasks are suspended. Cancelling an HSM task that is actually moving toward completion might have unintended consequences.
  • Required followup activity: When an HSM RECOVER REPLACE command is cancelled, it might be necessary to reallocate and recatalog the target data set before you issue the HSM RECOVER command again.
  • When duplexing output tapes: There is a limitation in HSM BACKDS processing when output tapes are duplexed. Under some circumstances, processing stops. Cancelling DFSMShsm might be required to release the original tape and tape drive.
  • Backup tasks: Before you cancel a suspended HSM journal backup task, allow any active HSM CS backup tasks to run to completion. If an HSM CDS backup task is also suspended, cancel it before you cancel the HSM journal backup task that is suspended.
  • Common Recall Queue requests: When cancelling an HSM request that is on the Common Recall Queue, the HSM cancel command will be executed on the appropriate z/OS system, which might not be the z/OS system you are viewing in the Navigator. If a CRQ request is in queued status, the HSM cancel command will be executed on the z/OS image from which the request originated. If the CRQ request is active, then the HSM cancel command will be executed on the z/OS system on which the request is being processed. To view the results of this command, you must navigate to the Tivoli® Enterprise Portal Storage Toolkit node under the z/OS system on which the cancel command was executed.