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.

Filter and rule list parameter explanations

This topic provides detailed explanations for filters and rule lists parameters.
ParameterExplanation
AA_AMODE

The AA_AMODE parameter specifies the application mode.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_AMODE=MON | WARN | REJ

The values are defined as follows:

  • MON – This value tracks space allocations and deallocations as they occur allowing up-to-the-minute analysis of DASD space usage.
  • WARN – This value generates a message if the current allocation exceeds the budget amount.
  • REJ – If the current allocation exceeds the budget amount, the allocation will be rejected.
AA_APPL

The AA_APPL parameter specifies the application name.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_APPL=applName

The applName variable represents the application name up to 50
characters.

If there is a blank in the application name, enclose the name in quotation
marks.

AA_ASTAT

The AA_ASTAT parameter indicates the application status.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_ASTAT=xxxx

The values are defined as follows:

  • MDEL – The application has been manually flagged for deletion. The next time that the database is copied, this application will be deleted.
  • DEL – This application has been automatically flagged for deletion. This application was created, but never updated. Because no activity has taken place in the application, it will be deleted the next time the database is copied.
  • ACTV – This application is currently active.
AA_AVAIL

The AA_AVAIL parameter includes or excludes applications base on the total number of bytes that are available in the application. This amount represents the total budget minus the total allocation space in the application.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_AVAIL=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_CDATE

The AA_CDATE parameter indicates the date the application was created in the application database in yyyy/mm/dd format.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:AA_CDATE=yyyy/mm/dd
AA_HSMC

The AA_HSMC parameter indicates the total amount of space allocated on DASD for HSM data sets assigned to this application.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_HSMC=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_HSMH

The AA_HSMH parameter indicates the largest amount of space allocated on DASD for HSM data sets assigned to this application.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_HSMH=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_KHSM

The AA_KHSM parameter indicates if HSM data sets are tracked for this application.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:AA_KHSM=YES | NO | Y | N
AA_KTEMP

The AA_KTEMP parameter indicates if temporary data sets are tracked for this application.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:AA_KTEMP=YES | NO | Y | N
AA_KVSAM

The AA_KVSAM parameter indicates if VSAM data sets are tracked for this application.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:AA_KVSAM=YES | NO | Y | N
AA_LDATE

The AA_LDATE parameter contains the date of the last allocation that resulted in one of the application fields being updated in yyyy/mm/dd format.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:AA_LDATE=yyyy/mm/dd
AA_NVSAMC

The AA_NVSAMC parameter includes or excludes applications based on the total number of bytes that are allocated to non-VSAM data sets in the application.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_NVSAMC=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_PERMC

The AA_PERMC parameter indicates the total amount of space allocated on DASD for permanent data sets assigned to this application.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_PERMC=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_PERMH

The AA_PERMH parameter indicates the largest amount of space allocated on DASD for permanent data sets assigned to this application.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_PERMH=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_PERMM

The AA_PERMM parameter specifies the maximum amount of space allowed for permanent data sets assigned to this application.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_PERMM=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_PERMP

The percentage of the permanent data set budget currently being used.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_PERMP=nnnnn

The nnnnn variable represents a whole number percentage from 0 to 2147483647.

AA_PHSM

The AA_PHSM parameter indicates if HSM data set allocations are included as part of the permanent data set allocations.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:AA_PHSM=YES | NO | Y | N
AA_PTEMP

The AA_PTEMP parameter indicates if temporary data set allocations are included as part of the permanent data set allocations.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:AA_PTEMP=YES | NO | Y | N
AA_PVSAM

The AA_PVSAM parameter indicates if VSAM data set allocations are included as part of the permanent data set allocations.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:AA_PVSAM=YES | NO | Y | N
AA_TEMPC

The AA_TEMPC parameter indicates the total amount of space allocated on DASD for temporary data sets assigned to this application.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_TEMPC=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_TEMPH

The AA_TEMPH parameter indicates the largest amount of space allocated on DASD for temporary data sets assigned to this application.

Allowed in:INC/EXC in the AUTOAPPL function
Syntax:

AA_TEMPH=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_TEMPM

The AA_TEMPM parameter specifies the maximum amount of space allowed for temporary data sets assigned to this application

Allowed in:

INC/EXC in the AUTOAPPL function

Syntax:

AA_TEMPM=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_TEMPP

The AA_TEMPP parameter specifies the percentage of the temporary data set budget that is currently being used.

Allowed in:

INC/EXC in the AUTOAPPL function

Syntax:

AA_TEMPP=nnnnn

The nnnnn variable represents a whole number percentage from 0 to 2147483647.

AA_UFLDn

The AA_UFLD n parameter is an application-defined user field (1 through 3).

Allowed in:

INC/EXC in the AUTOAPPL function

Syntax:

AA_UFLD n=xxxxxxxxxx

The n variable represents a user field from 1 to 3.

The xxxxxxxxxx variable represents the field name.

AA_UFLD1 can contain up to 8 characters.

AA_UFLD2 and 3 can contain up to 10 characters each.

AA_UNAME

The AA_UNAME parameter is an application-defined user name.

Allowed in:

INC/EXC in the AUTOAPPL function

Syntax:

AA_UNAME=UserName

The UserName variable represents the user name up to 20 characters.

If there is a blank in the application user name, enclose the user name in quotation marks.

AA_VLCNT

The AA_VLCNT parameter indicates the number of volumes that contain at least one data set included in the application's allocation amounts.

Allowed in:

INC/EXC in the AUTOAPPL function

Syntax:

AA_VLCNT=nnnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AA_VSAMC

The AA_VSAMC parameter indicates the total amount of space allocated on DASD for VSAM data sets assigned to this application.

Allowed in:

INC/EXC in the AUTOAPPL function

Syntax:

AA_VSAMC=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_VSAMH

The AA_VSAMH parameter indicates the largest amount of space allocated on DASD for VSAM data sets assigned to this application.

Allowed in:

INC/EXC in the AUTOAPPL function

Syntax:

AA_VSAMH=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_VSAMM

The AA_VSAMM parameter indicates the maximum amount of space allowed for VSAM data sets assigned to this application.

Allowed in:

INC/EXC in the AUTOAPPL function

Syntax:

AA_VSAMM=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AA_VSAMP

The AA_VSAMP parameter specifies the percentage of the VSAM data set budget that is currently being used.

Allowed in:

INC/EXC in the AUTOAPPL function

Syntax:

AA_VSAMP=nnnnn

The nnnnn variable represents a whole number percentage from 0 to 2147483647.

AA_WTHRS

The AA_WTHRS parameter specifies a percentage of the budget that can be used by the application before a warning message is issued.

Allowed in:

INC/EXC in the AUTOAPPL function

Syntax:

AA_WTHRS=nnnnn

The nnnnn variable represents a whole number percentage from 0 to 2147483647.

AC_ACCCNT

The AC_ACCCNT parameter specifies a catalog access count in the current Catalog Scan performance interval.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_ACCCNT=nnnnn

The nnnnn variable represents number from 0 to 9223372036854775807.

AC_ACCTIM

The AC_ACCTIM parameter specifies a catalog average access time in the current Catalog Scan performance interval. The access time is in microseconds (0.000001 seconds).

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_ACCTIM=nnnnn

The nnnnn variable represents number from 0 to 9223372036854775807.

Example:

INC AC_ACCTIM>1 specifies an access time greater than 1 microsecond.

AC_ACCTIM>10000 specifies an access time greater than 1 hundredth (.01) of a second.

AC_ACCTIMHC

The AC_ACCTIMHC parameters specifies the access count from the hour with the highest average access time in the current Catalog Scan performance interval.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_ACCTIMHC=nnnnn

The nnnnn variable represents number from 0 to 9223372036854775807.

AC_ACCTIMHR

The AC_ACCTIMHR parameter specifies the hour containing the highest average access time in the current Catalog Scan performance interval.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_ACCTIMHR=hh

The hh variable represents hours from 0 through to 23 (0 is the time range from 00:00 am to 00:59 am)

AC_ACCTIMHW

The AC_ACCTIMHW parameter specifies the highest average access time from all hours in the current Catalog Scan performance interval. The access time is in microseconds (0.000001 seconds).

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_ACCTIMHW=nnnnn

The nnnnn variable represents number from 0 to 9223372036854775807.

Example:

AC_ACCTIMHW>1 specifies a HWM access time greater than 1 microsecond.

AC_ACCTIMHW>10000 specifies a HWM access time greater than 1 hundredth (.01) of a second

AC_ALI#

The AC_ALI# parameter specifies the number of aliases defined in the master catalog with an association to a user catalog.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax

AC_ALI#=nnnnn

The nnnnn variable represents number from 0 to 2147483647.

AC_CAT

The AC_CAT parameter specifies the catalog name up to 44 characters.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_CAT=xxxxxxxxxx...

The variable xxxxxxxxxx... represents a 1- to 44-character valid data set name.

AC_CODE

The AC_CODE parameter specifies the value in the IBM ACCODE field. Normally, this field is used in conjunction with user-generated tape labels. The tape manager for CA, CA1, uses the field to indicate various special tapes, such as Off-site, permanent hold, and so on.

Allowed in:

INC/EXC and rule SET parameter for function SETEXPDT

Syntax:

AC_CODE=TapeTypes

AC_DS#

The AC_DS# parameter specifies the data set entries with an associated alias in the master catalog.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_DS#=nnnnn

The nnnnn variable represents number from 0 to 2147483647.

AC_EXTS

The AC_EXTS parameter specifies the catalog extents.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_EXTS=nnnnn

The nnnnn variable represents number from 0 to 2147483647.

AC_MALI#

The AC_MALI# parameter specifies a high-water-mark of data set entries. This is from the alias with the highest number of data set entries.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_MALI#=nnnnn

The nnnnn variable represents number from 0 to 2147483647.

AC_MALIN

The AC_MALIN parameter specifies the name of the alias with the highest number of data set entries.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_MALIN=aliasName

The aliasName variable represents a one- to forty-four-character valid alias name.

AC_PUSED

The AC_PUSED parameter specifies the percent of allocation that is used.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_PUSED=nnn

The nnn variable represents a value from 0 to 100.

AC_PUSEDT

THE AC_PUSEDT parameter specifies the percent of allocation that is used in tenths of a percent.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_PUSEDT=nnnn

The nnn variable represents a value from 0 to 1000.

Example:

INC AC_PUSEDT>0500 (include greater than 50%)

AC_SIZE

The AC_SIZE parameter specifies the catalog total size in tracks.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_SIZE=nnnnn

The nnnnn variable represents number from 0 to 2147483647.

AC_UALI#

The AC_UALI# parameter specifies a count of unique high level qualifiers of the unavailable data set entries. The qualifiers are from data set entries that do not have an alias defined in the master catalog. The user catalog must be explicitly named in order to access these data set entries.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_UALI#=nnnnn

The nnnnn variable represents number from 0 to 2147483647.

AC_UDS#

The AC_UDS# parameter specifies the data set entries with no associated alias in the master catalog. The user catalog must be explicitly named in order to access these data set entries.

Allowed in:

INC/EXC in the AUTOCATC function

Syntax:

AC_UDS#=nnnnn

The nnnnn variable represents number from 0 to 2147483647.

ACF2USER

The ACF2USER parameter contains the user name (CA ACF2 system). This is a 24-byte value. For ACF2 users, this parameter should be used instead of USER or RACF.

Note

This parameter might not be available during a REFRESH (rebuild) of ACF2 control blocks and is not available for function FDRASIST.

Allowed in:

INC/EXC

Syntax:

ACF2USER=xxxxxxxx

The xxxxxxxx variable represents a valid CA ACF2 user name 1-24 characters long.

ACT_ACCUM

The ACT_ACCUM parameter accumulates event and job actions over time and batch the events or job JCL statements together. When you use ACT_JOB to tailor skeleton JCL, you can use ACT_ACCUM to batch together or accumulate all the resources that match the solution over a specified time period, and create one set of tailored JCL that includes all the resources. When you use ACT_ACCUM with the ACT_EVENTID parameter, events are accumulated over the time period and issued at once. For more information, see the MainView SRM Automation User Guide.

Allowed in:

Rule SET parameter for AUTOAPPL, AUTODS, AUTOHMSG, AUTOPOOL, and AUTOVOL.

Syntax:

ACT_ACCUM=NO | HOUR | TOD | HSMDAY | ALL

The following table defines the values:

Value

Description

ALL

Indicates that resources matching the solution should be accumulated

You can later choose to issue events or tailor skeleton JCL. You can use this setting when you want to manually submit accumulated skeleton JCL using the AUTOSOL or AUTOACUM views. MainView SRM does not tailor or submit any JCL automatically with this setting. Accumulated data is lost when SVOS or SVESA is stopped or when a system or function refresh occurs.

HOUR

Indicates that resources matching the solution should be accumulated in the skeleton JCL and either submitted or saved, according to the JOB_DEST parameter, once per hour

This process causes one batch job to be submitted or one data set created at or near the top of each hour. The JCL includes all the resources matching the solution in the last hour. If no resources match the solution during the time period, no job is submitted and no data set is created.

HSMDAY

Indicates that resources matching the solution should be accumulated in the skeleton JCL and either submitted or saved, according to the JOB_DEST parameter, once per day at the start of the DFSMShsm cycle

This value was created for use in the AUTOHMSG function; however, it can be used in any AUTO function. This process causes one batch job to be submitted or one data set created at or near the beginning of the DFSMShsm daily cycle. The DFSMShsm daily cycle begins when DFSMShsm Auto Backup starts.

NO

Indicates that no accumulation should take place

A batch job is either saved to a data set or submitted, according to the JOB_DEST parameter, for each occurrence of the AUTO function.

TOD

Indicates that resources matching the solution should be accumulated in the skeleton JCL and either submitted or saved, according to the JOB_DEST parameter, once per day

When this value is specified the ACT_TOD parameter must be used to specify the time of day the job should be submitted. One batch job is submitted at or near the time of day that is indicated in ACT_TOD.

Default:

ACT_ACCUM=NO

ACT_COUNT

The ACT_COUNT parameter specifies the maximum to the number of records to which actions can be taken. ACT_EVENTID and ACT_JOBNAME keywords identify the possible actions to take. ACT_COUNT determines the maximum number of records those actions will be taken against. If ACT_COUNT is not specified the action will be taken on all records in the result group for the associated SET statement, unless limited by use of the ACT_SUM_LIM keyword. (optional)

Allowed in:

Rule SET parameter for AUTOAPPL, AUTODS, AUTOHMSG, AUTOPOOL, and AUTOVOL.

Syntax:

ACT_COUNT=nnnnn

The nnnnn variable represents the maximum to the number of records to which actions can be taken (1-9999).

ACT_EVENTID

The ACT_EVENTID parameter specifies an event to issue for each record in the SET result group. This action is applied to the result group of records that match the SET statement INC/EXC statements. The action is applied after any SORT= specification is processed, which means the events will be generated in sort order. The number of events to issue can be limited by ACT_SUM_LIM or ACT_COUNT keywords.

ACT_EVENTID and ACT_JOB specify the actions to take. Every SET statement should have at least one of these keywords or no action will be taken. Both statements can be used; however, care should be taken when doing this. Care must also be used when specifying ACT_EVENTID= in an AUTOx type FLST or RLST member.

Allowed in:

Rule SET parameter for AUTOAPPL, AUTODS, AUTOPOOL, and AUTOVOL.

Syntax:

ACT_EVENTID=xxxxx

The xxxxx variable represents the five-character value that corresponds to a valid event definition in PARMLIB member SMEVNTxx.

ACT_JOB

The ACT_JOB parameter specifies the name of a member containing skeleton JCL to be submitted using the Skeleton Tailoring facility. The member name must contain skeleton JCL and be located in BBSLIB data set of the MainView SRM Started Task.

ACT_JOB causes the submission of a single job, with the pool/volume/data set names passed to the Skeleton Tailoring facility. The JCL member should make use of the )DO or )REPEAT capability of skeleton tailoring to ensure all variable values are processed by the submitted job. This is described in detail below.

ACT_JOB is recommended over ACT_EVENTID if the result of the ACT_EVENTID will be to submit a job. Using ACT_EVENTID in conjunction with MainView AutoOPERATOR rules to submit a job causes a job to be submitted for each event, each record in the FLST/RLST result group (as limited by a count or sum limit). Using ACT_JOBNAME causes all of the result records to be passed to the Skeleton Tailoring facility in a single iteration.

ACT_JOB and ACT_EVENTID specify the actions to take. Every SET statement should have at least one of these keywords, or no action will be taken. Both statements can be used, however, care should be taken when doing this.

Allowed in:

Rule SET parameter for AUTOADDV, AUTOAPPL, AUTODS, AUTOPOOL, and AUTOVOL

Syntax:

ACT_JOB=memberName

The memberName variable represents the 1-8 character name of the PDS member that contains the skeleton JCL in the UBBPROC data set in the AO Started Task.

If not specified, an error will be generated during the SVOS start up.

Example:

This example selects the current device if it is a 3390-54 and it is being added to the LARGEGRP storage group. The skeleton JCL in SRMJOB10 is used to initialize the selected device.

SET ACT_JOB=SRMJOB09

INC DEV_TYPE=3390-54 GROUP=LARGEGRP

ACT_SUM_FLD

The ACT_SUM_FLD optional parameter causes a running total of the specified field to be maintained for each record against which a specified action is taken. When using ACT_SUM_FLD, ACT_SUM_LIM can be used to stop action from being taken after the running total reaches a specified value.

Allowed in:

Rule SET parameter for AUTOAPPL, AUTODS, AUTOPOOL, and AUTOVOL.

Syntax:

ACT_SUM_FLD=xxxxxxxxxxx

The xxxxxxxxxxx variable represents a 1- to 11-character valid INC/EXC field for the function associated with the RLST; the field name must be that of a numeric field.

ACT_SUM_LIM

The ACT_SUM_LIM optional parameter can be used to limit the number of records to be included in any specified action. If specified, ACT_SUM_FLD= must also be specified. A running total of the field specified in ACT_SUM_FLD is maintained as each action is taken. At the completion of the action the total is updated. Prior to taking the next action, the total is compared to ACT_SUM_LIM. If the total is less than the limit, the next action is taken. If the total is equal to or greater than the limit, action processing is bypassed for the remainder of the records in the SET group.

Allowed in:

Rule SET parameter for AUTOAPPL, AUTODS, AUTOPOOL, and AUTOVOL.

Syntax:

ACT_SUM_LIM=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

ACT_TOD

The ACT_TOD parameter specifies accumulated data should be processed, issuing events or creating tailored skeleton JCL or both. This parameter is used when ACT_ACCUM=TOD is specified.

Make certain that the time of day (TOD) that is specified in this parameter does not occur in a time period during which the solution is disabled, as specified by the WINDOW_xxx parameters. See WINDOW_STRT for more information.

This is an optional parameter. This parameter is required when ACT_ACCUM=TOD.

Allowed in:

Rule SET parameter for AUTOAPPL, AUTODS, AUTOHMSG, AUTOPOOL, and AUTOVOL.

Syntax:

ACT_TOD=hhmm

The hhmm variable represents the time of day from 0000 (midnight) through 2359. A value of 2400 can be entered, however, it is treated as 0000.

Default:ACT_TOD=0000
AD_ALVL1

The AD_ALVL1 parameter contains the application name (Application Level 1).

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_ALVL1=applName

The applName variable represents the application name up to 50 characters.

AD_ALVL2

The AD_ALVL2 parameter contains the application name (Application Level 2).

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_ALVL2=applName

The applName variable represents the application name up to 50 characters.

AD_ALVL3

The AD_ALVL3 parameter contains the application name (Application Level 3).

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_ALVL3=applName

The applName variable represents the application name up to 50 characters.

AD_ALVL4

The AD_ALVL4 parameter contains the application name (Application Level 4).

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_ALVL4=applName

The applName variable represents the application name up to 50 characters.

AD_BASE

The AD_BASE parameter indicates the base name of the data set.

For non-VSAM data sets, the base name is the same as the data set name. For VSAM data sets, the base name is the name of the VSAM cluster associated with the data set.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_BASE=clusterName

The clusterName variable represents the base name of the data set.

AD_BKUPCATS

The AD_BKUPCATS parameter indicates if one or more backup versions exist for a data set that was cataloged at the time of backup.

Note

The DFSMShsm BCDS(s) must be read to retrieve backup information. The HSM Collector (SVHSM) must be active in order for this information to be retrieved.

DFSMShsm backup information is grouped by data set name. If duplicate data set names exist, backup information may exist for data sets cataloged and uncataloged at the time of their backup.

Allowed in:

AUTODS function INC/EXC statement

Syntax:

AD_BKUPCATS=Y|N

Default:

If not specified then there is no filtration based on this keyword.

AD_BKUPDATE

The AD_BKUPDATE parameter contains the most recent backup date for the data set.

Note: The DFSMShsm BCDS(s) must be read to retrieve backup information. The HSM Collector (SVHSM) must be active in order for this information to be retrieved. DFSMShsm backup information is grouped by data set name. If duplicate data set names exist, the most recent backup data may be from either a cataloged or uncataloged data set at the time of backup.

Allowed in:

AUTODS function INC/EXC statement

Syntax:

AD_BKUPDATE=yyyy/mm/dd

Default:

If not specified then there is no filtration based on this keyword.

AD_BKUPDAYS

The AD_BKUPDAYS parameter Contains the number of days since the last backup was performed on the data set.

Note: The DFSMShsm BCDS(s) must be read to retrieve backup information. The HSM Collector (SVHSM) must be active in order for this information to be retrieved. DFSMShsm backup information is grouped by data set name. If duplicate data set names exist, the number of days since the last backup may be from either a cataloged or uncataloged data set.

Allowed in:

AUTODS function INC/EXC statement

Syntax:

AD_BKUPDAYS=nnnnn

The nnnnn variable represents number from 0 to 2147483647.

Default:

If not specified then there is no filtration based on this keyword.

AD_BKUPSIZE

The AD_BKUPSIZE parameter contains the backup space usage for the data set (in bytes). The space usage does not include retained backup versions.

Note: The DFSMShsm BCDS(s) must be read to retrieve backup information. The HSM Collector (SVHSM) must be active in order for this information to be retrieved. DFSMShsm backup information is grouped by data set name. If duplicate data set names exist, the backup information could be for more than one data set.

Allowed in:

AUTODS function INC/EXC statement

Syntax:

AD_BKUPSIZE=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

Default:

If not specified then there is no filtration based on this keyword.

AD_BKUPTOTS

The AD_BKUPTOTS parameter contains the number of backup versions that exist for the data set. The count does not include retained backup versions.

Note: The DFSMShsm BCDS(s) must be read to retrieve backup information. The HSM Collector (SVHSM) must be active in order for this information to be retrieved. DFSMShsm backup information is grouped by data set name. If duplicate data set names exist, the backup information could be for more than one data set.

Allowed in:

AUTODS function INC/EXC statement

Syntax:

AD_BKUPTOTS=nnnnn

The nnnnn variable represents number from 0 to 2147483647.

Default:

If not specified, there is no filtration based on this keyword.

AD_BKUPUNCS

The AD_BKUPUNCS parameter indicates if one or more backup versions exist for a data set that was uncataloged at the time of backup.

Note: The DFSMShsm BCDS(s) must be read to retrieve backup information. The HSM Collector (SVHSM) must be active in order for this information to be retrieved. DFSMShsm backup information is grouped by data set name. If duplicate data set names exist, backup information may exist for data sets cataloged and uncataloged at the time of their backup.

Allowed in:

AUTODS function INC/EXC statement

Syntax:

AD_BKUPUNCS=Y | N

Default:

If not specified, there is no filtration based on this keyword.

AD_BKUPWDAY

The AD_BKUPWDAY parameter contains the number of work days since the last backup was performed on the data set.

This number is calculated by subtracting the last backup date from the current date and adjusting the number according to the SMSCALxx calendar.

Note: The DFSMShsm BCDS(s) must be read to retrieve backup information. The HSM Collector (SVHSM) must be active in order for this information to be retrieved. DFSMShsm backup information is grouped by data set name. If duplicate data set names exist, the number of work days since the last backup may be from either a cataloged or uncataloged data set.

Allowed in:

AUTODS function INC/EXC statement

Syntax:

AD_BKUPWDAY=nnnnn

The nnnnn variable represents number from 0 to 2147483647.

Default:

If not specified, there is no filtration based on this keyword.

AD_BLKEF

The AD_BLKEF parameter specifies the percentage of blocking efficiency.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_BLKEF=nnn

The nnn variable represents a whole number percentage up to 100.

AD_BLKEFT>FLST/RLST parameter

The AD_BLKEFT parameter specifies the blocking efficiency of the data set in tenths of a percent.

BMC recommends that the AD_BLKEF keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_BLKEFT>nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

Example:

INC AD_BLKEFT > 0500 (include greater than 50%)

INC AD_BLKEFT > 0905 (include greater than 90.5%)

AD_BLKSZ

The AD_BLKSZ parameter contains physical block size or VSAM control interval size for the data set.

For VSAM KSDS, ESDS and RRDS, the control interval size is displayed. For all other data set types, the physical block size is displayed. For VSAM data sets, the physical block size and control interval size are obtained from the catalog.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_BLKSZ=nnnnn

The nnnnn variable represents the physical block size from 0 to 32760.

AD_BLKTR

The AD_BLKTR parameter contains the number of physical blocks that will fit on one track. The value relates to the Percent Efficiency value.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_BLKTR=nnnnn

The nnnnnn variable represents a number from 0 to 2147483647.

AD_CASPL

The AD_CASPL parameter contains the number of VSAM control area splits performed on the data set.

This number is for the entire VSAM data set if it spans multiple volumes. Non-VSAM data sets will show NA in this field.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_CASPL=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AD_CAT

The AD_CAT parameter contains the catalog status of the data set.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_CAT=x

The values are defined as follows:

  • C – The data set is cataloged and resides on the volume shown.

  • N – The data set is not cataloged, but resides on the volume shown.

  • D – The data set is not cataloged, but resides on the volume shown. However, there is a data set with the same name on a different volume that is cataloged.

AD_CDATE

The AD_CDATE parameter contains the 10-character creation date of the data set in yyyy/mm/dd format.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_CDATE=yyyy/mm/dd

AD_CDAYS
(PTF BPG7604 applied)

The AD_CDAYS parameter specifies the number of days since the data set was created.

The product calculates this number by subtracting the creation date from the current date. The calculation does not include the data set's time of creation.

Allowed in:INC/EXC in the AUTODS function
Syntax:

AD_CDAYS=nnnnn

The nnnnn variable represents a number from 0 through 99999.

AD_CHG

The AD_CHG parameter indicates if the data set has been opened for update since its last backup.

Note: This indicator is based off the flag DS1DSCHG in the format 1/8 DSCB for the data set. If a backup is run while the data set is opened for update, the flag is turned off in the DSCB. However, since the data set is still open, additional updates may occur to it after the backup. The flag would still be off in the DSCB, even though updates have occurred since the backup.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_CHG=YES | NO | Y | N

AD_CISPL

The AD_CISPL parameter contains the number of VSAM control interval splits performed on the data set.

This number is for the entire VSAM data set if it spans multiple volumes. Non-VSAM data sets will show NA in this field.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_CISPL=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AD_COMPR

The AD_COMPR parameter indicates if the data set is compressed.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_COMPR=YES | NO | Y | N

AD_DAYS

The AD_DAYS parameter contains the number of days since the data set was opened.

This number is calculated by subtracting the last reference date from the current date.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_DAYS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AD_DCLAS

The AD_DCLAS parameter contains the SMS-assigned data class or one of the specified values for the data set.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_DCLAS=DataClass

The values are defined as follows:

  • NONE – The data set is cataloged and non-SMS managed.

  • DUPLIC – The data set is a duplicate (not cataloged).

  • UNDET – The data set's SMS status could not be determined.

AD_DCVALID

The AD_DCVALID parameter indicates whether the data class to which the data set is assigned is valid.

The data class of the data set is inspected during a VTOC Scan and validated against SMS data class definitions at the time that the scan occurs.

Syntax:

AD_DCVALID=YES | NO | Y | N

AD_DIRBA
(PTF BPG7583 applied)

The AD_DIRBA parameter specifies the number of allocated PDS directory blocks.

Allowed in:INC/EXC in the SMFW21xx member and the AUTODS function 
Syntax:

AD_DIRBA op nnnnnn

The nnnnnn variable represents a number from 1 through 16777215.

The op variable represents all supported operators.       

AD_DIRBF
(PTF BPG7583 applied)

The AD_DIRBF parameter specifies the number of free PDS directory blocks

Allowed in:INC/EXC in the SMFW21xx member and the AUTODS function 
Syntax:

AD_DIRBF op nnnnnn

The nnnnnn variable represents a number from 0 through 16777215.

The op variable represents all supported operators.

AD_DOCC

The AD_DOCC parameter contains the device occupancy percentage.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_DOCC=nnn

The nnn variable represents a percentage from 0 to 100.

AD_DOCCT>FLST/RLST parameter

The AD_DOCCT parameter specifies the device occupancy percentage in tenths of a percent.

BMC recommends that the AD_DOCC keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_DOCCT>nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

Example:

INC AD_DOCCT > 0500 (to include greater than 50%)

INC AD_DOCCT > 0905(to include greater than 90.5%)

AD_DSN

The AD_DSN parameter specifies the data set name.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_DSN=dsName

The dsName variable represents a data set name up to 44 characters.

AD_DSORG

The AD_DSORG parameter contains the data set file organization and access method used to manage the data set.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_DSORG=xxxx

The following table defines the values:

Value

Description

DA

Direct Access (BDAM)

IS

Indexed Sequential (ISAM)

PO

Partitioned Data Set (BPAM)

PS

Physical Sequential (QSAM)

VS

Virtual Storage Access Method (VSAM)

--

The data set organization could not be determined or the data set was never opened.

AD_DSTYP

The AD_DSTYP parameter specifies the data set type.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_DSTYP=xxxx

The values are defined as follows:

  • DB2 (DB2 table space)

  • GDS (Generation data set)

  • HFS (Hierarchical file system data set)

  • HSM (HSM backup or migrate data set)

  • LRGE (Large format data set)

  • PDSE (Partitioned data set extended)

  • TEMP (Temporary data set)

  • ZFS (IBM zSeries file system data set)

  • VSAM (All other VSAM data sets not described by the preceding values)

  • NVSM (All other non-VSAM data sets not described by the preceding values)

AD_EXTS

The AD_EXTS parameter specifies the number of extents occupied by the data set on the volume.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_EXTS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AD_EXTSB

The AD_EXTSB parameter specifies the number of extents occupied by the data set on a non-EAV volume or in the BAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

INC AD_EXTSB>100

The value range is a number from 0 to 2147483647.

AD_EXTSE

The AD_EXTSE parameter specifies the number of extents occupied by the data set in the EAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

INC AD_EXTSE>100

The value range is a number from 0 to 2147483647.

AD_GROUP

The AD_GROUP parameter specifies the SMS storage group name that is displayed if the AUTODS function is associated with an AUTOPOOL GROUP=Function.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_GROUP=xxxxxxxxxx

The xxxxxxxxxxx variable represents an SMS storage group up to 30 characters.

AD_LDATE

The AD_LDATE parameter contains the last date the data set was opened in yyyy/mm/dd format.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_LDATE=yyyy/mm/dd

Note: For data sets that are never opened and do not have a last reference date, the creation date of the data set will be used as a last reference date.

AD_LRECL

The AD_LRECL parameter contains the maximum record length for the data set.

For VSAM data sets, the record length is obtained from the catalog.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_LRECL=nnnnn

The nnnnn variable represents a value from 0 to 99999.

AD_MCVALID

The AD_MCVALID parameter indicates whether the management class to which the data set is assigned is valid. The management class of the data set is inspected during a VTOC Scan and validated against SMS management class definitions at the time that the scan occurs.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_MCVALID=YES | NO | Y | N

AD_MNTTYPE

The AD_MNTTYPE parameter indicates the mount type of the volume on which the data set exists.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_MNTTYPE=PVT | STG | PUB | SYS

The values are defined as follows:

  • PVT (Private)

  • STG (Storage Group)

  • PUB (Public)

  • SYS (System)

AD_MCLAS

The AD_MCLAS parameter contains the SMS-assigned management class or one of the specified values.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_MCLAS=NONE | DUPLIC | UNDET

The values are defined as follows:

  • NONE – The data set is cataloged and non-SMS managed.

  • DUPLIC – The data set is a duplicate (not cataloged).

  • UNDET – The data set's SMS status could not be determined.

AD_MULTD

The AD_MULTD parameter indicates whether the AUTODS record was used in the creation of a multivolume summarization record.

