FDREPORT XSELECT and XEXCLUDE Statement

XSELECT and XEXCLUDE statement syntax

XSELECT and XEXCLUDE statements

These statements act as a filter for the data sets to be processed by FDREPORT. The XSELECT and XEXCLUDE statements use sophisticated comparisons (less than or equal, greater than, not equal, and the rest), as well as a data set name masking capability.

On the XSELECT and XEXCLUDE statements, one of a number of comparison operators may follow the operands. Since one form of those operators involve special characters (such as the not “¬” and less-than “<”), alternate forms of each operator without special characters are provided. The operators are:

The test is true if the indicated comparison of the FIELD value and the value you provide is true. For example,

If the operation is equal (= or .EQ.) or not-equal (¬=, or .NE.), several values may be provided in parentheses. For equal, the test is true if any of the comparisons are equal. For not-equal, the test is true if all of the comparisons are not equal. For example,

selects data sets whose LRECL is either 80 or 133. In addition, a given FIELD name may be specified more than once with several different operators; all of the tests must be true for the data set to be selected (unless all of the operators are equal (= or .EQ.) when it is sufficient for any one of the tests on that field to be true). For example:

selects any PS or PO data sets between 50 and 100 tracks in size.

When processing data sets from the source selected by DATATYPE= on the PRINT statement, each data set is passed through this filtering process where XEXCLUDE statements (if present) are processed first regardless of the statement order:

1. If any XEXCLUDE statements are present, the data set's FIELD values are compared to each statement. If all of the tests on a given statement are true for that data set, it is excluded from processing.
2. If any XSELECT statements are present then for any data set that was not excluded, the data set's FIELD values are compared to each of them. If all of the tests on a given statement are true for that data set, it is processed.
3. If there are no XSELECT statements present then all data sets that are not excluded are processed. If none of the above statements is present, then all data sets found on FDREPORT's input are processed.

The order of the XSELECT and XEXCLUDE statements is not significant. However, each statement operates independently. For example, if you want to select all PDSs on volumes starting with “ABC”, code:

If you code:

XSELECT DSORG=PO <--- INCORRECT XSELECT VOL=ABC*

it selects all of the data sets on volumes starting with “ABC”, not just the PDSs.

For most of the FIELD operands, the values that you specify are obvious. For example, LRECL= takes numeric values specifying logical record lengths. For some FIELD values the rules are not so obvious:

• For fields that represent dates, such as ADATE, EXPDATE, and LRDATE, the value must be specified as a Julian date, that is, year plus day number.
  • For years in the 19xx range you can specify a 2-digit year, for example, ADATE=95123.
  • For any year you can specify a 4-digit year, for example, EXPDATE=2020123 (required for years beyond 1999).
  • To improve readability, you can insert a period between the year and day, for example, BKDATE=95.321.
  • The date fields do not accept Gregorian dates (month, day, and year), but you can request display of dates in Gregorian format with the DATEFORMAT= operand on the PRINT or DEFAULT statement.
• For fields that represent a number of bytes, such as BYTES and PRIBYTES, you may specify values in bytes (a simple number, such as BYTESFRE=5000), kilobytes (a number followed by K, such as BYTES=250K), or megabytes (a number followed by M, such as BYTESUSE=450M). See HEXBYTES for the interpretation of kilobytes and megabytes.
• For fields that represent flags or similar attributes, such as ARCFLAG1, ATTR1, DSIND, and SMSFLAGS, the values that you use on XSELECT and XEXCLUDE statement may be different from the values that are displayed in a report. The field values are often abbreviated by 1 or 2 characters in a report to save space, but on these statements you may need to put the longer description. For example, ARCFLAG2 displays a value of “A” if the data set is cataloged for auto-recall, but you would say XSELECT ARCFLAG2=(RECALL) to select on that flag. The tables in FDREPORT-Field-Names show the report values and the selection values for such fields.

XSELECT and XEXCLUDE statement operands

nnn

Specifies the ICF VSAM clusters or components selected or excluded have a percent of free control areas that is within the percentage specified. The number may be from 0 to 100 inclusive.

%CAPUSED=

nnn

Specifies the data sets selected or excluded must have a percent of the used allocation capacity within the percentage specified. The used allocation capacity is calculated by multiplying the number of tracks allocated by the track capacity in bytes. The percentage is derived by dividing the allocation capacity into the number of bytes allocated. The number may be from 0 to 100 inclusive.

nnn

Specifies the ICF VSAM clusters or components selected or excluded have a percentage of free control intervals that is within the percentage specified. The number may be from 0 to 100 inclusive.

%DIRFREE=

nnn

Specifies the data sets selected or excluded must have a percent of free (unused) directory blocks that is within the percentage specified. The number may be from 0 to 100 inclusive.

%DIRUSED=

nnn

Specifies the data sets selected or excluded must have a percent of used directory blocks that is within the percentage specified. The number may be from 0 to 100 inclusive.

%FREE=

nnn

Specifies the data sets selected or excluded must have a percent of free (unused) tracks in the allocation that is within the percentage specified. The number may be from 0 to 100 inclusive.

%OVER=

nnn

Specifies the data sets selected or excluded must be an IAM file and must have a percent of used independent OVERFLOW that is within the percentage specified. The value may be from 0 to 100 inclusive.

%USED=

nnn

Specifies the data sets selected or excluded must have a percent of used tracks in the allocation that is within the percentage specified. The number may be from 0 to 100 inclusive.

ABRCYCLE=

nn

Specifies the data sets selected or excluded must have a current ABR backup that is within the ABR cycle number supplied. The number may be from 0 to 63 inclusive.

ABRGEN=

nnnn

Specifies the data sets selected or excluded must have a current ABR backup that is within the ABR generation number supplied. The number may be from 0 to 9999 inclusive.

nnn

Specifies the data sets selected or excluded must come from a volume with a ABR high threshold within the value specified. The number may be from 0 to 100 inclusive.

ABRIND=

Specifies the data sets selected or excluded must have an ABR indicator that corresponds to the indicator supplied. Valid indicators are:

