Filter and rule list parameter explanations

This topic provides detailed explanations for filters and rule list parameters.


ParameterExplanation
AA_AMODE

The AA_AMODE parameter specifies the application mode.

Allowed inINC/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 inINC/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 inINC/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 inINC/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 inINC/EXC in the AUTOAPPL function
SyntaxAA_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 inINC/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 inINC/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 inINC/EXC in the AUTOAPPL function
SyntaxAA_KHSM=YES | NO | Y | N
AA_KTEMP

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

Allowed inINC/EXC in the AUTOAPPL function
SyntaxAA_KTEMP=YES | NO | Y | N
AA_KVSAM

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

Allowed inINC/EXC in the AUTOAPPL function
SyntaxAA_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 inINC/EXC in the AUTOAPPL function
SyntaxAA_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 inINC/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 inINC/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 inINC/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 inINC/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 inINC/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 inINC/EXC in the AUTOAPPL function
SyntaxAA_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 inINC/EXC in the AUTOAPPL function
SyntaxAA_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 inINC/EXC in the AUTOAPPL function
SyntaxAA_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 inINC/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 inINC/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.

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. BMC AMI Storagedoes 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 BMC AMI StorageStarted 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 BMC AMI Ops Automation 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.

DefaultACT_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

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 inINC/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.

(BMC.AMISTG.SPE2201) Open link

AD_COMPP

The AD_COMPP parameter selects compressed data sets that are the specified percentage of their original size. This is only available if catalog information is included in data collection.

Example: AD_COMPP=30 will display data sets compressed to 30% of their original size.

Allowed inINC/EXC in the SMFW21xx member and the AUTODS function
Syntax

AD_COMPP=nnn

The nnn variable represents a number from 0 to 999. 

Default

None

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

Note

Including catalog information requires use of MRG_CATINFO=A in VSCAN processing, CATI=A in the AUTODS command, and always use catalog in Policy definitions.

ExampleAD_COMPP=30 will display data sets compressed to 30% of their original size.
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

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

Allowed inINC/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

The AD_DIRBF parameter specifies the number of free PDS directory blocks

Allowed inINC/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_DIRBU

(PTF BPG7923 applied)

The AD_DIRBU parameter specifies the percentage PDS directory blocks used in tenths of a percent. 

Allowed inINC/EXC in the SMFW21xx member and the AUTODS function 
Syntax

AD_DIRBU op nnnn

The nnnn variable is any number from 0 through 1000 and represents 0.0 to 100.0 percent.

The op variable represents all supported operators.

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

In the following example, the PDS data sets with fewer than or equal to 15.6% directory blocks are used.

AD_DIRBU<=156

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)

(BMC.AMISTG.SPE2201) Open link

AD_ENCRIND

The AD_ENCRIND parameter filters on data sets by their encryption status.

Allowed inINC/EXC in the SMFW21xx member and the AUTODS function
Syntax

AD_ENCRIND=YES|NO|Y|N

Default

None

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

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.

(BMC.AMISTG.SPE2201) Open link

AD_IAMIND

The AD_IAMIND parameter filters on data sets that are defined as IAM (Innovation Access Method). This is only available if catalog information is included in data collection. 

Allowed inINC/EXC in the SMFW21xx member and the AUTODS function
Syntax

AD_IAMIND=YES|NO|Y|N

Default:

None

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

Note

Including catalog information requires use of MRG_CATINFO=A in VSCAN processing, CATI=A in the AUTODS command, and always use catalog in Policy definitions.

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

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

Allowed inINC/EXC in the AUTODS function
SyntaxAD_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

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 inINC/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 BMC AMI Storagecalendar 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 BMC AMI StoragePool 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 BMC AMI StoragePool 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)

  • JCL (Indicates that SPACSQTY should allocate using the requested type specified in the JCL. Example If space=(CYL,(554,554)) is coded in the JCL then "CYL" will be used to allocate the data set.)
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'.

DefaultIf 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. BMC AMI Storagename 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.

DefaultAVL=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 BMC AMI Storagefunction 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 BMC AMI Storage 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 BMC AMI Storagepool. 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 BMC AMI Storage 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. BMC AMI Storagename 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

DefaultCRITEMC=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. BMC AMI Storagename 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. BMC AMI Storagename 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.

DefaultDEFUNIT=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. BMC AMI Storagename 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. BMC AMI Storage 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. BMC AMI Storage 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. BMC AMI Storagemasking 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. BMC AMI Storage 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 BMC AMI Storagecalendar 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). BMC AMI Storage 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. 

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

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

The PCTIACT parameter specifies when the secondary-extent percentage increase is activated.

Allowed inRule 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

The PCTICALC parameter specifies how many times to apply the calculated percentage increase to the secondary extent before becoming constant.

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

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

RELSPACE

The RELSPACE parameter specifies whether the dataset is flagged for release of unused space.

Allowed inRule SET parameter for function SPACSECI 
Syntax

RELSPACE=YES | NO

  • If Y, flags the data set for release of unused dataspace by adding the RLSE to space parameter on DD statement if not coded
  • If N, does not flag the data set for release of unused space.
    Release of unused space occurs at the close of data set. 

Important

SVM3327I is given only for PDSE data sets when RELSPACE is set to YES.

Example:

SVM3327I   Job name, Step name, DD name, Dataset name 
         RLSE ASSIGNED AS REQUIRED BY SPACSECI RELSPACE PARAMETER

DefaultRELSPACE=YES
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 BMC AMI Storage 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 BMC AMI Storage 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 BMC AMI Storage 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 BMC AMI Storage 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

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 inRule SET parameter for function DASDPOOL
SyntaxSMSNVOL=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.

ExampleSORT=(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 functions SPACSQTY, SPACAQTY, SPACSECI, and SPACVOLA  

Syntax

SQTY=nnnnnK|B|G|T

The nnnnn variable represents a number from 0 to 99999.

SQTYPCT

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

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

UPDTINDEX

The UPDTINDEX parameter picks the space allocation of the VSAM INDEX file from Rule list of SPACSQTY. The default value for UPDTINDEX is NO, so it takes the space allocation from DEFINE INDEX mentioned in the JCL.

When the UPDTINDEX value is changed to Y with the global parameter VINDEX set to Y in SMMSYSXX, the allocation space for the VSAM INDEX file is taken from the Rule list parameters PQTY and SQTY with unit mentioned in ALCTYPE.

Allowed inRule SET parameter for function SPACSQTY
Syntax

UPDTINDEX=Y | N | YES | NO   

Allowed in Rule SET parameter for function SPACSQTY

Important

In SMMSYSXX, set the global parameter VINDEX=Y.

DefaultUPDTINDEX=NO
Example

SPACSQTY FLST:
SET MODE=ACT MSG=I SMG=I
INC JOB = BOLLSK/
JCL: 
DEFINE    CLUSTER(                           
          NAME(BOLLSK.Z241297.VSAM01)        
          KEYS(11 00)                        
          RECSZ(170 170)                     
          SHAREOPTIONS(4,4)                  
          VOLUMES(SRMMM1)                    
          INDEXED)                           
 INDEX(   NAME(BOLLSK.Z241297.VSAM01.INDEX)  
          VOLUMES(SRMMM1)                    
          CYL(010 002))                      
 DATA(    NAME(BOLLSK.Z241297.VSAM01.DATA)   
          VOLUMES(SRMMM1)                    
          FREESPACE(45 45)                   
          CYL(15 003))              

Case 1
SPACSQTY RLST:
SET PQTY=3 SQTY=2 ALCTYPE=CYL REPLACE=YES 
INC JOB=BOLLSK/ DSN=BOLLSK.Z241297/
SMMSYSXX: 
By default, the global parameter VINDEX=NO.

In this case, the VSAM DATA file is allocated with Primary = 3 CYL and Secondary = 2 CYL, as mentioned in the RLST of SPACSQTY. But, the VSAM INDEX file is allocated with Primary=10 CYL and Secondary=2 CYL as mentioned in the JCL.

Case 2 
SPACSQTY RLST:
SET PQTY=3 SQTY=2 ALCTYPE=CYL REPLACE=YES UPDTINDEX=YES
INC JOB=BOLLSK/ DSN=BOLLSK.Z241297/
SMMSYSXX: 
Set global parameter VINDEX=Y.
In this case, the VSAM DATA and INDEX files are allocated with Primary = 3 CYL and Secondary = 2 CYL as mentioned in the  RLST of SPACSQTY.      

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

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 BMC AMI Storage 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
  • For DASDPOOL, default is VOLSEL=SRM
  • For SMSSELCT, default is VOLSEL=SRM

    Important

    Using the default VOLSEL=SRM disables SMSSELCT. To avoid this, you must code VOLSEL in SMSSELCT using a value other than SRM.

    When VOLSEL=SRM, the SVM3460I message is not displayed.

  • For FDRASIST, default is VOLSEL=BESTFIT
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. BMC AMI Storagename 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. 

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. 

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. 

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