QPR(1)

NAME
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"), or as one of the strings "today" or "tomorrow". 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.

-mb Send mail to the user on the originating machine 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 to be submitted. If no -q queue-name 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)
in the NPSN UNIX System Programmer Reference Manual.
qmgr(1M) in the NPSN UNIX System Administrator Reference Manual.

NPSN HISTORY
Origin: Sterling Software Incorporated

May 1986 - Robert Sandstrom, Sterling Software
Original release.