Local File Wildcard Parameters

The following wildcard parameters are supported:

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 data set name. For exmample, `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 data set name from this point on. The double asterisk cannot be the first character in the data set name. It must be the only data in the data set 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 examples: `DSN=TESTDNI..SOURCE` `LF=TESTDNI.ABC` 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`

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 data set name.

For exmample,

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 data set name from this point on. The double asterisk cannot be the first character in the data set name. It must be the only data in the data set 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 examples:

DSN=TESTDNI.**.SOURCE

LF=TESTDNI.ABC**

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

Contents

Index

Search Results

Local File Wildcard Parameters

Examples