Page History

Table of Contents

Summary

AlternativeFragments elements can be used in situations where:

• a specified - i.e. first choice - connection may not be available,
• where it is not acceptable to wait for the first choice connection and
• where alternative transfer configurations could be used.

Specifying Alternative Fragments

Alternative fragment elements are specified using either a ReadableAlternativeFragmentRef element or a WriteableAlternativeFragmentRef element, both readable fragment element or a writeable fragment element both of which are, respectively, children of the CopySourceFragmentRef or CopyTargetFragmentRef elements in the configuration Profiles branch.

...

• Profile
  • Operation
    
    • Copy
      • CopySource
        • CopySourceFragmentRef (specifies one of the following)
          • FTPFragmentRef
          • FTPSFragmentRef
          • etc.ReadableAlternativeFragmentRef 
        • AlternativeCopySourceFragmentRef (Has the ref Attribute attribute specifying the source ReadableAlternativeFragment fragmentsfragment)
      • CopyTarget
        
        • CopyTargetFragmentRef (specifies one of the following)
          • FTPFragmentRef
          • FTPSFragmentRef
          • etc.WriteableAlternativeFragmentRef
        • AlternativeCopyTargetFragmentRef (Has the ref Attribute attribute specifying the target WritableAlternativeFragment fragmentsfragment)

The ReadableAlternativeFragmentRef AlternativeCopySourceFragmentRef and WriteableAlternativeFragmentRef elements contain attributes that reference corresponding ReadableAlternativefragment and WriteableAlternativeFragment elements in the Fragments configuration branch.The ReadableAlternativeFragment and WriteableAlternativeFragment elements then contain two or more AlternativeCopyTargetFragmentRef elements then contain alternative fragment elements that will be tried in turn if the first one is not able to make a connection.

In the XML hierarchy this looks like:

...

.

...

...

• AltFTPFragmentRef (name = ....)
• AltFTPFragmentRef (name = ....)
• etc.

Note that the alternative fragment elements are themselves only references to named protocol fragment elements.The list above shows AltFTPFragmentRef elements - it is equally possible to specify elements with other protocols. A list of the Alt...FragmentRef elements available can be found in the parameter reference pages for ReadableAlternativeFragment and WriteableAlternativeFragment elements.

Further Information

Related Sections of this User Manual:

• YADE User Manual - Configuration Formats & Tools
• YADE User Manual - Configuring and Running File Transfers
  • YADE User Manual - Configuration 1 - An Overview
  • YADE User Manual - Configuration 2 - The Fragments Branch
    • JADE YADE User Manual - Configuring Alternative Fragments (this article)
      
  • JADE YADE User Manual - Configuration 3 - The Profile Branch