Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The File Transfer task allows you to execute file transfers on remote machines using any of the following protocols:

  • FTP
  • SFTP
  • UDM
  • FTPS
  • FTPES

To run a File Transfer task, you need Universal Agent for Linux/Unix, z/OS, or Windows to communicate with the File Transfer server. The Agent can, but does not have to be, running on the same machine as the File Transfer server.

...

When you create a File Transfer task, you select a file transfer protocol: FTP, SFTP, UDM, FTPS or FTPSFTPES

The File Transfer Task Exclude Protocols Universal Controller system property permits the exclusion of one or more, but not all, protocols from being selected (see the Transfer Protocol field, below.)

The order of precedence for selecting a default Transfer Protocol for a File Transfer task is UDM, SFTP, FTPS, FTPES, FTP.  The first of these protocols that is not specified in the File Transfer Task Exclude Protocols system property will be the default.

...

Make sure you have your private/public keys properly set up and working before you configure the Controller to use it. For example, to validate the keys, log into your destination server from your agent server using ssh.

Anchor
FTP/SFTP/FTPS/FTPES File Transfer Task Details
FTP/SFTP/FTPS/FTPES File Transfer Task Details
FTP/SFTP/FTPS/FTPES File Transfer Task Details

The following FTP/SFTP/FTPS File Transfer Task Details is for an existing FTP/SFTP/FTPS/FTPES File Transfer task.

Depending on the values that you enter / select for these fields, and whether or not the FTP/SFTP/FTPS/FTPES File Transfer task has ever been launched, more (or less) fields may display. See the field descriptions, below, for a description of all fields that may display in the FTP/SFTP/FTPS/FTPES File Transfer Task Details.
 

Anchor
FTP/SFTP/FTPS/FTPES File Transfer Task Details Field Descriptions
FTP/SFTP/FTPS/FTPES File Transfer Task Details Field Descriptions
FTP/SFTP/FTPS/FTPES File Transfer Task Details Field Descriptions

The following table describes the fields, buttons, and tabs that display in FTP/SFTP/FTPS File Transfer Task Details.

Field Name

Description

General

This section contains general information about the task.

Name

Include Page
UC69IL:Task NameUC69
IL:Task Name

Version

Include Page
UC69IL:VersionsUC69
IL:Versions

Description

Include Page
UC71xILx:SummaryUC71x
ILx:Summary

Member of Business Services

Include Page
UC70IL:Member of Business ServicesUC70
IL:Member of Business Services

Resolve Name Immediately

Include Page
UC69IL:Resolve Name ImmediatelyUC69
IL:Resolve Name Immediately

Time Zone Preference

Include Page
UC69IL:Time Zone PreferenceUC69
IL:Time Zone Preference

Hold on Start

Include Page
UC69IL:Hold on StartUC69
IL:Hold on Start

Hold Reason

Include Page
UC69IL:Hold ReasonUC69
IL:Hold Reason

Virtual Resource Priority

Include Page
UC69IL:Virtual Resource PriorityUC69
IL:Virtual Resource Priority

Anchor
Hold Resources on Failure
Hold Resources on Failure
Hold Resources on Failure

Include Page
UC69IL:Hold Resources on FailureUC69
IL:Hold Resources on Failure

Agent Details

This section contains assorted detailed information about the Agent / Agent Cluster selected for this task.

Anchor
Cluster
Cluster
Cluster

Include Page
UC69IL:ClusterUC69
IL:Cluster

Anchor
Agent
Agent
Agent

Include Page
UC69IL:Agent - 6.8.0.0UC69
IL:Agent - 6.8.0.0

Anchor
Agent Variable
Agent Variable
Agent Variable

Include Page
UC69IL:Agent VariableUC69
IL:Agent Variable

Anchor
Agent Cluster
Agent Cluster
Agent Cluster

Include Page
UC69IL:Agent Cluster - 6.8.0.0UC69
IL:Agent Cluster - 6.8.0.0

Anchor
Agent Cluster Variable
Agent Cluster Variable
Agent Cluster Variable

Include Page
UC69IL:Agent Cluster VariableUC69
IL:Agent Cluster Variable

Anchor
Broadcast
Broadcast
Broadcast

Include Page
UC69IL:BroadcastUC69
IL:Broadcast

Anchor
Cluster Broadcast
Cluster Broadcast
Cluster Broadcast

Include Page
UC69IL:Cluster BroadcastUC69
IL:Cluster Broadcast

Anchor
Cluster Broadcast Variable
Cluster Broadcast Variable
Cluster Broadcast Variable

Include Page
UC69IL:Cluster Broadcast VariableUC69
IL:Cluster Broadcast Variable

Anchor
Credentials
Credentials
Credentials

Include Page
UC69IL:Credentials field - U-FT-LU - 6.8.0.0UC69
IL:Credentials field - U-FT-LU - 6.8.0.0

