lssystem

Use the lssystem command to display a detailed view of a system.

Syntax

Parameters

-nohdr: (Optional) By default, headings are displayed for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.
Note: If no data exists to be displayed, headings are not displayed.
-delim delimiter: (Optional) 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 character with 1 byte. In a detailed view, the data is separated from its header by the specified delimiter.

Description

This command displays a detailed view of a system.

This table provides the attribute values that can be displayed as output view data.

Table 1. lssystem output
Attribute	Possible Values
layer	The value can be either: `replication`, which means the system can create partnerships. `storage` (default), which means the system can present storage.
location	The location is `local` or `remote`.
statistics status	The status is `on` or `off`.
auth_service_type
auth_service_configured	True if the `auth_service_type` is configured to be LDAP-only (if at least one LDAP server is configured).
auth_service_enabled
email_state	The possible values are: `running` `stopped` `invalid`
partnership	The possible values are: `fully_configured` `partially_configured_local` `partially_configured_local_stopped` `not_present` `fully_configured_stopped` `fully_configured_remote_stopped` `fully_configured_local_excluded` `fully_configured_remote_excluded` `fully_configured_exceeded` Blank
tier	Indicates which system information is being reported. The values are: `tier0_flash` `tier1_flash` `tier_enterprise` `tier_nearline` tier_scm
tier_capacity	Indicates the total MDisk storage in the tier.
tier_free_capacity	Indicates the amount of MDisk storage in the tier that is unused.
compression_active	Indicates whether any compressed volume copies exist in non-data reduction pools. Compressed volumes that are in data reduction pools do not count towards this value.
compression_virtual_capacity	Indicates the total virtual (provisioned) capacity for all compressed volume copies in non-data reduction pools. Compressed volumes that are in data reduction pools do not count towards this value. This value is in unsigned decimal format.
compression_compressed_capacity	Indicates the total used capacity for all compressed volume copies in non-data reduction pools. Compressed volumes that are in data reduction pools do not count towards this value. This value is in unsigned decimal format.
compression_uncompressed_capacity	Indicates the total uncompressed used capacity for all compressed volume copies in non-data reduction pools. Compressed volumes that are in data reduction pools do not count towards this value. This value is in unsigned decimal format.
physical_capacity	Indicates the total physical capacity of all standard-provisioned and thin-provisioned storage that is managed by the storage system. The value is rounded to two decimal places.
physical_free_capacity	Indicates the total free physical capacity of all standard-provisioned and thin-provisioned storage that is managed by the storage system. The value is rounded to two decimal places.
total_reclaimable_capacity	Indicates the unused (free) capacity that will be available after data is reduced. For storage pools that are not data reduction pools, this field reports `0.00MB`. Note: total_reclaimable_capacity is a sum of all the lsmdiskgrp reclaimable_capacities, which has a +/-1% margin. Therefore, this field has up to a +/-4% margin.
used_capacity_before_reduction	Indicates the total amount of data that is written to thin-provisioned and compressed volume copies that are in data reduction storage pools - before data reduction occurs. This value does not include standard-provisioned volumes (that can be created in a data reduction storage pool) because they are not eligible for reduction.
used_capacity_after_reduction	Indicates the total amount of capacity that is used for thin-provisioned and compressed volume copies in the storage pool after data reduction occurs.
overhead_capacity	Indicates the overhead capacity consumption in all storage pools that is not attributed to data.
rc_buffer_size	Indicates the resource buffer size that is assigned for Metro Mirror, Global Mirror, and HyperSwap® Copy Services.
has_nas_key	The value is `yes` or `no`.
total_drive_raw_capacity	The total known capacity of all discovered drives (regardless of drive use).
email_organization	Indicates the user's organization that is shown in the call home email function.
email_machine_address	Indicates the user's mailing address that is shown in the call home email function.
email_machine_city	Indicates the user's city that is shown in the call home email function.
email_machine_state	Indicates the user's state that is shown in the call home email function.
email_machine_zip	Indicates the user's postal code that is shown in the call home email function.
email_machine_country	Indicates the user's country that is shown in the call home email function.
cache_prefetch	Indicates whether cache prefetching is enabled across the system. The values are `on` and `off`.
local_fc_port_mask	Indicates the Fibre Channel (FC) input/output (I/O) ports that a system can use for node-to-node communications on a local system if those FC I/O ports exist on a node. The value is 64 binary bits.
partner_fc_port_mask	Indicates the FC I/O ports that a system can use for system-to-system communications on a partner system if those FC I/O ports exist on a node. The value is 64 binary bits.
topology	Indicates the system topology: `standard` `stretched` `hyperswap`
topology_status	Indicates the system topology status: `dual_site` `recovered_site_1` `recovered_site_2`
compression_destage_mode	Indicates the cache destage mode operation for Real-time compression within the cluster.
rc_auth_status	Indicates remote copy authentication. Remote copy includes Metro Mirror, Global Mirror, and HyperSwap. The values are: `chap` `none` (default)
vdisk_protection_time	Indicates the volume protection time in minutes (whether volume protection is enabled or not enabled). The value must be a number from 15 (default) to 1440.
vdisk_protection_enabled	Indicates whether volume protection is enabled (`yes`) or disabled (`no`) for a system.
product_name	Indicates the product name (an alphanumeric string of no more than 62 characters).
odx	Indicates whether offloaded data transfer (ODX) is enabled or disabled. The values are `on` and `off`.
easy_tier_acceleration	Indicates Easy Tier® and pool balance acceleration status. The values are `on` and `off`.
max_replication_delay	Indicates the value for maximum replication delay and is a numeric value in the range 0 - 360.
partnership_exclusion_threshold	Indicates the partnership exclusion threshold value and is a numeric value in the range 30 - 315.
ibmcustomer	Indicates the customer number. The value is blank or is a number that contains 7 - 10 digits.
ibmcomponent	Indicates the component. The value is blank, `SANVCNSW1`, or `SPVIRT4CL`.
ibmcountry	Indicates the country. The value is blank or a 3-digit number.
tier_0_flash_compressed_data_used	Indicates the capacity of compressed data that is used on the `flash` tier 0 storage tier. The value must be a number with two decimal places.
tier_1_flash_compressed_data_used	Indicates the capacity of compressed data that is used on the `flash` tier 1 storage tier. The value must be a number with two decimal places.
tier_enterprise_compressed_data_used	Indicates the capacity of compressed data that is used on the tier 2 `enterprise` storage tier. The value must be a number with two decimal places.
tier_nearline_compressed_data_used	Indicates the capacity of compressed data that is used on the tier 3 `nearline` storage tier. The value must be a number with two decimal places.
enhanced_callhome	Indicates whether to collect enhanced data in the call home report. The values are `on` or `off`. The enhanced reports include operational and event-related data and specific configuration information that is included in the inventory report. This function alerts the support center about hardware failures and potentially serious configuration or environmental issues. The support center can use the configuration information to automatically generate best practices or recommendations that are based on your actual configuration.
censor_callhome	Indicates that sensitive data is stripped from enhanced call home data. The values are `on` or `off`.
total_mdisk_capacity	Indicates the sum of mdiskgrp `capacity` plus the capacity of all unmanaged MDisks.
space_in_mdisk_grps	Indicates the sum of mdiskgrp `capacity`.
space_allocated_to_vdisks	Indicates the sum of mdiskgrp `real_capacity`.
total_free_space	Indicates the sum of mdiskgrp `free_capacity`.
total_vdiskcopy_capacity	Indicates the total provisioned capacity of all volume copies in the cluster.
total_used_capacity	Indicates the sum of mdiskgrp `used_capacity`.
total_vdisk_capacity	Indicates the total provisioned capacity of volumes in the cluster.
total_allocated_extent_capacity	Indicates the total size of all extents that are allocated to VDisks or otherwise in use by the system.
total_overallocation	Indicates the `total_vdiskcopy_capacity` as a percentage of `total_mdisk_capacity`. If `total_mdisk_capacity` is zero, then `total_overallocation` should display `100`.
tier0_flash_compressed_data_used	Indicates the capacity of compressed data used on the flash tier 0 storage tier.
tier1_flash_compressed_data_used	Indicates the capacity of compressed data used on the flash tier 1 storage tier.
deduplication_capacity_saving	Indicates the total amount of used capacity that is saved by data deduplication. This saving is before any compression.
compression_opportunity	Indicates the total amount of capacity of all volume-copies within data reduction pools that are enabled for compression. It does not include Real-time compression capacity or capacity that has been saved by data deduplication.
deduplication_opportunity	Indicates the total amount of `used_capacity_before_reduction` of all volume-copies within data reduction pools that are enabled for data deduplication.
host_unmap	This field displays whether SCSI Unmap support is enabled from the Host perspective. The possible values that are displayed are `on` or `off`.
backend_unmap	This field displays whether SCSI Unmap support for backend storage is enabled by the administrator. The possible values that are displayed are `on` or `off`.

