1 The Toolkit(s)

The tables below describe the tools you need to manage HSC and VTCS, grouped by the interface. For more information about the tools, see ELS Command, Control Statement, and Utility Reference.

Note:

Important: Register for HIPER Notifications. To help you stay current on maintenance and to proactively avoid problems, Oracle publishes HIPER Notifications as Knowledge Base Alert documents. You can retrieve the full list of HIPER Notifications by searching for keyword "HIPER" from the My Oracle Support (MOS) home page. You should also register to receive new HIPER Notification Alert documents automatically by MOS Hot Topics E-mail. Knowledge Base article 793436.1, searchable by number from the MOS home page, explains the Hot Topics E-mail feature and how to subscribe. Be sure to add all Oracle StorageTek products of interest to your Hot Topics E-mail profile. Simply click Add to include a specific product, then choose a product from the list that appears when you type StorageTek in the Product field on the Add Product box. Be sure to check the Alert document type as you select each product.

The HSC Toolkit

Table 1-1 HSC Operator Commands

Command:	Function:	See This Topic:
CDS ENABLE/DISABLE	Switches, expands, or moves CDS copies.	"Manually Switching to Another CDS Copy"
COMMPATH	Changes communications settings.	"Adding Scratch Volumes"
DISPLAY ACS	Displays the status of your ACSs, which includes hardware statuses for the ACSs, LMUs, and stations; and scratch volumes and free cells available.	"Managing ACSs"
DISPLAY ALL	All of DISPLAY ACS plus LSM and CDS status.	"Managing ACSs"
DISPLAY CAP	Displays CAP information.	"Adding Scratch Volumes"
DISPLAY EXCEPTNS	Displays library hardware problems.	"Managing Library Hardware"
DISPLAY LSM	Displays LSM status.	"Entering Cartridges"
DISPLAY SCRATCH	Displays scratch count information based on subpools.	"Adding Scratch Volumes"
DISPLAY THRESHLD	Displays threshold values set by the Warn command.	"Adding Scratch Volumes"
DISPLAY VOLUME	Displays physical volume information.	"Errant and Selected Volumes"
EJECT	Ejects up to 9999 cartridges.	"Entering Cartridges"
ENTER	Enters one or more volumes.	"Entering Cartridges"
MNTD AUTOCLN EJCTAUTO	Determines automatic drive cleaning and automatic ejection of cleaning cartridges that have exceeded their MAXCLEAN value.	"Managing Cleaning Cartridges"
MODIFY	Changes LSM and CAP state.	"Managing ACSs" "Adding Scratch Volumes"
OPTION ENTDUP	Determines the response to entering duplicate volumes.	"Entering Duplicate Volumes"
RELEASE	Releases a CAP and makes it available for use.	"Freeing An Allocated CAP"
SMC RESYNCH	Redrive lost mounts.	"Adding Scratch Volumes"
SCRATCH	Scratches specific volumes.	"Adding Scratch Volumes"
UNSCRATCH	Unscratches specific volumes.	"Adding Scratch Volumes"
WARN	Establishes scratch warning threshold values.	"Adding Scratch Volumes"

Table 1-2 HSC PARMLIB Control Statements

Control Statement:	Function:	See This Topic:
CDSDEF	Specifies data set names of CDS copies.	"Expanding the CDS" "Renaming a CDS" "Relocating a CDS"

Table 1-3 HSC Utilities (SLUADMIN unless indicated otherwise)

Utility:	Function:	See This Topic:
BACKUP	Backs up the primary CDS.	"Using the BACKup Utility to Back Up the CDS"
FMTLOG	Pre-formats log files.	"Managing CDS Logging"
LOGUTIL	Uses log files to help recover the CDS.	"Restoring the CDS from a Backup Copy"
OFFLOAD LOGFILE	Offloads transactions from any current log files and activates new log files.	"Managing CDS Logging"
RESTORE	Restores the CDS from a backup copy.	"Restoring the CDS from a Backup Copy"
Scratch Conversion(SLUCONDB)	Updates the HSC scratch list from the TMS scratch list.	"Adding Scratch Volumes"
SCREDIST	Balances the number of scratch volumes between specified LSMs in an ACS. Provides an option to balance by subpool.	"Adding Scratch Volumes"
SET LOGFILE	Specifies log file data sets.	"Managing CDS Logging"
SET VOLPARM	Defines all types of volumes and pools.	"Adding Scratch Volumes" "Defining Nearline Volumes" "Adding Scratch Volumes"
PITCOPY	Backs up the primary CDS (point in time).	"Using PITCOPY to back up the CDS"
UNSELECT	Resets volume selected status.	"Errant and Selected Volumes"
VOLRPT	Provides physical volume reports.	"Using a Volume Report"

