SFTP File Ops Agent Service (com.ibi.agents.XDSFTPFileOpsAgent)

Syntax:

com.ibi.agents.XDSFTPFileOpsAgent

iIT Service Object:

format: SFTP File Ops Agent

Description: Performs simple SFTP file operations.

Parameters:

Parameter

Description

Host Name *

The DNS name (or IP address) of the SFTP server that you want to connect to.

Remote Port *

The port to connect to on the SFTP site. Leave blank for default port 22.

Buffer Size

The size of the SFTP buffer to be used when sending or retrieving data. The default value of 32768 is used if this field is not set. A larger buffer may improve performance, but setting this field to a value greater than 65536 will default to 65536. The value must be entered as a whole number (for example, 32768, 65536). iWay recommends leaving the buffer size at 32768.

Proxy Settings

Proxy Type

The proxy protocol to use.

Proxy Host Name

The DNS name (or IP address) of the proxy server that you want to connect to.

Proxy Port

The port to connect to on the proxy site.

Proxy User ID

The user ID on the proxy server.

Password

The proxy user's password on the proxy server.

SSH Parameters

User Name

The user ID on the SSH-enabled server.

Password

The user's password on the SSH-enabled server.

Private Key

The path to the private key file for public-key authentication..

Passphrase

The passphrase used to protect the Private Key.

Provider

The name of the SSH Client Security Provider to use. If no Provider name is specified, enter the user name and either a password or a Private Key and passphrase values (Passphrase is required only if the Private Key file is passphrase protected).

Validate Host Keys

If set to true, keys sent from SSH hosts are validated. If valid, the keys are cached by this server. If false, any host key will be accepted by this server.

Host Key Repository

The path to the Known Host Keys repository on this server.

Agent Parameters

Operation *

The command to execute when agent goes active.

File (from) *

The originating file to be operated on. Relative or absolute file paths are supported through an SREG or XPATH expression evaluated using the incoming document.

File (to)

The destination file to be operated on. Wild cards are accepted. Required except for delete and size exist.

File (to) a directory name

File (to) references a directory. If it is unclear whether the path names a directory or a filename, the Service Manager will assume the path names a file.

File (to) Create Directories

Create if the directory doesn't exist. Used only for Copy, Move, Rename, and Append operations.

Remote Size or Permissions

The name of the Special Register designated to hold size (if Operation is size), or the file's octal permissions (if Operation is chmod). This field is required when the Operation is either size or chmod.

Out Document *

The document returned by operation (bad input defaults to result).

Action on Failure *

Determines whether an input document or status document is returned on failure.

Retry *

If non-zero, will retry the operation n times at one-second intervals.

Edges:

The following table lists the available Line Edges for the SFTP File Ops Agent Service (com.ibi.agents.XDSFTPFileOpsAgent).

Line Edge

Description

OnError

An exception occurred during execution.

OnSuccess

The operation was successful.

OnFailure

A fail condition occurred during execution.

OnParseError

Could not parse a document.

OnFailedConnection

Could not connect to the external system.

OnFailedOperation

Could not perform the operation requested .

OnFailSecurity

Could not operate dues to a security violation..

OnNotFound

The resource was not found and this is considered an error.