Data types and value ranges CLI commands Terminology

This topic provides information about the different data types and value ranges.

The following list defines each of the data types and value ranges.

Note:Note: If you do not specify a name when creating a new object, the cluster will assign a default name. This name is made from the object type as a prefix and the object ID as the suffix. For example, a new virtual disk (VDisk) is created with ID 5. This object will be given the default name of vdisk5. Because the system assigns these names, it will not allow you to create an object and call it vdiskx where x is the integer. This is because the cluster reserves these names (for example, object_type_prefix integer) for default.

filename_arg
This is a (optionally fully qualified) file name. Maximum length is 231 characters. Valid characters consist of the following:
  • .
  • /
  • -
  • _
  • a - z
  • A - Z
  • 0 - 9
The field may not contain two consecutive '.', or start with a '.', or end with a '.'.
directory_or_file_filter
Specifies a directory and or filename filter within the specified directory. Valid directory values consist of the following:
  • /dumps
  • /dumps/configs
  • /dumps/elogs
  • /dumps/feature
  • /dumps/iostats
  • /dumps/iotrace
  • /dumps/software
The filename filter can be any valid filename with or without the wildcard '*'. The filename filter can be appended to the end of one of the above directory values. Maximum length is 231 characters. Valid characters consist of the following:
  • *
  • .
  • /
  • -
  • _
  • a - z
  • A - Z
  • 0 - 9
The field may not contain two consecutive '.', or start with a '.', or end with a '.'.
filename_prefix
This is a prefix to be used when naming a file. Maximum length is 231 characters. Valid characters consist of the following:
  • a - z
  • A - Z
  • 0 - 9
  • -
  • _
name_arg
Names can be specified or changed using the create and modify functions. The view commands allow you to see both the name and ID of an object.

A string of 1-15 characters is allowed, composed of characters A-Z, a-z, 0-9, - and _.

The first character of a name_arg must not be numeric. The first character of an object name can not be a - as the CLI will interpret it as being the next parameter.

When creating a name for an object, the name may not consist of the object type followed only by an integer. The exception is Remote Copy relationships which can be named anything as long as the names are unique across the two clusters. This naming convention is used by the system to generate default names. You can not use one of the following reserved words followed by an integer:

  • cluster
  • controller
  • fccstgrp
  • fcmap
  • host
  • io_grp
  • mdisk
  • mdiskgrp
  • node
  • rccstgrp
  • rcmap

The cluster name is set when the cluster is created and is the only name that cannot be changed afterwards.

password
This is a user defined password. A password must meet the following requirements:
  • may use a - z, A - Z, 0 - 9 in any sequence
  • may use - (dash) but not as the first character
  • may use _ (underscore)
  • may contain a maximum of 15 characters
serial_number
The format of this number conforms to IBM standard C-S 1-1121-018 1999-06 Serial Numbering for IBM products. The serial number is 7 digits, the first two of which define the manufacturing location, leaving 5 digits for the product. The standard defines a way to extend the serial number using letters in the place of numbers in the 5 digit field.
ip_address_arg
The decimal, dotted quad notation, standard rules.
dns_name
Dotted domain name for the subnet that the cluster is in. For example, ibm.com.
hostname
The hostname assigned to the cluster. This can be different from the cluster name and you can change the hostname at any time.

A combination of the hostname and the dns_name that is used to access the cluster, for example:
https://hostname.ibm.com/

capacity_value
A value in multiples of 1 MB, ranging from 16 MB to 2 PetaBytes (PB).
Note:Note: The capacity can be specified as MB, KB, GB, or PB. When MB is used, the figure will be rounded up to the nearest 16 MB.
delay_arg
Unassigned integer ranging from 1 to 65535 (minutes for battery test).
node_id
Node IDs differ from other IDs as they are a unique node ID that is assigned when the node is initialized. Node IDs are expressed as 64-bit hexadecimal numbers. For example:
1A2B30C67AFFE47B
Node IDs, like other IDs, cannot be modified by user commands.
xxx_id
All objects are referred to by unique integer IDs that are assigned by the system when the objects are created. All IDs are represented internally as 32-bit integers. Node IDs are an exception.

IDs in the following ranges are used to identify the various types of objects:

  • node_id: 1 - 32
  • mdisk_grp_id: 0 - 127
  • io_grp_id: 0 - 3 (See Note.)
  • mdisk_id: 0 - 4095
  • vdisk_id: 0 - 8191
  • host_id: 0 - 127
  • flash_const_grp_id: 0 - 255
  • remote_const_grp_id: 0 - 255
  • fcmap_id: 0 - 4095
  • rcrel_id: 0 - 8191
  • controller_id: 0-63
Note:Note: io_group 4 exists but is only used in certain error recovery procedures.

These IDs, like node IDs, cannot be modified by user commands.

Note:Note: IDs are assigned at run-time by the system and cannot be relied upon to be the same after, for example, during the configuration restoration. Therefore, wherever possible, object names should be used in preference to IDs when working with objects.
xxx_list
A colon-delimited list of values of type xxx.
wwpn_arg
The Fibre Channel World Wide Port Name (wwpn). This is expressed as a 64-bit hexadecimal number, for example:
1A2B30C67AFFE47B
These numbers must be composed of the characters 0 - 9, a - f, and A - F. A command will fail if you enter WWPN 0 in the command string.
panel_name
A string of up to 6 characters that correspond to the number on the printed label below the APA display on the front panel of a node in the cluster.
sequence_number
32-bit unsigned integer, expressed in decimal.
scsi_num_arg
32-bit unsigned integer, expressed in decimal.
percentage_arg
8-bit unsigned integer, expressed in decimal 0 to 100.
extent_arg
32-bit unsigned integer, expressed in decimal.
num_extents_arg
32-bit unsigned integer, expressed in decimal.
threads_arg
8-bit unsigned integer, expressed in decimal, valid values, 1, 2, 3, or 4.
velocity_arg
The fabric speed in Giga-bits per second. Valid values are 1 or 2.
timezone_arg
The ID as detailed in the output of the svcinfo lstimezones command.
timeout_arg
The command timeout period. An integer from 0 to 600 (seconds).
stats_time_arg
The frequency at which statistics are gathered. 5 to 300 (seconds) in increments of 5.
directory_arg
Specifies a directory and or filename filter within the specified directory. Valid directory values are:
  • /dumps
  • /dumps/configs
  • /dumps/elogs
  • /dumps/feature
  • /dumps/iostats
  • /dumps/iotrace
  • /dumps/software

The filename filter can be any valid filename with or without the wildcard '*'.

The filename filter can be appended to the end of one of the above directory values.

locale_arg
The cluster locale setting. Valid values are 0 to 9.
  • 0 US English (default)
  • 1 Chinese (simplified)
  • 2 Chinese (traditional)
  • 3 Japanese
  • 4 Korean
  • 5 French
  • 6 German
  • 7 Italian
  • 8 Spanish
  • 9 Portuguese (Brazilian)
key_arg
A user definable identifier for an SSH key. A string of up to 30 characters.
user_arg
Specifies the user, either admin or service.
copy_rate
A numeric value from 0 to 100.
Related topics CLI commands Terminology

(C) Copyright International Business Machines Corporation 2003, 2004