HP 418800-B21 HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 35

Validation

Page 35 highlights

Line Task ... 9 Launch ( %source_host%, %suspend_command_line%, "", WAIT, "0" ) onerror pauseat E1: transaction start > 10 DO { transaction end > 11 $Rep1 = SnapshotStorageVolume ( %array_name_source_storvol_unc1%, FULLY_ALLOCATED, SAME, %dest_storvol1%, NOWAIT ) onerror pauseat E1: 12 // 13 } ALWAYS { 14 // Resume the host application. 15 Launch ( %source_host%, %resume_command_line%, "", WAIT, "0" ) 16 } ... In this example, if the snapshot command in the Do portion of the transaction fails, for whatever reason, the launch command in the Always portion is executed to resume host I/O to the storage volume. This transaction helps ensure that host I/O is not suspended indefinitely. Validation Validation refers to the use of resource validation commands in a job and subsequently performing a validation of the job. Job validation, especially at run time, helps ensure that a job instance runs successfully. The values that you enter for arguments within job commands are checked in the job editor only for compliance with basic syntax rules. See job command arguments. Resource validation commands There are several types of resource validation commands. Each type validates a different type of resource or the status of the resource. For example, ValidateStorageVolume checks for the availability of a specific virtual disk on a specific storage system, while ValidateSnapcloneStorageVolume checks whether the storage volume is available and if it can be copied using snapclone replication. IMPORTANT: HP recommends placing resource validation commands together, in the first lines of a job. They can be preceded by comments, but not by other types of commands. Resource validation processing Jobs can be run and validated for resources from the GUI or the CLUI. When done from the GUI, a new job instance is displayed in the Monitor Job window. Validation processing generally occurs as follows. • Normal. If the line is a validation command, it is executed. If successful, the next line is executed. If not successful, the job is stopped with a failure status. • Validate-only. If the line is a comment, SetVariable command or validation command, it is executed. If successful, the next line is checked. If not successful, the job is stopped with a failure status. When the first command is encountered that is not a SetVariable or validation command, the job is stopped with a success status. HP StorageWorks Replication Solutions Manager 4.0.1 35

  • 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

Line
Task
...
9
Launch ( %source_host%, %suspend_command_line%, "", WAIT, "0" )
onerror pauseat E1:
transaction start >
10
DO {
transaction end
>
11
$Rep1
= SnapshotStorageVolume ( %array_name_source_storvol_unc1%,
FULLY_ALLOCATED, SAME, %dest_storvol1%, NOWAIT ) onerror pauseat E1:
12
//
13
} ALWAYS {
14
// Resume the host application.
15
Launch ( %source_host%, %resume_command_line%, "", WAIT, "0" )
16
}
...
In this example, if the snapshot command in the
Do
portion of the transaction fails, for whatever reason,
the
launch
command in the Always portion is executed to resume host I/O to the storage volume. This
transaction helps ensure that host I/O is not suspended inde
nitely.
Validation
Validation refers to the use of resource validation commands in a job and subsequently performing
a validation of the job. Job validation, especially at run time, helps ensure that a job instance runs
successfully.
The values that you enter for arguments within job commands are checked in the job editor only for
compliance with basic syntax rules. See job command
arguments
.
Resource validation commands
There are several types of resource validation commands. Each type validates a different type of resource
or the status of the resource.
For example,
ValidateStorageVolume
checks for the availability of a speci
c virtual disk on a speci
c
storage system, while ValidateSnapcloneStorageVolume checks whether the storage volume is available
and if it can be copied using snapclone replication.
IMPORTANT:
HP recommends placing resource validation commands together, in the
rst lines of a job. They can be
preceded by comments, but not by other types of commands.
Resource validation processing
Jobs can be run and validated for resources from the GUI or the CLUI. When done from the GUI, a new
job instance is displayed in the Monitor Job window. Validation processing generally occurs as follows.
Normal
. If the line is a validation command, it is executed. If successful, the next line is executed.
If not successful, the job is stopped with a failure status.
Validate-only
. If the line is a comment, SetVariable command or validation command, it is
executed. If successful, the next line is checked. If not successful, the job is stopped with a failure
status. When the
rst command is encountered that is not a SetVariable or validation command,
the job is stopped with a success status.
HP StorageWorks Replication Solutions Manager 4.0.1
35