End of support This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.

VSCAN collections

Use the VSCAN collections options to view the VTOC scan collection data sets, view recent VTOC scan activity, and view and update PARMLIB members.

For more information about the VTOC scan collection data sets and filter members, see the Reference-for-MainView-SRM-Reporting. For information about the audit log files, see Using-MainView-SRM-products.

Note

You can use one of the following VSCAN primary command formats on the WBVTOC view to initiate a VTOC scan:

  • VSCAN xx

The variable xx is the suffix of the SMVSCFxx member that contains the filter keywords that are to be used in the scan.

  • VSCAN SUF=xx,keywords

The variable keywords overrides one or more filter keywords that are contained in the default SMVSCFxx member.

For more information about VSCAN filter commands, examples, and initiating VTOC scans, see the Reference-for-MainView-SRM-Reporting.

The following table summarizes each VSCAN collections option and its corresponding SETSRM keywords, action line commands, and EZCmd menus. 

Note

  • For complete keyword descriptions for the SETSRM command, see SETSRM-command
  • 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.

 VSCAN collection options

Menu option

Description

SETSRM keywords

Action line commands

EZCmd menu

Collection Data Sets

Advances to the WBVTOC view.

This view displays cataloged VTOC scan collection data sets and the inflight and aborted scans from the current MainView SRM execution. MainView SRM obtains the cataloged data sets using the VSCAN_OINDX setting in the active SMMSYS PARMLIB member.

The collection data sets are displayed according to the filter member suffix.

None

B—Browse

DET—Detail

DEL—Delete

DSN—Data set level statistics

E—Edit

G—Retrieve control record

P—Group and pool statistics

V—Volume level statistics

WBVTOCZ

VSCAN Activity Log

Advances to the LOGREC view.

This view displays records from the MainView SRM audit log files. When initiated from this link, filters are specified so that only VTOC scan activity records are displayed. A record is written to the audit log files when a VSCAN request is received and when a VSCAN request ends. The audit record contains the filter member that was used, the collection data set, and other information. For information about the audit log files, see Using-MainView-SRM-products.

DATETIME

None

None

VSCAN Filter Members

Advances to the ADMEM view.

Use this view to display and update MainView SRM PARMLIB members. Action line commands enable you to make changes to PARMLIB members. Press F1 in the CMD column to display online Help that describes each action line command.

None

R—Refresh

E—Edit

B—Browse

D—Display

N—Create

/—Display contents of storage

ADMEMZ

Data Set Filtering

Advances to the WBVTOCD view by way of the VTOC Scan Data Set Filter dialog.

Use the VTOC Scan Data Set Filter dialog to specify the filtering criteria that is used to produce the reports that are available for selection.

In the VTOC Scan Data Set Filter dialog, you can specify any or all of the parameters. Use the OP fields to set comparison operators for the values that you enter. Most non-numeric or single entry fields allow masking and stacking (multiple entries) of values separated by a comma. Some fields have two sets of OP and value entry fields. These fields allow for exclusions and ranges.

Examples:

  • The following example includes all SYS1 data sets except those that are named (prefixed) SYS1.MAN.
DSN EQ SYS1/
DSN2 NE SYS1.MAN/
  • The following example includes all volumes that have volume serial numbers (VOLSERs) that begin with BAB. The example excludes all that begin with BAB1, BAB3 or BAB5.
VOL EQ BAB/
VOL2 NE BAB1/,BAB3/,BAB5/
  • The following example displays data sets that have utilization greater than 20 percent but less than 90 percent.
Percent Used GT 20 LT 90

MainView SRM uses all of your entries in the dialog to create the data set filter. Assume that you entered all of the example entries. The resulting filter would list only SYS1 data sets (excluding SYS1.MAN data sets) on BAB volumes other than BAB1, BAB3, and BAB5 that have utilization greater than 20 percent but less than 90 percent.

Note: The first DSN and VOLUME entry fields in the dialog have a continuation line. You must completely fill the first line before using the next line because the two lines are treated as one contiguous string.

The following tables describe each data set filtering report and the data set filtering parameters.

Data set filtering reports

Report

Purpose

Data Set Level Statistics

Displays data set information for the data set selected (WBVTOCD)

Data Sets by Age

Displays data set information for data sets by age (DAGE)

Data Set Level Statistics for Uncataloged Data Sets

Displays data set information for uncataloged data sets (DUCAT)

Data Sets by Percent Utilized

Displays data set information for data sets by percent utilized (DPCTU)

Data Sets by Size

Displays data set information for data sets by size (DSIZE)

VSAM Data Sets

Displays data set information for VSAM data sets (DVSAM)

Data Sets by Extents

Displays data set information for data sets by extents (DEXTNT)

Data Sets by Device Occupancy %

Displays data sets by the percentage used of the device where the data set resides (DOPCT)

Data Set by Backup Information

Displays data set HSM backup information contained in the DFSMShsm BCDS(s) for the data set selected (DBACKS)

 

Data set filtering parameters

Parameter

Description

Masking allowed

Multiple entries

Allocation Size

Indicates the allocation size of the data set in KBs

 

 

Application Name

Indicates the name of the application, mask, or list

Examples: appl, appl2/, app3

+

+

CA/Splits

Number of CA Splits in a VSAM file

 

 

Catalog Indicator (C, N, D, U)

Filters on the catalog type (C, N, D, U)

Valid values are:

  • C (Cataloged data sets)
  • N (Not cataloged data sets)
  • D (Duplicate data sets)
  • U (Undetermined)

 

