Skip to Content

Control-M for Web Services, Java, and Messaging PACOB.9.0.00.009

BMC Software is releasing Control-M for Web Services, Java, and Messaging patch PACOB.9.0.00.009, which applies an enhancement and corrects the following problems in Control-M for Web Services, Java, and Messaging for UNIX and Windows.

Information

 

Important

Verify that Control-M for Web Services, Java, and Messaging 9.0.00 is installed before you install this patch. This patch is cumulative. You do not need to install previous patches.

Enhancements

You can now convert a Control-M for Web Services job to a Control-M for Web Services REST or Control-M for Web Services SOAP job, as described in the following procedures:

Corrected Problems

The following table describes the problems that are corrected in Control-M for Web Services, Java, and Messaging PACOB.9.0.00.009.

Tracking Number

Description

CTM-6851

Control-M for Web Services 9.0.00.007 jobs output unnecessary HTTP headers and identifiers with the SOAP envelope.

CTM-7913

Control-M for Web Services jobs do not support the PATCH HTTP request method in the Method (REST) attribute.

CTM-8324

Control-M for Web Services jobs fail when they receive an empty 202 Accepted HTTP status code response and an HTTP header with no Content-Type tag.

CTM-8325

Control-M for Web Services jobs fail and return HTTP status code 401 when you select the Require Login checkbox in the Control-M for Web Services connection profile REST login parameter because the login response is not passed to the jobs.

CTM-6536

Apache Log4j is now upgraded to version 2.17.1.

Installing Control-M for Web Services, Java, and Messaging PACOB.9.0.00.009 on UNIX

This procedure describes how to install Control-M for Web Services, Java, and Messaging patch PACOB.9.0.00.009 on UNIX.

Before You Begin

  • Verify that Control-M for Web Services, Java, and Messaging 9.0.00 is installed.
  • Verify that no Control-M jobs are executing on the Agent.
  • Verify that Java 11.0.16 or higher is installed.

Begin

  1. Download the installation package from the Patches tab at Control-M for Web Services, Java, and Messaging.
  2. Log in to the Agent account where Control-M for Web Services, Java, and Messaging is installed, and copy the installation package to a temporary directory on your local hard drive (not a network drive).
  3. From the temporary directory, run the following command to extract the patch installation file:
    • Linux: zcat PACOB.9.0.00.009_linux.tar.Z | tar -xvf -
    • AIX: zcat PACOB.9.0.00.009_aix.tar.Z | tar -xvf -
    • Solaris: zcat PACOB.9.0.00.009_solaris.tar.Z | tar -xvf -
  4. Navigate to the Control-M/Agent home directory and run the following command to shut down the Agent:
    shut-ag

    InformationIf Control-M/Agent was installed on the root or running as the the root user, you must log in as the root user to stop the Agent.
     
  5. Run the following commands to stop the Control-M for Web Services, Java, and Messaging plug-in:
    • ${HOME}/ctm/cm/WS/exe/stopwscm
    • ${HOME}/ctm/cm/JAVA/exe/stopjavacm
    • ${HOME}/ctm/cm/MSG/exe/stopmsgcm

  6. Run the following command to verify that the Control-M for Web Services process ID (PID) is deleted:
    ps -ef | grep wscm
    A one-line response appears.

    Information
    Important

    If the response exceeds one line in length, you must run the following command to kill the PID and repeat this step to verify that the Control-M Web Services process has been deleted:
    kill -9 <PID>

  7. If Control-M/Agent is installed on an AIX operating system, run the following command to clear shared libraries from the memory:
    /usr/sbin/slibclean
  8. Navigate to the extracted PACOB.9.0.00.009 directory and run the following command to install the patch:
    install_patch.sh
  9. Change the JRE package, as described in Changing the JRE Package in Control-M for Web Services, Java, and Messaging.

  10. Run the following command to start the Agent: start-ag

    Information
    Important

    If Control-M/Agent was installed on the root or running as the the root user, you must log in as the root user to start up the Agent.

Installing Control-M for Web Services, Java, and Messaging PACOB.9.0.00.009 on Windows

This procedure describes how to install Control-M for Web Services, Java, and Messaging patch PACOB.9.0.00.009 on Windows.

Before You Begin

  • Verify that Control-M for Web Services, Java, and Messaging 9.0.00 is installed.
  • Verify that no Control-M jobs are executing on the Agent.
  • Verify that Java 11.0.16 or higher is installed.