Information about the remote system is reported by the lssystem command if you issue either the mkfcpartnership or mkippartnership command from the local system to the remote system. For example, if the partnership is at least partially established from the local system.

Issue the lssystem command to display a detailed view of the system.

Detailed view shows the fields that are described for remote systems only; if the system location is local, then partnership and bandwidth do not apply (and are not defined or provided). For a remote system, these fields indicate the following information:

location: remote or local
partnership
fully_configured: The mkfcpartnership or mkippartnership command is issued in both directions and the remote system is online and available.
partially_configured_local: The mkfcpartnership or mkippartnership command is issued from the local system to the remote system. The remote system is online and available for partnership.
partially_configured_local_stopped: The mkfcpartnership or mkippartnership command is issued from the local system to the remote system. The chpartnership command with the stop parameter is issued from the local system, and the remote system is online and available. Issue the chpartnership command with the start parameter on the local system, and mkfcpartnership or mkippartnership on the remote system.
not_present: The mkfcpartnership or mkippartnership command is issued from the local system to the remote system, and the remote system is not available. Either the remote system is offline, or it is not connected to the local system.
fully_configured_stopped: The mkfcpartnership or mkippartnership command is issued in both directions and the remote system is online and available. The chpartnership command with the stop parameter is issued from the local system.
fully_configured_remote_stopped: The mkfcpartnership or mkippartnership command is issued in both directions and the remote system is online and available. The chpartnership command with the stop parameter is issued from the remote system.
fully_configured_local_excluded
fully_configured_remote_excluded
fully_configured_exceeded: Too many systems exist in the system network, and the partnership from the local system to the remote is disabled. Refer to the 1710 or 1720 errors in the system error log at the local and remote system.
bandwidth: The bandwidth available on the intersystem link for background copy, in megabytes per second (MBps).
Important: For partnerships over IP links with compression, this parameter specifies the aggregate bandwidth after the compression had been applied to the data. Do not set this parameter higher than the physical link bandwidth multiplied by the (carefully rounded down) compression factor.

