qevent(1)

qevent1

Subscribe and respond to grid engine events

Usage

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

Overview

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.

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.

Examples

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
    $ 

Releases

Unchanged in 5 releases since Debian 9 (Stretch).

  1. 9–13

Bugs

Needs tidying up and extending.

From gridengine-client 8.1.9+dfsg-13.1 in Debian 13 (Trixie). Parsed by carta from the page's man source.