User Manual Part 2

User Guide to Q4000/QPRO
Document Number 1135-4713 Rev G
THIS DOCUMENT CONTAINS CONFIDENTIAL AND PROPRIETARY INFORMATION OF QUAKE GLOBAL CORPORATION. IT MAY BE USED BY
RECIPIENT ONLY FOR THE PURPOSE FOR WHICH IT WAS TRANSMITTED AND WILL BE RETURNED UPON REQUEST OR WHEN NO LONGER NEEDED
BY RECIPIENT. DISCLOSURE TO UNAUTHORIZED THIRD PARTIES OR DUPLICATION WITHOUT THE EXPRESS WRITTEN PERMISSION OF QUAKE
GLOBAL IS PROHIBITED.
Page 63
CONFIDENTIAL
Information classified Confidential
-
Do not copy (See last page for obligations)
If parsing of the entire network configuration file fails, or the file is not present, all
networks and protocols are used with GPRS as the default protocol.
For in-depth information on the Network Independent Message Manager (NIMM), please
refer to the 1135-3003 Q4000 Programmer Guide.
11 Network Independent Message Manager (NIMM)
The Q4000 supports the ability to send messages independent of a specific network and
independent of any particular protocol. This Network Independent Message Manager (NIMM)
system consists of a single API to send messages for any configured network, and a mechanism
to update the configuration file at any time.
11.1.1 Network configuration file
The network configuration file is an ASCII-based, comma separated text file containing network
configuration data. It defines the order in which networks are attempted, including the protocol for
that network. This file is stored at "/tffs0/etc/NIMM.cfg" in NVM. If the user wishes to override
the built-in configuration, a custom configuration file may be created. NIMM reads this file once
at startup.
The file contains the following information:
• network on which the data will be sent
• protocol to use for this network
• maximum size of a message for this network
• boolean value indicating that this network/protocol accepts binary content
• timeout value to indicate how long this network/protocol can hold a message before being
forced to return it for other processing.
Some sample configuration data would be:
Network, Protocol, Max, Bool, Timeout
NETWORK_ORB, ORB_REPORT, 18, TRUE, 20000
NETWORK_TERR, TERR_SMTP, 20000, FALSE, 0
Lines starting with a double slash (//) are treated as comment lines and ignored.
Some networks support the concept of a timeout for a message. In particular, Iridium and
Orbcomm may take longer than expected for message delivery if the network drops out of view
during message transmission. In this case, NIMM tells the network delivery mechanism to drop
the message and informs the application in order to allow it to reschedule the message.
11.1.1.1 Default network configuration file
The default configuration built into the modem uses the following entries:
Note:
Note: