Skip to Content

Control-M AI Capabilities

BMC Software is releasing Control-M/EM patch PANFT.9.0.22.031, which enables you to use Control-M AI capabilities on Control-M Self-Hosted and corrects a problem in Control-M/EM on UNIX and Windows, as described in Corrected Problems.

Control-M AI Capabilities

  • Jett AI: A generative AI-based assistant embedded in Control-M that helps you understand and operate your workflows more effectively, and includes the following capabilities:
    • Jobs and monitoring: List and summarize job statuses, job definition changes, and users who have made changes or performed job management actions, based on your user authorization level.
    • Documentation: Ask Jett questions in conversational language about how to use Control-M and receive contextual responses directly from the product documentation. This enables you to obtain relevant information within Control-M to perform tasks and resolve issues.
    • Pre-defined and Favorite Prompts: Select pre-defined prompts from a sample list in Jett and save specific prompts in a Favorites list.
    • Conversational Mode (Preview): Ask Jett questions in a multi-turn conversational format, where Jett remembers prior questions and answers and removes the limitation of interaction via isolated queries. 
  • AI Workflow Creator (Preview): AI Workflow Creator enables you to create Control-M workflows using natural language. You can describe the required workflow, and Control-M generates a workspace that includes folders, sub‑folders, and jobs, which accelerates the initial workflow creation.
Information
Note
  • Preview features enable you to provide early feedback on new ideas. You can raise Support cases for Preview features at Impact Level 3 and 4. Preview feature functionality might be modified in the future.
  • You can mange user access for the Jett AI assistant and the AI Workflow Creator with the User Views tool.

Setting up Control-M AI

This procedure describes how to install and configure Control-M AI in your environment.

Begin

  1. Install Control-M Automation API 9.0.22.060, as described in Control-M Automation API Installation.
  2. Install patch Control-M/EM PANFT.9.0.22.030, as described in Control-M/EM PANFT.9.0.22.030.
  3. Install patch Control-M/EM PANFT.9.0.22.031, as described in Control-M AI Installation.
  4. Install Control-M AI, as described in Control-M AI Installation.
  5. Configure Control-M AI LLM Settings, as described in Configuring Control-M AI LLM Settings.

Control-M AI Installation

Control-M AI must be installed on a Control-M/EM Primary host and a dedicated Control-M/EM Distributed host.

Information
Note
  • Control-M/EM patch 9.0.22.031 is a GA point patch and is not cumulative. You must install Control-M/EM patch 9.0.22.030 before you install this patch. 
  • If you are using an MSSQL database, version 2019 and higher is supported.
  • You cannot run this installation if you are using more than 6 Control-M/Servers.

To install Control-M AI, you must install the following components in sequential order on a Control-M/EM Primary and dedicated Control-M/EM Distributed hosts:

  1. Control-M Automation API 9.0.22.060, as described in Control-M Automation API Installation
  2. Control-M/EM PANFT.9.0.22.031, as described in the following procedures:
  3. Control-M AI patch (Control-M/EM Primary only), as described in the following procedures:

After you have completed these installations, you must install the Control-M AI patch on the Control-M/EM Distributed host, as described in the following procedures:

After you have installed Control-M AI, you need to enable it in System Settings, as described in Configuring Control-M AI LLM Settings.

Control-M AI System Requirements

The following table lists the system requirements to install Control-M AI on a Control-M/Distributed host.

ResourceRequirement
CPU8 cores 
RAM16 GB
Disk Space150 GB
Operating System
  • Microsoft Windows 11
  • Alma Linux
  • Oracle Enterprise Linux
  • RedHat Enterprise Linux

Installing Control-M/EM Patch PANFT.9.0.22.031 on UNIX

This procedure describes how to install Control-M/EM patch PANFT.9.0.22.031 on UNIX.

Information
Important

You must install this patch on every host where Control-M/EM server is installed.

Before You Begin

  • Verify that Control-M Automation API 9.0.22.060 is installed on the Control-M/EM Primary and Distributed hosts before you install this patch, as described in Control-M Automation API Installation.
  • Verify that Control-M/EM 9.0.22 and PANFT.9.0.22.030 is installed on the Primary and Distributed hosts before you install this patch.

Begin

  1. Download the installation package from Control-M/EM 9.0.22 Patches.
  2. Log in to the accounts on the Primary and Distributed hosts where Control-M/EM is installed and copy the installation package to a temporary directory on your local hard drive (not a network drive).
  3. Run the following command on the Primary and Distributed hosts to extract the package:
    unzip -xvf PANFT.9.0.22.031_Linux.zip
    The zip file contains the following files: 
    • PANFT.9.0.22.031.zip
    • PA9TB.9.0.22.001-frontend.zip
    • PA9TB.9.0.22.001-linux-backend.zip
  4. Extract the PANFT.9.0.22.031.zip file to the temporary directory.
  5. From the temporary directory, do one of the following on the Primary and Distributed hosts:
    • Interactive Installation: Run the following command:
      ./install_patch.sh
      The installation file shuts down your Control-M/EM components, installs the patch, and restarts the components.
    • Automatic Installation: Run the following command:
      ./install_patch.sh -s
      The installation file shuts down your Control-M/EM components, installs the patch, and restarts the components.
  6. Follow the on-screen instructions until the installation is complete.
    The installation file shuts down your Control-M/EM components, installs the patch, and restarts the components.

