Table of Contents

Command Line Interface 5.5

gwsubmit

Name

gwsubmit — job submission utility for the GridWay system

Synopsis

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

Description

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

Command options

gwdag

Name

gwdag — dag job submission utility for the GridWay system

Synopsis

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

Description

Submit a dag job to gwd

Command options

gwps

Name

gwps — report a snapshot of the current jobs

Synopsis

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

Description

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

Command options

Output field description

Table 5. Field options

FIELD NAME FIELD OPTION DESCRIPTION
USER u owner of this job
JID J job unique identification assigned by the Gridway system
AID i array unique identification, only relevant for array jobs
TID i task identification, ranges from 0 to TOTAL_TASKS -1, only relevant for array jobs
FP p fixed priority of the job
TYPE y type of job (simple, multiple or mpi)
NP n number of processors
DM s dispatch Manager state, one of: pend, hold, prol, prew, wrap, epil, canl, stop, migr, done, fail
EM e execution Manager state (Globus state): pend, susp, actv, fail, done
RWS f flags: R times this job has been restarted, W number of processes waiting for this job, S re-schedule flag
START t/T the time the job entered the system
END t/T the time the job reached a final state (fail or done)
EXEC t/T total execution time, includes suspension time in the remote queue system
XFER t/T total file transfer time, includes stage-in and stage-out phases
EXIT x job exit code
TEMPLATE j filename of the job template used for this job
HOST h hostname where the job is being executed



gwhistory

Name

gwhistory — shows history of a job

Synopsis

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

Description

Prints information about the execution history of a job

Command options

Output field description

Table 6. Field information

NAME DESCRIPTION
HID host unique identification assigned by the Gridway system.
START the time the job start its execution on this host.
END the time the job left this host, because it finished or it was migrated.
PROLOG total prolog (file stage-in phase) time.
WRAPPER total wrapper (execution phase) time.
EPILOG total epilog (file stage-out phase) time.
MIGR total migration time.
REASON the reason why the job left this host.
QUEUE name of the queue.
HOST FQDN of the host.

gwhost

Name

gwhost — shows hosts information

Synopsis

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

Description

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

Command options

Output field description

Table 7. Field information

FIELD DESCRIPTION
HID host unique identification assigned by the Gridway system
PRIO priority assigned to the host
OS operating system
ARCH architecture
MHZ CPU speed in MHZ
%CPU free CPU ratio
MEM(F/T) system memory: F = Free, T = Total
DISK(F/T) secondary storage: F = Free, T = Total
N(U/F/T) number of slots: U = used by GridWay, F = free, T = total
LRMS local resource management system, the jobmanager name
HOSTNAME FQDN of this host


Table 8. Queue field information

FIELD DESCRIPTION
QUEUENAME name of this queue
SL(F/T) slots: F = Free, T = Total
WALLT queue wall time
CPUT queue cpu time
COUNT queue count number
MAXR max. running jobs
MAXQ max. queued jobs
STATUS queue status
DISPATCH queue dispatch type
PRIORITY queue priority



gwkill

Name

gwkill — controls job execution

Synopsis

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

Description

Sends a signal to a job or array job

Command options

gwwait

Name

gwwait — synchronize a job

Synopsis

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

Description

Waits for a job or array job

Command options

gwuser

Name

gwuser — monitors users in GridWay

Synopsis

gwuser [-h] [-nx]

Description

Prints information about users in the GridWay system

Command options

Output field description

Table 9. Field information

FIELD DESCRIPTION
UID user unique identification assigned by the Gridway system
NAME name of this user
JOBS number of Jobs in the GridWay system
RUN number of running jobs
IDLE idle time, (time with JOBS = 0)
EM execution manager drivers loaded for this user
TM transfer manager drivers loaded for this user
PID process identification of driver processes



gwacct

Name

gwacct — prints accounting information

Synopsis

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

Description

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

Command options

Output field description

Table 10. Field information

FIELD DESCRIPTION
HOST/USER host/user usage summary for this user/host
XFR total transfer time on this host (for this user)
EXE total execution time on this host (for this user), without suspension time
SUSP total suspension (queue) time on this host (for this user)
TOTS total executions on this host (for this user).
Termination reasons:
SUCC success
ERR error
KILL kill
USER user requested
SUSP suspension timeout
DISC discovery timeout
SELF self migration
PERF performance degradation
S-R stop-resume

jsdl2gw

Name

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

Synopsis

jsdl2gw [-h] input_jsdl [output_gwjt]

Description

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

Command options