OPENworkshop®/Dictionary-IV™ 8.6.0
Release Notes
Throroughbred Software logo


Enhancements

General |  Formats |  Screens |  Views |  Links |  Report-IV™ |  Script-IV™ |  Source-IV™

General [up]

  1. Reference: OPENworkshop Exit Method
    4GLE OMSC 0157


    An enhancement has been made to support a RUN of a OPENworkshop Exit method from the OO Menu. This allows the developer to RUN a OPENworkshop Exit method from OO menu rather than the usual way of CALLing a OPENworkshop Exit method and returning to the current popup menu.

    This process can be enabled by setting the global variable 'timeoutrun' to the value 'Y' in a StartUp Method.
    A$=CGV("timeoutrun","Y")
    When the OPENworkshop Exit occurs from the OPENworkshop Popup Menu, and if this global variable is set accordingly, the OPENworkshop Exit Method name in the Operator Code/Installation Record will be RUN instead of CALLED.

    An example of this may be the desire to RUN the UTLOGIN program when a timeout occurs. This forces users back to the IDOL-IV Login screen.

Formats [up]

  1. Reference: Format Maintenance View
    4GLE FMT 0156


    The Format Maintenance View will now display the Format description.

Screens [up]

  1. Reference: CONNECT SCREEN Help
    4GLE CSCR 0169


    A new Yes/No Flag has been added to CONNECT SCREEN.
    
        (9,1) Skip F7 Special Functions Menu
              "N" - The Screen Special Functions menu is displayed
              "Y" - The user is taken directly to the Help Type toggle menu without first
    displaying the Special Functions Menu.

Views [up]

  1. Reference: F8-List SELECT WHEN
    4GLE CVF8 0011


    A new option has been added to CONNECT VIEW to support a secure SELECT WHEN clause in VIEW$[7]. The secure select clause provides the developer with the ability to control what records are displayed in the view while preventing the user from changing or seeing the secured SELECT WHEN. A secure SELECT WHEN is never displayed in the F8-List Selection screen.

    The user retains the ability to enter a SELECT WHEN clause. The user defined SELECT WHEN will be appended to the 'hidden' secure SELECT WHEN clause.

    The secure select clause is enabled by setting VIEW$[13](8,1)="Y".
    
    3GL Example:
         DIM VIEW$[13];
         VIEW$[1]="OEVCUST",
         VIEW$[7]="SELECT WHEN #OEFCUST.SR-CODE ="+QUO+"HP"+QUO,
         VIEW$[13]="       Y";
         CALL "OO3A",VIEW$[ALL]

    4GL Example: DIM VIEW$[13] LET VIEW$[1]="OEVCUST", VIEW$[7]="SELECT WHEN #OEFCUST.SR-CODE ="+QUO+"HP"+QUO, VIEW$[13]=" Y" CONNECT VIEW "OEVCUST"
    For more information on the VIEW$[ALL] array please see the online help: CONNECT HELP, CONNECT VIEW, VIEW MSG array.

  2. Reference: F8-Commands
    4GLE CVF8 0012


    Three new options have been added to the View F8 Command menu.
    • Chart: This option allows data currently displayed in the View to be plotted graphically using Thoroughbred's TS ChartServer product. Numerous options are available such as custom chart title, X axis orientation, numeric column selection for the X-axis, custom X-axis legends, Sum By Clause, custom data set label, maximum and minimum data sets per chart, and chart type (including area, bar, graph plot, pie and stacked bar).

    • Export: This option exports the data currently displayed in the current View to a .txt file. The file is created in the default data file directory defined by #IDSV.DISK.NBR-DATAFILES.

    • Excel: This option exports the data displayed in the current View to an Excel spreadsheet on the Windows workstation using Thoroughbred's Gateway for Windows product. The data to be exported can be refined by specifying a SORT, RANGE From/To, and a SELECT WHEN clause.

