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-nameUser-
                    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.