create and force-create—create an object in the Printer Inventory

Format

Description

The create command creates an object in the Printer Inventory. The object must not already 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 and in the same object class exists, it is replaced.

Operands

objectclass

The class of the object that you want to create. Valid values are fsa and psf-fss.

name

A name to identify the object. Objects in the same object class cannot have the same name.

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

attribute = value

One or more attributes and values. Separate attributes with spaces.

Usage notes

• 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, PIDU uses the last specification.

Examples -- create and force-create

Creating a PSF FSS definition

This example creates an FSS definition for a PSF functional subsystem (FSS) named PSFFSS:

pidu -c 'create psf-fss PSFFSS
         tcpip-job-name = TCPIP;'

Creating a PSF FSA definition

This example creates an FSA definition for a PSF functional subsystem application (FSA) named PRT003:

pidu -c 'create fsa PRT003
         fsa-type = psf-tcpip
         form-definition = A10110
         location = "Bldg 3"
         page-definition = A08682
         printer-ip-address = 9.99.12.33;'

The attributes set in this definition are:

• fsa-type: The printer is a TCP/IP-connected PSF printer.
• form-definition: This attribute names the default form definition for the printer.
• location: This attribute describes the location of the printer.
• page-definition: This attribute names the default page definition for the printer.
• printer-ip-address: This attribute identifies the IP address of the printer.