Azure Job Types

Control-M multiple Microsoft Azure cloud-computing services.

The following topics describe job type attributes for Azure job types:

Azure Job

Azure jobs enable you to run the Azure Functions, Azure Logic Apps, and Azure Batch Account services.

The following table describes the Azure job attributes.

Attribute

Service

Description

Connection Profile

N/A

Defines the connection profile for the job.

Rules:

  • Characters: 1−30

  • Case Sensitive: Yes

  • Invalid Characters: Spaces

Variable Name: %%AZURE-ACCOUNT

Service

N/A

Determines one of the following Azure cloud-computing services:

  • Function

  • Logic Apps

  • Batch Account

Variable Name: %%AZURE-SERVICE_TYPE

You can also use more recent versions of these services, which are available as stand-alone job types. See Azure Functions Job, Azure Job Types, and Azure Batch Accounts Job.

Function

Function

Defines the name of the function you want to run.

Variable Name: %%AZURE- FUNCTION _NAME

Function App

Function

Defines the name of the Function application, which contains the function you want to run.

This field is automatically populated after you define the Function attribute.

Variable Name: %%AZURE- FUNCTION_APP

Parameters

Function

Defines the function parameters that enable you to control the presentation of data, as follows:

  • Key

  • Value

Variable Names:

  • %%AZURE-FUNCTION_PARAMS-Pnnn-KEY

  • %%AZURE-FUNCTION_PARAMS-Pnnn-VALUE

Append Log to Output

All services

Determines whether to add the job 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.

Logic App Name

Logic Apps

Defines the name of the logic app.

Variable Name: %%AZURE-LOGIC_APP_NAME

Request Body

Logic Apps

Defines the script for the expected payload in a logic app service.

Format: JSON

Variable Name: %%AZURE-LOGIC_APP_BODY

Job ID

Batch Account

Defines the job ID.

Variable Name: %%AZURE-BATCH_JOBID

Task Command Line

Batch Account

Defines the commands that the job performs.

Variable Name: %%AZURE-BATCH_ TASK_CMDLINE

Max Wall-Clock Time

Batch Account

Determines the maximum number of days, hours, minutes, or seconds to run the job, as follows:

  • Unlimited

  • Custom: Days, hours, minutes, or seconds

Variable Name: %%AWS-BATCH_ WALLCLOCK

Max Task Retry Count

Batch Account

Determines the number of times to rerun a failed job, as follows:

  • None

  • Unlimited

  • Custom

Variable Name: %%AWS-BATCH_ RETRIES_COUNT

Retention Time

Batch Account

Determines the file retention period, as follows:

  • Unlimited: Retains the job directory and its files indefinitely.
  • Custom: Determines the number of days, hours, minutes, or seconds to retain the job directory and its files.

Variable Name: %%AWS-BATCH_ RETENTION

Azure Batch Accounts Job

Azure Batch Accounts jobs enable you to run large-scale, computer-intensive tasks.

The following table describes the Azure Batch Accounts job attributes.

Attribute

Description

Connection Profile

Defines the connection profile for the job.

Rules:

  • Characters: 1−30

  • Case Sensitive: Yes

  • Invalid Characters: Spaces

Batch Job ID

Defines the name of the job that is created in Azure Portal.

Task ID Prefix

Defines a prefix that is added to the task ID.

Task Command Line

Defines the commands that the job performs.

Max Wall Clock Time

Determines the maximum amount of time the job runs, as follows:

  • Unlimited

  • Custom

Variable Name: %%AWS-BATCH_ WALLCLOCK

Max Wall Time Digits

Defines the Custom maximum number of seconds, minutes, hours, or days the job runs.

Default: 1

Max Wall Time Unit

Determines the Custom units used to define the maximum amount of time the job runs.

  • Seconds

  • Minutes

  • Hours

  • Days

Default: Minutes

Max Task Retry Count

Determines the maximum number of times to rerun a failed job, as follows:

  • None

  • Unlimited

  • Custom

Default: None

Retry Number

Determines the Custom maximum number of times to rerun a failed job.

Default: 1

Retention Time

Determines the file retention period, as follows:

  • Unlimited: Retains the job directory and its files indefinitely.
  • Custom: Determines the number of days, hours, minutes, or seconds to retain the job directory and its files.

Default: Unlimited

Retention Time Digits

Determines the number of seconds, minutes, hours, or days to set the Custom file retention period for.

Default: 1

Retention Time Unit

Determines the unit of time used to set the Custom file retention period for.

  • Seconds

  • Minutes

  • Hours

  • Days

Default: Hours

Append Log to Output

Determines whether to add the job 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.

Status Polling Interval

Determines the number of seconds to wait before checking the status of the Azure Batch Accounts job.

Default: 20

Azure Functions Job

Azure Functions is a cloud service for application development.

The following table describes Azure Functions job attributes.

Attribute

Description

Connection profile

Defines the connection profile for the job.

Rules:

  • Characters: 1−30

  • Case Sensitive: Yes

  • Invalid Characters: Spaces

Variable Name: %%AZURE-ACCOUNT

Function App

Defines the name of the Function application, which contains the function you want to run.

Function Name

Defines the name of the function you want to run.

Optional Input Parameters

Defines function parameters that enable you to control the presentation of data.

Copy

  "param1":"value1",
  "param2":"value2"
}

Rules:

  • Format: JSON

  • If you are not adding parameters, type: {}

Function Type

Determines one of the following types of Azure functions:

  • Activity: A basic unit of work in a Durable Function, which is a type of Azure function.

  • HTTP: An HTTP-triggered function.