This document provides complementary or late-breaking information as a supplement to the standard Jargon Writer documentation. Note that if there is a discrepancy between this document and Online Help documents or Readme files included with a release, this document is correct.

New Issues (not listed in latest release notes)

Known Issues

Release History

• Build 189
• Build 188
• Build 187
• Build 185
• Build 178
• Build 177
• Build 168-176
• Build 167
• Build 166
• Build 165
• Build 164
• Build 163
• Build 162
• Build 161
• Build 160
• Build 159
• Build 158

New Issues (not listed in latest release notes)
 

none

Known Issues

1. Java JRE 1.3 or higher is not supported. At present, JRE1.2 is the only supported Java version. Use of JRE 1.3 or 1.4 may cause various screen painting problems and other undesirable symptoms.
2. Can’t use a date in a constant condition parameter.
3. Table not validating when scrollbar is added.
4. Mask characters should not be case sensitive.
5. Button and menu mnemonics don't work while a maskfield has focus.
6. Focus problem when using editable comboboxes as table cell editors.
7. Cut/copy/paste not verifying container/component eligibility.
8. Some property changes do not take affect until the app is closed and reloaded: For the Table component this includes: ColumnWidth and ColumnTitle.
9. Need to prevent a component from occupying the grid space of another.
10. Not able to reselect a component after selecting a grid-based container.
11. Need to repaint component tree after a ListItem's text is updated.
12. Need to repaint task tree after up/down action from host param list.
13. The ".$$$" backup file is not being consistently created (due to a file lock by the XML parser).
14. Bug in encoding of URL name/value pairs for host params. If a field has a "%" character in the field name (like "disc-%"), the character is not encoded in the URL that is sent to the host, causing a WebSpeed error. It should convert it to the encoded value "%25" (where 25 is the hex code for the % character). A similar issue exists for other reserved characters defined in RFC 1738 (URL encoding specs).
15. Some client xml procedures that were converted from Version 1 "4jl" format to Version 2 "xml" format may have dropped the "common include" filename in host tasks when they were converted. To correct the problem, add the common include filename in the appropriate field in the properties panel of any host task in that client procedure, and regenerate the ".p" file.
16. The new table column header selection event ("columnSelectionEvent") can be used in Jargon Writer to associate a tasklist with this event. However, when test-executing an application using the Java-based Jargon Reader that is included in Jargon Writer, this event will not fire, due to lack of support for it in the Java 1.2 version that Jargon Reader uses. The event will work correctly when running the application in Jargon ReaderX, and can only be tested there.
17. For a complete list of additional known issues, see the Build 189 Release Notes document.

See the Build 189 Release Notes for a complete list of new features and bug fixes included in this release, plus known open issues, planned or requested new features, and known limitations. The following are highlights summarized from that document.

New Features:

1. New host method "jsi/combobox/addlist.i" allows adding combobox choices with a specified delimiter. Choosing a delimiter other than a comma thus allows choices that contain commas.
2. New "maxChars" attribute on text components allows limiting input to a specified number of characters in textfield, textarea and password components. If the value is -1 (the default) then any number of characters can be added.

Bug Fixes:

None.

See the Build 188 Release Notes for a complete list of new features and bug fixes included in this release, plus known open issues, planned or requested new features, and known limitations. The following are highlights summarized from that document.

New Features:

1. New options to use SSL encryption on all or selected host tasks
2. Math utilities for decimals
3. Table column headings as buttons with events
4. New features to send large tables as host task parameters
5. New host method to add items to a combobox in a table cell
6. Provide support for Netscape 6 and 7 in install files.
7. Remember which component has focus when frame reselected

Bug Fixes:

1. When sending all table rows in host task, empty rows cause data loss.
2. Vertical scrollbar is disabled on textpanes.
3. Host method "jsi/component/settooltiptext.i" not implemented.
4. Minus sign dropped when sending host task integer values.
5. Client method tabpanel.setSelectedIndex not implemented. Method should be "setTabIndex".

See the Build 187 Release Notes for a complete list of new features and bug fixes included in this release, plus known open issues, planned or requested new features, and known limitations. The following are highlights summarized from that document.

New Features:

1. New host methods to allow message box and warning box messages to contain commas.
2. New host method to add listbox choices containing commas.
3. New client method to add listbox choices containing commas.
4. New client method to change text of a table column heading for a specified column number.
5. New frame property "isCloseEnabled" (default 'true') allows suppressing the use of the "close" box on a frame. If set to 'false', this property grays out the 'X' button on the frame and removes the 'Close' choice from the frame's system menu. Works with both standalone and internal frames.

