Space banner

   

This space provides the same content as before, but the organization of the home page has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

HSM views

This topic summarizes the MainView SRM HSM view options from which you can select, as well as the SETSRM keywords that are available for each option and a description of the resulting view.

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.

For more information about the HSM views, see:

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

You can use masking in the following ways:
  • 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:

  1. Select HSM Text Messages from the DFSMShsm Menu.
  2. Filter the HSMMSG view for either ARC0734I, ARC1001I, or some other HSM message that indicates an error.
  3. After the HSMMSG view is displayed, enter FORM HSMMSGEZ on the COMMAND line; then press Enter.

The HSMMSGEZ view displays a row of data for each unique return and reason code combination. To drill down further, see HSM views.

HSM text message error display

The HSM Text Message Error Display is a tabular view that displays all of the DFSMShsm text messages associated with a selected return code and reason code from the HSMMSGEZ view.

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:

  1. Select HSM Text Messages from the DFSMShsm Menu.
  2. Filter the HSMMSG view for either ARC0734I, ARC1001I, or some other HSM message that indicates an error.
  3. After the HSMMSG view is displayed, enter FORM HSMMSGEZ on the COMMAND line; then press Enter.
  4. 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

Many of the DFSMShsm options advance to EZCmd menus, which list commands that you can select to perform an action on a data set or other item you chose from a list view.

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:

  • The name of the data set to back up

  • 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)

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:

  • Migration

  • Recall

  • Backup

  • Recovery

  • Dump

  • Restore

  • Other

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.




Was this page helpful? Yes No Submitting... Thank you

Comments