Control-M/Agent PAFZ4.9.0.22.052

BMC Software is releasing Control-M/Agent PAFZ4.9.0.22.052 to correct various issues in Control-M Application Integrator.

Corrected Problems

The following table describes the Control-M Application Integrator problems that are corrected in patch PAFZ4.9.0.22.052.

Tracking Number	Description	Impacted Integrations
CTM-14493	Jobs created with Control-M Application Integrator on Windows might remain stuck in Executing state if any runtime parameters generated from the Output Handling definitions contain newline characters.	Any user-defined Application Integrator plug-in Azure Data Factory
CTM-13804	Execution logs that are created during job execution and grow in size to several megabytes might result in significant memory usage.	Any user-defined Application Integrator plug-in Micro Focus
CTM-14482	Application Integrator jobs fail, and the following error appears in the logs: xml_buff_size is over MAX_XML_REQUEST_SIZE. stop adding XML elements to avoid 'xml element value too long' error This error is generated even though the maximum request size was not reached.	Any user-defined Application Integrator plug-in
CTM-14511	The Contains and Equals (=) operators in the Fail the job if extracted data field in Output Handling definitions do not trigger job failure as expected.	Any user-defined Application Integrator plug-in

Installing Patch PAFZ4.9.0.22.052 on UNIX

This procedure describes how to install Control-M/Agent patch PAFZ4.9.0.22.052 for Application Integrator on UNIX.

Before You Begin

• Verify that Control-M Application Integrator 9.0.22.050 is installed before you install this patch.
• Verify that no Control-M jobs are executing on the Agent.
• (AIX only) Log in as a root user and run the following command to remove unused libraries from the memory:
  /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/Agent 9.0.22 download page.
3. Save the downloaded installation package to a temporary directory.
4. If necessary, rename the downloaded file from PAAIT.9.0.22.052_unix.z to PAAIT.9.0.22.052_unix.tar.Z.
5. Run the following command to shut down the Agent:
   shut-ag
6. Navigate to the temporary folder where you downloaded the patch.
7. Extract the patch tar.Z file, using the following command:
   zcat PAAIT.9.0.22.052_unix.tar.Z | tar -xvf -
8. Run the following command:
   sh setup.sh
9. Follow the on-screen instructions until the installation is complete.
10. Run the following command to start the Agent:
    start-ag
    After the installation completes, the new Agent version (9.0.22.052) might take several hours to appear in the Configuration domain.

11. (Optional) To immediately update the Agent version in Control-M/EM, from the Agent host run the ag_ping utility.

Installing Patch PAFZ4.9.0.22.052 on Windows

This procedure describes how to install Control-M/Agent patch PAFZ4.9.0.22.052 for Application Integrator on Windows.

Before You Begin

• Verify that Control-M Application Integrator 9.0.22.050 is installed before you install this patch.
• Verify that no Control-M jobs are executing on the Agent.

Begin

1. Log in to the Control-M/Agent host.
2. Download the patch installation package from the Control-M/Agent 9.0.22 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.22.052_windows_x86_64.zip file.

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

   Information

   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.
   After the installation completes, the new Agent version (9.0.22.052) might take several hours to appear in the Configuration domain.
9. (Optional) To immediately update the Agent version in Control-M/EM, from the Agent host run the ag_ping utility.

Uninstalling Patch PAFZ4.9.0.22.052 from UNIX

This procedure describes how to uninstall Control-M/Agent patch PAFZ4.9.0.22.052 for Application Integrator from UNIX.

Before You Begin

• Verify that no Control-M jobs are executing on the Agent.
• (AIX only) Log in as a root user and run the following command to remove unused libraries from the memory:
  /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.22.052/uninstall.sh
4. Run the following command to start up the Agent:
   start-ag
5. (Optional) To immediately update the Agent version in Control-M/EM, from the Agent host run the ag_ping utility.

Uninstalling Patch PAFZ4.9.0.22.052 from Windows

This procedure describes how to uninstall Control-M/Agent patch PAFZ4.9.0.22.052 for Application Integrator 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.22.050 Patch 2 and click Uninstall.
5. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.
6. (Optional) To immediately update the Agent version in Control-M/EM, from the Agent host run the ag_ping utility.