rename—rename an object

Format

Description

The rename command renames an object in the Printer Inventory.

If you rename a component, this command automatically renames the component in all printer definitions that include the component. If you rename a printer definition, this command automatically renames the printer definitions in all printer pool definitions that list the printer definition.

You cannot rename the system configuration definition in the configuration class.

Operands

objectclass

The class of the object that you want to rename. For a list of the object classes, see Table 38.

You cannot specify the configuration class.

name

The name of the object. Names are case-sensitive, so be sure to use the correct uppercase and lowercase letters. Enclose the name in single or double quotation marks if the name contains special characters.

newname

The new name to identify the object. This name must be a unique name for the class of object in the Printer Inventory.

When you create a printer definition, printer-pool definition, job selection rule, or component, specify any combination of 1-17 letters (a-z, A-Z), numbers (0-9), and special characters (such as $ # @ . - = /). Blank characters are not allowed. In an IP PrintWay™ printer definition, use name DFLTNTRY to designate the IP PrintWay default printer definition. The name is case-sensitive.

When you create an FSS or FSA definition, this name must match the name used to define the FSA or FSS to JES. Specify a valid combination of 1-8 letters, numbers, and special characters (# $ @). The first character cannot be numeric. Lowercase letters are converted to uppercase.

If the name contains special characters, enclose the name in single or double quotation marks.

Example -- rename

This example renames the printer definition named lab_printer to new name jim:

pidu -c 'rename printer lab_printer jim ; '