The Batch Interface › SYSIN01 Parameters › General SYSIN01 Parameters › LFILE

LFILE

Identifies the local data set involved in a file transfer.

1 to 54 characters (for a non-USS file)

Specifies the non-USS local data set involved in a file transfer. This can be the name of a file copied to a remote system or the file name of a data set received from a remote system. Alternatively, the local data set name can be specified using the LCLDS01 DD statement. If both are specified, the data set defined by LFILE takes precedence.

Specifies up to 54 characters consisting of the following:

• A 1‑ to 44-character data set name
• An optional member name enclosed in parentheses

Note: A wildcard character (*) can be used if transferring between IBM mainframe systems.

Notes:

• Use an asterisk as the member name to show that all members of a partitioned data set are to be transferred.

  For example, the statement LFILE=PAYROLL.PDS(*) indicates that all members of the PAYROLL partitioned data set are to be transferred.

• Use the prefix followed by an asterisk if all members beginning with a specific prefix are to be transferred. For example, NAMES.PDS(AL*) requests that members AL, ALEX, and ALICE are all to be transferred. The asterisk must be the last character before the right parenthesis.
• The use of wildcards (*) is supported only between IBM mainframe systems and platforms running CA XCOM Data Transport Version 3.1, r11, r11.5 or r11.6.

1 to 255 characters (for a USS file)

Specifies the USS local data set involved in a file transfer. This can be the name of a file copied to a remote system or the file name of a data set received from a remote system. Alternatively, the local data set name can be specified using the LCLDS01 DD statement. If both are specified, the data set defined by LFILE takes precedence.

Specifies up to 255 characters consisting of the following:

• / (the first character of the data set name)
• A 1‑ to 254-character data set name

Notes:

• One or more wildcard characters (*) can be used if transferring to IBM mainframe systems, to Windows systems, or to UNIX systems.
• The transfer of USS files is supported only between systems running CA XCOM Data Transport r11.5 and above.

USS Examples

LFILE=/u/users/xcom/*

Transfer ALL files.

LFILE=/u/users/xcom/m*

Transfer ALL files starting with an m.

LFILE=/u/users/xcom/*m

Transfer ALL files ending with an m.

LFILE=/u/users/xcom/m*m

Transfer ALL files starting with an m and ending with an m.

LFILE=/u/users/xcom/m*y*m

Transfer ALL files starting with an m, ending with an m and containing a y.

LFILE=/u/users/xcom/m*you*

Transfer ALL files starting with an m and containing the characters you in succession.

LFILE=/u/users/xcom/m*y*o*u*

Transfer ALL files starting with an m and containing the characters y and o and u (in order, but not in succession).

Note: You can use symbolic variables with this parameter in batch SYSIN01. For more information, see Symbolic Parameters.