AD_MULTD=Y indicates that the data set is cataloged and was found on multiple volumes (based on the volumes scanned by the AUTODS request). The AUTODS results include one data set record per volume and one summarized data set record for all volumes. Each of these records have AD_MULTD=Y set. The summarized data set record has AD_VOLSQ=0 set.

The other data set records have AD_VOLSQ set to their proper volume sequence number (a nonzero value).

An AD_MULTD=Y specification in VTOC Scan Data Set Filter dialog member SMFW21xx can be used to force the display of single volume lines of multivolume data sets together with requests to display multivolume summary lines (VOLSQ=0).

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_MULTD=YES | NO | Y | N

AD_POOL

AD_POOL is the pool name that is associated with the data set. The pool is derived from the pool that is assigned to the volume on which the data set exists. The volume, and therefore the data set, can be assigned in up to eight pools and subpools. If a pool name was specified on the AUTODS command, this keyword value is set to that pool name. If no pool name was specified on the AUTODS command, this keyword value is set to the first pool name that is assigned to the volume.

When this keyword is used in the data set filtering member, the value of this keyword is always the first pool name that is assigned to the volume.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_POOL=xxxxxxxx

The xxxxxxxx variable represents a pool name up to 8 characters.

AD_POOLT

The AD_POOLT parameter contains the pool type.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_POOLT=S | P

The values are defined as follows:

  • S (Subpool)

  • P (User pool)

AD_PUSED

The AD_PUSED parameter contains the percentage of allocation that is used.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_PUSED=nnn

The nnn variable represents a percentage up to 100 in whole numbers (no decimal).

AD_PUSEDT>FLST/RLST parameter

The AD_PUSEDT parameter specifies the device occupancy percentage in tenths of a percent.

BMC recommends that the AD_PUSEDT keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_PUSEDT >nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

Example:

INC AD_PUSEDT > 0500 (to include greater than 50%)

INC AD_PUSEDT > 0905 (to include greater than 90.5%)

AD_REBLK

The AD_REBLK parameter contains the reblockable indicator, which determines whether the data set can be reblocked by the system when being moved from one device geometry to another.

This is also known as System Determined Block Size and typically allocates a block size that uses the space on the device most efficiently. N indicates that the data set is not allocated with System Determined Blocksizing and must be manually reblocked when moved from one device geometry to another.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_REBLK=YES | NO | Y | N

AD_RECFM

The AD_RECFM parameter contains the data set record format.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_RECFM=xxxxx

The record format indicates the type of record access along with the general format of the records and blocks.

The following table defines values for non-VSAM data sets:

Value

Description

F

Specifies a record format of fixed length blocks

V

Specifies a record format of variable length blocks

U

Specifies a record format of undefined block lengths

B

Specifies that records are blocked

S

Specifies that records span multiple blocks

M

Specifies that records contain machine control characters

A

Specifies that records contain ANSI printer control characters

----

Indicates that the data set organization could not be determined or the data set was never opened

The following table defines values for VSAM data sets:

Value

Description

ESDS

Specifies a record format for entry-sequenced data set

KSDS

Specifies a record format for a key-sequenced data set

LDS

Specifies a record format for a linear data set

PAGE

Specifies a record format for a system page data set

UCAT

Specifies a record format for a user catalog

VVDS

Specifies a record format for an ICF catalog system data set

----

Indicates that the data set organization could not be determined or the data set was never opened

AD_SCLAS

The AD_SCLAS parameter contains the SMS-assigned storage class or one of the specified values.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_SCLAS=StgClass

The values are defined as follows:

  • NONE – The data set is cataloged and non-SMS managed.

  • DUPLIC – The data set is a duplicate (not cataloged).

  • UNDET – The data set's SMS status could not be determined.

AD_SCVALID

The AD_SCVALID parameter indicates whether the storage class to which the data set is assigned is valid.

The storage class of the data set is inspected during a VTOC Scan and validated against SMS storage class definitions at the time that the scan occurs.

Syntax:

AD_SCVALID=YES | NO | Y | N

AD_SIZE

The AD_SIZE parameter specifies the data set size in kilobytes (one kilobyte equals 1024 bytes) on the volume.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_SIZE=dsSize

The dsSize variable represents a number from 0 to 2147483647.

AD_SIZEB

The AD_SIZEB parameter specifies the amount of data set space that is allocated on a non-EAV volume or in the BAS area of an EAV volume kilobytes; one kilobyte equals 1024 bytes.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

INC AD_SIZEB>100

The value range is a number from 0 to 2147483647.

AD_SIZEE

The AD_SIZEE parameter specifies the amount of data set space that is allocated in the EAS area of an EAV volume in kilobytes (one kilobyte equals 1024 bytes).

Allowed in:

INC/EXC in the AUTODS function

Syntax:

INC AD_SIZEE>100

The value range is a number from 0 to 2147483647.

AD_SMSI

The AD_SMSI parameter specifies the SMS status of the volume

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_SMSI=xx

The values are defined as follows:

  • M (SMS managed)

  • QA (SMS quiesced all)

  • QN (SMS quiesced new)

  • DA (SMS disabled all)

  • DN (SMS disabled new)

  • UN (Not SMS managed)

  • NA (Unknown)

AD_STORGRP

The AD_STORGRP parameter specifies the SMS storage group name that is displayed if the AUTODS function is associated with an AUTOPOOL GROUP=Function.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_STORGRP=StorGroup

The StorGroup variable represents an SMS storage group up to 8 characters.

AD_STRPC

The AD_STRPC parameter specifies the number of data set stripes.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_STRPC=dsStripes

The dsStripes variable represents a number from 0 to 2147483647.

AD_SUL
(PTF BPG7583 applied)

The AD_SUL parameter specifies the standard user labels (SULs) allocated to a DASD data set.

Allowed in:INC/EXC in the AUTODS function
Syntax:AD_SUL=YES|NO|Y|N
AD_TRKSA

The AD_TRKSA parameter specifies the number of tracks allocated.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_TRKSA=tracks

The tracks variable represents a number from 0 to 2147483647.

AD_TRKSAB

The AD_TRKSAB parameter specifies the number of tracks allocated in the BAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

INC AD_TRKSAB>100

The value range is a number from 0 to 2147483647.

AD_TRKSAE

The AD_TRKSAE parameter specifies the number of tracks allocated in the EAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

INC AD_TRKSAE>100

The value range is a number from 0 to 2147483647.

AD_TRKSF

The AD_TRKSF parameter specifies the number of tracks unused by the data set on the volume.

For VSAM data sets, the number of tracks unused is calculated from the high-allocated RBA and high-used RBA values for each volume. These values are obtained from the catalog.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_TRKSF=tracks

The tracks variable represents a number from 0 to 2147483647.

AD_TRKSFB

The AD_TRKSFB parameter specifies the number of tracks unused by the data set on a non-EAV volume or in the BAS area of an EAV volume.

For VSAM data sets, the number of tracks unused is calculated from the high-allocated RBA and high-used RBA values for each volume.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

INC AD_TRKSFB>100

The value range is a number from 0 to 2147483647.

AD_TRKSFE

The AD_TRKSFE parameter specifies the number of tracks unused by the data set in the EAS area of an EAV volume.

For VSAM data sets, the number of tracks unused is calculated from the high-allocated RBA and high-used RBA values for each volume. These values are obtained from the catalog.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

INC AD_TRKSFE>100

The value range is a number from 0 to 2147483647.

AD_TRKSU

The AD_TRKSU parameter specifies the number of tracks used by the data set on the volume.

For VSAM data sets, the number of tracks used is calculated from the starting RBA and high-used RBA values for each volume. These values are obtained from the catalog.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_TRKSU=tracks

The tracks variable represents a number from 0 to 2147483647.

AD_TRKSUB

The AD_TRKSUB parameter specifies the number of tracks used by the data set on a non-EAV volume or in the BAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

INC AD_TRKSUB>100

The value range is a number from 0 to 2147483647.

AD_TRKSUE

The AD_TRKSUE parameter specifies the number of tracks used by the data set in the EAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

INC AD_TRKSUE>100

The value range is a number from 0 to 2147483647.

AD_VOL

The AD_VOL parameter specifies the volume name.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_VOL=volName

The volName variable represents a volume name up to 6 characters.

AD_VOLSQ

The AD_VOLSQ parameter specifies the volume sequence number for the data set.

An AD_VOLSQ=0 specification in VTOC Scan Data Set Filter dialog member SMFW21xx can be used to force the display of multivolume summary lines (VOLSQ=0), which is an alternative to the VTOC Scan Data Set Filter dialog specification “Include VOLSQ=0 Recs Y”.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_VOLSQ=volSeq

The volSeq variable represents the volume sequence from 1 to 32767.

AD_VSAMCOMP

The AD_VSAMCOMP parameter indicates whether this is the data or index component of a VSAM cluster.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_VSAMCOMP=D | I

The values are defined as follows:

  • D (Data component)

  • I ( Index component)

AD_VSNVS

The AD_VSNVS parameter specifies the data set category.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_VSNVS=N | V

The values are defined as follows:

  • N (Non-VSAM data sets)

  • V ( VSAM data sets)

AD_WCDAY
(PTF BPG7604 applied)

Specifies the number of working days (calendar-adjusted) since the data set was created.

The SMSCALSxx calendar member defines working days. If you do not use SMSCALSxx or if the HSMMCCNV function is not active, the days are not adjusted. In that case, the value of AD_WCDAY will equal the value of AD_CDAY.

The calculation does not include the data set's time of creation.

Allowed in:INC/EXC in the AUTODS function
Syntax:

AD_WCDAY=nnnnn

The nnnnn variable represents a number from 0 through 99999.

Examlpe: AD_WCDAY=100

AD_WDAYS

Specifies the number of working days (from 0 through 2147483647) since the data set was last referenced.

The SMSCALSxx calendar member defines working days. If you do not use SMSCALSxx or if the HSMMCCNV function is not active, the days are not adjusted. In that case, the value of AD_WDAYS will equal the value of AD_DAYS.

The product calculates this number by substracting the last reference date from the current date and adjusting the number according to the SMSCALSxx calendar.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_WDAYS< >nnnnn

The nnnnn variable represents a number from 0 through 2147483647.

Examlpe: AD_WDAYS>100

AD_XDATE

The AD_XDATE parameter specifies the expiration date for the data set in yyyy/mm/dd format.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_XDATE=yyyy/mm/dd

Note: For data sets that are not assigned an expiration date a value of 9999/99/99 will be assigned to this field.

AD_XTFMT

The AD_XTFMT parameter indicates whether the data set is in extended format.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_XTFMT=YES|NO|Y|N

AD_XTNDA

The AD_XTNDA parameter indicates whether the data set is extended addressability.

Allowed in:

INC/EXC in the AUTODS function

Syntax:

AD_XTNDA=YES|NO|Y|N

AE_CALAGE

The AE_CALAGE parameter specifies the calendar-adjusted number of days since the data set was last referenced. Calendar-adjusted days are working days as defined in MainView SRM calendar member SMSCALS xx. If SMSCALS xx is not used or function HSMMCCNV is not active, these days are not adjusted and this keyword value will be equal to the AE_REFAGE keyword value.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_CALAGE=nnnn

The nnnn variable represents a number from 0 to 9999.

AE_CATEGORY

The AE_CATEGORY parameter specifies the category of failing HSM function.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_CATEGORY=failCategory

The following table defines the values:

Option

Description

BACKUP

Includes daily backup, spill backup, ABACKUP, incremental backup, and BACKDS

DUMP

Specifies dump processing

MIGRATION

Includes the following migration actions:

  • ML0 to ML1

  • ML1 to ML2

  • ML0 to ML2

RECALL

Includes the following recall actions:

  • ML1 to ML0

  • ML2 to ML0

RECOVERY

Specifies recovery processing

RESTORE

Specifies restore processing

SPCMGMT

Includes space management:

  • Deleting migrated data set

  • Deleting temporary data sets

  • Deleting expired data set

  • Partial space release and extent reduction

OTHER

Specifies any exceptional action not covered by other values

AE_DSN

The AE_DSN parameter specifies the name of the data set against which the failing HSM function was performed.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_DSN=dsn

The dsn variable represents a 1- to 44-character valid data set name.

AE_DSNn

The AE_DSN n parameter specifies the data set name qualifier of the data set against which the failing HSM function was performed.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_DSN n=xxxxxxxx

The following list defines the variable values:

  • The n variable represents a number from 1 to 8 that specifies the position of the qualifier in data set name.

  • The xxxxxxxx variable represents a one- to eight-character valid data set name qualifier.

AE_DSORG

The AE_DSORG parameter specifies the data set organization.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_DSORG=xx

The values are defined as follows:

  • PS (Sequential)

  • DA (Direct access)

  • PO (Partitioned)

  • VS (VSAM)

AE_FRVOL

The AE_FRVOL parameter specifies the volser of the original (from) volume. If the HSM action is performed on only one volume, the value of this keyword will be equal to the value of the AE_TVOL keyword. This value is the volume on which the data set currently resides.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_FRVOL=xxxxxx

The xxxxxx variable represents a one- to six-character valid volume serial number.

AE_HLQ

The AE_HLQ parameter specifies the high-level data set name qualifier of the data set against which the failing HSM function was performed.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_HLQ=dsHlq

The dsHlq variable represents a one- to eight-character valid data set name qualifier.

AE_HOST

The AE_HOST parameter specifies the ID of HSM host performing the failing function.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_HOST=xx

The xx variable represents up to 2 characters of a valid HSM host ID.

AE_JOBNAME

The AE_JOBNAME parameter specifies the job name of the requestor of the failing HSM function. If the job name of the requestor is not available, filtration does not take place. To determine if the job name is available for the error, see the MAINVIW SRM HSM Error Detail view.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_JOBNAME=jobName

The jobName variable represents a one- to eight-character valid job name.

AE_LLQ

The AE_LLQ parameter specifies the low-level data set name qualifier of the data set against which the failing HSM function was performed.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_LLQ=xxxxxxxx

The xxxxxxxx variable represents a one- to eight-character valid data set name qualifier.

Example:

In the following example, the HSM error is selected if the low-level qualifier of the data set against which the HSM function was performed is LAST:

INC AE_LLQ=LAST

AE_LREF

The AE_LREF parameter specifies the date when the data set was last referenced.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_LREF=yyyy/mm/dd

AE_MGMTCL

The AE_MGMTCL parameter specifies the name of an SMS Management Class for the data set that the failing HSM function was performed against.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_MGMTCL=mgtClas

The mgtClas variable represents a one- to eight-character valid SMS Management Class name.

AE_POOL

The AE_POOL parameter specifies the name of a MainView SRM Pool in which the data set is found, based on the primary volume against which the failing HSM function was performed.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_POOL=pool

The pool variable represents a one- to eight-character valid MainView SRM Pool name.

AE_RC

The AE_RC parameter specifies the return code of the failing HSM function.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_RC=nnn

The nnn variable represents a return code from 1 to 9999.

AE_REFAGE

The AE_REFAGE parameter specifies the number of days since the data set was last referenced.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_REFAGE=nnnnn

The nnnnn variable represents a number of days from 1 to 9999.

AE_RSN

The AE_RSN parameter specifies the reason code of the failing HSM function.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_RSN=nnnn

The nnnn variable represents a number from 1 to 9999.

AE_SIZE

The AE_SIZE parameter specifies the data set size in bytes.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_SIZE=dsSize[K|M|G|T]

The dsSize is a 1- to 19-digit number. The number can optionally be suffixed with the characters K,M,G,T to specify whether the number is expressed in kilobytes, megabytes, gigabytes, or terabytes. The maximum allowable AE_SIZE value is 9223372036854775807 bytes.

AE_SMS

The AE_SMS parameter specifies whether the data set that the failing HSM function was performed against is managed by SMS.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_SMS=YES|NO|Y|N

AE_STORCL

The AE_STORCL parameter specifies the name of an SMS Storage Class for the data set that the failing HSM function is performed against.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_STORCL=storClass

The storClass variable represents a one- to eight-character valid SMS Storage Class name.

AE_STORGRP

The AE_STORGRP parameter specifies the name of an SMS Storage Group for the data set that the failing HSM function is performed against.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_STORGRP=StorGroup

The StorGroup variable represents a one- to eight-character valid SMS Storage Group name.

AE_TVOL

The AE_TVOL parameter specifies the volser of the receiving (to) volume. If the HSM action is performed on only one volume, the value of this keyword will be equal to the volser where the data set currently resides.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_TVOL=toVol

The toVol variable represents a one- to six-character valid volume serial number.

AE_USERID

The AE_USERID parameter specifies the user ID of the requestor of the failing HSM function. If the user ID of the failing function requestor is not available, filtration does not take place.

Allowed in:

INC/EXC in the AUTOHERR function

Syntax:

AE_USERID=userID

The userID variable represents a one- to eight-character valid TSO user ID.

AL_ACCCNT

The AL_ACCCNT parameter specifies an alias access count in the current Catalog Scan performance interval.

Allowed in:

INC/EXC in the AUTOCATA function

Syntax:

AL_ACCCNT=nnnnn

The nnnnn variable represents number from 0 to 9223372036854775807.

AL_ACCTIM

The AL_ACCTIM parameter specifies an alias average access time in the current Catalog Scan performance interval. The access time is in microseconds (0.000001 seconds).

Allowed in:

INC/EXC in the AUTOCATA function

Syntax:

AL_ACCTIM=nnnnn

The nnnnn variable represents number from 0 to 9223372036854775807.

Example:

AL_ACCTIM>1 specifies an access time greater than 1 microsecond.

AL_ACCTIM>10000 specifies an access time greater than 1 hundredth (.01) of a second.

AL_ACCTIMHC

The AL_ACCTIMHC parameter specifies the access count from the hour with the highest average access time in the current Catalog Scan performance interval.

Allowed in:

INC/EXC in the AUTOCATA function

Syntax:

AL_ACCTIMHC=nnnnn

The nnnnn variable represents number from 0 to 9223372036854775807.

AL_ACCTIMHR

The AL_ACCTIMHR parameter specifies the hour containing the highest average access time in the current Catalog Scan performance interval.

Allowed in:

INC/EXC in the AUTOCATA function

Syntax:

AL_ACCTIMHR=hh

The hh variable represents hours from 0 through to 23; 0 is the time range from 00:00 am to 00:59 am.

AL_ACCTIMHW

The AL_ACCTIMHW parameter specifies the highest average access time from all hours in the current Catalog Scan performance interval. The access time is in microseconds (0.000001 seconds).

Allowed in:

INC/EXC in the AUTOCATA function

Syntax:

AL_ACCTIMHW=nnnnn

The nnnnn variable represents number from 0 to 9223372036854775807.

Example:

AL_ACCTIMHW>1 specifies a HWM access time greater than 1 microsecond.

AL_ACCTIMHW>10000 specifies a HWM access time greater than 1 hundredth (0.01) of a second.

AL_ALIAS

The AL_ALIAS parameter specifies the alias name.

Allowed in:

INC/EXC in the AUTOCATA function

Syntax:

AL_ALIAS=aliasName

The aliasName variable represents a one- to forty-four-character valid alias name.

AL_DS#

The AL_DS# parameter specifies the data set entries associated with the alias.

Allowed in:

INC/EXC in the AUTOCATA function

Syntax:

AL_DS#=nnnnn

The nnnnn variable represents number from 0 to 2147483647.

AL_INMAST

The AL_INMAST specifies if the alias is defined in the master catalog.

Allowed in:

INC/EXC in the AUTOCATA function

Syntax:

AL_INMAST=YES | NO | Y | N

ALCTYPE

The ALCTYPE parameter contains and specifies the unit of space allocation. It applies to both primary and secondary space quantities.

Allowed in:

INC/EXC and rule SET parameter for function SPACSQTY

Syntax:

ALCTYPE=xxx

The values are defined as follows:

  • TRK (Tracks)

  • CYL (Cylinders)

  • KAV (AVGREC=K)

  • MAV (AVGREC=M)

  • UAV (AVGREC=U)

  • BLK (Blocks)

  • KB (A block allocation where PQTY and SQTY are assumed to be kilobytes)

  • MB (A block allocation where PQTY and SQTY are assumed to be megabytes)

ALTPOOL

The ALTPOOL parameter specifies the name of an alternate pool to search for additional space during secondary space allocation when no volumes are available in the current pool. The alternate pool search uses MNTYPE=ALL (mount type). See also the parameters SPACVOLA, MNTYPE, and USECPOOL.

Allowed in:

Rule SET parameter for function SPACVOLA

Syntax:

ALTPOOL=altPool

The altPool variable represents a one- to eight-character valid pool name.

AO_DA_CASPL

The AO_DA_CASPL parameter specifies to include or exclude a data set based on VSAM data component CA split count.

For data sets not using RLS, this count is the current total for the data component.

For data sets using RLS, this count is what has occurred for a current open under a job. If the data set is open under multiple jobs, each job will have their own separate values.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_DA_CASPL=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AO_DA_CISPL

The AO_DA_CISPL parameter specifies to include or exclude a data set based on VSAM data component CI split count.

For data sets not using RLS, this count is the current total for the data component.

For data sets using RLS, this count is what has occurred for a current open under a job. If the data set is open under multiple jobs, each job will have their own separate values.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_DA_CISPL=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AO_DA_DELS

The AO_DA_DELS parameter specifies to include or exclude a data set based on VSAM data component record deletions.

For data sets not using RLS, this count is the current total for the data component.

For data sets using RLS, this count is what has occurred for a current open under a job. If the data set is open under multiple jobs, each job will have their own separate values.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_DA_DELS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AO_DA_EXTS

The AO_DA_EXTS parameter specifies to include or exclude a data set based on VSAM data component extent count.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_DA_EXTS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AO_DA_HARBA

The AO_DA_HARBA parameter specifies to include or exclude a data set based on VSAM data component high allocated RBA.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_DA_HARBA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AO_DA_HURBA

The AO_DA_HURBA parameter specifies to include or exclude a data set based on VSAM data component high used RBA.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_DA_HURBA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AO_DA_INS

The AO_DA_INS parameter specifies to include or exclude a data set based on VSAM data component record inserts.

For data sets not using RLS, this count is the current total for the data component.

For data sets using RLS, this count is what has occurred for a current open under a job. If the data set is open under multiple jobs, each job will have their own separate values.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_DA_INS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AO_DA_PCTF

The AO_DA_PCTF parameter specifies to include or exclude a data set based on VSAM data component percentage full.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_DA_PCTF=nnn

The nnn variable represents a percentage from 0 to 100.

AO_DA_PCTFT

The AO_DA_PCTFT parameter specifies to include or exclude a data set based on VSAM data component percentage full (the number is in tenths).

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_DA_PCTFT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AO_DA_RECS

The AO_DA_RECS parameter specifies to include or exclude a data set based on VSAM data component total record count.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_DA_RECS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AO_DA_UPDS

The AO_DA_UPDS parameter specifies to include or exclude a data set based on VSAM data component record updates.

For data sets not using RLS, this count is the current total for the data component.

For data sets using RLS, this count is what has occurred for a current open under a job. If the data set is open under multiple jobs, each job will have their own separate values.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_DA_UPDS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AO_DSN

The AO_DSN parameter specifies the VSAM cluster, or mask of clusters, to include or exclude.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_DSN=xxxxxxxx

The xxxxxxxx variable represents a data set name or mask up to 44 characters.

AO_IX_EXTS

The AO_IX_EXTS parameter specifies to include or exclude a data set based on VSAM index component extent count.

Note: Non-indexed VSAM clusters automatically fail qualification when this keyword is specified.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_IX_EXTS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AO_IX_HARBA

The AO_IX_HARBA parameter specifies to include or exclude a data set based on VSAM index component high allocated RBA.

Note: Non-indexed VSAM clusters automatically fail qualification when this keyword is specified.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_IX_HARBA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AO_IX_HURBA

The AO_IX_HURBA parameter specifies to include or exclude a data set based on VSAM index component high used RBA.

Note: Non-indexed VSAM clusters automatically fail qualification when this keyword is specified.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_IX_HURBA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AO_IX_PCTF

The AO_IX_PCTF parameter specifies to include or exclude a data set based on VSAM index component percentage full.

Note: Non-indexed VSAM clusters automatically fail qualification when this keyword is specified.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_IX_PCTF=nnn

The nnn variable represents a percentage from 0 to 100.

AO_IX_PCTFT

The AO_IX_PCTFT parameter specifies to include or exclude a data set based on VSAM index component percentage full (the number is in tenths).

Note:   Non-indexed VSAM clusters automatically fail qualification when this keyword is specified.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_IX_PCTFT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AO_IX_RECS=

The AO_IX_RECS parameter specifies to include or exclude a data set based on VSAM index component total record count.

Note:   Non-indexed VSAM clusters automatically fail qualification when this keyword is specified.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_IX_RECS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AO_JOB

The AO_JOB parameter specifies a job name to include or exclude.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_JOB=xxxxxxxx

The xxxxxxxx variable represents a job name or mask up to 8 characters.

AO_JOBELAP

The AO_JOBELAP parameter specifies to include or exclude a data set based on the time (in minutes) a job has been running.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_JOBELAP=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AO_RLS

The AO_RLS parameter specifies to include or exclude a data set based on if RLS is being used.

Allowed in:

INC/EXC in AUTOOVSM function

Syntax:

AO_RLS=Y|N|YES|NO

AP_CTIGC

The AP_CTIGC parameter includes or excludes pools based on the largest contiguous free cylinders.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_CTIGC=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_CTIGCB

The AP_CTIGCB parameter includes or excludes pools based on the largest amount of contiguous free cylinders either on a non-EAV volume or in the BAS area of an EAV volume in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_CTIGCB<100

The value is a number from 0 to 2147483647.

AP_CTIGCE

The AP_CTIGCE parameter includes or excludes pools based on the largest amount of contiguous free cylinders in the EAS area of an EAV volume in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_CTIGCE<100

The value is a number from 0 to 2147483647.

AP_CTIGT

The AP_CTIGT parameter includes or excludes pools based on the largest contiguous free tracks.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_CTIGT=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_CTIGTB

The AP_CTIGTB parameter includes or excludes pools based on the largest contiguous free tracks either on a non-EAV volume or in the BAS area of an EAV volume in the pool.

Allowed in:

INC/EXC in the AUTOPOOL functions

Syntax:

INC AP_CTIGTB<100

The value is a number from 0 to 2147483647.

AP_CTIGTE

The AP_CTIGTE parameter includes or excludes pools based on the largest contiguous free tracks in the EAS area of an EAV volume in the pool.

Allowed in:

INC/EXC in the AUTOPOOL functions

Syntax:

INC AP_CTIGTE<100

The value is a number from 0 to 2147483647.

AP_DS#DA

The AP_DS#DA parameter includes or excludes pools based on the number of data sets that are allocated on volumes with an SMS status of DISABLED ALL.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DS#DA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DS#DN

The AP_DS#DN parameter includes or excludes pools based on the number of data sets that are allocated on volumes with an SMS status of DISABLED NEW.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DS#DN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DS#EN

The AP_DS#EN parameter includes or excludes pools based on the number of data sets that are allocated on volumes with an SMS status of ENABLED.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DS#EN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DS#NM

The AP_DS#NM parameter includes or excludes pools based on the number of data sets that are allocated on volumes with an SMS status of NOT SMS MANAGED.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DS#NM=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DS#NS

The AP_DS#NS parameter includes or excludes pools based on the number of data sets that are allocated on volumes with an SMS status of NO STATUS GIVEN.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DS#NS=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DS#QA

The AP_DS#QA parameter includes or excludes pools based on the number of data sets that are allocated on volumes with an SMS status of QUIESCED ALL.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DS#QA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DS#QN

The AP_DS#QN parameter includes or excludes pools based on the number of data sets that are allocated on volumes with an SMS status of QUIESCED NEW.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DS#QN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DTDB2

The AP_DTDB2 parameter specifies the number of data sets with DSNTYPE DB2 (DB2 table spaces).

Allowed in:

INC/EXC in AUTOPOOL function

Syntax:

AP_DTDB2=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_DTDBZ

The AP_DTDBZ parameter specifies the total size of data sets with DSNTYPE DB2 (DB2 table spaces).

Allowed in:

INC/EXC in AUTOPOOL function

Syntax:

AP_DTDBZ=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DTGDS

The AP_DTGDS parameter specifies the number of data sets with DSNTYPE GDS (generation data sets).

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTGDS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_DTGDZ

The AP_DTGDZ parameter specifies the total size of data sets with DSNTYPE GDS (generation data sets).

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTGDZ=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DTHFS

The AP_DTHFS parameter specifies the number of data sets with DSNTYPE HFS (hierarchical file system data sets).

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTHFS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_DTHFZ

The AP_DTHFZ parameter specifies the total size of data sets with DSNTYPE HFS (hierarchical file system data sets).

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTHFZ=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DTHSM

The AP_DTHSM parameter specifies the number of data sets with DSNTYPE HSM (HSM backup or migrate data sets).

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTHSM=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_DTHSZ

The AP_DTHSZ parameter specifies the total size of data sets with DSNTYPE HSM (HSM backup or migrate data sets).

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTHSZ=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DTLRG

The AP_DTLRG parameter specifies the number of data sets with DSNTYPE LRGE (large format data sets).

Allowed in:

INC/EXC in AUTOPOOL function

Syntax:

AP_DTLRG=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_DTLRZ

The AP_DTLRZ parameter specifies the total size of data sets with DSNTYPE LRGE (large format data sets).

Allowed in:

INC/EXC in AUTOPOOL function

Syntax:

AP_DTLRZ=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DTNVS

The AP_DTNVS parameter specifies the number of data sets with DSNTYPE NVSM. These are non-VSAM data sets that are not described by the following DSNTYPE values:

  • GDS (Generation data set)

  • HFS (Hierarchical file system data set)

  • HSM (HSM backup or migrate data set)

  • LRGE (Large format data set)

  • PDSE (Partitioned data set extended)

  • TEMP (Temporary data set)

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTNVS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_DTNVZ

The AP_DTNVZ parameter specifies the total size of data sets with DSNTYPE NVSM. These are non-VSAM data sets not described by the following DSNTYPE values:

  • GDS (Generation data set)

  • HFS (Hierarchical file system data set)

  • HSM (HSM backup or migrate data set)

  • LRGE (Large format data set)

  • PDSE (Partitioned data set extended)

  • TEMP (Temporary data set)

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTNVZ=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DTPDE