The console_IP field displays either the:

Automatically populated system port 1 IP Address - Internet Protocol Version 4 (IPv4) or IPv6
User-populated IPv4 address

The port value is always 443, which requires the system to run by using default Hypertext Transfer Protocol Secure (HTTPS).

A concise invocation example

lssystem delim :

The resulting output:

id:name:location:partnership:id_alias
000002006420A162:system0:local::000002006420A162

A detailed invocation example

lssystem -delim :

The resulting output:

id:00000200A2600906
name:tbcluster-29
location:local
partnership
bandwidth
total_mdisk_capacity:60.5TB
space_in_mdisk_grps:60.5TB
space_allocated_to_vdisks:643.74GB
total_free_space:59.9TB
total_vdiskcopy_capacity:663.46GB
total_used_capacity:560.99GB
total_overallocation:1
total_vdisk_capacity:501.25GB
total_allocated_extent_capacity:792.50GB
statistics_status:on
statistics_frequency:15
cluster_locale:en_US
time_zone:375 Europe/London
code_level:6.4.0.0 (build 64.6.1205081000)
console_IP:9.71.53.69:443
id_alias:00000200A2600906
gm_link_tolerance:300
gm_inter_cluster_delay_simulation:0
gm_intra_cluster_delay_simulation:0
gm_max_host_delay:5
email_reply
email_contact
email_contact_primary
email_contact_alternate
email_contact_location
email_contact2
email_contact2_primary
email_contact2_alternate
email_state stopped
inventory_mail_interval:0
iscsi_auth_method:chap
iscsi_chap_secret:MYCLUSTERCHAP
auth_service_configured:no
auth_service_enabled:no
auth_service_url
auth_service_user_name
auth_service_pwd_set:no
auth_service_cert_set:no
auth_service_type:ldap
relationship_bandwidth_limit:25
tier:tier0_flash
tier_capacity:1.63TB
tier_free_capacity:1.63TB
tier:tier1_flash
tier_capacity:1.63TB
tier_free_capacity:1.63TB
tier:tier_enterprise
tier_capacity:0.00MB
tier_free_capacity:0.00MB
tier:tier_nearline
tier_capacity:0.00MB
tier_free_capacity:0.00MB
has_nas_key:no
layer:replication
rc_auth_method:none
rc_buffer_size:48
compression_active:yes
compression_virtual_capacity:1000.00MB
compression_compressed_capacity:0.41MB
compression_uncompressed_capacity:512.05MB
data_reduction:yes
total_reclaimable_capacity:10.00MB
used_capacity_before_reduction:10.00MB
used_capacity_after_reduction:20.00MB
overhead_capacity:50.00MB
cache_prefetch:on
email_organization:UEFA
email_machine_address:1 Chelsea Blvd
email_machine_city:Fulham
email_machine_state:XX
email_machine_zip:OU812
email_machine_country:GB
total_drive_raw_capacity:900.00GB
easy_tier_acceleration off
local_fc_port_mask:0000000000000000000000000000000000000000000000000000000000001101
partner_fc_port_mask:0000000000000000000000000000000000000000000000000000000000000011
topology:standard
topology_status:
compression_destage_mode:false
vdisk_protection_time:120
vdisk_protection_enabled no
product_name:Compumarge
odx:on
max_replication_delay:222
partnership_exclusion_threshold:120