Anchor
Credentials Variable
Credentials Variable
Credentials Variable

Include Page
UC69IL:Credentials VariableUC69
IL:Credentials Variable

File Transfer Details

This section contains assorted detailed information about the task.

Anchor
Transfer Protocol
Transfer Protocol
Transfer Protocol

Include Page
UC69IL:Transfer Protocol - 6.4.1UC69
IL:Transfer Protocol - 6.4.1

Anchor
FTP Command
FTP Command
Command

Include Page
UC69IL:Command-FTP SFTPUC69
IL:Command-FTP SFTP

Job Card (z/OS only)

Include Page
UC69IL:Job Card (zOS only)UC69
IL:Job Card (zOS only)

Subcommands (z/OS only)

Include Page
UC69IL:Subcommands (zOS only)UC69
IL:Subcommands (zOS only)

Transfer Type

Include Page
UC69IL:Transfer Type - FTP - 6.4.1UC69
IL:Transfer Type - FTP - 6.4.1

Transfer Mode

Include Page
UC69IL:Transfer Mode - FTP - 6.4.1UC69
IL:Transfer Mode - FTP - 6.4.1

Remote Server

Required if Transfer Protocol = FTP, SFTP or , FTPS, or FTPES; name or IP address of the File Transfer server. This machine may or may not be the same as the Agent machine.
 
You also can specify a non-standard FTP, SFTP, FTPS, or FTPS FTPES port: port number separated from the host name with a colon: "some.server.com:2222".

FTP Credentials

Include Page
UC69IL:FTP Credentials - 6.4.2.0UC69
IL:FTP Credentials - 6.4.2.0

FTP Credentials Variable

Include Page
UC69IL:FTP Credentials VariableUC69
IL:FTP Credentials Variable

Anchor
Local Filename
Local Filename
Local Filename

Include Page
UC70IL:Local FilenameUC70
IL:Local Filename

Anchor
Use Regular Expression
Use Regular Expression
Use Regular Expression

Enables the use of a regular expression in the Local Filename field.

Remote Filename

Include Page
UC70IL:Remote FilenameUC70
IL:Remote Filename

Move

Include Page
UC69IL:MoveUC69
IL:Move

Retry Options

This section contains specifications for retrying the task.

Anchor
Maximum Retries
Maximum Retries
Maximum Retries

Include Page
UC69IL:Maximum RetriesUC69
IL:Maximum Retries

Retry Indefinitely

Include Page
UC69IL:Retry IndefinitelyUC69
IL:Retry Indefinitely

Retry Interval (Seconds)

Include Page
UC69IL:Retry IntervalUC69
IL:Retry Interval

Suppress Intermediate Failures

Include Page
UC69IL:Suppress Intermediate FailuresUC69
IL:Suppress Intermediate Failures

Wait / Delay Options

This section contains specifications for waiting to start and/or delaying on start the task.

Anchor
Wait To Start
Wait To Start
Wait To Start

Include Page
UC69IL:Wait To Start - 6.2.1.0UC69
IL:Wait To Start - 6.2.1.0

Anchor
Wait Time
Wait Time
Wait Time

Include Page
UC69IL:Wait Time - 6.2.1.0UC69
IL:Wait Time - 6.2.1.0

Anchor
Wait Day Constraint
Wait Day Constraint
Wait Day Constraint

Include Page
UC69IL:Wait Day ConstraintUC69
IL:Wait Day Constraint

Anchor
Wait Duration
Wait Duration
Wait Duration

Include Page
UC69IL:Wait DurationUC69
IL:Wait Duration

Anchor
Wait Duration In Seconds
Wait Duration In Seconds
Wait Duration In Seconds

Include Page
UC69IL:Wait Duration In SecondsUC69
IL:Wait Duration In Seconds

Anchor
Delay On Start
Delay On Start
Delay On Start

Include Page
UC69IL:Delay On StartUC69
IL:Delay On Start

Anchor
Delay Duration
Delay Duration
Delay Duration

Include Page
UC69IL:Delay DurationUC69
IL:Delay Duration

Anchor
Delay Duration In Seconds
Delay Duration In Seconds
Delay Duration In Seconds

Include Page
UC69IL:Delay Duration In SecondsUC69
IL:Delay Duration In Seconds

Anchor
Workflow Only
Workflow Only
Workflow Only

Include Page
UC69IL:Workflow OnlyUC69
IL:Workflow Only

Time Options

This section contains time-related specifications for the task.

Anchor
Late Start
Late Start
Late Start

Include Page
UC69IL:Late StartUC69
IL:Late Start

Anchor
Late Start Type
Late Start Type
Late Start Type

Include Page
UC69IL:Late Start TypeUC69
IL:Late Start Type

