rename
You can use the rename command to rename a scheduling item in the database.
Overview
Before you rename an item, make sure no other item with the same name exists in the database. You can use the rename command to move the item to a specified folder at the same time. Specify the folder path before the new_item_identifier (example: /folder path/new_item_identifier). You must have delete and add access to the item to perform the action. When you rename a variable, the variable table that contains the variable is locked and no other user can run commands to lock the variable or the table.
Syntax and command line options
Before you run the command, you must give the name of the item that you want to
modify and a new name. The ;preview parameter is
optional.
ocli model rename | rn Scheduling item =/old_item_identifier//new_item_identifier/ [;preview]
where, - old_item_identifier is the name of the scheduling item.
- new_item_identifier is the name for the selected item to be updated.
For the list of scheduling items that you can use and the required format, see the
following table.
Scheduling items | Description |
---|---|
folder | fol
foldername |
You can specify the name of the folder to update. |
jobs | jobdefinition | jd
[[folder/]workstationame#][folder/]jobname
|
You can specify the jobname to update. You can provide the [folder/]workstationame#] path and the folder that contains the job definition to make the selection more specific. |
sched | jobstream | js
[[folder/]workstationame#][folder/]jstreamname |
You can specify the jstreamname job stream to update. You can provide the [folder/]workstationame#] path and the folder that contains job stream definition to make the selection more specific. |
workstation | ws | cpu
[folder/]workstationame
|
You can specify the name of the workstation to unlock. Optionally, you can specify the path of the folder that contains the required items. Wildcard characters are permitted. |
- ;preview
- If you specify this optional parameter, the results are displayed without the name changes. You can use this option to check on the impact of commands on items when you plan to rename multiple items.
Example
- Run the following command to rename the London job defined
on workstation UK_WKS_1 in folder UK
to job Berlin defined on workstation
Germany_WKS_1 in folder
Germany:
ocli model rn jobs /UK/UK_WKS_1#London /Germany/Germany_WKS_1#Berlin