SMVSCFxx parameter explanations

The following table provides detailed explanations of the SMVSCFxx parameters:

Related topic

Parameter

Explanation

DSN_MASK

The DSN_MASK parameter specifies the data set name or mask.

Syntax	DSN_MASK=xxxxxxxxxx DSN=xxxxxxxxxx DSNM=xxxxxxxxxx The xxxxxxxx... variable represents a data set name or data set filter. A forward slash specifies all data set names. Up to 50 DSN names or masks can be specified for inclusion by enclosing the numbers in parentheses.
Default	DSN_MASK=/

END_UNIT

The END_UNIT parameter specifies the ending unit address range.

Syntax	END_UNIT=xxxx EUNIT=xxxx The xxxx variable represents 4-character the ending unit address range.
Default	END_UNIT=FFFF

GDG

The GDG parameter specifies that the VTOC scan output is to go to a GDG (Generation Data Group) entry (+1).

Syntax

GDG=YES | NO | Y | N

When GDG=YES is specified, the output goes to a GDG entry (+1). The OUTSUFFIX parameter must be used for this parameter to take effect. The VTOC scan output data set name is generated by using the same method as the one used by OUTSUFFIX, except that after OUTSUFFIX is applied, (+1) is appended to the name. The resulting name will be the most current GDG generation.

Warning

If you specify the same value for OUTSUFFIX in multiple SMVSCF members and one member contains GDG=YES while another member contains GDG=NO, the GDG=NO collection data sets will be uncataloged after the scan is complete.

Default

GDG=NO

MASTER

The MASTER parameter specifies whether the collected VTOC scan output will go into a completely new collection data set or into the master collection data set.

When MASTER=Yes is specified, the RECORD_TYPE keyword must be D to collect data set and volume records. Data set filter criteria cannot be specified. This restriction includes the DSN_MASK, VSAM_NVSAM, SGC_APPL keywords because the data collected must be for all data sets from each qualifying volume. For each volume collected, the old volume data (volume and all its data set records) is replaced with the new data on the master.

When MASTER=No is specified, all filter criteria are available for specification. The collected data is written to a new collection data set.

Syntax	MASTER=YES \| NO \| Y \| N
Default	MASTER=NO

MNT_STATUS

The MNT_STATUS parameter specifies the mount status of the volume.

Syntax	MNT_STATUS=x MOUNT=x MNT=x The x variable represents one of the following values: A -All P - Public V - Private S - Storage
Default	MNT_STATUS=A

MRG_CATINFO

The MRG_CATINFO parameter specifies whether to include catalog information in the collection statistics.

Syntax

MRG_CATINFO=YES | NO | Y | N | A | Always

CATINFO=YES | NO | Y | N | A | Always

CATI=YES | NO | Y | N | A | Always

When Yes is specified, VSCAN will attempt to gather catalog information from various sources, but does not necessarily make calls to the catalog for data set information. When Always is specified, a call to the catalog is made for every data set encountered. Because this can cause significant overhead to the VSCAN process, BMC does not recommend that Always be used for every scan.

Default

MRG_CATINFO=YES

MRG_SGCINFO

The MRG_SGCINFO parameter specifies whether to include application data in the collected statistics.

Syntax	MRG_SGCINFO=Y \| N \| YES \| NO SGCINFO=Y \| N \| YES \| NO SGCI=Y \| N \| YES \| NO
Default	MRG_SGCINFO=YES

OUTSUFFIX

The OUTSUFFIX parameter specifies the suffix to be appended to the end of the collection data set name. Usually, VSCAN appends the date and time to the end the data set name when a scan is invoked. This parameter allows you to override the date and time values with your own values.

Syntax	OUTSUFFIX=xxxxxxxxxxxxxxx OUTSUFX=xxxxxxxxxxxxxxx OUTSFX=xxxxxxxxxxxxxxx The xxxxxxxxxxxxxxx variable represents a 1- to 15-character data set identifier.
Example:	If OUTSUFFIX=NEW.SCAN.FILE and the SMVSCF member suffix is NS and VSCAN_OINDX in the SMMSYS member is set to MVSRM.VSCAN, the generated collection data set name is MVSRM.VSCAN.SMVSCFNS.NEW.SCAN.FILE.

PARTIALSCAN

The PARTIALSCAN parameter indicates whether to eliminate some of the more extensive processing required to collect volume and pool statistics, which will improve scan run time but leave some volume and pool fields unpopulated.

Syntax	PARTIALSCAN=Y \| N \| YES \| NO
Default	PARTIALSCAN=NO

PDS_DIR

The PDS_DIR parameter specifies whether to include directory block counts.

Syntax	PDS_DIR=Y \| N \| YES \| NO
Default	PDS_DIR=NO

If you specify YES, the count value is available in view WBVTOCD (VTOC SCAN Data Set Level Statistics).

To access the PDS directory, follow these steps:

Allocate the PDS
Open the data set
Perform discovery I/Os
Close the data set
Deallocate the data set

This process can cause significant overhead to the VTOC scan depending on the number of PDSs in the scan.

PDSE_USED

The PDSE_USED parameter specifies whether to calculate the true PDSE percent used value while performing a VTOC scan initiated by the VSCAN command and show it in view WBVTOCD (VTOC SCAN Data Set Level). This specification overrides SMMSYS SET keyword PDSE_USED for the VSCAN command-initiated VTOC scans.

