What's new in this version
New developments in this version are divided into the following categories:
The following new features were introduced in the specified versions:
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.
|184.108.40.206||Services > Environment service||environment update|
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.
|220.127.116.11||Code Reference > Connection Profiles|
|File Transfer jobs now support the FTPS (FTP over SSL) communication protocol. A new type of connection profile is available for use by such File Transfer jobs.||18.104.22.168||Code Reference > Connection Profiles||ConnectionProfile:FileTransfer:FTPS|
|The new config item::recycle command enables you to recycle (that is, restart) a specific Control-M component. Currently, this command supports recycling of Control-M/Agents.||22.214.171.124||Services > Config service||config item::recycle|
The RerunIntervals and RerunSpecificTimes properties now support folders, in addition to jobs.
|126.96.36.199||Code Reference > Job Properties|
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.
|188.8.131.52||Code Reference > Connection Profiles||ConnectionProfile:FileTransfer:S3:Compatible|
A new type of If action, Action:CaptureOutput, now enables you to search job output and capture text from the job output into a variable.
|184.108.40.206||Code Reference > Job Properties||If Actions > Action:CaptureOutput|
|When specifying a Site Standard to enforce on a folder or simple folder, you can now specify values for its Business Fields through the JSON code.||220.127.116.11||Code Reference > Folder||Folder and Simple Folder|
|The Rerun property now supports cyclic folders, in addition to cyclic jobs. The RerunLimit property now also supports folders, in addition to jobs.||18.104.22.168||Code Reference > Job Properties||Rerun and RerunLimit|
|The Confirm property now supports folders, in addition to jobs and subfolders.||22.214.171.124||Code Reference > Job Properties||Confirm|
|When specifying a time period under the When property, you can now use the ActivePeriod parameter to choose between specifying a period of activity (when the job can run) or specifying a period of inactivity (when the job cannot run).||126.96.36.199||Code Reference > Job Properties||Specifying a period when a job can or cannot run|
|When specifying a time period under the When property, you can now specify a predefined Confirmation calendar to use for validation of scheduling dates and you can indicate how to handle jobs that are scheduled for a non-working day in this calendar.||188.8.131.52||Code Reference > Job Properties||Specifying a Confirmation calendar|
|SAP BW job for running and monitoring a Process Chain in SAP Business Warehouse (SAP BW).||184.108.40.206||Code Reference > Job types||Job:SAP:BW:ProcessChain|
|Informatica job for automation of Informatica workflows and an Informatica connection profile.||220.127.116.11|
File Transfer connection profiles were enhanced with several new optional parameters:
|18.104.22.168||Code Reference > Connection Profiles||ConnectionProfile:FileTransfer|
The new run job::waitingInfo command enables you to display the reasons why a waiting job has not yet been executed (for example: missing conditions, resources, hosts, users, or workloads).
|22.214.171.124||Services > Run service||run job::waitingInfo|
|The run order command now supports ordering of z/OS type jobs.||126.96.36.199||Services > Run service||run order|
|The new deploy ai:jobtype and deploy ai:jobtypes::get commands enable you to deploy Application Integrator job types to the Control-M/Agent and to get details of such job types.||188.8.131.52||Services > Deploy service|
The deploy service, which enables you to transfer job and configuration definitions to Control-M, now supports the use of a folder definitions XML file. This is in addition to the job definitions XML file, which was already supported.
For the retrieval of existing definitions, the deploy jobs::get command now enables you to choose the job definitions XML format for the output, in addition to the folder definitions XML format and the JSON format (the default).
|184.108.40.206||Services > Deploy service|
The following changes were made in existing features in the specified versions:
Responses to API commands of the run service no longer display session tokens in URLs.
To display session tokens in URLs in responses to API commands (as in previous versions of the product), you can use a new setting in the automation_api_config file, as described in the Control-M Administrator Guide.
|Values of ||220.127.116.11||Code Reference > Connection Profiles||ConnectionProfile:SAP|
The following table lists issues that have been corrected in the most recent releases:
|none||Configuration actions performed by the ||18.104.22.168|
Deployment of a job in XML format times out after a minute, with no user control over the timeout definitions.
To resolve this issue:
|DRDEV-43||When deploying a job that uses a site standard with a rerun interval, the job fails to validate and issues an internal validation error.||22.214.171.124|
|DRDEV-41||When more than one API session use the same token, after one session logs out, the other sessions might receive a null pointer exception error.||126.96.36.199|
When an order of a folder or job fails, the error message that is returned is empty and does not provide information about the issue.
The deploy jobs::get command returns an erroneous EndFolder=True (that is, folder set to cyclic folder) when the job type is dummy or RunAsDummy=true.
Folder deployment fails with error message "String index out of range".
Installation of a plug-in on an agent using the provision upgrade command fails if the first three characters in the name of the installation package include a numerical character (for example, DR1CM*).
|DRDEV-31||When deploying a folder that has an argument that uses the value of a variable, the variables enter the Control-M/Enterprise Manager in the incorrect order and result in an error.||188.8.131.52|
|DRDEV-25||Uninstallation of an agent using the provision service fails when the Control-M/Server is on a Windows host and a case mismatch is encountered in the host name specified by the system variable.||184.108.40.206|
|DRDEV-27||When the number of GUI sessions is limited in the Control-M environment, the API session is identified as a GUI session and is included in the count of open GUI sessions.||220.127.116.11|
|DRDEV-24||Getting job details using the deploy jobs::get command returns an error when the job contains an array of parameters and the first parameter is not defined.||18.104.22.168|
The config server:agent::delete command fails to delete a Control-M/Agent from the Control-M/Server database when the host name contains .com or .org.
|DRDEV-16||Incorrect job status returned by the run jobs:status::get command for a job that was deleted.||22.214.171.124|
|DRDEV-28||Deployment of a folder with a rule-based calendar but no when property results in daily execution of the jobs within the folder.||126.96.36.199|
Deployment of an Application Integrator connection profile fails on the most recent version of the Control-M/Enterprise Manager.
In the XML file returned by the deploy jobs::get command, newline characters erroneously appear as
Deployment of a connection profile fails when more than one Control-M/Server is defined in the environment.
|CAD-2182||The Access-Control-Allow-Origin: * header returns as a vulnerability in CORS security scans.|
This header has been removed from all request responses.
|DRDEV-13||Application Integrator (AI) job properties that were defined as mandatory are not validated properly.||188.8.131.52|
|DRDEV-14||Deployment failures occur when the Control-M/Server has a patch installed.||184.108.40.206|
|DRDEV-1||In a distributed EM environment, the API server fails to find the Application Integrator endpoint for running or deploying AI jobs.||220.127.116.11|
|DRDEV-15||The API server fails to start or stop on Solaris 10.||18.104.22.168|