NAME

       globus-scheduler-event-generator - Process job state change events

SYNOPSIS

       globus-scheduler-event-generator -h

       globus-scheduler-event-generator -s LRM_NAME [OPTIONS]

DESCRIPTION

       The globus-scheduler-event-generator (SEG) is a program which uses local resource manager-specific
       monitoring modules to generate job state change events. At the SEG level, the state change events
       correspond to changes in any jobs which are managed by the scheduler, even if they do not correspond to
       jobs initiated by the GRAM5 Service. These state change events are propagated to the Job State Monitor.

       Depending on scheduler-specific requirements, the SEG may need to run with privileges to enable it to
       obtain scheduler event notifications. As such, one SEG runs per scheduler resource. For example, on a
       host which provides access to both PBS and fork jobs, two SEGs, running at (potentially) different
       privilege levels will be running.

       When executed, the SEG is able to start issuing events from some time in the past. The SEG will, in
       general, not require any persistent state between invocations. One SEG instance exists for any particular
       scheduled resource instance (one for all homogeneous PBS queues, one for all fork jobs, etc).

       The SEG is implemented in an executable called the globus-scheduler-event-generator, located in the Grid
       Community Toolkit’s sbin directory.

       When begun, it loads the LRM-specific module based on the LRM_NAME parameter, and then defers to it for
       most functionality. When it detects an error writing to stdout or reading stdin, it terminates. The
       LRM-specific code uses the SEG API to emit events to the GRAM5 service.

OPTIONS

       -h
           Display a help message and exit.

       -s LRM_NAME
           Load the LRM-specific module for LRM_NAME. This is translated to loading the dynamic library
           libglobus_seg_’LRM_NAME'.

       -t TIMESTAMP
           Process events starting at TIMESTAMP. This is the only way to get the
           globus-scheduler-event-generator to process events that occur before the process begins. If not
           specified, it will generate events from the current timestamp only.

       -d DIRECTORY
           Write job state change events to files in DIRECTORY, named by the day that the event occurred
           (DIRECTORY/YYYYMMDD); if not specified, the events will be written to standard output.

       -b
           Run in the background. This only works if the -d option above is used.

       -p PIDFILE
           Write the process id of the globus-scheduler-event-generator to PIDFILE.

AUTHOR

       Copyright (c) 1999-2014 University of Chicago