HP XC System 4.x Software User commands, bsub command, Viewing information about your cluster, Monitoring jobs and tasks, Submitting and controlling jobs, Syntax, Options

User commands

Viewing information about your cluster

Command	Description
bhosts	Displays hosts and their static and dynamic resources
bmgroup	Displays information about host groups
blimits	Displays information about resource allocation limits of running jobs
bparams	Displays information about tunable batch system parameters
bqueues	Displays information about batch queues
busers	Displays information about users and user groups
lshosts	Displays hosts and their static resource information
lsid	Displays the current LSF version number, cluster name and the master
	host name
lsinfo	Displays load sharing configuration information
lsload	Displays dynamic load indices for hosts

Monitoring jobs and tasks

Command	Description
bapp	Displays information about jobs attached to application profiles
bhist	Displays historical information about jobs
bjgroup	Displays information about job groups
bjobs	Displays information about jobs
bpeek	Displays stdout and stderr of unfinished jobs
bsla	Displays information about service class configuration for goal-oriented
	service-level agreement (SLA) scheduling
bstatus	Reads or sets external job status messages and data files

Submitting and controlling jobs

Command	Description
bbot	Moves a pending job relative to the last job in the queue
bchkpnt	Checkpoints a checkpointable job
bgadd	Creates job groups
bgdel	Deletes job groups
bkill	Sends a signal to a job
bmig	Migrates a checkpointable or rerunnable job
bmod	Modifies job submission options
brequeue	Kills and requeues a job
brestart	Restarts a checkpointed job
bresume	Resumes a suspended job
bstop	Suspends a job
bsub	Submits a job
bswitch	Moves unfinished jobs from one queue to another
btop	Moves a pending job relative to the first job in the queue

bsub command

Syntax

bsub [options] command [arguments]

Options

Option	Description
-B	Sends email when the job is dispatched
-H	Holds the job in the PSUSP state at submission
-I -Ip -Is	Submits a batch interactive job. -Ip creates a pseudo-
	terminal. -Is creates a pseudo-terminal in shell mode.
-K	Submits a job and waits for the job to finish
-N	Emails the job report when the job finishes
-r	Makes a job rerunnable
-x	Exclusive execution
-aesub_parameters	String format parameter containing the name of an
	application-specific esub program to be passed to the
	master esub
-appapplication_profile_name	Submits the job to the specified application profile
-bbegin_time	Dispatches the job on or after the specified date and
	time in the form [[month:]day:]:minute
-Ccore_limit	Sets a per-process (soft) core file size limit (KB) for all
	the processes that belong to this job
-ccpu_time[/host_name /	Limits the total CPU time the job can use. CPU time is
host_model]	in the form [hour:]minute
-Ddata_limit	Sets per-process (soft) data segment size limit (KB)
	for each process that belong to the job
-E "pre_exec_command	Runs the specified pre-exec command on the
[arguments ...]"	execution host before running the job
-eerror_file	Appends the standard error output to a file
-eoerror_file	Overwrites the standard error output of the job to the
	specified file
-ext[sched]	Application-specific external scheduling options for
"external_scheduler_options"	the job (-extsched can be abbreviated to -ext)
-Ffile_limit	Sets per-process (soft) file size limit (KB) for each
	process that belong to the job
-f "local_file op [remote_file]" ...	Copies a file between the local (submission) host and
	remote (execution) host. op is one of >, <, <<, ><, <>
-Guser_group	Associates job with a specified user group
-gjob_group_name	Associates job with a specified job group
-iinput_file -isinput_file	Gets the standard input for the job from specified file
-J "job_name[index_list]	Assigns the specified name to the job. Job arrary
%job_slot_limit"	Index_list has the form start[-end[:step]], and
	%job_slot_limit is the maximum number of jobs that
	can run at any given time.
-jsdl file_name -jsdl_strict	Submits a job using a JSDL file to specify job
file_name	submission options
-k "chkpnt_dir [chkpnt_period]	Makes a job checkpointable and specifies the
[method=method_name]"	checkpoint directory, period in minutes, and method
-Llogin_shell	Initializes the execution environment using the
	specified login shell

Option	Description
-Lpls_project_name	Assigns the job to the specified License Scheduler
	project
-Mmem_limit	Sets the memory limit (KB)
-m "host_name	Runs job on one of the specified hosts. Plus (+) after
[@cluster_name][[!]	the names of hosts or host groups indicates a
+[pref_level]] host_group[[!]	preference. Optionally, a positive integer indicates a
+[pref_level]] ..."	preference level. Higher numbers indicate greater
	preferences for those hosts.
-nmin_proc[,max_proc]	Specifies the minimum and maximum numbers of
	processors required for a parallel job
-ooutput_file	Appends the standard output to a file
-oooutput_file	Overwrites the standard output of the job to the
	specified file if it exists, or sends the output to a new
	file if it does not exist
-Pproject_name	Assigns job to specified project
-pprocess_limit	Sets the limit of the number of processes for the whole
	job
-q "queue_name ..."	Submits job to specified queues
-R "res_req" [-R "res_req" …]	Specifies host resource requirements
-Sstack_limit	Sets a per-process (soft) stack segment size limit (KB)
	for each of the processes that belong to the job
-ssignal	Send signal when a queue-level run window closes
-slaservice_class_name	Specifies the service class where the job is to run
-sppriority	Specifies user-assigned job priority to allow users to
	order their jobs in a queue
-Tthread_limit	Sets the limit of the number of concurrent threads for
	the whole job
-tterm_time	Specifies the job termination deadline in the form
	[[month:]day:]hour:minute
-Ureservation_ID	Use advance reservation created with brsvadd
-umail_user	Sends mail to the specified email address
-vswap_limit	Set the total process virtual memory limit (KB) for the
	whole job
-Wrun_time[/host_name /	Sets the run time limit of the job in the form
host_model]	[hour:]minute
-w 'dependency_expression'	Places a job when the dependency expression
	evaluates to TRUE
-wa '[signal command	Specifies the job action to be taken before a job
CHKPNT]'	control action occurs
-wt '[hour:]minute'	Specifies the amount of time before a job control
	action occurs that a job warning action is to be taken
-Zs	Spools a command file for the job to the directory
	specified by the JOB_SPOOL_DIR in lsb.params
-h	Prints command usage to stderr and exits
-V	Prints LSF release version to stderr and exits

	www.platform.com
© 2000-2008 Platform Computing Inc.	doc@platform.com
Release date: May 2008	Last modified: May 2 2008
All products or services mentioned in this document are identified by the trademarks or
service marks of their respective owners.