This publication describes how to configure, monitor, and control the Cray Network Queuing Environment (NQE) running on a UNIX system. NQE is a software product that lets users submit, monitor, and control batch requests for execution on an NQS server in an NQE cluster. This publication is written for NQE administrators who are responsible for defining and maintaining the NQE network configuration. This publication also may be accessed online by using the Cray Research online documentation reader.

The NQE graphical user interface (GUI) allows users to submit and control batch requests to a central storage database and to obtain status on their batch requests and file transfers.

The Network Load Balancer (NLB) uses the system load information received from NQE execution servers to offer NQS an ordered list of servers to run a request; NQS uses the list to distribute the request.

The NQE database provides an alternate mechanism for distributing work. Requests are submitted and stored centrally. The NQE scheduler examines each request and determines when and where the request is run.

The File Transfer Agent (FTA) provides asynchronous and synchronous file transfer. You can queue your transfers so that they are retried if a network link fails.

Related Publications

The following documents contain additional information that may be helpful:

  • NQE Release Overview, publication RO-5237, provides NQE release information.

  • NQE Installation, publication SG-5236, describes how to install or upgrade the NQE software.

  • Introducing NQE, publication IN-2153, provides an overview of NQE functionality and describes how to access documentation online. This publication also may be accessed online by using the Cray Research online documentation reader.

  • NQE User's Guide, publication SG-2148, provides more detailed user-level information than Introducing NQE, such as how to do user tasks by using either the NQE graphical user interface (GUI) or the command-line interface, how to customize your environment, and so on. This publication may also be accessed online by using the Cray Research online documentation reader.

Ordering Cray Research Publications

The User Publications Catalog, Cray Research publication CP-0099, describes the availability and content of all Cray Research hardware and software documents that are available to customers. Cray Research customers who subscribe to the Cray Inform (CRInform) program can access this information on the CRInform system.

To order a document, either call the Distribution Center in Mendota Heights, Minnesota, at +1-612-683-5907, or send a facsimile of your request to fax number +1-612-452-0141. Cray Research employees may send electronic mail to orderdsk (UNIX system users).

Customers who subscribe to the CRInform program can order software release packages electronically by using the Order Cray Software option.

Customers outside of the United States and Canada should contact their local service organization for ordering and documentation information.


The following conventions are used throughout this document:




This fixed-space font denotes literal items such as commands, files, routines, path names, signals, messages, and programming language structures.


Man page section identifiers appear in parentheses after man page names. The following list describes the identifiers:


User commands


User commands ported from BSD


System calls


Library routines, macros, and opdefs


Devices (special files)




File formats


Miscellaneous topics


DWB-related information


Administrator commands

Some internal routines (for example, the _assign_asgcmd_info() routine) do not have man pages associated with them.


Italic typeface denotes variable entries and words or concepts being defined.

user input 

This bold, fixed-space font denotes literal items that the user enters in interactive sessions. Output is shown in nonbold, fixed-space font.

[ ] 

Brackets enclose optional portions of a command or directive line.


Ellipses indicate that a preceding element can be repeated.

The default shell in the UNICOS and UNICOS/mk operating systems, referred to in Cray Research documentation as the standard shell, is a version of the Korn shell that conforms to the following standards:

  • Institute of Electrical and Electronics Engineers (IEEE) Portable Operating System Interface (POSIX) Standard 1003.2-1992

  • X/Open Portability Guide, Issue 4 (XPG4)

The UNICOS and UNICOS/mk operating systems also support the optional use of the C shell.

Reader Comments

If you have comments about the technical accuracy, content, or organization of this document, please tell us. You can contact us in any of the following ways:

  • Send us electronic mail at the following address:

    [email protected]

  • Contact your customer service representative and ask that an SPR or PV be filed. If filing an SPR, use PUBLICATIONS for the group name, PUBS for the command, and NO-LICENSE for the release name.

  • Call our Software Publications Group in Eagan, Minnesota, through the Customer Service Call Center, using either of the following numbers:

    1-800-950-2729 (toll free from the United States and Canada)

  • Send a facsimile of your comments to the attention of “Software Publications Group” in Eagan, Minnesota, at fax number +1-612-683-5599.

We value your comments and will respond to them promptly.