The Menu Interface › Receive File from Another System Menu (XCICRFIL) › Parameter Fields › Remote Dataset Name

Remote Dataset Name

Indicates the name of the remote system data set being received. A maximum of 54 characters is allowed. If the file name is longer, enter only a plus (+) sign in the first position of this field. When you enter this value and complete all the fields of the screen, the Extended Length File Names menu is displayed. This screen accepts file names of up to 256 characters. For more information, see Extended Length File Names Menu (XCICEDSN) in this chapter.

Note: In the Digital Equipment Corp. VAX/VMS environment, brackets ([ ]) are used to indicate the directory in a complete file name specification. However, some EBCDIC environment keyboards do not provide brackets. In such cases, use braces ({ }) instead because CA XCOM Data Transport‑VAX converts the braces to brackets.

Up to 54 alphanumeric characters (for a non-USS file)

Indicates the name of the local data set being transferred. A maximum of 54 characters is allowed. These 54 characters consist of the following:

• A 1‑ to 44-character data set name
• An optional member name or relative generation data groups (GDG) data set level enclosed in parentheses

Notes:

• Use an asterisk to send multiple members of a partitioned data set. Specifying an asterisk for the member name sends all members of a PDS, for example, SURVEYS(*). To send to all members beginning with a specific prefix, specify this prefix followed by an asterisk. For example, NAMES.PDS(AL*) requests that members AL, ALEX, and ALICE all be transferred. Note that the asterisk must be the last character before the right parenthesis.
• If no member name is entered for a partitioned data set, a Member Selection List panel is displayed, allowing the selection of one or more members for transfer. For more information, see Remote File Name and Member Selection List in this chapter.

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 USS files (*) is supported only between systems running CA XCOM Data Transport r11.5.

Non-USS Examples

SURVEYS(*)

Transfer all members of the PDS.

NAMES.PDS(AL*)

Transfer all members of the PDS beginning with the prefix AL (for example, AL, ALEX, and ALICE).

Note: The asterisk must be the last character before the right parenthesis.

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).

Default: The last entered remote data set name