Open topic with navigation

TIBCO® Managed File Transfer Platform Server for z/OS 8.1.0

# 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 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

Copyright © 2003-2021. TIBCO Software Inc. All Rights Reserved.