Documentation Update

Product:   UTL Directory

Version:   08.02

Date:      April 25, 2008

Beginning with the 7.04 release, #FILES and .d00s are no longer supported by the
Reporter and Data Express.

Version 8.00 and above require Comet 2007.387 or higher and Comet Server Products 8.00 or higher in order to use DataExp. 1. DataExp A new SELECTING operator called CONTAINS has been added. KEYRANGE parameters will now automatically be enclosed in quotes if not done by the user. Added the ability to edit user-defined calculations. If output is to a spool a (SpoolMessage) is added to assist in identifying the job in QSPOOL. So as not to interfere with any PRINTER modifiers the user may have included, this is only done if no PRINTER modifiers already exist. Corrected a problem that could have caused a runtime error if the "indent" or "spaces" value was cleared or a non-numeric value was entered. Now verifies that the first character of a defined calc's field name begins with a letter. This is in support of the IB syntax requirements for variable names. A problem initializing the Printer combo box selection at startup when editing an existing report has been corrected. Now includes dynamically accessed dabs when starting a new Comet session. A new session is begun whenever the "DbMgr" or "Comet" buttons are clicked. 2. QReport In an effort to retire the QReport name, this program just runs the program DX which is the new Reporter launch pad utility. When ending, DX will attempt to run a program called RpgExit. You may write this program to direct the user back to your menu. If no RpgExit program is found, DX will return to QMONITOR. Added the name of the primary file to the information displayed for each report. 3. QReports A new SELECTING operator called CONTAINS has been added. It will match a string value occurring anywhere in the field. The margin overflow warning message is no longer issued if output is to LPH. Added retry loop if report is in use by another user. Previously a fatal error was issued. Added retry using different filename if CopyFile of .csv output file fails with access denied on the destination. This is to handle cases where the destination file exists and is currently open by another application. 4. DbMgr Corrected a problem that could have caused an endless loop when changing a field's size and requesting recalculation of other fields' positions. The "Convert spec files" utility now generates a log file.


Changes in previous releases: 8.01 1. QReports Corrected a problem that would generate an error if the first fieldname in a PRINT statement was just the continuation char (ie PRINT ;). 2. DataExp Corrected a problem that caused DataExpress.exe to crash if the UTL dir was configured using a UNC name. Report command files containing specs for more than one report are now rejected for editing. Corrected a problem processing a DEFINE statement if there were spaces preceding the length designator. 3. DbMgr Corrected a problem that was blanking out the fieldname in the dialog after changing one of it's attributes. E32 would follow in some circumstances. The "Generate Include File" utility now includes the position for each field in the generated FORMAT. This is important in case there are gaps of undefined bytes in the #CFILES description of the record. The columns of data are now lined up better in the generated include file. The "Import from FORMAT" utility corrects a problem that was listing .inc files twice. Also now has better handling of duplicate fieldnames. 8.00 1. QReport This has been completely redesigned. It is the launch pad for the Reporter and the new report editor, DataExpress.exe. 2. DataExp New front-end to the Reporter to assist you in designing and editing your reports. 2. DbMgr Added Data Dictionary search by actual filename to the Utilities tab. Output is sent to LPH. Improved performance of "Import from FORMAT" utility. 3. ViewMgr Added option to save the view as .ibr Reporter spec file. Corrected a problem that was preventing views from being accessed if one of them was an empty file. 4. QTILITY Changed default work directory to "TMP" from "RAM". Repaired the hyperlink to CED EDITOR repaired. It was broken in version 7.02. 7.04 1. New #CFILES replaces the .d00 files used as a Data Dictionary. A utility has been added to DbMgr to convert either the old #FILES or the .d00 files to the new #CFILES. Once converted, #CFILES will be used for DbMgr, ViewMgr, and the Reporter. 2. DbMgr The "Utility" tab contains a new program to generate #CFILES. A new "XML" button has been added to generate an XML representation of the data in a file. Optionally, the data from linked files may be included. The file is created in the $CATEMP folder. 3. ViewMgr The ExView.exe program that interfaced to Excel has been eliminated. Instead a .csv file is created and then launched. 4. DbLaunch Corrected problem that could have caused DbLaunch to get into an endless loop for non-CometAnywhere clients. 5. CmtHelpD A new lookup subprogram has been added as a replacement to the CMHELP table lookup program. This program uses a ListControl to allow the user to select the record whose primary key field will be returned to the calling program. Use of this facility requires #CFILES. The programmer's interface is defined in CmtHelpD.inc which can be found in the XTL release. 7.03 1. Changed all of the Data Express programs to transfer the .dll and any required .bmp files to the workstation so they can be loaded locally. Previously this was only done for CometAnywhere clients. 7.02 1. Removed CONDENS from QTILITY menu as it only supports file sizes up to 756. 2. ViewMgr Implemented new method for loading initial list box which could speedup the process. 7.01 1. DosCopy Eliminated E27 on "List" for keyonly files. 2. ViewMgr Column headings were being truncated at position 132 on the output when listing to a printer. This has been increased to 252. 3. The Reporter The version of the Reporter that uses .ibr spec files now recognizes the verb SPACES as well as SPACE. 4. QTILITY In the event that TERM$ has been cleared and is therefore invalid for a foreground partition, the QTILITY overlays will not be run.