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.

Accessing the Cancel HSM Request feature

The Cancel HSM Request feature is available through the DFSMShsm Status workspace for Tivoli OMEGAMON® XE 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.