Technical information

The RMS Enterprise SDK (v4)
20
RMS Enterprise - NetLinx Programmer’s Guide
It is important to note that any location-wide monitoring or control functionality should be implemented as part of the control
system asset. This include location-scoped concepts such as System Power and System Modes.
For more details on how to implement System Power or System Modes, please see Implementing System Power on page 113 and
Implementing System Modes on page 114.
RMS System Event Handler
The RMS Enterprise SDK provides an Include File to allow the NetLinx programmer to easily listen for and respond to System
generated events such as System Power changes and System Mode changes. This RmsSystemEventHandler Include File
automatically registers itself as an event listener to the RMS NetLinx virtual device (via the RmsEventListener Include File) and
subscribes to the system power and system mode event notifications. These event notifications are delivered as callback method
invocations to the following functions defined in the RmsSystemEventHandler Include File.
RmsEventSystemPowerChangeRequest (see page 21)
RmsEventSystemPowerChanged (see page 21)
RmsEventSystemModeChangeRequest (see page 22)
RmsEventSystemModeChanged (see page 22)
The diagram in FIG. 11 on page 20 illustrates the file dependency chain for the RmsSystemEventListener.axi Include File
integration:
The following code illustrates the inclusion of the RmsSystemEventHandler.axi Include File in the main NetLinx program:
//
// RMS SYSTEM POWER / SYSTEM MODE EVENT HANDLER
// system power and system mode monitoring and tracking
//
// If you do not need or wish to use the system power
// or system mode concepts, then you may comment out
// or delete this include file reference.
//
// If you do intend to implement system power states
// and/or system mode selections, then please see contents
// of this include file. You are responsible for
// implementing the logic for selecting/deselecting
// sources in your own NetLinx source code.
//
#INCLUDE 'RmsSystemEventHandler';
FIG. 11 RMS SDK File Dependencies - System Event Handler