NAME

       pbsdsh - distribute task to nodes under pbs

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 Copies nodes allocated.  This option is mutual
              exclusive with -n.

       -n node
              The program is spawned on one node which is the node-th 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, program, is the program to execute.

       Additional operands, args, 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)