APUStartInstance() Function

Starts an instance of the Alarm Printer in a minimized state with values specified from a configuration file.

Category

View

Syntax

[Result=] APUStartInstance(sFilePath, iTagInstance);

Arguments

sFilePath

Full path to a configuration file (input string).

iTagInstance

Integer tag. The function returns an instance number to it if the function executes successfully.

Remarks

You can start up to sixteen instances of the Alarm Printer. This function writes the instance number (0 - 15) to the iTagInstance parameter. The instance number increments when a new Alarm Printer instance starts.

This instance number can be used by other Alarm Printer functions to identify the Alarm Printer instance.

This function returns 0 or, in the case of error, an error code.

The Alarm Printer program does not automatically begin processing alarms from the alarm memory. Use the APUStartQuery() function to begin processing data from the alarm memory for the instance.

Example

Status = APUStartInstance("c:\MyAlarmCfg\Area1Alarms.alc", Inst);

See Also

APUStartQuery(), APUStopInstance(), APUStopQuery()