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 Helix Control-M Application Integrator.

Important

Verify that Helix Control-M/Agent 9.0.21.300 or later, which includes Helix Control-M Application Integrator version 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.

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/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.308_GA/PAAIT.9.0.21.308_unix.tar.Z
  4. Save the PAAIT.9.0.21.308_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.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/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.308_GA/PAAIT.9.0.21.308_windows_x86_64.zip
  4. Save the PAAIT.9.0.21.308_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.308_windows_x86_64.zip file.

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

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