Svccom3Reqtallyinfo() - VeriFone MX800 series Programmer's Manual

S F
ERVICE UNCTIONS

svcCom3ReqTallyInfo()

svcCom3ReqTallyInfo()
178
M X 800 S P
ERIES ROGRAMMERS
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:
Table 16 Tally Record
Entry Size
<Ntallies> byte
<Id> byte
<Count> word
Table 17
<ID> Mnemonic
1 ODP
2 LDP
3 MSE
4 SCE
5 POR
Prototype
short svcCom3ReqTallyInfo(int fd, char *tiBuf)
Parameters
file descriptor returned when opening a serial port with either open()
fd
or ecrOpen().
pointer to a buffer that will hold the Tally Information report.
*tiBuf
G
UIDE
Range Description
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.
00 – FF FF Tally code identifier (see table below)
0000 – FFFF 16 bit tally count. Order is MSB/LSB.
Description
Number of other device polls.
Number of local device polls.
Number of message structure errors.
Number of sequence count errors.
Number of power on reset commands