Links [up]

  1. Reference: General Links
    4GLE LINK 0093


    The Script-IV compiler has been modified to use OPT="DLINK" for Links containing sort files. The Script directives OPEN LINK, OPEN LINK DATA-FILE, and OPEN LINK SORT-FILE will now compile with the appropriate OPT="DLINK" option. The data and sort files are opened by the Basic runtime engine. All secondary keys are maintained by the Basic runtime engine. This enhancement generates more efficient compiled Script code.

    In addition OPEN LINK has been modified to always call the File Suffix Method when one is defined in the Link. The File Suffix Method takes precedence over the FILE-SUFFIX variable.

    For more information on OPEN OPT="DLINK", please see the Basic Language Reference (F-Q).

    IMPORTANT: The implementation of OPT="DLINK" requires the use of LINK ALIAS (LA) when re-using the same LINK (LN) for varying sort sequences, since this may affect the internal key pointers. Previously there were two channels; one for traversing the Link by primary key and a second for traversing the Link by secondary key. Although not recommended, this allowed the Script developer to READ and UPDATE the same LN with various SORT values without impacting the current key pointer. With OPT="DLINK" the Basic runtime engine will use a single channel for traversing the Link by both primary key and all sort keys. For this reason it is not safe to assume that the same LN can be reused for various functions if maintaining the current key pointer is critical to the Script logic. With 8.6.0 it is important that your Scripts maintain the proper channel context. We strongly recommend using the LA as it had been intended and not relying upon an understanding of the underlying Script code in order to achieve the desired result.

  2. Reference: General Links
    4GLE LINK 0094


    A new Link Integrity Check option has been added to the Upgrade Administration menu. This must be run as part of the upgrade process (in addition to the Rebuild Sorts option). Previously Link headers might contain fields padded with $00$s. This utility will replace $00$ with $20$. In addition this utility will perform various integrity checks. The results can be viewed in the Link Integrity Log View.

  3. Reference: General Links
    4GLE LINK 4GLE LINK 0097


    A new option has been added to Link Maintenance to perform an integrity check and a clean up of secondary key files. To access this option, from Link Maintenance press F5 on the data file name. Any extra secondary keys are removed, any missing secondary keys are added. This test is repeated until no more errors are found. This can be run without requiring exclusive use of the data file.

Report-IV [up]

  1. Reference: Error Reporting
    4GLE REPT4 0407


    Report-IV has been enhanced to use the standard OPENworkshop error reporting process.

Script-IV [up]

  1. Reference: Compiler
    4GLE SCRP 0064


    The Script-IV compiler has been enhanced to support global variable ]PFX$ with OPEN LINK NEW and OPEN LINK CREATE directives. For more information please refer to the Script-IV online help.

  2. Reference: Compiler
    4GLE SCRP 0071


    The OPEN LINK directive always executes the File Suffix Method defined for the Link. When opening a file with OPT="DLINK" the Basic engine always executes the File Suffix Method. In previous releases compiled Script code executed the File Suffix Method and this occurred only when a File Suffix was defined for the Link. Starting with this release the execution of the File Suffix Method is no longer dependent upon the presence of a File Suffix definition in the Link. This is also true for the CLOSE LINK ERASE directive.

  3. Reference: File Suffix
    4GLE SRPT 0334


    Script-IV will now always honor ]PFX$ set by the File Suffix Method. In addition the on line help for both ]PFX$ and File Suffix Method have been updated and corrected.

Source-IV [up]

  1. Reference: Editor
    4GLE SRC4 0117


    The Source-IV Editor has been modified to support some F7 Special Functions when a source module is locked. If a source module is locked and loaded for "Display Only", a limited F7 menu will display allowing:

    Edit session history: Select this option to view the edit session history for the source module. This includes an Undo option. When selected the edits will be rolled back for display only. The source cannot be saved.

    View source locks: Select this option to view all source locks for the current library.

    Compile errors view: Select this option to display the Compile error view.

  2. Reference: Compiler
    4GLS MISC 0056


    Source-IV has been enhanced to erase all copies of a compiled program accessible from the IPL DEV lines. This feature is enabled by default. It can be modified at the operator code level. From the main Source-IV menu select Compile Menu then select Compile Options. To disable this feature set Erase Programs to "N". If this parameter is not set the default value of "Y" will be applied when source is compiled.

Changes [up]

