lp(1) MPE/iX Shell and Utilities lp(1)
______________________________________________________________________
NAME
lp -- send files to a printer
SYNOPSIS
lp [-crs] [-d dest] [-n num] [-p priority] [-t title] [file...]
DESCRIPTION
lp prints one or more input files to a printer. If you do not
specify any files on the command line or you specify a filename
of -, lp reads and prints the standard input. lp prints files in
the same order that you specify them on the command line.
On MPE/iX, the capabilities possessed by individual users deter-
mines whether or not they can change a given spoolfile. Users
with SM or OP capability can make unrestricted changes to all
spoolfiles. Users with AM capability can make unrestricted
changes to spoolfiles belonging to the same account as the user.
Generic users and those with capabilities other than SM, OP, or
AM can only make changes to their own spoolfiles.
Options
lp accepts the following options.
-c immediately makes a copy of the files to be printed. This
ensures that lp prints the version of the file that exists
when you make the print request.
Note: This is the default behavior on MPE/iX. As a result,
this option has no effect and is ignored.
-d dest
specifies dest as the output device. If dest is a printer,
the files are printed only on that specific printer. If
dest is a class of printers, the files are printed on the
first available printer of that class. If dest is an inte-
ger, it specifies an ldev. If dest begins with \*, it
specifies a file equation to be used. -d takes precedence
over the LPDEST environment variable which in turn takes
precedence over the PRINTER environment variable. If this
option is not specified and neither LPDEST nor PRINTER is
set, lp assumes the output device is LP.
-n num
prints num copies of each input file (the default is 1).
The maximum value for num is 127.
-p priority
assigns a priority to the print job. This priority is used
to select the next spooled job for the targeted printer or
class of printers. priority is a number between 0 (lowest
priority) and 13 (highest priority). If this option is not
specified, a default priority of 8 is assigned.
1
lp(1) MPE/iX Shell and Utilities lp(1)
______________________________________________________________________
-r sends files to their destinations without automatically
inserting a carriage return/linefeed combination after each
line.
-s suppresses progress messages from lp.
-t title
prints title on the banner page of the output.
ENVIRONMENT VARIABLES
lp uses the following environment variables:
LPDEST
names the output device. This variable takes precedence
over PRINTER.
PRINTER
names the output device if LPDEST is not defined.
DIAGNOSTICS
Possible exit status values are:
0 Successful completion.
>0 An error occurred.
Messages
Message: argument to -p must be numeric
Cause: You specified a non-numeric priority.
Action: Specify a numeric priority
Message: argument to -n must be numeric
Cause: You specified the number of copies in non-numeric form.
Action: Specify the number of copies in numeric form.
Message: number of copies requested must be between 1 and 127
inclusive
Cause: You specified a number of copies that was not in the
range from 1 to 127.
Action: Specify the number of copies in the range of 1 to 127
or use lpalt to change the number of copies to any
value up to 65535.
Message: print priority value must be 0 to 13 inclusive
Cause: You specified a priority outside of the range 0 to 13.
Action: Specify a priority between 0 and 13 inclusive. You can
use the lpalt command to specify a priority of 14.
Message: destination specified is invalid
Cause: The ldev or class specified is not available or does
not exist.
2
lp(1) MPE/iX Shell and Utilities lp(1)
______________________________________________________________________
Action: Specify a destination that is available and exists.
Message: could not submit print request, subsystem 143 (HPFOPEN)
error: err_num err_description
Cause: The MPE/iX system spooler did not accept the print
request.
Action: Consult the MPE/iX Error Messages Manual, Volume I.
FILES
lp uses the following file:
/etc/termcap
contains entries that describe terminal controlling
features.
PORTABILITY
POSIX.2. x/OPEN Portability Guide 4.0.
The -p, -r, -s, and -t options are extensions to the POSIX stan-
dard.
SEE ALSO
cancel(1), lpalt(1), lpstat(1)
3