A - Always backup / never archive.

B - Current ABR backup.

N - Normal backup / never archive.

R - Archiving requested.

X - Exclude from ABR processing.

nnn

Specifies the data sets selected or excluded must come from a volume with an ABR low threshold within the value specified. The number may be from 0 to 100 inclusive.

ACTIVE=

Specifies the data sets selected or excluded have been tested with the ENQUEUE macro to determine if the data set is currently in use.

The data set is not in use.

The data set is in use.

ACTTTR=

nnnnnn

Specifies the data sets selected or excluded must reside on the block within the Archive Control File that is within the relative block number provided.

ADATE=

datespec

Specifies the data sets selected or excluded must have an archive date that is within the date specified. The date is specified as a Julian date (year plus day number) that may be in the form “yyyyddd” or “yyddd”. For readability, a period may be inserted between the year and day.

ADAYS=

nnnnn

Specifies the data sets selected or excluded must have a number of days since it was archived that is within the number of days supplied. The number may be from 0 to 32000, inclusive.

AIXNAME=

dsn

Specifies the alternate index cluster name used for selection or exclusion; following the rules for data set selection.

Specifies the IAM file or ICF VSAM clusters or components selected or excluded have an alternate index attribute with one or more of the following characteristics:

An alternate index.

The alternate index is upgraded to reflect changed data when the base cluster’s records are added to, updated, or erased.

Specifies the ICF VSAM clusters or components selected or excluded have one or more of the following attributes indicated in the AMDATTR field in the Access Method Data Statistics Block (AMDSB):

ESDS

Entry sequenced cluster.

IMBED

Sequence set placed with data component.

KEYRANGE

Key range defined component.

KSDS

Key sequenced cluster.

ORDERED

Volumes to be used in the order they are specified in the VOLUMES parameter.

REPLICATE

Each index record to be written on a track as many times as it fits.

RRDS

Relative record data set.

SPANNED

Data record can cross control interval boundary.

WRITECHECK

Perform write check during write processing.

Specifies the ICF VSAM clusters or components selected or excluded have one or more of the following attributes indicated in the AMDATTR3 field in the Access Method Data Statistics Block (AMDSB):

Cluster or component that is allocated to MSS device is staged at open and retained on staging device until closed.

Cluster or component that is allocated to MSS device is not staged at open, but data is to be staged as needed.

Linear cluster (ESDS that is processed using control intervals).

Data set is loaded.

Data set has non unique keys.

Shared basic catalog structure (sub-cell exists).

Variable RRDS.

De-staging is to complete before control is returned to the program that closes the data set.

dsn

Specifies the data sets selected or excluded must have been obtained from the Archive Control File specified when an extract file was created using RPTYPE=DATA or RPTYPE=COMPDATA and DATATYPE=ARCHIVE or DATATYPE=CATARCH.

Specifies the data sets selected or excluded must have the first archive flag byte set to the indicators supplied. The valid indicators are:

Component marked for delete because there is no corresponding cluster.

Component marked for delete because cluster is to be deleted.

External restore from archive.

Archive backup spans more than five volumes.

Internal restore from archive.

Portion of multi-volume data set archived from one volume.

Entry restored from archive or restore from archive was attempted.

Data set is restored with a Standard User Label (SUL).

Specifies the data sets selected or excluded must have the second archive flag byte set to the indicators supplied. The valid indicators are:

Default: Backup is an ABR tape, not an archive tape.

Cluster entry.

External delete from archive.

Backup data set created on DASD device (as opposed to tape device).

Backup data set is not cataloged.

Data set archived with the auto-recall option.

ARCTTR=

Specifies the data sets selected or excluded must contain the relative Archive Control File block number (with the auto recall indicator set) that matches the value provided. This value is extracted from the data set record within the Archive Control File, It is also placed in the catalog entry created when RECALL=YES is specified on the DUMP TYPE=ARC control statement and serves as a quick path into the Archive Control File for the restore server.

nnnnnn

The value specified is a decimal number.

X ‘xxxxxx’

The value specified is a hexadecimal number.

hhmmss

Specifies the data sets selected or excluded must have an archive time stamp that matches the value, range, or values supplied.

Specifies the ICF VSAM clusters or components selected or excluded have one or more of the following data set attributes found in the ATTR1 field in the VSAM data set information cell of an ICF VSAM data or index component.

Catalog eligible for Enhanced Catalog Sharing.

Erase components when cluster deleted.

component can be accessed for read only.

Data component’s control areas are preformatted.

Cluster can be re-opened as a new cluster.

Data component’s control areas are not preformatted.

Portable copy has been made.

Track overflow.

Specifies the ICF VSAM clusters or components selected or excluded have one or more of the following data set attributes found in the ATTR2 field in the VSAM data set information cell of an ICF VSAM data or index component.

Catalog busy (no access allowed).

Catalog is locked.

Component is not usable.

Internal system data set.

Any number of users for read or one user for read/write.

Any number of users for read and one user for write.

Fully shared by any number of users. Users are responsible for read/write integrity.

Fully shared by any number of users with direct access buffer refresh. Users are responsible for read/write integrity.

Cross system fully shared by any number of users. Users are responsible for read/write integrity.

Cross system fully shared by any number of users with direct access buffer refresh. Users are responsible for read/write integrity.

nnnn

Specifies the ICF VSAM alternate index clusters or components selected or excluded must have an alternate relative key position within the number specified. The number may be from 0 to 4095 inclusive.

BKCYCLE=

nn

Specifies the data sets selected or excluded must have an ABR backup tape cycle number that is within the ABR cycle number supplied. The number may be from 0 to 63 inclusive.

BKDATE=

datespec

Specifies the data sets selected or excluded must have an ABR last processed date within the date supplied. The date is specified as a Julian date that may be in the form “yyyyddd” or “yyddd”. For readability, a period may be inserted between the year and day.

BKDAYS=

nnnnn

Specifies the data sets selected or excluded must have a number of days since last processed by ABR that is within the number of days supplied. The number may be from 0 to 32000, inclusive.

BKDEVCLS=

