Control-M Application Integrator PAAIT.9.0.21.308
BMC Software is releasing Control-M Application Integrator patch PAAIT.9.0.21.308 to correct the following problems in Control-M Application Integrator.
Corrected Problems
The following table describes the problems that are corrected in Control-M Application Integrator PAAIT.9.0.21.308.
Tracking Number | Patch | Description | Impacted Integrations |
|---|---|---|---|
CTM-12246 | PAAIT.9.0.21.308 | A Do statement is not performed if the If Output field is set to an asterisk in the Output Handling rule of a Verify operation completion sub-step. | Any user-defined Application Integrator plugin. |
CTM-12229 | PAAIT.9.0.21.308 | A job that uses a centralized connection profile that is set to retrieve sensitive information from an external vault fails and the following error message appears in the job output: java.lang.NoSuchMethodError: 'com.sun.jna.Library com.sun.jna.Native.load(java.lang.String, java.lang.Class)' |
|
CTM-12205 | PAAIT.9.0.21.308 | Plug-in testing fails if the connection profile includes a password that is set as an environment variable, and the following error message appears: UCM0001 = <password> for account <account> was encrypted with a non-standard CM encryption> | Any user-defined Application Integrator plugin. |
CTM-12102 | PAAIT.9.0.21.308 | The execution log does not include a failure message when a CLI step fails. |
|
CTM-12061 | PAAIT.9.0.21.308 | A REST call fails if one of the URL parameters includes the space character. | Any user-defined Application Integrator plugin. |
CTM-12055 | PAAIT.9.0.21.308 | The space character is not recognized as a valid suffix for values in List-type job attributes, and it is ignored. | Any user-defined Application Integrator plugin. |
CTM-12047 | PAAIT.9.0.21.308 | Application Integrator jobs fail when configured with SSL, and the following error message appears in the logs: RestUtils.httpRest request failed. error: NONE (No such file or directory) |
|
CTM-12046 | PAAIT.9.0.21.308 | REST calls are executed twice when configured with Google Cloud authentication. |
|
CTM-12033 | PAAIT.9.0.21.308 | Jobs fail if the Application Integrator is configured to use a proxy that has a password defined for it. The following message appears: Unable to tunnel through proxy. Proxy returns "HTTP/1.1 407 authentication required". |
|
CTM-11976 | PAAIT.9.0.21.308 | The Manual abort operation sub-step is not executed when you terminate an Application Integrator job using the Kill action if Control-M Application Integrator is running with Java 21. |
|
CTM-11964 | PAAIT.9.0.21.308 | The number of similar job types that execute simultaneously is incorrectly calculated and the following false alert appears in the Alerts tool: Parallel jobs count for job type <Job_Type_Name> exceeds the limit of 50. | All Control-M Integrations plugins. |
CTM-11937 | PAAIT.9.0.21.308 | Application Integrator jobs that contain a REST API step fail when an authentication token is used as the key value in the Headers attribute. |
|
CTM-11907 | PAAIT.9.0.21.308 | A Web Services REST job fails if its connection profile is set to OAuth2 and Client Secret. |
|
CTM-11903 | PAAIT.9.0.21.308 | Chinese, Japanese, and Korean (CJK) characters do not appear correctly in the job execution log. |
|
CTM-11895 | PAAIT.9.0.21.308 | Application Integrator jobs that contain a REST API step incorrectly wait for a period that is 10 times the number that is defined in the Override connection timeout job attribute in the Advanced Settings. |
|
CTM-11822 | PAAIT.9.0.21.302 | The Do action defined in an Output Handling rule of a command line step fails for an Extract and handle data action set to Part of the line. The following error appears in the log: Cannot invoke "java.lang.Integer.intValue()" because "wordsNum" is null | Any user-defined Application Integrator plugin. |
CTM-11810 | PAAIT.9.0.21.302 | An HTTPS request to Automation API fails when a REST API step in an Application Integrator Job is configured to call an Automation API endpoint and Application Integrator is set to work through a proxy. | Any user-defined Application Integrator plugin. |
CTM-11703 | PAAIT.9.0.21.302 | Application Integrator jobs fail if several jobs run simultaneously after a Control-M/Agent restart and the jobs use a centralized connection profile. The following error appears in the logs: Fail to decrypt password with AES, reason -null |
|
CTM-11676 | PAAIT.9.0.21.302 | Output Handling in a REST API step fails to resolve an Application Integrator attribute during job execution if the attribute is included in the condition for data extraction from a header (which begins with If output). |
|
CTM-11674 | PAAIT.9.0.21.302 | The plug-in test in Application Integrator remains in Executing status if the plug-in includes a Verify operation completion sub-step of type Command Line and an Output Handling rule defines the Extract and handle data action with a Keep extracted data in a runtime parameter that includes a rule to fail the job (which begins with Fail the job if extracted data...) | Any user-defined Application Integrator plugin. |
CTM-11601 | PAAIT.9.0.21.302 | The Override connection timeout setting is not applied when the connection uses Google Identity token authentication. This occurs, for example, in the Control-M for Web Services REST job definition, where the value set in the Connection Timeout field is ignored during job execution. |
|
CTM-10404 | PAAIT.9.0.21.302 | The start-ag log file includes Application Integrator error messages that are related to the execution log. For example: [Fatal Error] customer_log_3nkwc_00005.xml:290:6: Character reference is an invalid XML character) |
|
Installing Control-M Application Integrator Patch PAAIT.9.0.21.308 on UNIX
This procedure describes how to install Control-M Application Integrator patch PAAIT.9.0.21.308 on UNIX.
Before You Begin
- Verify that Control-M Application Integrator 9.0.21.300 is installed before you install this patch.
If you have already installed a previous Application Integrator patch, you can install this patch on top of the previous patch. - Verify that no Control-M jobs are executing on the Agent.
- If you are using an AIX operating system, remove unused libraries from memory by typing the following command as a root user:
/usr/sbin/slibclean
Begin
- Download the patch installation package from the Control-M Application Integrator 9.0.21 download page.
- Log in to the account where Control-M/Agent is installed and copy the installation package to a temporary directory on your local hard drive (not a network drive).
- Run the following command to shut down the Agent:
shut-ag - Navigate to the temporary folder where you downloaded the patch.
- Extract the patch tar.Z file, using the following command:
zcat PAAIT.9.0.21.308_unix.tar.Z | tar -xvf - - Run the following command:
sh setup.sh - Follow the on-screen instructions until the installation is complete.
- Run the following command to start the Agent:
start-ag
Installing Control-M Application Integrator Patch PAAIT.9.0.21.308 on Windows
This procedure describes how to install Control-M Application Integrator patch PAAIT.9.0.21.308 on Windows.
Before You Begin
- Verify that Control-M Application Integrator 9.0.21.300 is installed before you install this patch.
If you have already installed a previous Application Integrator patch, you can install this patch on top of the previous patch. - Verify that no Control-M jobs are executing on the Agent.
Begin
- Download the patch installation package from the Control-M Application Integrator 9.0.21 download page.
- Log in to the account where Control-M/Agent is installed, copy the installation package to a temporary directory on your local hard drive (not a network drive), and then extract the package.
- Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Stop.
- Navigate to the temporary directory and run the following command:
PAAIT.9.0.21.308_windows_x86_64.exe
- Follow the on-screen instructions until the installation is complete.
- Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.
Uninstalling Control-M Application Integrator Patch PAAIT.9.0.21.308 from UNIX
This procedure describes how to uninstall Control-M Application Integrator patch PAAIT.9.0.21.308 from UNIX.
Before You Begin
- Verify that no Control-M jobs are executing on the Agent.
- If you are using an AIX operating system, remove unused libraries from memory by typing the following command as a root user:
/usr/sbin/slibclean
Begin
- Log in to the account where Control-M/Agent is installed.
Run the following command to shut down Control-M/Agent:
shut-ag- Run the following command:
/<Agent_Home>/ctm/install/PAAIT.9.0.21.308/uninstall.sh - Run the following command to start up the Agent:
start-ag
Uninstalling Control-M Application Integrator Patch PAAIT.9.0.21.308 from Windows
This procedure describes how to uninstall Control-M Application Integrator patch PAAIT.9.0.21.308 from Windows.
Before You Begin
- Verify that no Control-M jobs are executing on the Agent.
Begin
- Log in, as an administrator, to the host where Control-M/Agent is installed.
- Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Stop.
- From the Control Panel, select Program and Features.
- Select Control-M Application Integrator 9.0.21.300 Patch 8 and click Uninstall.
- Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.