General [up]

  1. Reference: General
    4GLE MISC 1847

    If the disk numbers set for data files (Link UTDATFIL) and work files (Link UTWRKFIL) are not defined in IPLINPUT DEV lines, a critical warning message will be displayed and the user will be instructed to log off immediately.

    This could happen if the Links are incorrectly modified or if the IPLINPUT file is modified and no longer contains a DEV entry for the required disk numbers.

  2. Reference: Open Printer
    4GLE 80NP 007


    A problem with the 8OPENP online help has been fixed. The example contained an incorrect CALL statement to close the printer.

  3. Reference: Open Printer
    4GLE 80NP 009


    A problem where passing a DEV line to 8OPENP in PT$[5] would cause an ERR=17 has been fixed.

  4. Reference: Documentation
    4GLE MISC 1848


    The Dictionary-IV Administrator Guide has been updated to include information on how to set the default work and data file disk numbers in Links UTWRKFIL and UTDATFIL.

  5. Reference: File Suffix Method
    4GLE MISC 1851


    A problem where ]PFX$ (File Suffix Global) was not being set after calling a File Suffix Method has been fixed.

  6. Reference: Global Xreference
    4GLE OMSC 0156


    A problem where the global xreference scan of Methods was skipping Formats that contained numeric values has been fixed.

  7. Reference: Online Help Message Dictionary
    4GLE 8MSG 001


    The online help for defining messages in the Message Dictionary has been corrected. When entering a Valid Value List for a Scroll type message, the sequence of the Valid Value List must match the sequence of selection items in the scroll list.

    For example:
    Message text: |A-Selection||B-Selection||C-Selection| VVList: 0ABC or 0ABC:123 or 0ABCabc:ABCABC

  8. Reference: Error Log Purge
    4GLE MISC 1859


    A problem where the OO Error Log automated purge did not remove all text records has been fixed.

  9. 4GLE MISC 1862
    Reference: Backup/Restore Utility


    Several changes have been made to the Backup/Restore utility that are related to VIP GUI screen definitions.

    A problem where under some circumstances it was incorrectly reported that the IDDbk and the IDDbkVIP files were out of sync, has been fixed.

    A problem where in some cases the utility reported an ERR=13 if IDDbkVIP was expected and not found, has been fixed.

    In some cases the GUI pointers in the screen header were not correctly updated. To fix this problem, please run the 8.60 Dictionary Update utility.

    Note: Although this is not an OPENworkshop issue, it is being documented here.

  10. 4GLE MLAG 0022
    Reference: Multi-Language Conversion Utility


    A problem converting screen definitions from one language to another has been fixed. In some cases it would generate an ERR=14 on line 100 in 8ZUT01.

Help [up]

  1. Reference: CONNECT HELP
    4GLE CHLP 0001


    A problem where the HELP$[3] was not returning the menu selection for type .MN. help definitions has been fixed.

Menus [up]

  1. Reference: OPENworkshop Pop-up Menus
    4GLE MENU 0154


    A problem where pop up menus (.MN.) with zero entries would generate errors has been fixed.

  2. Reference: IDOL-IV Menus
    4GLE MENU 0155


    A problem where IDOL-IV Exit Messages would generate an ERR=10 has been fixed. In addition the Dictionary-IV Administrators Guide and the Dictionary-IV on-line help have been corrected to include a remark explaining that exit messages do not work with a menu selection type "M".

Messages [up]

  1. Reference: Online Help Message Dictionary
    4GLE 8MSG 001


    The online help for defining messages in the Message Dictionary has been corrected. Note: When entering a Valid Value List for a Scroll type message, the sequence of the Valid Value List must match the sequence of selection items in the scroll list.

    For example: Message text: |A-Selection||B-Selection||C-Selection| VVList: 0ABC or 0ABC:123 or 0ABCabc:ABCABC

Mouse [up]

  1. Reference: Mouse Visuals
    4GLE MOUS 0005


    A problem where the mouse visual were not displaying for CONNECT SCREEN, PRINT SCREEN, and INPUT SCREEN has been fixed.

  2. Reference: Headings
    4GLE MOUS 0006


    The ability to edit View headings by clicking the mouse on a heading row has been disabled except for developers and View super users.

  3. Reference: Date Masks
    4GLE MOUS 0009


    A problem where date fields were not masked correctly when moving off a date field by F10 or clicking the mouse has been fixed. This was a problem in character mode and when VIP was enabled.

  4. Reference: Mouse Clicking
    4GLE MOUS 0011


    A problem where using the mouse to move from field to field on a screen with formulas did not work properly has been fixed. This was a problem with INPUT SCREEN but not with CONNECT SCREEN.

Printing [up]

  1. Reference: Printing
    4GLE PRNT 0002


    A problem where the Print error timeout was incorrectly set to 30 seconds has been fixed and is now set to 10 seconds.

Query-IV [up]

  1. Reference: F8-Query
    4GLE QRY4 0041


    A problem where doing F8 - Query from within a View could cause an ERR=47 or an ERR=46 has been fixed. This was only a problem when the Query-IV Operator Preference File Lookup Mode was set to "S".

  2. Reference: Range
    4GLE VIEW 0077


    A problem where in some cases Query-IV did not honor the range selection has been fixed. This was only a problem from a View "List" option when a range value had been entered and subsequently Query-IV was run from the View F8 menu.

