setbackendtype

Use the setbackendtype command to set or update the type of back-end storage system.

This command is available for the following storage systems:
  • Storwize® V7000
  • Storwize V7000 Unified
  • SAN Volume Controller
You must have Administrator authority to use this command.

Syntax for setting and updating back-end types of storage systems

Use this syntax to set a new type of back-end storage system:

Read syntax diagramSkip visual syntax diagramtpctoolsetbackendtype-user user_name -pwd password -url url -typestorage_system_type -namestorage_system_name -cachehitcache_hit_ratio -descriptiondescription -fs character-header -help-qs character?-silent-grouping

Use this syntax to update a type of back-end storage system:

Read syntax diagramSkip visual syntax diagramtpctoolsetbackendtype-user user_name -pwd password -url url -typestorage_system_type -namestorage_system_name-cachehitcache_hit_ratio-descriptiondescription-fs character-header -help-qs character?-silent-grouping

Parameters and arguments

-user user_name
Specifies an IBM Spectrum Control user ID.
-pwd password
Specifies the password for the IBM Spectrum Control user ID.
-url url
Specifies the Device server. The format of the URL is system:port_number, where system represents either the host name or IP address, and port_number represents the IBM Spectrum Control Device server port.
-type storage_system_type
Specifies the type of back-end storage system that manages most of the subsystem pool resources. The maximum number of characters that you can enter is 10. You can enter a type or use one of the following values:
Value Name
C EMC Clariion
D DS8000®
S EMC Symmetrix
X XIV®
DEFAULT Default value
-name storage_system_name
Specifies the name of the back-end type of storage system. The maximum number of characters that you can enter is 256. The name of the type of storage system is displayed on the MDisk Group Details page in the IBM Spectrum Control graphical user interface. You can enter a name or use one of the following values.
Description value Associated type value
"EMC Clariion" C
DS8000 D
"EMC Symmetrix" S
XIV X
DEFAULT DEFAULT
Tip: If you enter a value for the -name or -description parameter that contains spaces, you must enclose the value in double quotation marks such as "My Description".
-cachehit cache_hit_ratio
Specifies the ratio of cache hits for read operations. The maximum number of characters that you can enter is 4. You can specify a value or use one of the following values:
Value Back-end storage system
50 EMC Clariion
50 DS8000
70 EMC Symmetrix
50 XIV
0 Default value
-description description
Provides more information about the type of back-end storage system. The maximum number of characters that you can enter is 256. You can enter a description or use one of the following values:
Value Description
"CX BE Cache Hit Ratio" EMC Clariion
"DS8K Disk Controller" DS8000
"DMX BE Cache Hit Ratio" EMC Symmetrix
"IBM XIV" XIV
"DEFAULT TYPE FOR UNCONFIGURED DEVICES" 0 (default value)
-fs character
Specifies the 7-bit character that separates the information in the output. If you omit this parameter, the information is separated by blank spaces.
-header
Suppresses the column headings in the output. If you omit this parameter, the column headings are included.
-help | -h | -?
Lists help information for the command.
-qs character
Specifies the 7-bit character that surrounds character strings and date stamps in the output. If you omit this parameter, character strings and date stamps are enclosed by double quotation marks (").
-silent
Suppresses all output for the command. If you omit this parameter, output is included.
-grouping
Enables the grouping of numeric values. For example, in English the value 12000 would display as 12,000. The grouping character is determined by the system locale.

Example: Setting a new type of back-end storage system

The following command sets a new type of back-end storage system:
setbackendtype -type L -name test3 -cachehit 90 -description test_3
The following message is displayed:
Back-end Type Status
========================
L             Succeeded.