Filter
Top Products
26 Multitasking Guide • May 2007
Each resource typically has five constants that define the policy. A pair of constants
defines the reservation and the limit for each MIDlet suite. These constants have the
suffixes SUITE_RESERVED and SUITE_LIMIT, respectively. Another pair of
constants defines the reservation and limit for the AMS task. These constants have
the suffixes AMS_RESERVED and AMS_LIMIT. Finally, the fifth constant specifies the
global limit for the entire system. The sum of all allocations by all MIDlet suites and
the AMS cannot exceed this limit. This constant has the suffix GLOBAL_LIMIT.
For certain resources, it is important to choose the AMS reservation carefully. For
example, the AMS needs to open various MIDlet files in order to change application
settings. If the AMS open file reservation is not set high enough, and running
MIDlets have consumed all available file handles, the normal operation of the AMS
will be disrupted.
Five constants determine the policy for TCP client sockets: the global limit, the
reservation and limit for the AMS, and the reservation and limit for each MIDlet
suite. This pattern of five constants is repeated for several different resources,
including the following:
■ TCP server sockets
■ UDP datagram sockets
■ Open file handles
■ Audio channels
■ Mutable images
■ Immutable images
For each of these resource types, you can specify independently the global limit and
the reservations and limits for the AMS and for each MIDlet suite.
TABLE 3-1 Constant Definitions for the Resource Management Policy
Name Description
MAX_ISOLATES
Maximum number of tasks (isolates) allowed.
SUITE_MEMORY_RESERVED
Heap memory reserved for each MIDlet suite, in
kilobytes
SUITE_MEMORY_LIMIT
Heap memory limit for each MIDlet suite, in
kilobytes
TCP_CLI_GLOBAL_LIMIT
TCP client socket limit for the entire system
TCP_CLI_AMS_RESERVED
TCP client socket reservation for the AMS
TCP_CLI_AMS_LIMIT
TCP client socket limit for the AMS
TCP_CLI_SUITE_RESERVED
TCP client socket reservation for each MIDlet suite
TCP_CLI_SUITE_LIMIT
TCP client socket limit for each MIDlet suite