pioburst Command

Purpose

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

Syntax

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

Description

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:

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

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

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

Item	Description
/usr/lpd/pio/etc/pioburst	Contains the pioburst command.