HP 3PAR StoreServ 7200 2-node HP 3PAR CIM API Programming Reference (OS 3.1.2 - Page 63

Table 46 Return values for AttachOrModifyReplica/AttachReplica

Page 63 highlights

[In, REQ] CIM_ManagedElement ref SourceElement, [In, REQ] CIM_ManagedElement ref TargetElement, [In, REQ, Values {"Async", "Sync", "UnSyncAssoc", "UnSyncUnAssoc"}, ValueMap {"2", "3", "4", "5"}] Uint16 CopyType); Table 46 Return values for AttachOrModifyReplica()/AttachReplica() ValueMap 0 4 5 6 0x1000 Values Success Failed Invalid Parameter In Use Method parameters checked - job started Explanation/Notes For example: the source volume does not have snapspace, target volume is incompatible. For example: the wrong CopyType is specified. Target volume is already a physical copy of another volume. The method execution, if successful, always returns 0x1000, which means that job has started. A client can either monitor Job.OperationalStatus for job completion or wait for the arrival of modification of OperationalStatus for a ConcreteJob to indicate 'Complete' and 'OK' or 'Complete' and 'Error'. If the operation is of CopyType UnSyncAssoc, a resync snapshot of the physical copy is created. This snapshot has the same characteristics as a regular snapshot. STATE TRANSITIONS Table 47 (page 63) shows the values for SyncState and WhenSynced during various stages of physical copy creation. Internal vvol_t volume state flags (v_overall_state) are mapped to each SyncState. Table 47 State Transitions for Physical Copy Creation Operation Copy task queued but copy engine not yet started Copy in progress SyncState Initialized (2) ResyncInProgress (5) Initial copy in progress WhenSynced NULL NULL Copy complete Frozen (14) All blocks copied from source to an UnSyncAssoc replica and the copy engine is stopped Time of when copy is completed Copy Failed Broken (12) NULL The relationship is non-functional due to errors in the source or the target RESYNCHRONIZATION CLI EQUIVALENCE createvvcopy -r Copy Services Subprofile 63

  • 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
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309

[In, REQ] CIM_ManagedElement ref SourceElement,
[In, REQ] CIM_ManagedElement ref TargetElement,
[In, REQ,
Values {"Async", "Sync", "UnSyncAssoc", "UnSyncUnAssoc"},
ValueMap {"2", "3", "4", "5"}]
Uint16 CopyType);
Table 46 Return values for AttachOrModifyReplica()/AttachReplica()
Explanation/Notes
Values
ValueMap
Success
0
For example: the source volume does
not have snapspace, target volume is
incompatible.
Failed
4
For example: the wrong
CopyType
is
specified.
Invalid Parameter
5
Target volume is already a physical
copy of another volume.
In Use
6
Method parameters checked – job
started
0x1000
The method execution, if successful, always returns 0x1000, which means that job has started. A
client can either monitor
Job.OperationalStatus
for job completion or wait for the arrival of
modification of
OperationalStatus
for a
ConcreteJob
to indicate ‘Complete’ and ‘OK’ or
‘Complete’ and ‘Error’.
If the operation is of
CopyType UnSyncAssoc
, a resync snapshot of the physical copy is created.
This snapshot has the same characteristics as a regular snapshot.
STATE TRANSITIONS
Table 47 (page 63)
shows the values for
SyncState
and
WhenSynced
during various stages of
physical copy creation. Internal vvol_t volume state flags (v_overall_state) are mapped to each
SyncState
.
Table 47 State Transitions for Physical Copy Creation
WhenSynced
SyncState
Operation
NULL
Initialized (2)
Copy task queued but copy engine
not yet started
NULL
ResyncInProgress (5)
Copy in progress
Initial copy in progress
Time of when copy is completed
Frozen (14)
Copy complete
All blocks copied from source to an
UnSyncAssoc replica and the copy
engine is stopped
NULL
Broken (12)
Copy Failed
The relationship is non-functional due
to errors in the source or the target
RESYNCHRONIZATION
CLI EQUIVALENCE
createvvcopy
r <destvol>
Copy Services Subprofile
63