HP XP P9500 HP StorageWorks P9000 for Business Continuity Manager Software Ref - Page 243

Table 130 YKRESYNC Command Return Code List, REVERSE, FORWARD, YKQUERY, YKEWAIT, YKRESYNC, VOLUNIT

Page 243 highlights

NOTE: • If operations with a REVERSE specification such as planned outage take place, to control CA, CAA, or CAJ from the script, HP recommends that you specify explicitly the FORWARD or REVERSE parameter. • When specifying the FORWARD or REVERSE parameter to change the copy direction of the copy group, be sure to execute the YKQUERY command or YKEWAIT command and obtain information for the changed copy direction before performing operation. • When a copy is performed from low-capacity CA, CAA, or CAJ volumes to high-capacity volumes, if a failure occurs on the secondary site, a CA, CAA, or CAJ copy cannot be performed in the reverse direction (from the secondary site to the primary site). HP recommends strongly that copying from a small volume to a large volume function should be used exclusively for data migration. • After this command is executed against a volume is SWAPPING status, the direction of copy is reversed. • The YKRESYNC command terminates successfully when the instruction to the copy pair succeeded. Even if the YKRESYNC command terminates with return code 0, the copy pair might not be in the DUPLEX status. After you execute the YKRESYNC command, use the YKQUERY or YKEWAIT command to make sure that the copy pair status has changed to DUPLEX. If there is a volume whose status has not been changed, re-execute the YKRESYNC command with the VOLUNIT parameter specified for all the copy pairs. • If ONLINE(YES) parameter is specified, volume corruption might occur because a copy pair can be made even if the S-VOL is being used. Thus, consideration with respect to volume operation is required, such as limiting operation to the time periods when the S-VOL is not being used. • To use the YKRESYNC command to reflect the change in the ERRORLEVEL attribute on the device, specify the VOLUNIT parameter (or specify the DEVN parameter on a copy pair basis). If the parameter is not specified, the attribute change is not reflected. • Even if the status transition is successful, an I/O error might occur and the command might terminate with return code 32. When you create a script, code it in such a manner that the YKQUERY or YKEWAIT command is executed to check the results of status transitions, even if the command terminates with return code 32, and the processing resumes after a successful status transition. Return Codes Table 130 (page 243) lists the return codes to be returned when the YKRESYNC command terminates. Table 130 YKRESYNC Command Return Code List Return Code -4095 to -4040 -3 Meaning The command terminated abnormally, possibly because the user SVC routine has not been included properly. The module cannot be loaded. Possible causes are as follows: • The library dataset has not been linked. • The module is protected by the RACF program control function. -1 An interruption occurred during execution. 0 The command completed normally. 4 Since a volume with an invalid status was found in the copy group, processing for the volume will be skipped. Command details 243

  • 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
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399

NOTE:
If operations with a
REVERSE
specification such as planned outage take place, to control CA,
CAA, or CAJ from the script, HP recommends that you specify explicitly the
FORWARD
or
REVERSE
parameter.
When specifying the
FORWARD
or
REVERSE
parameter to change the copy direction of the
copy group, be sure to execute the
YKQUERY
command or
YKEWAIT
command and obtain
information for the changed copy direction before performing operation.
When a copy is performed from low-capacity CA, CAA, or CAJ volumes to high-capacity
volumes, if a failure occurs on the secondary site, a CA, CAA, or CAJ copy cannot be
performed in the reverse direction (from the secondary site to the primary site). HP recommends
strongly that copying from a small volume to a large volume function should be used exclusively
for data migration.
After this command is executed against a volume is SWAPPING status, the direction of copy
is reversed.
The
YKRESYNC
command terminates successfully when the instruction to the copy pair
succeeded. Even if the
YKRESYNC
command terminates with return code
0
, the copy pair
might not be in the DUPLEX status. After you execute the
YKRESYNC
command, use the
YKQUERY
or
YKEWAIT
command to make sure that the copy pair status has changed to
DUPLEX. If there is a volume whose status has not been changed, re-execute the
YKRESYNC
command with the
VOLUNIT
parameter specified for all the copy pairs.
If
ONLINE(YES)
parameter is specified, volume corruption might occur because a copy pair
can be made even if the S-VOL is being used. Thus, consideration with respect to volume
operation is required, such as limiting operation to the time periods when the S-VOL is not
being used.
To use the
YKRESYNC
command to reflect the change in the
ERRORLEVEL
attribute on the
device, specify the
VOLUNIT
parameter (or specify the
DEVN
parameter on a copy pair basis).
If the parameter is not specified, the attribute change is not reflected.
Even if the status transition is successful, an I/O error might occur and the command might
terminate with return code
32
. When you create a script, code it in such a manner that the
YKQUERY
or
YKEWAIT
command is executed to check the results of status transitions, even if
the command terminates with return code
32
, and the processing resumes after a successful
status transition.
Return Codes
Table 130 (page 243)
lists the return codes to be returned when the
YKRESYNC
command terminates.
Table 130 YKRESYNC Command Return Code List
Meaning
Return Code
The command terminated abnormally, possibly because the user SVC routine has
not been included properly.
-4095
to
-4040
The module cannot be loaded. Possible causes are as follows:
The library dataset has not been linked.
The module is protected by the RACF program control function.
-3
An interruption occurred during execution.
-1
The command completed normally.
0
Since a volume with an invalid status was found in the copy group, processing for
the volume will be skipped.
4
Command details
243