The AP_DTPDE parameter specifies the number of data sets with DSNTYPE PDE (PDSE data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AP_DTPDE=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_DTPDZ

The AP_DTPDZ parameter specifies the total size of data sets with DSNTYPE PDE (PDSE data sets).

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTPDZ=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DTTMP

The AP_DTTMP parameter specifies the number of data sets with DSNTYPE TMP (temporary data sets). This count is temporary data sets that existed on the volumes at collection time.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTTMP=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_DTTMZ

The AP_DTTMZ parameter specifies the total size of data sets with DSNTYPE TMP (temporary data sets). This number is the total size of temporary data sets that existed on the volumes at collection time.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTTMZ=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DTVSM

The AP_DTVSM parameter specifies the number of data sets with DSNTYPE VSAM. These are the VSAM data sets not described by the following DSNTYPE values:

  • DB2 (DB2 table space)

  • ZFS (zSeries file system data set)

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTVSM=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_DTVSZ

The AP_DTVSZ parameter specifies the total size of data sets with DSNTYPE VSAM. These are the VSAM data sets not described by the following DSNTYPE values:

  • DB2 (DB2 table space)

  • ZFS (zSeries file system data set)

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTVSZ=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_DTZFS

The AP_DTZFS parameter specifies the number of data sets with DSNTYPE ZFS (zSeries file system data set).

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTZFS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_DTZFZ

The AP_DTZFZ parameter specifies the total size of data sets with DSNTYPE ZFS (zSeries file system data set).

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_DTZFZ=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_FREEC

The AP_FREEC parameter includes or excludes pools based on the total count of free cylinders.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FREEC=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_FREECB

The AP_FREECB parameter includes or excludes pools based on the total count of free cylinders on non-EAV volumes and in the BAS area of EAV volume.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_FREECB<10000

The value is a number from 0 to 2147483647.

AP_FREECE

The AP_FREECE parameter includes or excludes pools based on the total count of free cylinders in the EAS area of EAV volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_FREECE<10000

The value is a number from 0 to 2147483647.

AP_FREED

The AP_FREED parameter includes or excludes pools based on the total number of free data set control blocks (DSCB) for all volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FREED=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_FREEDA

The AP_FREEDA parameter specifies the free size of SMS DISABLED ALL volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FREEDA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_FREEDN

The AP_FREEDN parameter specifies the free size of SMS DISABLED NEW volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FREEDN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_FREEEN

The AP_FREEEN parameter specifies the free size of SMS ENABLED volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FREEEN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_FREENG

The AP_FREENG parameter specifies the free size of SMS NOT GIVEN volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FREENG=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_FREEQA

The AP_FREEQA parameter specifies the free size of SMS QUIESCE ALL volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FREEQA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_FREEQN

The AP_FREEQN parameter specifies the free size of SMS QUIESCE NEW volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FREEQN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_FREET

The AP_FREET parameter includes or excludes pools based on the total count of free tracks.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FREET=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_FREETB

The AP_FREETB parameter includes or excludes pools based on the total count of free tracks on non-EAV volumes and in the BAS area of EAV volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_FREETB<10000

The value is a number from 0 to 2147483647.

AP_FREETE

The AP_FREETE parameter includes or excludes pools based on the total count of free tracks in the EAS area of EAV volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_FREETE<10000

The value is a number from 0 to 2147483647.

AP_FREEUN

The AP_FREEUN parameter specifies the free size of SMS UNMANAGED volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FREEUN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_FREEV

The AP_FREEV parameter includes or excludes pools based on the total number free index records in a volume’s VTOC index.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FREEV=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_FREEX

The AP_FREEX parameter includes or excludes pools based on the total number of free extents.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FREEX=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_FREEXB

The AP_FREEXB parameter includes or excludes pools based on the total count of free extents on non-EAV volumes and in the BAS area of EAV volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_FREEXB<10000

The value is a number from 0 to 2147483647.

AP_FREEXE

The AP_FREEXE parameter includes or excludes pools based on the total count of free extents in the EAS area of EAV volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_FREEXE<10000

The value is a number from 0 to 2147483647.

AP_FSIZE

The AP_FSIZE parameter includes or excludes pools based on the amount of free space in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_FSIZE=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_FSIZEB

The AP_FSIZEB parameter includes or excludes pools based on the amount of free space in bytes on non-EAV volumes and in the BAS area of EAV volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_FSIZEB<10000

The value is a number from 0 to 2147483647.

AP_FSIZEE

The AP_FSIZEE parameter includes or excludes pools based on the amount of free space in the pool in bytes in the EAS area of EAV volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_FSIZEE<10000

The value is a number from 0 to 2147483647.

AP_GROUP

The AP_GROUP parameter includes or excludes pools based on the pool, group, or subpool name.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_GROUP=xxxxxxxxx

The xxxxxxxxx variable represents a 1- to 30-character pool, group, or subpool name.

AP_HDFUL

The AP_HDFUL parameter includes or excludes pools based on the VVDS percentage full high-water mark.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HDFUL=nnn

The nnn variable represents a percentage from 1 to 100.

AP_HDFULT

The AP_HDFULT parameter includes or excludes pools based on high-water mark volume VVDS percentage full in tenths, which is the percentage full of the most utilized volume VVDS in the pool.

BMC recommends that the AP_HDFUL keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HDFULT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_HFULL

The AP_HFULL parameter includes or excludes pools based on the high-water mark volume percentage full, which is the percentage full of the highest utilized volume in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HFULL=nnn

The nnn variable represents a percentage up to 100.

AP_HFULLT

The AP_HFULLT parameter includes or excludes pools based on the high-water mark volume percentage full in tenths, which is the percentage full of the highest utilized volume in the pool.

BMC recommends that the AP_HFULL keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HFULLT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_HIFUL

The AP_HIFUL parameter includes or excludes pools based on the high-water mark volume VIR percentage full.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HIFUL=nnn

The nnn variable represents a percentage from 1 to 100.

AP_HIFULT

The AP_HIFULT parameter includes or excludes pools based on the high-water mark volume VIR percentage full in tenths, which is the percentage full of the most utilized volume VIR in the pool.

BMC recommends that the AP_HIFUL keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HIFULT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_HREEC

The AP_HREEVC parameter includes or excludes pools based on the high-water mark count of free cylinders.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HREEVC=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_HREECB

The AP_HREEVCB parameter includes or excludes pools based on the high-water mark count of free cylinders on non-EAV volumes and in the BAS area of EAV volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_HREEVCB<10000

The value is a number from 0 to 2147483647.

AP_HREECE

The AP_HREEVCE parameter includes or excludes pools based on the high-water mark count of free cylinders in the EAS area of EAV volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_HREEVCE<10000

The value is a number from 0 to 2147483647.

AP_HREED

The AP_HREED parameter includes or excludes pools based on the high-water mark count of free DSCBs.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HREED=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_HREET

The AP_HREET parameter includes or excludes pools based on the high-water mark count of free tracks.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HREET=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_HREETB

The AP_HREETB parameter includes or excludes pools based on the high-water mark count of free tracks on non-EAV volumes and in the BAS area of EAV volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_HREETB<10000

The value is a number from 0 to 2147483647.

AP_HREETE

The AP_HREETE parameter includes or excludes pools based on the high-water mark count of free tracks in the EAS area of EAV volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_HREETE<10000

The value is a number from 0 to 2147483647.

AP_HREEV

The AP_HREEV parameter includes or excludes pools based on the high-water mark count of free VIR.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HREEV=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_HREEX

The AP_HREEXB parameter includes or excludes pools based on the high-water mark count of free extent.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HREEXB=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_HREEXB

The AP_HREEXB parameter includes or excludes pools based on the high-water mark count of free extents on non-EAV volumes and in the BAS area of EAV volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_HREEXB<10000

The value range is a number from 0 to 2147483647.

AP_HREEXE

The AP_HREEXEB parameter includes or excludes pools based on the high-water mark count of free extents in the EAS area of EAV volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_HREEXEB<10000

The value is range is a number from 0 to 2147483647.

AP_HVFRG

The AP_HVFRG parameter includes or excludes pools based on the high-water mark fragmentation index.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HVFRG=nnn

The nnn variable represents percentage up to 100.

AP_HVFUL

The AP_HVFUL parameter includes or excludes pools based on the high-water mark VTOC percentage full.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HVFUL=nnn

The nnn variable represents percentage up to 100.

AP_HVFULT

The AP_HVFULT parameter includes or excludes pools based on the high-water mark volume VTOC percentage full in tenths, which is the VTOC percentage full of the most utilized volume VTOC in the pool.

BMC recommends that the AP_HVFUL keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_HVFULT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_IDLEDA

The AP_IDLEDA parameter specifies the idle size of SMS DISABLED ALL volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_IDLEDA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_IDLEDN

The AP_IDLEDN parameter specifies the idle size of SMS DISABLED NEW volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_IDLEDN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_IDLEEN

The AP_IDLEEN parameter specifies the idle size of SMS ENABLED volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_IDLEEN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_IDLENG

The AP_IDLENG parameter specifies the idle size of SMS NOT GIVEN volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_IDLENG=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_IDLEQA

The AP_IDLEQA parameter specifies the idle size of SMS QUIESCE ALL volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_IDLEQA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_IDLEQN

The AP_IDLEQN parameter specifies the idle size of SMS QUIESCE NEW volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_IDLEQN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_IDLEUN

The AP_IDLEUN parameter specifies the idle size of SMS UNMANAGED volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_IDLEUN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_ISIZE

The AP_ISIZE parameter indicates the total idle size in tracks of the VTOC indexes contained in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_ISIZE=nnnnn

The nnnnn variable represents a number between 0 and 9223372036854775807.

AP_LDFUL

The AP_LDFUL parameter includes or excludes pools based on the VVDS percentage full low-water mark.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LDFUL=nnn

The nnn variable represents a percentage from 1 to 100.

AP_LDFULT

The AP_LDFULT parameter includes or excludes pools based on the low-water mark volume VVDS percentage full in tenths, which is the percentage full of the least utilized volume VVDS in the pool.

BMC recommends that the AP_LDFUL keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LDFULT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_LFULL

The AP_LFULL parameter includes or excludes pools based on the low-water mark volume percentage full.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LFULL=nnn

The nnn variable represents percentage up to 100.

AP_LFULLT

The AP_LFULLT parameter includes or excludes pools based on the low-water mark volume percentage full in tenths, which is the percentage full of the least utilized volume in the pool.

BMC recommends that the AP_LFULL keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LFULLT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_LIFUL

The AP_LIFUL parameter includes or excludes pools based on the low-water mark volume VIR percentage full.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LIFUL=nnn

The nnn variable represents a percentage from 1 to 100.

AP_LIFULT

The AP_LIFULT parameter includes or excludes pools based on the low-water mark volume VIR percentage full in tenths, which is the percentage full of the least utilized volume VIR in the pool.

BMC recommends that the AP_LIFUL keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LIFULT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_LPRIC

The AP_LPRIC parameter includes or excludes pools based on the largest primary allocation (cylinders).

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LPRIC=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_LPRICB

The AP_LPRICB parameter includes or excludes pools based on the largest primary allocation (cylinders) either on a non-EAV volume or in the BAS area of an EAV volume in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_LPRICB<100

The value range is a number from 0 to 2147483647.

AP_LPRICE

The AP_LPRICE parameter includes or excludes pools based on the largest primary allocation (cylinders) in the EAS area of EAV volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_LPRICE<100

The value range is a number from 0 to 2147483647.

AP_LPRIT

The AP_LPRIT parameter includes or excludes pools based on the largest primary allocation (tracks).

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LPRIT=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_LPRITB

The AP_LPRITB parameter includes or excludes pools based on the largest primary allocation (tracks) either on a non-EAV volume or in the BAS area of an EAV volume in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_LPRITB<100

The value range is a number from 0 to 2147483647.

AP_LPRITE

The AP_LPRITE parameter includes or excludes pools based on the largest primary allocation (tracks) in the EAS area of an EAV volume in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_LPRITE<100

The value range is a number from 0 to 2147483647.

AP_LREEC

The AP_LREEC parameter includes or excludes pools based on the low-water mark free count of cylinders.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LREEC=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_LREECB

The AP_LREECB parameter includes or excludes pools based on the low-water mark count of free cylinders on non-EAV volumes and in the BAS area of EAV volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_LREECB<10000

The value range is a number from 0 to 2147483647.

AP_LREECE

The AP_LREECE parameter includes or excludes pools based on the low-water mark count of free cylinders in the EAS area of EAV volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_LREECE<10000

The value range is a number from 0 to 2147483647.

AP_LREED

The AP_LREED parameter includes or excludes pools based on the low-water mark free count of DSCBs.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LREED=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_LREET

The AP_LREET parameter includes or excludes pools based on the low-water mark free count of tracks.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LREET=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_LREETB

The AP_LREETB parameter includes or excludes pools based on the low-water mark count of free tracks on non-EAV volumes and in the BAS area of EAV volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_LREETB<10000

The value range is a number from 0 to 2147483647.

AP_LREETE

The AP_LREETE parameter includes or excludes pools based on the low-water mark count of free tracks in the EAS area of EAV volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_LREETE<10000

The value range is a number from 0 to 2147483647.

AP_LREEV

The LP_LREEV parameter includes or excludes pools based on the low-water mark free count of VIR.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

LP_LREEV=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_LREEX

The AP_LREEX parameter includes or excludes pools based on the low-water mark free count of extent.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LREEX=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_LREEXB

The AP_LREEXB parameter includes or excludes pools based on the low-water mark count of free extents on non-EAV volumes and in the BAS area of EAV volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_LREEXB<10000

The value range is a number from 0 to 2147483647.

AP_LREEXE

The AP_LREEXE parameter includes or excludes pools based on the low-water mark count of free extents in the EAS area of EAV volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_LREEXE<10000

The value range is a number from 0 to 2147483647.

AP_LVFRG

The AP_LVFRG parameter includes or excludes pools based on the low-water mark fragmentation index.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LVFRG=nnn

The nnn variable represents a percentage up to 100.

AP_LVFUL

The AP_LVFUL parameter includes or excludes pools based on the low-water mark of VTOC percentage full.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LVFUL=nnn

The nnn variable represents a percentage up to 100.

AP_LVFULT

The AP_LVFULT parameter includes or excludes pools based on the low-water mark volume VTOC percentage full in tenths, which is the percentage full of the least utilized volume VTOC in the pool.

BMC recommends that the AP_LVFUL keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_LVFULT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_NONVSDSC

The AP_NONVSDSC parameter includes or excludes pools based on the number of non-VSAM data sets that are defined in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_NONVSDSC=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_NONVSDSZ

The AP_NONVSDSZ parameter includes or excludes pools based on the number of bytes that are allocated to non-VSAM data sets defined in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_NONVSDSZ=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_PCTTDA

The AP_PCTTDA parameter specifies the percentage of total pool space for SMS DISABLED ALL volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTDA=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTTDAT

The AP_PCTTDAT parameter specifies the percentage of total pool space for SMS DISABLED ALL volumes in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTDAT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTTDN

The AP_PCTTDN parameter specifies the percentage of total pool space for SMS DISABLED NEW volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTDN=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTTDNT

The AP_PCTTDNT parameter specifies the percentage of total pool space for SMS DISABLED NEW volumes in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTDNT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTTEN

The AP_PCTTEN parameter specifies the percentage of total pool space for SMS ENABLED volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTEN=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTTENT

The AP_PCTTENT parameter specifies the percentage of total pool space for SMS ENABLED volumes in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTENT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTTNG

The AP_PCTTNG parameter specifies the percentage of total pool space for SMS NOT GIVEN volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTNG=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTTNGT

The AP_PCTTNGT parameter specifies the percentage of total pool space for SMS NOT GIVEN volumes in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTNGT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTTQA

The AP_PCTTQA parameter specifies the percentage of total pool space for SMS QUIESCE ALL volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTQA=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTTQAT

The AP_PCTTQAT parameter specifies the percentage of total pool space for SMS QUIESCE ALL volumes in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTQAT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTTQN

The AP_PCTTQN parameter specifies the percentage of total pool space for SMS QUIESCE NEW volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTQN=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTTQNT

The AP_PCTTQNT parameter specifies the percentage of total pool space for SMS QUIESCE NEW volumes in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTQNT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTTUN

The AP_PCTTUN parameter specifies the percentage of total pool space for SMS UNMANAGED volumes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTUN=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTTUNT

The AP_PCTTUNT parameter specifies the percentage of total pool space for SMS UNMANAGED volumes in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTTUNT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTUDA

The AP_PCTUDA parameter specifies the percentage used of SMS DISABLED ALL volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUDA=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTUDAT

The AP_PCTUDAT parameter specifies the percentage used of SMS DISABLED ALL volumes in the pool in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUDAT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTUDN

The AP_PCTUDN parameter specifies the percentage used of SMS DISABLED NEW volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUDN=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTUDNT

The AP_PCTUDNT parameter specifies the percentage used of SMS DISABLED NEW volumes in the pool in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUDNT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTUEN

The AP_PCTUEN parameter specifies the percentage used of SMS ENABLED volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUEN=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTUENT

The AP_PCTUENT parameter specifies the percentage used of SMS ENABLED volumes in the pool in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUENT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTUNG

The AP_PCTUNG parameter specifies the percentage used of SMS NOT GIVEN volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUNG=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTUNGT

The AP_PCTUNGT parameter specifies the percentage used of SMS NOT GIVEN volumes in the pool in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUNGT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTUQA

The AP_PCTUQA parameter specifies the percentage used of SMS QUIESCE ALL volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUQA=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTUQAT

The AP_PCTUQAT parameter specifies the percentage used of SMS QUIESCE ALL volumes in the pool in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUQAT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTUQN

The AP_PCTUQN parameter specifies the percentage used of SMS QUIESCE NEW volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUQN=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTUQNT

The AP_PCTUQNT parameter specifies the percentage used of SMS QUIESCE NEW volumes in the pool in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUQNT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PCTUUN

The AP_PCTUUN parameter specifies the percentage used of SMS UNMANAGED volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUUN=nnn

The nnn variable represents a percentage from 0 to 100.

AP_PCTUUNT

The AP_PCTUUNT parameter specifies the percentage used of SMS UNMANAGED volumes in the pool in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PCTUUNT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PERFL

The AP_PERFL parameter includes or excludes pools based on the pool percentage full based on used space as it relates to total space.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PERFL= nnn

The nnn variable represents a percentage from 0 to 100.

AP_PERFLB

The AP_PERFLB parameter includes or excludes pools based on the percentage of used space to total space in the pool, not including EAS space. This percentage includes non-EAV volume space and the BAS area of EAV volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_PERFLB<98

The value range is a percentage up to 100.

AP_PERFLBT

The AP_PERFLBT parameter includes or excludes pools based on the percentage of used space to total space in the pool, not including EAS space, in tenths. This percentage includes non-EAV volume space and the BAS area of EAV volumes in the pool in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_PERFLBT>980 (includes pool if value is greater than 98%)INC AP_PERFLBT>985 (includes pool if value is greater than 98.5%)

The value range is from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PERFLE

The AP_PERFLE parameter includes or excludes pools based on the percentage of used EAS space to total EAS space in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_PERFLE<98

The value range is a percentage up to 100.

AP_PERFLET

The AP_PERFLBT parameter includes or excludes pools based on the percentage of used EAS space to total EAS space in the pool in tenths.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_PERFLBT>985 (includes pool if value is greater than 98.5%)

The value range is from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_PERFLT

The AP_PERFLT parameter includes or excludes pools based on the pool percentage full in tenths based on used space as it relates to total space.

BMC recommends that the AP_PERFL keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_PERFLT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AP_SMDS#DA

The AP_SMDS#DA parameter includes or excludes pools based on the size of the smallest data set in bytes on a volume with an SMS status of DISABLED ALL.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SMDS#DA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SMDS#DN

The AP_SMDS#DN parameter includes or excludes pools based on the size of the smallest data set in bytes on a volume with an SMS status of DISABLED NEW.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SMDS#DN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SMDS#EN

The AP_SMDS#EN parameter includes or excludes pools based on the size of the smallest data set in bytes on a volume with an SMS status of ENABLED.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SMDS#EN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SMDS#NM

The AP_SMDS#NM parameter includes or excludes pools based on the size of the smallest data set in bytes on a volume with an SMS status of NOT MANAGED.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SMDS#NM=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SMDS#NS

The AP_SMDS#NS parameter includes or excludes pools based on the size of the smallest data set in bytes on a volume with an SMS status of NO STATUS GIVEN.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SMDS#NS=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SMDS#QA

The AP_SMDS#QA parameter includes or excludes pools based on the size of the smallest data set in bytes on a volume with an SMS status of QUIESCED ALL.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SMDS#QA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SMDS#QN

The AP_SMDS#QN parameter includes or excludes pools based on the size of the smallest data set in bytes on a volume with an SMS status of QUIESCED NEW.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SMDS#QN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SPACDA

The AP_SPACDA parameter includes or excludes pools based on the number of bytes that are allocated on volumes with an SMS status of DISABLED ALL.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SPACDA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SPACDN

The AP_SPACDN parameter includes or excludes pools based on the number of bytes that are allocated on volumes with an SMS status of DISABLED NEW.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SPACDN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SPACEN

The AP_SPACEN parameter includes or excludes pools based on the number of bytes that are allocated on volumes with an SMS status of ENABLED.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SPACEN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SPACNM

The AP_SPACNM parameter includes or excludes pools based on the number of bytes that are allocated on volumes with an SMS status of NOT SMS MANAGED.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SPACNM=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SPACNS

The AP_SPACNS parameter includes or excludes pools based on the number of bytes that are allocated on volumes with an SMS status of NO STATUS GIVEN.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SPACNS=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SPACQA

The AP_SPACQA parameter includes or excludes pools based on the number of bytes that are allocated on volumes with an SMS status of QUIESCED ALL.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SPACQA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_SPACQN

The AP_SPACQN parameter includes or excludes pools based on the number of bytes that are allocated on volumes with an SMS status of QUIESCED NEW.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_SPACQN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_STORGRP

The AP_STORGRP parameter specifies the pool, group, or subpool name.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_STORGRP=xxxxxxxx

The xxxxxxxx variable represents a pool, group, or subpool name up to eight characters.

AP_TOTALDA

The AP_TOTALDA parameter specifies the total size of SMS DISABLED ALL volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_TOTALDA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_TOTALDN

The AP_TOTALDN parameter specifies the total size of SMS DISABLED NEW volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_TOTALDN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_TOTALEN

The AP_TOTALEN parameter specifies the total size of SMS ENABLED volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_TOTALEN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_TOTALNG

The AP_TOTALNG parameter specifies the total size of SMS NOT GIVEN volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_TOTALNG=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_TOTALQA

The AP_TOTALQA parameter specifies the total size of SMS QUIESCE ALL volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_TOTALQA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_TOTALQN

The AP_TOTALQN parameter specifies the total size of SMS QUIESCE NEW volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_TOTALQN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_TOTALUN

The AP_TOTALUN parameter specifies the total size of SMS UNMANAGED volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_TOTALUN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_TSIZE

The AP_TSIZE parameter includes or excludes pools based on the total allocated space in bytes.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_TSIZE=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_TYPE

The AP_TYPE parameter includes or excludes pools based on the pool type.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_TYPE=xxxxxxxx

Valid values are: POOL, SUBPOOL, and STORGRP

AP_USEDDA

The AP_USEDDA parameter specifies the used size of SMS DISABLED ALL volumes in the pool.

Allowed in:

INC/EXC in AUTOPOOL function

Syntax:

AP_USEDDA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_USEDDN

The AP_USEDDN parameter specifies the used size of SMS DISABLED NEW volumes in the pool.

Allowed in:

INC/EXC in AUTOPOOL function

Syntax:

AP_USEDDN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_USEDEN

The AP_USEDEN parameter specifies the used size of SMS ENABLED volumes in the pool.

Allowed in:

INC/EXC in AUTOPOOL function

Syntax:

AP_USEDEN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_USEDNG

The AP_USEDNG parameter specifies the used size of SMS NOT GIVEN volumes in the pool

Allowed in:

INC/EXC in AUTOPOOL function

Syntax:

AP_USEDNG=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_USEDQA

The AP_USEDQA parameter specifies the used size of SMS QUIESCE ALL volumes in the pool.

Allowed in:

INC/EXC in AUTOPOOL function

Syntax:

AP_USEDQA=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_USEDQN

The AP_USEDQN parameter specifies the used size of SMS QUIESCE NEW volumes in the pool.

Allowed in:

INC/EXC in AUTOPOOL function

Syntax:

AP_USEDQN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_USEDUN

The AP_USEDUN parameter specifies the used size of SMS UNMANAGED volumes in the pool

Allowed in:

INC/EXC in AUTOPOOL function

Syntax:

AP_USEDUN=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_USIZE

The AP_USIZE parameter includes or excludes pools based on the amount of allocated space in the pool (used size).

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_USIZE=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AP_VOL#DA

The AP_VOL#DA parameter includes or excludes pools based on the number of volumes in the pool with an SMS status of DISABLED ALL.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_VOL#DA=nnnnnn

The nnnnnn variable represents a numeric value from 0 to 999999.

AP_VOL#DN

The AP_VOL#DN parameter includes or excludes pools based on the number of volumes in the pool with an SMS status of DISABLED NEW.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_VOL#DN=nnnnnn

The nnnnnn variable represents a numeric value from 0 to 999999.

AP_VOL#EN

The AP_VOL#EN parameter includes or excludes pools based on the number of volumes in the pool with an SMS status of ENABLED.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_VOL#EN=nnnnnn

The nnnnnn variable represents a numeric value from 0 to 999999.

AP_VOL#NM

The AP_VOL#NM parameter includes or excludes pools based on the number of volumes in the pool with an SMS status of NOT SMS MANAGED.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_VOL#NM=nnnnnn

The nnnnnn variable represents a numeric value from 0 to 999999.

AP_VOL#NS

The AP_VOL#NS parameter includes or excludes pools based on the number of volumes in the pool with an SMS status of NO STATUS GIVEN.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_VOL#NS=nnnnnn

The nnnnnn variable represents a numeric value from 0 to 999999.

AP_VOL#OFFL

The AP_VOL#OFFL parameter includes or excludes pools based on the number of volumes that are assigned to the group that is currently offline.

This field is available for storage groups only. Pools and subpools will always have a offline volume count of zero. This keyword should be used in conjunction with the AP_TYPE=STORGRP keyword to ensure that only storage groups are interrogated.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_VOL#OFFL=nnnnnn

The nnnnnn variable represents a numeric value from 0 to 999999.

AP_VOL#QA

The AP_VOL#QA parameter includes or excludes pools based on the number of volumes in the pool with an SMS status of QUIESCED ALL.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_VOL#QA=nnnnnn

The nnnnnn variable represents a numeric value from 0 to 999999.

AP_VOL#QN

The AP_VOL#QN parameter includes or excludes pools based on the number of volumes in the pool with an SMS status of QUIESCED NEW.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_VOL#QN=nnnnnn

The nnnnnn variable represents a numeric value from 0 to 999999.

AP_VOLC

The AP_VOLC parameter includes or excludes pools based on the number of online volumes in this pool on the collecting z/OS system.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_VOLC=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_VOLCE

The AP_VOLCE parameter includes or excludes pools based on the number of online EAV volumes in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

INC AP_VOLCE>0

The value range is a number from 0 to 2147483647.

AP_VOLFRAGH

The AP_VOLFRAGH parameter includes or excludes pools based on the highest fragmentation index value of all volumes in the pool. This value is the fragmentation index value for the most fragmented volume in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_VOLFRAGH=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent which represents the most fragmentation.

AP_VSAMDSC

The AP_VSAMDSC parameter includes or excludes pools based on the number of VSAM data sets that are defined in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_VSAMDSC=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AP_VSAMDSZ

The AP_VSAMDSZ parameter includes or excludes pools based on the number of bytes that are allocated to VSAM data sets that are defined in the pool.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AP_VSAMDSZ=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

APPL

The APPL parameter specifies the Storage Guard Control Application to use for filtering for the following EZSRMHSM views:

  • Backup data sets (HSMBKDS)

  • Backup DSN versions (HSMBKVR)

  • Migrated data sets (HSMMGDS)

  • TDSDD (Tape management data set details by DSN view)

Allowed in:

Flst INC/EXC statements in HSM CDS filtering, Flst PARMLIB members SMFE14xx, SMFE15xx and SMFE17xx.

Syntax:

APPL=applicationName

The applicationName variable represents an alphanumeric Storage Guard Control Application name from 1 to 50 characters long.

Note: If the application name contains a blank or space within it, the application name must be contained within single quotes. For example, if the application name is APPL TEST, enter 'APPL TEST'.

Default:If not specified then there is no filtration based on this keyword.
ATL_LIBNAME

The ATL_LIBNAME parameter specifies or contains the name of an Automated Tape Library. MainView SRM name masking can be used for filter list entries.

Allowed in data set filtering FLST members

Syntax:

ATL_LIBNAME=xxxxxxxx

The xxxxxx variable represents a valid one- to eight-character Automated Tape Library name.

AUTOLEV

The AUTOLEV parameter contains an 8-character literal AUTOLEV x, where x is a number indicating the current automation level for the resource being automated

AUTOLEV0 indicates that multiple levels are not being used. AUTOLEV1 indicates the first level of a multiple level request. For multiple level automation this field must be used either in this FLST/RLST member or contained within event text of any event issued and then referenced in the MANIVIEW AutoOPERATOR rule that looks for the event.

Allowed in:

INC/EXC in the AUTO functions

Syntax:

AUTOLEV=xxxxxxxx

AV_CTIGC

The AV_CTIGC parameter specifies the largest single extent in full cylinders available for allocation.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_CTIGC=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_CTIGCB

The AV_CTIGCB parameter specifies the largest single extent in full cylinders available for allocation either on a non-EAV volume or in the BAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_CTIGCB<100

The value range is a number from 0 to 2147483647.

AV_CTIGCE

The AV_CTIGCE parameter specifies the largest single extent in full cylinders available for allocation in the EAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_CTIGCE<100

The value range is a number from 0 to 2147483647.

AV_CTIGT

The AV_CTIGT parameter specifies the largest single extent in tracks available for allocation.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_CTIGT=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_CTIGTB

The AV_CTIGTB parameter specifies the largest single extent in tracks available for allocation either on a non-EAV volume or in the BAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_CTIGTB<100

The value range is a number from 0 to 2147483647.

AV_CTIGTE

The AV_CTIGTE parameter specifies the largest single extent in tracks available for allocation in the EAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_CTIGTE<100

The value range is a number from 0 to 2147483647.

AV_DEVTYPE

The AV_DEVTYPE parameter includes or excludes volumes based on the emulated device type.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DEVTYPE=DevType

Defined values are:

  • 3380

  • 3380A

  • 3380D

  • 3380E

  • 3380J

  • 3380K

  • 3380-1

  • 3380-2

  • 3380-3

  • 3390

  • 3390-1

  • 3390-2

  • 3390-3

  • 3390-9

  • 3390-27

  • 3390-54

  • 3390-EAV

AV_DSMINBYT

The AV_DSMINBYT parameter contains the size of the smallest data set on the volume in bytes.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DSMINBYT=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AV_DSNC

The AV_DSNC parameter includes or excludes volumes based on the number of data sets on a volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DSNC=nnnnnn

The nnnnnn variable represents a number of data sets from 1 to 999999.

AV_DSNCE

The AV_DSNCE parameter includes or excludes volumes based on the number of data sets in the EAS area of the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_DSNCE>0

The value range is a number of data sets from 1 to 999999.

AV_DTDB2

The AV_DTDB2 parameter specifies the number of data sets with DSNTYPE DB2 (DB2 table spaces).

Allowed in:

INC/EXC in AUTOVOL function

Syntax:

AV_DTDB2=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_DTDBZ

The AV_DTDBZ parameter specifies the total size in tracks of data sets with DSNTYPE DB2 (DB2 table spaces).

Allowed in:

INC/EXC in AUTOVOL function

Syntax:

AV_DTDBZ=nnnnn

The nnnnn variable represents a number of tracks from 0 to 2147483647.

AV_DTGDS

The AV_DTGDS parameter specifies the number of data sets with DSNTYPE GDS (generation data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTGDS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_DTGDZ

The AV_DTGDZ parameter specifies the total size in tracks of data sets with DSNTYPE GDS (generation data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTGDZ=nnnnn

The nnnnn variable represents a number of tracks from 0 to 2147483647.

AV_DTHFS

The AV_DTHFS parameter specifies the number of data sets with DSNTYPE HFS (hierarchical file system data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTHFS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_DTHFZ

The AV_DTHFZ parameter specifies the total size in tracks of data sets with DSNTYPE HFS (hierarchical file system data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTHFZ=nnnnn

The nnnnn variable represents a number of tracks from 0 to 2147483647.

AV_DTHSM

The AV_DTHSM parameter specifies the number of data sets with DSNTYPE HSM (HSM backup or migrate data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTHSM=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_DTHSZ

The AV_DTHSZ parameter specifies the total size in tracks of data sets with DSNTYPE HSM (HSM backup or migrate data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTHSZ=nnnnn

The nnnnn variable represents a number of tracks from 0 to 2147483647.

AV_DTLRG

The AV_DTLRG parameter specifies the number of data sets with DSNTYPE LRGE (large format data sets).

Allowed in:

INC/EXC in AUTOVOL function

Syntax:

AV_DTLRG=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_DTLRZ

The AV_DTLRZ parameter specifies the total size in tracks of data sets with DSNTYPE LRGE (large format data sets).

Allowed in:

INC/EXC in AUTOVOL function

Syntax:

AV_DTLRZ=nnnnn

The nnnnn variable represents a number of tracks from 0 to 2147483647.

AV_DTNVS

The AV_DTNVS parameter specifies the number of data sets with DSNTYPE NVSM. These are non-VSAM data sets that are not described by the following DSNTYPE values:

  • GDS (Generation data set)

  • HFS (Hierarchical file system data set)

  • HSM (HSM backup or migrate data set)

  • LRGE (Large format data set)

  • PDSE (Partitioned data set extended)

  • TEMP (Temporary data set)

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTNVS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_DTNVZ

The AV_DTNVZ parameter specifies the total size in tracks of data sets with DSNTYPE NVSM. These are non-VSAM data sets that are not described by the following DSNTYPE values:

  • GDS (Generation data set)

  • HFS (Hierarchical file system data set)

  • HSM (HSM backup or migrate data set)

  • LRGE (Large format data set)

  • PDSE (Partitioned data set extended)

  • TEMP (Temporary data set)

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTNVZ=nnnnn

The nnnnn variable represents a number of tracks from 0 to 2147483647.

AV_DTPDE

The AV_DTPDE parameter specifies the number of data sets with DSNTYPE PDE (PDSE data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTPDE=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_DTPDZ

The AV_DTPDZ parameter specifies the total size in tracks of data sets with DSNTYPE PDE (PDSE data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTPDZ=nnnnn

The nnnnn variable represents a number of tracks from 0 to 2147483647.

AV_DTTMP

The AV_DTTMP parameter specifies the number of data sets with DSNTYPE TMP (temporary data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTTMP=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_DTTMZ

The AV_DTTMZ parameter specifies the total size in tracks of data sets with DSNTYPE TMP (temporary data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTTMZ=nnnnn

The nnnnn variable represents a number of tracks from 0 to 2147483647.

AV_DTVSM

The AV_DTVSM parameter specifies the number of data sets with DSNTYPE VSAM. These are VSAM data sets that are not described by the following DSNTYPE values:

  • DB2 (DB2 table space)

  • ZFS (zSeries file system data set)

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTVSM=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_DTVSZ

The AV_DTVSZ parameter specifies the total size in tracks of data sets with DSNTYPE VSAM. These are VSAM data sets that are not described by the following DSNTYPE values:

  • DB2 (DB2 table space)

  • ZFS (zSeries file system data set)

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTVSZ=nnnnn

The nnnnn variable represents a number of tracks from 0 to 2147483647.

AV_DTZFS

The AV_DTZFS parameter specifies the number of data sets with DSNTYPE ZFS (zSeries file system data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTZFS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_DTZFZ

The AV_DTZFZ parameter specifies the total size in tracks of data sets in tracks with DSNTYPE ZFS (zSeries file system data sets).

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_DTZFZ=nnnnn

The nnnnn variable represents a number of tracks from 0 to 2147483647.

AV_EAVI

The AV_EAVI parameter specifies whether the volume is an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_EAVI=Y | N | YES | NO

AV_FBYTE

The AV_FBYTE parameter indicates the number of free bytes on the volume. This number is calculated by multiplying the track size in bytes by the number of free tracks on the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_FBYTE=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AV_FBYTEB

The AV_FBYTEB parameter specifies the amount of used space in a non-EAV volume or in the BAS area of an EAV volume, in bytes.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_FBYTEB>1M

The value range is a number from 0 to 2147483647.

AV_FBYTEE

The AV_FBYTEE parameter specifies the amount of used space in the EAS area of an EAV volume in bytes.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_FBYTEE>1M

The value range is a number from 0 to 2147483647.

AV_FRAGI

The AV_FRAGI parameter contains the fragmentation index value of the volume. The higher the value, the more fragmented the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_FRAGI=nnnn

The nnnn variable represents a number from 0 to 1000.

AV_FRAGIB

The AV_FRAGIB parameter specifies the fragmentation index value of a non-EAV volume or in the BAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_FRAGIB<500

The value range is from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AV_FRAGIE

The AV_FRAGIE parameter specifies the fragmentation index value of the EAS area of an EAV volume. Higher values mean that the volume is more fragmented.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_FRAGIE<500

The value range is from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AV_FREEC

The AV_FREEC parameter specifies the number of free cylinders on the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_FREEC=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_FREECB

The AV_FREECB parameter specifies the number of free cylinders on a non-EAV volume or in the BAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_FREECB<1000

The value range is a number from 0 to 2147483647.

AV_FREECE

The AV_FREECE parameter specifies the number of free cylinders in the EAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_FREECE<1000

The value range is a number from 0 to 2147483647.

AV_FREED

The AV_FREED parameter contains the number of free (Format 0) DSCBs on the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_FREED=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_FREET

The AV_FREET parameter specifies the number of free tracks on the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_FREET=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_FREETB

The AV_FREETB parameter specifies the number of free tracks on a non-EAV volume or in the BAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_FREETB<1000

The value range is a number from 0 to 2147483647.

AV_FREETE

The AV_FREETE parameter specifies the number of free tracks in the EAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_FREETE<1000

The value range is a number from 0 to 2147483647.

AV_FREEV

The AV_FREEV parameter contains the number of free VIRs (VTOC index records) on the volume

Allowed in:

INC/EXC in the AUTOVOL function.

Syntax:

AV_FREEV=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_FREEX

The AV_FREEX parameter specifies the total amount of free extents on the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_FREEX=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_FREEXB

The AV_FREEXB parameter specifies the number of free extents on a non-EAV volume or in the BAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_FREEXB<1000

The value range is a number from 0 to 2147483647.

AV_FREEXE

The AV_FREEXE parameter specifies the number of free extents in the EAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_FREEXE<1000

The value range is a number from 0 to 2147483647.

AV_FSIZE

The AV_FSIZE parameter specifies the number of tracks not used on the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_FSIZE=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_FULL

The AV_FULL parameter specifies the percentage of used space to total space for the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_FULL=nnn

The nnn variable represents a percentage up to 100.

AV_FULLB

The AV_FULLB parameter specifies the percentage of used space to total space in the BAS area of an EAV volume. For non-EAV volume, this value is the total volume percentage full.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_FULLB<98

The value range is from 0 to 100.

AV_FULLBT

The AV_FULLBT parameter specifies the percentage of used space to total space in the BAS area of an EAV volume in tenths. For non-EAV volume, this value is the total volume percentage full.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_FULLBT=nnnn

Example:

INC AV_FULLBT> 980 (includes volume if value is greater than 98%)

INC AV_FULLBT> 985 (includes volume if value is greater than 98.5%)

The value range is from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AV_FULLE

The AV_FULLE parameter specifies the percentage of used EAS space to total EAS space on an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_FULLE<98

The value range is from 0 to 100.

AV_FULLET

The AV_FULLET parameter specifies the percentage of used EAS space to total EAS space on an EAV volume in tenths.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_FULLET=nnnn

Example:

INC AV_FULLET> 980 (includes volume if value is greater than 98%)

INC AV_FULLET> 985 (includes volume if value is greater than 98.5%)

The value range is from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AV_FULLT

The AV_FULLT parameter specifies the volume percentage full in tenths based on used space as it relates to total space.

BMC recommends that the AV_FULL keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AV_FULLT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AV_IDLETRKS

The AV_IDLETRKS parameter includes or excludes volumes based on the number of idle tracks on a volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_IDLETRKS=nnnnnn

The nnnnnn variable represents a number from 1 to 999999.

AV_IPCTF

The AV_IPCTF parameter specifies the VTOC index percentage full.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_IPCTF=nnn

The nnn variable represents a percentage from 0 to 100.

AV_IPCTFT

The AV_IPCTFT parameter specifies the VIR percentage in tenths based on used space as it relates to total space in the VTOC index.

BMC recommends that the AV_IPCTF keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AV_IPCTFT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AV_ISIZE

The AV_ISIZE parameter specifies the total size in tracks of the VTOC index.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_ISIZE=nnnnn

The nnnnn variable represents a number of tracks from 0 to 2147483647.

AV_LPRIC

The AV_LPRIC parameter specifies the largest possible primary extent on the volume in cylinders. This value is the sum of the five largest extents on the volume.

Allowed in:

INC/EXC in the AUTOVOL functions

Syntax:

INC AV_LPRIC<500

The value range is a number from 0 to 2147483647.

AV_LPRICB

The AV_LPRICB parameter specifies the largest possible primary extent on a non-EAV volume or in the BAS area of an EAV volume, in cylinders. This value is the sum of the five largest extents on a non-EAV volume or in the BAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL functions

Syntax:

INC AV_LPRICB<500

The value range is a number from 0 to 2147483647.

AV_LPRICE

The AV_LPRICE parameter specifies the largest possible primary extent in the EAS area of an EAV volume in cylinders. This value is the sum of the five largest extents in the EAS area of and EAV volume.

Allowed in:

INC/EXC in the AUTOVOL functions

Syntax:

INC AV_LPRICE>10M

The value range is a number from 0 to 2147483647.

AV_LPRIT

The AV_LPRIT parameter specifies the largest possible primary extent in tracks.

This value is sum of the five largest extents on the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_LPRIT=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_LPRITB

The AV_LPRITB parameter specifies the largest possible primary extent on a non-EAV volume or in the BAS area of an EAV volume, in tracks. This value is the sum of the five largest extents on a non-EAV volume or in the BAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_LPRITB<1000

The value range is a number from 0 to 2147483647.

AV_LPRITE

The AV_LPRITE parameter specifies the largest possible primary extent in the EAS area of an EAV volume in tracks. This value is the sum of the five largest extents in the EAS area of an EAV volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_LPRITE<1000

The value range is a number from 0 to 2147483647.

AV_MNT

The AV_MNT parameter contains an indictor of how the volume is mounted.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_MNT=xxx

The values are defined as follows:

  • PUB (Public)

  • PVT (Private)

  • STG (Storage)

  • SYS (System)

AV_PID

The AV_PID parameter contains the physical disk ID.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_PID=xxxxxxxxxxx

The xxxxxxxxxxx variable represents a physical disk name of 1-11 characters.

AV_POLICY

The AV_POLICY parameter includes or excludes volumes based on the policy to which the volume is assigned.

When volumes are assigned to more than one policy, the value in this field will contain either the policy name associated with this run of the AUTOVOL function or the first policy to which the volume is assigned. All of the policies to which the volume is assigned can be viewed in the Configuration views.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_POLICY=xxxxxxxx

The xxxxxxxx variable represents a one- to eight-character policy name.

AV_POOL

The AV_POOL parameter indicates the pool or subpool name associated with the record.

The pool or subpool name is the name of the pool or subpool specified on the AUTOVOL command, regardless of whether the volume is included in more than one pool or subpool.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_POOL=poolName

The poolName variable represents a one- to eight-character pool name.

AV_PTYP

The AV_PTYP parameter indicates the type of pool or subpool.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_PTYP=P | S

  • P (Pool)

  • S (Subpool)

AV_RAIDTYP

The AV_RAIDTYP parameter includes or excludes volumes based on the type of RAID device.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_RAIDTYP=xxxxxxxxx

Defined values are:

  • RAMAC
  • RAMAC2
  • RAMAC3
  • RVA
  • SYMMETRIX
  • 2105-ESS
  • 2105
  • DS8000
  • NON-RAID
AV_RVABYTS

The AV_RVABYTS parameter includes or excludes volumes based on the number of back-end shared bytes that are assigned to the volume.

This value is associated with volumes on RVA devices. This keyword should be used in conjunction with the AV_RTYPE=RVA keyword to ensure that only volumes on RVA devices are interrogated. Volumes that do not exist on an RVA volume will have an AV_RVABYTS value of zero.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_RVABYTS=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AV_RVABYTU

The AV_RVABYTU parameter includes or excludes RVA volumes based on the number of back-end unique bytes that are assigned to the volume. This value is associated with volumes on RVA devices.

This keyword should be used in conjunction with the AV_RTYPE=RVA keyword to ensure that only volumes on RVA devices are interrogated. Volumes that do not exist on an RVA volume will have an AV_RVABYTU value of zero.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_RVABYTU=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AV_RVADEVID

The AV_RVADEVID parameter includes or excludes RVA volumes based on the device ID that is assigned within the RVA box. This value is associated with volumes on RVA devices.

This keyword should be used in conjunction with the AV_RTYPE=RVA keyword to ensure that only volumes on RVA devices are interrogated. Volumes that do not exist on an RVA volume will have an AV_RVADEVID value of zero.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_RVADEVID=xxxx

The xxxx variable represents a one- to four-character device ID.

AV_RVADEVN

The AV_RVADEVN parameter includes or excludes RVA volumes based on the RVA device name that is assigned to the volume. This value is associated with volumes on RVA devices.

This keyword should be used in conjunction with the AV_RTYPE=RVA keyword to ensure that only volumes on RVA devices are interrogated. Volumes that do not exist on an RVA volume will have an AV_RVADEVN value of zero.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_RVADEVN=xxxxxxxx

The xxxxxxxx variable represents a one- to eight-character descriptive volume name.

AV_RVASSF

The AV_RVASSF parameter includes or excludes RVA volumes based on the name of the RVA subsystem frame on which they exist.

This value is associated with volumes on RVA devices. This keyword should be used in conjunction with the AV_RTYPE=RVA keyword to ensure that only volumes on RVA devices are interrogated. Volumes that do not exist on an RVA volume will have an AV_RVASSF value of zero.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_RVASSF=xxxxxxxx

The xxxxxxxx variable represents a one- to eight-character subsystem frame name.

AV_SMSGP

The AV_SMSGP parameter contains the SMS-assigned storage group name.

If the volume is not SMS managed, this field will be blank.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_SMSGP=xxxxxxxxxxxxxxxx

The xxxxxxxxxxxxxxx variable represents a 1- to 30-character SMS group name.

AV_SMSI

The AV_SMSI parameter contains the SMS status of the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_SMSI=xx

The values are defined as follows:

  • M (SMS managed)

  • QA (SMS quiesced all)

  • QN (SMS quiesced new)

  • DA (SMS disabled all)

  • DN (SMS disabled new)

  • UN (Not SMS managed)

  • NA (Unknown)

AV_SSID

The AV_SSID parameter includes or excludes volumes based on the subsystem ID.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_SSID=xxxx

AV_STORGRP

The AV_STORGRP parameter contains the SMS-assigned storage group name. If the volume is not SMS-managed, this field will be blank.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_STORGRP=storGrp

The storGrp variable represents a one- to eight-character SMS group name.

AV_TBYTE

The AV_TBYTE parameter indicates the number of bytes on the volume.

This number is calculated by multiplying the track size in bytes by the number of tracks on the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_TBYTE=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AV_TSIZE

The AV_TSIZE parameter specifies the total volume size in tracks.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_TSIZE=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_UBYTE

The AV_UBYTE parameter specifies the number of used bytes on the volume.

This number is calculated by multiplying the track size in bytes by the number of used tracks on the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_UBYTE=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

AV_UBYTEB

The AV_UBYTEB parameter specifies the amount of used space on a non-EAV volume or in the BAS area of an EAV volume in bytes.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_UBYTEB>10M

The value range is a number from 0 to 2147483647.

AV_UBYTEE

The AV_UBYTEE parameter specifies the amount of used space in the EAS area of an EAV volume in bytes.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_UBYTEE>10M

The value range is a number from 0 to 2147483647.

AV_UCB

The AV_UCB parameter contains the device number for the volume (four hexadecimal digits). Masking characters are not allowed with this parameter; it is treated as a number.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_UCB=hhhh

The hhhh variable represents a hexadecimal number from 0001 to FFFF.

AV_USEDEXTS

The AV_USDEXTS parameter includes or excludes volumes based on the number of used extents on the volume.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_USDEXTS=nnnnnn

The nnnnnn variable represents a number from 0 to 999999.

AV_USIZE

The AV_USIZE parameter specifies the amount of space used on the volume in tracks.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_USIZE=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AV_USIZEB

The AV_USIZEB parameter specifies the amount of used space on a non-EAV volume or in the BAS area of an EAV volume in tracks.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_USIZEB>10000

The value range is a number of tracks from 0 to 2147483647.

AV_USIZEE

The AV_USIZEE parameter specifies the amount of used space in the EAS area of an EAV volume in tracks.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

INC AV_USIZEE>10000

The value range is a number of tracks from 0 to 2147483647.

AV_VOL

The AV_VOL parameter contains the volume serial number.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_VOL=xxxxxx

The xxxxxx variable represents a one- to six-character volume serial number.

AV_VPCTF

The AV_VPCTF parameter specifies the VVDS percentage full.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_VPCTF=nnn

The nnn variable represents a percentage from 0 to 100.

AV_VPCTFT

The AV_VPCTFT parameter specifies the VTOC percentage in full tenths.

BMC recommends that the AV_VPCTF keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AV_VPCTFT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AV_VSIZE

The AV_VSIZE parameter specifies the total size in tracks of the VVDS.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_VSIZE=nnnnn

The nnnnn variable represents a number of track from 0 to 2147483647.

AV_VTOCF

The AV_VTOCF parameter contains the percentage of used VTOC space.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_VTOCF=nnn

The nnn variable represents a percentage up to 100.

This percentage is a whole number, no decimal places.

AV_VTOCFT

The AV_VTOCFT parameter specifies the VTOC percentage in full tenths.

BMC recommends that the AV_VTOCF keyword be used to specify whole number percentage values. This keyword can be used when more granularity is needed.

Allowed in:

INC/EXC in the AUTOPOOL function

Syntax:

AV_VTOCFT=nnnn

The nnnn variable represents a value from 0 to 1000, in tenths of a percent, where 1000 means 100 percent.

AV_VTOCI

The AV_VTOCI parameter contains the VTOC index status.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_VTOCI=xxx

The values are defined as follows:

  • ACT – VTOC Index is defined and active.

  • INA – VTOC Index is defined but is not active.

  • UND – VTOC Index is not defined.

  • DIS – VTOC has had an index that has been disabled.

AV_VTOCZ

The AV_VTOCZ parameter contains the volumes VTOC size in tracks.

Allowed in:

INC/EXC in the AUTOVOL function

Syntax:

AV_VTOCZ=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

AVL

The AVL parameter specifies the average block size for BLK allocations and record length for KAV, MAV, and UAV allocations.

Allowed in:

Rule SET parameter for functions SPACSQTY and SPACAQTY

Syntax:

AVL=nnnnn

The nnnnn variable represents a number from 1 to 32767.

Default:AVL=9000
BACKCMD

The BACKCMD parameter specifies whether the DFSMShsm backup initiated by command (instead of automatically) is allowed or disallowed. If BACKCMD=Y is specified, HSMBACKP is activated both for backups initiated automatically and on command. If BACKCMD=N, HSMBACKP is activated only for automatic backup processing.

Allowed in:

Rule SET parameter for function HSMBACKP

Syntax:

BACKCMD=YES | NO | Y | N

Default :BACKCMD=Y
BACKPCMD

The BACKPCMD parameter specifies whether this backup is command initiated.

Allowed in:

INC/EXC in the HSMBACKP function

Syntax:

BACKPCMD=YES | NO | Y | N

BACKUP

The BACKUP parameter specifies the inclusion of data sets and volumes in DFSMShsm backup processing in function HSMBACKP. BACKUP=N excludes selected resources from DFSMShsm backup processing. The default is NO.

For MainView SRM function HSMMIGRT, specifies that migration direct from ML0 to ML2 is allowed without a DFSMShsm backup copy of the data set. The default is Y.

Allowed in:

Rule SET parameter for functions HSMBACKP, HSMMIGRT

Syntax:

BACKUP=YES | NO | Y | N

BCDS

The BCDS parameter specifies if DFSMShsm BCDS information should be collected when performing a VTOC scan.

Allowed in:

SMVSCFxx INC or EXC statement

Syntax:

BCDS=YES | NO | Y | N

Default:

BCDS=NO

BCDS_ACTSIZ

The BCDS_ACTSIZ parameter specifies if DFSMShsm backup space usage should be actual or an estimate. Calculating an estimate is based on the space used by the most current backup version of a data set. By estimating, less BCDS retrievals are required which reduces the elapsed time of the VTOC scan execution.

Allowed in:

SMVSCFxx INC or EXC statement

Syntax:

BCDS_ACTSIZ=YES | NO | Y | N

Default:

BCDS_ACTSIZ=NO

BKPTOTV

The BKPTOTV parameter specifies the total number of HSM backup versions that HSM will retain for the cataloged data set.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for HSMBKDS Backup data set view.

Syntax:

BKPTOTV=nnnn

The variable represents a number from 0 to 9999.

Example:

This example specifies 5 as the total number of HSM backup versions that HSM will retain for the cataloged data set.

BKPTOTV=5

Default:

If not specified then there is no filtration based on this keyword.

BKPVER

The BKPEVER parameter specifies the current number of HSM backup versions for the cataloged data set.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for HSMBKDS Backup data set view.

Syntax:

BKPVER=nnnn

The variable nnnn represents a number from 0 to 9999.

Example:

This example specifies 5 as the current number of HSM backup versions for the cataloged data set.

BKPVER=5

Default:

If not specified then there is no filtration based on this keyword.

BLKSIZE

The BLKSIZE parameter specifies or contains the block size of a data set. A specification of zero requests a system determined block size (if supported by your release of z/OS and DFP).

In a filter list specification, greater than (>) or less than (<) signs can be used instead of the equals sign (=).

Allowed in:

INC/EXC and rule SET parameter for function OPTBLKSZ and data set filtering FLST members

Syntax:

BLKSIZE=nnnnn

The nnnnn variable represents a number in the range 0 to 32,760.

BOXSERIAL

The BOXSERIAL parameter specifies the five-position box serial number. This keyword allows you to build pools of volumes based on the box in which the volume exists.

The box serial number is unavailable for offline volumes. Offline volumes will have a box serial number of blanks until the volume is brought online. There is no filter available for a box serial number of blanks.

Allowed in:

INC/EXC statement for function AUTOADDV

Syntax:

BOXSERIAL=nnnnn

The nnnnn variable represents the right five positions of the 12-position number box serial number that can be found on the BOXCNFG view or in the VOLCNFG view.

Example:

This example selects the candidate volume if it exists on box serial 05520. The SRMJOB09 skeleton JCL member is used to initialize the device.

SET ACT_JOB=SRMJOB09INC BOXSERIAL=05520

BUFSP

The BUFSP parameter contains and specifies the buffer space for the cluster or the data component of VSAM data sets. Any existing buffer space specification is overridden.

Note: A BUFSP value that is too small will be ignored by VSAM. Generally, a value less than {2 x data CISIZE} for non-indexed files or a value less than {2 x data CISIZE+1x index CISIZE} for indexed files will be too small.

Allowed in:

INC/EXC and rule SET parameter for function VSAMCNTL

Syntax:

BUFSP=nnnnnn

The nnnnnn variable represents a number in the range from 0 to 16776704.

BYPASS_ENQ

The BYPASS_ENQ parameter indicates whether the ENQ on the SYSDSN resource ( qname=SYSDSN, rname=dsname) should be bypassed before expanding the PDS directory.

The default is NO. Care must be taken when setting this parameter to YES. When YES is specified, a reader of the PDS could encounter unpredictable results during the PDS directory expansion.

Allowed in:

Rule SET parameter for function PDSDIRAD

Syntax:

BYPASS_ENQ=YES | NO | Y | N

Default :BYPASS_ENQ=NO
BYTES

The BYTES parameter specifies the amount of space in bytes on the candidate volume.

Allowed in:

INC/EXC statement for function AUTOADDV

Syntax:

BYTES=nnnnnnnnnnK|M|G|T

The nnnnnnnnnn variable represents 1 to 10 digits and K,M,G,T specifies whether the number is expressed in kilobytes, megabytes, gigabytes, or terabytes.

Example:

This example selects the volume if the target storage group begins with GROUP* and the space on the candidate volume is greater than nine gigabyte. The SRMJOB09 skeleton JCL member is used to initialize the device.

SET ACT_JOB=SRMJOB09

INC GROUP=GROUP* BYTES>9G

CAL

The CAL parameter specifies that dates must be adjusted by the specifications in the MainView SRM nonworking day calendar; for example, an expiration date is calculated using the retention period in days plus the number of nonworking days in that period.

Allowed in:

Rule SET parameter for functions HSMMCCNV, HSMMIGRT, and SETEXPDT

Syntax:

CAL=YES | NO | Y | N

CALAGE

The CALAGE parameter contains the calendar-adjusted unreferenced day count set by the HSMMIGRT function. The number of nonworking days is subtracted from the unreferenced day count.

Allowed in:

INC/EXC and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS – Backup data set view

  • HSMBKVR – Backup DSN version

  • HSMMGDS – Migrated data set view

  • TDSDD – Tape management data set details by DSN view

Syntax:

CALAGE=nnnnn

The nnnnn variable represents a number of days from 0 to 99999.

CAND_VOL

The CAND_VOL parameter specifies the volume serial number of the candidate volume that is being taken from the candidate pool.

The FLST/RLST statements get invoked for each volume in the candidate pool, one at a time, starting with the first volser in ascending volser order. The first volume to match an FLST and RLST statement is used, and subsequent volumes are not run through the function for this iteration of the AUTOADDV request command. The CAND_VOL value will change with each run through the AUTOADDV function for this request.

Use caution when using this keyword. Filtering on a specific volser could prevent the facility from working except on the first iteration.

Allowed in:

INC/EXC statement for function AUTOADDV

Syntax:

CAND_VOL=volser | volserMask

The volser or volserMask variable represents a valid volume serial number or mask up to six characters.

Example:

This example selects the volume if the volser begins with MMI and the storage group being added to is GROUPABC. The SRMJOB09 skeleton JCL member is used to initialize the device.

SET ACT_JOB=SRMJOB09

INC GROUP=GROUPABC CAND_VOL=MMI/

CANDIDATE

The CANDIDATE parameter specifies whether the IDCAMS DEFINEVOL=() list for a VSAM data set is used as an indicator of secondary volume allocation. If CANDIDATE=Y, the number of DEFINEd volumes is used to select that many candidate volumes from the MainView SRM pool. If CANDIDATE=N, no secondary volumes are assigned or available through normal z/OS processing (but SPACVOLA can be used to assign secondary volumes from a MainView SRM pool). Note that with specification of the CANDIDATE parameter, the candidate volumes are assigned from the pool, not from those volumes specified in the IDCAMS DEFINE VOL list. Note also that CANDIDATE overrides NVOLVSAM.

Allowed in:

Rule SET parameter for function DASDPOOL

Syntax:

CANDIDATE=YES | NO | Y | N

Default:

CANDIDATE=N

CAT

The CAT parameter contains the name of the catalog for a data set. MainView SRM name masking can be used.

Allowed in:

INC/EXC

Syntax:

CAT=catalog

The catalog variable represents a valid catalog name from 1 to 44 characters.

CATALOG

The CATALOG parameter contains and specifies the removal of the CATALOG parameter during VSAM cluster definition.

Allowed in:

INC/EXC and rule SET parameter for function VSAMCNTL

Syntax:

CATALOG=YES | NO | Y | N | BLANK

If Y is specified, the CATALOG parameter is allowed in the DEFINE CLUSTER definition; if N is specified, the CATALOG parameter is removed from the DEFINE CLUSTER definition when used in an INC/EXC statement. Blank indicates that no specification for CATALOG was made in the IDCAMS statements.

Note: When used as a selection parameter, this parameter is only valid for VSAM data sets.

CATLGTDS

The CATLGTDS parameter specifies whether a cataloged tape data set is selected.

Allowed in:

data set filtering FLST members

Syntax:

CATLGTDS =Y | N | YES | NO

CATLGVER

The CATLGVER parameter indicates whether backup versions of data sets cataloged on the correct volume and at the time that the backup version was made are to be displayed by EZSRMHSM view SMBKVR (Backup Data Set Versions).

Allowed in:

Flst INC statements in data set backup versions filtering Flst PARMLIB member SMFE15xx.

Syntax:

CATLGVER =ONLY | N | NO | Y | YES

The values are defined as follows:

  • ONLY – Displays only backup versions of the data sets cataloged at the time of backup.

  • NO – Displays backup versions of data sets that were not cataloged at the time of backup.

  • YES – Displays all backup versions.

Default:

CATLGVER =YES

CISIZE

The CISIZE parameter specifies the value of the data or cluster or index control interval size in the corresponding component of the IDCAMS control cards. Any existing specification of control interval size is overridden.

Allowed in:

INC/EXC and rule SET parameter for function VSAMCNTL

Syntax:

CISIZE=size

or

CISIZE=(size,index)

The size variable represents the data or cluster control interval size and the index variable represents the index control interval size from 0 to 999999.

COMP

The COMP parameter specifies whether a tape data set is to be compressed. (IDRC must be supported by the allocated cartridge device.)

Allowed in:

Rule SET parameter for function TAPECOMP

Syntax:

COMP=YES | NO | Y | N

CONTIG

The CONTIG parameter contains and specifies whether a data set is allocated with contiguous space required.

Allowed in:

INC/EXC and rule SET parameter for function SPACSQTY and SPACAQTY

Syntax:

CONTIG=YES | NO | Y | N

CREATEDAGE

The CREATEDAGE parameter contains the number of days since the data set was created.

For tape scan data set filtering, this number is calculated by subtracting the creation date from the tape scan date. If the creation date is not available, filtration does not take place.

Allowed in:

data set filtering FLST members

Syntax:

CREATEDAGE =nnnnn

The nnnnn variable represents a number from 0 to 99999.

CREATEDATE

The CREATEDATE parameter contains the 10-character creation date of the data set in yyyy/mm/dd format. If the creation date is not available, filtration does not take place.

Allowed in:

Data set filtering FLST members

Syntax:

CREATEDATE =yyyy/mm/dd

CREATEDCAGE

The CREATEDCAGE parameter contains the calendar-adjusted day count since the creation date.

For tape scan data set filtering, this number is calculated by subtracting the creation date from the tape scan date. If the creation date is not available, filtration does not take place.

Allowed in:

Data set filtering FLST members

Syntax:

CREATEDCAGE =nnnnn

The nnnnn variable represents a number from 0 to 99999.

CRITBIAS

The CRITBIAS parameter defines the number of data sets that can reside on the volume before the current allocation.

Allowed in:

Rule SET parameter for function DASDPOOL, FDRASIST, and SMSSELCT

Syntax:

CRITBIAS=n

The n variable represents a number of data sets from 1 to 9.

Note: This parameter works only in conjunction with VOLSEL=CRITDSN.

CRITEMC

The CRITEMC parameter specifies whether the volume meeting CRITDSN criteria includes EMC physical volumes. If yes, data sets specified with CRITDSN should not reside on the same EMC Physical volume nor the same MVS Logical volume. If no, data sets specified with CRITDSN can reside on the same EMC physical volume.

Allowed in:

Rule SET parameter for function DASDPOOL, FDRASIST, and SMSSELCT

Syntax:

CRITEMC=YES | NO | Y | N

Default:CRITEMC=NO
CRITFAIL

Defines the allocation process if a volume that meets the criteria cannot be found. If YES is specified, allocation fails; if NO is specified, allocation is directed to the best available volume in the first pool and the system tries the next pool. If no acceptable volume is found, CRITFAIL is processed on the saved volume.

Allowed in:

Rule SET parameter for function DASDPOOL, FDRASIST, and SMSSELCT

Syntax:

CRITFAIL=YES | NO | Y | N

Default:

CRITFAIL=N

Note:   This parameter works only in conjunction with VOLSEL=CRITDSN.

CRITLIST

The table that contains allocation volumes.

Allowed in:

Rule SET parameter for function DASDPOOL, FDRASIST, and SMSSELCT

Syntax:

CRITLIST=xxxxxxxx

Note:   This parameter works only in conjunction with VOLSEL=CRITDSN.

Warning

CRITDSN is resource intensive and should be used only for a small list of critical data sets. It should not be used without considering the impact on the system.

CURDAY

The CURDAY parameter includes or excludes the data set if the specified day has been met.

Allowed in:

INC/EXC

Syntax:

CURDAY= ( xxx,xxx,xxx,...)

The following keywords can be combined by enclosing keywords within parentheses and separating them with commas. The operator on this keyword must be equal or not equal.

CURDAY=(SUN,MON,...)

CURDAY=(SUNDAY,MONDAY,...)

CURDAY=(END_OF_MONTH)

CURDAY=(LAST_SUN_OF_MONTH,...)

CURDAY=(LAST_SUNDAY_OF_MONTH,...)

CURDAY=(LAST_WEEKENDDAY_OF_MONTH)

CURDAY=(LAST_WEEKDAY_OF_MONTH)

CURDAY=(FIRST_DAY_OF_MONTH)

CURDAY=(FIRST_SUN_OF_MONTH,...)

CURDAY=(FIRST_SUNDAY_OF_MONTH,...)

CURSPACE

The CURSPACE parameter contains the number of bytes that the data set will use after adding the current space request.

Allowed in:

INC/EXC

Syntax:

CURSPACE=nnnnnnK|M|G|T

CURTIME

The CURTIME parameter contains the current time of day. The time is in the form of hh:mm:ss

Allowed in:

INC/EXC

Syntax:

CURTIME=hh:mm:ss

The hh:mm:ss variable represents the time of day.

DADSM_FUNC

The DADSM_FUNC parameter contains the current point in allocation for most Allocation functions.

Allowed in:

INC/EXC

Syntax:

DADSM_FUNC=xxxxxxxx,xxxxxxxx,...

The following table defines the values:

Value

Description

JCL

Indicates that the function is processed at JFCB housekeeping

ALLOCATE

Indicates that the function is being processed at IGGPRE00 ALLOCATE

This value is valid for SMSSELCT if SMS_ALLOC has been set to Y and for FDRASIST.

EXTENDNV

Indicates that the function is being processed at IGGPRE00 EXTENDNV (extend to a new volume)

This value is valid for SMSSELCT if SMS_EXTEND has been set to Y.

RENAME

Indicates that the function is being processed at IGGPRE00 RENAME

This value is valid for DASDPOOL if DP_RENAME has been set to Y and for SMSMCREN.

DATACLAS

The DATACLAS parameter specifies or contains the name of a DFSMS data class. MainView SRM name masking can be used for filter list entries. Rule list entries must specify a valid data class name.

Allowed in:

INC/EXC and rule SET parameter for function SMSACSDC

Syntax:

DATACLAS=dataClas

The dataClas variable represents a valid one- to eight-character data class name.

DD

The DD parameter contains the data definition statement name from a JCL statement. MainView SRM name masking can be used.

Allowed in:

INC/EXC

Syntax:

DD=dataDef

The dataDef variable represents a valid one- to eight-character DD name.

DEF_SPCUNIT

The DEF_SPCUNIT parameter specifies the space unit of the PQTY and SQTY keywords and the space unit used in allocation of the data set for VSAM IDCAMS-defined data sets.

After the primary and secondary allocation amounts have been computed, the amounts are then converted (if necessary) to the specified unit.

This optional keyword is ignored for data sets that are not VSAM IDCAMS defined, including VSAM JCL-defined data sets.

Allowed in:

Rule SET parameter for function SPACAQTY

Syntax:

DEF_SPCUNIT=xxx

The values are defined as follows:

  • TRK (Tracks)

  • CYL (Cylinders)

  • REC (Records)

  • KB (Kilobytes)

  • MB (Megabytes)

Note: For REC, 4089 is the default record size if it is not specified in the DEFINE statement. The unit type is taken from the DEFINE statement.

DEFUNIT

The DEFUNIT parameter specifies the default unit name for volumes located outside STK silos.

Allowed in:

Rule SET parameter for function STKSUPP.

Syntax:

DEFUNIT=defUnit

The defUnit variable represents a generic unit name.

Default:DEFUNIT=3480
DESC

The DESC rule SET statement can be used to associate a text description with the solution. This description is displayed in views to help identify each solution.

Allowed in:

Rule SET parameter for AUTODS, AUTOVOL, and AUTOPOOL functions

Syntax:

DESC=description...

The description variable represents a 1- to 32-character policy description. If the description contains embedded blanks, it must be enclosed in single quotation marks.

DEVTYPE

The DEVTYPE parameter contains the type of device. For all functions except OPTBLKSZ, valid values are DASD, TAPE, or UNKN. For OPTBLKSZ, valid values are TAPE, 3380, and 3390.

The UNKN (unknown) device type is used for devices that are neither DASD nor TAPE and for devices that are requested by specific unit address.

Allowed in:

INC/EXC

Syntax:

DEVTYPE=xxxx

The xxxx variable represents a valid device type name: DASD, TAPE, UNKN, 3380, or 3390.

DIR

The DIR parameter contains and specifies the number of directory blocks for partitioned data sets.

Allowed in:

INC/EXC and rule SET parameter for function SPACSQTY and SPACAQTY

Syntax:

DIR=dirBlocks

The dirBlocks variable represents a number in of directory blocks from 1 to 32767.

DIR_BLOCKS= RLST parameter

The DIR_BLOCKS parameter specifies the number of directory blocks to add to the PDS that experiences an out-of-space condition on the directory.

Allowed in:

SET RLST in function PDSDIRAD

Syntax:

DIR_BLOCKS=nn

The nn variable is a number from 1 to 99.

Default :DIR_BLOCKS=1
DISPn

The DISP n parameter contains a data set disposition. DISP1 is the first JCL DISP subparameter (status); DISP2 is the second JCL DISP subparameter (normal termination disposition); and DISP3 is the third JCL DISP subparameter (abnormal termination disposition).

Allowed in:

INC/EXC

Syntax:

DISP n=xxxxxx

The values are defined as follows:

  • DISP1 (NEW, OLD, SHR, MOD)

  • DISP2 (DELET, KEEP, PASS, CATLG, UNCAT)

  • DISP3 (DELET, KEEP, CATLG, UNCAT)

DPORDEF

The DPORDEF parameter specifies the default response time for device selection based on DASD performance. The default value is used when response time information has not been accumulated for a device, such as when it has just been brought online.

DPORDEF can only be specified in conjunction with DPORMIN/MAX.

Note: The DASD Performance Optimization feature requires that VOLSEL=DPO be specified in order to select a device based on performance.

Allowed in:

Rule SET parameter for function DASDPOOL and SMSSELCT

Syntax:

DPORDEF=nnn

The nnn variable represents the default response time in milliseconds from 0 to 999 that will be substituted for unavailable information for a specific device.

DPORMAX

The DPORMAX parameter specifies the maximum response time objective for device selection based on DASD performance.

DPORMAX is normally specified in conjunction with DPORMIN.

Note that the DASD Performance Optimization feature requires that VOLSEL=DPO be specified in order to select a device based on performance.

Allowed in:

Rule SET parameter for functions DASDPOOL and SMSSELCT

Syntax:

DPORMAX=nnn

The nnn variable represents the maximum response time in milliseconds from 0 to 999 that will be considered for device selection based on performance.

DPORMIN

The DPORMIN parameter specifies the minimum response time objective for device selection based on DASD performance.

DPORMIN is normally specified in conjunction with DPORMAX.

Note that the DASD Performance Optimization feature requires that VOLSEL=DPO be specified in order to select a device based on performance.

Allowed in:

Rule SET parameter for function DASDPOOL and SMSSELCT

Syntax:

DPORMIN=nnn

The nnn variable represents the minimum response time in milliseconds from 0 to 999 that will be considered for device selection based on performance.

DPORSEP

The DPORSEP parameter specifies the response time value that is used to force selection of different volumes for data sets in the same job step.

When multiple data sets are allocated in a single job step and device selection based on DASD performance is specified for some or all, this separation factor is added to the current response time for previously used volumes in order to increase the likelihood that new allocations will go to a different volume.

DPORSEP can only be specified in conjunction with PORMIN/MAX.

Note that the DASD Performance Optimization feature requires that VOLSEL=DPO be specified in order to select a device based on performance.

Allowed in:

Rule SET parameter for function DASDPOOL and SMSSELCT

Syntax:

DPORSEP=nnn

The nnn variable represents the response time in milliseconds from 0 to 999 that will be used to enhance data set separation across volumes.

DPOWIND

The DPOWIND parameter specifies the window (length of the performance interval) that is used to analyze the response characteristics of DASD devices for selection based on performance.

Note: The DASD Performance Optimization feature requires that VOLSEL=DPO be specified in order to select a device based on performance.

Allowed in:

Rule SET parameter for function DASDPOOL and SMSSELCT

Syntax:

DPOWIND=nnnn

The nnnn variable represents the number of seconds from 0 to 999 over which the performance analysis will be made.

DSN

The DSN parameter contains the data set name. MainView SRM name masking can be used.

Allowed in:

INC/EXC and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS – Backup data set view

  • HSMBKVR – Backup DSN version

  • HSMMGDS – Migrated data set view

  • TDSDD – Tape management data set details by DSN view

Syntax:

DSN=dataSetName...

The dataSetName variable represents a valid one- to forty-four-character data set name.

DSNAME

Synonym. See DSN.

DSNn

The DSN n parameter specifies or contains a data set name qualifier. MainView SRM name masking can be used for filter list entries.

Allowed in:

INC/EXC, rule SET parameter for functions DSNCHECK and AUTODS, and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view

  • HSMBKVR - Backup DSN version

  • HSMMGDS - Migrated data set view

  • TDSDD - Tape management data set details by DSN view

Syntax:

DSN n=xxxxxxxx

The following list defines the variable values:

  • The n variable represents a number from 1 to 8 specifying the qualifier position in the data set name.

  • The xxxxxx variable represents a valid one- to eight-character data set qualifier name.

DSNTYPE

The DSNTYPE parameter contains the data set name type (but only if it is specified in the JCL).

Allowed in:

INC/EXC.

Syntax:

DSNTYPE=xxx

The values are defined as follows:

  • PDS – Partitioned data set

  • LIB – Extended partitioned data set

  • HFS – Hierarchical file system (open z/OS)

  • LRG – Large

  • PIP – Pipe (open z/OS)

  • STR – Striped

  • DB2 – IBM DB2 database

  • IAM – VSAM replacement access method (This value cannot be set during NOCATLG2, SPACPRIM, or SPACSWIR processing. The required data set is not yet open when these functions are processed.) The use of IAM with DSNTYPE is deprecated and may be removed in a future release. To test whether a data set is an IAM data set use the IAM_DS keyword.

Note: The application collector supports only LIB, HFS, and STR.

DSORG

The DSORG parameter contains the data set organization.

Allowed in:

INC/EXC and FLST INC/EXC statements in data set filtering FLST members for:

HSMMGDS - Migrated data set view

TDSDD - Tape management data set details by DSN view

Syntax:

DSORG=xxxx

The following table defines the values:

Value

Description

DA

Direct Access (BDAM)

IS

Indexed Sequential (ISAM)

PO

Partitioned Data Set (BPAM)

PS

Physical Sequential (QSAM)

VS

VSAM

--

The data set organization could not be determined or the data set was never opened.

DSORGE

The DSORGE parameter contains the data set organization.

Allowed in:

INC/EXC and FLST INC/EXC statements in data set filtering FLST members for:

HSMBKDS - Backup data set view

Syntax:

DSORGE=xxx

The following table defines the values:

Value

Description

HFS

Hierarchical file system data set

PS

Physical Sequential (QSAM)

PSU

Physical Sequential Unmovable

PO

Partitioned Data Set (BPAM)

POU

Partitioned Data Set Unmovable

VS

VSAM

DA

Direct Access (BDAM)

DAU

Direct Access Unmovable

IS

Indexed Sequential (ISAM)

- -

The data set organization could not be determined or the data set was never opened

DSORGF

The DSORGF parameter contains the data set organization.

Allowed in:

INC/EXC and FLST INC/EXC statements in data set filtering FLST members for:

HSMBKVR - Backup DSN version

Syntax:

DSORGF=xxxx

The following table defines the values:

Value

Description

PDSE

Partitioned data set extended

HFS

Hierarchical file system data set

PS

Physical Sequential (QSAM)

PSU

Physical Sequential Unmovable

PO

Partitioned Data Set (BPAM)

POU

Partitioned Data Set Unmovable

VS

VSAM

DAU

Direct Access Unmovable

IS

Indexed Sequential (ISAM)

- -

The data set organization could not be determined or the data set was never opened.

DSTYPE

The DSTYPE parameter contains the data set type.

Allowed in:

INC/EXC

Syntax:

DSTYPE=xxxx

The values are defined as follows:

  • PERM (Permanent data set)

  • TEMP (Temporary data set)

  • GDG (Generation data set)

DYNALLOC

The DYNALLOC parameter contains the allocation type (dynamic or JCL).

Allowed in:

INC/EXC

Syntax:

DYNALLOC=YES | NO | Y | N

ENVIR

The ENVIR parameter specifies the DFSMS allocation environment.

Note: This parameter is not available for functions SPACPRIM, SPACSECA, SPACSECB, SPACSECI, SPACSECR, SPACSWIR, and SPACVOLA.

Allowed in:

INC/EXC

Syntax:

ENVIR=xxxxx

The values are defined as follows:

  • ALLOC (New data set allocations)

  • RECALL (Data set recall operations)

  • RECOVER (Data set recover operations)

  • CONVERT (Data set convert-in-place operations)

  • STORE (OSREQ object store environment)

  • CHANGE (OSREQ object change environment)

  • CTRANS (OSMC object class transition environment)

  • OTHER (Set by installation exit)

During a RENAME operation, the DSNCHECK function sets this parameter to RENAME, which allows different naming standards on data set renames, if desired.

ERASE

The ERASE parameter contains and specifies the removal of the ERASE parameter during cluster definition.

Allowed in:

INC/EXC and rule SET parameter for function VSAMCNTL

Syntax:

ERASE=YES | NO | Y | N

If Y is specified the ERASE parameter is forced in the DEFINE CLUSTER definition; if N is specified, the ERASE parameter is removed from the DEFINE CLUSTER definition.

Note: When used as a selection parameter, this parameter is only valid for VSAM data sets.

EVENTID

The EVENTID parameter specifies the identifier assigned to the user event in SMEVNTxx.

Allowed in:

Rule SET parameter allowed in FLST or RLST of any function except USERVARS and the AUTO functions (see ACT_EVENTID=For use in AUTO functions)

Note: If EVENTID= is used on an FLST SET statement with MODE=INACT, the event will still be issued.

Syntax:

EVENTID=xxxxx

The xxxxx variable represents the five-character string specified on the EVNTID parameter in SMEVNT xx.

EXPDT

The EXPDT parameter contains and specifies the expiration date for a data set.

Allowed in:

INC/EXC, rule SET parameter for function SETEXPDT, and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS – Backup data set view

  • HSMBKVR – Backup DSN version

  • HSMMGDS – Migrated data set view

  • TDSDD – Tape management data set details by DSN view

Syntax:

EXPDT=yyddd

or

EXPDT=yyyyddd

The variable values are defines as follows:

  • The yyddd variable represents a Julian date for 1900 to 1999.

  • The yyyyddd variable represents a Julian date for any year.

EXPTYPE

The EXPTYPE parameter specifies the type of expiration to select. This parameter can be combined with the EXPTYPENUM parameter create a specific filter for the tape data set records that do not contain an actual expiration date. The content of the tape data set expiration date field is identified by the expiration type values below.

Allowed in:

Data set filtering FLST members

Syntax:

EXPTYPE=x

The values are defined as follows:

  • By expiration date:

    • D – Expiration date (use with TAPE_EXPDT)

    • J – Expiration date from JCL (use with TAPE_EXPDT)

  • For Control-T Tape Management Software:

    • C – Number of cycles

    • E – Controlled by EDM

    • I – Number of days in vault

    • L – Days since last reference

    • M – Controlled by the MVS catalog

    • P – Permanent

    • S – Controlled by the SMS class

    • V – Controlled by the vault

  • For CA-1 Tape Management Software:

    • K – CA-1 EXPDT keyword per the following list

  • The following CA-1 EXPDT values are available with EXPTYPE=K:

    • 88 uuu – User defined tape not under TMS control

    • 90 ddd – Tape will be retained for ddd days and then pass to MVS control

    • 98000 – Nonresident tape not under TMS control

    • 98 ddd – Days since last reference

    • 99000 – Controlled by the MVS catalog

    • 99366 – Permanent

    • 99 ccc – Number of cycles

EXPTYPENUM

This parameter can be combined with the EXPTYPE parameter to create a specific filter for the tape data set records that do not contain an actual expiration date. The EXPTYPENUM parameter specifies the numerical value in the expiration date field to select.

Allowed in:

Data set filtering FLST members

Syntax:

EXPTYPENUM=nnnnn

Note: EXPTYPENUM will not filter tape data sets records that an expiration type (EXPTYPE) of D, J, or blank.

EXTENT

The EXTENT parameter contains the number of extents for a data set.

Allowed in:

INC/EXC

Syntax:

EXTENT=nnn

The nnn variable represents a number of extents from 1 to 123. The comparison operator symbol can be equals (=), greater than (>), or less than (<).

FDEV

The FDEV parameter specifies the device type of the primary volume from which data set was migrated/backed up by HSM.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKVR - Backup DSN version, and

  • HSMMGDS - Migrated data set view.

Syntax:

FDEV=xxxxxx

The xxxxxx variable represents a 4- to 6-character device type as shown in the following list:

  • 3390

  • 3380

  • 3330-1

  • 3375

  • 3350

  • 3340

  • 3330

  • 2314

  • 2305-2

  • 9345

Example:

This example specifies migrated/backed up data sets that resided on 3380 device at the time of HSM action.

FGEV=3380

FILESEQ

The FILESEQ parameter contains the file sequence number of the data set.

Note: This parameter is not available for functions SPACPRIM, SPACSECA, SPACSECB, SPACSECI, SPACSECR, SPACSWIR, and SPACVOLA.

Allowed in:

INC/EXC

Syntax:

FILESEQ=nnnnnn

The nnnnnn variable represents a file sequence number from 0 to 999999.

FORCE

The FORCE parameter specifies whether the program specified block size should be overridden.

Allowed in:

Rule SET parameter for Allocation functions

Syntax:

FORCE=YES | NO | Y | N

If Y, the value specified will be used to override a program-specified block size; if N, a program specified block size will not be overridden.

Default:

FORCE=N

FREESIZE

The FREESIZE parameter includes or excludes the data set based on the free space that existed in the data set at the high-water mark at the time of allocation.

Allowed in:

INC/EXC for function SPACAQTY

Syntax:

FREESIZE=nnnnnnnnnnK|M|G|T

The nnnnnnnnnn variable represents 1-10 digits and K,M,G,T specifies whether the number is expressed in kilobytes, megabytes, gigabytes, or terabytes. The maximum allowable specification for FREESIZE is 2147483647K.

FUNCTION

The FUNCTION parameter specifies the name of the current function.

Allowed in:

INC/EXC

Syntax:

FUNCTION=xxxxxxxx

The xxxxxxxx variable represents the 8-character function name.

GDGVER

The GDGVER parameter contains the version number relative to the current generation of a GDG data set. This parameter is valid for the HSMMIGRT and HSMDELET functions only.

Allowed in:

INC/EXC (set only for HSM function)

Syntax:

GDGVER=nnn

The nnn is a version number from 0 to 255. The comparison operator symbol can be equals (=), greater than (>), or less than (<).

HDPORDEF

The HDPORDEF parameter specifies the default response time for device selection based on DASD performance. The default value is used when response time information has not been accumulated for a device, such as when it has just been brought online.

HDPORDEF is useful only when specified in conjunction with HDPORMIN/MAX. This parameter is available only when VOLSEL=HISTDPO.

Allowed in:

INC/EXC

Syntax:

HDPORDEF=nnn

The nnn variable represents the default response time in milliseconds from 0 to 999 that will be substituted for unavailable information for a specific device.

Default:

HDPORDEF=50

HDPORMAX

The HDPORMAX parameter specifies the maximum response time objective for device selection based on DASD performance.

HDPORMAX is normally specified in conjunction with HDPORMIN. This parameter is available only when VOLSEL=HISTDPO.

Allowed in:

INC/EXC

Syntax:

HDPORMAX=nnn

The nnn variable represents the maximum response time in milliseconds from 0 to 999 that will be considered for device selection based on performance.

HDPORMIN

The HDPORMIN parameter specifies the minimum response time objective for device selection based on DASD performance.

HDPORMIN is normally specified in conjunction with HDPORMAX. This parameter is available only when VOLSEL=HISTDPO.

Allowed in:

INC/EXC

Syntax:

HDPORMIN=nnn

The nnn variable represents the minimum response time in milliseconds from 0 to 999 that will be considered for device selection based on performance.

HDPORSEP

The HDPORSEP parameter specifies the response time value that is used to force selection of different volumes for data sets in the same job step.

When multiple data sets are allocated in a single job step and device selection based on DASD performance is specified for some or all, this separation factor is added to the current response time for previously used volumes in order to increase the likelihood that new allocations will go to a different volume. This parameter is available only when VOLSEL=HISTDPO.

Allowed in:

INC/EXC

Syntax:

HDPORSEP=nnn

The nnn variable represents the response time in milliseconds from 0 to 999 that will be used to enhance data set separation across volumes.

Default:

HDPORSEP=10

HDPOSTIM

The HDPOSTIM parameter specifies the starting time (each day) for a range of snapshots to be analyzed, which allows analysis of data from the same time range, or shift, each day. This parameter is available only when VOLSEL=HISTDPO.

Allowed in:

INC/EXC

Syntax:

HDPOSTIM=nnnn

The nnnn variable represents a time in 24-hour format from 0 to 2359.

Default:

HDPOSTIM=0000

HDPOETIM

The HDPOETIM parameter specifies the ending time (each day) for a range of snapshots to be analyzed. This allows analysis of data from the same time range, or shift, each day. This parameter is available only when VOLSEL=HISTDPO.

Allowed in:

INC/EXC

Syntax:

HDPOETIM=nnnn

The nnnn variable represents a time in 24-hour format from 0 to 2359.

Default:

HDPOETIM=2359

HDPODAYS

The HDPODAYS parameter specifies the days of the week to be used in determining performance statistics for pooling. This parameter is available only when VOLSEL=HISTDPO.

Allowed in:

INC/EXC

Syntax:

HDPODAYS=(MO, TU, WE, TH, FR, SA, SU)

Default:

HDPODAYS=(MO, TU, WE, TH, FR, SA, SU)

HLQ

The HLQ parameter contains the high-level qualifier of a data set name. MainView SRM name masking can be used.

Allowed in:

INC/EXC and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view

  • HSMBKVR - Backup DSN version

  • HSMMGDS - Migrated data set view

  • TDSDD - Tape management data set details by DSN view

Syntax:

HLQ=hlq

The hlq variable represents a valid 1 to 8 character data set qualifier.

HSM

The HSM parameter flags a DFSMShsm migration or backup data set. The HSM data set flag is set only if the HSMTRACK (Y) system option has been specified.

Allowed in:

INC/EXC (only for application collector)

SET (only for HSM functions)

Syntax:

HSM=YES | NO | Y | N

HSM_#PEND_G

The HSM_#PEND_G parameter contains the total number of pending recall requests.

Allowed in:

INC/EXC

Syntax:

HSM_#PEND_G=nnnnn

The nnnnn variable represents a number of pending requests from 0 to 32767.

HSM_#PEND_L

The HSM_#PEND_L parameter contains the number of pending recall requests requested on local system.

Allowed in:

INC/EXC

Syntax:

HSM_#PEND_L=nnnnn

The nnnnn variable represents a number of pending requests from 0 to 32767.

HSM_#SAME_G

The HSM_#SAME_G parameter contains the total number of pending recall requests for the same user.

Allowed in:

INC/EXC

Syntax:

HSM_#SAME_G=nnnnn

The nnnnn variable represents a number of requests from 1 to 32767.

HSM_#SAME_L

The HSM_#SAME_L parameter contains the number of pending recall requests for the same user originated on local system.

Allowed in:

INC/EXC

Syntax:

HSM_#SAME_L=nnnnn

The nnnnn variable represents a number of requests from 1 to 32767.

HSM_ACTION

The HSM_ACTION parameter filters the ACTION= text from the message text for ARC0734I.

The action is also parsed from ARC1000I and ARC1001I, and any message that contains ACTION= in the text. If the message text does not contain an action value, a value of blanks is used.

Allowed in:

INC/EXC

Syntax:

HSM_ACTION=xxxxxxxxxxxxxx

The variable xxxxxxxxxxxxxx is a 1- to 14-character action value found in the ARC0734I message text.

HSM_ACTIVE

The HSM_ACTIVE parameter indicates whether the recall request is currently being processed by HSM (Y) or still waiting to be processed (N).

Note: When a request is currently being processed, it cannot be canceled with the SET CANCEL keyword. See the SET CANCEL keyword for more information.

Allowed in:

INC/EXC for HSMRQUE

Syntax:

HSM_ACTIVE=YES | NO | Y | N

HSM_AGE

The HSM_AGE parameter filters the age of the data set as contained in the message text for ARC0734I.

The age is also obtained from any message with AGE in the message text. If the message text does not contain an AGE keyword, a value of zero is used.

Allowed in:

INC/EXC

Syntax:

HSM_AGE=nnnn

The variable nnnn is a 0- to 999-digit age value found in the ARC0734I message text.

HSM_BLOCKS

The HSM_BLOCKS parameter filters the number of blocks as contained in the message text for ARC0734I.

If the message text does not contain a number of blocks, a value of zero is used.

Allowed in:

INC/EXC

Syntax:

HSM_BLOCKS=nnnnnn

The variable nnnnnn is a number from 0 to 999999 that represents the number of blocks contained in the ARC0734I message.

HSM_CANCEL

The HSM_CANCEL parameter cancels a recall request. This parameter is valid for both HSMPRTY and HSMRQUE functions but handled differently. HSMPRTY function will cause exit ARCRPEXT to set return code to prevent recall request from queuing, whereas HSMRQUE function will cause HSM cancel command issued internally by SVOS and entry removed from recall request queue file.

Allowed in:

Rule SET parameter for function HSMPRTY

Syntax:

HSM_CANCEL=YES | NO | Y | N

HSM_DUPL

The HSM_DUPL parameter indicates whether the current recall request is a duplicate of a currently outstanding request. A duplicate is defined as a request for the same data set. The current recall is considered to be a duplicate if there is a request for the same data set name currently waiting to be processed by DFSMShsm. This keyword is only valid in the FLST/RLST of the HSMPRTY function.

Allowed in:

INC/EXC for HSMPRTY

Syntax:

HSM_DUPL=YES | NO | Y | N

HSM_FRVOL

The HSM_FRVOL parameter filters the from volume, FRVOL, in the message text for ARC0734I.

For other messages, a value of blank is used.

Allowed in:

INC/EXC

Syntax:

HSM_FRVOL=xxxxxx

The variable xxxxxx is a one- to six-digit from volume name that is found in the ARC0734I message.

HSM_HOST

The HSM_HOST parameter filters the host ID of the DFSMShsm address space issuing the message.

For function HSMRQUE it indicates the ID of the HSM host that placed a recall request on the queue, whereas for function HSMPRTY it indicates the ID of the HSM host that executed the recall request.

The host ID is always available.

Allowed in:

INC/EXC

Syntax:

HSM_HOST=xx

The variable xx represents up to a 2-character value host identifier that is defined in DFSMShsm. However, if the host ID is 1 character, you must enter only 1 character.

HSM_JOBNAM

The HSM_JOBNAM parameter filters the name of the recall that requested the job.

Allowed in:

INC/EXC

Syntax:

HSM_JOBNAM=jobName

The jobName variable represents a one- to eight-character recall name. MainView SRM masking can be used.

To filter on TSO ID, see the HSM_USERID keyword.

HSM_MLV

The HSM_MLV parameter filters the migration level of the volume.

Allowed in:

INC/EXC

Syntax:

HSM_MLV=1 | 2

The value options are for migration level 1 or 2.

HSM_MSGID

The HSM_MSGID parameter filters the ARC message number.

Allowed in:

INC/EXC

Syntax:

HSM_MSGID=xxxxxxxx

The xxxxxxxx variable represents a one- to eight-character ARC message number.

HSM_PRTY

The HSM_PRTY parameter determines the recall request priority to be set by Return Priority (ARCRPEXT) installation exit.

Allowed in:

INC/EXC for HSMPRTY and rule SET parameter for function HSMRQUE

Syntax:

HSM_PRTY=nnn

The nnn variable represents request priority from 0 to 100.

HSM_RC

The HSM_RC parameter filters the return code indicated in the message text.

If the message does not include a return code value, zero is used.

Allowed in:

INC/EXC

Syntax:

HSM_RC=nnnn

The variable nnnn represents a numeric return code value from zero to 9999.

HSM_REAS

The HSM_REAS parameter filters the reason code indicated in the message.

If the message does not include a reason code value, zero is used.

Allowed in:

INC/EXC

Syntax:

HSM_REAS=nnnn

The variable nnnn represents a numeric reason code value from zero to 9999.

HSM_SIZE

The HSM_SIZE parameter specifies the migrated data set size.

Allowed in:

INC/EXC

Syntax:

HSM_SIZE=nnnnn

The nnnnn variable represents a number from 0 to 9223372036854775807.

HSM_SOURCE

The HSM_SOURCE parameter indicates the source from which a recall request was generated.

Allowed in:

INC/EXC

Syntax:

HSM_SOURCE=TSO | TMP | OPER | BATCH | INT

Valid values are:

  • TSO (by TSO)

  • TMP (by TMP)

  • OPER (by operator)

  • BATCH (by either batch job or Started Task)

  • INT (internally by HSM)

HSM_STRING

The HSM_STRING parameter filters a string found in the message text.

Allowed in:

INC/EXC

Syntax:

HSM_STRING=’text

The variable text represents a value that should be used to filter the message text. An asterisk and slash can be used to search the message text for any value.

Examples:
  • This example will search for the string 'ended' anywhere in the message text.

HSM_STRING=*ended/

This value must be entered within single quotation marks if it contains embedded spaces and matches the value with the entire message text. If searching for a value that contains embedded spaces within the message text, insert a question mark (?) in the space position.

  • This example will search for the string 'daily backup' anywhere in the message text.

HSM_STRING=*daily?backup/

HSM_TIME

The HSM_TIME parameter specifies the elapsed time since the recall was requested.

Allowed in:

INC/EXC for HSMRQUE

Syntax:

HSM_TIME=hhmmss

The hhmmss variable represents the hours, minutes, and seconds of the elapsed time. Although this parameter is shown here with an equal sign, it is more likely that a greater-than sign or lesser-than sign will achieve the desired results.

HSM_TIME_EX

The HSM_TIME_EX parameter specifies the elapsed time since DFSMShsm started executing the recall request. HSM_CANCEL=Y cannot be used with this parameter.

Allowed in:

INC/EXC for HSMRQUE

Syntax:

HSM_TIME_EX=hhmmss

The hhmmss variable represents the hours, minutes, and seconds of the elapsed time. Although this parameter is shown here with an equal sign, it is more likely that a greater than sign or lesser than sign will achieve the desired results.

HSM_TOVOL

The HSM_TOVOL parameter filters the to volume, TOVOL, in the message text for ARC0734I.

For other messages a value of blank is used.

Allowed in:

INC/EXC

Syntax:

HSM_TOVOL=xxxxxx

The variable xxxxxx is a one- to six-digit to volume name that is found in the ARC0734I message.

HSM_TRACKS

The HSM_TRACKS parameter filters the number of tracks as contained in the message text for ARC0734I.

If the message text does not contain a number of tracks, a value of zero is used.

Allowed in:

INC/EXC

Syntax:

HSM_TRACKS=nnnnn

The variable nnnn represents the number of tracks from zero to 9999 contained in ARC0734I.

HSM_TRKS

The HSM_TRKS parameter contains the migrated data set size in tracks.

Allowed in:

INC/EXC

Syntax:

HSM_TRKS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

HSM_USERID

The HSM_USERID parameter specifies the user ID of the recall requestor.

Allowed in:

INC/EXC

Syntax:

HSM_USERID=xxxxxxxx

The xxxxxxxx variable represents a one- to eight-character user ID. MainView SRM masking can be used.

To filter for internally generated request (request made by HSM), use and asterisk (*). To filter for requests generated by the operator, use the OPER parameter.

To filter on job names, see the HSM_JOBNAM keyword.

HSM_WAIT

The HSM_WAIT parameter indicates whether the recall requestor is waiting for the recall completion.

Allowed in:

INC/EXC

Syntax:

HSM_WAIT=YES | NO | Y | N

HSMAAGE

The HSMAAGE parameter specifies the number of calendar-adjusted days since the data set was migrated/backed up. Calendar-adjusted days are working days as defined in MainView SRM calendar member SMSCALS xx. If SMSCALS xx is not used or function HSMMCCNV is not active, these days are not adjusted and this keyword value will be equal to the HSMAGE keyword value.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS – Backup data set view

  • HSMBKVR – Backup DSN version

  • HSMMGDS – Migrated data set view

Syntax:

HSMAAGE=nnnnn

The nnnnnvariable represents a number of days from 0 to 99999.

Example:

This example specifies data sets migrated/backed up 25 working days ago where working days are defined in SMSCALSxx.

HSMAAGE=25

HSMAGE

The HSMAGE parameter specifies the number of days since the HSM backup/migration of the data set was made. This value is calculated by subtracting the backup/migration date from the current date. The time of the migration is not included in the calculation.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS – Backup data set view

  • HSMBKVR – Backup DSN version

  • HSMMGDS – Migrated data set view

Syntax:

HSMAGE=nnnnn

The nnnnn variable represents a number of days from 0 to 99999.

Example:

Selected are data sets migrated/backed up 14 days ago.

HSMAGE=15

HSMCMD

The HSMCMD parameter specifies a valid HSM command to be issued for each record in the SET result group. The command is applied after any SORT specification is processed, which means that the commands are generated in sort order. You can use the ACT_SUM_LIM or ACT_COUNT parameter to limit the number of commands that are issued.

The HSM command syntax does not require any command character or prefix. The SVOS address space will determine the main (primary) HSM Started Task on the system and issue the command to that HSM address space by prefixing the command with the modifier and HSM Started Task name. The command can contain variables that will be replaced by values that are available in the result solution set created by the criteria defined in the solution. These are the same variables that are available for skeleton tailoring.

The command cannot exceed 126 bytes in length after all variable substitutions are made and the prefix has been added and must be enclosed in single quotation marks.

Syntax:

HSMCMD= 'hsmCommand'

Examples:
  • This command will cause the data set MY.DATA.SET to be migrated to ML1.

HSMCMD= 'MIGRATE DATASETNAME(MY.DATA.SET) ML1'

  • This command will replace the variable &DSN with the value provided by the result solution set and cause that data set to be migrated to ML1.

HSMCMD= 'MIGRATE DATASETNAME(&DSN) ML1'

HSMCMPR

The HSMCMPR parameter specifies the degree of compression of the migrated copy of the data set, expressed as a percentage of the original size.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for HSMBGDS Migrated data set view

Syntax:

HSMCMPR=nnn

The nnn variable represents a whole number percentage from 0 to 100.

Example:

Selected are migrated data sets with migrated copies compresses more than 50%.

HSMCMPR>50

HSMDATE

The HSMDATE parameter specifies the date when the HSM backup/migration of the data set was made.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view

  • HSMBKVR - Backup DSN version

  • HSMMGDS - Migrated data set view

Syntax:

HSMDATE=yyyy/mm/dd

The yyyy/mm/dd variable represents a valid Gregorian date, with no masking.

Example:

Selected are data sets migrated/backed up on April 15, 2010.

HSMDATE=2010/04/15

HSMDEV

The HSMDEV parameter specifies media used for making the last HSM backup/migration.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS – Backup data set view

  • HSMBKVR – Backup DSN version

  • HSMMGDS – Migrated data set view

Syntax:

HSMDEV=T | D

Valid values are:

  • T (tape)

  • D (DASD)

HSMDSN

The HSMDSN parameter specifies the data set name of the HSM backup/migration copy of the data set.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS – Backup data set view

  • HSMBKVR – Backup DSN version

  • HSMMGDS – Migrated data set view

Syntax:

HSMDSN=dsn

The dsn variable represents one- to forty-four-characters of a valid data set name. Masking is allowed.

Example:

Selected are data sets migrated/backed up to the HSM data set with DSN matching mask HSM.*.AUT/.

HSMDSN=HSM.*.AUT/

HSMEXPDT

The HSMEXPDT parameter specifies the expiration date of the data set that existed when HSM migrated this data set. If expiration date is not available, the value 9999/99/99 will be used.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for HSMBGDS Migrated data set view

Syntax:

HSMEXPDT=yyyy/mm/dd

The yyyy/mm/dd variable respresents the Gregorian expiration date; no masking allowed.

HSMSIZE

The HSMSIZE parameter specifies the data set size, in kilobytes, on the HSM backup/migration volume.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view

  • HSMBKVR - Backup DSN version

  • HSMMGDS - Migrated data set view

Syntax:

HSMSIZE=nnnnn

The nnnnnvariable respresents the data set size in kilobytes from 0 to 2147483647.

Example:

Selected are data sets migrated/backed up to the HSM data set greater than 3200 KB.

HSMSIZE>3200

HSMTIME

The HSMTIME parameter specifies the time of day when the HSM backup/migration of the data set was made.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view

  • HSMBKVR - Backup DSN version

  • HSMMGDS - Migrated data set view

Syntax:

HSMTIME=hh:mm:ss

The hh:mm:ss variable represents the time of day; no masking allowed.

HSMVOL

The HSMVOL parameter specifies the HSM volume to which the data set backup/migration was made by HSM.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view

  • HSMBKVR - Backup DSN version

  • HSMMGDS - Migrated data set view

Syntax:

HSMVOL=xxxxxx

The xxxxxx variable represents one- to six-characters of a valid volume serial number. Masking is allowed.

Example:

Selected are data sets migrated/backed up to the volumes with volsers started with characters MIG.

HSMVOL=MIG/

HWMSIZE

The HWMSIZE parameter includes or excludes the data set based on the high-water mark (HWM) allocation size. The HWM allocation size is the size of the data set before unused space was released by using the RLSE parameter.

Allowed in:

INC/EXC for function SPACAQTY

Syntax:

HWMSIZE=nnnnnnnnnnK|M|G|T

The nnnnnnnnnn variable represents from 1 to 10 digits, and K,M,G,T specifies whether the number is expressed in kilobytes, megabytes, gigabytes, or terabytes. The maximum allowable specification for HWMSIZE is 2147483647

IAM_DS

The IAM_DS parameter specifies whether a data set has been determined to be an IAM data set or not.

Allowed in:

INC/EXC

Syntax:

IAM_DS=Y | N | YES | NO

During processing, if no determination has been made about whether the data set is an IAM data set, the value will be null.

IMBED

The IMBED parameter contains and specifies the removal of the IMBED parameter during cluster definition.

Allowed in:

INC/EXC and rule SET parameter for function VSAMCNTL

Syntax:

IMBED=YES | NO | Y | N

If Y is specified the IMBED parameter is forced in the DEFINE CLUSTER definition; if N is specified, the IMBED parameter is removed from the DEFINE CLUSTER definition.

Note: When used as a selection parameter, this parameter is only valid for VSAM data sets.

IN_ATL_LIB

The IN_ATL_LIB parameter specifies whether a tape data set in an Automated Tape Library is selected.

Allowed in:

data set filtering FLST members

Syntax:

IN_ATL_LIB=Y | N | YES | NO

IN_VTS_LIB

The IN_VTS_LIB parameter specifies whether a tape data set in a Virtual Tape Library is selected.

Allowed in:

data set filtering FLST members

Syntax:

IN_VTS_LIB=Y | N | YES | NO

JCL_SPCUNIT

The JCL_SPCUNIT parameter specifies the space unit of the PQTY and SQTY keywords and the space unit used in allocation of the data sets that are not VSAM IDCAMS-defined data sets.

After the primary and secondary allocation amounts have been computed, the amounts are then converted (if necessary) to the specified unit. unit type is taken from the JCL statement

This optional keyword is ignored for data sets that are VSAM IDCAMS defined.

Allowed in:

Rule SET parameter for function SPACAQTY

Syntax:

JCL_SPCUNIT=xxx

The values are defined as follows:

  • BLK (Blocks)

  • CYL (Cylinders)

  • KAV (AVGREC-KAV)

  • MAV (AVGREC=MAV)

  • TRK (Tracks)

  • UAV (AVGREC=UAV)

Note: For BLK, UAV, KAV, and MAV, the AVL keyword is used to obtain the block size/average record length if it is not available in the JCL statements.

JOB

The JOB parameter contains the jobname (batch job, Started Task, TSO user). MainView SRM name masking can be used.

Allowed in:

INC/EXC

Syntax:

JOB=xxxxxxxx

The xxxxxxxx variable represents a valid one- to eight-character job name.

JOB_DEST

The JOB_DEST parameter is used in conjunction with the ACT_JOB parameter to tailor skeleton JCL. The JOB_DEST parameter determines the destination of the tailored JCL produced by the solution. For more information, see the MainView SRM Automation User Guide.

Allowed in:

Rule SET parameter for AUTOAPPL, AUTODS, AUTOHMSG, AUTOPOOL, and AUTOVOL.

Syntax:

JOB_DEST=SUBMIT | SAVE | NONE

The following table defines the values:

Value

Description

SUBMIT

Indicates that the skeleton JCL should be tailored and submitted

See the ACT_ACCUM parameter to determine how often this job might be submitted.

SAVE

Indicates that the skeleton JCL should be tailored and then saved to a data set

No job is submitted. See the ACT_ACCUM parameter to determine how often a data set might be created. The JCL written to the data set is never submitted by the Automation component. Use the AUTOSVDS view to edit or browse these data sets and manually submit the JCL.

NONE

Indicates that skeleton JCL should not be tailored

This setting can be used when ACT_ACCUM=ALL is used. These settings are used when data is being accumulated into skeleton JCL and you plan to submit the job manually by using the AUTOSOL or AUTOACUM views. A tailored JCL is not saved or submitted with this setting. This setting can also be used during testing of a new solution, to ensure that JCL is never saved to a data set or submitted.

Default:

JOB_DEST=SUBMIT

JOB_GROUP

The JOB_GROUP parameter specifies whether the Automation component will group each resource matching the SET statement into one batch job or if each resource matching the SET statement will be included in individual jobs.

The Automation component includes all resources that match a SET statement into one job. For example, the command AUTOVOL,POOL=ABCD,SOL=DEFRAG is specified. The DEFRAG solution specifies ACT_JOB=DFRAGJOB. All volumes that are in the ABCD pool are run against the DEFRAG solution. All volumes that match the solution are included in a single job. This process reduces the number of jobs that are submitted by the Automation product. In certain cases, it is beneficial to have one job submitted for each resource that matches the solution. If JOB_GROUP=N is specified in the DEFRAG solution in this example, one job would be submitted for each volume that matched the solution.

When ACT_JOB= is specified along with JOB_DEST=SAVE, a data set is created to contain the tailored JCL. The JCL is not submitted by the Automation product. When JOB_GROUP=N is used with these two keywords, multiple data sets are created, each containing tailored JCL for a single resource.

The default is JOB_GROUP=Y. If the keyword is not specified, all resources matching the SET statement will be grouped together into a single job.

The JOB_GROUP keyword is ignored if ACT_JOB is not specified on the same SET statement.

Allowed in:

Rule SET parameter for AUTOAPPL, AUTODS, AUTOHMSG, AUTOPOOL, and AUTOVOL (all AUTO functions except for AUTOADDV).

Syntax:

JOB_GROUP=Y|N|YES|NO

JOBACCTn

The JOBACCT n parameter contains the nth field of the job card ACCT field. MainView SRM name masking can be used.

Allowed in:

INC/EXC

Syntax:

JOBACCT n=xxxxxxxxxxxx

The n variable represents the number of the field from 1 to 3.

The xxxxxxxxxxxx variable represents a 1- to 20-characters job card ACCT field.

JOBCLASS

The JOBCLASS parameter contains the value of the class field of the job card of the currently executing job. MainView SRM name masking can be used.

Note: This parameter is not available for functions DSNCHECK, HSMBACKP, HSMDELET, HSMMCCNV, HSMMIGRT, HSMRQUE, SMSACSDC, SMSACSMC, SMSACSSC, SMSACSSG, or SMSACSTE.

Allowed in:

INC/EXC

Syntax:

JOBCLASS=x

The x variable represents a single job class character.

JOBSDAY

The JOBSDAY parameter contains the day of the week the job was started.

Allowed in:

INC/EXC

Syntax:

JOBSDAY=xxxxxxxx

The xxxxxxxx variable represents the day of the week that the job was initiated.

JOBSTIME

The JOBSTIME parameter contains the start time for the job stated in the form of HH:MM:SS.

Allowed in:

INC/EXC

Syntax:

JOBSTIME=nn:nn:nn

The nn:nn:nn variable represents the hour, minute, and second when the job was started.

JOBTYPE

The HSM parameter specifies the type of job that issued a request.

Allowed in:

INC/EXC

Syntax:

HSM=STC | TSO | JOB

Valide values are:

  • STC (Started Task)

  • TSU (timesharing user)

  • JOB (batch job)

LABELTYP

The LABELTYP parameter contains the value of the LABEL parameter of the DD statement.

Note: This parameter is not available for functions SPACPRIM, SPACSECA, SPACSECB, SPACSECI, SPACSECR, SPACSWIR, and SPACVOLA.

Allowed in:

INC/EXC

Syntax:

LABELTYP=xxx

The values are defined as follows:

  • SL (Standard labels)

  • SUL (Standard and user labels)

  • AL (ANSI labels)

  • AUL (ANSI and user labels)

  • NSL (Non-standard labels)

  • NL (No labels)

  • BLP (Bypass label processing)

  • LTM (Leading tapemark)

LAST_VOL

The LAST_VOL parameter specifies whether this volume is the last volume in the list of candidate pool volumes.

The volumes in the candidate pool are run through the AUTOADDV function one at a time, in ascending volser order. The first volume to match an AUTOADDV RLST statement is used. If all volumes in the candidate pool are run through the function and none is selected, the AUTOADDV request fails.

This keyword can be used to ensure that a volume is selected rather than allowing the AUTOADDV request to fail.

Allowed in:

INC/EXC statement for function AUTOADDV

Syntax:

LAST_VOL=Y | N | YES | NO

Example:

This example selects the volume if it is the last volume being passed through the function. If this volume is not selected, the AUTOADDV request will fail.

SET ACT_JOB=SRMJOB09 EVENTID=AE011

INC LAST_VOL=Y

Because this might not be the most appropriate volume for the storage group event AE011 is also issued. This event could be used to send a message to the storage administrator informing them of the situation, the storage group in question, and the volser added to the group.

Place this statement near the end of the AUTOADDV RLST member so that the volume has a chance to match a previous SET statement.

LBKPVER

The LBKPVER parameter specifies the absolute number that uniquely identifies the last backup version. The numbering begins at 1 for the first backup version of the data set and is retained for its life span.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view, and

  • HSMBKVR - Backup DSN version.

Syntax:

LBKPVER=nnnn

The nnnn variable represents a number from 0 to 9999.

Example:

Selected are backed up cataloged data sets with their last backup version equal to 197.

LBKPVER=197

LEVEL

The LEVEL parameter specifies the account level being processed by application.

Allowed in:

INC/EXC

Syntax:

LEVEL=n

The n variable represents an account level from 1 to 4.

LIMIT

The LIMIT parameter specifies the size limit of a data set in megabytes.

Allowed in:

Rule SET parameter for function SPACLIMI

Syntax:

LIMIT=nnnnnnnnnnK|M|G|T

The nnnnnnnnnn variable represents from 1 to 10 digits, and K,M,G,T specifies whether the number is expressed in kilobytes, megabytes, gigabytes, or terabytes. The maximum allowable specification for LIMIT is 2147483647K.

LLQ

The LLQ parameter specifies or contains the low-level qualifier of a data set name. MainView SRM name masking can be used for filter list entries.

Allowed in:

INC/EXC, rule SET parameter for functions DSNCHECK and AUTODS, and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS – Backup data set view

  • HSMBKVR – Backup DSN version

  • HSMMGDS – Migrated data set view

  • TDSDD – Tape management data set details by DSN view

Syntax:

LLQ=llq

The llq variable represents a valid one- to eight-character data set name qualifier.

LREADAGE

The LREADAGE parameter contains the number of days since the data set was last read. If the last read date is not available, filtration does not take place.

For tape scan data set filtering, this number is calculated by subtracting the last read date from the tape scan date.

Allowed in:

data set filtering FLST members

Syntax:

LREADAGE =nnnnn

The nnnnn variable represents a number from 0 to 99999.

LREADCAGE

The LREADCAGE parameter contains the calendar-adjusted number of work days since the data set was last read. If the last read date is not available, filtration does not take place.

For tape scan data set filtering, this number is calculated by subtracting the calendar-adjusted last read date from the tape scan date. Calendar-adjusted days are working days as defined in MainView SRM calendar member SMSCALS xx. If SMSCALS xx is not used, these days are not adjusted and this keyword value will be equal to the LREADAGE keyword value.

Allowed in:

data set filtering FLST members

Syntax:

LREADCAGE =nnnnn

The nnnnn variable represents a number from 0 to 99999.

LREADDATE

The LREADDATE parameter contains the 10-character last read date of the data set in yyyy/mm/dd format. If the last read date is not available, filtration does not take place.

Allowed in:

Data set filtering FLST members

Syntax:

LREADDATE =yyyy/mm/dd

LRECL

The LRECL parameter contains the logical record length of a data set.

Allowed in:

INC/EXC

Syntax:

LRECL=nnnnn

The nnnnn variable represents a number from 1 to 32,760. The comparison operator symbol can be equals (=), greater than (>), or less than (<).

LREF

The LREF parameter indicates the most recent date on which the migrated data set was referenced. If the last referenced date is not available, it will be substituted with the date when the data set was migrated

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBGDS – Migrated data set view

  • TDSDD – Tape management data set details by DSN view

Syntax:

LREF=yyyy/mm/dd

Example:LREF=2010/04/15 , which indicates that the selected migrated data sets were last referenced on April 15, 2010.
LWRITEAGE

The LWRITEAGE parameter contains the number of days since the data set was last written. If the last write date is not available, filtration does not take place.

For tape scan data set filtering, this number is calculated by subtracting the last write date from the tape scan date.

Allowed in:

data set filtering FLST members

Syntax:

LWRITEAGE =nnnnn

The nnnnn variable represents a number from 0 to 99999.

LWRITECAGE

The LWRITECAGE parameter contains the calendar-adjusted number of work days since the data set was last written. If the last write date is not available, filtration does not take place.

For tape scan data set filtering, this number is calculated by subtracting the calendar-adjusted last write date from the tape scan date. Calendar-adjusted days are working days as defined in MainView SRM calendar member SMSCALS xx. If SMSCALS xx is not used, these days are not adjusted and this keyword value will be equal to the LWRITEAGE keyword value.

Allowed in:

data set filtering FLST members

Syntax:

LWRITECAGE =nnnnn

The nnnnn variable represents a number from 0 to 99999.

LWRITEDATE

The LWRITEDATE parameter contains the 10-character last write date of the data set in yyyy/mm/dd format. If the last write date is not available, filtration does not take place.

Allowed in:

data set filtering FLST members

Syntax:

LWRITEDATE =yyyy/mm/dd

MAXQLF

The MAXQLF parameter specifies the maximum number of qualifiers a data set name can have.

Allowed in:

Rule SET parameter for function DSNCHECK

Syntax:

MAXQLF=nn

The nn variable represents a number from 1 to 99.

MAXSIZE

The MAXSIZE parameter contains the maximum size of a data set in bytes, based on the maximum possible extent count. For a non-VSAM data set, this value is the primary extent size plus the size of 15 secondary extents; for VSAM data sets, this value is the free space primary extent size plus the size of 122 secondary extents.

Allowed in:

INC/EXC

Syntax:

MAXSIZE=nnnnnnnnnnK|M|G|T

The nnnnnnnnnn variable represents from 1 to 10 digits, and K,M,G,T specifies whether the number is expressed in kilobytes, megabytes, gigabytes, or terabytes. The comparison operator symbol can be equals (=), greater than (>), or less than (<). The maximum allowable specification for MAXSIZE is 2147483647K.

MGMTCLAS

The MGMTCLAS parameter specifies or contains the name of a DFSMS management class. MainView SRM name masking can be used for filter list entries. Rule list entries must specify a valid management class name.

Allowed in:

INC/EXC statements, rule SET parameter for function SMSACSMC, and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS (Backup data set view)

  • HSMBKVR (Backup DSN version)

  • HSMMGDS (Migrated data set view)

  • TDSDD (Tape management data set details by DSN view)

Syntax:

MGMTCLAS=xxxxxxxx

The xxxxxxxx variable represents a valid one- to eight-character management class name.

MIGCMD

The MIGCMD parameter specifies whether DFSMShsm migration initiated by command (instead of automatically) is to be handled by HSMMIGRT. If MIGCMD=Y is set, the MainView SRM function HSMMIGRT is activated for migration initiated automatically and on command. If MIGCMD=N, HSMMIGRT is activated only for automatic migration processing.

Allowed in:

Rule SET parameter for function HSMMIGRT

Syntax:

MIGCMD=YES | NO | Y | N

Default:

MIGCMD=Y

MIGCTLG

The MIGCTLG parameter specifies the cataloged indicator for a migrated data set.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBGDS – Migrated data set view

  • TDSDD – Tape management data set details by DSN view

Syntax:

MIGCTLG=Y | N

The values as defines as follows:

  • Y – migrated data set is cataloged

  • N – migrated data set is not cataloged

MIGDAYS

The MIGDAYS parameter specifies the interval in days that a data set must be unreferenced before being eligible for migration. This count is added to the data set's date of last reference; if the resultant date is less than or equal to the current date, the data set is marked eligible for migration. See also the CAL parameter.

Note: The MIGDAYS parameter is no longer valid for HSMMIGRT. It has been replaced by CALAGE and REFAGE. MIGDAYS remains available for compatibility only; it will cause no action.

Allowed in:

Rule SET parameter for function HSMMIGRT

Syntax:

MIGDAYS=nnnn

The nnnn variable represents a number from 1 to 9999.

MIGLEV

The MIGLEV parameter specifies the migration level of the data set.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for HSMBGDS Migrated data set view

Syntax:

MIGLEV=1 | 2

The values are defined as follows:

  • 1 – initial migration, from primary to level 1 (typically DASD)

  • 2 – secondary migration, from level 1 to level 2 (often tape)

MIGRATE

The MIGRATE parameter specifies that DFSMShsm migration should be allowed or disallowed. When DFSMShsm tries to migrate data sets, the MainView SRM function HSMMIGRT gets control. Migration can be allowed or disallowed from HSMMIGRT by setting MIGRATE to Y or N respectively.

Allowed in:

Rule SET parameter for function HSMMIGRT

Syntax:

MIGRATE=YES | NO | Y | N

Default:

MIGRATE=Y

MIGRTCMD

The MIGRTCMD parameter specifies whether this migration is command initiated.

Allowed in:

INC/EXC in the HSMMIGRT function

Syntax:

MIGRTCMD=YES | NO | Y | N

MINQLF

The MINQLF parameter specifies the minimum number of qualifiers a data set name can have.

Allowed in:

Rule SET parameter for function DSNCHECK

Syntax:

MINQLF=nn

The nn variable represents a number from 1 to 99.

ML2

The ML2 parameter specifies that DFSMShsm migration from ML0 direct to ML2 (skipping ML1) is allowed. (DFSMShsm release 2.4.0 or later is required.) See also the BACKUP parameter.

Allowed in:

Rule SET parameter for function HSMMIGRT

Syntax:

ML2=YES | NO | Y | N

Default:

ML2=N

MNTYPE

The MNTYPE parameter contains and specifies the mount type for additional volumes in secondary space allocation. MNTYPE=ALL considers all volumes in the pool, regardless of the volume mount type. MNTYPE=CURRENT searches only for volumes with the same mount type as the current volume. Note that, regardless of the MNTYPE specification, all volumes in an alternate pool are considered eligible.

Also, for compatibility with STOP-X37 comparison, triplets can be specified with the first operand in the triplet specifying a partial mount type, the second operand specifying the offset in the mount type for the comparison to start, and the third operand, the comparison operator. For example, MNTYPE=((PV,1,EQ),(ST,1,EQ)) would allow volumes that are mounted PUBLIC or STORAGE.

The values are defined as follows:

  • EQ (=)

  • GT(>)

  • LE (<=)

  • NE (¬=)

    GE (>=)

  • LT (<)

  • GE (>=)

Allowed in:

INC/EXC and rule SET parameter for function SPACVOLA

Note: The mount attribute is not available if no volume has been selected.

Syntax:

MNTYPE=xxxxxxx

or

MNTYPE=((mmmmmm,n,op),...)

  • The mmmmmm variable represents the comparison character string.

  • The n variable represents the comparison offset.

  • The op variable represents the comparison operator.

The xxxxxxx variable represents the mount status value defined as follows:

  • ALL (All volumes in pool, regardless of mount type)

  • CURRENT (Current volume)

  • PRIVATE (Private volume)

  • PUBLIC (Public volume)

  • STORAGE (Storage volume)

Default:

MNTYPE=ALL

Note: When used as a selection parameter (INC/EXC), MNTYPE will never contain ALL.

MODE

MODE is the FLST SET statement parameter that specifies the status of the function for the resources that are selected by following INC/EXC statements. When SET MODE=INACT is specified, any selected resources are bypassed for processing by the function. When SET MODE=SIM is specified, selected resources are processed in simulation mode, in which the action is not applied but a message is issued (depending on the MSG parameter) to indicate the action that would be applied if SET MODE=ACT were specified.

Note: If EVENTID= is used on an FLST SET statement with MODE=INACT, the event will still be issued.

The MODE parameter is the most significant filter list SET statement parameter. The MODE parameter defines the processing mode for the selected resources.

The values are defined as follows:

  • ACTive – The function acts on the selected resources.

  • INACTive – The function does nothing for the selected resources.

  • SIMulate – The function reports activity as if it were active, but it does not actually take any action for the selected resources.

Different sets of selected resources can have different processing modes for a function.

Tip: Simulate mode (SIM) is used only for the HSM collector, Allocation, and DMS2HSM.

Syntax:

MODE=[ACT | INACT | SIM]

Required:

Yes

MSG

MSG is the FLST SET statement parameter that specifies the message generation option for resources that are selected by the following parameters. Informational and error messages can be produced, or all messages can be suppressed. Note that the MSG option on the function definition in the SMFUNC xx member is overridden by this option for specific selected resources.

Note: The MSG parameter is used only for the HSM collector, Allocation, and DMS2HSM.

Syntax:

MSG=I |W | E | S | N

The values are defined as follows:

  • I (Informational and error messages)

  • W (Warning messages)

  • E (Error messages only)

  • S (Severe messages)

  • N (No messages)

Default:

The MSG parameter on the function definition in SMFUNCxx.

MTSDSP

The MTSDSP parameter specifies the DFHSM Small Data Set Packing (SDSP) indicator.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for HSMBGDS Migrated data set view

Syntax:

MTSDSP=Y | N

The values are defined as follows:

  • Y – data set has been migrated to SDSP data set

  • N – data set has not been migrated to SDSP data set

MULTIVOL_DS

The MULTIVOL_DS parameter specifies whether a tape data set with a volume sequence number of two or more is selected.

Allowed in:

data set filtering FLST members

Syntax:

MULTIVOL_DS =Y | N | YES | NO

NEWAPPL

The NEWAPPL parameter specifies the value of an account code that is used to override the default account code. NEWAPPL replaced NEWACCT, which is also still accepted.

Allowed in:

Rule SET parameter for function SGCONTRL

Syntax:

NEWAPPL=xxxxxxxx

The xxxxxxx variable represents an alphanumeric code from 1 to 50 characters long.

Note: Do not use the following special characters in the name of an application:

( ) / / [ ] & < >

NOCATLG2

The NOCATLG2 parameter specifies the action to be taken when a NOT CATLGD2 condition occurs. This condition occurs when a data set has a disposition of (NEW,CATLG) and the same name already exists in the catalog. The NOCATLG2 function can cancel the job, or rename or delete or uncatalog the old data set. See also the parameter PURGE.

Allowed in:

Rule SET parameter for function NOCATLG2

Syntax:

NOCATLG2=xxxxxxx

The following table defines the values:

Option

Description

FAIL

Causes the job to fail

RENAME

Renames the old data set

DELETE

Deletes the old data set

UNCATLG

Uncatalogs the old data set

CANCEL

Cancels the job

If NOCATWHEN=ALLOC, the job is canceled before the current step executes. If NOCATWHEN=TERM, the job is canceled after the current step ends; that is, all following steps are flushed.

NO

Completes the job step with a normal return code

Subsequent job steps might abend or process invalid data. For SMS-managed data sets, the job fails immediately with a JCL error.

FLUSH

Data set receives NOT CATLGD2 message

The remainder of the job steps are flushed.

OPER

Issues a message to the system console by way of WTOR, allowing the operator to reply with the desired option

NOCATWHEN

The NOCATWHEN parameter specifies when NOCATLG2 processing will occur for a non-SMS data set.

Allowed in:

The SET parameter in function NOCATLG2

Syntax:

NOCATWHEN=TERM | ALLOC

The values are defined as follows:

  • TERM – NOCATLG2 processing will occur during step termination.

  • ALLOC – NOCATLG2 will occur during z/OS data set allocation processing.

Note: When NOCATWHEN=ALLOC and no volser is specified, you will not be able to filter on parameter VOL=. To be able to filter on VOL=, you must specify NOTCATWHEN=TERM.

NOCHECK

The NOCHECK parameter specifies the checks bypassed in space recovery validation.

Allowed in:

Rule SET parameter for functions SPACSECA, SPACSECB, SPACSECR, SPACSWIR, and SPACVOLA. All of the options are valid for SPACVOLA. CONTIG is the only option valid for the other functions.

Syntax:

NOCHECK=( xxxxxx,...)

The following table defines the values:

Value

Description

CONTIG

A data set is allocated with contiguous space required.

DC

A data set resides on a cached device.

Under normal conditions, the volume switch occurs only to packs that have the same device characteristics.

DSNAME

A data set is allocated to another DD statement within the same job step.

DISP

A permanent data set is being accessed without the use of a catalog.

ENQ

A permanent data set is allocated to a DD statement within another job.

EXCP

A data set is being processed with the EXCP access method (or otherwise processing at the hardware level).

NOTE

A data set is being processed with the NOTE macro.

POINT

A data set is being processed with the POINT macro.

NQUAL

The NQUAL parameter contains the total number of qualifiers in a data set name.

Allowed in:

INC/EXC

Syntax:

NQUAL=nn

The nn variable represents a number from 1 to 20. The comparison operator symbol can be equals (=), greater than (>), or less than (<).

NUMBLKS

The NUMBLKS parameter specifies the number of blocks (block count).

Allowed in:

data set filtering FLST members

Syntax:

NUMBLKS=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

NUNIT

The NUNIT parameter specifies the number of units requested. This value is the larger of units coded UNIT=(SYSALLDA,n) or volumes requested VOL=SER=.

Allowed in:

INC/EXC

Syntax:

NUNIT=nn

The nn variable represents a number from 1 to 59.

NVOL

The NVOL parameter specifies the number of volumes that can be allocated to or requested for a non-VSAM data set or VSAM data component.

Allowed in:

INC/EXC and rule SET parameter for DASDPOOL

Syntax:

NVOL=nn

The nn variable represents a number from 1 to 59 for non-VSAM data sets and from 1 to 20 for VSAM data components.

NVOLINDX

The NVOLINDX parameter specifies the number of volumes that can be allocated to a VSAM index component. Note that CANDIDATE overrides NVOLINDX.

Allowed in:

Rule SET parameter for DASDPOOL

Syntax:

NVOLINDX=nn

The nn variable represents a number from 1 to 20.

NVOLMAX

The NVOLMAX parameter specifies whether the number of volumes that can be assigned to a data set is limited to the number of volumes in the pool in which the data set resides.

Allowed in:

Rule SET parameter for DASDPOOL

Syntax:

NVOLMAX=YES | NO | Y | N

OLDACCT

The OLDACCT parameter specifies the value of a default account code.

Allowed in:

INC/EXC

Syntax:

OLDACCT=xxxxxxx

The xxxxxxx variable represents an alphanumeric code from 1 to 50 characters long.

OLDDSN

The OLDDSN parameter contains the name of the old data set (on a rename operation).

Allowed in:

INC/EXC

Syntax:

OLDDSN=xxxxxxxx.

The xxxxxxx variable represents the old data set name up to 44 characters long.

OLDHLQ

The OLDHLQ parameter contains the old data set high-level qualifier (on a rename operation).

Allowed in:

INC/EXC

Syntax:

OLDHLQ=xxxxxxxx

The xxxxxxxx variable represents the old data set high-level qualifier.

OPER

The OPER parameter allows the operator to provide a volume when the system cannot find space for a volume switch during SPACVOLA. This option is not available for SMS-managed data sets.

Allowed in:

Rule SET parameter for function SPACVOLA

Syntax:

OPER=YES | NO | Y | N

ORGSIZE

The ORGSIZE parameter specifies the original size in kilobytes, of the data set migrated/backed up by HSM.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view

  • HSMBKVR - Backup DSN version

  • HSMMGDS - Migrated data set view

Syntax:

ORIGSIZE=nnnnn

The nnnnnvariable is a number of kilobytes from 0 to 2147483647.

ORGTRK

The ORGTRK parameter specifies the number of tracks that HSM will allocate at the time the data set is restored/recalled.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view

  • HSMBKVR - Backup DSN version

  • HSMMGDS - Migrated data set view.

Syntax:

ORIGTRK=nnnnn

The nnnnnvariable is a number of tracks from 0 to 2147483647.

ORIGUNIT

The ORIGUNIT parameter contains the original unit name (generic or esoteric) specified in the JCL. For VSAM allocations, the value will always be SYSALLDA.

Allowed in:

INC/EXC. Cannot be set for SPACPRIM, SPACSECA, SPACSECB, SPACSECR, SPACSWIR, or SPACVOLA.

Syntax:

ORIGUNIT=xxxxxxxx

The xxxxxxxx variable represents a unit name.

ORIGVOL

The ORIGVOL parameter contains the original VOLSER specified in the JCL or in the IDCAMS control cards.

Allowed in:

INC/EXC and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view

  • HSMBKVR - Backup DSN version

  • HSMMGDS - Migrated data set view

  • TDSDD - Tape management data set details by DSN view

Syntax:

ORIGVOL=xxxxxx

The xxxxxx variable represents a volume serial number.

ORGSIZE

The ORGSIZE parameter specifies the original size of data set, in tracks, before it was migrated.

Allowed in:

INC/EXC and rule SET parameter for function HSMRECAL

Syntax:

ORGSIZE=nnnnn

The nnnnn variable represents a number from 0 to 2147483647.

OWNER

The OWNER parameter contains and specifies an owner to be assigned during cluster definition.

Allowed in:

INC/EXC and rule SET parameter for function VSAMCNTL. Cannot be set for NOCATLG2, SPACSWIR, or SPACPRIM functions.

Syntax:

OWNER=xxxxxxxx

The xxxxxxxxx variable represents a character string up to 40 characters long.

PCTFREE

The PCTFREE parameter includes or excludes the data set based on the free-space percentage for the data set at the high-water mark at the time of allocation.

Allowed in:

INC/EXC for function SPACAQTY

Syntax:

PCTFREE=nnn

The nnn variable represents a percentage from 0 to 100.

PCTFREELA

The PCTFREELA parameter includes or excludes the data set based on the free space percentage in the primary allocation or last secondary extent for the data set. If the data set never went into secondary allocations, this value is the free space percentage in the primary allocation, before unused space was released with RLSE. If the data set went into secondary allocations, this value is the free space percentage in the last secondary extent, before unused space was released with RLSE.

Allowed in:

INC/EXC for function SPACAQTY

Syntax:

PCTFREELA=nnn

The nnn variable represents a percentage from 0 to 100.

PCTI

The PCTI parameter specifies the percentage value by which a secondary allocation is increased.

Allowed in:

Rule SET parameter for function SPACSECI and SPACVOLA

Syntax:

PCTI=nnnnn

The nnnnn variable represents a number from 0 to 10000.

PCTIACT (PTF BPG7632 applied)

The PCTIACT parameter specifies when the secondary-extent percentage increase is activated.

Allowed in:Rule SET parameter for function SPACSECI
Syntax:

PCTIACT= A | S

The values are defined as follows:

A – The percentage increase value specified in the PCTI parameter is activated for all extents. This is the default.
S – The percentage increase value specified in the PCTI parameter is activated after the extent number specified on the SPACSECI=n parameter is reached.

PCTICALC (PTF BPG7632 applied)

The PCTICALC parameter specifies how many times to apply the calculated percentage increase to the secondary extent before becoming constant.

Allowed in:Rule SET parameter for function SPACSECI
Syntax:

PCTICALC= nn

The nn variable represents a number from 1 (the default) through 15.

Example

SET SPACSECI=3 PCTI=300 PCTIACT=S PCTICALC=3 causes a data set allocated with SPACE=(TRK,(1,1)) to use:

  • 1 track for extents 2 and 3
  • 3 tracks for extent 4
  • 9 tracks for extent 5
  • 27 tracks for extents 6 through 16
PGM

The PGM parameter contains the name of the currently executing program. MainView SRM name masking can be used.

Allowed in:

INC/EXC

Syntax:

PGM=xxxxxxxx

The xxxxxxxx variable represents a valid one- to eight-character program name.

PGMRNAME

The PGMRNAME parameter contains the value of the programmer name field of the job card of the currently executing job. MainView SRM name masking can be used.

Note: This parameter is not available for functions DSNCHECK, SMSACSDC, SMSACSMC, SMSACSSC, SMSACSSG, or SMSACSTE.

Allowed in:

INC/EXC

Syntax:

PGMRNAME=xxxxxxxx

The xxxxxxxx variable represents a valid one- to twenty-character programmer name.

POOL

The POOL parameter specifies or contains the name of a pool. MainView SRM name masking can be used for filter list entries. Up to 15 values of this parameter can be specified within parentheses when used as an action parameter on a SET statement.

Allowed in:

INC/EXC, rule SET parameter for functions DASDPOOL, HSMRECAL, TAPEPOOL, and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view

  • HSMBKVR - Backup DSN version

  • HSMMGDS - Migrated data set view

  • TDSDD - Tape management data set details by DSN view

Syntax:

POOL=poolName

or

POOL=( poolName...)

The poolName variable represents a valid one- to eight-character pool name. If the pool name is not defined, refresh or startup will fail. Up to 15 pool names can be specified in parentheses.

PQTY

The PQTY parameter specifies the size in kilobytes for the primary space allocation.

Allowed in:

Rule SET parameter for function SPACSQTY and SPACAQTY

Syntax:

PQTY=nnnnnK|M|G|T

The nnnnn variable represents a number from 1 to 99999K.

PQTYPCT (PTF BPG7674 applied)

The PQTYPCT parameter reduces the primary allocation amount by a percentage. This value is ignored if the PQTY keyword is set.

Allowed in:

Rule SET parameter for function SPACAQTY and SPACSQTY

Syntax:

PQTYPCT=nnn

The nnn variable represents a percentage from 1 to 100.

PQTYPCTF

The PQTYPCTF parameter reduces the primary allocation amount by a percentage of free space in the primary allocation. The free space information is from the last allocation for the data set, which is maintained in the DS Size Assist database. The free space maintained in the database might not match the one that displays in ISPF 3.2. It is the free space that would have existed if RLSE was not specified at data set close. This value is ignored if the PQTY or PQTYPCT keyword is set or if the data set went into secondary allocations.

Allowed in:

Rule SET parameter for function SPACAQTY

Syntax:

PQTYPCTF=nnn

The nnn variable represents a percentage from 0 to 100.

PRI_CYL

The PRI_CYL parameter specifies the number of primary cylinders on the volume.

Offline volumes have a primary cylinder count of zero. When the volume goes online, the actual primary cylinder count is determine and the volume is included in the appropriate pools.

Allowed in:

INC/EXC statement for function AUTOADDV

Syntax:

PRI_CYL=nnnnn

The nnnnn variable represents a number of cylinders from 0 to 99999.

If PRI_CYL is not used in an INC or EXC statement, volumes will be included in or excluded from the pool regardless of the number of primary cylinders.

This parameter is not available for functions DSNCHECK, SMSACSDC, SMSACSMC, SMSACSSC, SMSACSSG, or SMSACSTE.

Example:

This example selects the volume if the target storage group beings with GROUP* and the candidate volume has more than 32,000 cylinders.

SET ACT_JOB=SRMJOB09

INC GROUP=GROUP* PRI_CYL>32000

PRISPACE

The PRISPACE parameter contains the requested primary space in the units specified in the space request.

Allowed in:

INC/EXC

Syntax:

PRISPACE=nnnnnn

The nnnnnn variable represents a number from 0 to 999999.

PROCSTEP

The PROCSTEP parameter contains the step name of the currently executing procedure. MainView SRM name masking can be used.

Note: This parameter is not available for functions DSNCHECK, SMSACSDC, SMSACSMC, SMSACSSC, SMSACSSG, or SMSACSTE.

Allowed in:

INC/EXC

Syntax:

PROCSTEP=xxxxxxxx

The xxxxxxxx variable represents a one- to eight-character step name.

PURGE

The PURGE parameter specifies whether the old data set should be purged when a NOT CATLGD2 error occurs and NOCATLG2=DELETE and the old data set has an unexpired expiration date. See also the parameter NOCATLG2.

Allowed in:

Rule SET parameter for function NOCATLG2

Syntax:

PURGE=YES | NO | Y | N

PWDDEL

The PWDDEL parameter specifies that any passwords specified for a VSAM definition be deleted.

Allowed in:

Rule SET parameter for function VSAMCNTL

The PWDDEL=Y is specified if all password specifications (ControlPW, MASTERPW, READPW, UPDATEPW) are removed from the cluster definition; if PWDDEL=N is specified, any existing password specification is retained.

Syntax:

PWDDEL=YES | NO | Y | N

QUALn

This parameter is a synonym. See DSN n.

QUALL

This parameter is a synonym. See LLQ.

RACF

The RACF parameter contains the name of the IBM RACF or CA Technologies CA – Top Secret group. MainView SRM name masking can be used. (This parameter will not have a value if your security system is CA Technologies CA – ACF2.)

Allowed in:

INC/EXC

Syntax:

RACF=xxxxxxxx

RACFGRP

The RACFGRP parameter tests the value of either the RACF group coded on the JOB card or the default RACF group.

Allowed in:

INC/EXC

Syntax:

RACFGRP=xxxxxxxx

The xxxxxxxx variable represents a one- to eight-character user ID.

RACFUID

The RACFUID parameter specifies the value of the RACF user ID on a JOB card.

Allowed in:

INC/EXC

Syntax:

RACFUID=xxxxxxxx

The xxxxxxxx variable represents a one- to eight-character user ID.

RAIDDEVTYPE

The RAIDDEVTYPE parameter allows you to require a specific RAID device type for an allocation. If a particular hardware is chosen, the candidate list of volumes will be limited to devices that have the requested attribute flag enabled.

Allowed in:

Rule SET parameter for functions DASDPOOL and SMSSELCT

Syntax:

RAIDDEVTYPE=xxxxxxxx

The values are defined as follows:

  • EMC – The device must be an EMC RAID device.

  • RDFEMC – The device must be EMC and have the RDF flag enabled.

  • MIRROREMC – The device must be EMC and have the MIRROR flag enabled.

  • PARITYEMC – The device must be EMC and have the PARITY flag enabled.

RAID_TYPE

The RAID_TYPE parameter specifies the raid type of the candidate volume.

To see the raid type for a volume in the candidate pool, select the pool from the pool configuration view, GPCNFG, and look at the 'RAID Type' column in the VOLCNFG view.

Allowed in:

INC/EXC statement for function AUTOADDV

Syntax:

RAID_TYPE=raidType

Valid values are:

  • RAMAC

  • RAMAC2

  • RAMAC3

  • RVA

  • SYMMETRIX

  • 2105-ESS

  • 2105

  • DS8000

  • NON-RAID

Examples:
  • This example selects the volume if the storage group begins with ABC and the raid type is a 2105-ESS.

SET ACT_JOB=SRMJOB09

INC GROUP=ABC* RAID_TYPE=2105-ESS

  • Another way to express it is shown in the following example:

SET ACT_JOB=SRMJOB09

INC GROUP=ABC* RAID_TYPE=2105/

REC_TYPE

The REC_TYPE parameter specifies the type of pending recall request queue criteria under which the user will receive an action notification

Allowed in:

INC/EXC in function HSMRQUE

Syntax:

REC_TYPE=D | G | U

Values are:

  • D – Each pending recall is checked against all function HSMRQUE INC/EXC parameters. Action is issued for every recall satisfying INC/EXC criteria. Pending recall means a requested recall that is either currently processed or is waiting for execution.

  • G – All pending recalls are checked against function HSMRQUE INC/EXC parameters representing global statistics for all pending recalls. These parameters are:

    • HSM_#PEND_G - total number of pending recall requests

    • HSM_#PEND_L - number of pending recall requests requested on local system

    An action notification is issued only if global statistics for all pending recalls satisfy INC/EXC criteria for parameters outlined above. Pending recall means a requested recall that is either currently processed or is waiting for execution.

  • U – For every user that has unfinished recalls in pending recall queue checked against the following HSMRQUE INC/EXC parameters:

    • HSM_#SAME_G - total number of pending recall requests for the same user

    • HSM_#SAME_L - number of pending recall requests requested on local system by the same user

    • HSM_USERID - user ID of recall requestor

      An action notification is issued for every user that requested at least one recall not yet executed. In other words, one action is issued for every user waiting for at least one recall.

Default:

REC_TYPE=D

Example:

In this example, actions will be issued for every user that is waiting for at least one recall to complete and satisfies the INC/EXC criteria of the following FLST/RLST keywords:

  • HSM_#SAME_G
  • HSM_#SAME_L
  • HSM_USERID

REC_TYPE=U

RECFM

The RECFM parameter contains the record format of a data set.

Allowed in:

INC/EXC

Syntax:

RECFM=xxx

The first x variable represents a value defined as follows:

  • F (Fixed)

  • V (Variable)

  • U (Undefined)

The second and third variables are defined by values as follows:

  • B (Blocked)

  • S (Spanned)

  • T (Track overflow)

  • M (Machine control character)

  • A (ANSI control character)

RECORG

The RECORG parameter contains the record organization of a VSAM data set.

Allowed in:

INC/EXC

Syntax:

RECORG=xx

The values are defined as follows:

  • RR (Relative record)

  • ES (Entry sequenced)

  • KS (Key sequenced)

  • LS (Linear)

REFAGE

The REFAGE parameter contains the unadjusted, unreferenced day count set by the HSMMIGRT.

Allowed in:

INC/EXC and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS – Backup data set view

  • HSMBKVR – Backup DSN version

  • HSMMGDS – Migrated data set view

  • TDSDD – Tape management data set details by DSN view

Syntax:

REFAGE=nnnnn

The nnnnn variable represents a number from 0 to 99999.

REFVOL

The REFVOL parameter contains the volume serial number of the referenced DASD volume. This DASD volume contains the data set referenced by a VOL=REF parameter in the JCL DD statement.

Note: If the VOL=REF refers to an uncataloged data set name, REFVOL will contain the string NULVRF. Referring to an uncataloged data set in a VOL=REF statement will normally cause a JCL error; however, this JCL error can be suppressed by the SUPVOLRF function.

Allowed in:

INC/EXC parameter for the functions: SMSACSDC, SMSACSMC, SMSACSSC, SMSACSSG, and DASDPOOL

Syntax:

REFVOL=xxxxxx

REJECT

The REJECT parameter specifies whether the z/OS service request is to be rejected or accepted.

Allowed in:

Rule SET parameter for functions DASDPOOL, SMSACSDC, and TAPEPOOL

Syntax:

REJECT=YES | NO | Y | N

RELEASE

The RELEASE parameter contains the space release flag.

Allowed in:

INC/EXC

Syntax:

RELEASE=YES | NO | Y | N

RELGEN#

The RELGEN parameter specifies the relative generation number of backup versions. The most recent backup version is 0, the next most recent is 1, and so forth.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for HSMBKVR Backup DSN Version view

Syntax:

RELGEN#=nn

The nn variable represents a number from 0 to 99.

REORG

The REORG parameter specifies whether SPACVOLA will start a Started Task to reorganize a data set that has just been made multivolume by SPACVOLA.

Allowed in:

Rule SET parameter for function SPACVOLA

Syntax:

REORG=YES | NO | Y | N

REORG_NSMS

The REORG_NSMS parameter specifies the SMRORGxx suffix that contains the DFDSS control cards to be used by the DFDSS reorganize Started Task to reorganize a non-SMS multivolume data set. It also specifies the MainView SRM pool name of the target pool to which the multivolume data set is to be reorganized.

Allowed in:

Rule SET parameter for function SPACVOLA

Syntax:

REORG_NSMS=(xx,poolName)

The values are defined as follows:

  • The xx variable represents the SMRORG xx suffix.

  • The poolName variable represents the MainView SRM target pool for the reorganization.

REORG_PROC

The REORG_PROC parameter specifies the name of the procedure library member to be used as the Started Task JCL for the DFDSS reorganize job that is started by SPACVOLA processing automatically if REORG=Y is specified in the SPACVOLA RLST SET statement.

Allowed in:

Rule SET parameter for function SPACVOLA

Syntax:

REORG_PROC=(procName)

The procName variable represents the procedure library member to use as the Started Task JCL for the reorganize job.

REORG_SMS

The REORG_SMS parameter specifies the SMRORG xx suffix that contains the DFDSS control cards to be used by the DFDSS reorganize Started Task to reorganize an SMS multivolume data set. It also specifies the DFSMS Storage Class to be used as the target Storage Class to which the multivolume data set is to be reorganized.

Allowed in:

Rule SET parameter for function SPACVOLA

Syntax:

REORG_SMS=(xx,storClas)

The values are as follows:

  • The xx variable represents the SMRORG xx suffix.

  • The storClas is the DFSMS target Storage Class for the reorganize.

REPL

The REPL parameter contains and specifies the removal of the REPLICATE parameter during cluster definition.

Allowed in:

INC/EXC and rule SET parameter for function VSAMCNTL

Syntax:

REPL=YES | NO | Y | N

If Y is specified, the REPLICATE parameter is forced in the DEFINE CLUSTER definition; if N is specified, the REPLICATE parameter is removed from the DEFINE CLUSTER definition.

Note: When used as a SET parameter, this parameter is only valid for VSAM data sets.

REPLACE

The REPLACE parameter specifies that the z/OS value is to be replaced by the MainView SRM calculated value.

Allowed in:

Rule SET parameter for functions SETEXPDT, SMSACSDC, SMSACSMC, SMSACSSC, SMSACSSG, and SPACSQTY

Syntax:

REPLACE=YES | NO | Y | N

RETNCPY

The RETNCPY parameter indicates whether retained backup copies are to be displayed by EZSRMHSM view HSMBKVR (Backup Data Set Versions).

Allowed in:

Flst INC statements in data set backup versions filtering Flst PARMLIB member SMFE15xx.

Syntax:

RETNCPY=ONLY|N|NO|Y|YES

The values are defined as follows:

  • ONLY – Displays only retained backup copies.

  • NO – Retained backup copies are not displayed.

  • YES – Displays retained backup copies.

Retained copies are the backup copies that have rolled off from the active copies, but have not yet reached their retention periods. Roll-off processing removes all backup versions that have expired RETAINDAYS values. IBM manual z/OS V1R13.0 DFSMShsm Storage Administration contains all the details of the RETAINDAYS attribute.

Default:

RETNCPY=YES

RETPD

The RETPD parameter contains and specifies the retention period in days for a new data set.

Allowed in:

INC/EXC and rule SET parameter for function SETEXPDT

Syntax:

RETPD=nnnn

The nnnn variable represents a number of days from 0 to 9999.

REUSE

The REUSE parameter contains and specifies the removal of the REUSE parameter during cluster definition.

Allowed in:

INC/EXC and rule SET parameter for function VSAMCNTL

Syntax:

REUSE=YES | NO | Y | N

If Y is specified, the REUSE parameter is forced in the DEFINE CLUSTER definition; if N is specified, the REUSE parameter is removed from the DEFINE CLUSTER definition.

Note: When used as a selection parameter, this parameter is only valid for VSAM data sets.

RLSE

The RLSE parameter specifies that the SPACRLSE function is to release space for newly allocated data sets.

Allowed in:

Rule SET parameter for function SPACRLSE

Syntax:

RLSE=ALL | SEC | NO

The values are defined as follows:

  • ALL – Releases space for all data sets

  • SEC – Releases space for data sets with a secondary allocation

  • NO – Turns the release flag off

ROUND

The ROUND parameter contains and specifies that the ROUND subparameter of the SPACE parameter is in the JCL.

Allowed in:

INC/EXC and rule SET parameter for functions SPACAQTY, SPACCONV, and SPACSQTY

Syntax:

ROUND=YES | NO | Y | N

RQ_INTRVL

The RQ_INTRVL parameter specifies the time interval in minutes between same actions issued by function HSMRQUE.

The REC_TYPE INC/EXC parameter defines the type of pending recall request queue criteria under which function HSMRQUE triggers an action and generates notification.

Allowed in:

Rule SET parameter for function HSMRQUE

Syntax:

RQ_INTRVL=nnnnn

The nnnnn variable represents the number of minutes from 1 to 32767.

SECALLOCS

The SECALLOCS parameter includes or excludes the data set based on secondary allocations in the last allocation for the data set.

Allowed in:

INC/EXC for function SPACAQTY

Syntax:

SECALLOCS=nnnnn

The nnnnn variable represents a number from 1 to 99999.

SECSPACE

The SECSPACE parameter contains the requested secondary space in the units specified in the space request.

Allowed in:

INC/EXC

Syntax:

SECSPACE=nnnnnnK|M|G|T

The nnnnnn variable represents a number from 0 to 999999.

SCAN

The SCAN parameter specifies not to budget space for any level associated with a data set; this parameter is unique to the application collector

Allowed in:

Rule SET parameter

Syntax:

SCAN=EXIT

SEP

The SEP parameter specifies whether the data and index components of a VSAM key-sequenced data set are allocated to separate volumes in a pool.

CANDIDATE=Y must also be specified for VSAM component separation.

Allowed in:

Rule SET parameter for function DASDPOOL

Syntax:

SEP=YES | NO | Y | N|ASIS

SGC_FUNC

The SGC_FUNC parameter specifies the value of the application collector function currently being processed.

Allowed in:

INC/EXC

Syntax:

SGC_FUNC=ApplFunc

Valid values are:

  • ALLOCATE

  • EXTENDCV (extend on current volume

  • EXTENDNV (extend on new volume)

  • EXTENDVS (extend on VSAM)

  • RELEASE

  • RENAME

  • SCRATCH

  • BUDGET (TSO command being executed)

  • BUDDSN (TSO command being executed)

  • SGCMAINT (program being executed)

  • SGCRSYNC (program being executed)

  • SGCHSMR (batch HSM report program is being executed)

  • SVOSISPF (SGC programs are being invoked from the SVOS ISPF interface)

SGP_@BUSY

The SGP_@BUSY parameter specifies channel path busy threshold for inclusion or exclusion.

Allowed in:

INC/EXC

Syntax:

SGP_@BUSY{=|<|>} nnn

SGP_BESCOLT

The SGP_BESCOLT parameter specifies the collected back-end space in tenths of a MB.

Allowed in:

INC/EXC

Syntax:

SGP_BESCOLT=nnnnnnnn

The nnnnnnnn variable represents 1 to 8 numbers.

SGP_BESFREE

The SGP_BESFREE parameter specifies the free back-end space in tenths of a megabyte.

Syntax:

SGP_BESFREE=nnnnnnnn

The nnnnnnnn variable represents 1 to 8 numbers.

SGP_BESTOTL

The SGP_BESTOTL parameter specifies the total back-end space in tenths of a megabyte.

Syntax:

SGP_BESTOTL=nnnnnnnn

The nnnnnnnn variable represents 1 to 8 numbers.

SGP_BESUNCL

The SGP_BESUNCL parameter specifies the uncollected back-end space in tenths of a megabyte.

Syntax:

SGP_BESUNCL=nnnnnnnn

The nnnnnnnn variable represents 1 to 8 numbers.

SGP_CFWHIT@

The SGP_CFWHIT@ parameter specifies percentage of DFAST reads satisfied by cache threshold.

Syntax:

SGP_CFWHIT@=nnn

The nnn variable represents 0 to 100.

SGP_CFWPRSC

The SGP_CFWPRSC parameter specifies number of CFAST writes and reads per-second threshold.

Syntax:

SGP_CFWPRSC=nnn

SGP_CHPID

The SGP_CHPID parameter specifies channel paths to be included or excluded.

Syntax:

SGP_CHPID=chp ID

SGP_CNTLUID

The SGP_CNTLUID parameter specifies subsystem IDs of cache controllers to be included or excluded.

Syntax:

SGP_CNTLUID=subsystemID ID

SGP_CONNTIM

The SGP_CONNTIM parameter specifies the data set connect time threshold in 0.1-millisecond increments.

Syntax:

SGP_CONNTIM=nnnnn

SGP_CUBSYDL

The SGP_CUBSYDL parameter specifies the control unit busy delay threshold in 0.1-millisecond increments.

Syntax:

SGP_CUBSYDL=nnnnn

SGP_DFWHIT@

The SGP_DFWHIT@ parameter specifies percentage of DFAST writes satisfied by cache threshold.

Syntax:

SGP_DFWHIT@=nnn

The nnn variable represents a percentage from 0 to 100.

SGP_DFWPRSC

The SGP_DFWPRSC parameter specifies number of DFAST writes per-second threshold.

Syntax:

SGP_DFWPRSC=nnn

SGP_DISCTIM

The SGP_DISCTIM parameter specifies the data set disconnect time threshold in 0.1-millisecond increments.

Syntax:

SGP_DISCTIM=nnnnn

SGP_DP@BUSY

The SGP_DP@BUSY parameter specifies director port busy percentage to be included or excluded.

Syntax:

SGP_DP@BUSY=nn

SGP_DPBSYDL

The SGP_DPBSYDL parameter specifies the director port busy delay time threshold in 0.1-millisecond increments.

Syntax:

SGP_DPBSYDL=nnnnn

SGP_DVBSYDL

The SGP_DVBSYDL parameter specifies the device busy delay time threshold in 0.1-millisecond increments.

Syntax:

SGP_DVBSYDL=nnnnn

SGP_ECMCFBS

The SGP_ECMCFBS parameter specifies the ECAM channel programs bypassed due to busy configuration in tenths of a megabyte.

Syntax:

SGP_ECMCFBS=nnnnnnnn

The nnnnnnnn variable represents 1 to 8 numbers.

SGP_ECMMSGS

The SGP_ECMMSGS parameter specifies ECAM messages processed in tenths of a megabyte.

Syntax:

SGP_ECMMSGS=nnnnnnnn

The nnnnnnnn variable represents 1 to 8 numbers.

SGP_ECMNSPC

The SGP_ECMNSPC parameter specifies the ECAM channels programs bypassed due to no buffer space in tenths of a megabyte.

Syntax:

SGP_ECMNSPC=nnnnnnnn

The nnnnnnnn variable represents 1 to 8 numbers.

SGP_ECMPGMS

The SGP_ECMPGMS parameter specifies the ECAM channel programs in tenths of a megabyte.

Syntax:

SGP_ECMPGMS=nnnnnnnn

The nnnnnnnn variable represents 1 to 8 numbers.

SGP_FSCBYRD

The SGP_FSCBYRD parameter specifies the collected free space bytes read in tenths of a megabyte.

Syntax:

SGP_FSCBYRD=nnnnnnnn

The nnnnnnnn variable represents 1 to 8 numbers.

SGP_FSCPERC

The SGP_FSCBYRD parameter specifies the percentage of collected free space in tenths of a percent.

Syntax:

SGP_FSCBYRD=nnnn

The nnnn variable represents 1 to 4 numbers.

SGP_FSUPERC

The SGP_FSUPERC parameter specifies the percentage of uncollected free space in tenths of a percent.

Syntax:

SGP_FSUPERC=nnnn

The nnnn variable represents 1 to 4 numbers.

SGP_IOPRSEC

The SGP_IOPRSEC parameter specifies number of I/Os per-second threshold.

Syntax:

SGP_IOPRSEC{=|<|>} nnn

SGP_IOSQTIM

The SGP_IOSQTIM parameter specifies the data set IOSQ time threshold in 0.1-millisecond increments.

Syntax:

SGP_IOSQTIM=nnnnn

SGP_LCU@BSY

The SGP_LCU@BSY parameter specifies LCU busy percentage to be included or excluded.

Syntax:

SGP_LCU@BSY=nnn

SGP_LCUID

The SGP_LCUID parameter specifies the logical control unit ID of those controllers to be included or excluded.

Syntax:

SGP_LCUID=lcu ID

SGP_NCL

The SGP_NCL parameter specifies the net capacity load in bytes.

Syntax:

SGP_NCL=nnnnnnnnnn

The nnnnnnnnnn variable is a decimal number from 0 to 2,147,483,647.

SGP_NCLPERC

The SGP_NCLPERC parameter specifies the net capacity load percentage in tenths of a percent.

Syntax:

SGP_NCLPERC=nnnn

The nnnn variable represents 1 to 4 numbers.

SGP_NRDHIT@

The SGP_NRDHIT@ parameter specifies percentage of normal reads satisfied by cache threshold.

Syntax:

SGP_NRDHIT@=nnn

The nnn variable represents a percentage from 0 to 100.

SGP_NRDPSEC

The SGP_NRDPSEC parameter specifies number of normal reads per-second threshold.

Syntax:

SGP_NRDPSEC=nnn

SGP_NWRHIT@

The SGP_NWRHIT@ parameter specifies percentage of normal writes satisfied by cache threshold.

Syntax:

SGP_NWRHIT@=nnn

The nnn variable represents a percentage from 0 to 100.

SGP_NWRTPSC

The SGP_NWRTPSC parameter specifies number of normal writes per-second threshold.

Syntax:

SGP_NWRTPSC=nnn

SGP_PENDTIM

The SGP_PENDTIM parameter specifies the data set pending time threshold in 0.1-millisecond increments.

Syntax:

SGP_PENDTIM=nnnnn

SGP_RDHIT@

The SGP_RDHIT@ parameter specifies percentage of reads satisfied by cache threshold.

Syntax:

SGP_RDHIT@=nnn

The nnn variable represents a percentage from 0 to 100.

SGP_RDSPRSC

The SGP_RDSPRSC parameter specifies number of reads per-second threshold.

Syntax:

SGP_RDSPRSC=nnn

SGP_READ@

The SGP_READ@ parameter specifies the percentage of IOs that are reads threshold.

Syntax:

SGP_READ@=nnn

The nnn variable represents a percentage from 0 to 100.

SGP_RESERV@

The SGP_RESERV@ parameter specifies percentage volume is reserved for inclusion or exclusion.

Syntax:

SGP_RESERV@=nn

SGP_RESPTIM

The SGP_RESPTIM parameter specifies the data set response time threshold in 0.1-millisecond increments.

Syntax:

SGP_RESPTIM=nnnnn

SGP_RSFNAME

The SGP_RSFNAME parameter specifies the IXPF subsystem frame name.

Syntax:

SGP_RSFNAME=frameName

The frameName variable represents one- to eight-character IXPF subsystem frame name.

SGP_SRDHIT@

The SGP_SRDHIT@ parameter specifies percentage of sequential reads satisfied by cache threshold.

Syntax:

SGP_SRDHIT@=nnn

The nnn variable represents a percentage from 0 to 100.

SGP_SRDPRSC

The SGP_SRDPRSC parameter specifies number of sequential reads per-second threshold.

Syntax:

SGP_SRDPRSC=nnn

SGP_SWRHIT@

The SGP_SWRHIT@ parameter specifies percentage of sequential writes satisfied by cache threshold.

Syntax:

SGP_SWRHIT@=nnn

The nnn variable represents a percentage from 0 to 100.

SGP_SWRPRSC

The SGP_SWRPRSC parameter specifies number of sequential writes reads per-second threshold.

Syntax:

SGP_SWRPRSC=nnn

SGP_WRHIT@

The SGP_WRHIT@ parameter specifies percentage of writes satisfied by cache threshold.

Syntax:

SGP_WRHIT@=nnn

The nnn variable represents a percentage from 0 to 100.

SGP_WRITE@

The SGP_WRITE@ parameter specifies percentage of IOs that are writes threshold.

Syntax:

SGP_WRITE@=nnn

The nnn variable represents a percentage from 0 to 100.

SGP_WRPRSEC

The SGP_WRPRSEC parameter specifies number of writes per-second threshold.

Syntax:

SGP_WRPRSEC{=|>|<) nnn

SHOWSMAT

The SHOWSMAT parameter specifies whether SMAT variables should be displayed for debugging problems with MainView SRM rules. This parameter is generally only used at the request of BMC Software support.

Allowed in:

Rule SET parameter for filter list (SMFLST xx) members

Syntax:

SHOWSMAT=Y | N | YES | NO

Default :SHOWSMAT=N
SIZE

The SIZE parameter contains the size of either the primary extent or the primary plus two secondary extents.

Allowed in:

INC/EXC and in data set filtering FLST members

Syntax:

SIZE=nnnnnnnnnnK|M|G|T

The nnnnnnnnnn variable represents from 1 to 10 digits, and K,M,G,T specifies whether the number is expressed in kilobytes, megabytes, gigabytes, or terabytes. The comparison operator symbol can be equals (=), greater than (>), or less than (<). The maximum allowable specification for SIZE is 2147483647K.

Note: The setting of the SIZEISPRIM global parameter affects the value associated with the SIZE parameter.

SMF

The SMF parameter specifies the SMF message generation option for resources that are selected by the following parameters. Informational and error messages can be written to the SMF data set, or all messages can be omitted from the SMF data set. Note that the SMF option on the function definition in the SMFUNC xx member is overridden by this option for specific selected resources.

Note: The SMF parameter is used only for the HSM collector, Allocation, and DMS2HSM.

Syntax:

SMF=I |W | E | S | N

The values are defined as follows:

  • I (Informational and error messages)

  • W (Warning messages)

  • E (Error messages only)

  • S (Severe messages)

  • N (No messages)

SMS

This parameter is a synonym. See SMSMANAGED.

SMSGROUP

The SMSGROUP parameter specifies the SMS storage group to which the primary volume of the backed up or migrated data set was assigned.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS (Backup data set view)

  • HSMBKVR (Backup DSN version)

  • HSMMGDS (Migrated data set view)

  • TDSDD (Tape management data set details by DSN view)

Syntax:

SMSGROUP=xxxxxxxx

The xxxxxxxx variable represents one to thirty characters of a valid SMS storage group name. Masking is allowed.

SMSMANAGED

The SMSMANAGED parameter specifies whether the resource is managed by DFSMS.

Allowed in:

INC/EXC, rule SET parameter for function SMSACSTE, and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS (Backup data set view)

  • HSMBKVR (Backup DSN version)

  • HSMMGDS (Migrated data set view)

  • TDSDD (Tape management data set details by DSN view)

Syntax:

SMSMANAGED=YES | NO | Y | N

SMSNVOL (PTF BPG7644 applied)

Specifies whether to use the NVOL value to change the number of volumes and units allocated to an non-VSAM SMS-managed data set.

Allowed in:Rule SET parameter for function DASDPOOL
Syntax:SMSNVOL=YES|NO

Note

The SMSNVOL parameter works in conjunction with the NVOL= parameter only in the DASDPOOL function.

SMSPOOL

The SMSPOOL parameter specifies 1 to 15 SMSPOOLs that are to be used to limit volume selection during DADSM ALLOCATE for SMS-managed data sets.

Allowed in:

Rule SET parameter for function SMSSELCT and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view

  • HSMBKVR - Backup DSN version

  • HSMMGDS - Migrated data set view

  • TDSDD - Tape management data set details by DSN view

Syntax:

SMSPOOL=(xxxxxxxx , xxxxxxxx,...)

The xxxxxxxx variable represents an SMSPOOL.

Note: The SMSPOOLs must contain a subset of volumes from the SMS STORGRP assigned to the data set, or the allocation will fail. In addition, if multiple pools are coded in the parameter, no attempt is made to select volumes from the pools in any order. The first volume that matches a volume in any of the pools will be passed.

SMSPOOL_EXT

The SMSPOOL_EXT parameter specifies 1 to 15 SMSPOOLs that are to be used to limit volume selection during DADSM EXTENDNV (extend to a new volume) for SMS-managed data sets.

Allowed in:

Rule SET parameter for function SMSSELCT

Syntax:

SMSPOOL_EXT=(xxxxxxxx,xxxxxxxx,...)

The xxxxxxxx variable represents an SMSPOOL.

Note: The SMSPOOLs must contain a subset of volumes from the SMS STORGRP assigned to the data set, or the allocation will fail. In addition, if multiple pools are coded in the parameter, no attempt is made to select volumes from the pools in any order. The first volume that matches a volume in any of the pools will be passed.

SOLUTION

The SOLUTION parameter contains the solution value from the originating AUTO function command.

It is recommended that each SET statement in the AUTO function include a unique solution value. This solution value can then be used on the AUTO function console command to invoke the solution.

Allowed in:

INC/EXC in the AUTO functions

Syntax:

SOLUTION=xxxxxxxx

The xxxxxxxx variable represents a one- to eight-character solution value.

SORT

The SORT parameter specifies INC/EXC fields to sort the result group of record prior to taking any actions on the group. This parameter can be used, in conjunction with ACT_COUNT to take actions on the pools with the highest or lowest values in any of the pool space information fields.

Allowed in:

Rule SET parameter for AUTOAPPL, AUTODS, AUTOPOOL, and AUTOVOL.

Syntax:

SORT=(fieldName, x,fieldName, x,....)

The fieldName variable represents a valid INC/EXC field for the function.

The x variable represents either A (ascending) or D (descending).

If not specified, the result group of pools is not sorted and actions are taken in the order the pool information was collected.

Example:SORT=(AP_PERUSED,D) along with ACT_COUNT=5 causes any specified action to be taken on the five highest utilized pools.
SPACPRIM

The SPACPRIM parameter specifies the lower limit and decrement of space reduction, both as a percentage of the original primary allocation value. The first value specifies a lower limit, below which SPACPRIM will not go. The second value is the percentage by which the primary allocation will be decremented. For example, if SPACPRIM=(50,15), the function will decrement the original primary value by 15 percent on each attempt to find a primary extent but will not decrement the primary size more than 50 percent of the original value.

Allowed in:

Rule SET parameter for function SPACPRIM

Syntax:

SPACPRIM=(nn,nn)

The nn variable represents a percentage from 0 to 90. The first value specified is the lower limit; the second value specified is the decrement amount.

If you specify only one number, it refers to the lower limit (the first number) and the decrement percentage (the second number) defaults to 10%.

SPACSECA

The SPACSECA parameter specifies the size of the secondary space allocation as a percentage of the primary space allocation for data sets with no specified secondary allocation. For example, if the primary space allocation is 10 cylinders and SPACSECA=70, a data set with no secondary allocation specified is given 7 cylinders by SPACSECA. See also the SPACPRIM and SPACSECI parameters.

Allowed in:

Rule SET parameter for function SPACSECA

Syntax:

SPACSECA=nnnn

The nnnn variable represents a percentage from 1 to 9999.

SPACSECB

The SPACSECB parameter specifies the lower limit for the space reduction as a percentage of the original secondary allocation request.

Allowed in:

Rule SET parameter for function SPACSECB

Syntax:

SPACSECB=nnn

The nnn variable represents a percentage from 0 to 100.

SPACSECI

The SPACSECI parameter specifies the point in secondary extent processing for physical sequential data sets that the SPACSECI function automatically increases the size of the secondary allocation request. After the specified number of secondary extents have been allocated, SPACSECI increases the size of the secondary allocation by 100 percent of the original secondary allocation for each subsequent allocation. See the SPACSECI function description for an example. See also the SPACPRIM and SPACSECA parameters.

Allowed in:

Rule SET parameter for function SPACSECI

Syntax:

SPACSECI=nn

The nn variable represents a number from 1 to 15.

SPACSECR

The SPACSECR parameter specifies the lower limit and the decrement of space reduction, both as a percentage of the original secondary allocation value. The first value specifies a lower limit, below which SPACSECR will not go. The second value is the percentage by which the secondary allocation will be decremented. For example, if SPACSECR=(50,10), the function will decrement the original secondary value by 10 percent on each attempt to find a secondary extent but will not decrement the secondary size more than 50 percent of the original value. The decrement percentage is used only for striped data sets with multiple stripes.

Allowed in:

Rule SET parameter for function SPACSECR

Syntax:

SPACSECR=(nnn,nnn)

The values are defined as follows:

  • The first nnn variable represents the floor limit.

  • The second nnn is a percentage from 0 to 100 by which reduction can take place until either it fits or the floor limit is reached. (A specification of 100 will not reduce the secondary size at all.)

Default:

SPACSECR=(0,10)

SPACSWIR

The SPACSWIR parameter specifies the lower limit and decrement amount for space reduction when adding a new volume. Both are specified as a percentage of the original primary allocation value. The first value specifies a lower limit, below which SPACSWIR will not go. The second value is the percentage by which the primary allocation will be decremented. For example, if SPACSWIR=(50,10), the function will decrement the original primary value by 10 percent on each attempt to find a primary extent but will not decrement the primary size to less than 50 percent of the original value.

Allowed in:

Rule SET parameter for function SPACSWIR

Syntax:

SPACSWIR=(nnn,nnn)

The values are defined as follows:

  • The first nnn variable represents the floor limit.

  • The second nnn variable represents a percentage from 0 to 100 by which reduction can take place until either it fits or the floor limit is reached. (A specification of 100 will not reduce the secondary size at all.)

Default:

SPACSWIR=(0,10)

SPACVOLA

The SPACVOLA parameter specifies the maximum number of volumes on which a data set can be allocated during secondary extent processing. The SPACVOLA function adds volumes to a data set allocation, up to the limit. SPACVOLA does not support SAS data libraries. (SAS does not support z/OS multivolume data sets.) See also the SPACPRIM, SPACSECA, and SPACSECI parameters.

Allowed in:

Rule SET parameter for function SPACVOLA

Syntax:

SPACVOLA=nn

The nn variable represents a number of volumes from 1 to 59.

SPECIFIC

The SPECIFIC parameter specifies whether a specific volume was requested for a new data set allocation.

Allowed in:

INC/EXC

Syntax:

SPECIFIC=YES | NO | Y | N

SPLIT

The SPLIT parameter specifies whether affinity separation should be applied to resources selected for the STKSUPP function. When unit affinity directs multiple DD statements to a single drive, STKSUPP can apply affinity separation to allocate separate devices for silo and non-silo volumes, so volumes would not have to be entered into or removed from silos.

Allowed in:

Rule SET parameter for function STKSUPP.

Syntax:

SPLIT=YES | NO | Y | N

SQTY

The SQTY parameter specifies the size in kilobytes for the secondary space allocation.

Allowed in:

Rule SET parameter for function SPACSQTY and SPACAQTY

Syntax:

SQTY=nnnnnK|B|G|T

The nnnnn variable represents a number from 0 to 99999.

SQTYPCT (PTF BPG7674 applied)

The SQTYPCT parameter reduces the secondary allocation amount by a percentage. This value is ignored if the SQTY keyword is set.

Allowed in:

Rule SET parameter for function SPACAQTY and SPACSQTY

Syntax:

SQTYPCT=nnn

The nnn variable represents a percentage from 1 to 100.

SQTYPCTF

The SQTYPCTF parameter reduces the secondary allocation amount by a percentage of free space in the last secondary extent. The free space information is from the last allocation for the data set, which is maintained in the DS Size Assist database. The free space maintained in the database might not be the one that displays in ISPF 3.2. It is the free space that would have existed if RLSE was not specified at data set close. This value is ignored if the SQTY or SQTYPCT keyword is set or if the data set did not go into secondary allocations.

Allowed in:

Rule SET parameter for function SPACAQTY

Syntax:

SQTYPCTF=nnn

The nnn variable represents a percentage from 0 to 100.

STACKDS

The STACKDS parameter specifies whether a tape data set with a file sequence number of two or more is selected.

Allowed in:

data set filtering FLST members

Syntax:

STACKDS =Y | N | YES | NO

STEP

The STEP parameter contains the stepname of a job step. MainView SRM name masking can be used.

Allowed in:

INC/EXC

Syntax:

STEP=xxxxxxxx

The xxxxxxxx variable represents a valid 1 to 8-character job step name.

STEPACCTn

The STEPACCT n parameter contains the nth subfield in the ACCT field of the EXEC JCL statement. MainView SRM name masking can be used.

Allowed in:

INC/EXC

Syntax:

STEPACCT n=xxxxxxxx

The values are defined as follows:

  • The n variable represents a subfield number from 1-3.

  • The xxxxxxxx variable represents a 1 to 20-character ACCT field.

STOGROUP or STORGRP

The STOGROUP or STORGRP parameter specifies or contains the DFSMS storage group name for a data set. MainView SRM name masking can be used for filter list entries. Rule list entries must specify a valid DFSMS storage group name.

Allowed in:

INC/EXC and rule SET parameter for function SMSACSSC and INC/EXC parameter for function AUTOADDV

Syntax:

STOGROUP=storGrp

or

STORGRP=storGrp

The storGrp variable represents a valid one- to eight-character storage group name.

Example:

This example selects the volume if the storage group to which the volume is being added is GROUPABC and the candidate volume is a model 3390-54.

SET ACT_JOB=SRMJOB09

INC GROUP=GROUPABC VOL_DEVTYPE=3390-54

STORCLAS

The STORCLAS parameter specifies or contains the DFSMS storage class name for a data set. MainView SRM name masking can be used for filter list entries. Rule list entries must specify a valid storage class name.

Allowed in:

INC/EXC, rule SET parameter for function SMSACSSC, and FLST INC/EXC statements in data set filtering FLST members for:

  • HSMBKDS - Backup data set view

  • HSMBKVR - Backup DSN version

  • HSMMGDS - Migrated data set view

  • TDSDD - Tape management data set details by DSN view

Syntax:

STORCLAS=storClas

The storClas variable represents a valid one- to eight-character storage class name.

STORGRP

This parameter is a synonym. See STOGROUP.

STRIPCNT

The STRIPCNT parameter contains the number of stripes allocated to the data set. The STRIPCNT parameter is used to determine the number of stripes that are allocated to an extended format sequential data set. This parameter will always be one for a single stripe data set.

Allowed in:

INC/EXC

Syntax:

STRIPCNT=nnnnnnnn

The nnnnnnnn variable represents a number from 1 too 99999999.

Note: This parameter is not valid during SPACPRIM processing. The current z/OS DFP maximum is 16 stripes.

STRIPTY

The STRIPTY parameter specifies the type of extended format data set.

Allowed in:

INC/EXC

Syntax:

STRIPTY=xx

The values are defined as follows:

  • SS (Single stripe SAM data sets)

  • SM (Multistripe SAM data sets)

  • VS (Single stripe VSAM data sets)

Note: This parameter is not valid during SPACPRIM processing.

SUPVOL

The SUPVOL parameter specifies that allocation requests for specific volumes are suppressed (SUPVOL=Y) or allowed (SUPVOL=N). Suppression of specific volume requests allows MainView SRM to allocate to any volumes in the eligible pools. See also the parameters USEVOL and MNTYPE.

Allowed in:

Rule SET parameter for function DASDPOOL

Syntax:

SUPVOL=YES | NO | Y | N

Default:

SUPVOL=Y

SVOSCMD

The SVOSCMD parameter specifies a valid SVOS command to be issue for each record in the SET result group. The command is applied after any SORT specification is processed, which means that the commands are generated in sort order. You can use the ACT_SUM_LIM or ACT_COUNT parameter to limit the number of commands that are issued.

The SVOS command syntax does not require any command character or prefix. The command can contain variables which will be replaced by values available in the result solution set created by the criteria defined in the solution. These are the same variables that are available for skeleton tailoring.

The command cannot exceed 126 bytes in length after all variable substitutions are made and must be enclosed in single quotation marks.

Syntax:

SVOSCMD= 'svosCommand'

Examples:
  • This command will cause the AUTO function AUTODS to run against the volume MYVOL using the solution DELUNCAT for processing:

SVOSCMD= 'AUTODS,VOL=MYVOL,SOL=DELUNCAT'

  •  This command will replace the variable &VOLSER with the value provided by the result solution set and cause the AUTODS function to run against that volume. Therefore, if volume ABC123 was part of the solution set, &VOLSER will be replaced with ABC123.

SVOSCMD= 'AUTODS,VOL=&VOLSER,SOL=DELUNCAT'

SYSCMD

The SYSCMD parameter specifies a valid MVS system or JES command to be issue for each record in the SET result group. The command is applied after any SORT specification is processed, which means that the commands are generated in sort order. You can use the ACT_SUM_LIM or ACT_COUNT parameter to limit the number of commands that are issued. The command can contain variables which will be replaced by values available in the result solution set created by the criteria defined in the solution. These are the same variables that are available for skeleton tailoring.

The command must be coded using the same syntax required for entering the command to the MCS console. The command cannot exceed 126 bytes in length after all variable substitutions are made and must be enclosed in single quotation marks.

Note: If the MVS.MCSOPER.** RACF facility is active, the USERID associated with the SVOS address space must be given READ access, which enables SVOS to activate an MCS console. For more information, see Customizing MainView SRM products.

Syntax:

SYSCMD= 'systemCommand'

Example:

This command will cause the system to display the DASD that is online:

SYSCMD= 'D U,DASD,ONLINE'

SYSID

The SYSID parameter contains a z/OS operating system identifier. MainView SRM name masking can be used.

Note: This parameter is not available for functions DSNCHECK, SMSACSDC, SMSACSMC, SMSACSSC, SMSACSSG, or SMSACSTE.

Allowed in:

INC/EXC

Syntax:

SYSID=xxxx

The xxxx variable represents a system identifier from one- to four-characters long.

TAPE_EXPDT

The TAPE_EXPDT parameter contains the 10-character expiration date of the tape data set in yyyy/mm/dd format. Filtration does not take place if the expiration date field does not contain an actual expiration date. Tape data set records with an actual expiration date will have an EXPTYP value of D, J, or blank displayed in the Tape management Data Set Details by DSN view. An expiration date of 9999/99/99 will be assigned for tape data sets that do not have an expiration date.

Allowed in:

data set filtering FLST members

Syntax:

TAPE_EXPDT =yyyy/mm/dd

TAPELOC

The TAPELOC parameter specifies the tape data set location as determined by the Tape Management Software. MainView SRM name masking can be used for filter list entries.

Allowed in:

data set filtering FLST members

Syntax:

TAPELOC=xxxxxxxx

The xxxxxx variable represents a valid one- to eight-character tape location name.

TEMPDSN

The TEMPDSN parameter flags temporary data sets. This parameter is unique to the application collector.

Allowed in:

INC/EXC

Syntax:

TEMPDSN=YES | NO | Y | N

TRKCYL

The TRKCYL parameter specifies the number of tracks per cylinder of the source volume for the SPACCONV function. The value is used to calculate the proper size of an allocation on new devices for specifications based on devices no longer used.

Allowed in:

Rule SET parameter for function SPACCONV

Syntax:

TRKCYL=nn

The nn variable represents a number from 1 to 99.

TRKLEN

The TRKLEN parameter specifies the number of bytes per track of the source volume for the SPACCONV function. The value is used to calculate the proper size of an allocation on new devices for specifications based on devices no longer used.

Allowed in:

Rule SET parameter for function SPACCONV

Syntax:

TRKLEN=nnnnn

The nnnnn variable represents a number from 1 to 99999.

UNIT

The UNIT parameter contains or specifies the unit generic name (esoteric or generic) to be used by the data set during allocation.

Note: To use the UNIT=Filter on VTS data sets, you must specify JCLEXT=NO in the SMMSYS xx member.

Allowed in:

INC/EXC and the rule SET parameters for functions DASDPOOL, SPACVOLA, and TAPECOMP

Syntax:

UNIT=xxxxxxxx

The xxxxxxxx variable represents a valid one- to eight-character unit name (esoteric or generic).

UNIT_ADDR

The UNIT_ADDR parameter specifies the unit address of the candidate volume. This unit address will be re-initialized to the target volser and brought online to the target storage group.

To see the unit address, also know as device address or UCB address, for a volume in the candidate pool, select the pool from the pool configuration view, GPCNFG, and look at the Dev UCB column in the VOLCNFG view.

Allowed in:

INC/EXC statement for function AUTOADDV

Syntax:

UNIT_ADDR=unitAddress

The unitAddress variable represents four alphanumeric characters in a valid range of 0000 through FFFF.

Example:

This example selects the volume if the storage group to which the volume is being added begins with GROUP and the candidate volume unit address is greater than 0A00:

SET ACT_JOB=SRMJOB09

INC GROUP=GROUP* UNIT_ADDR=0A00

USECPOOL

The USECPOOL parameter specifies whether the current pool or the alternate pool is searched to find an additional volume required by a secondary allocation. USECPOOL=Y specifies that the current pool is searched, followed by the alternate pool, if any. USECPOOL=N specifies that the current pool is not searched; the search begins with the alternate pool, if any. If USECPOOL=N and no alternate pool is specified, the secondary allocation attempt fails. See also the parameters SPACVOLA, MNTYPE, and ALTPOOL.

Allowed in:

Rule SET parameter for function SPACVOLA

Syntax:

USECPOOL=YES | NO | Y | N

Default:

USECPOOL=Y

USER

The USER parameter contains the user name (RACF or CA Top Secret; for CA ACF2, contains the logon ID). MainView SRM name masking can be used.

Allowed in:

INC/EXC

Syntax:

USER=xxxxxxxx

The xxxxxxxx variable represents a valid one- to eight-character user name.

USEVOL

The USEVOL parameter specifies the type of volume (storage, private, or all) that satisfies non-specific allocation requests. See also the SUPVOL and MNTYPE parameters.

Allowed in:

Rule SET parameter for functions DASDPOOL, FDRASIST, TAPEPOOL, and HSMRECAL

Syntax:

USEVOL=xxxx

The values are defined as follows:

  • STOR (Storage mounted volume)

  • PRIV (Privately mounted volume)

  • ALL (Volume of any mount type)

Default:

USEVOL=ALL

USRCn

The USRC n parameter is a character field for a user-specified variable one to eight characters long. The value of n can be 1-10 (for example USRC1, USRC2, and so forth).

Allowed in:

INC/EXC parameters and the rule SET parameter for function USERVARS

Syntax:

USRC n=xxxxxxxxxx

USRNy

The USRN y parameter is a numeric field for a user-specified variable.

Allowed in:

INC/EXC parameters and the rule SET parameter for function USERVARS

Syntax:

USRN y=nnnnn

The values are defined as follows:

  • The value of y can be from 1- to 10 (for example USRN1, USRN2, and so on).

  • The nnnnn variable represents a user variable that does not exceed 214783647.

VARn

The VAR n parameter specifies variable text that can be substituted into the selected skeleton JCL, which allows user-created variables associated with the SET statement to be passed to the skeleton JCL.

This keyword can be used to reduce the number of skeleton JCL members that are needed for a particular function. Rather than having one member for each unique specification, the &VAR keywords can be used to set the unique value in the variable, whatever it is, and have it included in the tailoring process.

The &VAR keywords can contain other skeleton variables. For example, &VAR2='VERIFY(&CANDVOL)'.

Allowed in:

Rule SET parameter for function AUTOADDV

Syntax:

VAR n= 'textString'

The n variable represents a number between 1 and 9. The textString variable represents from 1 to 80 characters. You can use the continuation character as defined in the FLST/RLST conventions. You must use single quotation marks if the string includes spaces.

This keyword is specified in the RLST SET statement of any AUTO function.

Example:

In this example, the AUTOADDV function selects the current device if it is a 3390-54 and it is being added to the LARGEGRP storage group. The skeleton JCL in SRMJOB10 is used to initialize the selected device.

The RLST SET statement sets the VAR1 variable to the VTOC size for this type of device:

SET ACT_JOB=SRMJOB10 VAR1='VTOC(0,1,14)'
INC DEV_TYPE=3390-54 GROUP=LARGEGRP

The SRMJOB10 skeleton JCL member contains the following in the SYSIN of the INIT step:

//SYSIN  DD *
INIT-
UNIT(&UNIT)-
VERIFY(&CANDVOL)-
VOLID(&TARGVOL)-
&VAR1

After skeleton tailoring, the resulting JCL would be:

//SYSIN  DD *
INIT-
UNIT(&UNIT)-
VERIFY(&CANDVOL)-
VOLID(&TARGVOL)-
VTOC(0,1,14)

If not specified, any &VAR variables in the skeleton JCL will not be tailored.

VCOMPLLQ

The VCOMPLLQ parameter specifies or contains the low-level qualifier of a VSAM data set component. MainView SRM name masking can be used for filter list entries.

Allowed in:

INC/EXC and rule SET parameter for function DSNCHECK

Syntax:

VCOMPLLQ=xxxxxxxx

The xxxxxxxx variable represents a valid one- to eight-character data set name qualifier. It will contain blanks for the cluster.

VENDOR

The VENDOR parameter specifies the vendor name of the volume.

Allowed in:

INC/EXC statement for function AUTOADDV

Syntax:

VENDOR=xxx

This vendor is determined from the RDC CCW. Known current values are EMC | IBM | STK | HTC.

If VENDOR is not used in an INC or EXC statement, volumes will be included in or excluded from the pool regardless of their vendor.

Example:

This example selects the current device if it is on an IBM box and the storage group that begins with IBM:

SET ACT_JOB=SRMJOB09

INC VENDOR=IBM GROUP=IBM*

VFORCE

The VFORCE parameter specifies that naming conventions for VSAM components will be forced by adding standard component suffixes (DATA, INDEX) to VSAM data set cluster names.

Allowed in:

Rule SET parameter for function DASDPOOL

Syntax:

VFORCE=YES | NO | Y | N

Values are defined as follows:

  • Y – Overrides unspecified or invalid VSAM component names by appending.DATA and.INDEX qualifiers to the cluster name

  • N – Default

VIO

The VIO parameter specifies that a data set should be allocated in main storage (VIO=Y) or on DASD (VIO=N).

Allowed in:

Rule SET parameter for function VIOALLOC

Syntax:

VIO=YES | NO | Y | N

VOL_DEVTYPE

The VOL_DEVTYPE parameter specifies the emulated device type of the candidate volume.

To see the emulated device type value for a volume in the candidate pool, select the pool from the pool configuration view, GPCNFG, and look at the Emulated Device column in the VOLCNFG view.

Offline volumes have a emulated device type of blank. When the volume comes online the device type is determined and the volume is included in the appropriate pools.

Allowed in:

INC/EXC statement for function AUTOADDV

Syntax:

VOL_DEVTYPE=deviceType

The deviceType variable represents a 4- to 8-character device type.

The emulated device type is determined from the RDC CCW device type code. The following values are valid for the emulated device type:

  • 3380

  • 3380A

  • 3380D

  • 3380E

  • 3380J

  • 3380K

  • 3380-1

  • 3380-2

  • 3380-3

  • 3390

  • 3390-1

  • 3390-2

  • 3390-3

  • 3390-9

  • 3390-27

  • 3390-54

If VOL_DEVTYPE is not used in an INC or EXC statement, volumes will be included in or excluded from the pool regardless of the emulated device type.

Example:

This example selects the volume if the storage group being added to is GROUPABC and the candidate volume is a model 3390-54.

SET ACT_JOB=SRMJOB09

INC GROUP=GROUPABC VOL_DEVTYPE=3390-54

VOL

The VOL parameter contains the volume serial number. MainView SRM name masking can be used.

Allowed in:

INC/EXC and in data set filtering FLST members

Syntax:

VOL=xxxxxx

The xxxxxx variable represents a valid one- to six-character volume serial number.

VOLSEL

The VOLSEL parameter specifies the method of volume selection from a pool.

Allowed in:

Rule SET parameter for function DASDPOOL, FDRASIST, and SMSSELCT

Syntax:

VOLSEL=BESTFIT | CRITDSN | DPO | HISTDPO | MAXSPACE | PERCENT | SRM

The following table describes the options:

Option

Description

BESTFIT

The VARIABLE parameter specifies that the volume with the smallest contiguous extent that satisfies the primary allocation should be selected.

CRITDSN

The VARIABLE parameter controls allocations by specifying data sets that should not reside on the same volume.

Warning

CRITDSN is resource intensive and should be used only for a small list of critical data sets. It should not be used without considering the system impact.

DPO

The VARIABLE parameter specifies volume selection based on performance statistics accumulated by MainView SRM.

HISTDPO

The VARIABLE parameter specifies volume selection based on historical volume performance.

Warning

HISTDPO requires more resources than normal allocations.

MAXSPACE

The VARIABLE parameter specifies that the volume with the largest single contiguous extent should be selected.

PERCENT

The VARIABLE parameter specifies that the volume with the largest amount of free space should be selected.

SRM

This variable parameter specifies the z/OS System Resource Manager (SRM) should select the volume

This option requires the least amount of processing by MainView SRM and is the recommended option when using very large pools with the DASDPOOL function.

Note: This option should not be used with the SMSSELCT function.

Default:

VOLSEL=SRM

VOLSER

The VOLSER parameter specifies the volume serial ID or accepts a special asterisk mask in which leading asterisks require the new volume name to match the existing volume name in the leading asterisk positions. For example, VOLSER=(***) will add only volumes for which the first three characters match the existing volume.

Also, for compatibility with STOP-X37 comparison, triplets can be specified with the first operand in the triplet specifying a partial volume name, the second operand specifying the offset into the volume name to start the comparison, and the third operand is the comparison operator. For example, VOLSER=((WRK,1,EQ),(PROD,1,EQ)) will allow SPACVOLA to add volumes that start with the characters WRK or PROD. The values are defined as follows:

  • EQ (=)

  • GT (>)

  • LE (<=)

  • NE (¬=)

  • LT (<)

  • GE (>=)

Allowed in:

Rule SET parameter for function SPACVOLA and in data set filtering FLST members

Syntax:

VOLSER=xxxxxx or VOLSER=(*****)

The xxxxxx variable represents the one- to six-character volume serial ID, or (*****) is from 1 to 5 asterisks.

VSAM_DEFINE

The VSAM_DEFINE parameter includes or excludes the data set based on whether it is a VSAM-defined data set.

Allowed in:

INC/EXC for function SPACAQTY

Syntax:

VSAM_DEFINE=Y | N | YES | NO

VSAMCOMP

The VSAMCOMP parameter contains the VSAM data set component type (DATA or INDEX).

Allowed in:

INC/EXC

Syntax:

VSAMCOMP=xxxxx

The values are defined as follows:

  • DATA (Data component of data set)

  • INDEX (Index component of data set)

VSAMDEF

The VSAMDEF parameter contains the VSAM data set cluster definition (DATA or INDEX).

Allowed in:

INC/EXC

Syntax:

VSAMDEF=xxxxxxx

The values are defined as follows:

  • CLUSTER – The data or index component of a base cluster

  • AIX – The data or index component of an alternate index that is not part of an upgrade set

  • UPGRADE – The data or index component of an alternate index that is part of an upgrade set

VSAMSEP

The VSAMSEP parameter contains an indicator of whether data and index components are on separate volumes.

Allowed in:

INC/EXC

Syntax:

VSAMSEP=YES | NO | Y | N

VSNVS

The VSNVS parameter specifies whether the data set category is VSAM or non-VSAM.

Allowed in:

FLST INC/EXC statements in data set filtering FLST members for:

The values are as follows:

  • HSMBKDS (Backup data set view)

  • HSMBKVR (Backup DSN version)

  • HSMMGDS (Migrated data set view)

Syntax:

VSNVS=V | N

The values are defined as follows:

  • N (non-VSAM)

  • V (VSAM)

VTS_LIBNAME

The VTS_LIBNAME parameter specifies or contains the name of a Virtual Tape Library. MainView SRM name masking can be used for filter list entries.

Allowed in:

data set filtering FLST members

Syntax:

VTS_LIBNAME=xxxxxxxx

The xxxxxx variable represents a valid one- to eight-character Virtual Tape Library name.

WINDOW_DAYS

The WINDOW_DAYS parameter specifies the days of the week on which the solution is allowed to run. For any day that is defined to run the solution, the time of day must also fall within the WINDOW_STRT and WINDOW_END range. If a solution is requested at a time of day that falls outside of the WINDOW_STRT and WINDOW_END range, the request is ignored. For more information, see the MainView SRM Automation User Guide.

Allowed in:

Rule SET parameter for AUTOAPPL, AUTODS, AUTOHMSG, AUTOPOOL, and AUTOVOL.

Syntax:

WINDOW_DAYS=xxxxxxx

The variable represents as a seven-character positional parameter with each character representing a day of the week. The first character represents Sunday and the last character represents Saturday. Each character can be either a Y (active) or an N (inactive) and specifies whether the solution is active on that day. For example, a value of NYYYYYN indicates the solution should run Monday through Friday only.

All seven positions must be specified. All positions must be either a Y or an N. If not specified, the days window is not checked, which would be the same as if WINDOW_DAYS=YYYYYYY was coded.

Default:

WINDOW_DAYS=YYYYYYY, which means that the solution can run any day of the week

WINDOW_END

The WINDOW_END parameter indicates an end time of day prior to which the solution is allowed to run. The time between the WINDOW_STRT and WINDOW_END specifications indicate when the solution is allowed to run. The solution is disabled outside of the time window. A value of 0000 indicates midnight. A value of 2400 is treated as 0000. If the WINDOW_STRT and WINDOW_END values are the same, the solution can run 24 hours a day. For more information, see the MainView SRM Automation User Guide.

Allowed in:

Rule SET parameter for AUTOAPPL, AUTODS, AUTOHMSG, AUTOPOOL, and AUTOVOL.

Syntax:

WINDOW_END=hhmm

The values are defined as follows:

  • The hh variable represents hours from 00 through 24.

  • The mm variable represents minutes from 00 through 59.

Default:

WINDOW_END=0000

WINDOW_STRT

The WINDOW_STRT parameter indicates a start time of day when the solution is allowed to run. The time between the WINDOW_STRT and WINDOW_END specifications indicate when the solution is allowed to run. The solution is disabled outside the time window. A value of 0000 indicates midnight, as does a value of 2400. If the WINDOW_STRT and WINDOW_END times specify the same resulting value, the solution is always active and the times have no impact. For more information, see the MainView SRM Automation User Guide.

Allowed in:

Rule SET parameter for AUTOAPPL, AUTODS, AUTOHMSG, AUTOPOOL, and AUTOVOL.

Syntax:

WINDOW_STRT=hhmm

The values are defined as follows:

  • The hh variable represents hours from 00 through 24.

  • The mm variable represents minutes from 00 through 59.

Default:

WINDOW_STRT=0000

XMODE

The XMODE parameter contains the execution mode of a job.

Allowed in:

INC/EXC

Syntax:

XMODE=xxx

The values are defined as follows:

  • STC (Started task)

  • TSO (TSO session)

  • JOB (Batch job)



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

Comments