LSF Version 7.3 - Administering Platform LSF

Events list
656 Administering Platform LSF
Enable event generation for custom programs
If you use a custom program to handle the LSF events, take the following steps to
enable event generation.
1 Write a custom program to interpret the arguments passed by LSF. See
Arguments passed to the LSF event program on page 656 and Events list on
page 656 for more information.
2 To enable event generation, define LSF_EVENT_RECEIVER in
lsf.conf. You
must specify an event receiver even if your program ignores it.
The event receiver maintains cluster-specific or changeable information that
you do not want to hard-code into the event program. For example, the event
receiver could be the path to a current log file, the email address of the cluster
administrator, or the host to send SNMP traps to.
3 Set LSF_EVENT_PROGRAM in
lsf.conf and specify the name of your
custom event program. If you name your event program
genevent
(
genevent.exe on Windows) and place it in LSF_SERVERDIR, you can skip
this step.
4 Reconfigure the cluster with the commands
lsadmin reconfig and
badmin reconfig.
Events list
The following daemon operations cause mbatchd or the master LIM to call the
event program to generate an event. Each LSF event is identified by a predefined
number, which is passed as an argument to the event program. Events 1-9 also
return the name of the host on which on an event occurred.
1 LIM goes down (detected by the master LIM). This event may also occur if LIM
temporarily stops communicating to the master LIM.
2 RES goes down (detected by the master LIM).
3
sbatchd goes down (detected by mbatchd).
4 An LSF server or client host becomes unlicensed (detected by the master LIM).
5 A host becomes the new master host (detected by the master LIM).
6 The master host stops being the master (detected by the master LIM).
7
mbatchd comes up and is ready to schedule jobs (detected by mbatchd).
8
mbatchd goes down (detected by mbatchd).
9
mbatchd receives a reconfiguration request and is being reconfigured (detected
by
mbatchd).
10 LSB_SHAREDIR becomes full (detected by
mbatchd).
Arguments passed to the LSF event program
If LSF_EVENT_RECEIVER is defined, a function called ls_postevent() allows
specific daemon operations to generate LSF events. This function then calls the LSF
event program and passes the following arguments: