Specifications

Fabric OS Commands
390 Fabric OS Version 3.1.x/4.1.x Reference Guide
■ white space like spaces, and tab stops are skipped.
■ ranges using “-” can be mixed with individual values.
■ Each item may be proceeded by an optional slot number and “/”. for example,
“0,3,4-6,1”, “0,1,3,4,5,6”, “0 3 4 - 6 1" will all select items 0, 1, 3, 4, 5, 6 and
7.
Besides the syntax rules, there are also some grammatical restrictions on the slot
numbers:
■ Once specified a slot selection will apply to all following items to the right of
the slot selection until the next slot selection or the end of the item list. For
example, “1/0 - 15" and “1/0 - 1/15” are equivalent.
■ If no slot number is specified then User port lists will be specified by area
number. For instance “0, 16, 32" and “1/0, 2/0, 3/0” specify the same ports on
a 16 port/blade system. On that same system “1/0, 16, 32" is not a legal list.
Even though it is legal syntax the ports do not exist.
■ If no slot number is specified then all lists except user port lists will use the
default slot 0.
■ No list type except for user port lists may specify multiple conflicting slot
numbers. For instance “1/0, 2/0, 3/0” is a legal user port list but is not legal for
any other type of list.
■ In the case of conflicting settings within a single itemlist an error will be
generated as described above. In the case of multiple item list parameters, the
last one on the command line will override any previous settings.
The exact type of list varies depending on the test and the parameter but the most
common are Blade ports and User ports. A list of Blade ports is most commonly
used by the ASIC level tests such as cmitest or turboramtest and represents which
ports on the current blade (specified with --slot # parameter) will be tested. A list
of User ports is used by the higher level tests such as spinsilk or crossporttest to
specify which user accessible external ports within the current switch (selected
during telnet login) will be tested. When specified in an item list user ports may be
specified by either the area portion of the ports fibre channel address or with
slot/port notation. For non-bladed systems the port number on the silkscreen is the
area number so the two notations are identical.
The exact type of list required for any input parameter may be determined with the
diagcommandshow <test> command. For item list parameters the
parameter type will be PT_LIST and the list type will be one of the following: