IPS(M) XENIX System V IPS(M)
Name
ips, isbs, ipbs - IMAGEN protocol handlers.
Syntax
/usr/lib/ips [ options ] [ file ]
/usr/lib/isbs [ options ] [ file ]
/usr/lib/isps [ options ] [ file ]
Description
ips, isbs, and ipbs are the lowest level of IMAGEN printer
software. Each handles a different form of communications.
They present a very similar view to higher-level software,
allowing such software to be relatively independent of
communications method.
ips sends files to the IMAGEN printer using the ``sequence
packet protocol'' over RS-232C serial communication lines.
This protocol provides for error detection, retransmission,
status reporting, detection of unrecoverable errors, and
printer usage accounting. The IMAGEN printer must be
configured for ``sequenced packet (V1)'' at the desired baud
rate.
isbs supports the ``serial byte stream'' communications
method over RS-232C serial communication lines. This
protocol provides for flow control, but no error detection
or correction. The IMAGEN printer must be configured for
the ``serial byte stream'' protocol at the desired baud
rate, should use an ``EOF'' character of 0x04, a ``quote''
character of 0x02, an 8-bit-wide data path, XON/XOFF flow
control, and should not ignore unprintable characters.
ipbs supports the ``parallel byte stream'' communications
method, which is essentially similar to isbs but works on
parallel rather than serial ports. The IMAGEN printer must
be configured for the parallel interface, should use an
``EOF'' character of 0x04, a ``quote'' character of 0x02,
and should not ignore unprintable characters.
Neither isbs nor ipbs provides printer-usage accounting.
The following information is common to all these programs.
If no file name is given, the standard input is read.
The following options are recognized:
-Dstring
Imbed string into the document control language of the
file being sent. If an unrecoverable failure occurs
during transmission and the file can be resent, this
string will be resent as well.
Page 1 (printed 8/7/87)
IPS(M) XENIX System V IPS(M)
-astsfile
Save the current printer status in file stsfile.
-idevice
The IMAGEN printer is connected to XENIX special file
device. The default device is the value of DEVICE in
the file /etc/default/imagen.
-llogfile
Save information on the communications needed to send
the input in the file logfile.
-r The standard input is rewindable. Normally, the
standard input is not assumed to be rewindable. Or, if
an explicit file was named, that file is not
rewindable. Normally, an explicitly named file is
assumed to be rewindable.
-s Regardless of what other indications may have been
given, use the standard output as the printer.
-pdebug
Sets various debugging values.
The following options are recognized by all three programs,
but only used by ips and isbs; ipbs ignores them:
-o The line characteristics need to be set up if the
output is being sent to the standard output. Normally,
the characteristics of the standard output are not
changed. Or they do not need to be set up if an
explicit device was given with the -i option.
Normally, the characteristics of named devices are
changed.
-Bspeed
The baud rate of the serial communications lines is
speed. It is assumed that the IMAGEN printer is
capable of running at the specified speed, and that it
has been configured to do so. The default speed is the
value of SPEED in the /etc/default/imagen file.
The following options are recognized by all three programs,
but only used by ips; both isbs and ipbs ignore them:
-Aacctfile
Turns on accounting, and places the accounting
information in file acctfile. This file should be read
by imacct(C). There should be a separate acctfile for
each IMAGEN printer.
-nuser
Page 2 (printed 8/7/87)
IPS(M) XENIX System V IPS(M)
Names the user or account to be credited with this
printing job. Since these programs are normally run by
the spooling system, there is no reasonable default
username. Therefore, if accounting is enabled by use
of the -A option, this option should also be specified.
If it is not, all printing is charged to user ``???.''
-hhost
Names the machine to be credited with originating this
printing job. If not specified, first uname(S) and
then /etc/systemid are used to determine the name of
the local system. If the name of the system cannot be
determined, ``LOCAL'' is used.
The following option is not supported, and the -n option
should be used instead:
-uuid
The user identification number of the person to be
credited with this printing job.
ips, isbs, and ipbs all read /etc/default/imagen to obtain
various default settings. The values obtained, and the
default values, are:
DEVICE=/dev/imagen
The name of the XENIX special file connected to the
IMAGEN printer. This can be overridden with the -i or
-s options.
SPEED=9600
The baud rate of the IMAGEN printer. This is
meaningful only for ips and isbs, and can be overridden
with the -B option.
The values of the default settings can be changed to reflect
the local system configuration. If /etc/default/imagen does
not exist or cannot be read, the above default values are
used.
Page 3 (printed 8/7/87)
IPS(M) XENIX System V IPS(M)
Files
/dev/imagen
Default name of the XENIX special file connected to the
IMAGEN printer.
/dev/null
Default stsfile. See the -a option.
imagen.log
Default logfile. See the -l option.
See Also
imagen(M), ipr(C)
Author
IMAGEN Corporation.
Page 4 (printed 8/7/87)