1. Pressing the "+" or "-" key in a selected decimal textfield will now clear the field contents.

Build 185

See the Build 185 Release Notes for a complete list of new features and bug fixes included in this release, plus known open issues, planned or requested new features, and known limitations. The following are highlights summarized from that document.

New Features:

1. Add the event "WindowDeiconified" to the frame component so the developer can run a tasklist when this event occurs, to perhaps repaint the frame or other actions.
2. The jsi/gettable.i routine has been rewritten to remove a limit of 2000 table rows that was a hard-coded value caused by using an array. The array has been replaced by an open-ended temptable. Users should extract the jsi.zip or jsi.tar file to their host system working directories and recompile all 4gl programs.

1. Pulling down combobox and close/reopen screen causes hangs
2. Applet hangs with java.security.AccessControlException during xml load
3. No error on invalid tasklist name in invoketasklist
4. Table cell edit masks cause trailing blanks on host tasks

See the Build 178 Release Notes for a complete list of new features and bug fixes included in this release, plus known open issues, planned or requested new features, and known limitations. The following are highlights summarized from that document.

New Features:

None.

1. When an existing tasklist which contains an "IF" task was nested inside another tasklist, without first editing the tasklist to be nested, the task editor was changing the "True" tasklist name in the "IF" task to a duplicate of the "False" tasklist name.

NOTICE: Starting with this build (177), release notes for each build will be kept in separate documents.

See the Build 177 Release Notes for a complete list of new features and bug fixes included in this release, plus known open issues, planned or requested new features, and known limitations. The following are highlights summarized from that document.

New Features:

1. Jargon Writer, Jargon Reader and Jargon ReaderX now provide native support for Oracle host environments, including a new set of "jsi" host procedures written in PL/SQL. Qualified platforms include Oracle WebDB (version 2.2) and Oracle Application Server (version 8i).
2. Added new tree and tree node components, with various client and host methods.
3. Added new "internal frame" feature to allow nesting multiple child frames within a parent frame, using the Microsoft Multiple Document Interface (MDI) standard, which includes the ability to maximize, tile or cascade the nested frames.
4. A new "methodlist" parameter in the system/preferences.ini file provides an option in the Task Editor to see one combined list of only those methods supported in all deployment products (Jargon Reader and Jargon ReaderX). This option is the default behavior. If the parameter is commented out, the Task Editor will list the multiple Java classes for a target object and all the methods in each class, as in previous versions.
5. New "utility" methods (used with the app "root" object):  app.openApp and app.showDocumentInTarget.
6. Textareas and textpanes can now have an initial text value that contains embedded newlines. This is done by entering the two-character string "\n" within the value.

Bug Fixes:

1. The install script no longer overwrites the "jw.jsf" license file and "preferences.ini" preferences file in the system directory if a new version of Jargon Writer is installed over an older version. This script should not overwrite these files if they already exist.
2. Various problems with table columns have been corrected, including alignment of column heading and contents with various data types, problems related to hidden table columns, and problems related to having two or more columns with the same column title.
3. Textfields with fieldType=Logical now use the defaultValue correctly and the client and host "displayText" methods now work correctly on such textfields.
4. Constant parameters in host tasks no longer only send the first character of the value.
5. Corrected a problem in the task editor, where if you renamed a tasklist, hostTask, or clientTask name from "AA" to "BB", and then tried to change the name back to "AA", it did not change it back, it left it as BB.
6. Made table method getDataFromAllRows work the same as in ReaderX. Now it only sends non-empty rows in host tasks.
7. The frame method setSize(int, int) was not working until the frame had been made visible.
8. Corrected a problem where you could not "null out" (delete) the text on a label once it had any character string in it. This was being caused by a default value in the Jargon Writer configuration files.
9. The table object now auto-scrolls when the user tabs to a column or row that is not in the visible area of the table.
10. The table initialRowCount no longer affects the generation of Progress source ".p" programs.
11. Changing the date edit mask to a shorter value no longer prevents an app from being opened.
12. Running the frame.dispose() method within Jargon Writer no longer causes all gridbag layout information to be lost.

New Features:

none

