2 Visual Components Manuals

VA_Srelease(1,VC_HANDLE);
}
}
}
3.3.8.12 Reading Alarm Lists − VA_GetExAlarmList
Two functions can be used to read the alarm history VA_GetAlarmList and VA_GetExAlarmList. Both
functions return a result string which then must be evaluated.
It is important to call VA_Setup once before alarm system functions are called and to execute VA_Saccess
before each use of Visapi alarm functions.
3.3.8.12.1 Parameter
I/O Parameter Type Meaning
IN enable BOOL This function is only executed if enable is TRUE.
IN VCHandle UDINT The handle returned by VA_Setup.
IN pcAlarmLine DINT Text array to be used as the alarm line
IN plLen DINT
IN iFunction UINT
Address of a DINT variable which contains the length of the text field.
After the function is called, this variable is set to the actual length.
1 ..... Read first alarm
2 ..... Read next alarm
4 ..... Read previous alarm
8 ..... Read last alarm
IN cSeperator USINT Separation character to be inserted into the alarm line
IN cDateTimeFormat USINT
Desired format for date and time output in the alarm list
0 ... DD.MM.YY_HH:MM:SS
1 ... DD.MM.YY_HH:MM:SSa
2 ... HH_MM_SS
3 ... HH_MM_SSa
4 ... HH_MM
5 ... HH_MMa
6 ... NO_TIME_NO_DATE
OUT Return Value UINT Not equal to 0 if error occurs
3.3.8.12.2 Example for Automation Basic
if ready = 0 then
VC_HANDLE = VA_Setup(1 "vga") ,
VC_HANDLE if 0 then
ready = 1
endif
else
Access_Status = VA_Saccess (1,VC_HANDLE)
if Access_Status = 0 then
endif
endif
Alarmlen = 80
Seperator = ;Hyphen 45
;Read Alarmtype first alarm = 1
TimeDateForm ;DD.MM.YY = 0 HH.MM.SS
3.3.8.12.3 Example for C Programming
#include
#include
#include
GetExAL_Status = VA_GetExAlarmList UDINT(ADR(Alarmstring)),UDINT(ADR(Alarmlen)),Alarmtype,Seperato
(1,VC_HANDLE,
VA_Srelease (1,VC_HANDLE)
UINT _GLOBAL ready;
STRING _GLOBAL pcAlarmline[80];
DINT _GLOBAL lLen;
Introduction to Visual Components 2.3
148 3.3.8.12 Reading Alarm Lists − VA_GetExAlarmList