qpr(1)
qpr - submit a hardcopy print request to NQS
SYNOPSIS
qpr [-a date-time ] [-f form-name ] [-mb] [-me]
[-mu user-name ] [-n number-of-copies ] [-p priority ]
[-q queue-name ] [-r request-name ] [-z] [ files ]
DESCRIPTION
Qpr places the named files in a Network Queueing System
(NQS) queue to be printed by a device such as a line printer
or laser printer. If no files are specified, qpr will read
from the standard input.
In the absence of the -z flag, qpr will print a request-id
on the standard output, upon successful queueing of a
request. This request-id can be compared with what is
reported by qdev(1) and qstat(1) to find out what happened
to a request, and given as an argument to qdel(1) to delete
a request. A request-id is always of the form:
seqno.hostname where seqno refers to the sequence number
assigned to the request by NQS, and hostname refers to the
name of originating local machine. This identifier is used
throughout NQS to uniquely identify the request, no matter
where it is in the network.
The following options to qpr may appear in any order and may
be intermixed with file names.
-a date-time
Submit at the specified date and/or time. In the
absence of this flag, qpr will submit the request
immediately.
If a date-time specification is comprised of two
or more tokens separated by whitespace characters,
then the date-time specification must be placed
within double quotes as in: -a "July, 4, 2026
12:31-EDT", or otherwise escaped such that the
shell will interpret the entire date-time
specification as a single lexical token.
The syntax accepted for the date-time parameter is
relatively flexible. Unspecified date and time
values default to an appropriate value (e.g. if
no date is specified, then the current month, day,
and year are assumed).
A date can be specified as a month and day
(current year assumed). The year can also be
explicitly specified. It is also possible to
specify the date as a weekday name (e.g. "Tues"),
Weekday names and month names can be abbreviated
by any three character (or longer) prefix of the
actual name. An optional period can follow an
abbreviated month or day name.
Time of day specifications can be given using a
twenty-four hour clock, or "am" and "pm"
specifications may be used alternatively. In the
absence of a meridian specification, a twenty-four
hour clock is assumed.
It should be noted that the time of day
specification is interpreted using the precise
meridian definitions whereby "12am" refers to the
twenty-four hour clock time of 0:00:00, "12m"
refers to noon, and "12-pm" refers to 24:00:00.
Alternatively, the phrases "midnight" and "noon"
are accepted as time of day specifications, where
"midnight" refers to the time of 24:00:00.
A timezone may also appear at any point in the
date-time specification. Thus, it is legal to
say: "April 1, 1987 13:01-PDT". In the absence of
a timezone specification, the local timezone is
assumed, with daylight savings time being inferred
when appropriate, based on the date specified.
All alphabetic comparisons are performed in a case
insensitive fashion such that both "WeD" and "weD"
refer to the day of Wednesday.
Some valid date-time examples are:
01-Jan-1986 12am, PDT
Tuesday, 23:00:00
11pm tues.
tomorrow 23-MST
-f form-name
Limit the set of acceptable devices to those
devices which are loaded with the forms: form-
name. In the absence of this flag, qpr will
submit the request only to a device that is loaded
with the default forms. If there is no default
forms defined, the request will be submitted to
the appropriate output device without regard to
the forms configured for the device.
In any case, only those devices associated with
the chosen queue will be considered.
when the request begins execution. If the -mu
flag is also present, then mail is sent to the
user specified for the -mu flag instead of to the
invoking user.
-me Send mail to the invoker on the originating
machine when the request has ended execution. If
the -mu flag is also present, then mail is sent to
the user specified for the -mu flag instead of to
the invoking user.
-mu user-name
Specify that any mail concerning the request
should be delivered to the user user-name. User-
name may be formatted either as user (containing
no `@' characters), or as user@machine. In the
absence of this flag, any mail concerning the
request will be sent to the invoker on the
originating machine.
-n number-of-copies
Print number-of-copies copies. The default is
one.
-p priority
Assign an intra-queue priority to this request.
The specified priority must be an integer, and
must be in the range [0..63], inclusive. A value
of 63 defines the highest intra-queue request
priority, while a value of 0 defines the lowest.
This priority does not determine the execution
priority of the request. This priority is only
used to determine the relative ordering of
requests within a queue.
When a request is added to a queue, it is placed
at a specific position within the queue such that
it appears ahead of all existing requests whose
priority is less than the priority of the new
request. Similarly, all requests with a higher
priority will remain ahead of the new request when
the queueing process is complete. When the
priority of the new request is equal to the
priority of an existing request, the existing
request takes precedence over the new request.
If no intra-queue priority is chosen by the user,
then NQS assigns a default value.
-q queue-name
Specify the queue to which the device request is
specification is given, then the user's
environment variable set is searched for the
variable: QPR_QUEUE. If this environment variable
is found, then the character string value for
QPR_QUEUE is presumed to name the queue to which
the request should be submitted. If the QPR_QUEUE
environment variable is not found, then the
request will be submitted to the default device
request queue, if defined by the local system
administrator. Otherwise, the request cannot be
queued, and an appropriate error message is
displayed to this effect.
-r request-name
Assign a name to this request. In the absence of
an explict -r request-name specification, the
request-name defaults to the name of the first
print file (leading path name removed) specified
on the command line. If no print files were
specified, then the default request-name assigned
to the request is STDIN.
In all cases, if the request-name is found to
begin with a digit, then the character 'R' is
pre-pended to prevent a request-name from
beginning with a digit. All request-names are
truncated to a maximum length of 15 characters.
Be sure not to confuse request-name with request-
id.
-z Submit the request silently. If the request is
submitted successfully, nothing will be written to
stdout or stderr.
QUEUE ACCESS
NQS supports queue access restrictions. For each queue of
queue type other than network, access may be either
unrestricted or restricted. If access is unrestricted, any
request may enter the queue. If access is restricted, a
request can only enter the queue if the requester or the
requester's login group has been given access to that queue
(see qmgr(1M)). Requests submitted by root are an
exception; they are always queued, even if root has not
explicitly been given access.
Use qstat(1) to determine who has access to a particular
queue.
SEE ALSO
mail(1), qdel(1), qdev(1), qlimit(1), qstat(1), and qsub(1)
qmgr(1M) in the NPSN UNIX System Administrator Reference
Manual.
NPSN HISTORY
Origin: Sterling Software Incorporated
May 1986 - Robert Sandstrom, Sterling Software
Original release.