HP StorageWorks MSA 2/8 HP StorageWorks Fabric OS 3.X Document Addendum (AA-RW - Page 236

zoneobjectrename, Syntax, Availability, Description, Operands, Example

Page 236 highlights

Fabric OS reference guide zoneobjectrename Renames a zone object. Syntax zoneobjectrename "objectName", "newName" Availability Admin Description Use this command to rename a zone object. You can use this command for all zone object types, including CFG, zone, and alias. A zone configuration name must begin with a letter and can be followed by any number of letters, numerals, and underscores. Names are case sensitive; for example, Cfg_1 and cfg_1 are different zone configurations. Spaces are ignored. This command changes the defined configuration. For the change to be preserved across switch reboots, it must be saved to nonvolatile memory, using the cfgsave command. For the change to become effective, an appropriate zone configuration must be enabled, using the cfgenable command. See the zonecreate command for more information on name and member specifications. Note: This command requires an Advanced Zoning license. When security is enabled, this command can be issued only from the primary FCS switch. Operands Example This command has the following required operands: objectName The name of the object that you want to rename. newName The new name of the object. To create a configuration containing three zones: switch:admin> cfgShow "*" cfg: USA_cfg Red_zone; White_zone; Blue_zone switch:admin> zoneObjectRename "USA_cfg", "UK_cfg" switch:admin> cfgShow "*" cfg: UK_cfg Red_zone; White_zone; Blue_zone 236 Fabric OS 3.x Document Addendum

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250

Fabric OS reference guide
236
Fabric OS 3.x Document Addendum
Renames a zone object.
Syntax
zoneobjectrename "
objectName
", "
newName
"
Availability
Admin
Description
Use this command to rename a zone object. You can use this command for all zone object
types, including CFG, zone, and alias.
A zone configuration name must begin with a letter and can be followed by any number of
letters, numerals, and underscores. Names are case sensitive; for example,
Cfg_1
and
cfg_1
are different zone configurations. Spaces are ignored.
This command changes the defined configuration. For the change to be preserved across
switch reboots, it must be saved to nonvolatile memory, using the
cfgsave
command. For
the change to become effective, an appropriate zone configuration must be enabled, using the
cfgenable
command.
See the
zonecreate
command for more information on name and member specifications.
Note:
This command requires an Advanced Zoning license. When security is enabled, this
command can be issued only from the primary FCS switch.
Operands
This command has the following required operands:
Example
To create a configuration containing three zones:
zoneobjectrename
objectName
The name of the object that you want to rename.
newName
The new name of the object.
switch:admin>
cfgShow "*"
cfg:
USA_cfg
Red_zone; White_zone; Blue_zone
switch:admin>
zoneObjectRename "USA_cfg", "UK_cfg"
switch:admin>
cfgShow "*"
cfg:
UK_cfg
Red_zone; White_zone; Blue_zone