Control-M for AWS Athena

AWS Athena is a cloud-computing platform that you can use for data processing, analysis, and storage.

Control-M for AWS Athena enables you to do the following:

  • Execute and save new and predefined queries to a table or a Amazon S3 bucket file.
  • Manage AWS Athena credentials in a secure connection profile.
  • Connect to any AWS Athena endpoint.
  • Integrate AWS Athena jobs with other Control-M jobs into a single scheduling environment.
  • Attach an SLA job to your AWS Athena jobs.
  • Introduce all Control-M capabilities to Control-M for AWS Athena including advanced scheduling criteria, complex dependencies, Resource Pools, Lock Resources, and variables.
  • Run 50 AWS Athena jobs simultaneously per Agent.

Control-M for AWS Athena Compatibility

The following table lists the prerequisites that are required to use the AWS Athena plug-in, each with its minimum required version.

Control-M Application Integrator9.0.20.201
Control-M Web9.0.20.200
Control-M Automation API9.0.20.250

Control-M for AWS Athena is supported on Control-M Web and Control-M Automation API, but not on Control-M client.

To download the required installation files for each prerequisite, see Obtaining Control-M Installation Files.

Setting up Control-M for AWS Athena

This procedure describes how to deploy the AWS Athena plug-in, create a connection profile, and define an AWS Athena job in Control-M Web and Automation API.


Integration plug-ins released by BMC require an Application Integrator installation at your site. However, these plug-ins are not editable and you cannot import them into Application Integrator. To deploy these integrations to your Control-M environment, you import them directly into Control-M using Control-M Automation API.

Before You Begin

Verify that Automation API is installed, as described in Automation API Installation.


  1. Create a temporary directory to save the downloaded files.

  2. Download the AWS Athena plug-in from the Control-M for AWS Athena download page in the EPD site.
  3. Install the AWS Athena plug-in via one of the following methods:
    • (9.0.21 or higher) Use the Automation API Provision service:
      1. Log in to the Control-M/EM Server machine as an Administrator and store the downloaded zip file in the one of the following locations (within several minutes, the job type appears in Control-M Web):
        • Linux: $HOME/ctm_em/AUTO_DEPLOY
        • Windows: <EM_HOME>\AUTO_DEPLOY
      2. Log in to the Control-M/Agent machine and run the provision image command, as follows:
        • Linux: ctm provision image AAT_plugin.Linux
        • Windows: ctm provision image AAT_plugin.Windows
    • ( or lower) Use the Automation API Deploy service, as described in deploy jobtype.
  4. Create an AWS Athena connection profile in Control-M Web or Automation API, as follows:
  5. Define an AWS Athena job in Control-M Web or Automation API, as follows:


To remove this plug-in from an Agent, follow the instructions in Removing a Plug-in. The plug-in ID is AAT052023 .

Was this page helpful? Yes No Submitting... Thank you


  1. Mauricio Romero

    no working ctm provision image AWS_Athena_plugin.Windows, the command correct is ctm provision image AAT_plugin.Windows

    Sep 06, 2023 10:18
    1. Yechezkel Schatz

      Fixed. Thanks, Mauricio.

      Sep 10, 2023 03:43