Shell commands for monitoring batches, Synopsis, Command options – Apple Compressor 3 User Manual
Page 366

Note: Apple Qmaster stores the XML code for the last command you entered in
~Library/Preferences/com.apple.AppleQmaster.plist. You can copy the command in XML
form there, and customize it to use for a new job submission.
Shell Commands for Monitoring Batches
You can use the Batch Monitor command,
Batch Monitor
, with a number of command-line
options for monitoring jobs.
In the command-line descriptions below, angle brackets < > indicate a mandatory
argument in a command, and brackets [ ] indicate an optional argument.
Synopsis
Below is a synopsis of the command for monitoring batches. The
Batch Monitor
command
is located in /Applications/Utilities/Batch Monitor.app/Contents/MacOS/.
Batch Monitor [-clustername <name>] [-clusterid <user name:password@IP
address:port number>] [-jobid <identifier> -batchid <identifier>] [-timeout
<seconds>] [-query <seconds>] [-help]
To cancel a job or batch
µ
Use the following command:
Batch Monitor [-clustername <name>] [-clusterid <IP address> <port number>
<user name> <password>] -kill -jobid <identifier> -batchid <identifier>
Command Options
This table provides information about each of the command options for monitoring
batches.
Description
Monitoring command option
Use to specify the name of the cluster to which the job was sent.
-clustername <name>
User password for the cluster specified by ID or name.
-password <value>
Optionally, you can use
-clusterid
to enter the cluster ID and
port number instead of using
-clustername
.
Or, if you used
-clustername
and the cluster requires a password,
use
-clusterid
to specify the user name and password. (You
need to include the
IP address:port number
as well whenever
you use
-clusterid
.)
Use
Apple Qmaster -show
or
Compressor -show
to see a
cluster’s IP address and port number.
-clusterid <user
name:password@IP
address:port number>
Use to specify the job you want to monitor.
When you use the
-jobid
option, you must also specify the
-batchid
, in the form of the name that was given to the batch
when it was submitted. (The
-batchid
and
-jobid
are displayed
after a batch is submitted.)
If you do not use the
-jobid
option, all the jobs submitted to the
specified cluster are listed.
-jobid <identifier>
-batchid <identifier>
366
Appendix C
Using the Command Line