Jargon Reader® for Windows
README File

Contents: Requirements Summary of Changes in This Version Limitations Installation in a Windows PC Usage Custom Startup Menus Client and Host Methods Supported As of Version: 3.3.36 (Dec 15 2008) Requirements Jargon Reader for Windows can be run on the following operating systems: Windows 95 Windows 98 Windows 98SE Windows ME Windows NT Windows 2000 Windows 2003 Windows XP Windows Vista Summary of Changes in This Version: 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 New sys Quit, SetDefaultFont, SaveApp, PlaySound, LoadWaitCursor, LoadArrowCursor methods. 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. 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 Starting Folder for Open/Save Specify starting folder for GetOpenFileName etc.(Windows only) Frame Resize/Reposition New frame method to change its size and/or position (Windows only) Limitations: 300 components per frame. 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. (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 Windows PC: Automatic Installation via Microsoft Installer Program If zipped, unzip the MSI installer program (xxx.msi) on your PC . Run the setup program and accept all prompts. Manual Installation via Windows Explorer Select an installation folder and create it if it does not already exist. A suggested default install folder is: "C:\Jargonsoft\ReaderWIN". 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: ReaderWIN_3_3_32.zip). Platform abbreviations for Windows include: WIN - Windows 32-bit Operating Systems PDA - Jargon PDA Emulator for Windows PC Copy the .exe file to the selected install folder. Right-click the .exe file and select Send To-->Desktop (Create Shortcut). Note that the first time the Reader executable is run, it will create a folder named "cache" in the same folder where the exe is located. This cache folder contains ".dom" files for each app that allow for quicker startup and that retain each app's "state" information (such as component contents). To automatically load and run a specified app, right-click the shortcut and select Properties. Modify the "Target" startup command by adding a local pathname or remote URL that specifies a ".ini" file, after the .exe filename. This works with both ReaderWIN and ReaderPDA. Here are several examples of different ways to do this: C:\Jargonsoft\ReaderWIN\ReaderWIN.exe http://www.jargonsoft.com/v3/xml/demo32/menu.ini C:\Jargonsoft\ReaderWIN\ReaderWIN.exe C:\Jargonsoft\xml\demo32\menu.ini C:\Jargonsoft\ReaderWIN\ReaderWIN.exe ../xml/demo32/menu.ini Usage Click on the shortcut to start Jargon Reader. To see an example of a ReaderWIN app, in the "Startup Page URL" field enter: http://www.jargonsoft.com/V3/xml/util/dbwin.ini Click "Load". When the installed application listbox contains an entry named "dbwin" select it and click "Run". This "dbwin" app is a simple database schema and data browser. This example is connected to a copy of Progress Software's "Sports2000" demo database. 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 the same folder as the "Start In" property of the shortcut to ReaderWIN (if a shortcut is used), otherwise the folder where the actual ReaderWIN.exe is located. 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. The sample custom ApplicationMenu.xml provided with Jargon Writer has a "baseURL" value that needs to be set to the web server folder where the ini file is located (e.g. menu.ini). 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 folder 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)