piomkapqd Command

Purpose

Builds a SMIT dialog to create print queues and printers.

Syntax

To Create a Print Queue for an Existing Printer

piomkapqd -A AttachmentType -p Printer -d DeviceName -h Header-e ]

To Create a Printer and a Print Queue

piomkapqd -A AttachmentType -p Printer -v Device -s Subclass -r Adapter -h Header-e ]

To Create a Printer Attached to a TTY or to Assign Printer Output to a File and Create a New Queue

piomkapqd -A AttachmentType -p Printer-T TTYName |  -f FileName } -h Header-e ]

To Use a User-Defined Attachment for a New Printer and Print Queue

piomkapqd -A AttachmentType -p Printer-d DeviceName ] -c CmdExec -i DiscCmd -o ObjectID -h Header-e ]

Description

The piomkapqd command creates a System Management Interface Tool (SMIT) dialog that allows the user to create new printers and print queues. The piomkapqd command also allows users to add their user-defined attachment types to a SMIT printer or queue definition dialog.

Flags

Item Description
-A AttachmentType Specifies the type of attachment used to connect the printer to the data source. Common values for the AttachmentType variable are:
local
Specifies a local attachment type.
ascii
Specifies an ASCII attachment type.
file
Specifies a file where the data is stored.
-c CmdExec Specifies the value for the cmd_to_execute SMIT command. This flag is used when creating a user-defined attachment dialog. If this flag is not included, the piomkpq command is used as the default.
-d DeviceName Specifies the name of the device, pseudo-device, or file where the output is directed, for example lp0 or tty1.
-e Specifies that an existing print queue is to be used for printer output. The -e prevents the piomkapqd command from creating a new queue.
-f FileName Indicates the name of the file where output is stored.
-h Header Specifies the title or header of the SMIT dialog that is being created.
-i DiscCmd Specifies the value of the cmd_to_discover SMIT command. This flag is used when creating a user-defined attachment dialog. If this flag is not included, the piomkapqd command default value is used to create the dialog.
-o ObjectID Specifies the SMIT object whose ID matches the value of the ObjectID variable.
-p Printer Specifies the printer type as defined in the /usr/lib/lpd/pio/predef directory, for example ibm4019.
-r ParentAdapter Specifies the parent adapter for the printer.
-s Subclass Specifies the subclass type to which the printer belongs. The possible values for the Subclass variable are:
  • parallel
  • rs232
  • rs422
-T TTYName Specifies the name of the TTY attached to the new printer or queue.
-v Device Specifies the device type as defined in the ODM database. The -v flag retrieves printer definitions that are not stored in the /usr/lib/lpd/pio/predef directory.

Examples

  1. To create a SMIT dialog that adds a print queue to an existing local printer, enter:
    piomkapqd -A local -p ibm4019 -d lp0 -h 'Add a New Queue'
  2. To create a SMIT dialog that adds a new printer named lp2 and new print queue attached locally, enter:
    piomkapqd -A local -p ibm4019 -v ibm4019 -s rs232 -r sa0 -h 'Add New Printer'
  3. To create a SMIT dialog that adds a printer attached to a TTY and create a new queue for the printer, enter:
    piomkapqd -A tty -p ibm4039 -T tty12 -h 'Add TTY Printer'
  4. To create a SMIT dialog that directs output to a file name stuff and to create a new queue, enter:
    piomkapqd -A file -p ibm4039 -f stuff -h 'Add Output File' -e
  5. To create a SMIT dialog that adds a user-defined printer attachment type and creates a new queue, enter:
    piomkapqd -A hpJetDirect -p hplj-4 [-d lp0] -c /usr/sbin/mkjetd -i /usr/bin/lsjd -o JetDirect -h 
    'Add New Attachment Type'

File

Item Description
/usr/lib/lpd/pio/etc/piomkapqd Contains the piomkapqd command.