Man page - qevent(1)

Packages contains this manual

Manual

qevent

NAME
DESCRIPTION
SYNOPSIS
OPTIONS
FILES
EXAMPLE
BUGS

NAME

qevent - subscribe and respond to Grid Engine events

DESCRIPTION

qevent subscribes to "events" generated by the Grid Engine system and loops after writing its pid to the file qevent.pid . It is used by the Grid Engine test suite, and otherwise can be used to wait for a job or task to finish more efficiently than running qstat in a loop. See the example below.

SYNOPSIS

qevent [ -h | -help ] [ -ts | -testsuite ] [ -sm | -subscribe ] [ -trigger event script [ -trigger event script ],...]

OPTIONS

-h , -help

Show usage

-ts , -testsuite

Run in test suite mode.

-sm , -subscribe

Run in subscribe mode, printing events from the system.

-trigger event script

Start executable script when the specified event occurs. script gets three arguments: event name, job id, and task id. event is one of JB_END : signals a job end; JB_TASK_END : signals a job task end.

FILES

qevent.pid

Id of the qevent process.

EXAMPLE

This is an example of waiting for a job which could be used if the -sync , -hold_jid , or -hold_jid_ad options of qsub aren’t sufficient.

$ cat wait-for-job
#!/bin/sh
if [ "$2" = $JOBID ]; then
echo Job $JOBID finished
kill $(cat qevent.pid)
exit 0
fi
$ export JOBID=‘qsub -b y -terse sleep 30‘
$ qevent -trigger JB_END ./wait-for-job
Job 122837 finished
$

BUGS

Needs tidying up and extending.