lsiogrp
Use the lsiogrp command to display a concise list or a detailed view of input/ouput (I/O) groups visible to the clustered system (system).
The list report style can be used to obtain the following
two styles of report:
- A list containing 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 -- -- --+-----------------------------------+-- ----> '- -filtervalue -- attribute=value -' >--+----------+-- --+-----------------------+-- -- -------------> '- -nohdr -' '- -delim -- delimiter -' >--+-----------------+-- --+----------+-- --+---------------+-->< '- -filtervalue? -' '- -bytes -' +- object_id ---+ '- object_name -'
Parameters
- -filtervalue attribute=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 using 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.
- -delim delimiter
- (Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum possible 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 one 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:
- HWS_name
- HWS_unique_id
- node_count
- name
- id
- host_count
- -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 matching the filtering requirements that is 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 allocated to FlashCopy®.
- flash_copy_free_memory
- Indicates the total amount of memory allocated to FlashCopy, but unused.
- remote_copy_total_memory
- Indicates the total amount of memory allocated to Remote Copy, but unused. Remote copy includes Metro Mirror, Global Mirror, and HyperSwap®.
- remote_copy_free_memory
- Indicates the total amount of memory allocated to Remote Copy, but unused. Remote copy includes Metro Mirror, Global Mirror, and HyperSwap.
- mirroring_total_memory
- Indicates the total amount of memory allocated to mirroring.
- raid_total_memory
- Indicates the total amount of memory allocated to RAID.
- raid_free_memory
- Indicates the total amount of memory allocated to RAID, but is unused.
- maintenance
- Indicates if the I/O group is in maintenance mode. The values
are:
- yes
- no
- compression_active
- Indicates if compression is active for this I/O group.
- accessible_vdisk_count
- The number of accessible volumes in this I/O group.
- compression_supported
- Indicates if the I/O group supports compressed volumes.
- max_enclosures
- Indicates the maximum number of enclosures supported by this I/O group.
- 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 between 552 MB and 2048 MB.
- compression_total_memory
- Indicates the amount of RAM allocated for compression 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
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:21
flash_copy_maximum_memory:2048.0MB
compression_total_memory:35128.0MB
fctargetportnode:disabled