org.lsst.ccs.subsystem.doorman.main

Class DoormanMain

java.lang.Object

org.lsst.ccs.Agent

org.lsst.ccs.Subsystem

org.lsst.ccs.subsystem.doorman.main.DoormanMain

All Implemented Interfaces:

org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.framework.SignalHandler, org.lsst.ccs.messaging.CommandExecutor, org.lsst.ccs.ServiceLifecycle

public final class DoormanMain
extends org.lsst.ccs.Subsystem
implements org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.framework.SignalHandler

The main module for the Doorman subsystem. This module is responsible for:

• Establishing initial contact with the configured instruments.
• Providing and managing the periodic readout task.
• Alert management.
• Instrument management and status reporting.

* @author tether

Nested Class Summary

Nested classes/interfaces inherited from class org.lsst.ccs.Agent

org.lsst.ccs.Agent.RunningCommand

Field Summary

Fields inherited from class org.lsst.ccs.Agent

AGENT_HEARTBEAT_TASK, AGENT_RUNTIMEINFO_TASK, commandExecutorLock, currentAction, currentQueries, currentSignals, jvmShutdown, logBusHandler, stateService, treeComponentInitialized

Constructor Summary

Constructors

Constructor and Description
DoormanMain() Constructor.

Method Summary

Modifier and Type	Method and Description
String	disable(int index) Prevents an instrument from being read until further notice.
String	enable(int index) Enables periodic readout for an instrument.
void	init() Checks whether all the subsystem components have been constructed and registers the ClearAlertHandler.
String	instruments() Gives the status of each of the instruments.
void	postStart() Does nothing.
void	shutdown() Cancels the readout task if that hasn't already been done.
org.lsst.ccs.framework.TreeWalkerDiag	signal(org.lsst.ccs.framework.Signal sig) Signal handler for stop and abort.
void	start() Attempts to start all configured instruments.

Methods inherited from class org.lsst.ccs.Subsystem

getLogHandler, getNumberCommandThreads, ping, printRunningCommands, setLogFormat, setLogHandlerLevel, setLogLevel, setStackTraceDepth

Methods inherited from class org.lsst.ccs.Agent

broadcastStatus, checkAllHardwareStopped, createHelper, executeCommandRequest, getAgentInfo, getAgentPersistenceService, getAgentService, getAgentServices, getCCSVersions, getCommandCount, getComponentConfigurationEnvironment, getComponentConfigurationEnvironmentByName, getComponentLookup, getCurrentAction, getDescription, getDistributionInfo, getEnvironmentLockService, getEnvironmentMessagingAccess, getLogger, getMessagingAccess, getName, getScheduler, getStatusBroadcastPeriod, helper, initAgent, internalCheckHardware, isConnectedToTheBuses, isInEngineeringMode, populateComponentLookup, preBuild, preInit, printComponentNodeTree, publishSubsystemDataOnStatusBus, sendAck, sendNack, sendStatusMessage, setAgentName, shutdownAgent, startAgent, vetoTransitionToNormalMode

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.lsst.ccs.framework.HasLifecycle

build, postBuild, postInit, postShutdown

Methods inherited from interface org.lsst.ccs.ServiceLifecycle

afterInit, afterStart, preShutdown, preStart

Constructor Detail

DoormanMain

public DoormanMain()

Constructor.

Method Detail

instruments

@Command(type=QUERY,
         description="Displays a short report on instrument status.")
public String instruments()

Gives the status of each of the instruments. Includes instrument number, enable flag and the timestamp of the last record read.

Returns:

A string with a heading line followed by one line per instrument.

disable

@Command(type=ACTION,
         description="Prevents further readout of an instrument")
public String disable(@Argument(description="Instrument index number.")
                                                                                                              int index)
                                                                                                       throws Exception

Prevents an instrument from being read until further notice.

Parameters:

index - An instrument index number.

Returns:

"OK", or "BUSY" if a readout is in progress.

Throws:

Exception - if ident is invalid or ambiguous.

See Also:

enable(int)

enable

@Command(type=ACTION,
         description="Enables an instrument for readout.")
public String enable(@Argument(description="Instrument index number.")
                                                                                                      int index)
                                                                                               throws Exception

Enables periodic readout for an instrument.

Parameters:

index - An instrument index number.

Returns:

"OK", or "BUSY" if a readout is in progress.

Throws:

IllegalArgumentException - if ident is invalid or ambiguous.

IllegalArgumentException - if newLocation is invalid.

org.lsst.ccs.HardwareException - if device operations fail.

Exception

See Also:

disable(int)

signal

public org.lsst.ccs.framework.TreeWalkerDiag signal(org.lsst.ccs.framework.Signal sig)

Signal handler for stop and abort.

Specified by:

signal in interface org.lsst.ccs.framework.SignalHandler

Parameters:

sig - The signal.

Returns:

TreeWalkerDiag.GO.

init

public void init()

Checks whether all the subsystem components have been constructed and registers the ClearAlertHandler. Called just after the subsystem component tree has been built.

Specified by:

init in interface org.lsst.ccs.framework.HasLifecycle

Throws:

RuntimeException - if anything is missing.

start

public void start()

Attempts to start all configured instruments. All instruments are stopped and re-started with correct configurations for their assigned locations.

Specified by:

start in interface org.lsst.ccs.framework.HasLifecycle

postStart

public void postStart()

Does nothing. Called at the end of the initialization phase after start() has been called for all configurable components and after checkHardware() and checkStarted() have been called for all hardware controllers.

Specified by:

postStart in interface org.lsst.ccs.framework.HasLifecycle

shutdown

public void shutdown()

Cancels the readout task if that hasn't already been done. The instruments themselves are not stopped and continue to collect data. Called at the beginning of the shutdown phase.

Specified by:

shutdown in interface org.lsst.ccs.framework.HasLifecycle

See Also:

signal(org.lsst.ccs.framework.Signal)