create and force-create--create an object

create objectclass name [attribute = value]… ;

force-create objectclass name [attribute = value]… ;

The create command creates an object in the Printer Inventory. The object must not exist in the Printer Inventory.

The force-create command does the same function as the create command except that if an object of the same name exists in the same object class, it is replaced.

You cannot use the create command to create the system configuration definition in the configuration class. However, if dynamic configuration is enabled, you can use the force-create command to replace all attributes in the system configuration definition.

objectclass

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

You can specify the configuration class on a force-create command but not on a create command.

name

A name to identify the object. Objects in the same object class cannot have the same name. Also, a printer pool definition (printer-pool object class) cannot have the same name as a printer definition (printer object class).

The name of a trace-parameters object is the three-character daemon type, such as AOP for the Printer Inventory Manager daemon or NET for the NetSpool daemon. See Attributes for the trace-parameters object class for the daemon types.

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 that is used to define the FSA or FSS to JES. Specify a valid combination of 1 - 8 letters, numbers, and national characters (# $ @). The first character cannot be numeric. Blanks and other special characters are not allowed. Lowercase letters are converted to uppercase.

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

Tip: On a force-create command to replace the system configuration definition, specify aopd.conf as the name.

attribute = value

One or more attributes and values. Separate attributes with spaces. For the valid attributes for each object class, see Attribute listing.

• A printer definition can include one or more components. For example, a printer definition can include one Allocation component and one Processing component. When a printer definition includes a component, the attributes that are specified for the component apply to the printer definition as well. To include a component, use the include-object attributes, such as include-allocation and include-processing.
• When you create a printer definition and include components, you can override any attribute that is specified in a component. To do this, specify the same attribute on the create statement for the printer definition. The attribute that you specify on the create statement applies only to the printer definition. The value of the attribute in the component is not changed.
  Tip: If an attribute is specified in a printer definition, and you later change the value for that attribute in an included component, the value in the printer definition remains unchanged.
• You must create components before you create any printer definitions that include these components.
• You must create printer definitions before you create any printer pool definitions that list these printer definitions.
• To help you specify a valid create statement, first use the ISPF panels to create the object in the Printer Inventory and then use the PIDU display or export command to list the attributes for the object.
• If you repeat the same attribute in a create statement, the PIDU program uses the last specification.