Appendix L - QTRACS Message Abbreviator

This appendix describes the public Application Program Interface for the QTRACS Message Abbreviator program (ABMSGABV).

Required Parameter Group:

1	Original Message Body	Input	Char(1900)
2	Abbreviated Message Body	Output	Char(1900)
3	Original Cost	Output	Packed(5,3)
4	Abbreviated Cost	Output	Packed(5,3)
5	Cost Savings	Output	Packed(5,3)
6	Return Status	Output	Char(2)

API Overview:

The QTRACS Message Abbreviator public API (ABMSGABV) accepts as input a message body and attempts to abbreviate it. Upon completion it returns an abbreviated message, and some cost related information. The cost fields return zero if the 'Cost Savings' feature has not been enabled.

This API should be called by external applications prior to sending a freeform message to a vehicle (or vehicle message group) via QTRACS' API OMCRTMSG or transactional interface (601). Using this API to abbreviate a macro message will ruin the formatting of the message and cause problems on the mobile unit.

Note: contact QUALCOMM Professional Services for more information about the QTRACS Message Abbreviator.

Required Parameter Group Details:

(1) Original Message Body
INPUT; CHAR(1900)
This parameter contains the body of the message to be abbreviated.

(2) Abbreviated Message Body
OUTPUT; CHAR(1900)
This parameter contains the abbreviated message body.

(3) Original Cost
OUTPUT; PACKED(5,3)
This parameter returns the cost of the original message input. A zero value is returned if the 'Cost Savings' feature is disabled.

(4) Abbreviated Cost
OUTPUT; PACKED(5,3)
This parameter returns the cost of the abbreviated message. A zero value is returned if the 'Cost Savings' feature is disabled.

(5) Cost Savings
OUTPUT; PACKED(5,3)
This parameter returns the cost savings of the abbreviated message when sent to a single vehicle. A zero value is returned if the 'Cost Savings' feature is disabled.

(6) Return Status
OUTPUT; CHAR(2)
Status value returned to the caller will be set as follows:

00	Success, message text has been abbreviated
01	Failure, an error occurred on the call to OMMSABBV