QDEV(1)

NAME
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 displayed.

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.