State Miles Extract - Type 625 (new for v7.0)

State Miles Extract (new for v7.0)

(Type 625)

This section describes the transaction used to deliver State Miles Extracts to the external application software.

MCP-equipped vehicles can be configured to return the total distance traveled within a state. This information is automatically returned when the vehicle crosses a state boundary line, or a timer expires. If the State Miles Extract transaction attribute is enabled for an external application, a State Miles Extract transaction will be delivered to the external application whenever the information is received from an MCP-equipped vehicle.

State Miles Extract transaction format

From	To	Size	Type	Field Description
1	5	9,0	Packed	Host Message Number (HMN)
6	8	3	Character	Transaction Type = 625
9	13	9,0	Packed	Associated Message Global Message Handle
14	23	10	Character	Vehicle ID
24	30	13,0	Packed	Start of Period Timestamp
31	37	13,0	Packed	End of Period Timestamp
38	44	13,0	Packed	Date Posted (Arrival) Timestamp
45	46	2	Character	Current Country Abbreviation
47	48	2	Character	Current State Abbreviation
49	52	7,1	Packed	Miles
53	54	2	Character	Transition to Country Abbreviation
55	56	2	Character	Transition to State Abbreviation

State Miles Extract transaction field descriptions

Field	Description
Host Message Number	This packed decimal field contains the host message number. The host message number (HMN) is a global packet handle that is used to reference a specific transaction.
Transaction Type	This is the code that identifies the transaction as a state miles extract. It is a 3-character numeric field that always contains 625.
Associated Message Global Message Handle	This packed decimal field contains the global message handle. The global message handle is used to reference a specific QTRACS message. Each message is assigned a global message by QTRACS. This value is returned set equal to zero if the extract is not associated with the receipt of a QTRACS message.
Vehicle Identifer	This is the QTRACS entity name of the vehicle that was maintained.
Start of Period Timestamp	This 13 digit packed decimal numeric field contains the time and date of the starting timestamp of the miles tracked. This field is in the QTRACS GMT seconds format and may be converted for display using the QTRACS date/time API's.
End of Period Timestamp	This 13 digit packed nmeric field contains the time and date of the ending timestamp of the miles tracked. This field is in the QTRACS GMT seconds format and may be converted for display using the QTRACS date/time API's.
Date Posted (Arrival) Timestamp	This 13 digit packed decimal numeric field contains the time and date that the extract was received by QTRACS. This field is in the QTRACS GMT seconds format and may be converted for display using the QTRACS date/time API's.
Current Country Abbreviation	This 2-character field indicates the current country that the vehicle is in or was in before a country border crossing.
Current State Abbreviation	This 2-character field indicates the current state that the vehicle is in or was in before a state border crossing.
Miles	Miles travelled in the current state since the last extract.
Transition to Country Abbreviation	This 2-character field indicates the country that the vehicle is in when it crosses into a new state. This field is only filled if the vehicle crosses a state border.
Transition to State Abbreviation	This 2-character field indicates the new state that the vehicle is in when it crosses into a new state. This field is only filled if the vehicle crosses a state border.