3

Table Of Contents
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.
DescriptionMonitoring 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