GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PBSDSH (1)


.Ig
.Iq

NAME

pbsdsh - distribute task to nodes under pbs

CONTENTS

Synopsis
Description
Options
Operands
Standard Error
Exit Status
See Also

SYNOPSIS

pbsdsh [-c copies] [-o] [-s] [-u] [-v] program [args]
pbsdsh [-n node] [-o] [-s] [-u] [-v] program [args]
pbsdsh [-h nodename] [-o] [-v] program [args]

DESCRIPTION

Executes (spawns) a normal Unix program on one or more nodes under control of the Portable Batch System, PBS. Pbsdsh uses the Task Manager API, see tm_spawn(3), to distribute the program on the allocated nodes.

When run without the -c or the -n option, pbsdsh will spawn the program on all nodes allocated to the PBS job. The spawns take place concurrently - all execute at (about) the same time.

Users will find the PBS_TASKNUM , PBS_NODENUM , and the PBS_VNODENUM environmental variables useful. They contain the TM task id, the node identifier, and the cpu (virtual node) identifier.

OPTIONS

-c copies The program is spawned on the first nodes allocated. This option is mutual exclusive with -n.
-n node The program is spawned on one node which is the node allocted. This option is mutual exclusive with -c.
-h hostname The program is spawned on the node specified.
-o Capture stdout of the spawned program. Normally stdout goes to the job’s output.
-s If this option is given, the program is run in turn on each node, one after the other.
-u The program is run once on each node (unique). This ignores the number of allocated processers on a given node.
-v Verbose output about error conditions and task exit status is produced.

OPERANDS

The first operand, is the program to execute.

Additional operands, are passed as arguments to the program.

STANDARD ERROR

The pbsdsh command will write a diagnostic message to standard error for each error occurrence.

EXIT STATUS

Upon successful processing of all the operands presented to the command, the exit status will be a value of zero.

If the pbsdsh command fails to process any operand, or fails to contact the MOM daemon on the localhost the command exits with a value greater than zero.

SEE ALSO

qsub(1B), tm_spawn(3B)

Search for    or go to Top of page |  Section 1 |  Main Index


Local PBSDSH (1B)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.