Specifies the data sets selected or excluded must have been backed up or archived to the device class entered.

The data sets have been backed up or archived to DASD.

The data sets have been backed up or archived to tape.

BKDEVTYP=

Specifies the data sets selected or excluded must have been backup up or archived to the device type entered. Some valid backup device types are:

3380

3390

DISK - Any DASD device type.

3480

3480X

3490

3590-1

TAPE - Any tape device type.

nnn

Specifies the data sets selected or excluded must have a number of active backup files (after exclusion or selection) that satisfies the criteria specified. The value specified may be any number from 0 through 999, inclusive.

BKEXDATE=

datespec

Specifies the data sets selected or excluded must have an ABR backup tape with an expiration date that matches the date supplied.

For DATATYPE=ARCHIVE or CATARCH, this field is the expiration date of the archive backup file. For DATATYPE=VTOC or CATVTOC, ABR does not record the expiration date of the backup file and this field is not meaningful. For DATATYPE=VOLDATA, this field is the expiration date of the most current full volume backup and not necessarily the expiration date of the most current cycle. For DATATYPE=EXTRACT, the contents of this field depend on the original source. For other DATATYPE specifications, this field is not meaningful.

The date is specified as a Julian date that may be in the form “yyyyddd” or “yyddd”. For readability, a period may be inserted between the year and day.

BKEXDAYS=

nnnnn

Specifies the data sets selected or excluded must have an ABR backup tape with a number of days until expiration that is within the number of days supplied. If the ABR backup tape’s expiration date is earlier than today, then the value of BKEXDAYS is zero. If the ABR backup tape’s expiration date is 1999.000 or 199.xxx (where “xxx” is 365 or greater), then the value of BKEXDAYS is 65535.

For DATATYPE=ARCHIVE or CATARCH, this field is the number of days until expiration of the archive backup file. For DATATYPE=VTOC or CATVTOC, ABR does not record the expiration date of the backup file and this field is not meaningful. For DATATYPE=VOLDATA, this is the number of days until expiration of the most recent full volume backup and not necessarily the number of days until expiration of the most recent cycle. For DATATYPE=EXTRACT, the contents of this field depend on the original source. For other DATATYPE specifications, this field is not meaningful.

BKFILENO=

nnnnn

Specifies the data sets selected or excluded must have an ABR tape file number that is within the number specified. The number may be from 0 to 65534 inclusive.

BKGEN=

nnnn

Specifies the data sets selected or excluded must have an ABR backup tape generation number that is within the number supplied. The number may be from 1 to 9999 inclusive.

BKSUFFIX=

cccccccc

Specifies the data sets selected or excluded must have the value specified in an ABR backup tape data set name suffix.

This operand supports full masking. The string may be from 1 to 8 characters in length, including mask characters. The characteristics of the mask are defined under the VOLUME= operand.

BKTAPCNT=

nn

Specifies the data sets selected or excluded must have an ABR tape volume count that is within the number specified. The number may be from 1 to 19 inclusive.

hhmmss

Specifies the data sets selected or excluded must have an ABR backup time stamp that matches the value or range of values supplied. Currently, data sets that are archived for application backup are the only entries with a backup time stamp.

BKVOL=

vol

Specifies the data sets selected or excluded must have the ABR backup tape volume specified in the volumes required to restore.

This operand supports full masking. The string may be from 1 to 6 characters in length, including mask characters. The characteristics of the mask are defined under the VOLUME= operand.

BLKSIZE=

nnnnn

Specifies the data set selected or excluded must have a block size that is within the value specified. The number may be from 0 to 32760 inclusive.

BLKSTRK=

nnnnn

Specifies the data set selected or excluded must have a number of blocks per track that is within the value specified. The number of blocks per track is determined by the TRKCALC service routine for non-VSAM data sets based on the block size. If the block size is zero, the number of blocks per track are zero. The number of blocks per track is obtained from the VVR for ICF VSAM components. The value may be from 0 to 32000 inclusive.

BUFSIZE=

nnnnn

Specifies the ICF VSAM clusters or components selected or excluded have a minimum buffer size that is within the value specified. The value may be from 0 to 32000 inclusive.

Specifies the data sets selected or excluded have a number of bytes allocated that is within the value specified. The number of bytes allocated is equivalent to the high allocated RBA for ICF VSAM components and is a calculated value for non-VSAM data sets, based on the block size. If the block size is zero, the number of bytes allocated are zero. The value may be from 0 to 4294967294 inclusive.

nnnnnnnnnn

Specifies the exact value to be compared.

nnnnnnnK

Indicates the value should be multiplied by 1,000.

nnnnM

Indicates the value should be multiplied by 1,000,000.

BYTESFRE=

Specifies the data sets selected or excluded have a number of bytes free within the allocated space that is within the value specified. The number of bytes free within the allocated space is equivalent to the high used RBA for ICF VSAM components and is a calculated value for non-VSAM data sets, based on the block size. If the block size is zero, the number of bytes free within the allocated space are zero. The value may be from 0 to 4294967294 inclusive.

nnnnnnnnnn

Specifies the exact value to be compared.

nnnnnnnK

Indicates the value should be multiplied by 1,000.

nnnnM

Indicates the value should be multiplied by 1,000,000.

BYTESTRK=

nnnnnn

Specifies the data sets selected or excluded have a number of bytes utilized per track that is within the value specified. The number of bytes utilized per track is equivalent to the number of blocks per track multiplied by the physical block size for ICF VSAM components and the number of blocks per track multiplied by the block size for non-VSAM data sets. If the block size is zero, the number of bytes utilized per track are zero. The value may be from 0 to 999999 inclusive.

BYTESUSE=

Specifies the data sets selected or excluded have a number of bytes used within the allocated space that is within the value specified. The number of bytes used within the allocated space is equivalent to the difference between the high allocated and the high used RBA for ICF VSAM components and is a calculated value for non-VSAM data sets, based on the block size. If the block size is zero, the number of bytes free within the allocated space are zero. The value may be from 0 to 4294967294 inclusive.

nnnnnnnnnn

