Specifications

Contents
1 Series 3 Programming Overview...........................................................................................1-1
Programming possibilities...............................................................................................1-1
Differences between .app files and .img files....................................................................1-2
Add-file lists.............................................................................................................1-2
Pre-defined add-file slots ..........................................................................................1-2
Running programs via RunImg S3............................................................................1-3
Program files with and without icon files..................................................................1-3
Resource files and shell data files..............................................................................1-3
Customised add-files.................................................................................................1-3
Finding add-files within a .app file...........................................................................1-3
Multi-lingual applications ...............................................................................................1-4
Environment variables on the Series 3.............................................................................1-4
Avoid $ signs............................................................................................................1-5
Series 3 family compatibility ...........................................................................................1-5
Series 3/Series 3a/Workabout compatibility..............................................................1-5
Compatibility with Series 3c and Siena.....................................................................1-5
Programs written for the Series 3..............................................................................1-5
Programs written for the Series 3a ............................................................................1-5
2 Communicating with the System Screen...............................................................................2-1
Introduction.....................................................................................................................2-1
Creating .shd files ...........................................................................................................2-1
The format of .ms files..............................................................................................2-1
Default extension......................................................................................................2-2
Public name..............................................................................................................2-2
Default directory.......................................................................................................2-2
Application type numbers .........................................................................................2-2
Multi-lingual forms of .ms files ................................................................................2-3
Pure file list applications...........................................................................................2-4
Aliasing applications.......................................................................................................2-4
Creating .als files......................................................................................................2-5
Active aliasing and passive aliasing..........................................................................2-5
Active aliasing in the built-in text editor...................................................................2-5
How aliasing works ..................................................................................................2-6
Epoc reserved statics........................................................................................................2-7
DatProcessNamePtr (0x22).......................................................................................2-7
More on the file lists in the System Screen................................................................2-7
Assigning application buttons...................................................................................2-8
DatUsedPathNamePtr (0x3e) ....................................................................................2-8
DatStatusNamePtr (0x3c) .........................................................................................2-9
DatLocked (0x3a).....................................................................................................2-9
The Series 3 command line..............................................................................................2-9
Summary of command line format............................................................................2-10
Supplying a command line from the SIBO Debugger................................................2-10
From command line to reserved statics .....................................................................2-11
Applications that disregard their command line........................................................2-11
Creating directories when required ...........................................................................2-12
Messages from the System Screen....................................................................................2-12
Shutdown messages..................................................................................................2-12
Switchfiles messages.................................................................................................2-12
How messages from the System Screen are received..................................................2-12
Contents of the new command line for System Screen messages...............................2-13
Other possible types of messages...............................................................................2-13
Multi-lingual aliasing of Word.app...........................................................................2-13