Configuring Control-M MFT in the aft_configurable.properties File

(Linux only) Determines whether a specified user password for the local host in the connection profile is enabled, as follows:

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

Default: false

After this parameter is set, you can use any dummy password and bypass password maintenance on local accounts.

The Agent must run in root mode.

Determines whether the job fails when Control-M MFT fails to close the data channel after the transfer completes for the destination host, as follows:

• true: The job fails 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

Determines whether you can set authorizations to perform actions such as mkdir, rename, and delete from the AFT remote browser dialog, as follows:

• true: Disables authorizations.

• false: Enable authorizations.

Default: false

(Control-M MFT only) Determines whether pre- and post-commands appear in the job output, as follows:

• true: Pre- and post-commands do not appear in the output.

• false: Pre- and post-commands appear in the output.

Default: false

(Control-M MFT only) Determines whether to enable the First Failure Data Capture (FFDC) mechanism in AFT, as follows:

• true: Enables the FFDC mechanism.

• false: Disables the FFDC mechanism.

Default: true

Defines the waiting time, in milliseconds, to kill a job with the standard process before a brutal force kill.

Default: 10000

Defines the waiting time, in seconds, to retrieve centralized connection profile details from the Control-M/Server with the ctmgetcm utility.

Default: 30

(Control-M MFT only) Defines the time interval, in seconds, that the File Watcher checks whether the file is static.

Values: 1–999

Default: 2

This parameter is also used when the Transfer All Matching Files checkbox is selected in Control-M Desktop.

Determines one of the following proxy protocols when a proxy is used in Configuration Management:

• HTTP

• SOCKS4

• SOCKS5

Default: HTTP

Defines the list of SFTP and FTP server hosts that bypass the proxy to connect to them.

Default: <empty>

Determines the maximum number of jobs that can concurrently run.

Default: 300

Determines whether to automatically add or remove file extensions to files that are encrypted or decrypted with the PGP template.

Default: false

An extension is added when files are copied to a directory. If a specific target filename is specified, the destination filename does not change.

Defines the extension that is added or removed from filenames that are encrypted or decrypted when the com.bmc.aft.configurable.ccm.pgp.handle.extension parameter is set to true.

Default: .pgp

Determines whether files are watched or transferred, based on one of the following attributes:

• none

• name

• timestamp

• size

Default: timestamp

Determines whether files are watched or transferred by the latest or oldest files.

Valid Values:

• ascending
• descending

Default: ascending

Defines the minimum number of milliseconds that File Transfer updates are sent to Control-M/EM.

Default: 10000

By default, an event is sent for every progress value change. However, no more than one In Progress event is sent for a file every ten seconds.

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

Default: 120000

By default, an event is sent for every progress value change. However, since the progress of large files might take time to change, an event is sent every 120 seconds even when the progress has not changed, such as from 40% to 50%.

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

Default: 32,768

Determines whether a failed file transfer record must be added to the MFT Search View and Dashboard when there is a File Watcher failure, such as when a file is not found, as follows:

• true: Failed file transfer records are added.

• false: Failed file transfer records are not added.

Default: false

Defines the retention time, in hours, of File Transfer events in the local database.

Default: 24

Defines the initial delay, in milliseconds, to check whether to purge old events from the local database.

Default: 1,800,000 (30 minutes)

Defines the interval, in milliseconds, to check whether to purge old events from the local database.

Default: 21,600,000 (6 hours)

Determines whether transfer definition details appear in the job output, as follows:

• true: Transfer definition details appear in the output.

• false: Transfer definition details do not appear in the output.

Default: false

This can be valuable when you use variables A memory location with a name and value that you can reference in your job processing definitions, which Control-M resolves for the current job execution. in job definitions The set of parameters that defines what the job does, when it runs, its prerequisites, and the post-processing actions that Control-M performs after the job completes execution. and want to see the resolved values (watch pattern includes an Auto-Edit variables).

Determines whether a notification about an overwritten file appears in the job output, as follows:

• true: A notification appears in the job output. This option might reduce performance if the destination directory contains many files.

• false: A notification does not appear in the job output.

Default: false

Determines whether to include old AFT error and info messages in the job output. This allows post-processing old messages that are no longer printed or printed differently in MFT.

Default: false

Defines the path of the file that contains the old AFT messages to print in the job output.

Default: ${cm.home}/data/old_aft_output_messages.properties

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

Default: true

Determines whether to overwrite an existing target name in a rename post-action, as follows:

• true: An existing target name is overwritten in a rename post-action.

• false: The rename operation fails with a message that the file already exists.

Default: true

Determines whether to move a file to the target directory when a trailing slash is not specified.

• true: A file is moved to the target directory when a trailing slash is not specified.

• false: The target name is treated as a filename when a trailing slash is not specified.

Default: false

Determines whether to support filtering by regular expression, as follows:

true: The source filename is treated as a regular expression.

false: The source filename is not treated as a regular expression.

Default: false

