Open topic with navigation

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

# FUSSMFIL

You can use the FUSSMFIL exec to queue transfers to send multiple files to a remote node.

You can use this exec to send multiple files to a remote system in one command. The FUSSMFIL exec uses the same parameters as the FUSSEND exec. This exec uses the LFILE parameter as a high-level prefix and scans the catalog for all files that match the high-level prefix. Then, it substitutes information of the LFILE parameter into the RFILE parameter, and queues a file transfer for each dataset that matches the high-level qualifier.

The Platform Server only supports to initiate up to 500 transfers on any single FUSSMFIL transfer. If more than 500 files match the LFILE prefix, an error message is displayed and no transfers is queued.

Note: You can use the WAIT and MWAIT operands in this exec. The Platform Server only supports to queue up to 40 transfers before a FUSWAIT command is executed for an address space.

## Wildcard Parameter

The LFILE parameter accepts a single wildcard parameter, *.

You must use at least one full z/OS prefix before the first wildcard. For example, LF=PROD.* is acceptable, while LF=PROD* is illegal and will not be processed.

The following examples show how to use the wildcard parameter in the FUSSMFIL exec:

- LF=FUSION.* or LF=FUSION: Sends all files starting with FUSION.
- LF=FUSION.ABC* or LF=FUSION.ABC.*: Sends all files starting with FUSION.ABC.

Note: It is more efficient to put the wildcard character after the period than before the period. It is more efficient to use LF=FUSION.PROD.* than using LF=FUSION.PROD*. Because the first setting reads only the entries starting with FUSION.PROD in the catalog, while the second setting reads all entries starting with FUSION in the catalog to see whether a match on FUSION.PROD* exists.

## Substitutable Parameters

Three substitutable parameters can be set with the FUSSMFIL exec. You must define one of these parameters within the RFILE parameter; otherwise, the request fails.

Parameter | Description
--- | ---
%LFILE | Substitutes the entire LFILE parameter. For example:
    FUSSMFIL NODE=SNANODE LF=LOCAL.FILE.CRE* RF=C:\%LFILE INTERVAL=3 SAY WAIT
The output of this example is the same as that of the FUSSEND or FUSRECV exec. You get the output for each file that is transferred.
%SUFFIX | Substitutes the data after the high-level prefix defined. For example:
    FUSSMFIL IPADDR=127.127.127.1 IPPORT=46464 LF=LOCAL.FILE.CRE* RF=C:\ACCT.%SUFFIX INTERVAL=3 SAY WAIT
The output of this example is the same as that of the FUSSEND or FUSRECV exec. You get the output for each file that is transferred.
%NOHLQ | Substitutes all data except the high-level qualifier (HLQ). For example:
    FUSSMFIL NODE=SNANODE LF=LOCAL.FILE.CRE* RF=C:\ACCT.%NOHLQ INTERVAL=3 SAY WAIT
The output of this example is the same as that of the FUSSEND or FUSRECV exec. You get the output for each file that is transferred.

In the following example, you can extract four files from the catalog:

`LF=PROD.TESTV*`

The following table shows the remote files for each RF command:

| `RF=%LFILE` | `RF= ACCT.%SUFFIX` | `RF= ACCT.%NOHLO(s/b NOHLQ).bkup`
--- | --- | --- | ---
PROD.TESTVB | PROD.TESTVB | ACCT.B | ACCT.TESTVB.BKUP
PROD.TESTVBA | PROD.TESTVBA | ACCT.BA | ACCT.TESTVBA.BKUP
PROD.TESTVB2 | PROD.TESTVB2 | ACCT.B2 | ACCT.TESTVB2.BKUP
PROD.TESTVB3 | PROD.TESTVB3 | ACCT.B3 | ACCT.TESTVB3.BKUP

## The TEST Parameter

When you use the TEST parameter in the FUSSMFIL exec, the exec displays and tests the LF and RF files to be passed to the Platform Server instead of queuing the request. In this way, you can ensure that only the correct files are queued before a transfer request is queued.

For example:

    FUSSMFIL lf=prod.acct98.* rf=acct.%nohlq ipaddr=14.0.0.0 ipport=46464 test,

The response is as follows:

    LFILE=PROD.ACCT98.PAYROLL     RFILE=acct.ACCT98.PAYROLL
    LFILE=PROD.ACCT98.TAXES  	   RFILE=acct.ACCT98.TAXES
    LFILE=PROD.ACCT98.TAXES.BKUP  RFILE=acct.ACCT98.TAXES.BKUP

Note: No transfers are queued when the TEST parameter is used on the command line. After you validate that the parameters in this exec are correct, you can remove the TEST parameter and execute the FUSSMFIL exec.

The following example queues a transfer to send multiple files to a remote node, substitutes the entire %LFILE parameter, and tests the local files (LF) and the remote files (RF) that are queued:

    FUSSMFIL NODE=SNANODE LF=LOCAL.FILE.CRE* RF=C:\%LFILE INTERVAL=3 SAY WAIT TEST

The output of this example is as follows:

    LFILE=LOCAL.FILE.CREATE.FILE1  RFILE=C:\LOCAL.FILE.CREATE.FILE1
    LFILE=LOCAL.FILE.CREATE.FILE2  RFILE=C:\LOCAL.FILE.CREATE.FILE2
    LFILE=LOCAL.FILE.CREATE.FILE3  RFILE=C:\LOCAL.FILE.CREATE.FILE3
    LFILE=LOCAL.FILE.CREATE.FILE4  RFILE=C:\LOCAL.FILE.CREATE.FILE4

The following example queues a transfer to send multiple files to a remote node, substitutes the data after the high-level prefix defined, and tests the local files (LF) and the remote files (RF) that are queued:

    FUSSMFIL IPADDR=127.127.127.1 IPPORT=46464 LF=LOCAL.FILE.CRE* RF=C:\ACCT.%SUFFIX INTERVAL=3 SAY WAIT TEST

The output of this example is as follows:

    LFILE=LOCAL.FILE.CREATE.FILE1  RFILE=C:\acct.ATE.FILE1
    LFILE=LOCAL.FILE.CREATE.FILE2  RFILE=C:\acct.ATE.FILE2
    LFILE=LOCAL.FILE.CREATE.FILE3  RFILE=C:\acct.ATE.FILE3

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