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
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.
| /var/spool/lpd/pio/@local/ddi/* | Contains the digested, virtual printer definitions. |
| /usr/lpd/pio/etc/piodigest | Contains the piodigest command. |
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.1 Guide to Printers and Printing.