Determines whether to rename a source or destination file, even when the option is Left As Is but there is a new filename specified in the job definition. Users can create these jobs on an old Control-M/EM client, version 7.0.00 or lower.

Default: false

(SFTP connection profiles only) Determines where to prepend a preceding slash to a source or destination path when it is missing, as follows:

• true: Prepends a missing preceding slash to a source or destination path.

• false: Does not prepend a missing preceding slash to a source or destination path.

Default: false

Determines whether to do full impersonation on Linux when the Agent is running as root.

Default: false

When the value is false, 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.

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

Determines whether to always fail the job if the post-action on the source or destination file failed, regardless of the flag in the Advanced dialog of the job definition.

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 use a z/OS parameter that has a value in the job definition, but is empty in the template.

Default: false

Determines whether to ignore files that contain 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 smaller than 1,024).

Default: false

Determines whether to store File Transfer updates in Control-M MFT database (updates do not appear in the 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 not appear in the 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 to skip reading and parsing the whole remote server SSH version, which is returned by the Web Proxy. This option is relevant only for SSH connections via the Web Proxy since some proxy servers might return an invalid response and cause a significant delay in the initial connection.

Default: false

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 files was 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 enforce simultaneous transfers for all MFT jobs. The parameter overrides the option in the MFT job. This parameter is not recommended if you run a high number of concurrent jobs.

Default: false

Defines the maximum number of concurrent jobs that can transfer files simultaneously.

Default: 20

Defines the maximum number of threads to run jobs with simultaneous transfers in auto mode.

Default: 16

Defines the minimum processors required to run jobs with simultaneous transfers in auto mode.

Default: 2

Defines the minimum volume of files to transfer, in MBs, to activate simultaneous transfers when the job is defined to perform simultaneous transfers in auto mode.

Default: 50

Determines whether to verify if the FTP server address in the data channel is similar to the one used in the control channel. It is defined with a virtual IP for FTP servers.

Default: true

Determines whether to fail the File Transfer job if 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 does not exist, as follows:

• true: The job fails.

• false: The job does not fail.

Default: true

Determines the list of substrings that cause the job to fail if the write error response contains them. The job does not try to reconnect to the server, and fails immediately.

Use the ‘|’ character as a separator.

Default: broken|socket write error

A file transfer progress update appears in 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-to-local-file transfers.

Default: 1,048,576

Defines the maximum file volume allowed for an MFT job to transfer in a single transfer. The job fails when the total file size exceeds the defined volume. The value for an unlimited volume is 0.

Default: 0

Defines the maximum file count allowed for an MFT job to transfer in a single transfer. The job fails when the total count exceeds this amount.

Default: 500,000

Determines whether to continue to retrieve the destination file size from the point of failure, after the system reconnects to the remote host. This is only relevant for binary transfers to distributed systems only.

Default: true

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 an SFTP client.

Determines the list of ciphers used by MFT as an SFTP client.

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

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

Determines the list of accepted key algorithms.

Determines the list of key exchange algorithms to omit from the MFT key exchange list used in the initial SFTP negotiation.

The IgnoreCheckKexes parameter must be set to false.

Determines a list of ciphers to omit from the MFT ciphers list used in the initial SFTP negotiation.

The IgnoreCheckCiphers parameter must be set to false.

Determines a list of MAC algorithms to omit from the MFT MAC list used in the initial SFTP negotiation.

The IgnoreCheckMacsparameter must be set to false.

Determines a list of ciphers to omit from the MFT signature list used in the initial SFTP negotiation.

The IgnoreCheckSignaturesparameter must be set to false.

Determines whether to omit the list of ciphers specified in CheckCiphers from the MFT ciphers list used in the initial SFTP negotiation. The list is omitted if the parameter is set to false.

Default: true

Determines whether to omit the list of key exchange algorithms in CheckKexes from the MFT key exchange algorithm list used in the initial SFTP negotiation. The list is omitted if the parameter is set to false.

Default: true

Determines whether to omit the list of ciphers in CheckMacs from the MFT MAC algorithm list used in the initial SFTP negotiation. The list is omitted if the parameter is set to false.

Default: true

Determines whether to omit the list of ciphers in CheckSignatures from the MFT signature list used in the initial SFTP negotiation. The list is omitted if the parameter is set to false.

Default: true

Defines the keep-alive interval, in milliseconds, when the client pings the server to keep the connection alive.

Default: 10000 (10 seconds)

Defines the maximum number of keep-alive messages to send without receiving any messages back from the server, before the client disconnects from the server.

Default: 2000

Determines whether to ignore signature (host key) verification in an SFTP connection.

Default: false

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

Default: false

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

Default: 600

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

Default: 5,000

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, even though the transfer has not started, as follows:

• NEVER: Do not send In Queue status events.

• FIRST_RUN: Send In Queue status events only for the first run of each job.

• ALWAYS: Always send In Queue status events.

Default: NEVER

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 upload or download size for a file in a single part.

Default: 8,388,608

Determines the buffer size when a file downloads or uploads to Azure.

Default: 131,072

Determines the maximum attempts to perform action on Azure storage.

Default: 3

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

Default: 1,000

Determines the connection timeout to Azure.

Default: 60000

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

Default: 600,000

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

Default: 600,000

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

Default: 600,000

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: 1,000

Determines, in milliseconds, the connection timeout to Google Cloud Storage.

Default: 20,000

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 File Watch operations begin or end).

