Control-M Application Integrator PAAIT.9.0.21.302


BMC Software is releasing Control-M Application Integrator patch PAAIT.9.0.21.302, which corrects the following problems in Control-M Application Integrator.

Information
Important

Verify that Control-M/Agent 9.0.21.300, which includes Control-M Application Integrator 9.0.21.300, is installed before you install this patch.

Corrected Problems

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

Tracking Number

Description

Impacted Integrations

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

Any user-defined Application Integrator plugin.

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.

Any user-defined Application Integrator plugin. 

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

  • Any user-defined Application Integrator plugin. 
  • All Control-M Integrations plugins excluding Datastage and microfocus plugins,

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

Any user-defined Application Integrator plugin. 

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 Control-M Application Integrator Patch PAAIT.9.0.21.302 on UNIX

This procedure describes how to install Control-M Application Integrator patch PAAIT.9.0.21.302 on UNIX.

Before You Begin

  • Verify that Control-M jobs are not running on the Control-M/Agent.
  • Ensure that you installed Control-M Application Integrator version 9.0.21.300.
    If you have already installed patch PAAIT.9.0.21.301, you can install this patch on top of the previous patch.
  • 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. Download the patch installation package from the Control-M Application Integrator 9.0.21 download page.
  2. Log in to the account where Control-M/Agent is installed and copy the installation package to a temporary directory on your local hard drive (not a network drive).
  3. Stop the Control-M/Agent by typing the following command:
    shut-ag
  4. Navigate to the temporary folder where you downloaded the patch.
  5. Extract the patch tar.Z file, using the following command:
    zcat 
    PAAIT.9.0.21.302_unix.tar.Z | tar -xvf -
  6. Run the following command
    sh setup.sh
  7. Start the Control-M/Agent by typing the following command:
    start-ag

Installing Control-M Application Integrator Patch PAAIT.9.0.21.302 on Windows

This procedure describes how to install Control-M Application Integrator patch 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 Application Integrator version 9.0.21.300.
    If you have already installed patch PAAIT.9.0.21.301, you can install this patch on top of the previous patch.

Begin

  1. Download the patch installation package from the Control-M Application Integrator 9.0.21 download page.
  2. Log in to the account where Control-M/Agent is installed, copy the installation package to a temporary directory on your local hard drive (not a network drive), and then extract the package.
  3. Stop the Control-M/Agent in Windows Services.
  4. Run the following command:
    PAAIT.9.0.21.302_windows_x86_64.exe


    InformationIf User Account Control (UAC) is enabled, you must run the executable as an Administrator.
     

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

Uninstalling Control-M Application Integrator Patch PAAIT.9.0.21.302 from UNIX

This procedure describes how to uninstall Control-M Application Integrator patch PAAIT.9.0.21.302 from UNIX.

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 Control-M Application Integrator Patch PAAIT.9.0.21.302 from Windows

This procedure describes how to uninstall Control-M Application Integrator patch 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*

Control-M 9.0.21