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]
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.
The first operand, program, is the program to execute.
Additional operands are passed as arguments to the program.
The pbsdsh command will write a diagnostic message to standard error for each error occurrence.
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 Alsoqsub(1B), tm_spawn(3B)
|© 2001-2010 Adaptive Computing Enterprises, Inc.|