ibmcustomer:1234567
ibmcomponent:SANVCNSW1
ibmcountry:866

tier_0_flash_compressed_data_used:0.00MB
tier_1_flash_compressed_data_used:0.00MB
tier_enterprise_compressed_data_used:0.00MB
tier_nearline_compressed_data_used:0.00MB

physical_capacity:0.00MB
physical_free_capacity:0.00MB
enhanced_callhome:on
censor_callhome:off
deduplication_capacity_saving:100GB
overhead_capacity:23.00GB
host_unmap:on
backend_unmap:on

A detailed invocation example

lssystem -delim :

The resulting output:

id:00000200A2600906
name:tbcluster-29
location:local
partnership
bandwidth
total_mdisk_capacity:60.5TB
space_in_mdisk_grps:60.5TB
space_allocated_to_vdisks:643.74GB
total_free_space:59.9TB
total_vdiskcopy_capacity:663.46GB
total_used_capacity:560.99GB
total_overallocation:1
total_vdisk_capacity:501.25GB
total_allocated_extent_capacity:792.50GB
statistics_status:on
statistics_frequency:15
cluster_locale:en_US
time_zone:375 Europe/London
code_level:6.4.0.0 (build 64.6.1205081000)
console_IP:9.71.53.69:443
id_alias:00000200A2600906
gm_link_tolerance:300
gm_inter_cluster_delay_simulation:0
gm_intra_cluster_delay_simulation:0
gm_max_host_delay:5
email_reply
email_contact
email_contact_primary
email_contact_alternate
email_contact_location
email_contact2
email_contact2_primary
email_contact2_alternate
email_state stopped
inventory_mail_interval:0
iscsi_auth_method:chap
iscsi_chap_secret:MYCLUSTERCHAP
auth_service_configured:no
auth_service_enabled:no
auth_service_url
auth_service_user_name
auth_service_pwd_set:no
auth_service_cert_set:no
auth_service_type:tip
relationship_bandwidth_limit:25
tier:ssd
tier_capacity:0.00MB
tier_free_capacity:0.00MB
tier:enterprise
tier_capacity:60.49TB
tier_free_capacity:59.72TB
has_nas_key:no
layer:replication
rc_auth_method:none
rc_buffer_size:48
compression_active:yes
compression_virtual_capacity:1000.00MB
compression_compressed_capacity:0.41MB
compression_uncompressed_capacity:512.05MB
cache_prefetch:on
email_organization:UEFA
email_machine_address:1 Chelsea Blvd
email_machine_city:Fulham
email_machine_state:XX
email_machine_zip:OU812
email_machine_country:GB
total_drive_raw_capacity:900.00GB
easy_tier_acceleration off
local_fc_port_mask:0000000000000000000000000000000000000000000000000000000000001101
partner_fc_port_mask:0000000000000000000000000000000000000000000000000000000000000011
topology:standard
topology_status:
compression_destage_mode false
vdisk_protection_time 120
vdisk_protection_enabled no
product_name Compumarge
odx on
max_replication_delay 222

A detailed invocation example

lssystem

The resulting output:

