SLURM Reference Manual for HP XC System Software

SMAP (Show Job Geometry)
ROLE.
On BlueGene/L only, the SMAP utilty reveals not only which nodes are allocated to currently running jobs
but also the geometric arrangement of those nodes (and hence, the way that BG/L jobs fit among one
another topographically). On BG/L, SMAP thus supplements SINFO (page 53) and SQUEUE (page 46)
as a visually enhanced way to monitor job interactions and to plan spatially for new node allocations.
PREREQUISITES.
(1) SMAP runs only on LC's BlueGene/L (BG/L) machine.
(2) SMAP takes over the terminal window in which it runs. So executing it as a controllee of XTERM, in
a separate window dedicated to its output, is a good strategy (see below).
(3) SMAP needs a window wider than 80 characters to display its character-based "map" of job/node
allocations effectively. Requesting a 100-character-wide window with XTERM's -geometry option is a
good strategy (see below).
EXECUTION.
Because of its prerequisites (above), a typical appropriate SMAP run could begin with an execute line such
as this
xterm -geometry 100x30 -e /usr/bin/smap -Dj >& /dev/null &
to show the arrangement of jobs currently running (-Dj) on BG/L.
TYPICAL OUTPUT.
SMAP's character-based map of job/node allocations typically looks like this (some blank columns have
been trimmed to fit this manual):
a a a a b b d d ID JOBID PARTITION USER NAME ST TIME NODES NODELIST
a a a a b b d d a 12345 batch joseph tst1 R 43:12 64 bgl[000x333]
a a a a b b c c b 12346 debug chris sim3 R 12:34 16 bgl[420x533]
a a a a b b c c c 12350 debug danny job3 R 0:12 8 bgl[622x733]
d 12356 debug dan colu R 18:05 16 bgl[600x731]
a a a a b b d d e 12378 debug joseph asx4 R 0:34 4 bgl[612x713]
a a a a b b d d
a a a a b b c c
a a a a b b c c
a a a a . . d d
a a a a . . d d
a a a a . . e e Y
a a a a . . e e |
|
a a a a . . d d 0----X
a a a a . . d d /
a a a a . . . . /
a a a a . . . # Z
Note here that:
(1) As the legend indicates, the origin (node 000) lies at the REAR (upper, not lower) left corner of the
bottom "plane" (4-line group, and each such 4-line group shows another Y-dimension plane above it).
SLURM Reference Manual - 63