The following table shows the FMS Select Criteria field name, listed alphabetically.
Allocated in blocks
Allocated in cylinders
Primary allocation amount
Allocated In tracks
Backup/archive date
Backup/archive time
Type of DSNINDEX record
Creation date in the format-1 DSCB prior to archival
Data class name <character format>
ARCHIVE KEY
Data set organization
Expiration date in the format-1 DSCB prior to archival
Jobname in the format-1 DSCB prior to archival
Kilobytes allocated to data set
Management class name <character format>
Last modification date in format-1 DSCB prior to archival
Recover partially backed up PO data sets
Recataloged to CA Disk Pseudo volume
Restore date in DSNINDEX record
Restore time in DSNINDEX record
Storage class name <character format>
Storage group name <character format>
Today's date
Last use date in format-1 DSCB prior to archival
User field information in DSNINDEX record
Version number of the DSNINDEX record
Version number of Archive DSNINDEX record
Version number of Backup DSNINDEX record
The following describes each field name in detail.
This criterion allows for the selection of DSNINDEX records that were allocated in blocks at the time the data set was backed up or archived. For VSAM, this selection criteria test is based on the data component information. For detail information about when this condition is true, see the section ALLOBLKS – Allocated in blocks (yes/no) in the chapter "Basic System – DMS PROC."
For example, to select only those DSNINDEX records that were allocated in blocks at backup time:
CRI=(ALLOBLKS,EQ,YES)
This criterion allows for the selection of DSNINDEX records that were allocated in cylinders at the time the data set was backed up or archived. For VSAM, this selection criteria test is based on the data component information.
For detail information about when this condition is true, see the section ALLOCYLS – Allocated in cylinders (yes/no) in the chapter "Basic System – DMS PROC." For example, to select only those DSNINDEX records that were allocated in cylinders at backup time:
CRI=(ALLOCYLS,EQ,YES)
The value of ALLOPRI is set to the first extent as specified in the DSNINDEX record. Since the actual primary request value is not recorded in the VTOC, the size of the first extent is displayed. The first extent size is calculated from information in the format-1 DSCB. Unless the data set is very large, or the free space on a volume is badly fragmented, the first extent will accurately reflect the primary space. The value must be specified as a numeric value.
For more information, see the sysparm description for ALLOCPRIy in the Systems Guide.
For example, to select only those DSNINDEX records that have a primary extent smaller the 15 tracks:
CRI=(ALLOPRI,LT,15,AND,ALLOTRKS,EQ,YES)
Note: If sysparm PRIALLOC is left at its default value, Recover processing will consolidate the original extents during allocation. This can increase the number of data sets selected using ALLOPRI. For more information, see the sysparm description for PRIALLOCn in the Systems Guide.
This criterion allows for the selection of DSNINDEX records that were allocated in tracks at the time the data set was backed up or archived. For VSAM, this selection criteria test is based on the data component information.
For detail information about when this condition is true, see the section ALLOTRKS – Allocated in tracks (yes/no) in the chapter "Basic System – DMS PROC." For example, to select only those DSNINDEX records that were allocated in tracks at backup time:
CRI=(ALLOTRKS,EQ,YES)
This criterion allows for the selection of DSNINDEX records based upon their Written Date stamps. This parameter is functionally equivalent to the DATE= and EDATE= parameters used by the RECOVER PROC. Any valid CA Disk date format is supported, including TODAY. For more information, see ARCTIME.
Note: For a list of valid dates, see the section Date Formats in the chapter "General Information."
For example, to select only those DSNINDEX records that were written in the last 7 days:
CRI=(ARCDT,GE,TODAY-7)
This criterion allows for the selection of DSNINDEX records based upon their Written Time stamps. This parameter is functionally equivalent to the TIME= and ETIME= parameters used by the RECOVER PROC.
For example, to select DSNINDEX records that were written on January 22, 1996 between the hours of 11AM and 11PM:
CRI=(ARCDT,EQ,96022,AND,ARCTIME,GT,1100,AND,ARCTIME,LT,2300)
This criterion allows for the selection of DSNINDEX records based upon whether they are an archive or backup copy of the data set. Valid operands are: BACKUP or ARCHIVE.
For example, to select only those DSNINDEX records that were created as a result of executing the BACKUP command:
CRI=(ARCTYPE,EQ,BACKUP)
Important! Using this example without any other criteria parameters can potentially down-level a data set. This will happen if version zero of the DSNINDEX record being recovered was created by the ARCHIVE command.
For more information, see VERSION.
This criterion allows for the selection of DSNINDEX records based upon the Format-1 DSCB creation date of the data set prior to being archived. Any valid CA Disk date format is supported, including TODAY.
Note: For a list of valid dates, see the section Date Formats in the chapter "General Information."
For example, to select only those DSNINDEX records of data sets created in the last three months:
CRI=(CREDT,GT,TODAY-90)
This criterion allows for the selection of DSNINDEX records based upon the DFSMS Data Class name of the data set.
For example, to select only those DSNINDEX records of data sets that were assigned to the STANDARD Data Class:
CRI=(DCNAME,EQ,<STANDARD>)
For example, to select those DSNINDEX records that have DISK12 as their ARCHIVE KEY:
This criterion allows for the selection of DSNINDEX records based upon their ARCHIVE KEY. This value must be enclosed in < >, and can represent a tape, cartridge, or disk archive. For an example of an ARCHIVE KEY, see the section LISTV Sample Report in the chapter "FILES Maintenance."
CRI=(DSNKEY,EQ,<DISK12>)
This criterion allows for the selection of DSNINDEX records based upon the value in its DSORG field. For a list of valid values see the section DSORG – Data Set Organization in the chapter "Basic System – DMS PROC."
For example, to select only those DSNINDEX records that have AM in their DSORG field:
CRI=(DSORG,EQ,AM)
Note: This example is functionally equivalent to specifying VSAMONLY from the RECOVER PROC.
This criterion allows for the selection of DSNINDEX records based upon the Format-1 DSCB expiration date of the data set prior to being archived. Any valid CA Disk date format is supported, including TODAY.
Note: For a list of valid dates, see the section Date Formats in the chapter "General Information."
For example, to exclude only those DSNINDEX records that contain data sets which have Format-1 DSCB expiration dates between January 1 and July 1, 1996:
CRI=(EXPDT,GT,1/1/96,AND,EXPDT,LT,7/1/96)
This criterion allows for the selection of DSNINDEX records based on the name of the job in the Format-1 DSCB of the data set prior to being archived. Depending of the OPEN SVC option chosen, this would either be the creating, modifying, or last using JOBNAME, or an account number. For information on OPEN SVC options, see The CA Disk SVC in the Installation Guide.
For example, to select only those DSNINDEX records that contain SB15BKUP in their JOBNAME field:
CRI=(JOBNAME,EQ,<SB15BKUP>)
This criterion allows for the selection of DSNINDEX records that contained nnnnn kilobytes at the time the data set was backed up or archived.
For example, to select only those DSNINDEX records that contain data sets that were larger than 50000 kilobytes at backup time:
CRI=(KBYTES,GT,50000)
This criterion allows for the selection of DSNINDEX records based upon the DFSMS Management Class name of the data set.
For example, to select only those DSNINDEX records of data sets that were assigned to the GDGS Management Class:
CRI=(MCNAME,EQ,<GDGS>)
This criterion allows for the selection of DSNINDEX records based upon the Format-1 DSCB last modification date of the data set prior to being archived. Any valid CA Disk date format is supported, including TODAY.
Note: For a list of valid dates, see the section Date Formats in the chapter "General Information."
For example, to select only those DSNINDEX records that contain data sets last modified on can 2, 1993:
CRI=(MODDT,EQ,1993123)
Default processing excludes partially backed up PO data sets from being selected for recovery. Instead, FMS selects the latest non-partially backed up PO. The objective of this criterion is to recover partially backed up PO's.
For example, to include partially backed up PO's during recover, add the following criteria statement to your command stream:
CRI=(PARTBKUP,EQ,YES)
This criterion allows for the selection of DSNINDEX records based on whether the data set was recataloged to the pseudo-volume at archive time. Valid values are: YES or NO.
For example, to select only those DSNINDEX records that contain data sets cataloged to ARCIVE:
CRI=(RECAT,EQ,YES)
This criterion allows for the selection of DSNINDEX records based upon the Last Restore Date of the DSNINDEX record. It will only contain a valid date if sysparm SMSUPDAT (described in SMSUPDATy in the Systems Guide) is at the default value of 'Y'. This criterion can be used to restart a failed RECOVER job by placing it on an EXCLUDE statement in conjunction with the VERSION criteria. Any valid CA Disk date format is supported, including TODAY.
Note: For a list of valid dates, see the section Date Formats in the chapter "General Information." For other related information, see VERSION.
For example, the typical method of restarting a RECOVER that failed:
EXCLUDE CRI=(RESDT,EQ,TODAY,OR,VERSION,NE,0)
Important! Be aware that VERSION should always be used in conjunction with RESDT. This is because ALL versions (even back level copies) are candidates to FMS unless specifically excluded or disallowed by selection criteria.
This criterion allows for the selection of DSNINDEX records based upon the Last Restore Time of the DSNINDEX record. It will only contain a valid time if sysparm SMSUPDAT (described in SMSUPDATy in the Systems Guide) is set to Y.
Note: For more information, see VERSION.
For example, to select only those DSNINDEX records that were restored yesterday between 8AM and 5PM:
CRI=(RESTIME,GT,0800,AND,RESTIME,LT,1700,AND,RESDT,EQ,TODAY-1)
This criterion allows for the selection of DSNINDEX records based upon the DFSMS Storage Class name of the data set.
For example, to select only those DSNINDEX records of data sets that were assigned to the EXTRA Storage
Class:
CRI=(SCNAME,EQ,<EXTRA>)
This criterion allows for the selection of DSNINDEX records based upon the DFSMS Storage Group name of the data set.
For example, to select only those DSNINDEX records of data sets that were assigned to the PLENTY Storage Group:
CRI=(SGNAME,EQ,<PLENTY>)
This value is derived from the system clock. Comparison dates used in conjunction with this criterion can be entered in any acceptable CA Disk format.
Note: For a list of valid dates, see the section Date Formats in the chapter "General Information."
This criterion allows for the selection of DSNINDEX records based upon the Format-1 DSCB last use date of the data set prior to being archived. Any valid CA Disk date format is supported, including TODAY.
Note: For a list of valid dates, see see the section Date Formats in the chapter "General Information."
For example, to select only those DSNINDEX records that contain data sets which were last used on November 1, 1994:
CRI=(USEDT,EQ,11/01/94)
If you want to select or exclude entries with zero or invalid USEDTs, use 0, 'zero', or 2155.366 as the comparison value.
CRI=(USEDT,EQ,0)
This criterion allows for the selection of DSNINDEX records based upon the information contained within the 25 byte user field. The comparison is made against the left justified field, and blanks and non-printable Hex characters are not allowed. For more information, see Subfile Record Format — (DSNINDEX) and User Exit DINXUFEX — Update DSNINDEX User Field in the Systems Guide.
For example, to select only those DSNINDEX records that contain Acct#18753 in the User Field:
CRI=(USERFLD,EQ,<Acct#18753>)
This criterion allows for the selection of DSNINDEX records based upon the relative version number of the data set. Both archive and backup copies are considered when calculating the version number, and it can be used to restart a failed RECOVER job. For details and an example, see RESDT. Valid values are: Negative numeric or zero—the most current version.
For example, to select the latest backup of a data set that has not been archived:
CRI=(VERSION,EQ,0,AND,ARCTYPE,EQ,BACKUP)
Or, in a recover restart situation, consider the following statement:
EXCLUDE CRI=(RESDT,EQ,TODAY,AND,VERSION,NE,0)
Note: In the second example, there are two important items to point out: First, the value of RESDT is very important, especially if the recover began before midnight, and abended after midnight. If this is the case, the appropriate date would be GE,TODAY-1. Second, if VERSION was not specified as shown, there is a possibility of down-leveling a data set by mistake by selecting a non-zero version of the DSNINDEX record.
This criterion allows for the selection of DSNINDEX records based upon the relative version number of the data set. Only archive copies are considered when calculating the version number.
Important! Since this criterion automatically excludes backup versions, you can potentially down-level a data set that has a more current backup version in the archives.
Valid values are: Negative numeric or zero—the most current version.
For example, to select the -1 version of an archived copy, ignoring all backup copies, even a more current one:
CRI=(VERSIONARC,EQ,-1)
This criterion allows for the selection of DSNINDEX records based upon the version number of the data set. Only backup copies are considered when calculating the version number.
Important! Because this criterion automatically excludes archive versions, you can potentially down-level a data set that has a more current archive version in the archives.
Valid values are: Negative numeric or zero—the most current version.
For example, to select the third oldest backup version, ignoring all archive copies, even a more current one:
CRI=(VERSIOBKP,EQ,-2)
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|