HP StorageWorks Storage Mirroring scripting guide (T2558-96074, February 2008)

13 - 29
Queue Task
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.
 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