Option

Description

YES|Y

Calculates and displays the true PDSE percent used value and, based on true percent used and number of allocated tracks, calculates the approximate value of tracks used and tracks free.

PDSE percent used calculation involves allocating the PDSE data set, opening the data set, performing discovery I/Os, closing the data set, and deallocating it. This process can cause significant overhead to the VTOC scan process depending on the number of PDSE data sets in the scan.

NO|N

Does not calculate true PDSE percent used value, in which case it will show as 100% full. Tracks used will be equal to tracks allocated, and free tracks will be zero.

This specification can be overridden by SMVSCFxx SET keyword PDSE_USED while performing VTOC scan.

Example

PDSE_USED=YES

In this example, the true PDSE percent used value is requested to be calculated during VTOC scan, and it overrides SMMSYSxx specification.

Syntax	PDSE_USED=YES \| NO \| Y \| N
Default	Defaults to SMMSYSxx global SET keyword PDSE_USED, which, if not specified, defaults to PDSE_USED=NO.

POLICY

The POLICY parameter specifies the policy to which volumes that are to be collected are assigned.

Syntax	POLICY=xxxxxxxx The xxxxxxxx variable represents a one- to eight-character policy name or mask. A forward slash specifies all policies. Up to 10 policy names or masks can be specified for inclusion by enclosing the numbers in parentheses.
Default	POLICY=/

POOL

The POOL parameter specifies the user pool mask used to filter volume and data set records processed by VTOC scan collection.

Syntax	POOL=xxxxxxxx The xxxxxxxx variable represents a one- to eight-character pool name or mask. A forward slash specifies all pools. Up to 10 pool names or masks can be specified for inclusion by enclosing the numbers in parentheses.
Default	POOL=/

RECORD_TYPE

The RECORD_TYPE parameter specifies whether to generate the report by data set or volume statistical records.

Syntax	RECORD_TYPE=x REC_TYPE=x RECT=x The x variable represents one of the following values: D - data set V - volume
Default	RECORD_TYPE=D

SGC_APPL

The SGC_APPL parameter specifies the application name mask used to filter volume and data set records processed by VTOC scan collection.

Syntax	SGC_APPL=xxxxxxxxxxx APPL=xxxxxxxxxxx The xxxxxxxxxxx variable represents a 1- to 50-character application name or mask. A forward slash specifies all applications. Up to 10 application names or masks can be specified for inclusion by enclosing the numbers in parentheses. Important If an application name contains embedded spaces, the value must be enclosed in single quotation marks.
Default	SGC_APPL=/

SMS_GROUP

The SMS_GROUP parameter specifies the volume’s SMS group name or mask.

Syntax	SMS_GROUP=xxxxxxxx GROUP=xxxxxxxx GRP=xxxxxxxx The xxxxxxxx variable represents an SMS storage group name or filter. A forward slash specifies al SMS storage group names. Up to 10 SMS storage group names or masks can be specified for inclusion by enclosing the numbers in parentheses.
Default	SMS_GROUP=/

SMS_STATE

The SMS_STATE parameter specifies the SMS status for the volumes.

Syntax	SMS_STATE=x SMSST=x The x variable represents one of the following values: A - All volumes D - SMS disabled status volumes I - SMS initial status volumes M - SMS managed volumes Q - SMS quiesced status volumes U - Unmanaged SMS volumes
Default	SMS_STATE=A

START_UNIT

The START_UNIT parameter specifies the starting unit address range.

Syntax	START_UNIT=xxxx SUNIT=xxxx The xxxx variable represents the 4-character starting unit address.
Default	START_UNIT=0000

SUBPOOL

The SUBPOOL parameter specifies the subpool mask used to filter volume and data set records processed by VTOC scan collection.

Syntax	SUBPOOL=xxxxxxxx SPOOL=xxxxxxxx The xxxxxxxx variable represents a one- to eight-character subpool name or mask. A forward slash specifies all subpools. Up to 10 subpool names or masks can be specified for inclusion by enclosing the numbers in parentheses.
Default	SUBPOOL=/

VOLUME

The VOLUME parameter specifies a list of volume masks (up to 50 values or masks) to include for collection.

Syntax	VOLUME=xxxxxx VOL=xxxxxx VOLUME=(xxxxxx,xxxxxx,...) The xxxxxx variable represents a one- to six-character volume mask. A forward slash specifies all volumes. Up to 50 volume names or masks can be specified for inclusion by enclosing the numbers in parentheses.
Default	VOLUME=/

VOLUME_EXC

The VOLUME_EXC parameter specifies a list of volume masks (up to 50 values or masks) to exclude volumes from collection.

Syntax	VOLUME_EXC=xxxxxx VOLUME_EXC=(xxxxxx,xxxxxx,...) VOL_EXC=(xxxxxx,xxxxxx,...) VOLEXC=(xxxxxx,xxxxxx,...) The xxxxxx variable represents one- to six-character volume mask. Up to 50 volume names or masks can be specified for exclusion by enclosing the numbers in parentheses.

VSAM_NVSAM

The VSAM_NVSAM parameter specifies the data set type.

Syntax	VSAM_NVSAM=x where x variable represents one of the following values: A - All V - VSAM N - NONVSAM
Default	VSAM_NVSAM=A

SMVSCFxx parameter explanations

On this page