1. Character textfields with edit masks such as X(15) were returning a null value to the host task when the data length was exactly 1 character.
2. The InstallShield installation script was not creating a shortcut when the Start Menu program folder was not named "Programs".

New Features:

1. Enhanced the jargonapp.dtd configuration file to allow misc container to contain textfield, textarea, and checkbox components. This allows developers to put "hidden" fields into a misc container rather than using a "hidden frame" as was normally done before. This will create smaller xml app files and reduce runtime overhead.

1. "Save as" was not updating the value of target object names if the target was the App object.
2. The data type of a constant parameter in a client task was being changed incorrectly when editing the task in the Task Editor, if another parameter of that task's method used a subtask to get its value. The data type of the first constantParam was being forced to be the same as that of the first resultParam.
3. Added a new "title" preferences.ini item for the Jargon Writer frame title, to provide a visual cue as to which version of Jargon Writer is being run (useful if you have multiple "ini" files for working with different applications or hosts). For example, if you set title=AppSpeed Demo, the title bar would read "Jargon Writer - AppSpeed Demo".
4. The host method "invoketasklist.i" will now add the specified tasklist to a queue instead of invoking it immediately. This corrects a problem where any invoked tasklist that contained another host task could not be run on AppServer because of a "server busy" status.
5. An error message is now displayed if a save is done and the "save to" file is read only. Previously it would appear that the save had been done, but the file was not really saved, and there was no indication of this.

This build was not a production release.

Bug Fixes:

1. The host status animation routine (that displays the moving progress bar in the lower lefthand corner of a frame during host tasks) has been rewritten in an attempt to correct apparent problems that caused intermittent hangs during host communications.
2. If a table has a hidden column (visible=false), the "jsi/table/removeallitems.i" method did not clear the rightmost table column. The corresponding client method did not work correctly either.
3. The host method "jsi/component/setenabled.i" only worked with a literal 'true' or 'false', or with a character variable containing those exact strings (lowercase true or false, without any quotes or extra spaces). The method should be able to use a logical variable or table fieldname as a value, like jsi/checkbox/select.i and other methods do. It also should be able to accept 'yes' or 'no' values in addition to 'true' and 'false'. Finally, it should ignore any trailing spaces in the yes/no or true/false values.

Production release of build 163 with updated documentation files and encrypted "jsi" 4GL files.

This build was not a production release.

New Features:

1. More example applications in demo directory with examples of local tasks for font selection, math package, string manipulation.
2. New method: getTrimValue() method of JSITextField. Can be used to test for empty or blank value in a textfield in a condition task (local editing).

1. Can not requestFocus during FocusLost event.
2. Error caused by changing condition parameter from task to constant.
3. Message and progress bar is not consistently displaying on the active frame.
4. Component names are being truncated at 20 characters in generated 4GL code (length is now unlimited).
5. Spinner initial value not working.
6. Frame object needs color property.
7. Table not sending correct RowSpec parameter.

This build was not a production release.
 

1. There are two new options in the system\preferences.ini file:

#Enable/disable debug messages
Debug=off

The debug option, when turned "on" (it is "off" by default) will print many trace messages to the errorlog.txt file.

#Enable/disable the animated progress bar during remote tasks.
Animation=on

The animation option will enable/disable the animated progress bar during remote tasks, which may have been causing occasional hangs.

New Features:

1. Method for getting “.ini” parameter values
2. Show progress bar during save.
3. Ability to un-select a component from the toolbar.
4. Ability to override default delimiter for table getData methods.
5. Tab changed event on tab panel.
6. Add spinner component.
7. Methods to get string value of int and boolean return values.
8. Methods to get int or boolean value of string return value.
9. Methods to add/subtract a signed integer constant to an “integer” textfield value.
10. Method to get the current app name as a string value.
11. Method to get CSV list of all listitems in a combo box or listbox.
12. Error report to show system and JVM version info.
13. Method to append a string value to a textfield (like textarea has now)

Bug Fixes:

1. Ability to copy text from host console, error log, and error dialog box.
2. Multiple selection in grid caused by scrolling component tree.
3. Some layout properties are lost when component is cut and pasted.
4. Param.i needs “do: … end.” within AppServer block.
5. State Aware: test for AppServer and remove need for output.i (New include files)
6. Condition task constant data type does not change to match result task type.
7. Textarea not converting char 128/129 from AppServer. Revise to use different replacement characters for newline and pipe: chr(028) “FS” and chr(029) “GS”.
8. Make AppServer connection before running initial tasklist.
9. Report init.dtd file not found error.

