# 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 HSM Status workspace for Tivoli OMEGAMON® XE for Storage on z/OS®. You access and use the feature as follows:

1. Navigate to the HSM Status workspace in the Navigator. The workspace includes the HSM Functions Status Report table.
2. Click one of the blue link icons on the left side of the rows in that HSM Functions Status Report table.

   The HSM Request Details workspace is displayed. This workspace includes the HSM Requests view that lists HSM requests.

3. In the HSM Requests 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 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.