Control-M Application Integrator PAAIT.9.0.21.302

BMC Software is releasing patch PAAIT.9.0.21.302 to correct several problems in Helix Control-M Application Integrator.

You need to install this patch on top of Helix Control-M Application Integrator version 9.0.21.300, which is provided with Control-M/Agent since version 9.0.21. 

Corrected Problems

The following table describes the corrected problems included in patch PAAIT.9.0.21.302:

Tracking Number

Description

CTM-11822

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

CTM-11810

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.

CTM-11703

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

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

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

CTM-11601

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

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 the Patch on UNIX/Linux

This procedure describes how to install PAAIT.9.0.21.302 on UNIX/Linux.

Before You Begin

  • Verify that Control-M jobs are not running on the Control-M/Agent.
  • Ensure that you installed Control-M/Agent version 9.0.21.300.
  • 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.302_GA/PAAIT.9.0.21.302_unix.tar.Z
  4. Save the PAAIT.9.0.21.302_unix.tar.Z file in the temporary directory.
  5. Stop the Control-M/Agent by typing the following command:
    shut-ag
  6. Extract the patch tar.Z file, using the following command:
    zcat     PAAIT.9.0.21.302_unix.tar.Z | tar -xvf -
  7. Run the following command
    sh setup.sh
  8. Start the Control-M/Agent by typing the following command:
    start-ag

Installing the Patch on Windows

This procedure describes how to install PAAIT.9.0.21.302 on Windows.

Before You Begin

  • Verify that Control-M jobs are not running on the Control-M/Agent.
  • Ensure that you installed Control-M/Agent version 9.0.21.300.

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.302_GA/PAAIT.9.0.21.302_windows_x86_64.zip
  4. Save the PAAIT.9.0.21.302_windows_x86_64.zip file in the temporary directory.
  5. Stop the Control-M/Agent in Windows Services.
  6. Extract the PAAIT.9.0.21.302_windows_x86_64.zip file.

  7. Run the following command:
    PAAIT.9.0.21.302_windows_x86_64.exe

    Note

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

  8. Start the Control-M/Agent in Windows Services.

Uninstalling the Patch from UNIX/Linux

This procedure describes how to uninstall PAAIT.9.0.21.302 from UNIX/Linux.

Before You Begin

  • Ensure that no jobs are running on the Control-M/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 computer.
  2. Stop the Control-M/Agent by typing the following command:
    shut-ag
  3. Run the following command:
    /<Agent home dir>/ctm/install/PAAIT.9.0.21.302/uninstall.sh
  4. Start the Control-M/Agent by typing the following command:
    start-ag

Uninstalling the Patch from Windows

This procedure describes how to uninstall PAAIT.9.0.21.302 from Windows.

Before You Begin

  • Ensure that no jobs are running on the Control-M/Agent.

Begin

  1. Log in to the Control-M/Agent computer.
  2. Stop the Control-M/Agent in Windows Services.
  3. From the Control Panel, select Program and Features.
  4. Select Control-M Application Integrator 9.0.21.300 Patch 2 and click Uninstall.
  5. Start the Control-M/Agent in Windows Services.

 

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