Anchor
Late Start Time
Late Start Time
Late Start Time

Include Page
UC69IL:Late Start TimeUC69
IL:Late Start Time

Anchor
Late Start Day Constraint
Late Start Day Constraint
Late Start Day Constraint

Include Page
UC69IL:Late Start Day ConstraintUC69
IL:Late Start Day Constraint

Anchor
Late Start Nth Amount
Late Start Nth Amount
Late Start Nth Amount

Include Page
UC69IL:Late Start Nth AmountUC69
IL:Late Start Nth Amount

Anchor
Late Start Duration
Late Start Duration
Late Start Duration

Include Page
UC69IL:Late Start Duration - NEWUC69
IL:Late Start Duration - NEW

Anchor
Late Finish
Late Finish
Late Finish

Include Page
UC69IL:Late FinishUC69
IL:Late Finish

Anchor
Late Finish Type
Late Finish Type
Late Finish Type

Include Page
UC69IL:Late Finish TypeUC69
IL:Late Finish Type

Anchor
Late Finish Offset Type
Late Finish Offset Type
Late Finish Offset Type

Include Page
UC69IL:Late Finish Offset TypeUC69
IL:Late Finish Offset Type

Anchor
Late Finish Percentage Offset ( + )
Late Finish Percentage Offset ( + )
Late Finish Percentage Offset ( + )

Include Page
UC69IL:Late Finish Percentage Offset ( + )UC69
IL:Late Finish Percentage Offset ( + )

Anchor
Late Finish Duration Offset ( + )
Late Finish Duration Offset ( + )
Late Finish Duration Offset ( + )

Include Page
UC69IL:Late Finish Duration Offset ( + )UC69
IL:Late Finish Duration Offset ( + )

Anchor
Late Finish Duration Offset Unit
Late Finish Duration Offset Unit
Late Finish Duration Offset Unit

Include Page
UC69IL:Late Finish Duration Offset UnitUC69
IL:Late Finish Duration Offset Unit

Anchor
Late Finish Time
Late Finish Time
Late Finish Time

Include Page
UC69IL:Late Finish TimeUC69
IL:Late Finish Time

Anchor
Late Finish Day Constraint
Late Finish Day Constraint
Late Finish Day Constraint

Include Page
UC69IL:Late Finish Day ConstraintUC69
IL:Late Finish Day Constraint

Anchor
Late Finish Nth Amount
Late Finish Nth Amount
Late Finish Nth Amount

Include Page
UC69IL:Late Finish Nth AmountUC69
IL:Late Finish Nth Amount

Anchor
Late Finish Duration
Late Finish Duration
Late Finish Duration

Include Page
UC69IL:Late Finish Duration - NEWUC69
IL:Late Finish Duration - NEW

Anchor
Early Finish
Early Finish
Early Finish

Include Page
UC69IL:Early FinishUC69
IL:Early Finish

Anchor
Early Finish Type
Early Finish Type
Early Finish Type

Include Page
UC69IL:Early Finish TypeUC69
IL:Early Finish Type

Anchor
Early Finish Offset Type
Early Finish Offset Type
Early Finish Offset Type

Include Page
UC69IL:Early Finish Offset TypeUC69
IL:Early Finish Offset Type

Anchor
Early Finish Percentage Offset ( - )
Early Finish Percentage Offset ( - )
Early Finish Percentage Offset ( - )

Include Page
UC69IL:Early Finish Percentage Offset ( - )UC69
IL:Early Finish Percentage Offset ( - )

Anchor
Early Finish Duration Offset ( - )
Early Finish Duration Offset ( - )
Early Finish Duration Offset ( - )

Include Page
UC69IL:Early Finish Duration Offset ( - )UC69
IL:Early Finish Duration Offset ( - )

Anchor
Early Finish Duration Offset Unit
Early Finish Duration Offset Unit
Early Finish Duration Offset Unit

Include Page
UC69IL:Early Finish Duration Offset UnitUC69
IL:Early Finish Duration Offset Unit

Anchor
Early Finish Time
Early Finish Time
Early Finish Time

Include Page
UC69IL:Early Finish TimeUC69
IL:Early Finish Time

Anchor
Early Finish Day Constraint
Early Finish Day Constraint
Early Finish Day Constraint

Include Page
UC69IL:Early Finish Day ConstraintUC69
IL:Early Finish Day Constraint

Anchor
Early Finish Nth Amount
Early Finish Nth Amount
Early Finish Nth Amount

Include Page
UC69IL:Early Finish Nth AmountUC69
IL:Early Finish Nth Amount

Anchor
Early Finish Duration
Early Finish Duration
Early Finish Duration

Include Page
UC69IL:Early Finish Duration - NEWUC69
IL:Early Finish Duration - NEW

Anchor
User Estimated Duration
User Estimated Duration
User Estimated Duration

