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 specify 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.

Table 1. Scheduling items
Scheduling items	Description
`calendars \| calendar \| cal [folder/]calname`	You can specify the `[folder/]calname` that you want to rename. Wildcard characters are permitted.
`domain \| dom domainname`	You can specify the `domainname` that you want to rename. Wildcard characters are permitted.
`folder \| fol foldername`	You can specify the `foldername` to rename.
`jobs \| jobdefinition \| jd [[folder/]workstationame#][folder/]jobname`	You can specify the `jobname` to rename. 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.
`prompt \| pr [folder/]promptname`	You can specify the `[folder/]promptname` to rename. Wildcard characters are permitted.
`resource \| re \| reso [folder/]resourcename`	You must specify the `[folder/]resourcename` that you want to rename. You can provide the `[folder/]workstationame#]` and the folder in which the resource is defined to make the selection more specific. Wildcard characters are permitted.
`runcyclegroup \| rcg [folder/]rcgname]`	You must specify the `[folder/]rcgname]` that you want to rename. Wildcard characters are permitted.
`users \| user [[folder/]workstationame#]username [;password]`	You can specify the `[[folder/]workstationame#]username [;password]` that you want to rename. Wildcard characters are permitted.
`parms \| parm \| variable \| vb [[folder/]tablename.]variablename`	You can specify the `[[folder/]tablename.]variablename` that you want to rename. Wildcard characters are permitted.
`vartable \| vt [folder/]tablename`	You can specify the `[folder/]tablename` that you want to rename. Wildcard characters are permitted.
`workstation \| ws \| cpu [folder/]workstationame`	You can specify the name of the workstation to rename. Optionally, you can specify the path of the folder that contains the required items. Wildcard characters are permitted.
`workstationclass \| wsc [folder/]workstationclassname]`	You must specify the `[folder/]workstationclassname]` that you want to rename. 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
```