qhold(1)


          qhold - hold NQS request(s).

     SYNOPSIS
          qhold [ -u username ] [ -v ] request-id ...

     DESCRIPTION
          Qhold holds all queued or waiting NQS requests whose
          respective request-id is listed on the command line.  Qhold
          will not hold a running NQS request.

          To hold an NQS request, the invoking user must be the owner;
          namely the submitter of the request.  The only exception to
          this rule occurs when the invoking user is the superuser, or
          has NQS operator privileges as defined in the NQS manager
          database.  Under these conditions, the invoker may specify
          the -u username flag which allows the invoker to hold
          requests owned by the user whose account name is username.
          When this form of the command is used, all request-ids
          listed on the command line are presumed to refer to requests
          owned by the specified user.

          An NQS request is always uniquely identified by its
          request-id, no matter where it is in the network of the
          machines comprising the NPSN.  A request-id is always of the
          form:  seqno or seqno.hostname where hostname identifies the
          machine from whence the request was originally submitted,
          and seqno identifies the sequence number assigned to the
          request on the originating host.  If the hostname portion of
          a request-id is omitted, then the local host is always
          assumed.

          The request-id of any NQS request is displayed when the
          request is first submitted (unless the silent mode of
          operation for the given NQS command was specified).  The
          user can also obtain the request-id of any request through
          the use of the qstat(1) command.

          The -v switch will print out the current version of qhold.

     BUGS
          One cannot hold a job on a remote machine.

     SEE ALSO
          qdel(1), qrls(1), qstat(1).
          qmgr(1M) in the NPSN UNIX System Administrator Reference
          Manual.

     NPSN HISTORY
          Origin: CERN

          January 1992 - Christian Boissat, CERN

          August 1994 - John Roman, Monsanto Company
          Release 3.36