Commands Reference, Volume 4

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

-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

/usr/lib/lpd/pio/etc/piomkapqd

Contains the piomkapqd command.

Related Information

The piobe command, piomkpq command .

Printer Overview for System Management, Queuing System Overview for System Management in the AIX 5L Version 5.2 Guide to Printers and Printing.

System Management Interface Tool in the AIX 5L Version 5.2 System Management Concepts: Operating System and Devices.

Printer Backend Overview for Programming in the AIX 5L Version 5.2 Guide to Printers and Printing.