Table 1-4 Diagnostics

Diagnostic Tool:	Function:	See This Topic/Document:
Generalized Trace Facility	The Generalized Trace Facility (GTF) provides a low level history of the recent past.	"Adding Scratch Volumes"
Supervisor Call and Abnormal End Dumps (ABEND)	SVC and ABEND dumps are taken where appropriate to diagnose software failures.	"Adding Scratch Volumes"
Error Recording Data Set Records	Software failures are logged into these error recording data sets. 4480 Cartridge Subsystem and 3278 Terminal Subsystem Error Recording Data Set (ERDS) records are written by MVS routines.	"Adding Scratch Volumes"
HSC LIST Command	The LIst command is used to display an HSC data structure and to provide for diagnostic support for the HSC. Use this command under the direction of Oracle support personnel.	ELS Command, Control Statement, and Utility Reference

Table 1-5 HSC Performance Tools

Performance Tool:	Function:	See This Topic:
Activities report	Produces a detailed report identifying performance values for various library activities.	"Optimizing Mount Performance"
Scratch Redistribution utility	Redistributes scratch volumes across the LSMs within a specific ACS.	"Optimizing Mount Performance" "Adding Scratch Volumes"
WARN command	Establishes thresholds which control when HSC notifies the operator of an insufficient quantity of scratch cartridges in an ACS.	"Adding Scratch Volumes"
CAPPREF command	Specifies preference values for CAPs.	"Adding Scratch Volumes"
SMF records	Logs ACS activity and performance data for analysis.	"Optimizing Mount Performance"

The VTCS Toolkit

Table 1-6 The VTCS Toolkit

Command:	Function:	See This Topic/Document:
AUDIT	Updates the MVC and VTV information in the HSC CDS.	"Changing RTD Device Types" "Changing RTD Device Types" "Logically Dismounting VTVs in an Offline VTSS"
DELETSCR	Deletes scratch VTVs from VTSSs and unlinks any migrated VTVs from MVCs	"Doing Demand MVC Space Reclamations"
DISPLAY	Displays the status of All Things VTCS and, as such is one of your Primary tools.	"Checking Virtual Tape Status (Daily)" "Checking Virtual Tape Status (Daily)" "Doing Demand MVC Space Reclamations" "Doing Demand MVC Space Reclamations" "Poor VTV Mount Performance" "Poor VTV Mount Performance" "RTD/MVC Failures" "Poor VTV Mount Performance"
MIGRATE	Demand migrates VTVs to MVCs.	"Doing Demand MVC Space Reclamations"
MVCDRAIN	Recalls all current and scratched VTVs from an MVC and, optionally, ”virtually” ejects the MVC (makes it unavailable for VSM use without physically ejecting it from the library).	"Doing Demand MVC Space Reclamations"
MVCMAINT	Sets MVC attributes.	"Changing RTD Device Types"
MVCPLRPT	Manages your MVCPOOLS and Storage Classes.	ELS Command, Control Statement, and Utility Reference
MVCRPT	Reports the status of your VSM system's MVCs and is Primary Wellness Meter #2.	"Checking Virtual Tape Status (Daily)" "Doing Demand MVC Space Reclamations" "Using PITCOPY to back up the CDS" "Fixing Common Problems"
RECALL	Does demand VTV recalls.	"Doing Demand MVC Space Reclamations"
RECLAIM	Does demand MVC space reclamation.	"Doing Demand MVC Space Reclamations"
RECONCIL	Reconciles VTV media and location (moves VTVs from one Storage Class to another).	"Working with VTSSs"
The RTV utility	Converts VTVs contained on MVCs to data sets on Nearline volumes (real tape volumes).	"Fixing Common Problems"
SET MIGOPT	Changes the following migration parameters: Maximum and minimum concurrent automatic migration, immediate migration, and migrate-to-threshold tasks. High and low AMTs.	"Checking Virtual Tape Status (Daily)" "Doing Demand MVC Space Reclamations"
VARY RTD	Changes RTD state	"Checking Virtual Tape Status (Daily)" "Working with VTSSs"
VARY VTSS	Changes VTSS states on all hosts.	"Working with VTSSs"