Specifies the exact value to be compared.

nnnnnnnK

Indicates the value should be multiplied by 1,000.

nnnnM

Indicates the value should be multiplied by 1,000,000.

CANDVOLC=

nnn

Specifies the data sets or cluster names selected or excluded must be cataloged to a number of candidate volumes that is within the value specified. The value may be from 1 to 200 inclusive. For VSAM, this field reflects the entire sphere (base cluster plus alternate indexes), not an individual component.

Candidate volumes are volumes that were requested when a VSAM cluster or SMS-managed non-VSAM data set was created, but that have not yet been used for data. For non SMS-managed VSAM clusters, candidate volumes are actual volumes on which no space has been allocated yet for the cluster. For SMS-managed data sets (VSAM or non-VSAM) with guaranteed space, candidate volumes are actual volumes on which space has been allocated, but not used. For SMS-managed data sets (VSAM or non-VSAM) without guaranteed space, candidate volumes are not-specific volumes shown as asterisk (*). There may be multiple (*) volumes.

A volume that is a candidate for one component of a cluster but contains used space for another component of that cluster is counted in CATVOLCT and not counted in CANDVOLC. Exception, for non SMS-managed, non-VSAM data sets, volumes that were requested when the data set was created but have not been used for data are counted in CATVOLCT and not counted in CANDVOLC, because there is no indicator in the catalog that the volume is a candidate.

CAPBYTES=

Specifies the data sets selected or excluded have a number of capacity allocated bytes that is within the value specified. The number capacity allocated bytes is equivalent to the number of tracks allocated times the track capacity in bytes. The value may be from 0 to 4294967294 inclusive.

nnnnnnnnnn

Specifies the exact value to be compared.

nnnnnnnK

Indicates the value should be multiplied by 1,000.

nnnnM

Indicates the value should be multiplied by 1,000,000.

CASPLIT=

nnnnnnnn

Specifies the ICF VSAM clusters or components selected or excluded have a number of control area splits that is within the value specified. The value may be from 0 to 99999999 inclusive.

nnnnnn

Specifies the ICF VSAM clusters or data components selected or excluded have a control area split ration that is within the value specified. The control area split ration is defined as the number of control area splits per 100 control areas of the prime volume data component in an ICF VSAM KSDS. The value may be from 0 to 999999 inclusive.

CATALOG=

Specifies the data sets selected or excluded must have a catalog status indicator that corresponds to the indicator supplied. Valid indicators are:

Cataloged to candidate volume.

DASD read failed. Normally the entry would be marked “ONL” (only cataloged), but DASD I/O errors or VTOC open failure prevented the VTOC from being read. Can only occur when DATATYPE=CATVTOC is specified.

Cataloged to another volume.

Not cataloged.

Only cataloged.

Cataloged to this volume.

Cataloged, but unable to process with LOCATE (for example, unmounted CVOL).

CATGROUP=

dsnspec

Specifies strings from 1 to 44 characters in length. All ICF VSAM clusters that show as being cataloged into an ICF catalog that matches the selection or exclusion criteria (e.e., compare length is the length of the data specified) are selected or excluded.

There is a special form of the CATGROUP= operand. Leading periods “.” after CATGROUP= indicate that the group name starts after one ore more index levels. Each period indicates that one index level is to be bypassed.

CATNAME=

dsnspec

