Commands Reference, Volume 4

pioburst Command

Purpose

Generates burst pages (header and trailer pages) for printer output.

Syntax

/usr/lpd/pio/etc/pioburst [ -H HostName ] TextFile

The pioburst command retrieves prototype text for a burst page from the file specified by the TextFile variable, fills in the variable fields identified by % escape sequences in the prototype text, and writes the constructed text to standard output. It is invoked as a filter in a pipeline by the print job manager, the piobe command.

The % escape sequences, which are replaced by corresponding values, are:

%A	Specifies the formatting flag values.
%D	Specifies the user to whom the print output is to be delivered.
%H	Specifies the name of the host machine printing the job.
%P	Specifies the time the print job was printed.
%Q	Specifies the time the print job was queued.
%S	Specifies the user who submitted the print job.
%T	Specifies the title of the print job.
%%	Specifies the % (percent sign).

Labels (20 characters long) for each of the variable fields can be specified by using the same escape sequence as for the variable field, except using lowercase letters. For example, to generate a label for the variable field specifying the print job was queued (%Q), use %q. The %e variable represents the label END OF OUTPUT FOR:.

The pioburst command requires the following environment variables to be initialized:

PIOTITLE	Title of the print job (for %T)
PIOQDATE	Time the print job was queued (for %Q)
PIOFROM	User who submitted the print job (for %S)
PIOTO	User to whom the print output is to be delivered (for %D)
PIOFLAGS	Flag values (for %A).

Flags

-H HostName

Specifies that the host name designated by the HostName variable override the default host name (the name of the host machine printing the job).

Example

To generate a header page and send it to standard output, enter:

pioburst /usr/lpd/pio/burst/H.ascii

Files

/usr/lpd/pio/etc/pioburst

Contains the pioburst command.

Related Information

The digest command, piobe command, piodigest command, pioformat command, piofquote command, pioout command, piopredef command.

The Printer Overview for System Management in the AIX 5L Version 5.1 Guide to Printers and Printing.

Printer Colon File Conventions in the AIX 5L Version 5.1 Guide to Printers and Printing.

Printer Colon File Escape Sequences in the AIX 5L Version 5.1 Guide to Printers and Printing.

Printer Code Page Translation Tables in the AIX 5L Version 5.1 Guide to Printers and Printing.

Virtual Printer Definitions and Attributes in the AIX 5L Version 5.1 Guide to Printers and Printing.