+

CI/Splits

Filters on the number of CI Splits in a VSAM file

 

 

Compressed Indicator

Filters on whether data sets are compressed

Valid values are:

  • Yes – Compressed data sets
  • No – No compressed data sets

 

 

Days Not Referenced

Filters on the number of days since the data set was referenced

 

 

DS Changed

Filters on the data set changed indicator. A data set's changed indicator is Y if the data set has been opened for update since the last backup; otherwise, it is N.

Valid values:

Y – Include data sets that were opened for update

N – Do not include data sets that were opened for update

 

 

DSN Mask

Filters on the data set name or mask (MYDSN or MYDSN/) or list (MYDSN/,MYDSN2/...)

+

+

DSN Type

Filters on the data set type or data set types (DB2,HFS, HSM...)

Valid values are:

  • DB2 (IBM DB2 table space)
  • HFS (Hierarchical file system data set)
  • ZFS (IBM zSeries file system)
  • PDSE (Partitioned data set extended)
  • TEMP (Temporary data set)
  • HSM (HSM backup or migrate data set)
  • GDS (Generation data set)
  • VSAM (VSAM data set, not described by one of the above values)
  • NVSM (non-VSAM data set, not described by one of the above values)
  • LRGE (Large format data set)

 

+

DSORG

Filters on the data set organization or list of data set organization types (PO,PS,DA,VS,IS,--)

Valid values are:

  • PSU (Physical Sequential Unmovable)
  • POU (Partitioned Data Set Unmovable)
  • DAU (Direct Access Unmovable)
  • PO (Partitioned Data Set (BPAM))
  • PS (Physical Sequential (QSAM))
  • DA (Direct Access (BDAM))
  • VS (VSAM)
  • IS (Indexed Sequential (ISAM))
  • -- (The data set organization could not be determined or the data set was never opened)

 

+

Extended Addressability

Filters on whether extended data sets are included

Valid values are:

  • Yes – Extended addressable data sets (can exceed 4GB)
  • No – No extended addressable data sets

 

 

Extended Format

Filters on whether data sets are extended format

Valid values are:

  • Yes – Extended format data sets
  • No – No extended format data sets

 

 

Extents

Filters on the number of extents for a data set

 

 

Free Size

Filters on the amount of free space in a data set in tracks

 

 

Group/Pool Mask

Filters on the name of the group or pool (MYPOOL, MYP/ or /) or list (mypoolab,mypoolc/...)

+

+

Group/Pool Type

Filters on the type of pool or group (POOL,SUBPOOL,STRGROUP)

If you enter a value in this field, you must enter a value in the Group/Pool Mask field.

Valid values are:

  • POOL
  • SUBPOOL
  • STRGROUP

 

 

Include VOLSEQ=0 Records

Indicates whether to create or display accumulation records

Valid values are:

  • Y creates and displays VOLSEQ 0 (zero) records in the view.

    Note

    These records accumulate of all of the distinct pieces of a multi-volume data set.

  • N does not create or display accumulation records.

Sequence 0 data sets are complete if the retrieval request obtained all pieces of the multi-volume data set.

 

 

OP

Is an operator field that accepts comparison values

Valid values are:

  • EQ (Equal to)
  • LT (Less than)
  • GT (Greater than)
  • NE (Not equal to)
  • LE (Less than or equal to)
  • GE (Greater than or equal to)

 

 

Percent Used

Filters on the percentage of used space in the data set

 

 

Record Format

Filters on the record format type

Valid values are:

  • ESDS (VSAM entry sequential data set)
  • F (Fixed)
  • FB (Fixed Blocked)
  • FBA (Fixed blocked ASA printer control)
  • FBM (Fixed blocked machine code printer control)
  • FBS (Fixed Blocked Spanned)
  • KSDS (VSAM keyed sequential data set)
  • LDS (VSAM linear data set)
  • PAGE (Page data set)
  • RRDS (VSAM relative record data set)
  • U (Undefined)
  • UCAT (Catalog)
  • V (Variable)
  • VB (Variable Blocked)
  • VBS (Variable Blocked Spanned)
  • VVDS (VSAM volume data set)

 

+

Report Selection

Is a value of 1-8 that determines the specific report that will be generated

 

 

Return Code

Displays the data set's collection return code

 

 

SMFW21 Suffix

Indicates an alphanumeric suffix of the SMFW21 member located in SVOS PARMLIB

Use this member in conjunction with the filtering entries that you enter in the dialog. For more information, see FLST-filtering-for-views.

 

 

SMS Mgmt Class

Filters on the name of the SMS storage management class, mask, or list (mgmtcl1,mgm/)

+

+

SMS Stg Class

Filters on the SMS-assigned storage class name, mask, or list (stgcl123,stgcl5/)

+

+

Total backups

Filters on the total HSM backup versions

 

 

Total Versions

Filters on range for Total Versions

Valid values:

1-9999

 

 

Volume

Filters on the name of the volume or volume list (vol123,vol2/,vol/)

+

+

VSAM/NVSAM (A,V, N)

Filters on the type of data set: (A)ll, (V)SAM, (N)on-VSAM

 

 

Work Days Not Referenced

Filters on the number of work days since the data set was referenced

Working days are defined by MainView SRM calendar member SMSCALSxx. If SMSCALSxx is not used or function HSMMCCNV is not active, this field is equivalent to Days Not Referenced.

 

 

None

None

None



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*