Command Line Interface 5.6

gwsubmit — job submission utility for the GridWay system

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

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

• -h print this help
• -v print to stdout the job ids returned by gwd
• -o hold job on submission
• -d “id1 id2 …” job dependencies. Submit the job on hold state, and release it once the jobs with id1, id2, … have finished
• -p priority initial priority for 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
• -t template template file describing the 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] [-nfx] [job_id]

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

• -h print this 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 state job_state (see JOB STATES)
• -o output_format define output information (see FIELD INFORMATION)
• -c delay refresh job information every delay seconds
• -n do not print the header
• -f full format
• -x xml format
• job_id only monitor this job_id

Table 1. Field options

Table 2. Job states

gwhistory — shows history of a job

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

Prints information about the execution history of a job

• -h print this help
• -n do not print the header lines
• -x xml format
• job_id job identification as provided by gwps

Table 3. Field information

gwhost — shows hosts information

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

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

• -h print this help
• -c delay refresh host information every delay seconds
• -n do not print the header
• -f full format
• -x xml format
• -m job_id prints hosts matching the requirements of a given job
• host_id only monitor this host_id, printing also queue information.

Table 4. Field information

Table 5. 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 print this help
• -a asynchronous signal, only relevant for KILL and STOP
• -k kill (default, if no signal specified)
• -t stop
• -r resume
• -o hold
• -l release
• -s re-schedule
• -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
• -A <array_id> array identification as provided by gwps

gwwait — synchronize a job

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

Waits for a job or array job

• -h help.
• -a any. Return 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
• -t timeout do not wait more than timeout seconds. A negative value means waiting for ever (default)
• job_id [job_id2 …] job identification or list of jobs ids as provided by gwps.
• -A array_id array identification as provided by gwps

gwuser — monitors users in GridWay

gwuser [-h] [-nx]

Prints information about users in the GridWay system

• -h print this help
• -n do not print the header lines
• -x xml format

Table 6. Field information

gwacct — prints accounting information

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

Prints accounting information about users or hosts in the GridWay system

• -h print this help
• -n do not print the header lines
• -x xml output
• -d n print accounting information from n days ago (ex: -d 1)
• -w n print accounting information from n weeks ago (ex: -w 1)
• -m n print accounting information from n months ago (ex: -m 1)
• -t s print accounting information from s seconds, where s is an epoch (i.e. -t 1159809792)
• -u user print accounting information for user
• -r hostname print accounting information for host

Table 7. Field information

gwdagman — dag job submission utility for the GridWay system

gwdagman [-h] [-d] <dagman file>

Submits a dag job to gwd

• -d Generate DOT file. It is written to STDOUT
• -h Print this help

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 print this help
• input_jsdl read the jsdl document from the input_jsdl
• output_gwjt store the GridWay Job Template specification in the output_gwjt.jt file