Product Knowledge Base

Space shortcuts

Page tree

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

Summary

AlternativeFragments elements are 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 of which are, respectively, children of the CopySourceFragmentRef or CopyTargetFragmentRef elements in the configuration Profiles branch.

Readable... elements are used where only read permissions are required - i.e. for transfer sources, Writable... elements are used where a file is to be written - i.e. for transfer targets and for transfer sources where the file to be transfered is modified before being transferred. Note that this can be where pre-processing is involved.

In the XML hierarchy this looks like:

  • Profile
    • Operation
      • Copy
        • CopySource
          • CopySourceFragmentRef (one of the following)
            • FTPFragmentRef
            • FTPSFragmentRef
            • etc.
            • ReadableAlternativeFragmentRef (Has the ref Attribute specifying the source ReadableAlternativeFragment fragments)
        • CopyTarget
          • CopyTargetFragmentRef (one of the following)
            • FTPFragmentRef
            • FTPSFragmentRef
            • etc.
            • WriteableAlternativeFragmentRef

The ReadableAlternativeFragmentRef 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 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:

  • Fragments
    • ProtocolFragments
    • AlternativeFragments
      • ReadableAlternativefragment
        • AltFTPFragmentRef (name = ....)
        • AltFTPFragmentRef (name = ....)
        • etc.
      • WriteableAlternativeFragment 
        • 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:

 

  • No labels