Command Line Interface 5.4

gwsubmit — job submission utility for the GridWay system

gwsubmit -t template [-n tasks] [-h] [-v] [-o] [-s start] [-i increment] [-d "id1 id2 ..."]

Submit a job or an array job (if the number of tasks is defined) to gwd

• -h Prints help.
• -t <template> The template file describing the job.
• -n <tasks> Submit an array job with the given number of tasks. All the jobs in the array will use the same template.
• -s <start> Start value for custom param in array jobs. Default 0.
• -i <increment> Increment value for custom param in array jobs. Each task has associated the value PARAM=start+increment*TASK_ID, and MAX_PARM=start+increment*(tasks-1). Default 1.
• -d <id1 id2…> Job dependencies. Submit the job on hold state, and release it once jobs with id1,id2,.. have successfully finished.
• -v Print to stdout the job ids returned by gwd.
• -o Hold job on submission.
• -p <priority> Initial priority for the job.

gwdag — dag job submission utility for the GridWay system

gwdag [-h] [-d] <DAG description file>

Submit a dag job to gwd

• -h Prints help.
• -d Writes to STDOUT a DOT description for the specified DAG job.

gwps — report a snapshot of the current jobs

gwps [-h] [-u user] [-r host] [-A AID] [-s job_state] [-o output_format] [-c delay] [-n] [job_id]

Prints information about all the jobs in the GridWay system (default)

• -h Prints help.
• -u user Monitor only jobs owned by user.
• -r host Monitor only jobs executed in host.
• -A AID Monitor only jobs part of the array AID.
• -s job_state Monitor only jobs in states matching that of job_state.
• -o output_format Formats output information, allowing the selection of which fields to display.
• -c <delay> This will cause gwps to print job information every <delay> seconds continuously (similar to top command).
• -n Do not print the header.
• job_id Only monitor this job_id.

Table 5. Field options

gwhistory — shows history of a job

gwhistory [-h] [-n] <job_id>

Prints information about the execution history of a job

• -h Prints help.
• -n Do not print the header lines
• job_id Job identification as provided by gwps.

Table 6. Field information

gwhost — shows hosts information

gwhost [-h] [-c delay] [-nf] [-m job_id] [host_id]

Prints information about all the hosts in the GridWay system (default)

• -h Prints help.
• -c <delay> This will cause gwhost to print job information every <delay> seconds continuously (similar to top command)
• -n Do not print the header.
• -f Full format.
• -m <job_id> Prints hosts matching the requirements of a given job.
• host_id Only monitor this host_id, also prints queue information.

Table 7. Field information

Table 8. Queue field information

gwkill — controls job execution

gwkill [-h] [-a] [-k | -t | -o | -s | -r | -l | -9] <job_id [job_id2 ...] | -A array_id>

Sends a signal to a job or array job

• -h Prints help.
• -a Asynchronous signal, only relevant for KILL and STOP.
• -k Kill (default, if no signal specified).
• -t Stop job.
• -r Resume job.
• -o Hold job.
• -l Release job.
• -s Re-schedule job.
• -9 Hard kill, removes the job from the system without synchronizing remote job execution or cleaning remote host.
• job_id [job_id2 …] Job identification as provided by gwps. You can specify a blank space separated list of job ids.
• -A <array_id> Array identification as provided by gwps.

gwwait — synchronize a job

gwwait [-h] [-a] [-v] [-k] <job_id ...| -A array_id>

Waits for a job or array job

• -h help.
• -a Any, returns when the first job of the list or array finishes.
• -v Prints job exit code.
• -k Keep jobs, they remain in fail or done states in the GridWay system. By default, jobs are killed and their resources freed.
• -A <array_id> Array identification as provided by gwps.
• job_id Job ids list (blank space separated).

gwuser — monitors users in GridWay

gwuser [-h] [-n]

Prints information about users in the GridWay system

• -h Prints help.
• -n Do not print the header.

Table 9. Field information

gwacct — prints accounting information

gwacct [-h] [-n] [<-d n | -w n | -m n | -t s>] <-u user|-r host>

Prints usage statistics per user or resource. Note: accounting statistics are updated once a job is killed.

• -h Prints help.
• -n Do not print the header.
• < -d n | -w n | -m n | -t s> Take into account jobs submitted after certain date, specified in number of days (-d), weeks (-w), months (-m) or an epoch (-t).
• -u user Print usage statistics for user.
• -r hostname Print usage statistics for host.

Table 10. Field information

jsdl2gw — parser to translate JSDL file into GridWay Job Template file

jsdl2gw [-h] input_jsdl [output_gwjt]

Converts a jsdl document into a gridway job template. If no output file is defined, it defaults to the standard output. This enables the use of pipes with gwsubmit in the following fashion:

jsdl2gw jsdl-job.xml | gwsubmit

• -h Prints help.
• input_jsdl Reads the jsdl document from the input_jsdl
• output_gwjt Stores the GridWay Job Template specification in the output_gwjt.jt file