Commands Reference, Volume 4

piodigest Command

Purpose

Digests attribute values for a virtual printer definition into a memory image and stores the memory image in a file.

Syntax

/usr/lpd/pio/etc/piodigest [ -s DataStreamType ] [ -n DeviceName ] [ -p DirectoryPath ] [ -q PrintQueueName ] [ -t PrinterType ] [ -d QueueDeviceName ] { ColonFileName | - }

Description

The piodigest command retrieves virtual printer attribute values from a colon file, builds a memory image of the attribute values and their lookup tables, and writes the constructed memory image to a file. The memory image in the file is then available for access by a print formatter and by the piobe command (the print job manager). The command also creates Object Data Manager (ODM) stanzas for the specified queue and queue devices. The ODM stanzas are used in System Management Interface Tool (SMIT) dialogs. If an attribute called zV is specified and the attribute contains a value of +, the piodigest command performs syntax, reference, and limits validation on all attributes specified in the colon file.

The piodidgest command should be invoked whenever a customized version of a virtual printer definition is initially generated or is later modified. Each invocation of the piodigest command digests the attribute values for one virtual printer definition.

The ColonFileName parameter is the name of the input file in colon format. A colon file contains the attribute values for one virtual printer. A value of - (dash) for the ColonFileName parameter indicates that the colon file should be read from standard input.

The name of the output file that is generated will be of the form:

PrinterType.DataStreamType.DeviceName.PrintQueueName:QueueDeviceName

Flags

-d QueueDeviceName	Specifies the name of the virtual printer (queue device). If this flag is not specified, the virtual printer name specified by the mv attribute from the input colon file is assumed.
-n DeviceName	Specifies the name of the printer device, such as `lp0` for line printer 0, or `lp1` for line printer 1. If this flag is not specified, the device name specified by the mn attribute from the input colon file is assumed.
-p DirectoryPath	Specifies the path name of the directory where the output file is to be generated. If this flag is not specified, the /var/spool/lpd/pio/@local/ddi directory is assumed.
-q PrintQueueName	Specifies the name of the print queue to which the virtual printer is assigned. If this flag is not specified, the print queue name specified by the mq attribute from the input colon file is assumed.
-s DataStreamType	Specifies the printer data stream type. Example data stream types are asc (IBM extended ASCII), ps (PostScript), pcl (HP PCL), and 630 (Diablo 630). If this flag is not specified, the data stream type specified by the md attribute from the input colon file is assumed.
-t PrinterType	Specifies the printer type. Examples are `4201-3` and `ti2115`. If this flag is not specified, the printer type specified by the mt attribute from the input colon file is assumed.

Example

To generate a digested virtual printer definition, enter:

piodigest -d mypro -n lp0 -q proq -s asc -t 4201-3

The attribute values for the virtual printer assigned to the mypro queue device on the proq print queue are digested and stored in the file named 4201-3.asc.lp0.proq:mypro in the /var/spool/lpd/pio/@local/ddi directory.

Files

/var/spool/lpd/pio/@local/ddi/*	Contains the digested, virtual printer definitions.
/usr/lpd/pio/etc/piodigest	Contains the piodigest command.

Related Information

The mkvirprt command, piobe command, pioburst command, pioformat command, piofquote command, pioout command, piopredef command.

The Printer Overview for System Management and Virtual Printer Definitions and Attributes, Printer Code Page Translation Tables, Printer Colon File Conventions, Printer Colon File Escape Sequences, Printer Backend Overview for Programming, Understanding the Interaction between qdaemon and the Backend, Understanding Backend Routines in libqb in AIX 5L Version 5.2 Guide to Printers and Printing.