Include Page
UC69IL:User Estimated DurationUC69
IL:User Estimated Duration

Critical Path Options

This section contains Critical Path-related specifications for the task.

Anchor
CP Duration
CP Duration
CP Duration

Include Page
UC69IL:CP DurationUC69
IL:CP Duration

Anchor
CP Duration (Resolved)
CP Duration (Resolved)
CP Duration (Resolved)

Include Page
UC69IL:CP Duration (Resolved)UC69
IL:CP Duration (Resolved)

Anchor
CP Duration Unit
CP Duration Unit
CP Duration Unit

Include Page
UC69IL:CP Duration UnitUC69
IL:CP Duration Unit

Workflow Execution Options

This section contains Execution Restriction specifications for the task if it is within a Workflow.

Anchor
Execution Restriction
Execution Restriction
Execution Restriction

Include Page
UC69IL:Execution RestrictionUC69
IL:Execution Restriction

Anchor
Restriction Period
Restriction Period
Restriction Period

Include Page
UC69IL:Restriction PeriodUC69
IL:Restriction Period

Anchor
Before Date
Before Date
Before Date

Include Page
UC69IL:Before DateUC69
IL:Before Date

Anchor
Before Time
Before Time
Before Time

Include Page
UC69IL:Before TimeUC69
IL:Before Time

Anchor
After Date
After Date
After Date

Include Page
UC69IL:After DateUC69
IL:After Date

Anchor
After Time
After Time
After Time

Include Page
UC69IL:After TimeUC69
IL:After Time

Anchor
Date List
Date List
Date List

Include Page
UC69IL:Date ListUC69
IL:Date List

Statistics

This section contains time-related statistics for task instances of the task.

First Execution

Include Page
UC71xIL:First ExecutionUC71x
IL:First Execution

Last Execution

Include Page
UC71xIL:Last ExecutionUC71x
IL:Last Execution

Last Instance Duration

Include Page
UC69IL:Last Instance DurationUC69
IL:Last Instance Duration

Lowest Instance Time

Include Page
UC69IL:Lowest Instance TimeUC69
IL:Lowest Instance Time

Average Instance Time

Include Page
UC69IL:Average Instance TimeUC69
IL:Average Instance Time

Highest Instance Time

Include Page
UC69IL:Highest Instance TimeUC69
IL:Highest Instance Time

Number of Instances

Include Page
UC69IL:Number of InstancesUC69
IL:Number of Instances

Metadata

This section contains Metadata information about this record.

UUID

Universally Unique Identifier of this record.

Updated By

Name of the user that last updated this record.

Updated

Date and time that this record was last updated.

Created By

Name of the user that created this record.

Created

Date and time that this record was created.

Buttons

This section identifies the buttons displayed above and below the Task Details that let you perform various actions.

Save

Saves a new task record in the Controller database.

Save & New

Saves a new record in the Controller database and redisplays empty Details so that you can create another new record.

Save & View

Saves a new record in the Controller database and continues to display that record.

New

Displays empty (except for default values) Details for creating a new task.

Update

Include Page
UC69IL:Update buttonUC69
IL:Update button

Launch Task

Include Page
UC69IL:Launch Task buttonUC69
IL:Launch Task button

View Parents

Include Page
UC69IL:View Parents buttonUC69
IL:View Parents button

Copy

Creates a copy of this task, which you are prompted to rename.

Delete

Include Page
UC69IL:Delete buttonUC69
IL:Delete button

Note
titleNote

You cannot delete a task if it is either:

  • Specified in an enabled Trigger.
  • The only task specified in a disabled Trigger.

Refresh

Refreshes any dynamic data displayed in the Details.

Close

For pop-up view only; closes the pop-up view of this task.

Tabs

This section identifies the tabs across the top of the Task Details that provide access to additional information about the task.

Variables

Include Page
UC69IL:Variables tabUC69
IL:Variables tab

Actions

Include Page
UC69IL:Actions tabUC69
IL:Actions tab

Virtual Resources

Include Page
UC69IL:Task Virtual Resources tab - 6.7.0.0UC69
IL:Task Virtual Resources tab - 6.7.0.0

Mutually Exclusive

Include Page
UC69IL:Mutually Exclusive Tasks tabUC69
IL:Mutually Exclusive Tasks tab

Anchor
Instances tab
Instances tab
Instances

Lists all instances of the task.

Triggers

Include Page
UC69IL:Triggers tabUC69
IL:Triggers tab

Notes

Include Page
UC69IL:Notes tabUC69
IL:Notes tab

Anchor
Versions tab
Versions tab
Versions

Include Page
UC69IL:Versions tabUC69
IL:Versions tab

Anchor
UDM File Transfer Task Details
UDM File Transfer Task Details
UDM File Transfer Task Details

...