Previous Topic: Remote File

Next Topic: Program Library


Remote File Substitution Character

Specifies a character that is used in a Remote File Name to establish a schema for generating a unique file name for each member involved in a partitioned data set (PDS) transfer. The unique file name is derived by replacing the substitution character in the Remote File Name schema with the PDS member names. CA XCOM Data Transport generates a separate transfer request for each selected PDS member. The PDS transferred members are selected from a member list. The list is displayed when a PDS name is entered without any member name in the Local File Name field. For information about how to select a PDS member from a member list, see Member Selection List in this chapter.

Example 1

Assume from the partitioned data set XCOM.PDS the members A, B and C are transferred to a PC destination where they are stored in the (remote) files C:\A.DAT, C:\B.DAT and C:\C.DAT. The at sign (@) is used as the remote file substitution character. Specify XCOM.PDS in the Local File Name field, @ in the Remote File Substitution Character field and C:\@.DAT as the file name schema in the Remote File Name field.

When the XCOM.PDS members have been selected from the member list, CA XCOM Data Transport generates the following transfer requests:

Local File Name

Remote File Name Schema and Substitution Character

Remote File Name

XCOM.PDS(A)

 

C:\A.DAT

XCOM.PDS(B)

 C:\@.DAT 

C:\B.DAT

XCOM.PDS(C)

 

C:\C.DAT

Example 2

In the following example, the schema for generating remote file names is based on a partitioned data set:

Local File Name

Remote File Name Schema and Substitution Character

Remote File Name

XCOM.PDS(A)

 

XCOM.PDS.OUT(A)

XCOM.PDS(B)

 XCOM.PDS.OUT(*) 

XCOM.PDS.OUT(B)

XCOM.PDS(C)

 

XCOM.PDS.OUT(C)

Note: If the remote file name schema contains multiple occurrences of the Remote File Substitution Character, only the first occurrence of the Substitution Character is used in the generation of Remote File Names.