Storage Toolkit
This topic describes the Storage Toolkit feature, which enables you to use actions in the Tivoli® Enterprise Portal. The Storage Toolkit actions provide convenient access to mainframe operations that let you target resources such as volumes and mainframe data sets. For example, you use the actions to migrate data sets or release free space.
The Situation Storage Toolkit Extension enhancement provides you with the ability to associate a Storage Toolkit command with a situation. This means that the Storage Toolkit command will be run when the situation becomes true. All of the capabilities of the Storage Toolkit can now be associated with a situation including the ability to issue custom commands, batch JCL, and Storage Toolkit generated commands. See Associating Storage Toolkit commands with situations for more information.
- DFSMSdss (Device Support Services)
- DFSMShsm (Hierarchical Storage Manager)
- ICKDSF (Device Support Facilities)
- IDCAMS (Access Method Services)
- DFSMSrmm (DFSMS Removable Media Manager)
- Mainframe (z/OS console command)
- TSO (Time Sharing Option)
Storage Toolkit menus and dialog boxes
This section describes the actions that are available in the context menus of the Storage Toolkit.
To access the actions, you select and right-click rows in the workspaces that have action menus. A context menu is displayed where you now select an item such as Dataset Actions. Then you choose the appropriate action from the submenu. When you select an action, a dialog box is displayed where you configure the action and submit the request.
- Create Command
- Create Batch Job
- Submit Command or Job
- Select the target resources in the Tivoli Enterprise Portal.
- Right-click and select Dataset Actions > Migrate.
- Configure the command.
- Submit the request. The Migrate command is issued against each resource.
- Custom commands and jobs
Name of menu item Corresponding dialog box Create Batch Job Create Batch Job dialog box Create Command Issue Command dialog box Submit Command or Job Submit Command or Job dialog box - Actions related to volumes that are displayed in workspaces of the Tivoli Enterprise Portal
Name of menu item Corresponding dialog box Backup Volume Backup dialog box Convert Volume Conversion dialog box Migrate Volume Migration dialog box Release Space Volume Space Release dialog box Compress Compress dialog box Defrag Defrag dialog box - Actions related to data sets that are displayed in workspaces of the Tivoli Enterprise Portal
Name of menu item Corresponding dialog box Backup Dataset Backup dialog box Migrate Dataset Migration dialog box Move & Copy Dataset Copy and Move dialog box Recall Dataset Recall dialog box Recover Dataset Recover dialog box Release Space Dataset Space Release dialog box Compress Dataset Compress dialog box Print Print dialog box Allocate Dataset Allocate dialog box Rename Dataset Rename dialog box Alter Dataset Alter dialog box Delete Dataset Delete dialog box Listcat Dataset Listcat dialog box Repro Dataset Repro dialog box Verify Dataset Verify dialog box Catalog Dataset Catalog dialog box Uncatalog Dataset Uncatalog dialog box Define Cluster Dataset Define Cluster dialog box - Actions related to data set attribute groups that are displayed in workspaces of the Tivoli Enterprise Portal
Name of menu item Corresponding dialog box Extract Attributes Dataset Attribute Group Extract dialog box - Actions related to DFSMShsm
Cancel HSM Request dialog box. The menu item that corresponds to this dialog box is available when all the selected items are either queued or active. If the state of any selected item is complete, abended, or cancelled, the menu is not available.
- Actions related to DFSMSrmm
Name of menu item Corresponding dialog box Actions related to DFSMSrmm-related data sets Add Dataset Add Dataset dialog box Change Dataset Change Dataset dialog box Delete Dataset Delete Dataset dialog box Actions related to DFSMSrmm-related owners Add Owner Add Owner dialog box Change Owner Change Owner dialog box Delete Owner Delete Owner dialog box Actions related to DFSMSrmm-related volumes Add Volume Add Volume dialog box Change Volume Change Volume dialog box Confirm Actions Confirm Actions for All Volumes dialog box Delete Volume Delete Volume dialog box Actions related to DFSMSrmm-related VRS resources Add VRS Add VRS dialog box Change VRS Change VRS dialog box Delete VRS Delete VRS dialog box
The documentation for the z/OS operating system includes reference information for the commands and parameters that the Storage Toolkit uses. You can access documentation for the version of z/OS that you use through the following Web page: http://www-03.ibm.com/systems/z/os/zos/ |
How the Storage Toolkit processes action requests
All actions, not only the actions that submit user-defined JCL streams, run as batch jobs on the z/OS system. Each type of command has a batch job interface which the Storage Toolkit uses to execute the action. The JCL for each command type is defined by PARMGEN and is subsequently used to run the command. PARMGEN is also used to define a default JOB card which is applied to each batch job, but can be overridden with a custom JOB card that you provide on the Storage Toolkit dialog box.
When you submit an action request, the Storage Toolkit starts a thread on z/OS to handle the execution of the request. The thread generates the JCL, substituting values for variables and expanding )DOT )ENDDOT clauses, submits the batch job for execution using the MVS™ Internal Reader, and waits for its completion. At the beginning of each JCL stream, the Storage Toolkit inserts a step that executes code to monitor the rest of the steps in the job. As each step completes, this code collects command output or, in the case when your request is to run user-defined JCL, it collects the contents of corresponding data sets and DD names that you specified be copied for later viewing. DD names that are routed to a SYSOUT class are not collected until the final job step.
At the end of each JCL stream, the Storage Toolkit adds a final step that also executes Storage Toolkit code. The code in the final step collects SYSOUT from each step where it was requested, collects the return code of the batch job, and optionally, collects the JES output. Additionally, it notifies the Storage Toolkit thread that the batch job is complete. The thread then stores the results of the execution into the checkpoint database and terminates.
To accomplish this, the Storage Toolkit thread creates temporary data sets to contain the JCL, the results of the batch job and other files. The data sets are transient and are shared between the thread and the batch job. When the batch job completes, the data sets are deleted.
Activities required to process your request are executed under a security environment that the Storage Toolkit establishes using your Tivoli Enterprise Portal user ID. Because the security environment is established on the z/OS system where the monitoring agent runs, your portal user ID must match your mainframe ID on that system. If this ID is not a valid mainframe user ID, a security environment cannot be established and the action request fails.
- Create and access all temporary data sets required by the batch job.
- Submit the batch job.