AWS Job

AWS jobs enable you to define and run AWS Lambda, AWS Step Functions, and AWS Batch services.

The following table describes the AWS job attributes.

Attribute

Service

Description

Connection Profile

N/A

Determines the authorization credentials that are used to connect Control-M to AWS.

Rules:

  • Characters: 1−30

  • Case sensitive: Yes

  • Invalid characters: Spaces

Service

N/A

Determines one of the following AWS cloud-computing services:

  • Lambda: A compute service that enables you to run code on a virtual cluster.

  • Step Function: A visual workflow design service that can integrate other AWS services.

  • Batch: A batch computing service that enables you to manage and run batch computing workloads in AWS.

Function Name

Lambda

Determines the Lambda function to execute.

Variable name: %%AWS-LAMBDA_NAME

Version

Lambda

Determines the Lambda function version.

Variable name: %%AWS-LAMBDA_VERSION

Payload

Lambda

Determines the Lambda function payload in JSON format.

Variable name: %%AWS-LAMBDA_PAYLOAD_JSON

Client Context JSON

Lambda

Defines client-specific information for Lambda.

Variable name: %%AWS-LAMBDA_CUSTOMER_CONTEXT_JSON

Append Log to Output

All services

Determines whether to append the log to the outputClosedA tab in the job properties pane in the Monitoring domain that shows the output of a job, which indicates whether a job ended OK, and used, for example, with jobs that check file location.

State Machine

Step Function

Determines the Step Function state machine to use. A state machine is a workflow.

Variable name: %%AWS-STEP_NAME

Execution Name

Step Function

Defines the name of the Step Function execution.

Variable name: %%AWS-STEP_EXECUTION_NAME

Input

Step Function

Defines the Step Function input in JSON format.

Variable name: %%AWS-STEP_PAYLOAD_JSON

Job Name

Batch

Defines the name of the job.

Variable name: %%AWS-BATCH_JOB_NAME

Job Definition

Batch

Defines the job definition to use for a batch job.

Variable name: %%AWS-BATCH_JOB_DEFINITION

Job Definition Revision

Batch

Defines the job definition revision for a batch job.

Variable name: %%AWS-BATCH_JOB_DEF_REV

Job Queue

Batch

Determines the queue where the batch job is submitted.

Variable name: %%AWS-BATCH_JOB_QUEUE

Parameters

Batch

Defines the following batch job parameters:

  • Name

  • Value

Variable names:

  • %%AWS-BATCH_PARAMETERS-Pnnn-KEY

  • %AWS-BATCH_PARAMETERS-Pnnn-VALUE

Job Type

Batch

Determines one of the following types of batch jobs:

  • Single

  • Array

Variable name: %%AWS-BATCH_JOB_TYPE

Array Size

Batch

Determines the Array size for the batch job.

Default: 2

Job Dependency

Batch

Determines whether this batch job depends on another job, as follows:

  • None

  • Depend on Another Job

Variable name: %%AWS-BATCH_DEPENDS_CHECK

Dependency Type

Batch

Determines the Depend on Another Job type, as follows:

  • Standard

  • Sequential

  • N-to-N

Job ID

Batch

Determines the Depend on Another Job ID.

Container Overrides Command

Batch

Defines the command sent to the batch job container that overrides the default command from the Docker image or batch job definition.

Variable name: %%AWS-BATCH_CONTENTS_COMMAND

Environment

Batch

Defines the following environment variables sent to batch job container.

  • Name

  • Value

Variable names:

  • %%AWS-BATCH_ENV_PARAM-Pnnn-KEY

  • %%AWS-BATCH_ENV_PARAM-Pnnn-VALUE

vCPUs

Batch

Determines the number of virtual CPUs (vCPUs) to reserve for a batch job container.

Variable name: %%AWS-BATCH_CONTENT_ENV_CPU

Memory (MiB)

Batch

Determines the number of mebibytes (MiB; mega binary bites) that are reserved for the batch job

Rule: 4 or more.

Variable name: %%AWS-BATCH_CONTENT_ENV_MEMORY

Job Attempts

Batch

Determines the number of times to rerun a failed batch job.

Variable name: %%AWS-BATCH_RETRY_ATTEMPTS

Execution Timeout

Batch

Determines the timeout duration in seconds for a batch job.

Variable name: %%AWS-BATCH_TIMEOUT

AWS Permission Requirements

The following table lists the AWS Permission Requirements to run AWS jobs:

Service

Required Actions

Lambda

  • InvokeFunction

  • ListFunctions

Step Function

  • ListStateMachines

  • StartExecution

  • DescribeExecution

  • GetExecutionHistory

  • StopExecution

Batch

  • SubmitJob

  • DescribeJobQueues

  • DescribeJobDefinitions

  • DescribeJobs

  • TerminateJob