qdev(1)                             CLIX                             qdev(1)



  NAME

    qdev - Displays the status of NQS devices

  SYNOPSIS

    qdev [device-name[@host] ... ]

  DESCRIPTION

    The qdev command displays the status of Network Queuing System (NQS)
    devices.  The qdev command, without any arguments, displays the current
    status of all NQS devices on the local host.  Otherwise, qdev displays the
    status of the devices specified by device-name.  If @host is specified,
    the device located on host is displayed.  The device is assumed to be on
    the local machine unless a particular host is specified by @host.

    A device header with the following format is displayed for each of the
    specified devices:

    device-name@hostname
    Fullname:
    Server:
    Forms:
    Status = [ ];

    ``Fullname:'' lists the full pathname of the special file associated
    with the device.  ``Server:'' lists the command line that will be used
    to execve the device server.  ``Forms:'' lists the forms
    configured for the device.  ``Status:'' displays the general state of
    the device.

    The general state of a device is defined by two principal properties.
    The first property is whether the device is willing to continue
    accepting queued requests.  If it is willing, the state of the device
    is ENABLED.  If the device is unwilling to continue accepting
    queued requests and is idle, its state is DISABLED.  The state
    of the device is ENABLED/CLOSED if the device is unwilling
    to continue accepting queued requests but is not yet idle.

    The second principal property of a device is whether the device is
    busy.  If the device is busy, it is in an ACTIVE state.  If the device
    is idle and not out of service, it is in an INACTIVE state.  If the
    device is idle and out of service, it is in a FAILED state.  The
    FAILED state covers both hardware and software failures.

    If a device is busy, information about the active request follows the
    device header.  The name of the request, the ID of the request, and
    the name of the request owner are displayed.

  EXAMPLES



  2/94 - Intergraph Corporation                                              1

  qdev(1)                             CLIX                             qdev(1)



    1.  To get a report on the status of all devices on the local machine,
        enter the following:

        qdev


    2.  For a report on the status of a device name, say ilp811, at machine
        remote, use the following:

        qdev ilp811@remote


  NOTES

    The qdev command does not currently support requests to display the status
    of devices on remote hosts.  If the specified host is not the local host,
    an error will be generated.

  DIAGNOSTICS

    Seek staff support
           An internal or NQS error occurred.  Seek help from the NQS or
           system administrator.

    Invalid hostname specification
           The @host machine specified does not exist or is not syntactically
           valid (special characters in the host-name).

  EXIT VALUES

    The qdev command exits with a 0 if successful and a 1 if an error
    occurred.

  RELATED INFORMATION

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


















  2                                              Intergraph Corporation - 2/94