Local File Wildcard Parameters

The following wildcard parameters are supported:

Wildcard Parameter Description

Wildcard Parameter	Description
%	This parameter indicates a match on a single character. If a character is not present, a match does not occur. You can include up to eight % wildcard characters in a single qualifier. For example, DSN=TESTDNI.NODE%%.* DSN=TESTDNI.%FILE.%%XYZ If you specify: DSN=TESTDNI.AB%%.SOURCE DNI returns: TESTDNI.AB12.SOURCE TESTDNI.ABCD.SOURCE DNI does not return: TESTDNI.AB1.SOURCE
*	This parameter indicates a match on any data within the qualifier. The asterisk () can be preceded by other characters, and followed by additional qualifiers. You cannot specify asterisk as the first qualifier in the z/OS dataset name. For example, DSN=TESTDNI..SOURCE LF=PRODDNI.SOURCE.* If you specify: DSN=TESTDNI.AB*.SOURCE DNI returns: TESTDNI.ABC123.SOURCE TESTDNI.AB.SOURCE DNI does not return: TESTDNI.AA123.SOURCE
**	A double asterisk () indicates a match on dataset name from this point on. The double asterisk cannot be the first character in the dataset name. It must be the only data in the dataset qualifier and must be the last qualifier in the file name. You cannot add any characters following the double asterisk and you must use it behind a period. Valid examples: DSN=TESTDNI.SOURCE. LF=TESTDNI.NYNODE.TEXT. Invalid example: DSN=TESTDNI..SOURCE If you specify: DSN=TESTDNI.ABC.** DNI returns: TESTDNI.ABC.TAX.DATA.2008 TESTDNI.ABC.SOURCE DNI does not return: `TESTDNI.ABC123.TAX.DATA.2008`

This parameter indicates a match on a single character. If a character is not present, a match does not occur. You can include up to eight % wildcard characters in a single qualifier.

For example,

DSN=TESTDNI.NODE%%.*
DSN=TESTDNI.%FILE.%%XYZ

If you specify:

DSN=TESTDNI.AB%%.SOURCE

DNI returns:

TESTDNI.AB12.SOURCE 
TESTDNI.ABCD.SOURCE

DNI does not return:

TESTDNI.AB1.SOURCE

This parameter indicates a match on any data within the qualifier. The asterisk (*) can be preceded by other characters, and followed by additional qualifiers. You cannot specify asterisk as the first qualifier in the z/OS dataset name.

For example,

DSN=TESTDNI.*.SOURCE
LF=PRODDNI.SOURCE.*

If you specify:

DSN=TESTDNI.AB*.SOURCE

DNI returns:

TESTDNI.ABC123.SOURCE
TESTDNI.AB.SOURCE

DNI does not return:

TESTDNI.AA123.SOURCE

A double asterisk (**) indicates a match on dataset name from this point on. The double asterisk cannot be the first character in the dataset name. It must be the only data in the dataset qualifier and must be the last qualifier in the file name. You cannot add any characters following the double asterisk and you must use it behind a period.

Valid examples:

DSN=TESTDNI.SOURCE.**
LF=TESTDNI.NYNODE.TEXT.**

Invalid example:

DSN=TESTDNI.**.SOURCE

If you specify:

DSN=TESTDNI.ABC.**

DNI returns:

TESTDNI.ABC.TAX.DATA.2008
TESTDNI.ABC.SOURCE

DNI does not return:

TESTDNI.ABC123.TAX.DATA.2008

Examples

The following examples show how to define local file wildcards in the DSN parameter.

Example 1:

DSN=TESTDNI.AB%%123.SOURCE

DNI returns:

TESTDNI.AB12123.SOURCE
TESTDNI.ABCD123.SOURCE

DNI does not return:

TESTDNI.ABCD123.SOURCE

Example 2:

DSN=TESTDNI.ABC.*

DNI returns:

TESTDNI.ABC.SOURCE
TESTDNI.ABC.ACCT

DNI does not return:

TESTDNI.ABC.SOURCE.DATA

Example 3:

DSN=TESTDNI.AB*.SOURCE

DNI returns:

TESTDNI.ABC123.SOURCE
TESTDNI.AB.SOURCE

DNI does not return:

TESTDNI.AA123.SOURCE

Example 4:

DSN=TESTDNI.AB*.**

DNI returns:

TESTDNI.ABC123.TAX.DATA.2008
TESTDNI.AB.TAX.DATA.2008
TESTDNI.AB.SOURCE

DNI does not return:

TESTDNI.AA123.TAX.DATA