Installing Control-M AI on a Control-M/EM Primary Host on UNIX

This procedure describes how to install Control-M AI on a Control-M/EM Primary host on UNIX.

Information
Note

Control-M AI does not support High Availability.

Before You Begin

Begin

  1. Log in to the Control-M/EM Primary host.
  2. From the temporary directory where you downloaded the PANFT.9.0.22.031_Linux.zip file that you installed, extract the following file:
    PA9TB.9.0.22.001-frontend.zip
  3. Run the following command:
    temp/PA9TB.9.0.22.001-frontend/install_patch.sh

Installing Control-M AI on a Control-M/EM Distributed Host on UNIX

This procedure describes how to install Control-M AI on a Control-M/EM Distributed host on UNIX.

Information
Note

Control-M AI does not support High Availability.

Before You Begin

Begin

  1. Log in to the Control-M/EM Distributed host.
  2. From the temporary directory where you downloaded the PANFT.9.0.22.031_Linux.zip file that you installed, extract the following file:
    PA9TB.9.0.22.001-linux-backend.zip
  3. Run the following command:
    temp/PA9TB.9.0.22.001-linux-backend/install_patch.sh
Information
Note

The installation might take over 30 minutes to complete. Do not close the installer or interrupt the process while it is running.

Installing Control-M/EM Patch PANFT.9.0.22.031 on Windows

This procedure describes how to install Control-M/EM patch PANFT.9.0.22.031 on Windows.

Information
Important

You must install this patch on every host where Control-M/EM server is installed.

Before You Begin

  • Verify that Control-M Automation API 9.0.22.060 is installed on the Control-M/EM Primary and Distributed hosts before you install this patch, as described in Control-M Automation API Installation.
  • Verify that Control-M/EM 9.0.22 and PANFT.9.0.22.030 is installed on the Primary and Distributed hosts before you install this patch.

Begin

  1. Download the installation package from Control-M/EM 9.0.22 Patches.
  2. Log in to the accounts on the Primary and Distributed hosts where Control-M/EM is installed, and copy the installation package to a temporary directory on your local hard drive (not a network drive).
  3. Extract the PANFT.9.0.22.031_Windows.zip file to the temporary directory.
    The zip file contains the following files:
    • PANFT.9.0.22.031.zip
    • PA9TB.9.0.22.001-frontend.zip
    • pA9TB.9.0.22.001-windows-backend.zip
  4. Extract the PANFT.9.0.22.031.zip to the temporary directory.
  5. From the temporary directory, do one of the following:
    • Interactive Installation: Run the following command:
      install_patch.bat
      The installation file shuts down your Control-M/EM components, installs the patch, and restarts the components.
    • Automatic Installation: Run the following command:
      install_patch.bat -s
      The installation file shuts down your Control-M/EM components, installs the patch, and restarts the components.
  6. Follow the on-screen instructions until the installation is complete.
    The installation file shuts down your Control-M/EM components, installs the patch, and restarts the components.

Installing Control-M AI on a Control-M/EM Primary Host on Windows

This procedure describes how to install Control-M AI on a Control-M/EM Primary host on Windows.

Information
Note

Control-M AI does not support High Availability.

Before You Begin

Begin

  1. Log in to the Control-M/EM Primary host.
  2. From the temporary directory where you downloaded the PANFT.9.0.22.031_Windows.zip file that you installed, extract the following file:
    PA9TB.9.0.22.001-frontend.zip
  3. Run the following command:
    C:\temp\PA9TB.9.0.22.001-frontend\install_patch.bat

Installing Control-M AI on a Control-M/EM Distributed Host on Windows

This procedure describes how to install Control-M AI on a Control-M/EM Distributed host on Windows.

Information
Note

Control-M AI does not support High Availability.

Before You Begin

Begin

  1. Log in to the Control-M/EM Distributed host.
  2. From the temporary directory where you downloaded the PANFT.9.0.22.031_Windows.zip file that you installed, extract the following file:
    PA9TB.9.0.22.001-windows-backend.zip
  3. Run the following command:
    C:\temp\PA9TB.9.0.22.001-windows-backend\install_patch.bat
Information
Note

The installation might take over 30 minutes to complete. Do not close the installer or interrupt the process while it is running.

Uninstalling Control-M AI from UNIX

This procedure describes how to uninstall Control-M AI from the Control-M/EM Primary host and Control-M/EM Distributed host on UNIX.

Begin

  1. Log in to the Control-M/EM Primary and Distributed hosts.
  2. Navigate to the following directory:
    <EM_HOME>/patches/PA9TB.9.0.22.001/
  3. Run the following command:
    uninstall_patch.sh