Default: false

Determines whether MFT sends transfer progress changes for Agent track responses. The Agent sends a short update to the Control-M/Server and to the progress bar or data in the Monitoring Job properties.

Default: true

Defines the interval, in seconds, to send transfer progress changes for Agent track responses. This is relevant for the following:

com.bmc.aft.configurable.agentTrackUpdateOnProgressIntervalSeconds=true

Default: 120

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 data channel after the transfer completes for the source host.

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

Defines the default part size, in MBs, for the mulitpart upload of a file.

Default: 10

Defines the maximum part size, in MBs, for the mulitpart upload of a file. This value is used to upload very large files, when the number of parts results in more than 10,000 parts, due to the default part size.

Default: 50

Determines whether to perform multipart download to download from S3 to a local or network file system.

Default: true

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

Default: 5000

Determines whether to generate copies of temporary scripts for pre- and post-execution commands.

Default: false

Use this parameter to troubleshoot pre- or post-execution command issues when multiple File Transfer jobs run concurrently.

Determines whether to download large files from Oracle Object Storage to the local file system in multipart.

Default: true

Determines whether to perform multipart upload when transferring large files to Oracle Object Storage

Default: true

Determines the minimum file size to use multipart transfers from or to Oracle Object Storage.

Default: 8,388,608 (8 MB)

Determines the size of each part when transferring files from or to Oracle Object Storage in multi-part.

Default: 4,194,304 (4 MB)

Determines the buffer size, in bytes, when files transfer to or from Oracle Object Storage

Default: 131,072 (128 KB)

Determines the maximum number of concurrent threads when files transfer in multipart from or to Oracle Object Storage.

Default: 10

Determines the number of file action attempts performed on Oracle Object Storage.

Default: 3

Determines the page size to list items, such as compartments or buckets, in Oracle Object Storage.

The maximum value is 1000.

Default: 1000

Defines the page size to list files in Oracle Object Storage.

Default: 1000

Determines the number of milliseconds between file actions attempt performed on Oracle Object Storage.

Default: 1,000

Determines the number of milliseconds for Oracle Object Storage read operations before a timeout occurs.

Default: 60,000

Determines the number of milliseconds to wait before a connection timeout occurs in Oracle Object Storage.

Default: 10,000

Determines whether to search for local files with the default search algorithm, as follows:

• true: Searches with the default search algorithm.

• false: Searches with a new search algorithm that uses file streams to list directories, introduced in Control-M MFT 9.0.20.

Default: false

Defines the filename format for the transferred file when a file with the same name is found in the destination path and Add Counter is selected in the job definition.

You can define the filename with any combination of free text and the following MFT variables:

• [N]: Filename

• [C]: Counter

• [E]: File extension.

• [Y]: Year (4 digits).

• [M]: Month (2 digits).

• [D]: Day (2 digits).

• [H]: Hour, in 24-hour format (2 digits).

• [m]: Minutes (2 digits).

• [S]: Seconds (2 digits).

• [ms]: Milliseconds (3 digits).

• [U]: Unique identifier.

• [O]: Run (order) ID.

Default: [N]-[C][E]

Determines the limit for the counter that is appended to the filename of a transferred file when a file with the same name already exists in the destination path.

Default: 100

Defines the timestamp format of the transferred file when a file with the same name is found in the destination path and Add Timestamp is selected in the job definition.

You can define the filename with any combination of free text and the following MFT variables:

• [N]: Filename

• [C]: Counter

• [E]: File extension.

• [Y]: Year (4 digits).

• [M]: Month (2 digits).

• [D]: Day (2 digits).

• [H]: Hour, in 24-hour format (2 digits).

• [m]: Minutes (2 digits).

• [S]: Seconds (2 digits).

• [ms]: Milliseconds (3 digits).

• [U]: Unique identifier.

• [O]: Run (order) ID.

Default: [N]-[Y][M][D]-[H][m][S][E]

Determines whether to show the file timestamps in the Agent time zone of the file browser in an MFT job.

Default: true

Determines which table is used by the FTP server during transfer for translation.

Default: AUSGER, BELGIAN, CANADIAN, CUSTOM, DANNOR, DUTCH, FINSWED, FRENCH, ITALIAN, JAPANESE, PORTUGUE, SPANISH, SWISFREN, SWISGERM, UK, US

Determines whether to switch to binary mode before you generate an FTP list.

The FTP list is generated in binary mode, even if the transfer is defined as EBCDIC (for z/OS) or a specific CCSID (for OS400), if the parameter value is true.

Default: false

Determines the debug level for the cmupdate utility, which is executed every few seconds to publish file transfer events or update the status of the File Transfer Server.

Default: 0