aft_configurable.properties file parameters

The following table describes some of the aft_configurable.properties file parameters:

NOTE: You can access the aft_configurable.properties file in ~/ctm/cm/AFT/data (UNIX) or Control-M Agent\Default\CM\AFT\data (Windows).

Parameter

Description

com.bmc.aft.configurable.ftp.disableUnixPass

(UNIX Only) Enables a password for a specified user for the local host in the Connection Profile. Values:

  • true: Disables the password for the specified user
  • false: Enables the password for the specified user

Default: false

NOTE: After setting the parameter, you can use any dummy password for local accounts and bypass password maintenance for local accounts for UNIX machines. The Agent must run in Root mode.

com.bmc.aft.configurable.ftp.failOnDestCloseDataChannel

The job fails when Control-M for AFT or Control-M MFT fails to close the data channel after the transfer completes. Values:

  • true: Enables the job to fail when the data channel fails to close after the transfer completes
  • false: The job does not fail when the data channel fails to close after the transfer completes

Default: false

com.bmc.aft.configurable.disableFileSystemRequests

Enables you to set authorizations to perform actions such as mkdir, rename, and delete from the AFT remote browser dialog.

Values:

  • true: Disables authorizations
  • false: Enable authorizations

Default: false

com.bmc.aft.configurable.disablePrePostCommandOutput

(Control-M MFT only) Enables you to avoid printing pre/post commands in the job output. Values:

  • true: Avoids printing pre/post commands in the output
  • false: Prints pre-/post commands in the output

Default: false

com.bmc.aft.configurable.ffdc.enable

(Control-M MFT only) Enables FFDC (First Failure Data Capture) mechanism for AFT

Values:

  • true: Enables FFDC mechanism
  • false: Disables FFDC mechanism

Default: true

com.bmc.aft.configurable.ccm.static.check.interval

(Control-M MFT only) Sets the interval time when the file watcher checks if the file is static. This parameter is also used when the Transfer all matching files checkbox is checked in the Control-M client.

Default: 2 (seconds)

Values: 1-999

com.bmc.aft.configurable.maxConcurrentJobs

Determines the maximum number of concurrent running jobs.

Default: 300

NOTE: If you want to raise the default value, be aware that it might consume more resources and module performance.

com.bmc.aft.configurable.ccm.pgp.handle.extension

Determines whether to automatically add or remove extensions to a file that is encrypted/decrypted using PGP template.

Default: false

NOTE: The extension is added when files are copied to a directory. If a specific target file name is specified, the destination file name does not change.

com.bmc.aft.configurable.ccm.pgp.file.extension

Determines which extension is added or removed to or from files that are encrypted/decrypted when com.bmc.aft.configurable.ccm.pgp.handle.extension is set to true.

Default: .pgp

com.bmc.cm.aft.client.filecopy.mineventlimit

Determines the minimum number of milliseconds for File Transfer updates sent to Control-M/EM.

Default: 2000

By default, an event is sent on every progress value change, but not more than one In Progress event is sent per file every 2 seconds.

com.bmc.cm.aft.client.filecopy.maxeventlimit

Determines the maximum number of milliseconds for File Transfer updates sent to Control-M/EM.

Default: 20000

By default, an event is sent on every progress value change, but since large files progress may take time to change, an event is sent every 20 seconds even if progress wasn’t changed. For example, from 42% to 43%.

com.bmc.aft.configurable.ftp.bufferSize

Determines the buffer size for every chunk sent during a file transfer.

Default: 32768

com.bmc.aft.configurable.createEventOnFileWatcherFailedWhenTransferExist

Determines whether a failed file transfer record must be added to the MFT Search view and dashboard in case of File Watcher failure. For example, if a file was not found.

Default: false

com.bmc.aft.configurable.printTransferDefinitions

Determines whether to print transfer definition details to the job output. This can be valuable if you use variables in job definitions and want to see the resolved values (watch pattern includes an Auto-Edit variable).

Default: false

com.bmc.aft.configurable.renameDestOnPrefix

Renames the <prefix><filename> to the target file name in a rename post action. If false, the prefix is removed and then <file> is renamed to the target file name.

Default: true

com.bmc.aft.configurable.actions.overwriteIfExists

Determines whether to overwrite an existing target name in a rename post action. When set to false, the rename operation fails with a message that the file already exists.

Default: true

com.bmc.aft.configurable.actions.moveToDirectoryIfExists

Determines whether to move a file under the target directory (even if trailing slash wasn’t specified), When set to false, it treats the target name as a file (when trailing slash is not specified).

Default: false

com.bmc.aft.configurable.file.filterRegex

Determines whether to support filtering by regular expression. When set to true, the source file name is treated as a regular expression.

Default: false

NOTE:

  • Wildcards (“*” and “?”) are still supported (use them instead of “.*” and “.”)
  • Wildcards must be specified in a file pattern for the feature to work (e.g.: [Ff][Ii][Ll][Ee]*.txt)

