Configuring Control-M in the aft_configurable.properties File

(Linux 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

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

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

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

(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

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

Values:

• true: Enables FFDC mechanism

• false: Disables FFDC mechanism

Default: true

(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.

Values: 1-999

Default: 2 (seconds)

Determines the maximum number of concurrent running jobs.

Default: 300

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

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

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.

Default: false

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

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.

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%.

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

Default: 32768

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

Determines whether to print transfer definition details to the job output. This can be valuable if you use variablesA name and value pair that you can reference in your job processing definition, which Control-M resolves for the current execution of the job in job definitionsThe set of parameters that defines what the job does, when it must run, its prerequisites to run, and post-processing actions for Control-M to perform after its completion (also called a job processing definition) and want to see the resolved values (watch pattern includes an Auto-Edit variable).

Default: false

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

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

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

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

• 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)

Default: false

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

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

Default: false

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

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

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

Default: true

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

Default: false

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

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

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

Default: false

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

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

Default: false

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

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

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

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

Default: false

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

Default: false

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

Default: 0

Determines the number of seconds to wait before each retry.

Default: 0

Determines whether the destination file uses the symbolic link name.

Default: true

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

Default: true

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

Default: false

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

Default: false

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)

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

Default: true

Prints a file transfer progress update to the job output when every X percent of the file is transferred.

Default: 10

Generates a file transfer progress event to the MFT dashboard when every X percent of the file is transferred.

Default: 10

Determines the default buffer size, in bytes, used for local->local file transfers.

Default: 1048576

Determines whether to perform directory listing in binary when the transfer is defined in EBCDIC.

Default: false

Determines the list of key exchange algorithms to be used by MFT as SFTP client.

Determines the List of Message Authentication Codes (MACs) to be used by MFT as SFTP client.

Determines the list of key Signature algorithms to be used by MFT as SFTP client.

Determines whether the header content type is updated when uploading a file to S3.

Default: false

Determines whether to verify if the FTP server address in the data channel is similar to the one used in the control channel.

Default: true

Determines the timeout, in seconds, for an OS command running by an MFT client to finish.

Default: 600

Determines the time, in milliseconds, to wait before each publishing of an MFT file transfer event.

Default: 5000

Determines the maximum number of MFT file transfer events to be sent in a single chunk.

Default: 1000

Determines whether to send events for identified files to be transferred, although the transfer hasn’t started. Possible values:

• NEVER: Do not send “In Queue” status events

• FIRST_RUN: Send “In Queue” status only for each job’s first run

• ALWAYS: Always send “In Queue” status events

Default: NEVER

Determines if the MFT file watcher fails the job (with RC = 1) when the watch pattern contains a non-exist path.

Default: false

Determines if a multipart (multi-threaded) transfer is used when you upload a file to Azure Blob storage.

Default: true

Determines whether to use multipart (multi-threaded) transfer when downloading file from Azure to a local path

Default: true

Determines the number of concurrent threads when uploading blocks to azure or downloading from azure to local.

Default: 10

Determines the maximum size for uploading/Downloading a file in a single part.

Default: 8388608

Determines the buffer size when downloading/uploading file from/to azure.

Default: 131072

Determines the block size when downloading/uploading file from/to azure.

Default: 4194304

Determines the maximum attempts to perform action on azure storage.

Default: 3

Determines the delay, in milliseconds, between retries for Azure requests.

Default: 1000

Determines the connection timeout to Azure.

Default: 60000

Determines the response timeout duration used when waiting for a server to reply.

Default: 600000

Determines, in milliseconds, the read timeout used when reading a response from Azure.

Default: 600000

Determines, in milliseconds, the write timeout used when waiting for a request to be sent to Azure.

Default: 600000

Determines, in seconds, the timeout for copy blob operation.

Default: 60

Determines the maximum number of retries for a failing operation against Google Cloud Storage.

Default: 3

Determines, in milliseconds, the interval between operation retries against Google cloud storage.

Default: 1000

Determines, in milliseconds, the connection timeout to Google cloud storage.

Default: 20000

Determines, in milliseconds, the read timeout for Google cloud storage to read operations.

Default: 60000

Determines whether MFT sends Agent track notifications during a job run (when starting/finishing file watch operations).

Default: false

Determines whether to show or set the z/OS full DataSet names as the transferred filename.

Default: false

Determines whether to fail the job if closing the source FTP server’s data channel after the transfer completes.

Default: true

Determines whether to fail the job if the close_notify response is received from the FTP server when using SSL.

Default: true

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

Default: 3

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

Default: 5

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