IBM Books

IBM LoadLeveler for AIX 5L: Using and Administering

llmatrix - Query Gang matrix

Purpose

Returns the Gang matrix information in the LoadLeveler cluster when Gang scheduling is used.

Syntax

llmatrix [-? | -H | -v | [-r] [-s] <hostlist> ]

Flags

-?
Provides a short usage message.

-H
Provides help information.

-v
Outputs the name of the command, release number, service level, service level date, and operating system used to build the command.

-r
Indicates raw mode for output. Each column of the Gang matrix will occupy one line with the output fields separated by an exclamation point (!).

-s
Specifies that the short hostnames will be used in the output.

hostlist
A blank-delimited list of machines for which you are requesting Gang matrix information.

Description

If you do not specify a hostlist, the system displays the complete Gang matrix.

Gang matrix output information is formatted into columns. Each column is identified by the machine name and processor number. Each row in the matrix is called a time-slice and contains job step names. Job steps in an active time-slice run for the time period specified by GANG_MATRIX_TIME_SLICE. When that time-slice expires, the job steps in the next time-slice are run. At the end of the last time-slice, the cycle is restarted at the first time-slice.

In the matrix output:

Note:The processor number does not correspond to a particular physical processor.

Examples

This example displays the complete Gang matrix: 

llmatrix

This example displays the portion of the Gang matrix for machine c163n03 in raw mode: 

llmatrix -r c163n03

Results

llmatrix returns the following exit values:

The following listing is sample output for the llmatrix -s command:

Figure 19. llmatrix -s output


+--------------------------------------------------------------------------------+
|GANG_MATRIX_TIME_SLICE = 60 seconds                                             |
|                                                                                |
|Column: Machine Name /  Processor Number                                        |
|            Job Step Names                                                      |
|                                                                                |
|                                                                                |
|Column: c209f1n05 / Processor0                                                  |
|            c209f1n05.11.0                                                      |
|            c209f1n05.14.0*                                                     |
|            c209f1n05.13.0                                                      |
|                                                                                |
|Column: c209f1n05 / Processor1                                                  |
|            c209f1n05.11.0                                                      |
|            c209f1n05.14.0*                                                     |
|            c209f1n05.13.0                                                      |
|                                                                                |
|Column: c209f1n05 / Processor2                                                  |
|            c209f1n05.12.0                                                      |
|            c209f1n05.14.0*                                                     |
|            NULL                                                                |
|                                                                                |
|                                                                                |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|Column: c209f1n05 / Processor3                                                  |
|            c209f1n05.12.0                                                      |
|            c209f1n05.14.0*                                                     |
|            NULL                                                                |
|                                                                                |
|Column: c209f1n01 / Processor0                                                  |
|            c209f1n05.11.0                                                      |
|            c209f1n05.14.0*                                                     |
|            c209f1n05.13.0                                                      |
|                                                                                |
|Column: c209f1n01 / Processor1                                                  |
|            c209f1n05.11.0                                                      |
|            c209f1n05.14.0*                                                     |
|            c209f1n05.13.0                                                      |
|                                                                                |
|Column: c209f1n01 / Processor2                                                  |
|            c209f1n05.12.0                                                      |
|            c209f1n05.14.0*                                                     |
|            NULL                                                                |
|                                                                                |
|Column: c209f1n01 / Processor3                                                  |
|            c209f1n05.12.0                                                      |
|            c209f1n05.14.0*                                                     |
|            NULL                                                                |
+--------------------------------------------------------------------------------+

The following listing is sample output for the llmatrix -s -r c209f1n05 c209f1n01 command:

Figure 20. llmatrix -s -r output


+--------------------------------------------------------------------------------+
|c209f1n05!Processor0!c209f1n05.11.0,c209f1n05.14.0*,c209f1n05.13.0              |
|c209f1n05!Processor1!c209f1n05.11.0,c209f1n05.14.0*,c209f1n05.13.0              |
|c209f1n05!Processor2!c209f1n05.12.0,c209f1n05.14.0*,NULL                        |
|c209f1n05!Processor3!c209f1n05.12.0,c209f1n05.14.0*,NULL                        |
|c209f1n01!Processor0!c209f1n05.11.0,c209f1n05.14.0*,c209f1n05.13.0              |
|c209f1n01!Processor1!c209f1n05.11.0,c209f1n05.14.0*,c209f1n05.13.0              |
|c209f1n01!Processor2!c209f1n05.12.0,c209f1n05.14.0*,NULL                        |
|c209f1n01!Processor3!c209f1n05.12.0,c209f1n05.14.0*,NULL                        |
+--------------------------------------------------------------------------------+

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]