Use the lsiogrp command to display a concise list or a detailed view
of input/output (I/O) groups visible to the system.
The list report style can be used to obtain the following two styles of report:
- A list that contains concise information about all the I/O groups that are visible to the
system. Each entry in the list corresponds to a single I/O group.
- The detailed information about a single I/O group.
Syntax
lsiogrp [ -filtervalueattribute=value ] [ -nohdr ] [ -delimdelimiter ] [ -filtervalue? ] [ -bytes ] [ { object_id | object_name } ]
Parameters
- -filtervalueattribute=value
- (Optional) Specifies a list of one or more filters. Only objects with a value that matches
the filter attribute value are returned. If a capacity is specified, the units must also be
included.
Note: Some filters allow the use of a wildcard when you enter the command. The following rules
apply to the use of wildcard characters when you use the CLI:
- The wildcard character is an asterisk (*), which must be the first or last character in
the string.
- The command can contain a maximum of one wildcard.
- When you use a wildcard, enclose the filter entry within double quotation marks (""), as
follows:
- lsiogrp -filtervalue "name=md*"
- -nohdr
- (Optional) By default, headings are displayed for each column of data in a concise style
view, and for each item of data in a detailed style view. The -nohdr
parameter suppresses the display of these headings.
- -delimdelimiter
- (Optional) By default in a concise view, all columns of data are space-separated. The width
of each column is set to the maximum width of each item of data. In a detailed view, each item
of data has its own row, and if the headers are displayed the data is separated from the
header by a space. The -delim parameter overrides this behavior. Valid
input for the -delim parameter is a 1-byte character. If you enter
-delim : on the command line, the colon character (:)
separates all items of data in a concise view; for example, the spacing of columns does not
occur. In a detailed view, the data is separated from its header by the specified
delimiter.
- -filtervalue?
- (Optional) Displays the valid filter attributes for the lsiogrp command.
- -bytes
- (Optional) Displays all capacities as bytes.
- object_id | object_name
- (Optional) Specifies the name or ID of an object. When you use this parameter, the detailed
view of the specific object is returned and any value that is specified by the
-filtervalue parameter is ignored. If you do not specify the
object_id | object_name parameter, the concise view of all objects that
match the filtering requirements that are specified by the -filtervalue
parameter are displayed.
Description
This command returns a concise list or a detailed view of I/O groups visible to the
system.
You can display the following information for this command:
- id
- Indicates the ID of the I/O group.
- name
- Indicates the name of the I/O group.
- node_count
- Indicates the number of nodes in the I/O group.
- vdisk_count
- Indicates the number of volumes in the I/O group.
- host_count
- Indicates the number of hosts in the I/O group.
- flash_copy_total_memory
- Indicates the total amount of memory that is allocated to FlashCopy.
- flash_copy_free_memory
- Indicates the total amount of memory that is allocated to FlashCopy, but unused.
- remote_copy_total_memory
- Indicates the total amount of memory that is allocated to Remote Copy, but unused.
- remote_copy_free_memory
- Indicates the total amount of memory that is allocated to Remote Copy, but unused.
- mirroring_total_memory
- Indicates the total amount of memory that is allocated to mirroring.
- raid_total_memory
- Indicates the total amount of memory that is allocated to RAID.
- raid_free_memory
- Indicates the total amount of memory that is allocated to RAID, but is unused.
- maintenance
- Indicates whether the I/O group is in maintenance mode. The values are:
- compression_active
- Indicates whether Real-time compression is used in the selected I/O group.
- accessible_vdisk_count
- The number of accessible volumes in this I/O group.
- compression_supported
- Indicates whether the I/O group supports Real-time compression or data reduction
compression.
- max_enclosures
- Indicates the maximum number of enclosures that are supported by this I/O group.
- encryption_supported
- Indicates whether the I/O group supports encryption for attached drives. The values are:
- encryption_supported
- Indicates whether the I/O group supports encryption for attached drives. The possible
values are:
- flash_copy_maximum_memory
- Identifies the maximum memory that can be set for the specified I/O group. The value must
be a numeric string in the range 552 MB - 2048 MB.
- site_id
- Identifies the site ID for the I/O group. The possible values are:
- site_name
- Identifies the site name for the I/O group. The value must be an alphanumeric string or
blank.
- compression_total_memory
- Indicates the total amount of memory that is allocated for Real-time compression per node
in the specified I/O group.
- fctargetportmode
- Indicates the current N_Port ID Virtualization (NPIV) status in the specified I/O group.
The values are:
- disabled
- transitional
- enabled
- changing_disabled_to_transitional
- changing_transitional_to_disabled
- changing_enabled_to_transitional
- changing_transitional_to_enabled
- deduplication_supported
- Indicates whether this I/O group supports data deduplication. The value that is displayed
is either yes or no.
Note: An I/O group indicates that data
deduplication is supported if the nodes in the I/O group have 32 GB of memory (or greater)
installed. The existence of Real-time compression volumes in the I/O group does not
influence whether data deduplication is shown as supported.
- deduplication_active
- Indicates whether data deduplication is in use in the I/O group. The value that is
displayed is either yes or no.
- nqn
- The NVMe Qualified Name (NQN) presented by nodes in this I/O group. This field is blank if
NVMe host attachment is not supported.
A concise invocation example
lsiogrp -delim :
The resulting output:
id:name:node_count:vdisk_count:host_count
0:io_grp0:1:0:0
1:io_grp1:0:0:0
2:io_grp2:0:0:0
3:io_grp3:0:0:0
4:recovery_io_grp:0:0:0
A detailed invocation example
lsiogrp -delim : 0
The detailed output:
id:0
name:io_grp0
node_count:1
vdisk_count:51
host_count:0
flash_copy_total_memory:3.0MB
flash_copy_free_memory:1.0MB
remote_copy_total_memory:6.5MB
remote_copy_free_memory:2.8MB
mirroring_total_memory:1.0MB
mirroring_free_memory:0.3MB
raid_total_memory:2MB
raid_free_memory:25.0MB
maintenance: no
compression_active:yes
accessible_vdisk_count:10
compression_supported:yes
max_enclosures:21flash_copy_maximum_memory:2048.0MB
compression_total_memory:35128.0MB
fctargetportmode:disabled
deduplication_supported: yes
deduplication_active: nonqn: nqn.1986-03.com.ibm:nvme:2145.000002006721FE4D.iogroup0