AUTODS filter list parameters
Data set attributes can be monitored as criteria to include or exclude the data set from the solution. The following table describes the filter list parameters for the AUTODS function. For a complete description of each parameter, see Reference for BMC AMI Storage products.
INC and EXC parameters for AUTODS
Parameter | Definition |
---|---|
AD_ALVL1=applicationLevel1 | Specifies the first 50 characters of the application name (Application Level 1) |
AD_ALVL2=applicationLevel2 | Specifies the first 50 characters of the application name (Application Level 2) |
AD_ALVL3=applicationLevel3 | Specifies the first 50 characters of the application name (Application Level 3) |
AD_ALVL4=applicationLevel4 | Specifies the first 50 characters of the application name (Application Level 4) |
AD_BASE=clusterName | 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. |
AD_BKUPCATS=YES|NO | Indicates if one or more backup versions exist for a data set that was cataloged at the time of backup. |
AD_BKUPDATE =yyyy/mm/dd | Contains the most recent backup date for the data set. |
AD_BKUPDAYS=nnnnn | Contains the number of days since the last backup was performed on the data set. |
AD_BKUPSIZE=nnnn | Contains the backup space usage for the data set (in bytes). The space usage does not include retained backup versions. |
AD_BKUPTOTS=nnnn | Contains the number of backup versions that exist for the data set. The count does not include retained backup versions. |
AD_BKUPUNCS=Y|N | Indicates if one or more backup versions exist for a data set that was uncataloged at the time of backup. |
AD_BKUPWDAY=nnnnn | Contains the number of work days since the last backup was performed on the data set. |
AD_BLKEF=nnn | Specifies the percentage of blocking efficiency (0-100) |
AD_BLKEFT>nnnn | Specifies the blocking efficiency of the data set in tenths of a percent (0-1000) |
AD_BLKSZ=physicalBlocksize | Specifies physical block size or VSAM control interval size for the data set (0-32760). 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. |
AD_BLKTR=numBlocks | Specifies the number of physical blocks that will fit on one track (0-2147483647). The value relates to the Percent Efficiency value. |
AD_CASPL=numVSAM | Specifies the number of VSAM control area splits performed on the data set (0-2147483647). This number is for the entire VSAM data set if it spans multiple volumes. Non-VSAM data sets will show NA in this field. |
AD_CAT=x | Specifies the data set's catalog status. Indicators are:
|
AD_CDATE=yyyy/mm/dd | Specifies the 10-character creation date of the data set in yyyy/mm/dd format |
AD_CDAYS=nnnnn | Specifies the number of days since the data set was created (0-99999) |
AD_CHG=Y | N | Specifies an indicator of whether the data set has been opened for output (changed) |
AD_CISPL=numSplits | Specifies the number of VSAM control interval splits performed on the data set (0-2147483647). This number is for the entire VSAM data set if it spans multiple volumes. Non-VSAM data sets will show NA in this field. |
AD_COMPR=YES|NO|Y|N | Indicates if the data set is compressed |
AD_DAYS=numDays | Specifies the number of days since the data set was opened (0-2147483647). This number is calculated by subtracting the last reference date from the current date. If the data set was never opened, this field will contain zero. |
AD_DCLAS=dataClass | Specifies the SMS-assigned data class or one of the following values for the data set:
|
AD_DCVALID=Y | N | Indicates whether the data class to which the data set is assigned. 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. |
AD_DIRBA>nnnnnnn | Specifies the number of allocated PDS data set directory blocks (1 – 16777215) Important Including this parameter might cause significant overhead to the AUTODS function and to the data set collection policies that utilize automation using solutions that include this parameter. This parameter is equivalent to setting the PDS_DIR = y parameter in a VSCAN. For more information, see SMVSCFxx filter keywords. |
AD_DIRBF>nnnnnnn | Specifies the number of free PDS data set directory blocks (0 – 16777215) Important Including this parameter might cause significant overhead to the AUTODS function and to the data set collection policies that utilize automation using solutions that include this parameter. This parameter is equivalent to setting the PDS_DIR=Y parameter in a VSCAN. For more information, see SMVSCFxx filter keywords. |
AD_DIRBU=nnnn | Specifies the PDS directory blocks used in tenths of a percentage (0 -1000) For more information, see Filter and rule list parameter explanations. |
AD_DOCC=nnn | Specifies the device occupancy percentage (0-100) |
AD_DOCCT>nnnn | Specifies the device occupancy percentage in tenths of a percent (0-1000) |
AD_DSN=dsName | Specifies the data set name (1-44 characters) |
AD_DSORG=xxxx | Specifies the data set file organization and access method used to manage the data set. The indicators and their meanings are:
|
AD_DSTYP=xxxx | Specifies the data set type. Values are as follows:
|
AD_EXTS=numExtents | Specifies the number of extents occupied by the data set on the volume (0-2147483647) |
AD_EXTSB>nnnnnnnnnn | Specifies the number of extents occupied by the data set on a non-EAV volume or in the BAS area of an EAV volume |
AD_EXTSE>nnnnnnnnnn | Specifies the number of extents occupied by the data set in the EAS area of an EAV volume |
AD_GROUP=groupName | SMS storage group name displayed if the AUTODS function is associated with an AUTOPOOL GROUP function (1-30 characters) |
AD_LDATE=yyyy/mm/dd | Specifies the last date the data set was opened in yyyy/mm/dd format. If the data set was never opened, this field will contain blanks. |
AD_LRECL=maxRecordLength | Specifies the maximum record length for the data set (0-99999). For VSAM data sets, the record length is obtained from the catalog. |
AD_MCLAS=mgmtClass | Specifies the SMS-assigned management class or one of the following values:
|
AD_MCVALID=Y | N | 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. |
AD_MNTTYPE=mountType | Indicates the mount type of the volume on which the data set exists. This field can contain one of the following values:
|
AD_MULTD=YES | NO | Y | N | 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). |
AD_POOL=poolName | Specifies the pool name that is associated with the data set. The pool name 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; otherwise, 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 (1-8 characters). |
AD_POOLT=S | P | Specifies the pool type, S (for subpool) or P (for user pool) |
AD_PUSED=nnn | Specifies the percentage of allocation that is used (0-100) |
AD_PUSEDT>nnnn | Specifies the percentage in tenths of allocated space to used space in the data set (0-1000) |
AD_REBLK=Y | N | Specifies 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 indicator is also known as System Determined Blocksize and typically allocates a blocksize 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. |
AD_RECFM=recordFormat | Specifies the data set record format. The record format indicates the type of record access along with the general format of the records and blocks. Indicator meanings are: Non-VSAM data sets:
VSAM data sets:
|
AD_SCLAS=storageClass | Specifies the SMS-assigned storage class or one of the following values:
|
AD_SCVALID=Y | N | 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. |
AD_SIZE=dsSize | Specifies the data set size in kilobytes (one kilobyte equals 1024 bytes) on the volume (0-2147483647) |
AD_SIZEB>nnnnnnnnnn | Specifies the amount of data set space that is allocated on a non-EAV volume or in the BAS area of an EAV volume in kilobytes (one kilobyte equals 1024 bytes) |
AD_SIZEE>nnnnnnnnnn | 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) |
AD_SMSI=xx | Specifies the SMS status of the volume. Values are:
|
AD_STORGRP=xxxxxxxx | SMS storage group name displayed if the AUTODS function is associated with an AUTOPOOL GROUP function (1-8 characters) |
AD_STRPC=nnnnn | Specifies the number of data set stripes (0-217483647) |
AD_TRKSA=nnnnnnnnnn | Specifies the number of tracks allocated (0-2147483647) |
AD_TRKSAB>nnnnnnnnnn | Specifies the number of tracks allocated on a non-EAV volume or in the BAS area of an EAV volume |
AD_TRKSAE>nnnnnnnnnn | Specifies the number of tracks allocated in the EAS area of an EAV volume |
AD_TRKSF=nnnnnnnnnn | Specifies the number of tracks unused by the data set on the volume (0-2147483647). 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. |
AD_TRKSFB>nnnnnnnnnn | 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. |
AD_TRKSFE>nnnnnnnnnn | 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. |
AD_TRKSU=nnnnnnnnnn | Specifies the number of tracks used by the data set on the volume (0-2147483647). 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. |
AD_TRKSUB>nnnnnnnnnn | Specifies the number of tracks used by the data set on a non-EAV volume or in the BAS area of an EAV volume |
AD_TRKSUE>nnnnnnnnnn | Specifies the number of tracks used by the data set in the EAS area of an EAV volume |
AD_VOL=xxxxxx | Specifies the volume number (1-6 characters) |
AD_VOLSQ=sequenceNumber | Indicates the sequence number of the data set. This field always contains a 1 when the data set is not a multivolume data set. When the data set is multivolume, you can use this field to inspect the various pieces of the data set, because the AUTODS record exists for each piece of the data set on each volume. For multivolume data sets, an additional AUTODS record with an AD_VOLSQ value of 0 is created to represent the accumulation of all of the distinct pieces of the data set. You can use this sequence-zero data set record to create automation on the total percentage used or on the total of any other field. Important Unpredictable results can occur if the same data set name is used on multiple cataloged data sets, where the data sets reside on different volumes and are in different catalogs. This same situation can also arise if the VTOC Scan master collection data set is shared between systems with different catalogs. In these situations the sequence-zero data set might not represent the correct totals for the data set. |
AD_VSAMCOMP=I | D | indicates whether the data set is the data or index component of a VSAM cluster |
AD_VSNVS=N | V | Specifies the data set category:
|
AD_WDAYS=workingDays | Specifies the number of working days (0-2147483647) since the data set was last referenced. Working days are defined in the BMC AMI Storage calendar member SMSCALSxx. If SMSCALSxx is not used or function HSMMCCNV is not active, these days are not adjusted and this keyword value will be equal to AD_DAYS keyword value. This number is calculated by subtracting the last reference date from the current date and adjusting the number according to the SMSCALSxx calendar. |
AD_WCDAY=nnnnn | Specifies the number of working days since the data set was created (0-99999) |
AD_XDATE=xxxxxxxxxx | Specifies the expiration date for the data set in yyyy/mm/dd format |
AD_XTFMT=YES|NO|Y|N | Indicates whether the data set is in extended format |
AD_XTNDA=YES|NO|Y|N | Indicates if the data set is extended addressability |
AUTOLEV=xxxxxxxx | Specifies an 8-character value (AUTOLEVx), where x is a number that indicates the current automation level for the resource that is being automated. AUTOLEV0 indicates that multiple levels are not being used. AUTOLEV1 indicates the first level of a multiple-level request. For multilevel automation, this specification must be used in this FLST/RLST member or must be contained within event text of any issued event and then referenced in the BMC AMI Ops Automation Rule that looks for the event. |
DSNn=xxxxxxxx | Specifies or contains a data set name qualifier You can use BMC AMI Storage name masking for filter list entries. |
LLQ=xxxxxxxx | Specifies or contains the low-level qualifier of a data set name You can use BMC AMI Storage name masking for filter list entries. |
SOLUTION=xxxxxxxx | Specifies the solution value from the originating AUTOVOL command (1-8 characters). BMC recommends that each SET statement in the AUTOVOL function include a unique solution value. You can use this solution value on the AUTOVOL console command to invoke the solution. For more information, see SOLUTION parameter. |
Comments
Log in or register to comment.