lsiogrp

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:

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:
  • yes
  • no
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:
  • yes
  • no
encryption_supported
Indicates whether the I/O group supports encryption for attached drives. The possible values are:
  • yes
  • no
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:
  • 1
  • 2
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