qevent (1) - Linux Man Pages

qevent: subscribe and respond to xxQS_NAMExx events

NAME

qevent - subscribe and respond to xxQS_NAMExx events

DESCRIPTION

qevent subscribes to "events" generated by the xxQS_NAMExx system and loops after writing its pid to the file qevent.pid. It is used by the xxQS_NAMExx 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.