com.bmc.aft.configurable.performRenameActionWhenOptFieldIsMissingAndNewNameFieldExist

Determines whether to perform a rename on source or destination file even when the option is Left as is. but there is a new file name specified in the job definition. These jobs can be created by users using an old Control-M/EM Desktop version (7.0.00 or before).

Default: false

com.bmc.aft.configurable.sftp.prependPrecedingSlashToPathWhenMissing

Determines where to prepend preceding slash to source or destination path when it is missing (SFTP Connection Profiles only).

Default: false

com.bmc.aft.configurable.linux.impersonation.enabled

Determines whether to do full impersonation on Linux when the Control-M/Agent is running as root. When value is false (default), the container, which runs as root, still checks file permissions for every transfer and sets the owner according to the Connection Profile user. The transfer itself is done as root.

Default: false

com.bmc.aft.configurable.performPreCommandAfterFileWatcherActionSucceeded

Determines whether to execute the pre-command when defining File Watcher job with Pre-Command, after the file watcher operation (if watch operation succeeded).

Default: false

com.bmc.aft.configurable.ftp.os2200.retrieveFromSourceDir

Determine whether to change the working directory to the source directory before opening the file to read from (on OS2200).

Default: true

com.bmc.aft.configurable.ignoreFilesControlCharacter

Determines whether to ignore files containing a control character in the name.

Default: false

com.bmc.aft.configurable.security.ftp.checkAlgorithmConstraints

Determines whether to ignore checking algorithm constraints. When set to true, Control-M MFT doesn't fail connections for deprecated signature algorithm used for certificates. (MD2 algorithm, or a server that uses key size with length lower than 1024).

Default: false

com.bmc.aft.configurable.publish.doNotStoreEvents

Determines whether to store File Transfer updates in Control-M MFT database (Updates don't appear in Dashboard or Search view).

NOTE: If set to true, new file transfer records do not appear in the MFT Dashboard and search results.

Default: false

com.bmc.aft.configurable.publish.doNotPublishEvents

Determines whether to publish File Transfer updates to Control-M/EM (Updates don't appear in Dashboard or Search view).

NOTE: If set to true, new file transfer records do not appear in the MFT Dashboard and search results.

Default: false

com.bmc.aft.configurable.sftp.allow.authentication.failure.on.host.authorization

Determines whether to ignore failing authentications while authorizing an SSH host, and proceed with storing the host key in the known_hosts file.

Default: false

com.bmc.aft.configurable.sftp.NewLine.CRLF.Servers=

Defines this server to hold files with <CR><LF> at the end of line.

com.bmc.aft.configurable.sftp.NewLine.LF.Servers=

Defines this server to hold files with <LF> at the end of line.

com.bmc.aft.configurable.local.transfer.files.in.use

Determines whether the file is in use before a transfer. Files that are in use are skipped.

Default: false

com.bmc.aft.configurable.verify.file.size.has.not.changed.before.transfer

Determines whether to verify if the file size has changed since the file(s) were marked for transfer.

Default: false

com.bmc.aft.configurable.file.stream.operations.number.of.retries

Determines the number of retries to perform when file streams fails to open or close.

Default: 0

com.bmc.aft.configurable.file.stream.operations.time.between.retries.in.seconds

Determines the number of seconds to wait before each retry.

Default: 0

com.bmc.aft.configurable.destNameUseSymbolicLinkName

Determines whether the destination file uses the symbolic link name.

Default: true

com.bmc.aft.configurable.ftp.remoteVerificationControlVsDataEnabled

Determines whether to enable server verification of an FTP server that is defined with a virtual IP.

Default: true

com.bmc.aft.configurable.failJobOnPrePostExecCmdFailure

Determines whether to fail the File Transfer job if either the pre or post execution command fails.

Default: false

com.bmc.aft.configurable.forceRestartOnDisconnectionDuringDownload

Determines whether to restart the transfer from the beginning when there is a disconnection during the transfer.

Default: false

com.bmc.aft.configurable.fileWatcherFailIfSourceDirectoryMissing

Determine the ID of the return code when the directory that you are watching does not exist.

Default: true (Return code = 1 instead of 7)

com.bmc.aft.configurable.transferFailedIfDestinationDirectoryMissing

 

Determines whether to fail the job if the destination directory doesn't exist.

Default: true

com.bmc.aft.configurable.s3.multipart.upload.threads.count

Determines the number of threads to use when performing multipart uploads to Amazon S3.

Default: 3

com.bmc.aft.configurable.s3.maximum.multipart.uploads.count

 

Determines the maximum number of concurrent jobs performing multipart uploads to Amazon S3.

Default: 5

com.bmc.aft.configurable.s3.maxConnections

 

Determines the maximum total number of connections that can be opened to S3 account

Parent Topic

Configuration procedures