Control-M Application Integrator PAAIT.9.0.21.310
BMC Software is releasing Control-M Application Integrator patch PAAIT.9.0.21.310 to correct the following problems in Control-M SaaS Application Integrator.
Corrected Problems
The following table describes the problems that are corrected in Control-M Application Integrator PAAIT.9.0.21.310:
Tracking Number | Patch | Description | Impacted Integrations |
---|---|---|---|
CTM-12597 | PAAIT.9.0.21.310 | Pretty print fails when Output Handling returns a JSON response and the JSON path returns a string that is surrounded by curly brackets. The following errors appears: Expected a ':' after a key... | Any user-defined Application Integrator plug-in. |
CTM-12542 | PAAIT.9.0.21.310 | The output processed in the Output Handling section is only partial if it contains text surrounded by square brackets. | Any user-defined Application Integrator plug-in. |
CTM-12531 | PAAIT.9.0.21.310 | Only the first line is extracted from the Body element in an HTTP response during Output Handling of a REST API step. | Any user-defined Application Integrator plug-in. |
CTM-12500 | PAAIT.9.0.21.310 | White-space characters, such as newline or tab characters, are removed from the SOAP response in a Control-M for Web Services SOAP job. |
|
CTM-12483 | PAAIT.9.0.21.310 | The file that is created when you save content to a file during Output Handling of a REST API step is corrupt if the content is in binary format. | Any user-defined Application Integrator plug-in. |
CTM-12400 | PAAIT.9.0.21.310 | The end position for extraction of part of a line in a Command Line step is determined incorrectly. The search begins at the beginning of the line instead of beginning at the specified start position. | Any user-defined Application Integrator plug-in. |
CTM-12389 | PAAIT.9.0.21.310 | The proclog directory is filled with AI_DLL_TRACK files when Application Integrator jobs run, and the following error appears in the files: key too long: 72 |
|
CTM-12368 | PAAIT.9.0.21.310 | The error that appears in the job output when an OAuth2 token expires is inaccurate, "Unknown execution error" instead of "Connection refused." |
|
CTM-12355 | PAAIT.9.0.21.310 | A REST API call with an empty Body and "Content-Length: 0" in the Header is processed incorrectly during execution. The "Content-Length: 0" setting is removed from the Header. | Any user-defined Application Integrator plug-in. |
CTM-12233 | PAAIT.9.0.21.310 | The Manual abort operation sub-step in a Command Line (CLI) job behaves incorrectly when Abort Method is set to Continue Execution. Step execution is terminated immediately when the job is aborted, instead of allowing the step to complete its execution. |
|
CTM-10256 | PAAIT.9.0.21.310 | The following message appears in the Control-M/Agent daily log when you run Application Integrator jobs that are configured with Specific statement output in the If-Actions section: DEBUG DUMP FOR process/thread=5764. Message is 0618 13:21:33:042 AS:ag_dwnsys_isStatement: Error. '%STMT%' not found in template. Invalid template will be ignored. | Any user-defined Application Integrator plug-in. |
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 plug-in. |
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 plug-in. |
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 plug-in. |
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 plug-in. |
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 plug-ins. |
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 plug-in. |
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 plug-in. |
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 plug-in. |
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.310 on UNIX
This procedure describes how to install Control-M Application Integrator patch PAAIT.9.0.21.310 on UNIX.
Before You Begin
- Verify that Control-M/Agent 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
- Log in to the Control-M/Agent host where Control-M Application Integrator is installed.
- Create a temporary directory to save downloaded files.
- Download the patch from the following S3 link:
https://control-m-pre-ga.s3.us-east-1.amazonaws.com/PAAIT.9.0.21.310_GA/PAAIT.9.0.21.310_unix.tar.Z - Save the PAAIT.9.0.21.310_unix.tar.Z file in the temporary directory.
- Run the following command to shut down the Agent:
shut-ag - Extract the patch tar.Z file, using the following command:
zcat PAAIT.9.0.21.310_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.310 on Windows
This procedure describes how to install Control-M Application Integrator patch PAAIT.9.0.21.310 on Windows.
Before You Begin
- Verify that Control-M/Agent 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
- Log in to the Control-M/Agent computer.
- Create a temporary directory to save downloaded files.
- Download the patch from the following S3 link:
https://control-m-pre-ga.s3.us-east-1.amazonaws.com/PAAIT.9.0.21.310_GA/PAAIT.9.0.21.310_windows_x86_64.zip - Save the PAAIT.9.0.21.310_windows_x86_64.zip file in the temporary directory.
- Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Stop.
- Extract the PAAIT.9.0.21.310_windows_x86_64.zip file.
Navigate to the temporary directory and run the following command:
PAAIT.9.0.21.310_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.310 from UNIX
This procedure describes how to uninstall PAAIT.9.0.21.310 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.310/uninstall.sh - Run the following command to start up the Agent:
start-ag
Uninstalling Control-M Application Integrator Patch PAAIT.9.0.21.310 from Windows
This procedure describes how to uninstall PAAIT.9.0.21.310 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 10 and click Uninstall.
- Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.