​​​​​Uninstalling Control-M AI from Windows

This procedure describes how to uninstall Control-M AI from the Control-M/EM Primary host and Control-M/EM Distributed host on Windows.

Begin

  1. Log in to the Control-M/EM Primary and Distributed hosts.
  2. Navigate to the following directory:
    <EM_HOME>\patches\PA9TB.9.0.22.001
  3. Run the following command:
    uninstall_patch.bat

Uninstalling Control-M/EM Patch PANFT.9.0.22.031 from UNIX

This procedure describes how to uninstall Control-M/EM patch PANFT.9.0.22.031 on the Control-M/EM Primary host and Control-M/EM Distributed host from UNIX. 

Begin

  1. Log in to the accounts on the Primary and Distributed hosts where Control-M/EM is installed.
  2. Navigate to the following directory:
    <EM_HOME>/patches/PANFT.9.0.22.031
  3. Run the following command:
    ./uninstall_patch.sh
    The uninstall file shuts down your Control-M/EM components, uninstalls the patch, and restarts the components.

Uninstalling Control-M/EM Patch PANFT.9.0.22.031 from Windows

This procedure describes how to uninstall Control-M/EM patch PANFT.9.0.22.031 on the Control-M/EM Primary host and Control-M/EM Distributed host from Windows. 

Begin

  1. Log in to the accounts on the Primary and Distributed hosts where Control-M/EM is installed.
  2. Navigate to the following directory:
    <EM_HOME>\patches\PANFT.9.0.22.031
  3. Run the following command:
    uninstall_patch.bat
    The uninstall file shuts down your Control-M/EM components, uninstalls the patch, and restarts the components.

Configuring Control-M AI LLM Settings

This procedure describes how to configure Control-M AI LLM Settings.

Before You Begin

  • Verify that you have your own AWS Bedrock Claude Sonnet 4 account.
  • Verify that the following services are up:
    • Control-M AI Service - Orchestration Guardrails 
    • Control-M AI Service - Policy Guardrails
    • Control-M AI Service
Information
Note
  • Control‑M AI currently supports only the Claude Sonnet 4 model under the AWS Bedrock framework.
  • To increase the maximum number of non-contextual GenAI requests per day, you must update the MaxNumberEmGenAIRequestsPerDay system parameter, as described in Configuring Control-M/EM System Parameters
  • To increase the maximum number of contextual GenAI requests per day, which allows Jett to retain the context from prior questions, you must define the MaxJettRequestsPerDay_Contextual system parameter twice (GUI Server and CMS), as described in  Adding Control-M/EM System Parameters This limit is enforced only if AI Pilot Preview Features is enabled.
  • To increase the maximum number of Workflow Creator requests per day, you must define the WorkflowCreatorDailyLimit system parameter twice (GUI Server and CMS), as described in  Adding Control-M/EM System Parameters This limit is enforced only if AI Pilot Preview Features is enabled.
  • The Control-M AI responsiveness, availability, and performance might be impacted by the AWS platform throttling mechanism. To prevent this from occurring, you must contact AWS Support to increase the limit of the Request Per Minute (RPM) and Token Per Minute (TPM) parameters.

Begin

  1. From Control-M Web, open the Configuration domain. 
  2. From the drop-down list, select System Settings.
  3. Click the AI Features tab.
  4. Do the following:
    • Enable the following parameters:
      • Enable AI Features
      • AI Pilot Preview Features (Optional)
    • Define the Large Language Model Settings, as defined in Large Language Model Settings.
  5. Click Save.

Corrected Problems

The following table describes the problems that are corrected in Control-M/EM PANFT.9.0.22.031.

Tracking Number

Patch

Description

CTM-134239.0.22.031The tree in the left pane of a Viewpoint in the Monitoring domain unexpectedly auto-scrolls to a selected item after an update.

Known Issues

The following table describes the known issues in Control-M/EM PANFT.9.0.22.031.

Tracking Number

Description

WBL-374563

Control-M AI fails after installation in one of the following scenarios:

  • The Control-M AI Service - Orchestration Guardrails, Control-M AI Service - Policy Guardrails , or Control-M AI Service are down.
  • The Control-M AI Service - Orchestration Guardrails, Control-M AI Service - Policy Guardrails , or Control-M AI Service are up but the following error message appears in the log:
    500 Server Error

Workaround: 

  1. Edit the config.ini file in <EM_HOME>/Jett/server/src.
  2. Set the use_fixed_ports attribute to true in the [INFOSYS GUARDRAILS DYNAMIC PORTS] section, and configure two available ports.

Do not use ports 32400–32499, which might be used by Jett.

WBL-375094

The Jett icon appears in the Application Selector in Control-M Web after Control-M AI is uninstalled.

Workaround: Change the EnableEmGenAI parameter value to N.

WBL-378160

The LLM connection test fails if Annotation is enabled. You can still connect to the LLM without a test.

 

 

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

Control-M 9.0.22