HP StorageWorks Storage Mirroring for Linux Scripting Guide (T2558-96319, June 2009)

7 - 5
6. The target processes the Storage Mirroring task command and completes whatever task is
defined, perhaps a snapshot or backup. Since the Storage Mirroring task command is
user-defined, you can insert any valid executable or batch file.
Storage Mirroring task command processing must be enabled, and there must be an active Storage
Mirroring connection for task command processing to function properly. To insert a task command,
you would use the
queuetask command. Also, see Creating a backup or snapshot of the target
by inserting a task command during replication on page 15-4 for a sample script which can be
used as a basis for creating a script for your own environment.
Command QUEUETASK
Description Queues tasks inline with replication data.
Syntax
QUEUETASK <job_name> TO <target> ONQUEUE = <task> [args]
| ONTRANSMIT = <task> [args] | ONRECEIVE = <task> [args] |
ONEXECUTE = <
task> [args] [TIMEOUT = <timeout>]
[INTERACT | NOINTERACT]
Options
 job_name—Unique job name assigned to this task. This will be the
identifier you see in the log files.
 target—Name of the target, an IP address on the target, or a virtual IP
address. Depending on the network route Storage Mirroring uses to
access the target, you may need to specify the fully qualified domain
name. The target is required even if you are only queuing a task to be
executed on the source.
 ONQUEUE—Execute the specified task on the source machine as soon as
the source receives and queues the task. During heavy replication, there
may be a delay while the task is queued inline with the replication
operations.
 ONTRANSMIT—Execute the specified task on the source machine just
before the source transmits the task to the target.
 ONRECEIVE—Execute the specified task on the target machine as soon
as the target receives and queues the task.
 ONEXECUTE—Execute the specified task on the target when the target
processes the task from the queue. Since the task is not executed until it
is processed, if the target is paused, the task will be held in queue.
 task—The path and filename of the task to run relative to the machine it
will be run on. Tasks include any valid executable or batch file. The
executables or files must exist in the specified location on the machine
where they will be executed
 args—Arguments or options which need to be supplied with the task.
Multiple arguments can be supplied in a space-separated list enclosed in
quotation marks.
Options
 TIMEOUT timeout—Valid number followed by an optional time indicator
indicating the length of time ot pause while waiting for the task to
complete. The valid time indicators include seconds, minutes, hours, and
days. If you do not specify a time indicator, it will default to seconds. The
number zero (0) indicates there is no timeout delay and the next
operation is immediately processed. The keyword FOREVER indicates that
the next operation is not processed until the task has completed
execution. If you do not specify this option, the timeout will default to
forever.
 INTERACT—Tasks interact with the desktop and, therefore, display on
screen and run in the foreground
 NOINTERACT—Tasks do not interact with the desktop
Examples
qtask backup to beta onrec=PauseAndBackup.bat
onexec=resume.bat