What's new in this version

Support for the AWS job type, enabling you to automate a select list of AWS services and manage the Control-M for AWS connection profile.

Code Reference > Job types

Job:AWS

Two new API commands are now available for management of Site standards defined in Control-M. One of these commands retrieves a list of allowed values defined for a restricted-text field in a Site standard, and the other replaces the defined values with a new set of values. These commands are supported in Control-M environments with Control-M/Enterprise Manager version 9.0.19.000 or later. Currently, the API commands support only the application field in a Site standard.

The Control-M Workbench can now be installed and used as a Docker image.

The Control-M Workbench was tested on Docker version 19.03.1.

You can now use the new run job::modify command to modify the settings of an active job that is currently held (that is, a job for which processing has been stopped), based on job settings that you define through a Job Definitions file.

In addition, the new run job::get command enables you to obtain the details of an active job. The output of this command is especially useful as the basis for your Job Definitions file when performing a Modify action.

run job::modify
run job::get

You can now include an additional header in login requests sent by the CLI using the new additionalLoginHeader property in the environment update command.

This is useful, for example, if your connection with the API server goes through an API Gateway that requires an additional authorization header during login actions.

File Transfer jobs now support file transfers from the local filesystem to an AS2 server using the AS2 protocol. A new AS2 connection profile is available for use by such File Transfer jobs.

Code Reference > Job types

Job:FileTransfer

ConnectionProfile:FileTransfer:AS2

The RerunIntervals and RerunSpecificTimes properties now support folders, in addition to jobs.

RerunIntervals and RerunSpecificTimes

File Transfer jobs now support file transfers from the local filesystem to Amazon S3 storage or S3-compatible storage and vice versa. For such file transfers, the new S3BucketName parameter must be included in the job definitions. New S3 connection profiles are also available for use by these File Transfer jobs.

Code Reference > Job types

Job:FileTransfer

ConnectionProfile:FileTransfer:S3:Amazon

Date and time formats in the response to the run job:log::get command have changed to match the formats in other API calls. The following formats are applied:

• For orderDateFrom and orderDateTo: YYMMDD
• For fromTime and toTime: YYYYMMDDhhmmss

Services > Run service

9.0.19.140

Deployment of a folder fails due to a problematic calendar definition, and returns the error "external validator 'TagSelectionsValidator' is not found."

If a flow is deployed in XML format and it fails to deploy, the tempPasswdFile file, which contains sensitive connection details, is not deleted after completion of the deployment action.

Validation of site standards for a deployed folder is always set to strict.

Resolution: Validation of site standards during folder deployment/build is set to match the DefaultNewFolderStrictness system parameter.

When a folder contains a confirmation calendar with a rule-based calendar defined under it, the deploy jobs::get command returns an error:
"unsupported property \"conf_cal\" = \"<Rule-based_calendar_name""

When folder definitions contain the RerunLimit property, the deploy jobs::get command fails, and an error is issued: "Folder has an unsupported property "max_rerun"..."

If annotation is enabled in Control-M, annotations are required also in API commands. Annotations cannot be set to optional in API commands.

For information about changing the default behavior and setting annotations as optional in API commands, see the Control-M Administrator Guide in the Control-M Online Help.

The run job::modify command returns an error, "No site standard set to folder F." This occurs when site standards are activated, Control-M Workload Change Manager is active, and the Control-M/EM system parameter DefaultNewFolderStrictness is set to R (activated).

DRDEV-50

The deploy jobs::get API command returns the following error: "Failed to get Folder data from Control-M... For input string: \"\""

DRDEV-44

When deploying a folder that is defined in XML, the new folder is not synchronized in Control-M/Server.

DRDEV-30

When deploying a folder that is defined in XML, special characters for the local language are not encoded correctly.

DRDEV-22

When deploying a folder that is defined in XML on an environment that requires annotations, the annotations are not set correctly.

none

Configuration actions performed by the config service do not work on Solaris and AIX.

DRDEV-45

Deployment of a job in XML format times out after a minute, with no user control over the timeout definitions.

To resolve this issue:

1. In the automation-api.properties file, add the emdef_timeout parameter, and set it to a value that is longer than the default 60000 milliseconds (1 minute).
   For example:   emdef_timeout=180000

2. For the new setting to take effect, restart the API process (the emrestsrv process).