This build was not a production release.

Bug Fixes:

1. Backup file when saving in Writer = appname.xml.$$$  Only created if something is changed in existing app, and not on original "save as". (OK - nothing to change).
2. Missing API help from task editor Help button for:  doc/api/com/jargonsoft/jfccomponents/text/JSIText.html
3. No "duplicates check" on host params. I can select a  component like "textfield0" multiple times as a    simple host param, and/or as a part of a business object.
4. Task tree doesn't repaint when host params are rearranged.
5. Image icon value will copy to another value if you:

   a) click in "Image" value to see filename and edit button
   b) without clicking the button, click in the next image
      value field (like disabled icon's value)
   c) the same image from normal icon will be copied.
6. Missing app doesn't get autoloaded when app1 has a host  task with params from app2, and you close  app2 and then edit the task again in the same session. Only works if you reopen app1.
7. Condition tasks are reversing param 1 and 2 after entry.
8. Condition tasks are setting both true and false tasklist names to be the same (either both trueTL or both falseTL).  Seems to happen after editing either the condition TL or editing one of the true/false TL's.
9. Newly added host params of a host task are being saved in the XML file without the "name=" attribute, so they don't load back in correctly on reopen, and then can't generate 4gl.
10. Populating a combobox from a host task (didn't test client) and  setting the selected index is causing an ActionEvent and running the associated tasklist. Should only respond to user selection.
11. When moving a component up/down within a container, focus is changing to the container after each move, which makes the user have to click on it again to move it another node up/down. Focus should stay on the component being moved.
12. Tooltips for comboboxes don't display unless you put cursor on the very edge of it (not in the middle).
13. If one app (app1) executes a local task that references some component in another app (app2), then the initial tasklist in app2 is not being run when it is first loaded/instantiated. It seems that the initial tasklist is only being run if the app is executed directly by Writer. Don't know if same is true in an app run strictly in Reader or not. The initial tasklist did run in this scenario in V1.
14. The Generate 4GL is using "jsi/getlogical.i" instead of the correct "jsi/getlog.i".
15. If you edit the name value of a component (like 'textfield0') and then decide to leave it the same, when you hit Enter it thinks there is a duplicate name and displays error 2072 ("component name already registered").

Bug Fixes:

1. Jargon Writer allows a component such as a panel to be added by using the "+" sign in the component tree, but this does not properly assign the necessary gridbag properties such as X/Y coordinates.
2. Generated 4GL programs do not handle table columns and business objects correctly.
3. Detachable/floatable toolbar can cause display problems if user clicks in unused area of the toolbar.
4. In viewing client tasks, if a target object is in an app that is not currently open, its node and method do not display in the target tree in the Task Editor.
5. Images aren't saved correctly.

Known Issues

1. Images aren't saved correctly. To correct this, edit the "system/preferences.ini" file and change the entry "MediaRootDir=.\images" to "MediaRootDir=images".
2. Can't open online docs. Try changing the BrowserCommand entry in system/preferences.ini to "start" or to the pathname of a local browser, such as "C:\Program Files\Internet Explorer\IEXPLORE.EXE".
3. Jargon Writer allows a component such as a panel to be added by using the "+" sign in the component tree, but this does not properly assign the necessary gridbag properties such as X/Y coordinates. Fixed in Build 159.
4. Generated 4GL programs do not handle table columns and business objects correctly. Fixed in Build 159.
5. The components toolbar can have display problems caused by clicking in the unused area of a component toolbar while moving the mouse. With Build 159, the toolbar is no longer detachable/floatable, to prevent this problem.
6. In viewing client tasks, if a target object is in an app that is not currently open, its node and method do not display in the target tree in the Task Editor. Fixed in Build 159.
7. Sports demo doesn't display correctly at 800x600 resolution. This was caused by resizing issues in two frames when the demo was converted from V1 to V2. Fixed in Build 159. Contact support@jargonsoft.com if you want us to email you a corrected copy of sports.xml.
8. There is no way to deselect (remove) an image file from any icon property once you have selected one - you can only choose a different one. The ability to deselect an image will be added in Build 159.
9. If the task editor window is minimized,  a "view-->task editor" does nothing. It ought to restore the frame. This is an known issue that remains open because standard java methods do not provide a way to detect a minimized window or restore it, without using platform-specific (native) methods, which go against the platform-independent philosophy.