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

Item Description
-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

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