id 000002006C40A278
name cluster0
location local
partnership
bandwidth
total_mdisk_capacity 222.2GB
space_in_mdisk_grps 0
space_allocated_to_vdisks 0.00MB
total_free_space 222.2GB
total_vdiskcopy_capacity 0.00MB
total_used_capacity 0.00MB
total_overallocation 0
total_vdisk_capacity 0.00MB
total_allocated_extent_capacity 0.00MB
statistics_status on
statistics_frequency 15
cluster_locale en_US
time_zone 522 UTC
code_level 6.4.0.0 (build 61.9.1112130001)
console_IP 0.0.0.0:443
id_alias 000002006C40A278
gm_link_tolerance 300
gm_inter_cluster_delay_simulation 0
gm_intra_cluster_delay_simulation 0
gm_max_host_delay 5
email_reply
email_contact
email_contact_primary
email_contact_alternate
email_contact_location
email_contact2
email_contact2_primary
email_contact2_alternate
email_state stopped
inventory_mail_interval 0
cluster_ntp_IP_address
cluster_isns_IP_address
iscsi_auth_method none
iscsi_chap_secret
auth_service_configured no
auth_service_enabled no
auth_service_url
auth_service_user_name
auth_service_pwd_set no
auth_service_cert_set no
auth_service_type tip
relationship_bandwidth_limit 25
tier tier0_flash
tier_capacity 1.63TB
tier_free_capacity 1.63TB
tier tier1_flash
tier_capacity 1.63TB
tier_free_capacity 1.63TB
tier tier_enterprise
tier_capacity 0.00MB
tier_free_capacity 0.00MB
tier tier_nearline
tier_capacity 0.00MB
tier_free_capacity 0.00MB
has_nas_key no
layer replication
rc_buffer_size 48
compression_active no
compression_virtual_capacity 0.00MB
compression_compressed_capacity 0.00MB
compression_uncompressed_capacity 0.00MB
data_reduction yes
total_reclaimable_capacity 25.00MB
used_capacity_before_reduction
used_capacity_after_reduction
overhead_capacity
cache_prefetch on
email_organization
email_machine_address
email_machine_city
email_machine_state XX
email_machine_zip
email_machine_country
total_drive_raw_capacity 173.63TB
easy_tier_acceleration off
local_fc_port_mask:0000000000000000000000000000000000000000000000000000000000001101
partner_fc_port_mask:0000000000000000000000000000000000000000000000000000000000000011
topology:standard
topology_status:
compression_destage_mode false
vdisk_protection_time 120
vdisk_protection_enabled yes
product_name Compuhomer
odx on
max_replication_delay 333
partnership_exclusion_threshold 120

ibmcustomer 1234567
ibmcomponent SANVCNSW1
ibmcountry 866

tier_0_flash_compressed_data_used 0.00MB
tier_1_flash_compressed_data_used 0.00MB
tier_enterprise_compressed_data_used 0.00MB
tier_nearline_compressed_data_used 0.00MB

physical_capacity:768.00GB
physical_free_capacity:692.81GB
enhanced_callhome off
censor_callhome on

A detailed invocation example

lssystem

The resulting output:

id 000002006C40A278
name cluster0
location local
partnership
bandwidth
total_mdisk_capacity 222.2GB
space_in_mdisk_grps 0
space_allocated_to_vdisks 0.00MB
total_free_space 222.2GB
total_vdiskcopy_capacity 0.00MB
total_used_capacity 0.00MB
total_overallocation 0
total_vdisk_capacity 0.00MB
total_allocated_extent_capacity 0.00MB
statistics_status on
statistics_frequency 15
cluster_locale en_US
time_zone 522 UTC
code_level 6.4.0.0 (build 61.9.1112130001)
console_IP 0.0.0.0:443
id_alias 000002006C40A278
gm_link_tolerance 300
gm_inter_cluster_delay_simulation 0
gm_intra_cluster_delay_simulation 0
gm_max_host_delay 5
email_reply
email_contact
email_contact_primary
email_contact_alternate
email_contact_location
email_contact2
email_contact2_primary
email_contact2_alternate
email_state stopped
inventory_mail_interval 0
cluster_ntp_IP_address
cluster_isns_IP_address
iscsi_auth_method none
iscsi_chap_secret
auth_service_configured no
auth_service_enabled no
auth_service_url
auth_service_user_name
auth_service_pwd_set no
auth_service_cert_set no
auth_service_type tip
relationship_bandwidth_limit 25
tier ssd
tier_capacity 0.00MB
tier_free_capacity 0.00MB
tier enterprise
tier_capacity 111.10GB
tier_free_capacity 111.10GB
tier nearline
tier_capacity 111.10GB
tier_free_capacity 111.10GB 
has_nas_key no
layer replication
rc_buffer_size 48
compression_active no
compression_virtual_capacity 0.00MB
compression_compressed_capacity 0.00MB
compression_uncompressed_capacity 0.00MB
cache_prefetch on
email_organization
email_machine_address
email_machine_city
email_machine_state XX
email_machine_zip
email_machine_country
total_drive_raw_capacity 173.63TB
easy_tier_acceleration off
local_fc_port_mask:0000000000000000000000000000000000000000000000000000000000001101
partner_fc_port_mask:0000000000000000000000000000000000000000000000000000000000000011
topology:standard
topology_status:
compression_destage_mode false
vdisk_protection_time 120
vdisk_protection_enabled yes
product_name Compuhomer
odx on
max_replication_delay 333
deduplication_capacity_saving:100GB
overhead_capacity:23.00GB