Forward T2 Message - Type 609
Submitting a Forward T2 Message (Type 609)
This transaction is used to request the transmission of a forward message to a T2-equipped trailer. The receipt of this transaction will cause QTRACS to place a call to OMCRTMSG. The parameter list will be constructed using values supplied in the transaction. Refer to the OMCRTMSG section of this document for additional information.
Forward T2 message transaction format
| From | To | Size | Type | Field Name |
|---|---|---|---|---|
| 1 | 5 | 9 | Packed | Local GMH |
| 6 | 8 | 3 | Character | Transaction Type = 609 |
| 9 | 18 | 10 | Character | Sender |
| 19 | 19 | 1 | Character | Reserved - set to blanks |
| 20 | 21 | 3 | Packed | Reserved - set to zero |
| 22 | 31 | 10 | Zoned | Destination |
| 32 | 241 | 210 | Character | Reserved - set to blanks |
| 242 | 243 | 3 | Packed | Times to Transmit |
| 244 | 244 | 1 | Character | Priority |
| 245 | 245 | 1 | Character | Schedule |
| 246 | 246 | 1 | Character | Return Receipt |
| 247 | 247 | 1 | Character | Word Wrap |
| 248 | 257 | 10 | Character | Response Indicator |
| 258 | 259 | 3 | Packed | T2 Data Type |
| 260 | 261 | 3 | Packed | Reserved - set to zero |
| 262 | 271 | 10 | Character | Application ID |
| 272 | 278 | 7 | Character | Reserved - set to blanks |
| 279 | 279 | 1 | Character | Body Type Indicator |
| 280 | 282 | 5 | Packed | Message Body Length |
| 283 | 2182 | 1900 | Character | Message Body |
Forward T2 message transaction fields
| Field Name | Description |
| Local GMH | This packed decimal field contains the Local GMH as assigned by the application requesting that this message be sent. Upon receipt of this transaction, QTRACS will assign a Global Message Handle. If requested, QTRACS will return that GMH to the external application defined in the Application ID field. QTRACS discards the Local GMH upon receipt. |
| Transaction Type | This field must be set to 609. |
| Sender | Source entity identifier. Denotes the source (sender) of the message. The source must be an application. |
| Destination | T2 device ID. Denotes the serial number of the T2 device to which this message will be sent. Must be a single 10-digit terrestrial T2 ID in the range of 0120000001:0129999998. |
| Times to Transmit | Times to transmit. This field is passed through to the NMC. It is only used for components of the message that are transmitted over the OmniTRACS link. A zero value in this field will cause the NMC to transmit the message based on its internal defaults. This field should be set to zero unless there are very specific transmission requirements. Setting this field to a value other than zero may adversely affect the characteristics of the transmission priority. |
| Priority | Message transmission priority. Valid values are:
|
| Schedule | Schedule for off-peak (batch) transmission where:
|
| Return Receipt | This field must be set to 0. |
| Word Wrap | This field must be set to 0. |
| Response Indicator | This field must be set to *NONE. |
| T2 Data Type | This field indicates the type of data that is contained in the T2 message body, where:
|
| Application ID | If the calling application would like QTRACS to return the GMH for this message, then this field should contain the registered QTRACS external application id to which the 692 transaction will be sent. See an explanation of the 692 transaction for more details. This is only necessary in a RI (remote integration) environment. |
| Body Type Indicator | This field must be set to 'R' (T2). |
| Message Length | This is the length (in characters) of the message as it is stored in the T2 Message Body field. The maximum length is 1900. |
| T2 Message Body | This field contains the body of the message. It is a variable length field. The length of the field (in characters) is indicated in the Message Length field described above. |