Jargon Reader® for Pocket PC, Symbol, PSC,
Windows CE and Jargon 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.3.36 (Dec 15 2008) Requirements These versions of Jargon Reader can be run on the following devices: HP (Compaq) iPAQ http://www.hp.com/country/us/eng/prodserv/handheld.html Dell Axim http://www.dell.com/us/en/bsd/products/series_pda_snp.htm Hand Help Products (HHP) Dolphin 7900/9500 Series http://www.handheld.com/site.aspx/na/en/products/sbus/?sbu=2 Symbol PDT 8100 Series http://www.symbol.com/products/mobile_computers/mobile_pdt8100.html Falcon PSC 4220/4410/4420 Handhelds http://na.psc.com/html/f44104420.htm DAPtech CE8640 Handhelds http://www.daptech.com/products/ T-Mobile Pocket PC Phone Edition http://support.t-mobile.com/knowbase/root/public/tm21430.htm? Fujitsu 3500 Stylistic Pen Tablet with Windows 2000 http://www.fujitsu-siemens.com/rl/products/pentablets/stylistic.html Samsung i700 http://www.samsungusa.com/cgi-bin/nabc/prod/hhcommerce/telecommunications/sph_i700_features_verizon.jsp Samsung i730 (from Verizon) http://www.vzwshop.com/samsungi730info/ Intermec 700 Series Color Mobile Computer http://home.intermec.com/eprise/main/Intermec/Content/Products/Products_ShowDetail?Product=CMPTR700COLOR The Jargon PDA Emulator can be run on any PC or Tablet devices that uses the Windows 95/98/ME/NT/2000/2003/XP 32-bit operating systems. Other PocketPC, WinCE and Windows-based devices may work but are not supported until being qualified by Jargon Software. Only devices using ARM, StrongARM, and XScale processors have been qualified. If you have a device you would like us certify, please contact us. Summary of Changes in Recent Versions: More Components Increase components per frame from 50 to 150 on Windows Mobile devices. Run Other Programs Implement sys.OSExec(string cmd) for Windows Mobile. New Combobox Event and Methods Add new combobox event "ValueChangedEvent" and methods to remove selections and to get a list of selections. New Table Methods Add new table methods GetRowCount, GetRowText, RemoveRow, InsertRow, SetRowColors, SetCellColors, and ResetAllColors. New File System Methods Add new jsifile methods to open and read a file a line at a time, to help prevent fatal "out of memory" errors on Windows Mobile devices. Changes in Older Versions New System methods Quit, SetDefaultFont, SaveApp, PlaySound, LoadWaitCursor, LoadArrowCursor. Local File Append New client jsifile method to append data to a local text file. Host File Write/Append/Delete New host methods to write, append and delete files on local device SetFocus Methods Add SetFocus() methods for button, checkbox, combobox and table. Keyboard Support Support for keyboard operation without a stylus on Pocket PC devices Windows Mobile 5 Support for Windows Mobile 5 on Pocket PC devices Hide HTTP Stop Button New SetStopButtonVisible method for http requests Enable/Disable Methods Client and host enable/disable methods for all input objects Expanded Serial Port Support Support for all serial "COM" ports in serial port open method FTP Error Suppression New ftp method to suppress error message for missing file on Get FTP Return Status Changed ftp get/put methods to return success or failure of file transfer File Copy/Delete/Rename/Move Methods New "jsifile" methods to copy/delete/move/rename files File Read Method New jsifile.Read method to read local text or binary files File UUEncode Methods New jsifile methods: UUEncode, UUDecode, GetUUDecodedLen, GetSize Fixed Fonts New methods to specify and apply fonts to text components HTTP Buffer Size Increased http request (send) buffer from 35KB to 120KB Host Append Methods Implemented host methods to append to text component values Infrared Object/Methods New "irda" object and methods for using Infrared port International Language Support Support for multi-byte and Unicode character sets such as Korean Mag Card Readers New serial callback method runs when specified string is received Resize Components Implemented horiz/vert fill on all components System Timer Methods New sys methods to run callback function when a timer fires Table ActionEvent Double-clicking on a table row now fires the ActionEvent Tree and TreeNode Methods Support for all V2 tree and treenode methods and attributes Limitations: 150 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. 50 tables for all combined running apps (25 in versions 3.3.16 and older). http request (send) buffer of 120KB. (was 35KB in versions 3.3.10 and older) 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: Automatic Installation via ActiveSync Setup Program Cradle/connect the mobile device to your PC and verify that it is connected in ActiveSync. If zipped, unzip the setup program (xxx_setup.exe) on your PC . Run the setup program and accept all prompts on the PC and the mobile device. Manual Installation via Windows Explorer and ActiveSync Extract the ".exe" file from the installation zip file. These zip files are usually named something like "ReaderXXX_9_9_99.zip" where XXX is the platform abbreviation and 9_9_99 is the version number (example: ReaderPPO_3_3_32.zip). Platform abbreviations include: PDA - Jargon PDA Emulator (Windows PC version) 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) 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: Go to "Start", "Settings", "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 "Start In" property of the shortcut to ReaderPDA (if a shortcut is used), otherwise the folder where the actual ReaderPDA.exe is located. 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: Client Methods Host Methods for Java Host Functions for Microsoft ASP Host Procedures for Oracle PL/SQL Host Functions for PHP Scripts Host Methods for Progress 4GL (end of readme file)