Sun Microsystems 2 manual Maximum number of tasks isolates allowed

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.

TABLE 3-1Constant 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

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.

26 Multitasking Guide • May 2007