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

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'
```
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'
```
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'
```
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
```

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.