40 Tools guide — Program loader
Developer’s Guide – RIM 950 Wireless Handheld™
API, RimCatastrophicAPIFailure(). In all cases, ot her
unresolved links fail; only unresolved OS calls can be mapped.
-D specifies that unresolved OS calls should not be mapped to
RimCatastrophicAPIFailure().
<files or groups> are one or more files or groups of files to be
loaded onto the RIM Wireless Handheld. Individual files are specified
alone. Groups of files are enclosed in parentheses, brackets, or braces.
There must be spaces surrounding the brackets, as in the example below.
Description
The LOAD command loads new applications or the application
environment onto the RIM Wireless Handheld. Any old applications by
the same name are erased. Applications can and should be grouped to
reduce wasted space on the RIM Wireless Handheld. However, if an
application is to be replaced separate from other applica tions on t he RIM
Wireless Handheld, it should be placed in its own group.
Note
When loading or replacing the application environment
(PAGER950.BIN), it must be specified first on any Load command.
Grouping of programs
Because the flash memory can only be erased one 64 kilobyte sector at a
time, any application that is to be erased and have its space reclaimed
must not overlap with other applications in the same 64 kilobyte sector.
Grouped applications are contiguous, without regar d to the 64k sector
boundaries. As such, when invalidating an application that is part of a
group, the space cannot be reclaimed without erasing other applications
as well. Applications that are not grouped each occupy one or more 64
kilobyte sectors, with the remainder of the last sector used being wasted.
Note
The ability to group programs is specific to the PROGRAMMER.EXE.
Although the desktop loader program will recognize groups already
on a RIM Wireless Handheld, it cannot load files in groups.
Examples
The following command will load the application environment and
applications onto the RIM Wireless Handheld: