1. Qube
2. Qube! Documentation
3. Advanced User's Guide
4. Command Line Reference
5. qbsub

qbsub

--name string

Job name

--priority int

Priority value

--requirements string

Job requirements expression - Job Requirements

--reservations string

Job reservations expression - Job Reservations 

--restrictions string

Job restrictions expression - worker_restrictions

--pid int

Parent job to submitted job

--pgrp int

Process group ID

--cluster string

Cluster specification

--kind string

Job kind

--account string

Arbitrary accounting data string

--user string

User account to use Note: needs admin or impersonation privilege

--domain string

Qube! domain to use Note: needs admin or impersonation privilege

--cpus int

Number of subjobs to run

--max_cpus int (or "*")

--processors int

Number of processors to reserve per host

--status string

Initial job state (blocked or pending)

--hosts string,…

List of comma delimited hosts to run job on

--omithosts string,…

List of comma delimited hosts to not run job on

--groups string,…

List of comma delimited host groups to run job on

--omitgroups string

List of comma delimited host groups to not run job on

--hostorder string

Order in which the hosts are preferred - hostorder syntax

--flags string,…

Flags (see below for description of all available flags)

--mail

Email job owner when job is complete.

--dependency string

Wait until trigger string condition has been met before starting.

--preexec string

Execute command string on the Supervisor when the job starts running.

--postexec string

Execute command string on the Supervisor when the job completes.

--waitfor int

Wait until job ID int is done before starting.

--timelimit int

Automatically kill the job if it runs longer than int seconds.

--waiton

Qbsub will block until the submitted job completes.

--range string

Execute over range string QB_FRAME_NUMBER

--padding int

Range pad value.

--reverse

Reverse the frame range

--binary

Use binary for frame range ordering

--partitions int

Number of partitions to use (default: # of frames)

--chunk int

Number of frames to use per partition (default: 1)

--p_agenda string

Specify which frames to use as p-agenda (default: 1^st, last, and middle frames)

--p_priority int

Set priority for p-agenda (default: site-wide value, or 1)

--p_cpus int

Number of subjobs to use to process p-agenda (default: length of p-agenda list)

--export string

Export job to *.qja file.

--import string

Import job from *.qja file.

--address string, …

List of string email addresses when using --email option

--type string --prototype string

Use string job type.

--data string

Raw package data string (for use only with --type option).

--retrysubjob int

Retry each subjob int times.

--retrywork int

Retry each work agenda item int times.

--retryworkdelay int

Insert artificial delay of int seconds before each automatic retry of work item

--xml

Output in XML format

--help

Command help

--version

Command version

auto_mount

Require automatic drive mounts on worker.

auto_wrangling

Enable auto-wrangling for this job.

disable_auto_complete

Normally instances are automatically completed by the system when a job runs out of available agenda items. Setting this flag disables that.

disable_cpu_limit

Normally, if a job is submitted with the number of instances greater than there are agenda items, Qube! automatically shrinks the number of instances to be equal to the number of agenda items. Setting this flag disables that.

disable_windows_job_object

(Deprecated in Qube6.5) Disable Windows' process management mechanism (called the "Job Object") that Qube! normally uses to manage job processes. Some applications already use it internally, and job objects don't nest well within other job objects, causing jobs to crash unexpectedly.

elite

Submit job as an elite job, which will be started immediately regardless of how busy the farm is. Elite jobs are also protected from preemption. Must be admin.

export_environment

Use environment variables set in the submission environment, when running the job on the workers.

expand

(Deprecated in Qube6.5) Automatically expand job to use as many instances as there are agenda items (limited by the total job slots in the farm).

grid

Wait for all instances to start before beginning work (useful for implementation of parallel jobs, such as satellite renders).

host_list

Run job on all candidate hosts, as filtered by other options (such as "hosts" or "groups").

mail

Send e-mail when job is done.

migrate_on_frame_retry

When an agenda item (frame) fails but is retried automatically because the retrywork option is set, setting this flag causes the instances to be migrated to another worker host, preventing the frame from running on the same host.

p_agenda

Enable p-agenda for this job, so that some frames are processed at a higher priority.

uninterruptible

Prevent job from being preempted.