Message-ID: <1336772937.9045.1711714872500.JavaMail.confluence@host3.pipelinefx.com> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_9044_1879750622.1711714872499" ------=_Part_9044_1879750622.1711714872499 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html qbsub

qbsub

[=20 Description ] [=20 Options ] [=20 Notes ] [=20 Examples ] [=20 See also ]

Description

qbsub submits a command for the Supervisor to schedule.=  If the --range is specified, a job with an agenda will be submitted.=

Usage 

qbsub [optionscommand

where command is a command to be executed on the remo= te host.

Options

Option

Description

--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 "*")

Maximum number of instances to use= ("*" means "no limit") for Smart-share auto-expansion = (new in 6.6)

--processors int

Number of processors to reserve per host

<= /td>

--status string

Initial job state (blocked or pending)

--hosts string,=E2=80=A6

List of comma delimited hosts to run job on

--omithosts string,=E2=80=A6

List of comma delimited hosts to not run job = on

--groups string,=E2=80=A6

List of comma delimited host groups to run jo= b on

--omitgroups string

List of comma delimited host groups to not ru= n job on

--hostorder string

Order in which the hosts are preferred - hostorder syntax

--flags string,=E2=80=A6

Flags (see below for description of all avail= able 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 Superv= isor when the job starts running.

--postexec string

Execute command string on the Superv= isor 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.

--agendatimelimit int Automatically kill an agenda item = if it runs longer than int seconds.

--waiton

Qbsub will block until the submitted job comp= letes.

--range string

Execute over range string QB_FRAME_N= UMBER

--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 fr= ames)

--chunk int

Number of frames to use per partition (defaul= t: 1)

--p_agenda string

Specify which frames to use as p-agenda (defa= ult: 1st, 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, =E2=80=A6

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 onl= y with --type option).

--retrysubjob int

Retry each subjob int times.

--retrywork int

Retry each work agenda item int time= s.

--retryworkdelay int

Insert artificial delay of int secon= ds before each automatic retry of work item

--preflights string,... instance-level preflights (comma-s= eparated)
--postflights string,...<= /td> instance-level postflights (comma-= separated)
--agenda_preflights string,...= agenda-level preflights (comma-sep= arated)
--agenda_postflights string,..= . agenda-level posflights (comma-sep= arated)

--xml

Output in XML format

--help

Command help

--version

Command version

Flag

Value

Description

auto_mount

8

Require automatic drive mounts on worker.

=

auto_wrangling

16384

Enable auto-wrangling for this job.

convert_path 131072 Automatically convert paths on wor= ker at runtime.

disable_auto_complete

8192

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

disable_cpu_limit

4096

Normally, if a job is submitted with the numb= er of instances greater than there are agenda items, Qube! automatically sh= rinks the number of instances to be equal to the number of agenda items. Se= tting this flag disables that.

disable_windows_job_object

2048

(Deprecated in Qube6.5) Disable W= indows' 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 jo= b objects, causing jobs to crash unexpectedly.

elite

512

Submit job as an elite job, which will be sta= rted immediately regardless of how busy the farm is. Elite jobs are also pr= otected from preemption. Must be admin.

export_environment

16

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

expand

32

(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

4

Wait for all instances to start before beginn= ing work (useful for implementation of parallel jobs, such as satellite ren= ders).

host_list

256

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

mail

1024

Send e-mail when job is done.

migrate_on_frame_retry

65536

When an agenda item (frame) fails but is retr= ied automatically because the retrywork option is set, setting this flag ca= uses the instances to be migrated to another worker host, preventing the fr= ame from running on the same host.

no_defaults 524288 Prevent supervisor from applying s= upervisor_job_flags

p_agenda

32768

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

uninterruptible

1

Prevent job from being preempted.

Notes

 

Examples

Submit "ls -l" job named "myjob1" to run on 2 cpus:<= /p>

qbsub --name myjob1 --cpus 2 ls -l

Submit maya render to machine that has maya installed:

qbsub -priority 1 --reservations host.maya=3D1 Render -s = 1 -e 30 myscene.ma

Submit a render job at priority 1 which matches host qb003:

qbsub -priority 1 --requirements host.name=3Dqb003 Render= -s 1 -e 30 myscene.ma

Submit a simple ls job and send testuser@example.com notification when the job is c= omplete:

qbsub --mail --address "testuser@example.com<= strong>" ls

Export to job.qja template file a simple dir command with priority set t= o 5:

qbsub --priority 5 --export job.qja dir

Import job.qja template and submit this template and override the cluste= r specification to /example:

qbsub --cluster /example --import job.qja

Submit an agenda-based, 200-frame Maya "Render" job, to be pro= cessed by 10 subjobs:

qbsub =E2=80=93range 1-200 =E2=80=93cpus 10 Render =E2=80= =93s QB_FRAME_NUMBER =E2=80=93e QB_FRAME_NUMBER /path/to/myscene.ma

Same as above, but use p-agenda to process some key frames at higher pri= ority. We'll let the system choose the p-agenda, which will be the 1st= , last, and middle frames of the entire range (i.e. 1, 200, and 99). = Note als that this submission will generate 2 jobs:

qbsub =E2=80=93range 1-200 =E2=80= =93flags "p_agenda" =E2=80=93cpus 10 Render =E2=80=93s QB_FRAME_N= UMBER =E2=80=93e QB_FRAME_NUMBER /path/to/myscene.ma

Same as above, but explicitly specify p-agenda frames. Note that we can = omit the "-flags" option in this case:

qbsub =E2=80=93range 1-200 =E2=80=93p_agenda "1-200x= 50" =E2=80=93cpus 10 Render =E2=80=93s QB_FRAME_NUMBER =E2=80=93e QB_F= RAME_NUMBER /path/to/myscene.ma

Execute "myprog /home/data/myfile.data", but convert the path = at runtime to a suitable path on the worker if necessary (as dictated by th= e worker_path_map defined on the worker): 

See also

Job Requirements

Job Reservations

How to restrict a host t= o only one instance of a given kind of job, but still allow other jobs<= /p>

Host Ordering

------=_Part_9044_1879750622.1711714872499--