lsfeature

Edit online

Use the lsfeature command to list the features that are available for the current system code release. You can also list trial or entitlement information and license keys.

Syntax

Parameters

-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.
Note: If there is no data to be displayed, headings are not displayed.
-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 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.
-bytes: (Optional) Displays all capacities as bytes.

Description

This command lists the features that are available for the current system code release. You can also list trial or entitlement information and license keys.

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

Table 1. lsfeature outputs
Attribute	Possible Values
id	Indicates a number that refers to each feature of the system.
name	Indicates the feature name with a 16-character alphanumeric string: `easy_tier` `remote_mirroring` `flashcopy_upgrade` `turbo_performance` `encryption`
state	Indicates the current state of the feature: `active` `inactive` `trial_available` `trial_active` `trial_expired`
license_key	Indicates the key that is used in feature activation with a string that consists of 16 hexadecimal characters that are organized in four groups of four numbers with each group that is separated by a hyphen (such as `0123-4567-89AB-CDEF`).
trial_expiration_date	Indicates the trial expiration date as long as the state is `trial_available` or `trial_active`. This value is displayed in the format `YYYYMMDD`.

An invocation example

lsfeature

The resulting output:

id name              state           license_key          trial_expiration_date   serial_num mtm
0  turbo_performance trial_available                      20130201
1  easy_tier         trial_active                         20130101
2  flashcopy_upgrade active          0123-4567-89AB-CDEF
3  remote_mirroring  trial_expired                        20130201

An invocation example

In this system, both licenses are for encryption. There are two control enclosures, and the serial number and machine type are displayed:

lsfeature

The resulting output:

id name       state  license_key         trial_expiration_date serial_num mtm
0  encryption active 90AB-D41D-C799-2EF4                       78G00TT    2076-624
1  encryption active 3A87-463E-B5DF-9969                       31G00KG    2076-624

If one of the licenses is removed:

lsfeature

The resulting output:

id name       state    license_key         trial_expiration_date serial_num mtm
0  encryption inactive 90AB-D41D-C799-2EF4                       78G00TT    2076-624

The state is inactive because control enclosures require their own license to activate encryption.