SERVICE FUNCTIONS
svcCom3ReqTallyInfo()
178 M
X
800 SERIES PROGRAMMERS GUIDE
svcCom3ReqTallyInfo()
The svcCom3ReqTallyInfo() function allows the application to request the
Tally Information report which is comprised of a listing of counters that track ECR
events. This function returns 0 upon success and a negative value if
unsuccessful. The Tally Record report is defined as follows:
Tally Record Structure: <Ntallies> <Id> <Count> . . . <Id> <Count>
The tally record is a listing of the current tally counters. The record is open ended
and allows for additional tally counters to be added. Each tally count is uniquely
identified and is followed with a 16 bit binary value in MSB/LSB order. The tally
counters are up counters that increment with each detected event and will clamp
at 0xFFFF to indicate overflow.
Where:
Prototype
short svcCom3ReqTallyInfo(int fd, char *tiBuf)
Parameters
Table 16 Tally Record
Entry Size Range Description
<Ntallies> byte 00 – FF Number of tally entries in record. Current
firmware version limits this field to 5 and
always reports 5 entries. This field has a
range of 00-FF if needed to change
number of entries reported. A zero tally
count would indicate that no list follows.
<Id> byte 00 – FF FF Tally code identifier (see table below)
<Count> word 0000 – FFFF 16 bit tally count. Order is MSB/LSB.
Table 17
<ID> Mnemonic Description
1 ODP Number of other device polls.
2 LDP Number of local device polls.
3 MSE Number of message structure errors.
4 SCE Number of sequence count errors.
5 POR Number of power on reset commands
fd file descriptor returned when opening a serial port with either open()
or ecrOpen().
*tiBuf pointer to a buffer that will hold the Tally Information report.
To Next Page
Loading...
