Cancel HSM Request dialog box
Use 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.
In the General tab you can set name and description values for the action.
In the Scheduling tab you schedule the action in one of the following ways:
- At a specific time and date OR
- At a specific time and days of the week. (Select
the Every check box to enable the action to run every
week on the schedule you specify.) OR
- In a specific time frame, when a specific amount
of time has passed.
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:
- Navigate to the HSM Status workspace in the Navigator. The workspace includes
the HSM Functions Status Report table.
- 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.
- 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.
- Right-click on the selected rows to access the context menu.
- Select Cancel HSM Request.
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.
The Cancel HSM Request dialog
box is displayed.
- As needed, enter options in the fields of the General tab and Scheduling
tab of the dialog box.
- Click OK in the dialog box to confirm your settings.
A confirmation dialog is displayed.
- 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 cause negative consequences for your system.
This section introduces some issues that you should consider before cancelling
an HSM request. See z/OS DFSMShsm(TM) 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 hung.
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, a hang results. Cancelling DFSMShsm might be required
to release the original tape and tape drive.
- Backup tasks: Before you cancel a hung HSM journal
backup task, allow any active HSM CS backup tasks to
run to completion. If an HSM CDS backup task is also
hung, cancel it before you cancel the hung HSM journal backup task.
Managing actions
The following workspaces help you view and manage actions:
- Storage Toolkit Action Requests workspace: The Storage Toolkit Action
Requests workspace of the Storage Toolkit enables you to view and maintain
reports on actions. You select and right-click items in the workspace to access
context menus that allow you to create, submit, delete all, and delete the
items.
- Storage Toolkit Action Requests Summary workspace: The
Storage Toolkit Action Requests Summary workspace provides a link to the Storage
Toolkit Result Summary workspace. As with the principal workspace, you select
and right-click items to select management operations, such as delete. Action
summaries and the data from the running of actions persist until you delete
them.
- HSM Request Details workspace: The HSM Request Details
workspace provides context menus that enable you to select and cancel active
or queued DFSMShsm requests. See Cancel HSM Request dialog box for
more information.