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:
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:
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:
Default: false |
com.bmc.aft.configurable.disablePrePostCommandOutput |
(Control-M MFT only) Enables you to avoid printing pre/post commands in the job output. Values:
Default: false |
com.bmc.aft.configurable.ffdc.enable |
(Control-M MFT only) Enables FFDC (First Failure Data Capture) mechanism for AFT Values:
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:
|
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 |