Digests attribute values for a virtual printer definition into a memory image and stores the memory image in a file.
/usr/lpd/pio/etc/piodigest [ -s DataStreamType ] [ -n DeviceName ] [ -p DirectoryPath ] [ -q PrintQueueName ] [ -t PrinterType ] [ -d QueueDeviceName ] { ColonFileName | - }
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| 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. |
To generate a digested virtual printer definition, enter:
piodigest -d mypro -n lp0 -q proq -s asc -t 4201-3The 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.
| Item | Description |
|---|---|
| /var/spool/lpd/pio/@local/ddi/* | Contains the digested, virtual printer definitions. |
| /usr/lpd/pio/etc/piodigest | Contains the piodigest command. |