Data set name filtering

To implement data set name filtering for the selection criteria DSNAME, DSNAME_DATA, DSNAME_INDEX, and LOGSTREAMID, specify the DSN_PATTERN_MATCHING keyword in the OPTIONS member.

For information about the OPTIONS member global definitions and general operation options, see Specifying subsystem options.

DSN_PATTERN_MATCHING wildcard character patterns

Table 1 shows valid wildcard character patterns and examples for the DSN_PATTERN_MATCHING options.

Table 1. DSN_PATTERN_MATCHING wildcard character patterns and examples
Wildcard character specification	Description	Examples
*	An asterisk that is combined with valid DSN characters, or a percent sign (%), represents zero to eight characters of any value.	`ABC.DEF` This specification matches all data set names that have ABC as the first qualifier and the characters DEF at the beginning of the second qualifier. For example: ABC.DEF, ABC.DEF3, or ABC.DEFINE1. `ABC.DEF` This specification matches all data set names that have ABC as the first qualifier and the characters DEF at the end of the second qualifier. For example: ABC.ADEF or ABC.A123DEF. `ABC.*D%` This specification matches all data set names that have ABC as the first qualifier, the character D in the second qualifier, followed by one non-blank DSN character. For example: ABC.ADE or ABC.JOBD1.
. or ..	Represents one or more valid characters when BASIC is specified. Represents one DSN qualifier when EXTENDED1 or EXTENDED2 is specified.	`.DEF.JOB` When BASIC is specified, this specification matches on data set names that have any valid leading qualifiers where the last two qualifiers of the data set name are DEF.JOB. For example: ABC.DEF.JOB, WORK1.DEF. JOB, or TEST1.ABC.DEF. JOB. This specification does not match on a data set name of DEF.JOB. When EXTENDED1 or EXTENDED2 is specified, this specification matches on data set names that have any valid first qualifier where the last two qualifiers are DEF.JOB (such as TST3.DEF.JOB or ABC.DEF.JOB). Note: This specification does not match on data set names such as DEF.JOB, ABC.TST3.DEF.JOB, or WORK1.TEST5.AUD.DEF. JOB. `ABC.DEF..JOB` When BASIC is specified, this specification matches on data set names that have ABC as the first qualifier, DEF as the second qualifier, one or more qualifiers, and JOB as the last qualifier. For example: ABC.DEF.GHI.JOB or ABC.DEF.TST3.T52.JOB. When EXTENDED1 or EXTENDED2 is specified, this specification matches on data set names that have ABC as the first qualifier, DEF as the second qualifier, any valid third qualifier, and JOB as the last qualifier. For example: ABC.DEF.TST3.JOB or ABC.DEF.GHI.JOB. Note: This specification does not match on data set names such as ABC.DEF.JOB or ABC.DEF.TST3.T52.JOB.
.* last qualifier	Represents one or more trailing DSN qualifiers when BASIC is specified. Represents one DSN qualifier when EXTENDED1 is specified. Represents zero or more DSN qualifiers when EXTENDED2 is specified.	`ABC.DEF.*` When BASIC is specified, this specification matches data set names that have ABC as the first qualifier, DEF as the second qualifier, and one or more trailing qualifiers. For example: ABC.DEF.TST3, ABC.DEF.GHI.JOB, or ABC.DEF.TST3.JOB.T52.ADDR5. Note: This specification does not match on the data set name ABC.DEF. When EXTENDED1 is specified, this specification matches all data set names that have ABC as the first qualifier, DEF as the second qualifier, and any valid third qualifier. For example: ABC.DEF.TST3 or ABC.DEF.JOB. Note: This specification does not match on the data set name ABC.DEF or data set names with more than three qualifiers. When EXTENDED2 is specified, this specification matches data set names that have ABC as the first qualifier and DEF as the second qualifier, including data set names with zero or more trailing qualifiers. For example: ABC.DEF, ABC.DEF.TST3, ABC.DEF.GHI.JOB, or ABC.DEF.TST3.JOB.T52.ADDR5.
. or .. or .**	Represents zero or more DSN qualifiers. Note: The BASIC option does not support the use of double asterisks.	`.DEF.JOB` When EXTENDED1 or EXTENDED2 is specified, this specification matches on data set names that end with the qualifiers of DEF and JOB. For example: DEF.JOB, ABC.DEF.JOB, ABC.TST3.DEF. JOB, or T52.TST3.WORK.DEF. JOB. `ABC.DEF..JOB` When EXTENDED1 or EXTENDED2 is specified, this specification matches on data set names that have ABC as the first qualifier, DEF as the second qualifier, zero or more qualifiers, and JOB as the last qualifier. For example: ABC.DEF.JOB or ABC.DEF.TST3.JOB. `ABC.DEF.**` When EXTENDED1 or EXTENDED2 is specified, this specification matches data set names that have ABC as the first qualifier and DEF as the second qualifier. For example: ABC.DEF, ABC.DEF.TST3, or ABC.DEF.TST3.JOB.T52.ADDR5.
%	Represents one non-blank DSN character.	`ABC.D%%%D` This specification matches all data sets that have ABC as the first qualifier and a second qualifier that begins with D, followed by three characters, ending with D. For example: ABC.D123D or ABC.DABCD.

Rule definition example (DSN_PATTERN_MATCHING=BASIC)

The following example applies to default Advanced Allocation Management processing as specified by the DSN_PATTERN_MATCHING=BASIC subsystem option.

INCLUDE DSNAME=WRKABC*
INCLUDE DSNAME=WORK.ABC*.IJK
INCLUDE DSNAME=PABC.CDEF.*
INCLUDE DSNAME=NODE1.NO*E4

The INCLUDE DSNAME=WRKABC* statement indicates that all data sets that have names that begin with WRKABC (such as WRKABC, WRKABCTS, WRKABC1.TEST, WRKABC2.TST.DSK1) are to be included in processing:

The INCLUDE DSNAME=WORK.ABC*.IJK statement indicates that all data sets that have names that begin with WORK.ABC and end with .IJK (such as WORK.ABC.IJK, WORK.ABC123.IJK or WORK.ABCTST1.DSK1.IJK) are to be included in processing.

The INCLUDE DSNAME=PABC.CDEF.* statement indicates that all data sets that have names that begin with PABC.CDEF. (such as PABC.CDEF.TST or PABC.CDEF.TEST.WRK1) are to be included in processing. PABC.CDEF is not included in processing.

The INCLUDE DSNAME=NODE1.NO*E4 statement indicates that all data sets that have names that begin with NODE1.NO and end with E4 (such as NODE1.NOABC.NODE4, or NODE1.NODE2.NODE3.NODE4) are to be included in processing.