qbsub submits a command for the Supervisor to schedule. If the --range is specified, a job with an agenda will be submitted.
See Jobs, instances, agenda items, and job slots for a description of the taxonomy of a Qube! job.
qbsub [options] command
where command is a command to be executed on the remote host.
Job requirements expression - Job Requirements
Job reservations expression - Job Reservations
Job restrictions expression - worker_restrictions
Parent job to submitted job
Process group ID
Arbitrary accounting data string
User account to use Note: needs admin or impersonation privilege
Qube! domain to use Note: needs admin or impersonation privilege
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)|
Number of processors to reserve per host
Initial job state (blocked or pending)
List of comma delimited hosts to run job on
List of comma delimited hosts to not run job on
List of comma delimited host groups to run job on
List of comma delimited host groups to not run job on
Order in which the hosts are preferred - hostorder syntax
Flags (see below for description of all available flags)
Email job owner when job is complete.
Wait until trigger string condition has been met before starting.
Execute command string on the Supervisor when the job starts running.
Execute command string on the Supervisor when the job completes.
Wait until job ID int is done before starting.
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.|
Qbsub will block until the submitted job completes.
Execute over range string QB_FRAME_NUMBER
Range pad value.
Reverse the frame range
Use binary for frame range ordering
Number of partitions to use (default: # of frames)
Number of frames to use per partition (default: 1)
Specify which frames to use as p-agenda (default: 1st, last, and middle frames)
Set priority for p-agenda (default: site-wide value, or 1)
Number of subjobs to use to process p-agenda (default: length of p-agenda list)
Export job to *.qja file.
Import job from *.qja file.
--address string, …
List of string email addresses when using --email option
--type string --prototype string
Use string job type.
Raw package data string (for use only with --type option).
Retry each subjob int times.
Retry each work agenda item int times.
Insert artificial delay of int seconds before each automatic retry of work item
|--preflights string,...||instance-level preflights (comma-separated)|
|--postflights string,...||instance-level postflights (comma-separated)|
|--agenda_preflights string,...||agenda-level preflights (comma-separated)|
|--agenda_postflights string,...||agenda-level posflights (comma-separated)|
Output in XML format
Submit "ls -l" job named "myjob1" to run on 2 cpus:
Execute "myprog /home/data/myfile.data", but convert the path at runtime to a suitable path on the worker if necessary (as dictated by the worker_path_map defined on the worker):
How to restrict a host to only one instance of a given kind of job, but still allow other jobs