Welcome
Orchestrating
Orchestrate anything with HCL Universal Orchestrator.
Orchestration CLI commands
You can use the various command options in Orchestration CLI to achieve specific results. The command options are not case sensitive and you can use either uppercase or lowercase letters.
Orchestration CLI keywords
You can use Orchestration CLI keywords when defining a workflows and tasks.
Validity keywords
In this topic you can find the list of validity keywords.

What's new
HCL Universal Orchestrator is constantly evolving to offer you the most comprehensive orchestration capabilities. For known limitations, workarounds, and contact information of HCL Customer Support, see Release notes.
What is HCL Universal Orchestrator
An introductory overview of HCL Universal Orchestrator.
Deploying and Administrating
All the information you need to deploy and administrate HCL Universal Orchestrator.
Using the UI
The UI is the HCL Universal Orchestrator interface, from which you can smoothly design your scheduling environment and monitor every process.
Orchestrating
Orchestrate anything with HCL Universal Orchestrator.
- Orchestration CLI commands
  You can use the various command options in Orchestration CLI to achieve specific results. The command options are not case sensitive and you can use either uppercase or lowercase letters.
  - Access required to run Orchestration CLI commands
    You must have specific permissions to run each command in Orchestration CLI. The level of access to run the command is customizable and you can use Dynamic Workload Console (DWC) or Orchestration CLI to manage the roles.
  - Context commands
    The term context refers to the set of parameters in the config.yaml file that is used to establish an environment to run HCL Universal Orchestrator. You can create multiple contexts in the config.yaml file to manage the workload. This helps you to utilize the resources in a more efficient manner.
  - Model commands
    You can use the model commands to create or modify the item definitions for folders, tasks, workflows, and other scheduling or security items.
  - Plan commands
    You can use the plan commands to submit and run the task or workflows.
  - Plug-in commands
    You can use the plug-in commands to install, delete, or update plug-ins supported by HCL Universal Orchestrator.
  - help
    You can use the help command to view the online help or details about the commands that Orchestration CLI supports.
  - version
    You can use the version command to view the version of Orchestration CLI that is installed in your system.
  - Orchestration CLI keywords
    You can use Orchestration CLI keywords when defining a workflows and tasks.
    - Dependency keywords
      In this topic you can find the list of dependency keywords.
    - nop
    - Run cycle keywords
      In this topic you can find the list of run cycle keywords.
    - Time restriction keywords
      In this topic you can find the list of time restriction keywords.
    - Validity keywords
      In this topic you can find the list of validity keywords.
  - Managing multiple config.yaml files
    You can create multiple config.yaml files in the database to run commands on different contexts without changing the default context. The feature permits you to use multiple config.yaml files at the same time.
  - Managing multiple formats
    You can set the format by configuring the config.yaml file or by adding the parameter in model commands.
  - Modifying context parameter temporarily
    You can temporarily modify the parameters in the default config.yaml file when you run a plan, model or plug-in command. This feature permits you to customize the behavior of a specific command without modifying the entire config.yaml file.
  - Special characters as wildcards and delimiters
    When you want to use filters to select scheduling items in the database, you can use a list of selected special characters as wildcards and delimiters.
  - Orchestration CLI return codes
    Orchestration CLI return codes
- Workflow definition
  A workflow is a set of tasks to be run, together with times, priorities, and other dependencies that define the processing order.
- Task definition
  A task definition is a unit of work that specifies an action to be performed on specific workstations in the HCL Universal Orchestrator network.
- Event source definition
  An event source is an item that allows HCL Universal Orchestrator to receive events from specific event plug-ins.
- Calendar definition
  Calendars define the days in which workflows do or do not run.
- Folder definition
  You can use folders to organize your items accordingly to your business needs.
- Credentials definition
  Credential definitions are used to store user IDs and passwords, or tokens.
- Variable table definition
  Variables are values that can change according to the purpose of workflows and task templates.
- Workstation definition
  A workstation is a scheduling item that runs tasks.
- Event plug-in structure
- Managing matching criteria
  In this topic you can find a description of matching criteria.
- Parsing OCLI files in streaming
  HCL Universal Orchestrator enables you to add or replace files containing multiple item types through OCLI in a single command.
- Data exchange and transformation
  This topic explains how you can streamline your workflows using data exchange and transformation.
Orchestrating from Mobile
You can use your mobile devices to manage quickly and easily your whole HCL Universal Orchestrator environment.
Monitoring
Take your environment under control.
Using REST API
Use REST APIs to easily integrate workload scheduling capabilities with external products and solutions.
Uno AI Pilot
Welcome to the HCL Universal Orchestrator AI Pilot documentation. This resource is designed to guide you through everything you need to know about using UnO AI Pilot effectively. You will find detailed instructions, feature overviews, and helpful tips to ensure you get the best experience with UnO AI Pilot.
Troubleshooting
Recover your environment if any issue occurs.
Notices

Validity keywords

In this topic you can find the list of validity keywords.

This topic lists the keywords that you can use when planning a workflow. You can find the syntax of the scheduling keywords and related examples.

In this topic you can find the following validity keywords:

validfrom / validto
draft

validfrom / validto

These keywords specify a time frame in which a workflow definition is valid.

Syntax

validfrom date

Arguments

validfrom date: Using this keyword, you can define from which date the workflow definition is valid.; If a validfrom date is not defined within the run cycle, by default the value is set to 2020/01/01.

Comments

You can define different versions of the same workflow by creating other workflows with the same name and workstation, but with different validity intervals. The workflow identified as the dependency is the one that has a validity interval coincident with the period in which the dependency is active. When you define a workflow version, you must enter the validfrom date only. The validto value is automatically set according to the validfrom date of the following version.

The validto date specified in the run cycle is not included in the run cycle, so the workflow does not run on that date.

The validto date is shown when issuing list and display command when MAESTROCOLUMNS is set to 120.

Example

In the following example, the WORKFLOW1 workflow, which contains the TASK_1 task, is active from December 1, 2024.
```
SCHEDULE WS_AGT_1#WORKFLOW1 VALIDFROM 12/01/2024 
:
WS_AGT_0#TASK_1

END
```

draft

You can use this keyword to save the workflow as a draft so that it is not included in the plan generation process. If the workflow is referenced by dependencies, such workflow is not considered.

Syntax

draft

Comments

If you save as draft an existing task which has already been referenced, all the instances of that task do not run and the dependencies are realeased.

Example

In the following example, the WORKFLOW1 workflow is active from December 1, 2024, though it is marked as draft and thus it is not included in the plan. WORKFLOW1 contains the TASK_2 task.

SCHEDULE WS_AGT_1#WORKFLOW1 VALIDFROM 12/01/2024 
DRAFT
:
WS_AGT_0#TASK_2

END