Transfer File

Function:

Transfers contents of one file or data stream into another. Source and target can be located on different platforms. Mass processing is supported.

The target file is created automatically if it does not already exist, as long as the parent exists. By default, if a file already exists its contents is overwritten. You can customize this behavior using the Existing Resource Handling attribute.

Note: If the target file of the tool "Transfer File" is an MVS data set, it is not checked if an enqueue is set on the data set before it is overwritten. The tool "Transfer File" does not set an enqueue before overwriting the data set content.

If the target file of the tool "Transfer File" is of type MVS_SEQ the sequential MVS data set must already exist. The creation of a new sequential MVS data set is not supported by the tool.

Attributes:

Attribute	Type	Description
Existing Resource Handling	Selection	Specifies how to handle conflicts with existing target resources. Possible values: Replace Replace any existing target files. Ignore Leave existing target files untouched. Error Produce an error if at least one target file already exists and in this case does not transfer any file in a mass processing action. The error cancels the current AWM action. From Parameter The value for Existing Resource Handling must be specified by an input parameter. Default value: Replace

Attribute

Type

Description

Existing Resource Handling

Selection

Specifies how to handle conflicts with existing target resources.

Possible values:

Replace: Replace any existing target files.
Ignore: Leave existing target files untouched.
Error: Produce an error if at least one target file already exists and in this case does not transfer any file in a mass processing action.
The error cancels the current AWM action.
From Parameter: The value for Existing Resource Handling must be specified by an input parameter.

Default value: Replace

Parameter Name	I/O	Type	Description
Source File [M]	I	File	References the source of the file transfer.
Target File [M]	I	File	References the target file of the file transfer.
Existing Resource Handling [O]	I	String	Specifies how to handle conflicts with existing target resources. Must be one of the following values: Replace Ignore Error The parameter is only available if the attribute Existing Resource Processing is set to From Parameter. See attribute description for more details.

Parameter Name

I/O

Type

Description

Source File [M]

File

References the source of the file transfer.

Target File [M]

File

References the target file of the file transfer.

Existing Resource Handling [O]

String

Specifies how to handle conflicts with existing target resources. Must be one of the following values:

Replace
Ignore
Error

The parameter is only available if the attribute Existing Resource Processing is set to From Parameter. See attribute description for more details.

The following combinations of input parameters with the Mass Processing attribute set to true or false are supported:

Source File "Mass Processing"	Target File "Mass Processing"	Behavior
true	true	Mass transfer of all files. If the tool is called from a non-mass processing action only a single file is transferred.
false	true	Only a single file is transferred.
true	false	Not supported
false	false	The single source file is transferred to multiple target files. The target files receive all the same content.