Binary Return Messages - Type 605
Binary Return Messages (Type 605)
Binary return messages are obtained by QTRACS as a result of periodic polling of the NMC by the Communications Manager process. Each of them is delivered to the appropriate external application via this Binary Return Message transaction.
Binary Return Messages are routed via binary data type and subtype. The subtype is defined to be the first byte of the binary information contained in the message body. Subtypes are in the range 0 through 255. The QTRACS Router can be instructed to route all subtypes of a single binary data type by setting *ALL as the subtype in the binary message routing database.
Binary Return Message transaction format
From | To | Size | Type | Field Description |
1 | 5 | 9 | Packed | Global Message Handle |
6 | 8 | 3 | Character | Transaction Type = 605 |
9 | 9 | 1 | Character | Source Entity Type |
10 | 19 | 10 | Character | Source Entity Identifier |
20 | 24 | 9 | Packed | Forward Global Message Handle |
25 | 25 | 1 | Character | Trip Status |
26 | 26 | 1 | Character | Return Message Priority |
27 | 30 | 7 | Packed | Mobile Firmware Version Number |
31 | 31 | 1 | Binary | Mobile Feature Enable Indicators |
32 | 32 | 1 | Character | QMASS Copy |
33 | 42 | 10 | Character | QMASS Auxiliary ID of Owner |
43 | 73 | 31 | Character | QMASS Return Auxiliary ID String |
74 | 173 | 100 | Character | Reserved - returned as blanks |
174 | 176 | 3 | Zoned | Binary Data Type |
177 | 179 | 3 | Zoned | Reserved - returned as zero |
180 | 186 | 13 | Packed | Message Time |
187 | 190 | 4 | Zoned | Message Length |
191 | 1615 | 1425 | Character | Message Body |
Binary Return Message transaction field descriptions
Field | Description |
Global Message Handle (GMH) | This packed decimal field contains the global message handle. The global message handle (GMH) is a universal handle that can be used to reference a specific message. Each return message is assigned a global message handle by QTRACS. |
Transaction Type | This is the code that identifies the transaction as a binary return message. It is a 3-character numeric field that will contain 605. |
Source Entity Type | This is a one-character code that identifies the source type of the message; where:
|
Source Entity Identifier | This is the 10-character source identifier. It identifies the source entity of the message. This should always be a registered QTRACS vehicle identifier. |
Forward GMH | This packed decimal field contains the global message handle (GMH) of the forward message to which this return message is a reply. This field may contain the GMH of the forward binary polling message for which this return binary message is a response. |
Trip Status | This 1-character field indicates the state of the vehicle's trip status, where:
|
Return Message Priority | This is the priority of the return message; where:
|
Mobile Firmware Version Number | This 7-digit packed decimal field contains the firmware version number of the vehicle that returned this binary message. This field should be ignored if the source of this message is an auxiliary vehicle (Source Entity Type = 'T'). The field will contain zeros in that case. |
Mobile Feature Enable Indicators | This 8-bit byte contains the feature indicators for the vehicle as follows:
|
QMASS Copy | This single byte character value indicates whether this is an original message sent from the vehicle or a copy of the message; where:
|
QMASS Auxiliary ID of Owner | This 10-character field contains the QTRACS auxiliary identifier of the owner of the vehicle. |
QMASS Return Auxiliary String | This 31-character string contains the text included in routed return messages from the vehicle to the auxiliary account. This text is specified by the owner of the vehicle at the time the vehicle is made available through QMASS. |
Binary Data Type | This 3 character field indicates the type of binary message being returned.
|
Message Time | This 13-digit packed decimal numeric field contains the time and date that the message was sent. This field is in the QTRACS GMT seconds format and may be converted for display using the QTRACS date/time APIs. |
Length | This is the length (in bytes) of the message as it is stored in the message body field. |
Message Body | This field contains the body of the binary message. It is a variable length field. The length of the field (in bytes) is indicated in the message length field described above. This field can contain a maximum of 1425 bytes of binary data. The content of the message body depends on the binary data type. This is not described in this document. |