DISPATCHRECEIPT
Lists the dispatch messages installed
|
Platform: |
OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, CPT7, CPT7700, SMART7, SMART2 |
The DISPATCHRECEIPT log provides a digitally signed token that indicates which dispatch messages have been installed on the receiver, including those for Service Periods and for Permanent Models. The receipt string (which includes the PSN) can be provided to the NovAtel commerce system as proof of message reception and to confirm that the receiver has the latest subscription information. If a newer dispatch is available, the system will provide it. The values in the receipt are also expanded in the log for each type.
For information about dispatch messages, refer to Receiver Features: Authorization and Subscriptions.
Message ID: 2558
Log type: Asynch
Recommended input:
log dispatchreceipt once
ASCII Example:
<DISPATCHRECEIPT
< 3
< DICTIONARY 6 0 1 0
< SPLIT 12 0 1 0
< MODEL 0 0 0 0
< "BMHR17090005E=B7qAobpe72na03OdqM5MEwjFqoX7=”
|
Field |
Field type |
Description |
Format |
Binary bytes |
Binary offset |
|---|---|---|---|---|---|
|
1 |
Log header |
DISPATCHRECEIPT header For information about log headers, see ASCII, Abbreviated ASCII or Binary. |
– |
H |
0 |
|
2 |
# entries |
Number of message type records to follow. Range is 0 to 15. |
Ulong |
4 |
H |
|
3 |
dispatch type |
Message type for this entry. See Table: Dispatch message type. Only one of SPLIT or MERGED type is given – whichever is present. They share the same sequence number. |
Enum |
4 |
H+4 |
|
4 |
sequence number |
Maximum message sequence number of this type ever received. 0 = This message type has never been received. |
Ushort |
2 |
H+8 |
|
5 |
maximum revision |
Maximum supported dispatch revision for this type. Messages with higher revisions will be ignored. |
Uchar |
1 |
H+10 |
|
6 |
present |
1 = This message is currently saved on the receiver 0 = This message is not currently present |
Uchar |
1 |
H+11 |
|
7 |
reserved |
Reserved field filled with zero. Ignore on reception. |
Ulong |
4 |
H+12 |
|
9 |
Next message type = H + 16 + (#entries x 12) |
||||
|
8 |
receipt |
A digitally signed message indicating which dispatch messages are currently installed in the receiver. This message is in Offline Dispatch format, which begins with the card PSN. This message is 15 to 256 characters and contains only URL safe ASCII characters. |
String |
256 |
H+16+ (#entries x 12) |
|
10 |
xxxx |
32-bit CRC (ASCII and Binary only) |
Hex |
4 |
H+272+ (#entries x 12) |
|
11 |
[CR][LF] |
Sentence terminator (ASCII only) |
– |
– |
– |