Cogent C API and Utilities : Version 5.4
	Cascade Historian Functions

`HI_Enable`

HI_Enable — activates data recording.

Syntax

#include <cogent.h>
ST_STATUS HI_Enable( IP_hTASK   historian, 
  char*   retbuf, 
  int   buflen, 
  char*   histpattern);

Arguments

historian: The task pointer to the Cascade Historian program.
retbuf: An optional buffer containing an error message.
buflen: The length in bytes of retbuf. If retbuf is non-NULL, this must be a valid non-zero length. If retbuf is NULL, this parameter is ignored.
histpattern: A globbing pattern specifying a group of histories.

Returns

ST_OK on success. Otherwise ST_ERROR, and the retbuf will contain a NULL-terminated character string with an error message. If the return value is ST_OK, the retbuf may not contain useful information.

Description

This function reverses the effect of a previous disable, hist_disable, or HI_Disable call, so that new data values will be accepted and logged.

This function corresponds to the Cascade Historian enable command and the hist_enable dynamic library function.

`ST_STATUS HI_Enable(`	IP_hTASK	`historian`,
	char*	`retbuf`,
	int	`buflen`,
	char*	`histpattern)`;


HI_Earliest		HI_ExchangeBuffer