This topic describes the configuration parameters for the BatchFTP OTD, accessed from the Connectivity Map.
The BatchFTP Connectivity Map properties include these sections:
General Settings (BatchFTP Connectivity Map).
Several of these configuration options allow you to use regular expressions. This advanced feature is useful but must be used carefully. An improperly formed regular expression can cause the creation of undesired data or even the loss of data. You must have a clear understanding of regular-expression syntax and construction before attempting to use this feature. It is recommended that you test such configurations thoroughly before moving them to production.
Pre-transfer operations are those performed before the file transfer.
The Pre Transfer section of the BatchFTP Connectivity Map properties contains the top-level parameters displayed in this table.
Table 12 Connectivity Map - BatchFTP - Pre Transfer
Where to Go Next
For information on Batch FTP SOCKS configuration, go to SOCKS (BatchFTP Connectivity Map).
More Information
About Configuring Java CAPS Adapter Connectivity Map Properties
Configuring Java CAPS Project Components for Communication Adapters
Related Topics
For links to the other topics for this Adapter, go to Related Topics for Sun Adapter for Batch/FTP.
The BatchFTP SOCKS supports two negotiation methods: NO-AUTHENTICATION and USER/PASSWORD.
The SOCKS section of the BatchFTP Connectivity Map properties contains the top-level parameters displayed in this table.
Table 13 Connectivity Map - BatchFTP - SOCKS
Where to Go Next
SOCKS (BatchFTP Connectivity Map).
More Information
About Configuring Java CAPS Adapter Connectivity Map Properties
Configuring Java CAPS Project Components for Communication Adapters
Related Topics
For links to the other topics for this Adapter, go to Related Topics for Sun Adapter for Batch/FTP.
The FTP section of the BatchFTP Connectivity Map properties contains the top-level parameters displayed in this table.
Table 14 Connectivity Map - BatchFTP - Pre Transfer
Name |
Description |
Required Value |
---|---|---|
Allows you to set the timeout of the FTP command/control connection socket. Normally, the larger the file you are transferring, the higher this value must be. Of course, the quality of the network connection also affects this setting. The value is in milliseconds. A timeout of zero is interpreted as an infinite timeout. |
An integer from 0 to 2147483647. The configured default is 45000. |
|
Allows you to set the timeout of the FTP data connection socket. Normally, a slow or busy network connection requires a higher timeout setting. The value is in milliseconds. A timeout of zero is interpreted as an infinite timeout. For setting the timeout of the command/control connection socket, see the parameter Command Connection Timeout. |
An integer from 0 to 2147483647. The configured default is 45000. |
|
Specifies the system that reflects the remote host. This parameter is used to determine the format in which the LIST command returns file-listing information. The Directory Listing Style values include User Defined1 - User Defined10 values. These user defined properties allow you to create multiple user-defined FTP heuristic configurations, and make these selectable from the BatchFTP adapter properties. You can create corresponding heuristic configurations in the FtpHeuristics.cfg file under the User Defined sections. For more information on setting user defined FTP heuristic properties, see To Modify the FTP Heuristics Configuration File. Note – This property is superseded by any value specified in the User Defined Directory Listing Style property (see the User Defined Directory Listing Style property). The User Defined Directory Listing Style property value must be blank (empty) to enable the Directory Listing Style property. |
One of the following values,
|
|
Specifies the name of a user-defined directory listing style (heuristics) that is available in the user-created FTP heuristics configuration file located on the Application Server. This property works in conjunction with the Directory Listing Style and User Defined Heuristics Configuration File properties. For details on how to use the User Defined Directory Listing Style see To Create a Custom Heuristics Configuration File. Note – The BatchFTP OTD will generate an exception if a selected User Defined Directory Listing Style or the User Defined Heuristics Configuration File path is not defined correctly. If a User Defined Directory Listing Style is specified, a corresponding value must also be provided for the User Defined Heuristics Configuration File property. |
A text string value (default to blank) representing the directory listing style (heuristics) name which is defined in a user supplied heuristics configuration file. |
|
Allows you to prompt the adapter to enter either the passive or active mode. Normally, when you connect to an FTP site, the site establishes the data connection to your computer. However, some FTP sites allow passive transfers, meaning that your computer establishes the data connection. By default, the passive mode is used. It is recommended that you use this mode for transfers to and from FTP sites that support it. The passive mode can be required in the following situations:
|
Select Yes or No. The configured default is Yes. |
|
Specifies the mode used to transfer data to or from the FTP server, using the ASCII, Binary, or EBCDIC mode. If you choose Ebcdic, make sure of the following:
|
Select ASCII, Binary, or EBCDIC. The configured default is Binary. |
Where to Go Next
FTP Raw Commands (BatchFTP Connectivity Map).
More Information
About Configuring Java CAPS Adapter Connectivity Map Properties
Configuring Java CAPS Project Components for Communication Adapters
Related Topics
For links to the other topics for this Adapter, go to Related Topics for Sun Adapter for Batch/FTP.
FTP raw commands are commands that are sent directly to the FTP server.
The FTP Raw Commands section of the BatchFTP Connectivity Map properties contains the top-level parameters displayed in this table.
Table 15 Connectivity Map - BatchFTP - FTP Raw Commands
Where to Go Next
Sequence Numbering (BatchFTP Connectivity Map).
More Information
About Configuring Java CAPS Adapter Connectivity Map Properties
Configuring Java CAPS Project Components for Communication Adapters
Related Topics
For links to the other topics for this Adapter, go to Related Topics for Sun Adapter for Batch/FTP.
The Sequence Numbering section of the BatchFTP Connectivity Map properties contains the top-level parameters displayed in this table:
The Synchronized property, under General Settings, must be set to Yes to use Sequence Numbering.
Name |
Description |
Required Value |
---|---|---|
Use this parameter when you have set up the target directory or file name to contain a sequence number. It tells the adapter that when this value (the Max Sequence Number) is reached, to reset the sequence number to the Starting Sequence Number value. This parameter is used for the name pattern %#. |
An integer from 1 to 2147483647. The value of Max Sequence Number must be greater than that of Starting Sequence Number. |
|
Use this parameter when you have set up the target directory or file name to contain a sequence number. It tells the adapter which value to start with in the absence of a sequence number from the previous run. This parameter is used for the name pattern %#. When the Max Sequence Number value is reached, the sequence number rolls over to the Starting Sequence Number value. |
An integer from 0 to 2147483647. The value of the Starting Sequence Number must be less than the Max Sequence Number value. |
Where to Go Next
Post Transfer (BatchFTP Connectivity Map).
More Information
About Configuring Java CAPS Adapter Connectivity Map Properties
Configuring Java CAPS Project Components for Communication Adapters
Related Topics
For links to the other topics for this Adapter, go to Related Topics for Sun Adapter for Batch/FTP.
Post-transfer operations are those performed on remote (ftp) site after the real ftp transfer.
The Post Transfer section of the BatchFTP Connectivity Map properties contains the top-level parameters displayed in this table:
Table 17 Connectivity Map - BatchFTP - Post Transfer
Name |
Description |
Required Value |
---|---|---|
Specifies the directory name (path) on the external system to which a file is renamed. The value can be a literal or pattern name. For an outbound transfer (to destination), the directory is created if it does not already exist. This setting is only for the Rename operation of the Post Transfer Command parameter. Special characters are allowed, for example, the pattern %f indicates the original working directory name. The expansion of any special characters is carried out each time this parameter is used. See Post Directory Name Is Pattern property. |
Enter the exact name of the directory (with the path), enter a pattern name, or select one of the following values,
|
|
Specifies whether the pattern entered for the directory represents a literal or a name pattern, as follows,
|
Select Yes or No. The configured default is Yes. |
|
Specifies the file name to which a file on an external system is renamed. The value represents the file name. The value can be a literal, or pattern name. This setting is only for Rename operation of Post Transfer Command parameter. Special characters are allowed. For example, the pattern %f indicates the original working file name. See Post Directory Name Is Pattern property. |
Enter the exact name of the file, enter a pattern name, or select one of the following values,
|
|
Specifies whether the pattern entered for the file name is interpreted as literal or as a name pattern , as follows,
|
Select Yes or No. The configured default is Yes |
|
Allows you to execute a desired action directly after the actual file transfer or during the commit phase. For an inbound transfer, you can mark the transferred file as consumed by making an automatic backup (Rename) or by destroying it permanently (Delete). For an outbound transfer, you can make the transferred file available to other clients by renaming it. The options are,
|
Select Rename, Delete, or None. The configured default is None. |
Where to Go Next
Target Location (BatchFTP Connectivity Map).
More Information
About Configuring Java CAPS Adapter Connectivity Map Properties
Configuring Java CAPS Project Components for Communication Adapters
Related Topics
For links to the other topics for this Adapter, go to Related Topics for Sun Adapter for Batch/FTP.
The Target Location section allows you to configure the parameters for the Target Location (remote location) of the FTP directories and files.
The Target Location section of the BatchFTP Connectivity Map properties contains the top-level parameters displayed in this table:
Table 18 Connectivity Map - BatchFTP - Target Location
Name |
Description |
Required Value |
---|---|---|
Specifies whether to overwrite or append the data to the existing file. Use this parameter for outbound FTP transfers only. Choose the appropriate setting as follows,
|
Select Yes or No. The configured default is No. |
|
Specifies the directory on the external system from which files are retrieved or sent. The directory name and path is preferred, otherwise, the path is relative to your home directory when you log on to the FTP server. The value can be a literal, regular expression (source), or pattern name (destination). For outbound FTP operations (destination), the directory is created if it does not already exist. See Target Directory Name Is Pattern property. |
A directory name and path on the target external system. |
|
Specifies whether the directory name is represented as literal, or as a regular expression or name pattern, as follows,
|
Select Yes or No. The configured default is No. |
|
Specifies the name of the remote FTP file to be retrieved or sent. The value can be a literal, regular expression (get), or pattern name (put). For MVS GDG systems, the target file name can be the version of the data set, for example,
|
For inbound: a literal file name or a regular expression. For outbound: a literal file name or name pattern. |
|
Specifies whether the target file name represents a literal, or as a regular expression or name pattern, as follows,
|
Select Yes or No. The configured default is Yes. |
Where to Go Next
SSH Tunneling (BatchFTP Connectivity Map).
More Information
About Configuring Java CAPS Adapter Connectivity Map Properties
Configuring Java CAPS Project Components for Communication Adapters
Related Topics
For links to the other topics for this Adapter, go to Related Topics for Sun Adapter for Batch/FTP.
The SSH Tunneling section provides information for configuring the SSH Tunneling properties. If Secure FTP (FTP over SSH or FTP over SSL) is required, use the Secure FTP OTDs (BatchFTPOverSSL, BatchSFTP, and BatchSCP).
The SSH Tunneling section of the BatchFTP Connectivity Map properties contains the top-level parameters displayed in this table:
Table 19 Connectivity Map - BatchFTP - SSH Tunneling
Name |
Description |
Required Value |
---|---|---|
Specifies whether the adapter needs to launch an SSH subprocess. Selecting No indicates that the SSH channel has not yet been established. The adapter spawns a subprocess internally then establishes the channel on your behalf. If you select No, you must set the following parameters,
|
Select Yes or No. The configured default is No. |
|
Specifies the command line used to establish an SSH channel. This parameter is required only when you set the SSH Channel Established parameter to No. This entry must be the complete, correct command line required by the additional software application you are using to support SSH tunneling. This command line is executed as it is, so you must be sure of the following,
|
A valid SSH command line. |
|
The command-line syntax can differ, depending on the type of SSH client implementation you are using. See your SSH-tunneling support software user documentation for details. For example, ssh -L 3456:ftp.sun.com:21 -o BatchMode=yes apple ssh -L 4567:apple:21 -o BatchMode=yes apple ssh -L 5678:orange:21 -o BatchMode=yes apple ssh -L 6789:orange:21 -g -o BatchMode=yes apple plink -L 4567:apple:21 apple plink -L 5678:orange:21 apple plink -L 6789:orange:21 -g apple | ||
Specifies whether the FTP command connection is secured through an SSH tunnel. If you choose No, all other parameters in this section are ignored. Note – If you want to use the SSH port-forwarding feature, you may need to reconfigure your FTP server, depending on what kind of server you are using and how it is currently configured. |
Select Yes or No. The configured default is No. |
The adapter’s SSH tunneling (also known as port forwarding) feature utilizes additional existing SSH-supporting software applications, for example, Plink on Windows or OpenSSH on UNIX (see Additional Software Requirements).
For different SSH client implementations, the command syntax and environment configuration may vary. See your SSH-supporting application’s user guide for details.
SSH tunneling provides secure FTP command connections. This mechanism is based on an existing SSH port-forwarding configuration. You must configure SSH port forwarding on the SSH listen host before you configure the supporting Adapter Connection.
For example, on the App Server client host localhost, you can issue a command, such as,
ssh -L 4567:apple:21 -o BatchMode=yes apple |
Under the adapter’s configuration for the previous example, you must specify,
localhost for the Environment parameter SSH Listen Host
4567 for the Environment parameter SSH Listen Port
In this case, the adapter connects to the FTP server apple:21 through an SSH tunnel. For more information on SSH tunneling, see SSH Tunneling Support.
It is possible to use SOCKS and SSH tunneling at the same time. However, this practice is not recommended.
Where to Go Next
General Settings (BatchFTP Connectivity Map).
More Information
About Configuring Java CAPS Adapter Connectivity Map Properties
Configuring Java CAPS Project Components for Communication Adapters
Related Topics
For links to the other topics for this Adapter, go to Related Topics for Sun Adapter for Batch/FTP.
The General Settings section of the BatchFTP Connectivity Map properties contains the top-level parameters displayed in this table:
Table 20 Connectivity Map - BatchFTP - General Settings
Name |
Description |
Required Value |
---|---|---|
Specifically applies to legacy Batch adapter Projects. Provides backward compatibility to allow Projects that were created using the Batch adapter version 5.0.7 or earlier to be imported and deployed without a change in the adapters behavior. The selections are,
|
Select Yes or No. The default setting is Yes, simulating Projects created with Batch adapter version 5.0.7 or earlier. |
Where to Go Next
For information on Batch Adapter BatchFTPOverSSL configuration, go to Configuring Batch Adapter BatchFTPOverSSL Connectivity Map Properties.
More Information
About Configuring Java CAPS Adapter Connectivity Map Properties
Configuring Java CAPS Project Components for Communication Adapters
Related Topics
For links to the other topics for this Adapter, go to Related Topics for Sun Adapter for Batch/FTP.