qdel(1) — CLIX 3.1r7.6.28



  qdel(1)                             CLIX                             qdel(1)



  NAME

    qdel - Deletes or signals NQS requests

  SYNOPSIS

    qdel [-k] [-signo] [-u username] request-id[@host] ...

  FLAGS

    -k   Sends the SIGKILL signal to the specified request-ids.

    -u   Allows superusers or those with NQS operator privileges to delete or
         signal NQS requests.

  DESCRIPTION

    The qdel command deletes or signals the Network Queuing System (NQS)
    request specified by the request-id.  If @host is specified, the host is
    deleted.  Queued and waiting requests are deleted.  Running requests are
    signaled if the -k or the -signo flags are used.  The -k flag will send
    the SIGKILL signal and the -signo flag will send the signal associated
    with signo to the specified request-ids.  Routing, arriving, and departing
    requests are not affected.

    To delete or signal an NQS request, the invoking user must ordinarily be
    the owner of the request.  The -u flag; however, provides a way to avoid
    this rule.  The -u flag specifies requests owned by the user username.
    This flag may be used only if the invoking user is the superuser or has
    NQS operator privileges.  If a request-id that is not owned by username is
    specified, an error message will be generated.

    The request-id uniquely identifies an NQS request regardless of where the
    request is in the network of NQS machines.  The request-id has the form
    seqno[.hostname].  The seqno identifies the sequence number assigned to
    the request on the originating host.  The hostname identifies the
    originating host.  If the hostname portion of a request-id is omitted, the
    local host is assumed.

    The request-id of an NQS request is displayed when the request is first
    submitted (unless the silent mode of operation is specified).  The user
    can also obtain the request-id of any request by using the qstat command.

  EXAMPLES

    1.  To delete the queued or waiting request, 123.request, on the local
        machine:

        qdel 123.request





  2/94 - Intergraph Corporation                                              1



  qdel(1)                             CLIX                             qdel(1)



    2.  To kill the running request, 123.request, on the host remote that
        belongs to user doe:

        qdel -k -u doe 123.req@remote


  CAUTIONS

    When an NQS request is spawned, a new process group is established for all
    processes in the request.  If the -k flag or -signo flag is used, a signal
    will be sent to all processes in the process group.  However, if a process
    successfully executes a setpgrp call, it will not receive any signals sent
    by qdel.  The kill command may be used to delete such processes.

  DIAGNOSTICS

    No such user on this machine
           The user-name given with the -u flag does not exist on this
           machine.

    Insufficient privilege for -u specification
           The -u flag was used, and the user did not have operator privileges
           or was not superuser.

    Unknown machine for request-id: id
           The machine given to delete the request from is not a known host-
           name.  Check the /etc/hosts file.

    The NQS daemon is not running
           NQS is not running right now, try again later.

    Request is running
           An attempt to delete a request was made, without the -k flag or -
           signo flag.

    An internal error or a problem with NQS occurred
           Seek help from the NQS or system administrator.

  EXIT VALUES

    The qdel command exits with a 0 if the NQS request was successfully
    deleted or killed.  This command exits with a 1 if an error occurs.

  RELATED INFORMATION

    Commands: qdev(1), qlimit(1), qpr(1), qstat(1), qsub(1),kill(1), qmgr(8)

    Functions: setpgrp(2), signal(2)






  2                                              Intergraph Corporation - 2/94

Museum

Related Articles