Skip to main content
Omnitracs Knowledge Base

Vehicle Definition Notification - Type 401 (new for v6.2)

Vehicle Definition Notification (new for v6.2)

(Type 401)

This section describes the transaction used to deliver Vehicle Definition Notification transactions to the external application software. QTRACS provides the means to request notification of vehicle maintenance; add, delete, rename and change vehicle UA, for owned vehicles and auxiliary vehicles.

Depending on the setting of the Vehicle Maintenance Transaction attribute within the external application registry, a Vehicle Definition Notification transaction will be delivered to an external application each time a vehicle is maintained.

Vehicle Notification Definition transaction format

From To Size Type Field Description
1 5 9,0 Packed Host Message Number (HMN)
6 8 3 Character Transaction Type = 401
9 15 13,0 Packed Event Time
16 16 1 Character Maintenance Function
17 26 10 Character Vehicle Identifier
27 36 10 Character Vehicle Unified Address
37 37 1 Character Vehicle Type
38 47 10 Character Prior Vehicle Identifier
48 57 10 Character Prior Vehicle Unified Address
58 58 1 Character Prior Vehicle Type
59 68 10 Character QMASS Auxiliary Account Identifier of Owner

Vehicle Notification Definition 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 vehicle maintenance. It is a 3-character numeric field that always contains 401.
Event Time This 13-digit packed decimal numeric field contains the time and date that the maintenance event occurred. This field is in the QTRACS GMT seconds format and may be converted for display using the QTRACS date/time APIs.
Maintenance Function This 1-character field indicates the type of maintenance performed; where:
1 add
2 rename
3 delete
4 change UA
Vehicle Identifer This is the QTRACS entity name of the vehicle that was maintained.
Vehicle Unified Address This is a 10-character field that identifies the mobile communications terminal number installed in the vehicle.
Vehicle Type This 1-character field indicates the type of unit installed on the vehicle; where:
0 unknown
1 MCT
2 TMCT
3 OmniOne
4 MCP Other
5 MCP050
6 MCP100
7 MCP110
8 MCP200
Prior Vehicle Identifer This is the old QTRACS entity name of the vehicle that was maintained. This field will only be filled if the maintenance performed was a rename.
Prior Vehicle Unified Address This is the old 10-character field that identified the mobile communications terminal number installed in the vehicle. This field will only be filled if the maintenance performed was change UA.
Prior Vehicle Type This 1-character field indicates the old type of unit installed on the vehicle; where:
0 unknown
1 MCT
2 TMCT
3 OmniOne
4 MCP Other
5 MCP050
6 MCP100
7 MCP110
8 MCP200
This field will only be filled if the maintenance performed was change UA.
QMASS Auxiliary Account Identifier of Owner This 10-character field contains the QTRACS auxiliary identifier of the owner of this vehicle. This field will be blank if vehicle is owned.
  • Was this article helpful?