IVM lsmemdev command

Purpose

Lists block storage devices on the Virtual I/O Server that are capable of being added to a shared memory pool for use as paging space devices. This command is operable only in an Integrated Virtualization Manager environment.

Syntax

lsmemdev -r avail [-m ManagedSystem ] [-p <VIOS LPAR name> | --id <VIOS LPAR ID>] [--min <minimum size in MB>] [--max <maximum size in MB> [ --filter "FilterData" ] [ -F "AttributeNames" ] [--header] [--help]

Description

The lsmemdev command lists block storage devices on the Virtual I/O Server that are capable of being added to a shared memory pool for use as paging space devices. Only devices in the available state are displayed.

Flags

Flag name Description
-r ResourceType The type of resources to list:

avail: available resources  

-m ManagedSystem The name of the managed system. This attribute is optional because only one system is managed. The name can either be the user-defined name for the managed system, or be in the form tttt-mmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system.
--filter FilterData The filters to apply to the resources to be listed. Filters are used to select which resources of the specified resource type are to be listed. If no filters are used, all of the resources of the specified resource type are listed. For example, specific logical partitions can be listed by using a filter to specify the names or IDs of the logical partitions to list. Otherwise, if no filter is used, all the logical partitions in the managed system are listed.

The filter data consists of filter name/value pairs, which are in comma-separated value (CSV) format. The filter data must be enclosed in quotation marks.

The format of the filter data is as follows:
"filter-name=value,filter-name=value,..."
Note that certain filters accept a comma-separated list of values, as follows:
""filter-name=value,value,...",..."

When a list of values is specified, the filter name/value pair must be enclosed in quotation marks. Depending on the shell being used, nested quotation marks might need to be preceded by an escape character, which is usually a backslash (\) character.

Unless otherwise indicated, multiple values can be specified for each filter.

Valid filter names:

types | storage_pools | redundant

-F AttributeNames A delimiter separated list of attribute names for the desired attribute values to be displayed for each resource. If no attribute names are specified, values for all of the attributes for the resource are displayed.

When this option is specified, only attribute values are displayed. No attribute names are displayed. The attribute values displayed are separated by the delimiter which was specified with this option.

This option is useful when only attribute values are desired to be displayed, or when the values of only selected attributes are desired to be displayed.

Attribute names for partitions:
device_name
The Virtual I/O Server name of a block storage device.
phys_loc
If the device has a physical location code, this attribute is displayed by default with the physical location code as the value. If the device does not have a physical location code, this attribute is not displayed by default and has a blank value.
redundant_capable
This attribute is not displayed by default, but if requested has a value of 0.
size
Size of the block storage device in megabytes.
storage_pool
If the device comes from a storage pool, this attribute is displayed by default with the storage pool as the value. If the device does not come from a storage pool, this attribute is not displayed by default and has a blank value.
type
Type of the underlying device. Valid values follow:
  • logical
  • phys
  • storage_pool
--header Displays a header record, which is a delimiter-separated list of attribute names for the attribute values that are displayed. This header record is the first record displayed. This option is only valid when used with the -F option.

Exit Status

This command has a return code of 0 on success.

Security

This command is accessible by all users.

Examples

To list the storage devices that are capable of being added to a memory pool, type:
lsmemdev -r avail



Last updated: Wed, November 18, 2020