pbsdsh(1)

1pbsdsh(1B)                            PBS                           pbsdsh(1B)
2
3
4

NAME

6       pbsdsh - distribute task to nodes under pbs
7

SYNOPSIS

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

DESCRIPTION

14       Executes (spawns) a normal Unix program on one or more nodes under con‐
15       trol of the Portable Batch System, PBS.  Pbsdsh uses the  Task  Manager
16       API, see tm_spawn(3), to distribute the program on the allocated nodes.
17
18       When run without the -c or the -n option, pbsdsh will spawn the program
19       on all nodes allocated to the PBS job.  The spawns take  place  concur‐
20       rently - all execute at (about) the same time.
21
22       Users  will  find  the PBS_TASKNUM , PBS_NODENUM , and the PBS_VNODENUM
23       environmental variables useful.  They contain the TM task id, the  node
24       identifier, and the cpu (virtual node) identifier.
25

OPTIONS

27       -c copies
28              The  program  is  spawned  on  the first Copies nodes allocated.
29              This option is mutual exclusive with -n.
30
31       -n node
32              The program is spawned on one node which  is  the  node-th  node
33              allocted.  This option is mutual exclusive with -c.
34
35       -h hostname
36              The program is spawned on the node specified.
37
38       -o     Capture  stdout of the spawned program.  Normally stdout goes to
39              the job's output.
40
41       -s     If this option is given, the program is  run  in  turn  on  each
42              node, one after the other.
43
44       -u     The program is run once on each node (unique).  This ignores the
45              number of allocated processers on a given node.
46
47       -v     Verbose output about error conditions and task  exit  status  is
48              produced.
49

OPERANDS

51       The first operand, program, is the program to execute.
52
53       Additional operands, args, are passed as arguments to the program.
54

STANDARD ERROR

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

EXIT STATUS

60       Upon successful processing of all the operands presented  to  the  com‐
61       mand, the exit status will be a value of zero.
62
63       If the pbsdsh command fails to process any operand, or fails to contact
64       the MOM daemon on the localhost the command exits with a value  greater
65       than zero.
66