Home
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.
Model commands
You can use the model commands to create or modify the item definitions for folders, jobs, job streams, and other scheduling or security items.
new
You can use the new command to create a new scheduling or security item definition.

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.
  - Model commands
    You can use the model commands to create or modify the item definitions for folders, jobs, job streams, and other scheduling or security items.
    - add
      You can use the add command to add scheduling items to the database.
    - delete
      You can use the delete command to remove the scheduling or security items from the database.
    - display
      You can use the display command to view the entire information about the item definitions of the same type.
    - extract
      You can use the extract command to create a text file by copying the item definitions from the database.
    - list
      You can use the list command to view the list of items of the same type.
    - listfolder
      You can use the listfolder command to view the list of folders available in the database.
    - lock
      You can use the lock command to lock access to a scheduling item definition.
    - mkfolder
      You can use the mkfolder command to create new folders.
    - modify
      You can use the modify command to update the existing scheduling or security items in the database.
    - new
      You can use the new command to create a new scheduling or security item definition.
    - rename
      You can use the rename command to rename a scheduling or security item in the database.
    - renamefolder
      You can use the renamefoldercommand to rename folder definitions.
    - replace
      You can use the replace command to replace the existing scheduling or security item definitions in the database.
    - rmfolder
      You can use the rmfolder command to delete folders in the database.
    - unlock
      You can use the unlock command to unlock a scheduling or security item that are locked.
  - Plan commands
    You can use the plan commands to submit and run the job or job streams.
  - 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. You can use the command either with a plan or a model.
  - 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
- Job stream definition
  This topic introduces the job stream definition, that can be managed from the Orchestration CLI and from the Dynamic Workload Console.
- Job definition
  This topic introduces the job definition, that can be managed from the Orchestration CLI and from the Dynamic Workload Console.
- Calendar definition
  This topic introduces the calendar definition, that can be managed from the Orchestration CLI and from the Dynamic Workload Console.
- Folder definition
  This topic introduces the folder definition, that can be managed from the Orchestration CLI and from the Dynamic Workload Console.
- Credentials definition
  This topic introduces credentials definition, that can be managed from the Orchestration CLI and from the Dynamic Workload Console.
- Variable table definition
  This topic introduces the variable table definition, that can be managed from the Orchestration CLI and from the Dynamic Workload Console.
- Workstation definition
  This topic introduces the workstation definition, that can be done from the Orchestration CLI and from the Dynamic Workload Console.
- Managing matching criteria
  In this topic you can find a description of matching criteria.
- Managing time zones
  In this topic you can find information about managing time zones.
- Policy-driven plan
  The new HCL Universal Orchestrator policy-driven adaptive plan makes your workload more autonomous, dynamic and scalable.
- Data exchange and transformation
  This topic explains how you can streamline your workflows using data exchange and transformation.

new

You can use the new command to create a new scheduling or security item definition.

Overview

The new command opens a predefined template in an editor based on the operating system that you run the command on.

On Windows operating system, the predefined template opens in notepad.

In UNIX operating systems, the predefined template opens in Visual Editor.

You can save the template after you customize the definitions. If you do not want to use the predefined template, run the command without adding an item, which opens an empty file.

Note: When you create a variable in an existing variable table, the variable table is locked and no other user can modify it.

Syntax and command line options

Before you run the command, you must add at least one scheduling or security item. You can run the command as follows:

ocli model new scheduling or security item

You can create the following items and use either the spelled out form or the abbreviation as follows:

calendar | cal
folder | fol
parm | vb | variable
vartable | vb
job | jobdefinition | jd
jobstream | js
user | users
accesscontrollist | acl
securityrole | srole

Examples

Run the following command to add a new folder definition:
```
ocli model new folder
```
Run the following command to add a new calendar definition:
```
ocli model new calendar
```