Jargon Reader® for Pocket PC, Symbol, PSC, WinCE and PDA Emulator README File
Contents:
Requirements
Summary of Changes in This Version
Limitations
Installation in a Pocket PC or WinCE device
Using the IR Port
Usage
Custom Startup Menus
Client and Host Methods Supported
As of Version: 3.2.54 (Mar 20 2005)
Requirements
These versions of Jargon Reader can be run on the following devices:
Summary of Changes in This Version:
- System Timer Methods New sys methods to run callback function when a timer fires
- Support for Fixed Fonts New methods to specify and apply fonts to text components
- Support for Mag Card Readers New serial callback method runs when specified string is received
- New Infrared Object/Methods New "irda" object and methods for using Infrared port
- Expanded Serial Port Support Support for all serial "COM" ports in serial port open method
- Copy/Delete/Rename/Move Files New "jsifile" methods to copy/delete/move/rename files
- Component Resizing Implemented horiz/vert fill on all components
Limitations:
- 50 components per frame on PocketPC and WinCE platforms (300 on Windows PCs).
- maximum of 128 preference items ("ini" file parameters) per app.
- maximum of 10 levels of nested elements in XML files.
- 25 tables for all combined running apps.
- SSL receive buffer of 250KB.
- Maximum of 16 menu items that can be added to an app.
Installation in a Pocket PC or WinCE device:
-
Extract the ".exe" file from the installation zip file. These zip files are usually
named in the format "ReaderXXX9999.zip" where XXX is the platform abbreviation
and 9999 is the version number (example: ReaderPPC3247.zip).
Platform abbreviations include:
PPC - Pocket PC
PPO - Pocket PC with Oracle 9i Lite support
PSC - PSC Falcon 4220/4410/4420 running PPC/WinCE
Note: There is a special PSC4220 version for Falcon 4220.
SYM - Symbol running PocketPC or WinCE OS
SYO - Symbol running PPC/WinCE with Oracle 9i Lite support
WCE - Windows CE
WCO - Windows CE with Oracle 9i Lite support
WIN - Windows 32-bit OS (Win9x/NT/2000/XP)
PDA - Jargon PDA Emulator (Windows PC version)
- Using Windows Explorer on your PC, copy the .exe file and paste it into one of
these folders under Mobile Device\My Pocket PC:
\Windows\Start Menu
or
\Windows\Start Menu\Programs
depending on whether you want it to appear in the "short list" of apps
in the handheld menu that displays when you tap the "Start" icon. If you
put the exe file into Programs, it will be included in the Programs
sub-folder which requires another tap on the start menu to access it.
- Create a folder named "JargonSoft" under "Program Files"
- On handheld devices, Jargon Reader attempts to create a sub-folder
named "\Program Files\JargonSoft\cache" for saving application data.
On some devices, Jargon Reader may not be able to automatically create this
folder. If so, manually create a folder named "cache" under "Program Files\JargonSoft".
- When the "Program Files\JargonSoft\cache" folder is present, Jargon Reader
should save the state of each application and retain the last URL that
was entered into the startup menu.
Using the IR Port on Pocket PC
When using the IR port with Jargon applications, such as when using the
IR port to send reports to an IR-enabled printer, you may receive the error
message "error #5831: Invalid port" if the port is in use. To correct this:
-
In the Control Panel, within the "Connections" tab, tap on the "Beam" icon
and uncheck "Receive all incoming beams". This will close the IR port and
allow another application to open it.
Usage
- Start Reader.
- In the "Startup Page URL" field enter:
http://www.jargonsoft.com/V3/xml/demo32/menu.ini
- Press "Load".
- When the installed application listbox contains an entry named "menu"
select it and press "Run". This menu contains various examples of PocketPC
demo apps. The magic word for the db admin utility is "dba".
- Also, be sure to completely end programs running on a PocketPC or other
WinCE device. Simply clicking the "X" button minimizes the app, but does
NOT stop it. One of the handheld's mechanical button may bring up a task
list and you can end the process from there, or you can select
Start-->Settings-->System-->Memory-->Running Programs, and stop it from there.
Custom Startup Menus
- At startup, Jargon Reader will:
- See if an "ini" file is specified on the command line. If so, load it and run that app.
- If not, see if there is an ApplicationMenu.dom (cache file) already in the cache folder
- If not, see if there is an external ApplicationMenu.xml in a local folder
- The PDA Emulator version looks in the same folder as the ReaderPDA.exe.
- All handheld versions look in the "\Program Files\Jargonsoft" folder.
- If not, use the hardcoded default ApplicationMenu.xml that is built into
Jargon Reader.
- The ApplicationMenu.xml procedure must specify where to get the "ini"
file for each of the apps that can be run from it. Often the ApplicationMenu.xml
is used as a login or "start" window and the only app it runs is a menu
app.
There is a "baseURL" value that needs to be set to the web server folder
where the ini file is located (e.g. menu.ini) and that ini file will have
the normal 4 values that allow Jargon Reader to then load and run the menu.xml
(from the same folder on the web server).
- See the xml/JargonDemo directory in your Jargon Writer release for an example of
how to populate the "baseURL" from a host procedure. It can also be hardcoded into
ApplicationMenu.xml if you wish.
Client and Host Methods Supported
For a complete list of the client methods and host methods that are currently
supported for use with this version of Jargon Reader, see the following
documents:
Return to Version 3 Documentation Index
(end of readme file)