HSM views
For more information about the MainView SRM HSM collector, see Reference for MainView SRM Reporting.
In all DFSMShsm views, use the TIME command to set date and time ranges for the reporting period; however, the HSMDAYS keyword overrides the TIME command and aligns the reported days with the DFSMShsm cycle days. The DFSMShsm cycle begins when HSM AutoBackup runs. MainView SRM retrieves start and end dates and times from the parameters in the MainView TIME command. If you have not set the TIME command, the default time range is 2 days (48 hours) before the current date and time to the current date and time.
Note
For complete keyword descriptions for the SETSRM command, see SETSRM command.
Menu options
The following table describes the options listed under HSM views:
DFSMShsm menu options
Menu option and view name | SETSRM keywords | View description |
|---|---|---|
HSM Tape Mount Activity(HSMTMNT) | HOSTID HSMDAYS VOLUME | Shows tape mounts and demounts that were performed in the HSM address space for the specified time period The data is collected in the MainView SRM HSM database. |
HSM RECYCLE Activity (HSMRCYCL) | DSN GROUP HOSTID HSMDAYS MGMTCLASS SMSIND STGCLASS SYSID TYPE | Shows RECYCLE activity that was performed in the HSM address space during the specified time period with volume and SMS class information The data is collected in the MainView SRM HSM database. |
HSM volume dump activity (HSMVDUMP) | HOSTID HSMDAYS VOLUME | Shows volume dump activity that was performed in the HSM address space during the specified time period The data is collected in the MainView SRM HSM database. |
HSM commands (HSMCMDS) | HOSTID HSMDAYS CMDFLTR | Shows HSM commands that were issued to the HSM address space during the specified time period The data is collected in the MainView SRM HSM database. |
Backup/Recovery Activity (HSMBKRC) | DSN GROUP HOSTID HSMDAYS MGMTCLASS MSGID SMSIND STGCLASS SYSID TYPE | Shows all successful backup and recovery actions that were processed by DFSMShsm during the specified time period and shows age, volumes (from, to, and current), date of last change, and SMS class information |
Daily Activity Summary (HSMDLYAS) | HOSTID HSMDAYS | Shows statistics for DFSMShsm operations over the requested time period The view displays information from the DFSMShsm daily statistics records (DSR) summarized into one row per day, per host. The data is collected in the MainView SRM HSM database. |
Daily Volume Summary (HSMDLYVS) | HOSTID HSMDAYS VOLUME | Shows information for DFSMShsm-managed volumes for the requested time period The view displays information from the DFSMShsm volume statistics records (VSR) summarized by date and volser. These records might be created as frequently as once per hour. The data is collected in the MainView SRM HSM database. |
Data Set Deletions (HSMDSDL) | DSN GROUP HOSTID HSMDAYS MGMTCLASS SMSIND STGCLASS SYSID TYPE | Displays DFSMShsm data set deletions based on entries on the DFSMShsm log file Each entry represents a data set that has been deleted by DFSMShsm for aging or at a user’s request. The view is initially sorted by system ID, data set name, and date and time. Unsuccessful actions are not included. |
Error Summary (HSMERRS) | DSN GROUP HOSTID HSMDAYS MGMTCLASS STGCLASS SMSIND SYSID TYPE | Displays counts of errors that occurred for each return code during migration, recall, and backup activity Successful actions are also counted. Each entry represents the number of DFSMShsm actions that were completed with a specific return code. Return codes with a zero count are not included. To view detailed information about any entry, place the cursor on the field and press Enter. |
Log Entries (HSMLOGE) | DSN GROUP HOSTID HSMDAYS MGMTCLASS SMSIND STGCLASS SYSID TYPE | Displays the entries in the MainView SRM HSM database files that were derived from the DFSMShsm log files Entries are displayed alphabetically by data set. To view data set detail, place the cursor on the data set name and press Enter. |
Migrates (HSMMGAT) | DSN GROUP HOSTID HSMDAYS MGMTCLASS SMSIND STGCLASS SYSID TYPE | Shows all successful migrations processed by DFSMShsm during the specified time period, with aging information, volume information, and DFSMS class information |
Migrates Level 1->2 (HSMMG12D) | DSN GROUP HOSTID HSMDAYS MGMTCLASS SMSIND STGCLASS SYSID TYPE | Shows all successful migrations from level 1 to level 2 that were processed by DFSMShsm during the specified time period, with aging, volume, and DFSMS class information |
Migration Thrashing (HSMMGTH) | DSN GROUP HOSTID HSMDAYS MGMTCLASS SMSIND STGCLASS SYSID TYPE | Shows migration and recall actions for data sets in a manner that makes excessive activity highly visible |
Recalls (HSMRCAL) | DSN GROUP HOSTID HSMDAYS MGMTCLASS SMSIND STGCLASS SYSID TYPE | Shows successful recalls that were processed by DFSMShsm during the specified time period, with aging, volume, and DFSMS class information |
Recall Response Time (SMRCALR) | DSN GROUP HOSTID HSMDAYS MGMTCLASS SMSIND STGCLASS SYSID TYPE | Displays successful recall requests over the time interval, sorted by total response time |
Recall Queue Times (HSMRCALQ) | DSN GROUP HOSTID HSMDAYS MGMTCLASS SMSIND STGCLASS SYSID TYPE | Displays successful recall requests over the time interval, sorted by total time that the request spent waiting to be processed by DFSMShsm |
Automatic Function Run (HSMSPM) | HOSTID SMSIND | Displays log records that are storage by MainView SRM for each run of any of the HSM automatic functions, including primary space management, secondary space management, automatic backup, automatic dump, and interval migration Each record indicates SUCCESSFUL or UNSUCCESSFUL run of an automatic function by DFSMShsm. The counts of volumes processed, volumes unprocessed, and space moved during the function are displayed. The HSM collector, SVHSM, must be active during the entire run of the automatic function for statistics to appear for the run. |
HSM Text Messages (HSMMSG) | DSN GROUP HOSTID HSMDAYS MSGID MGMTCLASS RC SMSIND STGCLASS SYSID TYPE | Displays all text messages that are issued by DFSMShsm Fields from the message text are parsed into individual columns in the view so that you can filter on message number, data set name, volume, age, and other message contents. |
Host Status (HSMSTAT) | None | Displays information about each HSM host to which MainView SRM is currently connected For information about establishing a connection between MainView SRM and DFSMShsm, see Customizing MainView SRM products. |
Current Recall Queue (HSMRQUE) | None | Displays recall requests that have been received by DFSMShsm but have not yet been processed This real-time view is based on a recall queue VSAM data set that is defined by the SMMSYSxx SET keyword HSMRQ_VSAM. The view includes information about recalls that were requested but not yet completed on all HSM hosts that share the recall queue file. In this view, you can issue a CANCEL line command to cancel the recall requests that originated on the current system but have not yet executed. |
Current Recall Systems (HSMRQSYS) | None | Displays the list of system IDs of all systems that share the Recall Queue VSAM data set that is defined in the SMMSYSxx master SET keyword HSMRQ_SCOPE |
Log Database (HSMLOGDB, HSMDBZ) | None | Displays the list of VSAM data sets that are allocated to the HSM collector for storing DFSMShsm log records The view provides the current status of each VSAM data set in the HSM collector database. |
DFHSM Output Mgmt (HSMOMDS) | None | Lists the data sets that contain DFSMShsm messages and DFDSS messages Each data set that is listed on HSMOMDS has one or more members associated with it. These members contain the messages from DFSMShsm or DFDSS that pertain to specific areas, such as backup or migration. Select one of the data sets to advance to the HSMOMDS EZCmd Menu (HSMOMDSZ). In HSMOMDSZ, you can choose to delete the data set or display the members in the data set on view HSMOMML. |
DFHSM Module Check (HSMMDCMP) | None | Displays information about the modules that are an interface between DFSMShsm and MainView SRM Error conditions can occur if the modules that are available to DFHSM are different from the same modules within the MainView SRM address space. This view helps you determine any discrepancies between MainView SRM and DFHSM as they pertain to module availability and module release/version levels. If the Module Status column contains a value other than MATCHES or UNAVAIL, hyperlink on the Module Name column to investigate the problem further. This view requires access to the CSVDYNL interface. Contact your security administrator to grant READ access to the User ID for the SVOS address space. The facility is 'CSVDYNL.*.TEST'. |
DFHSM CDS Status (HSMCDSST) | None | Displays the data set information for each of the DFHSM CDS files and the MainView SRM recall queue |
Masking examples
DSN: SYS/ selects all data sets that begin with SYS and contain any additional characters.
VOLSER: ABC* selects all volsers that begin with ABC and contain any additional characters.
Views not available through menu options
The following views are not accessed directly from the DFSMShsm Menu. See each section for the procedure to access the views.
HSM text message error summary
The HSM Message Error Summary view displays selected text messages issued by DFSMShsm summarized by return code and reason code.
Use the following procedure to access the view:
HSM text message error display
The return code, reason code, and data set name fields are displayed as the first fields in the view, providing the information needed to research DFSMShsm errors.
Use the following procedure to access the view:
- Place the cursor on a return code in the RC field and press Enter to display the HSMMSGE tabular view for the specified return code.
HSM EZcmd menu options
The following table lists in alphabetical order all HSM EZCmd menu options. All options are not available on all EZCmd menus.
For an explanation of any field or column on a view, place your cursor over the field or in the column and press F1 to access online Help.
HSM EZCmd menu options
Option/command | Description |
|---|---|
Backup Data Set | Select this option to advance to a data-entry panel where you specify:
If you specify a unit, you must also specify the volume. |
Data Set List Catalog | Select this option to display catalog list information (IDCAMS LISTCAT) for the data set. |
Delete a Tape | Select this option to advance to a data-entry panel where you specify the volume serial number of the tape that you want to delete and whether you want to wait for the DFSMShsm command to complete or allow it to run in the background. |
Delete Backup Copy | Select this option to advance to a data-entry panel where you specify the name of the backup data set you want to delete, the version of the backup data set (0-999 or All), and the volume on which the backup data set is stored. |
Delete Migrated Copy | Select this option to advance to a data-entry panel where you specify the name of the backup data set you want to delete, whether you want to wait for the DFSMShsm command to complete or allow it to run in the background, and whether you want to purge the data set. |
Detail Data Set Info | Select this option to advance to a report that displays information about the data set such as creation date, expiration date, and last reference date. |
Display Error Details | Select this option to advance to the error details view, which displays unsuccessful DFSMShsm actions that are recorded on the DFSMShsm log file. The view is initially listed by data set name within functional category. Only unsuccessful actions are included. DFSMShsm actions are grouped into the following functional categories:
|
Display HSM Messages | Select this option to advance to the DFSMShsm messages view, which displays messages that are generated by DFSMShsm. |
Display Migration Thrashing Details | Select this option to advance to the migration thrashing details view, which displays detailed information for the migration and recall activity of a selected data set. |
Display QuickRef Messages | Select this option to advance to the ChicagoSoft MVS/QuickRef messages display. |
List Backup Versions | Select this option to advance to a list of all DFSMShsm data set backup entries for the data set that you selected. Choose one of the backup versions to advance to an EZcmd Menu, where you can choose to delete the backup copy, recover using the backup copy, or see a detail view for the backup (see the following explanations for these options). |
Migrate Data Set | Select this option to advance to a data-entry panel where you specify the name of the data set you want to migrate, the migration level (1 or 2), and whether you want to wait for the DFSMShsm command to complete or allow it to run in the background. |
Recall Data Set | Select this option to advance to a data-entry panel where you specify the name of the data set you want to recall, whether you want to wait for the DFSMShsm command to complete or allow it to run in the background, the unit name for the volume (3380, 3390, or 9345), and if you specify a unit, you must also specify the volume. |
Recover From Backup | Select this option to advance to a data-entry panel where you specify the backup data set name, the backup generation number (0-12), the date the backup was created, the volume on which the backup is stored, the password for the data set if it is password-protected, and indicate whether you want to replace any existing data set with the same name. |
Recycle a Tape | Select this option to advance to a data-entry panel where you specify the volume serial number of the tape that you want to recycle and whether you want to wait for the DFSMShsm command to complete or allow it to run in the background. |
Unassign a Tape | Select this option to advance to a data-entry panel where you specify the volume serial number of the tape that you want to unassign and whether you want to wait for the DFSMShsm command to complete or allow it to run in the background. |
Comments
Log in or register to comment.