Report-IV [up]

  1. Reference: Dates
    4GLE RPT4 0397


    A problem with date type 2 where date mask "MM/DD/YY" would display the century instead of the year has been fixed.

  2. Reference: Report-IV with DataServer
    4GLE RPT4 0399


    A problem where ".ReportName" or the "R" option on IDOL-IV menus did not work when the data files are on a DataServer, has been fixed.

  3. Reference: General
    4GLE RPT4 0401


    Error reporting has been improved when Report-IV encounters a bad Link definition.

  4. Reference: Dates
    4GLE RPT4 0402


    A problem displaying type 2 dates has been fixed. Date masks for type 2 dates was not being generated correctly when IM=DDMMYY, DM=DD/MM/YY, Y2KBASE = 1900 and CNF 1,26,1,90,,0,0,D. In addition the Report-IV editor used the IDOL-IV/OPENworkshop system mask as a default and at run time generated a default mask based on the IPL CNF line. At runtime Report-IV will now generate a default mask using the IDOL-IV/OPENworkshop system display mask.

  5. Reference: Compiler
    4GLE RPT4 0408


    A problem where an ERR=46 occurred when /RL=0 appeared in very large reports has been fixed.

  6. Reference: Compiler
    4GLE RPT4 0409


    A problem where Report-IV would attempt to print invalid mnemonics has been fixed.

  7. Reference: Compile
    4GLE RPPH 0001


    A problem where the NUM and NTD functions did not compile correctly has been fixed. For example the following:
    IF NUM(K$(1,6))>0 L$(1,8)=NTD(NUM(K$(1,6))

    Compiled as:
    IF N>0 L$(1,8)=NTD(NUM(K$(1,6))

  8. 4GLE MLAG 0023
    Reference: Multi-Lang Report Definitions


    Several Multi-Language problems compiling and running Report-IV definitions have been corrected.

  9. 4GLE RPT4 0398
    Reference: Compile


    A problem where blank dates did not compile correctly has been fixed. The following would fail if DATE1 and DATE2 where all spaces and were both defined as a date type 8.

    
    CB01C     IF NUM(STRING_FIELD)=0 THEN
    :              LET DATE1 = DATA2
    

Screens [up]

  1. Reference: Screen Maintenance
    4GLE SCRN 0172


    A problem where deleting a screen definition did not remove all screen detail records from the Dictionary has been fixed.

  2. Reference: PRINT SCREEN
    4GLE SRPT 0343


    A problem where PRINT SCREEN did not use the DM date mask for date type 3 fields has been fixed. PRINT SCREEN DATA displayed the date as DDMMYY instead of the mask specified in DM=.

  3. Reference: CONNECT SCREEN
    4GLE CSCR 0161


    A problem with logical screens where a Pre-Process required a second input for the user has been fixed.

  4. Reference: CONNECT SCREEN Help
    4GLE CSCR 0162


    A problem where Application Help and Application Help override values were not working when doing a CONNECT SCREEN to a logical screen has been fixed. Logical screen processing did not support the F7 Screen Special Functions menu, which is how Application Help is activated.

    Please refer to the updated CONNECT SCREEN online help SCREEN$[14] (OOHCN04) for an explanation of Application Help, Data Help and General Help.

  5. Reference: CONNECT SCREEN
    4GLE CSCR 0164


    A problem where invalid mask errors were incorrectly being generated when CMASK was set to anything except a period (.) and when there was no fractional part to a number has been fixed.

  6. Reference: CONNECT SCREEN
    4GLE CSCR 0168


    An Error 47 Post Process date field has been fixed where:
    • The format has a date type 5 len 4,

    • IM=DDMMYY and DM=DD/MM/YYYY,

    • The date field is the last field in the format, and

    • The data field has a valid Post Process and you move off the field.


  7. Reference: SCREEN$[ALL] Documentation
    4GLE CSCR 0170


    A correction has been made to the documentation of SCREEN$[7]. The screen CONNECT message entry did not clearly state that "AUTO-EXIT" is the only valid CONNECT message for screen processing.

  8. Reference: CONNECT SCREEN Date Fields
    4GLE SCRN 0177


    A problem where an ERR=47 in OO22Z occurred when using F10 GOTO or the mouse to move off of a date field that had a Pre-Process or a Post-Process, has been fixed.

    Note: This same error may have occurred with any field where the input size did not match the storage size.

  9. Reference: Screen Maintenance/Format Maintenance
    4GLE SCRN 0188


    A problem with both Screen Maintenance and Format Maintenance where an ERR=47 attempting to parse A3$ has been fixed. This could happen when either adding new fields or a Format or when attempting to load a Screen definition. This would only happen when our internal mask table was exactly 255 bytes in length. Existing problem screens can be corrected by resaving them in the screen editor.

  10. Reference: Screen Maintenance
    4GLE SCRN 0189


    A problem where selecting F5 on an input field and then responding "N" to the save option would result in an ERR=47 in OONSC0, has been fixed.

Script-IV [up]

  1. Reference: Compiler
    4GLE SCRP 0065


    A problem where CTL was not compiling correctly since the introduction of the SET CTL directive has been fixed. For example the following Script-IV syntax did not compile correctly:

    DO LOOP WHILE TEST=TEST AND CTL <> 4

  2. Reference: Compiler
    4GLE COMP 0020


    A problem where OPEN LINK ERROR process was not being compiled correctly has been fixed. For example the following Script-IV syntax did not compile correctly:
    
    LET FILE-FOUND = "Y"
    OPEN LINK MYLINK
       ERROR FILE-NOT-FOUND
    

  3. Reference: CHANGE TEXT
    4GLE SCRP 0066


    A problem where CHANGE TEXT did not create the text window at the correct location has been fixed. The location of the text window had been off by one character.

  4. Reference: Compiler
    4GLE SRCP 0017


    A problem where SET CTL and DO LOOP WHILE CTL <> 4 did not compile correctly has been fixed.

  5. Reference: Compiler
    4GLE SRCP 0019


    A problem where the timeout option was still prompting for user input under some error conditions has been fixed. If OPENworkshop Exit is set to 0,0,N (do not display compiler errors while in progress) during FORMAT verification, the compiler would put up an error message requiring a response.

  6. Reference: Compiler
    4GLE SRCP 0020


    A problem where an incorrect error branch was generated for COMPILE AS has been fixed.

  7. Reference: Compiler
    4GLE SRPT 0342


    A problem where in some cases the text file name was not compiled correctly has been fixed. This was only a problem when the data file names were longer than 8-characters and the data file name contained "/".

  8. Reference: Compiler
    4GLE MISC 1849


    A problem with the saving and restoring of #IDSV.FILE-SUFFIX has been fixed.

  9. Reference: Compiler
    4GLE SRCP 0023


    A problem where an ERR=46 occurred when a Script contained a very large number of data names, has been fixed.

  10. Reference: Compiler
    4GLE SCRP 0023


    A problem where an ERR=46 occurred when a Script contained a very large number of data names has been fixed.

Source-IV [up]

  1. Reference: Editor
    4GLS MISC 0055


    A problem where a help text was incorrectly pasted into the source has been fixed.

  2. Reference: Editor
    4GLE SRC4 0111


    A problem where an F4 out of Search and Replace would exit without saving changes made by Replace has been fixed. If "Verify" is on, the Search and Replace continues, if "Verify" is off, the Search and Replace terminates.

  3. Reference: Source Update Utility
    4GLE SRC4 0112


    A problem where the Source Update Utility could generate an error attempting to CLOSE(C2), when C2 is not a valid open channel, has been fixed. The Source Update Utility is used when upgrading from early versions of Source-IV to convert all Source-IV dates in date type 8 format.

  4. Reference: Editor
    4GLE SRC4 0114


    A problem where F7 to View Edit History from a Source-IV bk file would sometimes fail to display any edit history has been fixed.

  5. Reference: Editor
    4GLE SRC4 0116


    A problem where an ERR=47 occurred while doing a ChangeUndo on very large statements has been fixed.

Views [up]

  1. Reference: Sorts
    4GLE VIEW 0079


    A problem with Views where using a reverse sort option and hitting a busy record would cause a hang has been fixed.

  2. Reference: F8 List
    4GLE CVF8 0010


    A problem where the F8 List options were not always being cleared has been fixed. This was only a problem when drilling down through different views that referenced the same format definition.

  3. Reference: F7 Edit Format
    4GLE CVIE 0322


    A problem where an Edit Format option has been selected from F7 in a View would cause an ERR=94 has been fixed.

  4. Reference: CONNECT VIEW Text Fields
    4GLE TEXT 0050


    A problem where the data entered in a text field would be lost has been fixed. This could happen when adding a new record, entering text and then changing the key before moving off the row.


Copyright ©2007 Thoroughbred Software International, Inc. Unauthorized use is prohibited.