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.

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

Corrected Problems

The following table describes the problems that are corrected in Control-M Application Integrator PAAIT.9.0.21.308:

Tracking Number

Description

CTM-12246

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.

CTM-12229

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

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>

CTM-12102

The execution log does not include a failure message when a CLI step fails.

CTM-12061

A REST call fails if one of the URL parameters includes the space character.

CTM-12055

The space character is not recognized as a valid suffix for values in List-type job attributes, and it is ignored.

CTM-12047

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

REST calls are executed twice when configured with Google Cloud authentication.

CTM-12033

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

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

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.

CTM-11937

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

A Web Services REST job fails if its connection profile is set to OAuth2 and Client Secret.

CTM-11903

Chinese, Japanese, and Korean (CJK) characters do not appear correctly in the job execution log.

CTM-11895

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.

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

  1. Log in to the Control-M/Agent host where Control-M Application Integrator is installed.
  2. Download the patch installation package from the Control-M Application Integrator 9.0.21 download page.
  3. Save the downloaded installation package to a temporary directory.
  4. Run the following command to shut down the Agent:
    shut-ag
  5. Navigate to the temporary folder where you downloaded the patch.
  6. Extract the patch tar.Z file, using the following command:
    zcat     PAAIT.9.0.21.308_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.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

  1. Log in to the Control-M/Agent computer.
  2. Download the patch installation package from the Control-M Application Integrator 9.0.21 download page.
  3. Save the downloaded installation package to a temporary directory.
  4. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Stop.
  5. Extract the PAAIT.9.0.21.308_windows_x86_64.zip file.

  6. Navigate to the temporary directory and run the following command:
    PAAIT.9.0.21.308_windows_x86_64.exe

    Note

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

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

  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.308/uninstall.sh
  4. 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 PAAIT.9.0.21.308 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 8 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*