User's Manual

DRAFT TrimTrac 1.5 Technical Manual v0.3ab 124
QUERY_LOG
This message is used by the server application to request logged REPORT_POS
or STATUS_MSG messages that may not have been received at the server
application. The TrimTrac 1.5 will send the corresponding messages to the server
application in response to this message at the rate of one REPORT_POS or
STATUS_MSG per message. At the end of the messages a RESP_QUERY_LOG
or RESP_QUERY_AGGR is sent. The TrimTrac 1.5 log contains 1,024 of the
most recent messages. Care should be taken when structuring the QUERY_LOG
message. Querying the entire log, for instance, will result in the transmission of
all 1,024 logged messages.
>QTKABBBBCCCC[DE[FGHIJJJK[LLLLMMMMMM[NNNNOOOOOO]]]];PW
=PPPPPPPP;ID=YYYYYYYY;*ZZ<
A
Always ‘R’: Indicates a query for old REPORT messages
BBBB
Beginning Protocol Sequence Number. 16-bit Hex (0000-FFFF)
incrementing by 1 for each logged report
.
CCCC
Ending Protocol Sequence Number. 16-bit Hex (0000-FFFF)
incrementing by 1 for each logged report
PPPPPPPP
Security Password
. Always 8 alphanumeric characters, UPPER
CASE ONLY.
. Default 00000000
YYYYYYYY
Unit ID. Always 8 alphanumeric characters, UPPER CASE ONLY
ZZ
Checksum.
Optional
D
Aggregate Log Reporting Flag: ‘T’ = enabled, ‘F’ = disabled.
When enabled, aggregate reports may be returned.
E
Stop RESP_QUERY_LOG message from being sent: ‘T’ = do
not send, ‘F’ = send. Used to stop the unit from fulfilling
previous QUERY_LOG requests.
F
Filter 1: 'Z' = All, 'U' = Unsent only.
G
Filter 2: 'Z' = All, 'P' = Position only, 'S' = Status only.
H
Filter 3: 'Z' = All, 'A' = Alert only
I
Time range: 'Z' = Unused, 'N' = Newest, 'O' = Oldest
JJJ
Maximum Number of Messages to be sent in response to the current
QUERY_LOG message. If non-zero then this limits the total number of
message that can be sent from the log. If zero then the number of messages
sent from the log limit is 1,024 messages. Applicable if Time range is not ‘Z’.
K
Last Message: ‘1’ = automatically include the last message in
the log regardless of the filter settings, ‘0’ = don’t automatically
include the last message in the log.
LLLL
GPS week number of starting date
MMMMMM
GPS seconds into week of starting date.
NNNN
GPS week number of ending date. 'Most recent' if not present.
OOOOOO
GPS seconds into week of ending date. 'Most recent' if not
present.
Table 62, QUERY_LOG Message