Home

GEONius.com
29-Feb-2016
E-mail

eco_util - EPOCH V4 CORBA-Lite Utilities

The ECO utilities provide simplified access to the CORBA-based EPOCH V4 servers using the CORBA-Lite utilities.

Two functions aid in establishing a CORBA network connection to a V4 service:

ecoGetServiceURL()
queries, as necessary, the V4 configuration service and the V4 node manager for a target service's URL. (The URL for the configuration service must be explicitly supplied if environment variable EPOCHNG_CONFIG is not set.)
ecoGetService()
establishes an IIOP network stream to a URL-specified V4 service via the service's Epoch::Admin object.

Once an IIOP connection is established, a client application can use coliRequest() and coliGetReply() for basic communications with the service. A server application, on the other hand, would use coliGetRequest() and coliReply().

Higher-level routines built on the functions above communicate with specific EPOCH V4 services. The names are self-explanatory.

Configuration Server:
ecoGetServiceList()
Database Server:
ecoGetCDBArguments()
ecoGetCDBCommands()
ecoGetCDBDescriptions()
ecoGetCDBFormats()
ecoGetEventCategories()
ecoGetEventDefinitions()
ecoGetLimitTable()
ecoGetSubsystems()
ecoGetPointList()
ecoOpenCDB()
ecoOpenTDB()
Node Manager:
ecoGetHostServices()
ecoGetStreamList()
ecoGetStreamServices()
ecoStartStream()
ecoStopStream()
Points Server:
ecoPointGet()
ecoPointSet()
Various Servers:
ecoGetID()
ecoV2S()

Public Procedures

ecoGetCDBArguments() - gets a list of a spacecraft command arguments from a database server.
ecoGetCDBCommands() - gets a list of a spacecraft commands from a database server.
ecoGetCDBDescriptions() - gets a list of a spacecraft command descriptions from a database server.
ecoGetCDBFormats() - gets a list of a spacecraft command formats from a database server.
ecoGetEventCategories() - gets a list of event categories from a database server.
ecoGetEventDefinitions() - gets a list of event definitions from a database server.
ecoGetHostServices() - gets a list of host services from a node manager.
ecoGetID() - gets an EPOCH V4 object's ID.
ecoGetLimitTable() - gets a list of limit definitions from a database server.
ecoGetPointList() - gets a list of a spacecraft stream's points from a database server.
ecoGetService() - connects to an EPOCH V4 service.
ecoGetServiceList() - gets a list of services from a configuration server.
ecoGetServiceURL() - gets the URL for an EPOCH V4 service.
ecoGetStreamList() - gets a list of spacecraft streams from a node manager.
ecoGetStreamServices() - gets a list of spacecraft stream's services from a node manager.
ecoGetSubsystems() - gets a list of a spacecraft subsystems from a database server.
ecoOpenCDB() - open a spacecraft command database.
ecoOpenTDB() - open a telemetry database.
ecoPointGet() - gets a point's value from a points server.
ecoPointSet() - sets a point's value on a points server.
ecoServiceContexts() - gets the EPOCH V4 service context list.
ecoStartStream() - asks a node manager to start a spacecraft stream.
ecoStopStream() - asks a node manager to stop a spacecraft stream.
ecoV2S() - returns the string representation of a VarData value.

Source Files

eco_util.c
eco_util.h

Alex Measday  /  E-mail