User manual

Computer Gateway User Manual 3-5 5/96
3.2.1
3.2.1.4 Store Data
This routine sends data to points in the CG, or elsewhere on the LCN. The specification of
what points are to receive data, and the location of data within the calling-program's data
arrays, is contained in the Data Definition Table referenced by the call. Errors encountered
during execution of the routine, as well as individual point-data errors, are returned to the
calling program.
3.2.1.5 Store Single Value (External ID)
This routine stores data to a single point in the CG, or elsewhere on the LCN. The
specification of which data is to be fetched and where it is to be stored is contained in the
call.
3.2.1.6 Store Single Value (Internal ID)
This routine stores data to a single point in the CG, or elsewhere on the LCN. Use of the
internal point and parameter address (obtained by previous use of the Convert Address
function) reduces the overhead required for repetitive single-point requests. The
specification of which data is to be fetched and where it is to be stored is contained in the
call.
3.2.1.7 Get History
This routine is used to fetch history data from the HM. The specification of which data is
to be collected is contained in a Data Definition Table, while time bounds and the history
type are calling parameters.
3.2.1.8 Get Message
This routine is used to fetch a character-string message held in a CG buffer by this
program's ACIDP. The message presence is detected as the result of a Get ACP-Status
request.
3.2.1.9 Send Message
This routine is used to send a message to all operator stations monitoring the unit this
program's ACIDP was assigned to when configured. A request to wait for operator
confirmation is optional. If operator confirmation is requested, execution of the requesting
program is suspended until either the confirmation occurs or until its specified wait time
expires. The requesting program receives an indication of whether confirmation or a time
out occurred.