Forward Message Completion - Type 602

Notification of Forward Message Completion (Type 602)

If the source of a message is an external application, then QTRACS/400 automatically notifies the application software about the status of its attempt to send a message. This notification is sent back to the application through its input queue as specified when the application was registered. The message acknowledgment attribute of the application, which was also provided at registration time, provides the means to configure the application in one of two ways:

Negative Acknowledgments Only causes QTRACS/400 to report only failed attempts back to the application. In this case, the application is not notified about messages that are accepted by QTRACS for delivery and that are successfully delivered to the destination.
All Acknowledgments causes QTRACS/400 to notify the application about the delivery status of all messages. In this case, the resolution of each message submission is reported back.

Forward message onfirmation transaction format

From	To	Size	Type	Field Name
1	5	9	Packed	Global Message Handle
6	8	3	Character	Transaction Type Code = 602
9	10	2	Character	Completion Status
11	20	10	Character	Application ID
21	24	4	Character	Completion Reason Code
25	34	10	Character	Addressee (Receiver) of Message
35	39	9	Packed	Message Component Reference Number (HMN)
40	40	1	Character	QMASS Copy of Message
41	50	10	Character	QMASS Auxiliary ID of Owner of Vehicle
51	81	31	Character	Reserved - set to blanks
82	88	13	Packed	Timestamp
89	181	93	Character	Reserved - set to blanks

Forward message onfirmation transaction format

Field Name	Description
Global Message Handle	This packed decimal field contains the global message handle. The global message handle (GMH) is used as a reference to the forward message. The external application software obtained the GMH from QTRACS via a call to OMCRTMSG at the time that the message was submitted. QTRACS returns the GMH in all transactions that pertain to the message.
Transaction Type	This field will be set to 602.
Completion Status	The Completion Status indicates the status of the message submission in QTRACS v3.x format. These codes are supported for backward compatibility with QTRACS v3.x external applications only. All external applications should be modified to utilize the Completion Reason Code field below.
Application ID	The Application ID is the 10-character identifier of the application that submitted the message for transmission.
Completion Reason Code	This is a 4-character code indicating the completion status of the message. A descriptive message can be found in the TRAQMSGF message file by appending this code to the 'CRC' prefix. This code supercedes the completion status as described above.
Addressee (Receiver of Message)	This field contains the entity identifier of the receiver of the forward message. Multiple Type 602 transactions are returned (one for each addressee) in the case of messages that are addressed to more than one vehicle. This field is provides the means to determine which addressee is being referenced by the forward message completion transaction.
Message Component Reference Number	QTRACS assigns a unique reference number to each remote addressee when a forward message is addressed to more than one vehicle. This number is used internally by QTRACS to track the disposition of each transmittable component of the forward message. This field is returned in certain QTRACS API routines.
QMASS Copy of Message	This single byte character value indicates whether this is an original message sent from the vehicle or a copy of the message; where: 0 Original 1 Copy
QMASS Auxiliary ID of Owner of Vehicle	This 10-character field contains the QTRACS auxiliary identifier of the owner of the vehicle.
Timestamp	Normally, this 13-digit packed field returns the timestamp (in GMT seconds) of when the message was received by the mobile. In some instances, the message was rejected, dropped, or undeliverable (as indicated in the Completion Reason Code field). In these cases, this timestamp indicates when that disposition applied to the forward message.