Send a file

How to use the SEND FILE command

This section describes how to use the SEND command to perform a file transfer. It begins with the simple examples and builds in complexity. However, there are many Transfer CFT parameters that can help you customize your flows, which are described in feature specific topics. Examples in this page are divided into the following umbrella categories:

• Use or override default values
• Use file name parameters
• Use scheduling features
• Execute pre and post transfer activities
• Use visibility features to link an application to a transfer
• Miscellaneous send features

Use or override default values

Send a file using only the partner definition

You can perform a basic SEND command by specifying only the partner. In this case, the IDF (model file) in the partner definition is used by default. If the partner definition does not include an IDF, the global default model file value is used.

In this example, the store1 partner values including the dailysales (IDF) are used.

Override the model file default values

You can create your own model files to use with an existing partner. When specified in the send command, the new model file overrides the partner and global default model file value.

Override the model file values

Using additional send command parameters, such as the file name, you can override values in the model file.

Blocking the override functionality

In some cases you may not want to allow the model file values to be overridden. To block the override functionality set the force parameter to yes. In this example, the fname=oldfile and not newfile is used.

Use file name parameters

There are several ways for you to provide the file name in the SEND command to achieve the actions described in this section, such as sending files based on a list.

Send a file using only the file name

Send a group of files

Send files that are recorded in a list

Use the appropriate indirection character (@ or #) to send all files that are listed in a specified file. Add the indirection character at the beginning of the complete file name, including path as shown in the following syntax.

For more information, see Use an indirection file.

Send files that match a mask

You can use mask characters to send groups of files by adding either the ? character to indicate one character, or the * to indicate multiple characters. Be sure to prefix the file name with the appropriate indirection character.

Reference a folder

Specify the folder name and add the indirection character to send all files that are contained in a folder, where daily_reports is a folder.

Send a list of the folder contents

This section describes how to send a list of files that are contained in a folder or folders. Note that it does not send the files themselves.

Use the folder name

If you specify only the folder name, this sends a list of the files contained in the folder.

Use file or folder name plus a mask

Add a mask character to the file or folder name to send a list of the files contained in the folder.

How to define the remote file name

Use the network file name

Use the NFNAME, network file name, to indicate the remote file name to be downloaded on the remote side. This feature is available only in open mode, as described in Read transfer implicit send open mode.

Use selfname

You can use the selfname option to send only certain files from a given folder to a particular partner. Begin by creating a file that lists the specific files to send, where you use only the relative name.

Using the send command, include the selfname parameter, which is the name of the file you created. You then use the name of the folder containing the files (preceded by the indirection character) as the fname.

Example

In this example, the report_folder contains the following files A1, A2, A3, B1, and B2, and the report_limited file lists A1 and B1.

Using the syntax in this example, only the files A1 and B1 are transferred.

See SELFNAME.

Use scheduling features

Trigger a send according to the transfer status

You can use the send command with STATE parameters so that the send occurs once the transfer has a predefined status.

Perform a send at a specific time

You can use the mintime and mindate parameters to schedule a transfer for a given date and time. These can be relative or absolute values; for more information see Delayed transfers in Transfer scheduling.

How to define a periodic send

You can use the cycle and tcycle parameters to define a periodic send. See Cyclic transfer requests.

Define a send based on a transfer timeout

You can define that beyond a specified time in minutes, the transfer is canceled. See also maxduration.

See also Transfer scheduling.

Send a group of files in a single transfer

Prerequisites

• You can only use this mode between Transfer CFTs running the same platforms (Windows to Windows, for example)
• Set the uconf cft.server.force_heterogeneous_mode parameter value to yes if not already done
• Use the group of files syntax

Use the fname and wfname parameters to use this mode, also referred to as homogeneous mode.

See also WFNAME.

Execute pre and post transfer activities

For details transfer activities and scheduling, see Processing execution policy.

How to trigger pre execution scripts

How to trigger post execution scripts

How to trigger a script when a transfer fails

See Transfer error procedures for more information.

Use visibility features to link an application to a transfer

When using visibility features to link an application to a transfer, or to link a transfer to other transfers, you can use the appobjid and the appcycid parameters. These parameters refer to tracked object and the cycle id.

Miscellaneous send features

How to override defined transfer routing

Use the ipart parameter to override either the default or defined routing partner in the partner definition.

See also Store and forward.

How to toggle the protocol used for a send

In the partner definition create a choice of protocols, for example prot=(nossl, ssl), sap=(1761, 1762). Use the PROT parameter with the SEND command to indicate for that particular transfer it should use the specified protocol.

How to provide passwords when required by the remote partner

You must provide both the user and corresponding password in send command as defined on the remote partner in the receive file template.

Wait for a synchronous transfer to complete before continuing

After configuring the synchronous communication, add the wstate and wtimeout to the send command.

How to send additional information to the remote partner

Use the following parameters to further refine the send command and provide more information to the remote partner concerning a transfer

• parm = a free parameter that allows you to add information to send with your transfer (512 characters)
• sappl, rappl = send information about the applications sending the transfer
• suser, ruser = send information related to the transfer users