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.

Important

Verify that Control-M/Agent 9.0.21.300 or later, which includes Control-M Application Integrator version 9.0.21.300, is installed before you install this patch.
This patch is cumulative. You do not need to install the previous patches, PAAIT.9.0.21.308 or PAAIT.9.0.21.302.

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-12597PAAIT.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-12542PAAIT.9.0.21.310The 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-12531PAAIT.9.0.21.310Only 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-12500PAAIT.9.0.21.310White-space characters, such as newline or tab characters, are removed from the SOAP response in a Control-M for Web Services SOAP job.
CTM-12483PAAIT.9.0.21.310The 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-12400PAAIT.9.0.21.310The 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-12389PAAIT.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-12368PAAIT.9.0.21.310The error that appears in the job output when an OAuth2 token expires is inaccurate, "Unknown execution error" instead of "Connection refused."
  • Any user-defined Application Integrator plug-in
  • All Azure-based Control-M Integration plug-ins
  • Snowflake
CTM-12355PAAIT.9.0.21.310A 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-10256PAAIT.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.

  • Any user-defined Application Integrator plug-in. 
  • All REST-based Integration plug-ins that use Google Cloud Authentication. 
  • Web Services REST

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

  • Any user-defined Application Integrator plug-in. 
  • All Control-M Integrations plug-ins, except for the DataStage and MicroFocus plug-ins.

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

  1. Log in to the Control-M/Agent host where Control-M Application Integrator is installed.
  2. Create a temporary directory to save downloaded files.
  3. 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
  4. Save the PAAIT.9.0.21.310_unix.tar.Z file in the temporary directory.
  5. Run the following command to shut down the Agent:
    shut-ag
  6. Extract the patch tar.Z file, using the following command:
    zcat 
    PAAIT.9.0.21.310_unix.tar.Z | tar -xvf -
  7. Run the following command
    sh setup.sh
  8. Follow the on-screen instructions until the installation is complete.
  9. 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

  1. Log in to the Control-M/Agent computer.
  2. Create a temporary directory to save downloaded files.
  3. 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
  4. Save the PAAIT.9.0.21.310_windows_x86_64.zip file in the temporary directory.
  5. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Stop.
  6. Extract the PAAIT.9.0.21.310_windows_x86_64.zip file.
  7. Navigate to the temporary directory and run the following command:
    PAAIT.9.0.21.310_windows_x86_64.exe

    Note

    If User Account Control (UAC) is enabled, you must run the executable As Administrator.

  8. Follow the on-screen instructions until the installation is complete.
  9. 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

  1. Log in to the account where Control-M/Agent is installed.
  2. Run the following command to shut down Control-M/Agent:

    shut-ag

  3. Run the following command:
    /<Agent_Home>/ctm/install/PAAIT.9.0.21.310/uninstall.sh
  4. 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

  1. Log in, as an administrator, to the host where Control-M/Agent is installed.
  2. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Stop.
  3. From the Control Panel, select Program and Features.
  4. Select Control-M Application Integrator 9.0.21.300 Patch 10 and click Uninstall.
  5. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*