beautypg.com

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

Page 366

background image

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 ] [-clusterid

address:port number>] [-jobid -batchid ] [-timeout

] [-query ] [-help]

To cancel a job or batch

µ

Use the following command:

Batch Monitor [-clustername ] [-clusterid

] -kill -jobid -batchid

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

User password for the cluster specified by ID or name.

-password

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

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

-batchid

366

Appendix C

Using the Command Line