qpr(1) CLIX qpr(1)
NAME
qpr - Submits a print request to NQS
SYNOPSIS
qpr [flag ... ] [file ... ]
FLAGS
[-a date-time]
Submits the request at the specified date and/or time. When this
flag is not specified, qpr submits the request immediately.
If a date-time specification is composed of two or more tokens
separated by white space characters, the date-time specification
must be enclosed in quotation marks as in -a "July, 4, 2026 12:31-
EDT". If not specified in quotation marks, the specification
should be escaped so that the shell will interpret the date-time
specification as a single lexical token.
The syntax accepted for the date-time parameter is flexible.
Unspecified date and time values default to an appropriate value.
(For example, if a date is not specified, the current month, day,
and year are assumed.)
A date can be specified as a month and a day (current year
assumed). The year can also be explicitly specified. It is also
possible to specify the date as a weekday name (such as Tues), or
as one of the strings today or tomorrow. Weekday and month names
can be abbreviated by any three-character (or longer) prefix to the
actual name. An optional period can follow an abbreviated month or
day name.
Time of day specifications can be given using a 24-hour clock or am
and pm specifications may be used alternatively. When a meridian
is not specified, a 24-hour clock is assumed.
The time of day specification is interpreted using the precise
meridian definitions. 12am refers to the 24-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 24:00:00.
A time zone may also appear at any point in the date-time
specification. Thus, "April 1, 1987 13:01-PDT" is a legal
specification. When a time zone is not specified, the local time
zone is assumed, with daylight savings time being inferred when
appropriate based on the date specified.
Not all alphabetic comparisons are case-sensitive. Both WeD and
2/94 - Intergraph Corporation 1
qpr(1) CLIX qpr(1)
weD refer to Wednesday. Examples of valid date-time specifications
are as follows:
"01-Jan-1986 12am, PDT"
"Tuesday, 23:00:00"
"11pm tues."
"tomorrow 23-MST"
-d name=value
Defines an environment variable name with the given value to be put
in the environment of the device server. This flag is specific to
devserver.
-e tag=filename
Associates tag with the filename, export the file to the server
machine, and put tag in the environment of the device server so
that the server can access the ancillary file by looking at the
environment variable tag. This flag is specific to devserver.
-f form-name
Limits the set of acceptable devices to devices that are loaded
with the form form-name. When this flag is not specified, qpr
submits the request only to a device loaded with the default form.
If a default form is not defined, the request is submitted to the
first available output device without regarding the forms
configured for the device. In any case, only devices associated
with the chosen queue are considered.
-l message
Logs message in the device accounting file if device accounting is
turned on at the destination device queue. This flag is specific
to devserver.
-mb Sends mail to the user on the originating machine when the request
begins execution. If the -mu flag is also present, mail is sent to
the user specified by the -mu flag instead of to the invoking user.
-me Sends mail to the invoking user on the originating machine when the
request has ended execution. If the -mu flag is also present, mail
is sent to the user specified by the -mu flag instead of to the
invoking user.
-mu username
Specifies that any mail concerning the request should be delivered
to the user username. Username has the form user[@machine]. When
this flag is not specified, any mail concerning the request is sent
to the invoker on the originating machine.
-n number-of-copies
Prints number-of-copies copies. The default is 1.
2 Intergraph Corporation - 2/94
qpr(1) CLIX qpr(1)
-o options
Places the following options on the end of the argument list of the
device filter before it is started to process the output file.
Since options is one argument, multiple options must be quoted as
one argument. This flag is specific to devserver.
-p priority
Assigns an intraqueue priority to this request. The specified
priority must be an integer, and must be in the 0-63 range,
inclusive. A value of 63 defines the highest intraqueue request
priority, while a value of 0 defines the lowest. This priority
does not determine the execution priority of the request. This
priority is used only 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 so that it appears ahead of all existing
requests with priorities less than the priority of the new request.
Similarly, all requests with a higher priority remain ahead of the
new request when the queuing process is complete. When the
priority of the new request equals the priority of an existing
request, the existing request takes precedence over the new
request.
If the user does not choose an intraqueue priority, the value
configured by the system administrator will be used. If a value
has not been configured by the system administrator, a default
value of 31 is assigned to the request.
-q queue-name
Specifies the queue to which the device request is to be submitted.
If the -q queue-name specification is not given, the user's
environment is searched for the variable $QPR_QUEUE. If this
environment variable is found, the character string value for
$QPR_QUEUE is presumed to be the name of the queue to which the
request should be submitted. If the $QPR_QUEUE environment
variable is not found, the request is submitted to the default
device request queue if one has been defined by the local system
administrator. Otherwise, the request cannot be queued and an
appropriate error message is displayed.
-r request-name
Assigns a name to this request. When the -r flag is not specified,
the request-name defaults to the name of the first print file (with
the leading pathname removed) specified on the command line. If a
print file was not specified, the default request-name assigned to
the request is stdin.
In all cases, if the request-name begins with a digit, the
character R is prefixed to prevent a request-name from beginning
with a digit. All request-names are truncated to a maximum length
2/94 - Intergraph Corporation 3
qpr(1) CLIX qpr(1)
of 15 characters.
-R Deletes the original files after NQS is finished with them. This
normally means that the original files are deleted immediately
after the files are successfully copied into the spool directory.
If the -s flag is specified with the -R flag, the original files
will not be deleted until one of two events occurs. If the file is
printed/plotted locally, the original files are deleted after the
job has completed. If the request is routed to a remote machine,
the files are deleted after the request has been transferred to the
remote machine.
The -R flag cannot be used with the -sx and -sp flags.
-s [xp]
Symbolically links the files into the NQS spool directories rather
than copying them. If the -s flag is used, files submitted should
not be renamed, moved, or deleted until the device request has left
the machine or has completed printing. Using the -s flag speeds up
the submission of very large files because they are not copied into
the spool directory.
The -sp flag will only symbolically link the print files and copy
the tag files. The -sx flag will only link the tag files and copy
the print files. The -sp and -sx flags cannot be used with the -R
flag.
-t type
Specifies that the format of the input is type. The input type
maybe any input type supported by the server to which the request
is submitted. The valid input types are as follows: ascii, cmyk,
gks, hpgl, igds, iscrpt, prop, raster, script, and text. See the
InterPlot User's Guide for detailed descriptions of each input
type.
-x When a device request is submitted, the following environment
variables are automatically defined in the environment of the
device server: $QPR_HOST, $QPR_REQID, $QPR_REQNAME, and $QPR_QUEUE.
These environment variables refer to the hostname the request
originated from, the request ID, the request name, and the name of
the queue the request eventually executes in. If the -x flag is
specified, all remaining environment variables are exported to the
environment of the device server. This flag is specific to
devserver.
-z Submits the request silently. If the request is submitted
successfully, nothing will be written to stdout or stderr.
DESCRIPTION
4 Intergraph Corporation - 2/94
qpr(1) CLIX qpr(1)
The qpr command places the named files in a Network Queuing System (NQS)
queue to be printed by a device such as a line printer or a laser printer.
If a file is not specified, qpr reads from stdin.
NQS has queue access restrictions. For each queue with a 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 enter the queue only if the requester or the
requester's login group has access to that queue (see qmgr). Requests
submitted by the superuser are an exception; they are always queued, even
if the superuser has not explicitly been given access. qstat may be used
to determine who has access to a particular queue.
The qpr command prints a request ID to stdout when a request is queued
successfully. This request ID can be compared with what is reported by
qdev and qstat to learn the outcome of a request. It can also be given as
an argument to qdel to delete a request. A request ID has the form
seqno.hostname, where seqno refers to the sequence number assigned to the
NQS request, and hostname refers to the name of the originating machine.
This identifier is used throughout NQS to uniquely identify the request
anywhere in the network.
When submitting an Interplot qpr request, the metafile, as well as any
exported files specified by the -e flag are symbolically linked with the
-s flag.
EXAMPLES
1. The following command line submits the text type file named data to
queue name laser1:
qpr -a 11:40 -mb -me -n 2 -q laser1 -t text data
Additional flags specify that two copies will be printed (-n), mail
will be sent to the user when the job begins (-mb) and ends (-me), and
the job will stay in the wait state in the receiving device queue
until 11:40am (-a).
2. To submit the file data2 to the default queue name on the system, use
the following:
qpr -l "Doe's print files" -f longform -p 50 -r Doe1 data2
The request name will be Doe1 instead of data2. The priority of the
request is 50 (higher than the default), and the printer must have the
form name longform. The log message ``Doe's print files'' will go
into the accounting file, if the queue has accounting.
3. The -z flag is useful for shell scripts because it does not print
messages unless an error occurs. The following example, assuming all
defaults, prints the asd.txt file ``silently'':
2/94 - Intergraph Corporation 5
qpr(1) CLIX qpr(1)
qpr -z asd.txt
The qpr command returns a 1 if the request was successfully submitted.
4. To submit an Interplot qpr request:
qpr -q q -s -e PEN_ATTR=/pen_attributes
DIAGNOSTICS
Multiple request start-after time specifications.
The -a flag was given twice.
Invalid date/time syntax.
The time and date argument for the -a flag could not be deciphered.
No request queue specified, and no local default has
been defined.
No -q flag was given, and there was no default print queue-name
defined for NQS.
Seek help from system support personnel.
An internal or NQS error occurred. Seek help from the NQS manager
or the system administrator.
EXIT VALUES
The qpr command exits with a value of 1 if the request was successfully
queued and a value of 0 if not queued.
RELATED INFORMATION
Commands: qdel(1), qdev(1), qlimit(1), qstat(1), qsub(1), mail(1), qmgr(8)
Intergraph Network Queuing System (NQS) User's Guide, InterPlot User's
Guide
6 Intergraph Corporation - 2/94