qdev(1)


          qdev - display status of NQS devices

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

     DESCRIPTION
          Qdev displays the status of devices known to the Network
          Queueing System (NQS).

          If no devices are specified, then the current state of each
          NQS device on the local host is displayed.  Otherwise, the
          response is limited to the devices specified.  Devices may
          be specified either as device-name or device-name@host-name.
          In the absence of a host-name specifier, the local host is
          assumed.

          A device header with several headings is displayed for each
          of the selected devices.  The first heading in a device
          header appears as Device:, and is followed by the name of
          the device formatted as device-name@host-name.  The second
          heading of Fullname: is followed by the full path name of
          the special file associated with the device.  The third
          heading of Server: is followed by the command line which
          will be used to execve(2) the device server.  The fourth
          heading of Forms: is followed by the forms configured for
          the device.

          The final heading of Status: prefaces a display of the
          general device state.  The general state of a device is
          defined by two principal properties of the device.

          The first property concerns whether or not the device is
          willing to continue accepting queued requests.  If it is,
          the device is said to be ENABLED.  If the device is
          unwilling to continue accepting queued requests, and is
          idle, its state is DISABLED.  A third state of
          ENABLED/CLOSED is used to describe a device that is
          unwilling to continue accepting queued requests, but is not
          yet idle.

          The second principal property of a device concerns whether
          or not the device is busy.  There are three cases.  If the
          device is busy, it is said to be ACTIVE.  If the device is
          idle and not known to be out of service, it is said to be
          INACTIVE.  Finally, if the device is idle and known to be
          out of service, it is said to be FAILED.  FAILED covers both
          hardware and software failures.

          If a device is busy, information about the active request
          follows the device header.  The request-name, request-id,
          and the name of the user who submitted the request are all

     SEE ALSO
          qdel(1), qlimit(1), qpr(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.