Attributes of the -filtervalue argument CLI commands

You can use the -filtervalue argument to filter a view based on some specific attribute values that relate to each object type. You can combine multiple filters to create specific searches, for example, -filtervalue name=fred:status=online. The help (-filtervalue?) specifies the attributes available for each object type.

The -filtervalue argument, if used, must have attrib=value entered. The -filtervalue? and -filtervalue arguments are mutually exclusive.

Note:Note: The qualifiers < and > should be enclosed in quotes. For example,
-filtervalue vdisk_count "<"4 or port_count ">"1
It is also valid to include the whole expression in quotes. For example,
-filtervalue "vdisk_count<4"

When an attribute requires the -unit argument, it is specified after the attribute. For example,
-filtervalue capacity=24 -unit mb
The valid input options for the -unit parameter are:

  • b (bytes)
  • mb (Megabytes)
  • gb (Gigabytes)
  • tb (Terabytes)
  • pb (Petabytes)

The * character may be used as a wildcard at the beginning or end of a text string, but not both.

Table 102. Valid filter attributes
Object Attribute Valid Qualifiers Wildcard Valid Description
cluster cluster_name or name = Yes The cluster name.
cluster_unique_id or id =, <, <=, >, >= No The cluster ID.
node node_name or name = Yes The node name.
id =, <, <=, >, >= No The node ID.
status = No The status of the node.

The valid input options for node status are:

  • adding
  • deleting
  • online
  • offline
  • pending
IO_group_
name
= Yes The I/O group name.
IO_group_id =, <, <=, >, >= No The I/O group ID.
io_grp HWS_name or name = Yes The I/O group name
HWS_unique_
id or id
=, <, <=, >, >= No The I/O group ID.
node_count =, <, <=, >, >= No The number of nodes in the I/O group.
controller controller_id or id =, <, <=, >, >= No The controller ID.
mdisk name = Yes The name of the MDisk.
id =, <, <=, >, >= No The ID of the MDisk.
controller_
name
= Yes The name of the controller the MDisk belongs to.
status = No The status of the MDisk.

The valid input options for MDisk status are:

  • online
  • degraded
  • excluded
  • offline
mode = No The mode of the MDisk.

The valid input options for MDisk mode are:

  • unmanaged
  • managed
  • image
mdisk_grp_
name
= Yes The MDisk group name.
mdisk_grp_id =, <, <=, >, >= No The MDisk group ID.
capacity =, <, <=, >, >= No The capacity. Requires the -unit argument.
mdiskgrp name = Yes The MDisk group name.
storage_pool_id or id =, <, <=, >, >= No The MDisk group ID.
mdisk_count =, <, <=, >, >= No The number of MDisks in the group.
vdisk_count =, <, <=, >, >= No The number of VDisks in the group.
status = No The status of the MDisk group. The valid input options are:
  • online
  • degraded
  • offline
extent_size =, <, <=, >, >= No The extent size. (MB)
vdisk vdisk_name or name = Yes The name of the VDisk.
vdisk_id or id =, <, <=, >, >= No The ID of the VDisk.
IO_group_
name
= Yes The name of the I/O group.
IO_group_id =, <, <=, >, >= No The ID of the I/O group.
status = No The status of the VDisk.

The valid input options for VDisk status are:

  • online
  • degraded
  • offline
mdisk_grp_
name
= Yes The MDisk group name.
mdisk_grp_id =, <, <=, >, >= No The MDisk group ID.
capacity =, <, <=, >, >= No The capacity. Requires the -unit argument.
type = No The VDisk type. The valid value options are:
  • seq
  • striped
  • image
FC_name = Yes The FlashCopy mapping name.
FC_id =, <, <=, >, >= No The FlashCopy mapping ID.
RC_name = Yes The Remote Copy relationship name.
RC_id =, <, <=, >, >= No The Remote Copy relationship ID.
host host_name or name = Yes The host name.
host_id or id =, <, <=, >, >= No The host ID.
port_count =, <, <=, >, >= No The number of ports.
fcmap FC_mapping_name or name = Yes The FlashCopy mapping name.
FC_id or id =, <, <=, >, >= No The FlashCopy mapping ID.
source_vdisk_name = Yes The source VDisk name.
source_vdisk_id =, <, <=, >, >= No The source VDisk ID.
target_vdisk_name = Yes The target VDisk name.
target_vdisk_id =, <, <=, >, >= No The target VDisk ID.
group_name = Yes The consistency group name.
group_id =, <, <=, >, >= No The consistency group ID.
status = No The mapping status.

The valid input options for fcmap status are:

  • idle_copied
  • preparing
  • copying
  • stopped
  • suspended
copy_rate =, <, <=, >, >= No The background copy rate.
fcconsist-
grp
name = Yes The consistency group name.
FC_group_id or id =, <, <=, >, >= No The consistency group ID.
status = No The consistency group status. The valid value options are:
  • idle_or_copied
  • preparing
  • prepared
  • copying
  • stopped
  • suspended
rcrelation-
ship
RC_rel_id or id =, <, <=, >, >= No The Remote Copy relationship ID.
RC_rel_name or name = Yes The Remote Copy relationship name.
master_cluster_id =, <, <=, >, >= No The master cluster ID.
master_cluster_name = Yes The master cluster name.
master_vdisk_id =, <, <=, >, >= No The master VDisk ID.
master_vdisk_name = Yes The master VDisk name.
aux_cluster_id =, <, <=, >, >= No The aux cluster ID.
aux_cluster_name = Yes The aux cluster name.
aux_vdisk_id =, <, <=, >, >= No The aux VDisk ID.
aux_vdisk_name = Yes The aux VDisk name.
primary = No The relationship primary. The valid input values are:
  • master
  • aux
consistency_group_id =, <, <=, >, >= No The Remote Copy consistency group ID.
consistency_group_name = Yes The Remote Copy consistency group name.
state = Yes The relationship state. The valid input values are:
  • inconsistent_stopped
  • inconsistent_copying
  • consistent_stopped
  • consistent_synchronised
  • idling
  • idling_disconnected
  • inconsistent_disconnected
  • consistent_disconnected
progress =, <, <=, >, >= No The progress of the initial background copy (synchronization) for the relationship.
rcconsist-
grp
group_id or id =, <, <=, >, >= No The consistency group ID.
name = Yes The consistency group name.
master_cluster_id =, <, <=, >, >= No The master cluster ID.
master_cluster_name = Yes The master cluster name.
aux_cluster_id =, <, <=, >, >= No The aux cluster ID.
aux_cluster_name = Yes The aux cluster name.
primary = No The consistency group primary. The valid input values are:
  • master
  • aux
state = No The consistency group state. The valid input values are:
  • inconsistent_stopped
  • inconsistent_copying
  • consistent_stopped
  • consistent_synchronised
  • idling
  • idling_disconnected
  • inconsistent_disconnected
  • consistent_disconnected
  • empty
relationship_count =, <, <=, >, >= No The relationship count.
Related topics CLI commands

(C) Copyright International Business Machines Corporation 2003, 2004