P
B
Portable Batch System
S
Internal Design Specification
Albeaus Bayucan
Casimir Lesiak
Bhroam Mann
Robert L. Henderson
Tom Proett
Dave Tweten †
MRJ Technology Solutions
2672 Bayshore Parkway
Suite 810
Mountain View, CA 94043
http://pbs.mrj.com
Release: 2.2
Printed: November 30, 1999
† Numerical Aerospace Simulation Systems Division, NASA Ames Research Center, Moffett Field, CA
PBS IDS
PBS IDS
Portable Batch System (PBS) Software License
Copyright © 1999, MRJ Technology Solutions.
All rights reserved.
Acknowledgment: The Portable Batch System Software was originally developed as a joint
project between the Numerical Aerospace Simulation (NAS) Systems Division of NASA Ames
Research Center and the National Energy Research Supercomputer Center (NERSC) of
Lawrence Livermore National Laboratory.
Redistribution of the Portable Batch System Software and use in source and binary forms,
with or without modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright and acknowledgment
notices, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright and acknowledg-
ment notices, this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
- All advertising materials mentioning features or use of this software must display the
following acknowledgment:
This product includes software developed by NASA Ames Research Center,
Lawrence Livermore National Laboratory, and MRJ Technology Solutions.
DISCLAIMER OF WARRANTY
THIS SOFTWARE IS PROVIDED BY MRJ TECHNOLOGY SOLUTIONS ("MRJ")
"AS IS" WITHOUT WARRANTY OF ANY KIND, AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PUR-
POSE, AND NON-INFRINGEMENT ARE EXPRESSLY DISCLAIMED.
IN NO EVENT, UNLESS REQUIRED BY APPLICABLE LAW, SHALL MRJ,
NASA, NOR THE U.S. GOVERNMENT BE LIABLE FOR ANY DIRECT DAM-
AGES WHATSOEVER, NOR ANY INDIRECT, INCIDENTAL, SPECIAL, EXEM-
PLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARIS-
ING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This license will be governed by the laws of the Commonwealth of Virginia, without reference
to its choice of law rules.
This product includes software developed by the NetBSD Foundation, Inc. and its contribu-
tors.
pf1-
PBS IDS
PBS Revision History
Revision 1.0 June, 1994 — Alpha Test Release
Revision 1.1 March 15, 1995
...
Revision 1.1.9 December 20, 1996
Revision 1.1.10 July 31, 1997
Revision 1.1.11 December 19, 1997
Revision 1.1.12 July 9, 1998
Revision 2.0 October 14, 1998
Revision 2.1 May 12, 1999
Revision 2.2 November 30, 1999
pf2
PBS IDS
Table of Contents
PBS License Agreement .............................................................................. pf1
Revision History .......................................................................................... pf2
1. Introduction ..................................................................................... 1-5
1.1. Purpose ............................................................................................... 1-5
1.2. Glossary ............................................................................................... 1-2
1.3. System Overview ............................................................................... 1-2
1.3.1. Batch Pre-history ........................................................................... 1-2
1.3.2. PBS Overview .................................................................................... 1-2
2. User Commands ............................................................................. 2-1
2.1. User Commands Overview ............................................................. 2-1
2.2. Packaging ........................................................................................... 2-1
2.3. Program: qalter ................................................................................. 2-1
2.3.1. Overview ............................................................................................ 2-1
2.3.2. External Interfaces ............................................................................ 2-1
2.3.3. qalter.c ................................................................................................ 2-1
2.4. Program: qdel .................................................................................... 2-2
2.4.1. Overview ............................................................................................ 2-2
2.4.2. External Interfaces ............................................................................ 2-2
2.4.3. qdel.c .................................................................................................. 2-2
2.5. Program: qhold .................................................................................. 2-3
2.5.1. Overview ............................................................................................ 2-3
2.5.2. External Interfaces ............................................................................ 2-3
2.5.3. qhold.c ................................................................................................ 2-3
2.6. Program: qmove ................................................................................ 2-4
2.6.1. Overview ............................................................................................ 2-4
2.6.2. External Interfaces ............................................................................ 2-4
2.6.3. qmove.c ............................................................................................... 2-4
2.7. Program: qmsg ................................................................................... 2-5
2.7.1. Overview ............................................................................................ 2-5
2.7.2. External Interfaces ............................................................................ 2-5
2.7.3. qmsg.c ................................................................................................. 2-5
2.8. Program: qrerun ............................................................................... 2-6
2.8.1. Overview ............................................................................................ 2-6
2.8.2. External Interfaces ............................................................................ 2-6
2.8.3. qrerun.c .............................................................................................. 2-6
2.9. Program: qrls ..................................................................................... 2-7
2.9.1. Overview ............................................................................................ 2-7
2.9.2. External Interfaces ............................................................................ 2-7
2.9.3. qrls.c ................................................................................................... 2-7
2.10. Program: qselect ............................................................................. 2-7
2.10.1. Overview .......................................................................................... 2-8
2.10.2. External Interfaces .......................................................................... 2-8
2.10.3. qselect.c ............................................................................................ 2-8
2.11. Program: qsig ................................................................................... 2-10
2.11.1. Overview .......................................................................................... 2-10
2.11.2. External Interfaces .......................................................................... 2-10
2.11.3. qsig.c ................................................................................................. 2-10
2.12. Program: qstat ................................................................................. 2-11
2.12.1. Overview .......................................................................................... 2-11
2.12.2. External Interfaces .......................................................................... 2-11
2.12.3. qstat.c ............................................................................................... 2-11
2.13. Program: qsub ................................................................................. 2-15
pf3-
