Skip to Content
Information

This site will undergo a brief period of maintenance on Friday, 18 December at 12:30 AM Central/12:00 PM IST. During a 30 minute window, site availability may be intermittent.

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-BMC-AMI-Storage-Reporting. For information about the audit log files, see Using-BMC-AMI-Storage-products.

Related topic

Analyzing-DASD


Warning

Important

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-BMC-AMI-Storage-Reporting.

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

Warning

Important

  • 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 BMC AMI Storage execution. BMC AMI Storage 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)
  • FA (File-AID Main Menu)(BMC.AMISTG.SPE2201)
  • FB (File-AID Browse)
  • FE (File-AID 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 BMC AMI Storage 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-BMC-AMI-Storage-products.

DATETIME

None

None

VSCAN Filter Members

Advances to the ADMEM view.

Use this view to display and update BMC AMI Storage 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

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

BMC AMI Storage 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.

Warning

Important

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.

    Warning

    Important

    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 BMC AMI Storage calendar member SMSCALSxx. If SMSCALSxx is not used or function HSMMCCNV is not active, this field is equivalent to Days Not Referenced.



None


None



 

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

BMC AMI Storage Reporting 8.2