Specifies the catalog name selection or exclusion. Only standard catalog names are supported. Standard catalog names contain only alphabetic (character A to Z), number (numeric character 0 to 9), or national (characters (#), ($), and (@)), and periods.

The syntax for the CATNAME= operand is as follows:

• Valid characters (alphabetic, numeric, national) represent themselves.
• (/) (slash) is a masking character that is used to represent a single valid character of any value.
• (|) (vertical bar) is a masking character that is used to represent a single valid alphabetic character.
• (+) (plus) is a masking character that is used to represent a single valid numeric character.
• (?) (question mark) is a masking character that is used to represent a single valid national character.
• (*) (single asterisk) represents zero or more valid characters within an index level that are to be skipped.
• (**) (double asterisk) represents zero or more valid characters and/or index levels that are to be skipped.
• (.) (period) represents a period in the catalog name, except for the following special cases:
  • “**.” (double asterisk, period) at the beginning of what is specified means that a matching catalog name contains the pattern following the “**.” after one or more index levels.
  • “.**.” (period, double asterisk, period) means that a matching catalog name contains at least one period at the point specified (not necessarily two periods).
  • “.**” (period, double asterisk) at the end of what is specified means that, at the point specified, a matching catalog name contains one or more index levels.
• Embedded blanks are not supported.
• The last character specified cannot be a period.
• “***” is invalid.
• “**.**” is invalid.

CATTTR=

Specifies the data sets selected or excluded must contain a TTR value from the catalog that matches the value provided. For a data set on DASD, this field indicates the location (TTR) of the DSCB within the VTOC. However, if the x‘80’ bit is on in the first byte, it indicates that the data set has been archived by ABR and is eligible for auto recall. This CATTTR= value is placed in the catalog entry when RECALL=YES is specified on the DUMP TYPE=ARC control statement and serves as a quick path into the Archive Control File for the restore server.

nnnnnn

The value specified is a decimal number.

X‘xxxxxx’

The value specified is a hexadecimal number.

CATVOL=

cccccccc

Specifies the data sets selected or excluded must have the first cataloged volume serial number that matches the character string specified.

This operand supports full masking. The string may be from 1 to 8 characters in length, including mask characters. The characteristics of the mask are defined under the VOLUME= operand.

CATVOLCT=

nnn

Specifies the data set or cluster names selected or excluded must be cataloged to a number of non-candidate volumes that is within the value specified. The number of candidate volumes is provided separately in the field CANDVOLC=. The value may be from 1 to 200 inclusive.

For VSAM, this field reflects the entire sphere (base cluster plus alternate indexes), not an individual component.

CATVOLTL=

nnn

Specifies the data set or cluster names selected or excluded must be cataloged to a total number of volumes that is within the value specified. This value includes both the number of candidate volumes that is found in the field CANDVOLC= and the number of non-candidate volumes that is found in the field CATVOLCT=. The value may be from 1 to 200 inclusive.

For VSAM, this field reflects the entire sphere (base cluster plus alternate indexes), not an individual component.

xx

Specifies that data sets or clusters must reside on DASD that has a channel connect address that matches the values specified. The value specified is two hexadecimal characters in length.

nnnnn

Specifies the ICF VSAM clusters or components selected or excluded have a number of control intervals per control area that is within the value specified. The value may be from 0 to 65535.

CISIZE=

nnnnn

Specifies that ICF VSAM clusters or components selected (or excluded) have a control interval size that is within the value specified. The value may be from 0 to 32760 inclusive.

CISPLIT=

nnnnnnnn

Specifies the ICF VSAM clusters or components selected or excluded have a number of control interval splits that is within the value specified. The value may be from 0 to 99999999 inclusive.

nnnnnn

Specifies the ICF VSAM clusters or data components selected or excluded have a control interval split ratio that is within the value specified. The control interval split ratio is defined as the number of control interval splits per 100 control intervals of the prime volume data component in an ICF VSAM KSDS. The value may be from 0 to 999999 inclusive.

Specifies the ICF VSAM clusters or components selected or excluded have one or more of the following attributes indicated in the CLUSATTR= cluster attribute flag in the VSAM data set information cell:

Automated Tape Library (ATL) catalog.

Attribute extension data set.

Extended format data set.

Formatted page space.

Cluster describes PAGESPACE.

Cluster describes SWAPSPACE.

Timestamps exist in this cell.

Verify required (catalog only).

CLUSTER=

dsnspec

Specifies strings from 1 to 44 characters in length. All ICF VSAM clusters having a cluster name that matches the selection or exclusion criteria (that is, compare length is 44) are selected or excluded.

There is a special form of the CLUSTER= operand. Leading periods “.” after CLUSTER= indicate that the name starts after one or more index levels. Each period indicates that one index level is to be bypassed. The resulting compare must be exact (that is, a value of “..LIST” does not match a cluster with a name of A.B.LIST.D).

CLUSTGROUP=

dsnspec

Specifies strings from 1 to 44 characters in length. All ICF VSAM clusters having a cluster name that matches the selection or exclusion criteria (that is, compare length is the length of data specified) are selected or excluded.

There is a special form of the CLUSTGROUP= operand. Leading periods “.” after CLUSTGROUP= indicate that the group name starts after one or more index levels. Each period indicates that one index level is to be bypassed.

CMPCANDV=

nnn

Specifies the VSAM components selected or excluded must be cataloged to a number of candidate volumes that is within the value specified. The value may be from 0 to 200 inclusive.

Candidate volumes are volumes that were requested with a VSAM cluster or SMS-managed, non-VSAM data set was created but have not yet been used for data.

For non SMS-managed VSAM components, candidate volumes are actual volumes on which no space has been allocated yet for the cluster.

For SMS-managed data sets (VSAM or non-VSAM) with guaranteed space, candidate volumes are actual volumes on which space has been allocated but not used.

For SMS-managed data sets (VSAM or non-VSAM) without guaranteed space, candidate volumes are non-specific volumes shown as asterisk (*). There may be multiple asterisk (*) volumes.

CMPVOLCT=

nnn

Specifies VSAM components selected or excluded must be cataloged to a number of non-candidate volumes that is within the value specified. The number of candidate volumes is provided separately in the field CMPCANDV. The value may be from 1 to 200 inclusive.

CMPVOLTL=

nnn

Specifies the VSAM components selected or excluded must be cataloged to a total number of volumes that is within the value specified. This value includes both the number of candidate volumes that is found in the field CMPCANDV and the number of non-candidate volumes that is found in the field CMPVOLCT. The value may be from 1 to 200 inclusive.

COMPTYPE=

Specifies the type of ICF VSAM component that is to be selected or excluded. Valid component types are:

Data component.

Index component.

Alternate index data component.

Alternate index index component.

COMPUSER=

Specifies the data sets or clusters selected or excluded must have a value for the Compressed User Data Size (taken from either the Type=27 or Type=28 Extended Format Cell in the VVDS) within the value specified. The number may be from 0 to 999999999999999 inclusive.

nnnnnnnnnnnnnnn

Specifies the exact value to be compared.

nnnnnnnnnnnnK

Indicates the value should be multiplied by 1,000.

nnnnnnnnnM

Indicates the value should be multiplied by 1,000,000.

CRDATE=

datespec

Specifies the data sets selected or excluded must have a creation date that is within the date supplied. The date is specified as a Julian date that may be in the form “yyyyddd” or “yyddd”. For readability, a period may be inserted between the year and day.

CRDAYS=

nnnnn

Specifies the data sets selected or excluded must have a number of days since creation that is within the number of days supplied. The number may be from 0 to 32000 inclusive.

CRJOBNAM=

cccccccc

Specifies the data sets selected or excluded must have a creation job name as extracted from the Format_9 DSCB that matches the character string specified.

This operand supports full masking. The string may be from 1 to 8 characters in length, including mask characters. The characteristics of the mask are defined under the VOLUME= operand.

CRSTEPNM=

cccccccc

Specifies the data sets selected or excluded must have a creation step name as extracted from the Format_9 DSCB that matches the character string specified.

This operand supports full masking. The string may be from 1 to 8 characters in length, including mask characters. The characteristics of the mask are defined under the VOLUME= operand.

hhmmss

Specifies the data sets selected or excluded must have a creation time that matches the value or range of values supplied. Currently, data sets that were defined under z/OS 1.11, prior releases of ICF VSAM, and IAM have a creation time.

CTFLD=

Specifies the DSCB for the data sets selected or excluded must reside on a track within the VTOC that matches the value specified.

ccccchhhhrr

Specify the value in decimal specifying all of the necessary initial zeros.

ccccc.hhhh.rr

Specify the value in decimal where the cylinder number is 1 to 5 digits, the head number is 1 to 4 digits, and the record number is 1 or 2 digits where the cylinder number, head number, and record number are separated by periods.

X‘ccccchhhhrr’

Specify the value in hexadecimal.

ccccc

Specifies the data sets or clusters selected or excluded must be connected to the DASD control unit with the serial number that matches the value specified.

This operand supports full masking. The string may be from 1 to 5 characters in length, including mask characters. The characteristics of the mask are defined under the VOLUME= operand.

DATACLAS=

dataclas

Specifies the data sets selected or excluded must have an SMS data class that matches the character string specified.

This operand supports full masking. The string may be from 1 to 8 characters in length, including mask characters. The characteristics of the mask are defined under the VOLUME= operand.

DAYSEXP=

nnnnn

Specifies the data sets selected or excluded must have a number of days until expiration that is within the number of days supplied. The number may be from 0 to 32000, inclusive. If a data set’s expiration date is 99.000, 99.xxx (“xxx” is 365 or greater), then the value of DAYSEXP= is set to 65535.

DELETES=

Specifies the ICF VSAM clusters or components selected or excluded have a number of records deleted that is within the value specified. The value may be from 0 to 4294967294 inclusive.

nnnnnnnnnn

Specifies the exact value to be compared.

nnnnnnnK

Indicates the value should be multiplied by 1,000.

nnnnM

Indicates the value should be multiplied by 1,000,000.

DEVCLASS=

Specifies the data sets selected or excluded must reside only on the device class specified. FDREPORT recognizes the following device classes:

DEVTYPE=

Specifies the data sets selected or excluded must reside only on the device type specified. Some valid DASD device types are:

3390

3390-A

Recognized only if SUMDEVICE=UNIQUE is in effect.

3390-E2

Recognized only if SUMDEVICE=UNIQUE is in effect.

3390-F

Recognized only if SUMDEVICE=UNIQUE is in effect.

3390-2

Recognized only if SUMDEVICE=UNIQUE is in effect.

3390-3

Recognized only if SUMDEVICE=UNIQUE is in effect.

3390-9

Recognized only if SUMDEVICE=UNIQUE is in effect.

3390-27

Recognized only if SUMDEVICE=UNIQUE is in effect.

3390-53

Recognized only if SUMDEVICE=UNIQUE is in effect.

3390-54

Recognized only if SUMDEVICE=UNIQUE is in effect.

SYSRES

When executing with DATATYPE=CATALOG, represents data sets cataloged with indirect volume serials.

Some valid tape devices are:

3480

3480X

3490

3590-1

TAPE

DIRBFREE=

nnnnn

Specifies the data sets selected or excluded must have a number of free (unused) directory blocks that is within the number specified. The number may be from 0 to 32000 inclusive.

DIRBLOCK=

nnnnn

Specifies the data sets selected or excluded must have a number of directory blocks that is within the number specified. The number may be from 0 to 32000 inclusive.

DIRBUSED=

nnnnn

Specifies the data sets selected or excluded must have a number of used director blocks that is within the number specified. The number may be from 0 to 32000 inclusive.

DSGROUP=

dsnspec

Specifies strings of 1 to 44 characters in length. All data sets having a name that matches the selection or exclusion criteria (that is, compare length is the length of data specified) are selected or excluded.

There is a special form of the DSGROUP= operand. Leading periods “.” after DSGROUP= indicate that the group name starts after one or more index levels. Each period indicates that one index level is to be bypassed.

Multiple data set group values using the same operator may be entered as (dsnspec,…,dsnspec).

DSIND=

Specifies the data sets selected or excluded must have data set indicators that correspond to the indicators supplied. Valid indicators are:

Last volume on which data set resides.

IBM RACF defined data set.

Block size is multiple of 8.

Password required for read or write.

Password required only for write.

Data set has been updated.

DSNALCNT=

nnnnn

Specifies the data sets selected or excluded must have been extracted from a system catalog using DATATYPE=CATALOG, CATARCH, or CATVTOC and must contain a number of aliases that satisfies the value and operator specified.

DSNALIAS=

dsnspec

Specifies the data sets selected or excluded must have been extracted from a system catalog using DATATYPE=CATALOG, CATARCH, or CATVTOC and must contain the character string specified as an alias name or an alias name prefix.

DSNAME=

dsnspec

Specifies strings from 1 to 44 characters in length. All data sets having a name that matches the selection or exclusion criteria (that is, compare length is 44) are selected or excluded.

There is a special form of the DSNAME= operand. Leading periods “.” after DSN= indicate that the name starts after one or more index levels. Each period indicates that one index level is to be bypassed. The resulting compare must be exact (that is, a value of “..LIST” does not match a data set with a name of “A.B.LIST.D”).

It is also possible to cause the DSN= operand to act like the DSG= operand by indication argument truncation with an asterisk (*). The resulting compare would not be an exact compare (that is, a value of “..LIST*” would then match a data set “A.B.LIST.D”).

Multiple data set name values using the same operator may be entered as (dsnspec,…,dsnspec).

DSNEIFLG=

Specifies the extended data set criteria associated with the ICF VSAM component. This information is extracted from the VVR. The values are:

The data set / component has extended addressability and may exceed 4G. GIGABYTE may be abbreviated as “G”.

The ICF VSAM component uses relative control interval (CI) addressing. RELCI may be abbreviates as “R”.

The data set contains a zSeries File System. ZFS may be abbreviated as “Z”

DSNFLAGS=

Specifies the data set or component selected or excluded must have a data set attribute value that matches the value specified. The only valid attribute is:

Data set or component is defined as supporting record level sharing.

DSORG=

Specifies the data sets selected or excluded must have a data set organization that corresponds to the data set organization supplied. Valid data set organizations are:

All VSAM.

Direct Access.

ICF VSAM.

Hierarchical File Structure.

Physical Sequential.

Physical Sequential Extended.

Partitioned.

Partitioned Extended.

Unmovable. May be appended to all other data set organizations or used independently.

Alternate form of Unmovable.

Undefined.

DSSN=

Specifies the data sets selected or excluded must have the value specified in the volume serial number location in the Format_1 DSCB. This capability is provided because many installations use the field for other than the current volume serial number.

This operand supports full masking. The string may be from 1 to 6 characters in length, including mask characters. The characteristics of the mask are defined under the VOLUME= operand.

cccccc

The value specified is in character format.

C‘cccccc’

The value specified is in character format.

X‘xxxxxxxxxxx’

The value specified is in hexadecimal format.

ENCRBDAY=

nnnnn

Specifies the volumes selected or excluded must have a number of days since backed up by FDRCRYPT that is within the number of days supplied. The number may be from 0 to 32000 inclusive.

ENCRBDSN=

dsn

Specifies backup data set name selection or exclusion, subject to the rule that only standard data set names are supported. Standard data set names contain only alphabetic (character A to Z), number (numeric character 0 to 9), or national character (#, $, @), and periods.

The syntax for the ENCRBDSN= operand is as follows:

• Valid characters (alphabetic, numeric, national) represent themselves.
• (/) slash is a masking character that is used to represent a single valid character of any value.
• (|) vertical bar is a masking character that is used to represent a single valid alphabetic character.
• (+) plus is a masking character that is used to represent a single valid numeric character.
• (?) question mark is a masking character that is used to represent a single valid national character.
• (*) single asterisk represents zero or more valid characters within an index level that are to be skipped.
• (**) double asterisk represents zero or more valid characters and/or index levels that are to be skipped.
• (.) period represents a period in the catalog name, except for the following special cases:
  • “**.” (double asterisk, period) at the beginning of what is specified means that a matching catalog name contains the pattern following the “**.” after one or more index levels.
  • “.**.” (period, double asterisk, period) means that a matching catalog name contains at least one period at the point specified (not necessarily two periods).
  • “.**” (period, double asterisk) at the end of what is specified means that, at the point specified, a matching catalog name contains one or more index levels.
• Embedded blanks are not supported.
• The last character specified cannot be a period.
• “***” is invalid.
• “**.**” is invalid.

ENCRBVOL=

vol

Specifies the volumes selected or excluded must have the first backup volume that matches the values specified. This operand currently supports full masking. The string may be from 1 to 6 characters in length, including mask characters. The characters of the mask are defined under the VOLUME= operand.

ENCRDATE=

yyyyddd

Specifies the volumes selected or excluded must have been a backup date within the date supplied. The date is specified as a Julian date (year plus day number) that may be in the form “yyyyddd” or “yyddd”. For readability, a period may be inserted between the year and day.

ENCRFLGS=

Specifies the volumes selected or excluded must have record indicators that match one or more of the values specified. Valid values are:

Record marked for deletion.

File was encrypted by FDRCAMS.

Key was generated by FDRCRYPT.

A master key was used during the encryption.

A public key was used during the encryption.

The backup file resides on a tape device.

The backup file was created by FDRUPSTREAM.

ENCRFLSQ=

nnnnn

Specifies the volumes selected or excluded must have a backup file sequence number that matches the value provided. This field only applies to tape data sets; the tile sequence number of DASD data sets is always shown as zero. The number may be from 0 to 65535 inclusive.

ENCRKEY=

X‘x...x’

Specifies the volumes selected or excluded must have an encryption key that matches the value provided. The key is 32 bytes long and must be entered as pairs of valid hexadecimal characters, from 2 character to 64 characters in length.

ENCRTIME=

hhmmss

Specifies the volumes selected or excluded must have a backup time stamp that matches the value or range of values supplied.

ENCRTYPE=

Specifies the volumes selected or excluded must have an encryption type that matches the encryption types specified. Valid encryption types are:

AES128

Encryption using the current US-government supported encryption technique (Advanced Encryption Standard (AES) with an 128 bit (16 byte) key).

AES192

Encryption using the Advanced Encryption Standard (AES) with a 192 bit (24 byte) key.

AES256

Encryption using the Advanced Encryption Standard (AES) with a 256 bit (32 byte) key.

ENCRVOL=

vol

Specifies the DASD volume serial number that was encrypted with be tested. If the volume serial number test is successful, the record is eligible for selection or exclusion. This operand supports full masking. The string may be from 1 to 6 characters in length, including mask characters. The characteristics of the mask are defined under the VOLUME= operand.

EXCPEXIT=

cccccccc

Specifies the ICF VSAM clusters or components selected or excluded have an exception exit name that matches the character string specified. This operand supports full masking. The string may be from 1 to 8 characters in length, including mask characters. The characteristics of the mask are defined under the VOLUME= operand.

EXCPS=

Specifies the ICF VSAM clusters or components selected or excluded have a number of DASD EXCPs recorded that is within the value specified. The value may be from 0 to 4294967294 inclusive.

nnnnnnnnnn

Specifies the exact value to be compared.

nnnnnnnK

Indicates the value should be multiplied by 1,000.

nnnnM

Indicates the value should be multiplied by 1,000,000.

EXPDATE=

datespec

Specifies the data sets selected or excluded must have an expiration date that is within the date supplied. The date is specifies as a Julian date (year plus day number)) that may be in the form “yyyyddd” or “yyddd”. For readability, a period may be inserted between the year and day.

EXPDAYS=

nnnnn

Specifies the data sets selected or excluded must have a number of days until expiration that is within the number of days supplied. The number may be from 0 to 32000, inclusive. If a data set’s expiration date is earlier than today, then the value of EXPDAYS is zero. If a data set’s expiration date is 99.000 or 99.xxx (“xxx” is 365 or greater), then the value of EXPDAYS= is 65535.

EXTENTS=

cccchhrr 

Specifies the selected or excluded data set(s) that must have one or more extents containing the specified cccchh value. This specified value is checked against the cccccchhhh values represented by the extent descriptor(s) of the data set. If the extent descriptor describes a ccccchhhh value that matches the value or operator specified, the data set is accepted for processing.

Where,

• cccc is Cylinder in the integer.
• hh is Head in the integer.
• rr is the operator (matching criteria) value in the integer.

The following table displays the mapping of the integer value with the operator.

If rr is 00, it will select the '=' operator for extents checking.

If rr is 08, it will select '<' operator for extents checking.

You can also use a combination of two values such as 72, which is 64+8 and it will select two operators '>=' and '<' for checking extents.

EXTYPE=

Specifies the data sets selected or excluded must have at least one extent that matches the type specified. Valid extent types are:

Extent on cylinder boundary.

Index extent.

Prime extent.

Overflow extent.

Standard User Label extent.

FILESEQ=

nnnnn

Specifies the data sets selected or excluded must have a file sequence number that matches the value provided. This field only applies to tape data sets; the file sequence number of DASD data sets is always shown as zero. The number may be from 0 to 65535 inclusive.

FLAG1=

Specifies the data sets selected or excluded must have an extended format data set flag byte value that matches the value provided. Valid indicators are:

Check-pointed data set.

Data set is compressible.

Extended attribute setting.

Pervasive Encryption.

Data set may exceed 65535 tracks on volume.

Data set has been recalled (by DFSMShsm).

FREEEXT=

nnn

Specifies the data sets selected or excluded must have a number of free or unused extents on a DASD volume (including the SUL extent, if present) that is within the value specified. The number may be from 0 to 127 inclusive.

GDGENTRY=

nnn

Specifies the data sets selected or excluded must be part of a generation data group having a number of active entries that matches the value provided. The number may be from 0 to 255 inclusive.

GDGFLAGS=

Specifies the data sets selected or excluded must be part of a generation data group having the indicators that match those provided. Valid indicators are:

All data sets within the GDG are to be uncataloged with the limit is reached.

Only the oldest data set of the GDG is to be uncataloged when the limit is reached.

The data set is not to be removed from the VTOC of the volume on which it resides when it is uncataloged.

The data set is to be removed from the VTOC of the volume on which it resides.

MEMNAMES

For PDSs, matches the data set only if it contains “MEMNAMES=” or does not contain “MEMNAMES¬=” the members specified. The member names can be specified as masks, as described under the VOLUME= operand.

STORGRP

Selects “STORGRP=” or excludes “STORGRP¬=” all online volumes defined as belonging to the specified SMS storage group. A storage group prefix can be specified by following the prefix with an asterisk, for example, STORGRP=DB*. Multiple storage groups and/or prefixes may be specified by enclosing them in parentheses, separated by commas. Valid only on systems with SMS active.

UNIT

Selects online volumes based on their device address, up to four hexadecimal digits. UNIT= can also select offline DASD volumes if the SELECTOFFLIN option is enabled.

All comparison operands are valid (for example, UNIT>=140).

UNITNAME

Selects “UNITNAME=” or excludes “UNITNAME¬=” all online volumes that are mounted on a DASD unit that is included in the specified generic (for example, UNITNAME=3390) or esoteric name (for example, UNITNAME=SYSDA). This is limited to names that are valid for UNIT= in JCL at your installation. Multiple units may be specified by enclosing them in parentheses, separated by commas.

XDSNAME

Selects or excludes data sets based on a mask tested against the data set name or VSAM cluster name. XDSNAME= and XDSNAME¬= are supported. This mask may contain:

• Any valid (alphanumeric or national) character representing itself.
• / (slash) or % (percent) represents a single valid character.
• | (vertical bar) represents a single valid alphabetic character.
• + (plus) represents a single valid numeric character.
• ? (question) represents a single valid national character (#, $, or @ in the US).
• * (single asterisk) represents zero or more valid characters within one index level.
• ** (double asterisk) represents zero or more valid characters contained in one or more index levels (including their periods).
• . (period) represents a period (index level) in the data set name except for the special cases below.
• **. (double asterisk, period) at the beginning of the string represents one or more index levels at the beginning of the data set name.
• .** (period, double asterisk) at the end of the string represents one or more index levels at the end of the data set name.
• .**. (period, double asterisk, period) in the middle of the string represents either a SINGLE period or one or more index levels at that point.

Examples:

Selects any data set with a first index level of exactly “A.”.

Selects any data set with a first index level that begins with “A”.

Is equivalent to XDSN=A**.

Selects any data set with a first index level beginning with “A” that has at least four index levels.

Selects any data set with a first index level beginning with “A” that has exactly three index levels.

Selects any data set of at least two index levels ending in “.CNTL”.

Selects any data set starting with a first index level exactly three characters long.

Relative GDG generations, for example, XDSNAME=*.MASTER(0) is not supported.

VOLUME=

Specifies one or more DASD volume serial numbers. Volume serials may be specified by a mask. This mask may contain:

• Any valid (alphanumeric or national) character representing itself.
• / (slash) or % (percent) represents a single valid character.
• | (vertical bar) represents a single valid alphabetic character.
• + (plus) represents a single valid numeric character.
• ? (question) represents a single valid national character (#, $, or @ in the US).
• * (single asterisk) represents zero or more valid characters.

Examples:

VOL=X**Z

VOL=//PR* VOL=TSO+++

XSELECT and XEXCLUDE support both VOL= and VOL¬=. Multiple volume serials and/or masks may be specified by enclosing them in parentheses, separated by commas. For example, VOL=(SYS123,TSO+++)

The VOL= operand may be repeated on a single statement; all of the specified volumes are selected (or excluded). Prior releases of FDREPORT permitted you to have STORGRP, UNIT, UNITNAME, VOLUME, and VOLGROUP specified on the same command and, if the operator was equal (=, .EQ.) each time, the operands were OR’d. This new code prevents this. Since STORGRP, UNIT, and UNITNAME have their own imprint on the selection process, specification of them on the same command results in them being AND’d together to make a complete argument. The only exceptions currently permitted on the XSELECT and XEXCLUDE commands are: “If a given field name is specified more than once on the same command, and the operator is equal (=, .EQ.) each time, then the occurrences of that field name are OR’d. If any combination of the field names VLVOLSER, VOLUME, and VOLGROUP is specified on the same command, and the operator is equal (=, .EQ.) each time, then these operands are OR’d. If none of these operands is specified, then the volumes on which the data sets reside are not criteria for selection.