Begin

  1. Download the installation package from the Patches tab at Control-M for Web Services, Java, and Messaging.
  2. Log in as an administrator to the Agent account where Control-M for Web Services, Java, and Messaging is installed, copy the installation package to a temporary directory on your local hard drive (not a network drive), and extract the package.
  3. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Stop.
  4. Run the following command to stop the Control-M for Web Services, Java, and Messaging plug-in:
    • <Agent_Home>\cm\WS\exe\stopwscm
    • <Agent_Home>\cm\JAVA\exe\stopjavacm
    • <Agent_Home>\cm\MSG\exe\stopmsgcm
  5. Do the following to verify that Control-M for Web Services, Java, and Messaging is stopped:
    1. Press CTRL+ALT+DELETE, click Task Manager, and click the Details tab.
      The Windows Task Manager Details tab appears.
    2. Right-click on a column, select Select Columns, then select the Command Line checkbox, and then click OK.
      The Command Line column appears in the Details tab.
    3. In the Name column, locate the javaw.exe task and if you find it, in the Command Line column, verify that the line contains the following string:
      CM\WS\EXE
    4. If CM\WS\EXE appears in the Command Line of the javaw.exe task, right-click on the javaw.exe task and then select End Task from the drop-down list.
      The javaw.exe task disappears from the Details tab table.
  6. Navigate to the temporary directory and run the following command:
    PACOB.9.0.00.009\install_patch.bat
  7. Change the JRE package, as described in Changing the JRE Package in Control-M for Web Services, Java, and Messaging.
  8. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.

Uninstalling Control-M for Web Services, Java, and Messaging Patch PACOB.9.0.00.009 from UNIX

This procedure describes how to uninstall Control-M for Web Services, Java, and Messaging patch PACOB.9.0.00.009 from UNIX. The original Control-M for Web Services connection profile, wsprofile.dat, is not restored. However, this connection profile is saved as wsprofile.dat.install_saved in the <Agent_Home>/data directory.

Before You Begin

  • Verify that no Control-M jobs are executing on the Agent.

Begin

  1. Log in to the Agent account where Control-M for Web Services, Java, and Messaging is installed.

  2. Run the following command to shut down Control-M/Agent:
    shut-ag

    Information
    Important

    If Control-M/Agent was installed on the root or running as the the root user, you must log in as the root user to stop the Agent.

  3. Run the following command to stop the Control-M for Web Services, Java, and Messaging plug-in:
    • ${HOME}/ctm/cm/WS/exe/stopwscm
    • ${HOME}/ctm/cm/JAVA/exe/stopjavacm
    • ${HOME}/ctm/cm/MSG/exe/stopmsgcm

  1. Run the following command to verify that the Control-M for Web Services process ID (PID) is deleted:
    ps -ef | grep wscm
    A one-line response appears. 

    Information
    Important

    If the response exceeds one line in length, you must run the following command to kill the PID and repeat this step to verify that the Control-M Web Services process has been deleted:
    kill -9 <PID>

  2. If Control-M/Agent is installed on an AIX operating system, run the following command to delete unused libraries:
    ${HOME}/usr/sbin/slibclean

  3. Run the following command:

    PACOB.9.0.00.009/uninstall_patch.sh

  4. From the Agent account, run the following command to start up the Agent:
    start-ag

    Information
    Important

    If Control-M/Agent was installed on the root or running as the the root user, you must log in as the root user to start up the Agent.

Uninstalling Control-M for Web Services, Java, and Messaging Patch PACOB.9.0.00.009 from Windows

This procedure describes how to uninstall Control-M for Web Services, Java, and Messaging patch PACOB.9.0.00.009 from Windows. The original Control-M for Web Services connection profile, wsprofile.dat, is not restored. However, this connection profile is saved as wsprofile.dat.install_saved in the <Agent_Home>\data directory.

Before You Begin

  • Verify that no Control-M jobs are executing on the Agent.

Begin

  1. Log in as an administrator to the Agent account where Control-M for Web Services, Java, and Messaging is installed.Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Stop.
  2. Run the following command to stop the Control-M for Web Services, Java, and Messaging plug-in:
    • <Agent_Home>\cm\WS\exe\stopwscm
    • <Agent_Home>\cm\JAVA\exe\stopjavacm
    • <Agent_Home>\cm\MSG\exe\stopmsgcm
  3. Do the following to verify that Control-M for Web Services, Java, and Messaging is stopped:
    1. Press CTRL+ALT+DELETE, click Task Manager, and click the Details tab.
      The Windows Task Manager Details tab appears.
    2. Right-click on a column, select Select Columns, then select the Command Line checkbox, and then click OK.
      The Command Line column appears in the Details tab.
    3. In the Name column, locate the javaw.exe task and if you find it, in the Command Line column, verify that the line contains the following string:
      CM\WS\EXE
    4. If CM\WS\EXE appears in the Command Line of the javaw.exe task, right-click on the javaw.exe task and then select End Task from the drop-down list.
      The javaw.exe task disappears from the Details tab table.

  4. From the <Agent Home> directory, run the following command:
    PACOB.9.0.00.009\uninstall_patch.bat

  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*

Control-M 9.0.21