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