Release Notes for ASNA Monarch 4.0.61.0

Released to GA March 17, 2010

Software Requirements

• ASNA DataGate for System i version 8.0 or newer.
• ASNA Monarch Collector version 3.1.007.0 - Installation instructions for Monarch Collector can be found here: http://devnet.asna.com/documentation/Readme/Monarch40_Readme.htm#Installing_Collector

Installation Notes

If you install AVR 8.2 or AVR 9.0 on a computer where you have Monarch 3.1 installed, consider the following:

• You will need to upgrade Monarch 3.1 to Monarch 4.0. Follow the instructions provided with Monarch Cocoon 4.0 help for automatic or manual Gallery update.
• Monarch 3.1 Gameplans are not compatible with Monarch Cocoon 4.0. It is assumed that 2.1 gameplans are already migrated.

Features and Enhancements

Enhanced Cocoon Usability and Look

• New Cocoon Data Agent to migrate database files. Migrating Data Results are viewable in Cocoon in the Data Agent tab. You can also check the migration results outside Cocoon using the Cocoon Data Agent Data Viewer.
• New Database Files Graph and the ability to create a GamePlan from a Database File.
• Support of *UIM Menus as entry points for GamePlans.
• Support for web-modules project type (setting on GamePlan Directives).
• Support for migration of embedded SQL.
• Support of the RPG Cycle.
• Task Management
  • Separate task id's generated for each CL command or DDS display file keyword not supported
  • Summary list of tasks
  • Filters / advanced filters
  • New Effort based on filtered tasks
• User Column movement on data grids.
• Enhanced capability to set common directives when selecting multiple objects.
• New Missing Objects tab on the Gallery level.
• New capability to assist with the location of missing objects.
• Missing programs added to Cluster Details tab.
• Enhanced Object Library settings on *LIBL tab in the property panel providing three setting views.
• Automatic Gallery 3.1 to 4.0 Upgrade, which can also be run manually.
• User javascript can be included.
• There are numerous changes within this version of Cocoon that have simplified the renaming of certain fields and arrays and as a result of the cycle; a separate topic (.Net Printfile Field Name Changes) has been added to detail the changes for this version.

Monarch Framework

• Command.CallSilent can be used to invoke an interactive program from the yellow thread and prevent the displaying of the program’s display file in the browser. When the interactive program performs an EXFMT (or READ) it will stop waiting for input from the user; when this occurs, CallSilent will return the display file object allowing the caller to inspect the dataset containing the datatables of the record formats written by the interactive program on the blue thread.
• Command.PushKeyFocus can bae invoked from the yellow thread to provide input to a program in the blue thread waiting for input.
• DDS keywords SFLDROP and SFLFOLD supported with the addition of DdsSubfile properties SflDropKey, SflFoldKey, SflMode, SubfileDrop, SubfileFold, and DroppedRowHeight.
• Two new classes derived from DdsDataField are DdsTimeField and DdsTimestampField, which define a time and timestamp web control respectively.
• Support for embedded SQL includes the addition of:
  • Added to Program class: SqlQueryResults field, ExecuteSQL_Command and ExecuteSQL_CommandVerbatim methods, and ExecuteSQL_Statement and ExecuteSQL_StatementVerbatim methods.
  • New nested Program classes: DBParm, DBStrParm, DBScaledParm, SQL_CommunicationsArea, SqlCursor, and SqlPreparedStatement Class.
  • New Enumerations: SqlCursorFetchOrientations and SqlCursorScrollTypes.

Disk Files

• Cluster grouping of Database files for migration of data separate from the programs that utilize them.

DSS Display and Print Files

• New keywords: DdsTimeField and DdsTimestampField

DSS Keywords

The following are now supported:

• SFLDROP
• SFLFOLD
• SFLEND
• SFLMODE

AVR Compiler Support

• Support of the RPG Cycle with the addition of *StartCycle / *EndCycle, *FetchOverflow, BegCyclePrintAttr / EndCyclePrintAttr, HeadingSpec, DetailSpec, TotalSpec.
• In support of the AVR Cycle, DclDiskFile Designation keyword supports primary / secondary file designation.
• In support of the AVR Cycle, the Overflow indicator (IndicatorOF) is replaced by *INOF on the DclPrintFile OverflowInd keyword. The keyword field no longer needs to be declared.

Issues resoved since the last GA release (4.0.46.0)

Monarch Cocoon

• Case 11606. Migration of *INUx poluted with task 4067 ( un-supported "RT Indicator").
• Case 11619. RPG III - Overflow indicator "OBNxx" get RPG Agent confused when generating Except names .
• Case 11252. GetLdaField lenght doesn't match with local data area length.
• Case 11565. Line conditioned by un-supported indicator RT does not migrate correctly.
• Case 11441. Reading source members to produce Artifacts, TaskList and Migration is a lot slower than what it used to be on version 3.1
• Case 7776. Cluster Detail Export xml doc appears to be encoded as UTF-8, but marked as UTF-16.
• Case 11497. Missing Sources incorrectly reports all object types as *PGM.
• Case 11112. Export Program list from Gallery gives "Index was outside the bound of the array" error.
• Case 11471. Monarch Legacy Source tab cannot find source.
• Case 11333. Rectangle for Date Formats with type "L" not properly displayed on PFD.
• Fix related to Case 11224. Embedded SQL fails to migrate property.
• Case 11253. Changing regional settings from english(US) to Italian(Italy), increases Legacy Source font size.
• Case 10948. Colon on a MOVE gets RPG confused, for example MOVE *ALL':' D1P1 gets migrated as Move *ALL' D11P1.
• Change related to Case 10839. %LookupLE does not get migrated correctly.
• Case 11224. Embedded SQL fails to migrate property.
• Case 11217. Set Indicator "U" off is migrated as set indicator "U" on.
• Case 9759. Non numeric conditional indicators in lower case are incompletely migrated on headingSpecs.
• Case 11041. RPG Agent drops '*on' when evaluating overflow indicator. Fails when *InK is used on WHEN expressions.
• Case 11077. SetOff and SetOn are incorrectly migrated, adding *on and *off after the indicator
• Case 10875. Literal without apostrophe token in *TCAT is migrated as invalid variable.
• Case 10864. UPSI assignment in /Free is incorrectly migrated to GetSwitch.
• Case 10867. After computing the Task List, a dialog prompts to call the Migration Agents (again)?
• Case 10839. Free-form %Lookup zero-based adjustment migrated incorrectly.
• Case 7452. Library List in error message unreadable.
• Case 5421. .NET Print Files directives are changed once cocoon restarts.
• Case 10713. Message is migrated producing invalid XML file -- double quote inside TEXT needs to be escaped to "
• Case 6175. MigrateGameplan method in automation does not migrate message files.
• Case 10322. Unable to migrate message files. 4.0 - Writing the comment was broken, it attempted to include twice the <!-- and --> tokens.
• Case 1693O. Migrate option is enabled even when the Printer O-Spec is marked as no-migrate.
• Case 9250. The implementation for Case 10010 had a conflict with Character fields.
• Case 9594. If statement is getting dropped on *TotalCalc SubRutine.
• Case 9566. Added missing EndIf on *TotalCalc SubRutine
• Related to Case 8095. When migrating numeric fields, set the alignment property to "Right" aligned (as opposed to Left aligned). It was migrating with alignment right, regardless of EditWord on Printer O-Specs.
• Case 10010. Fixed decimal fields without editcode should be migrated as having editcode X
• Case 9715. Adden missing LEN keyword on properties that implement FIDS for Printfile current-line
• Case 9572. Printer O-Specs for Service Program cannot be accesed or migrated.
• Implemented Case 9715. Add support for Line numbers to INFDS for printfiles.
• Related to Case 9250. To avoid upper case label truncation - the calculations for average char width, when using fixed pitch fonts were improved.
• Related to Case 9714. Renaming of duplicate DATE or TIME are now reported as tasks.
• Case 9357. Printer O-Specs are silently dropped (not generated)
• Case 7994. TestN (Test Numeric) incorrectly migrated FLD Contents.
• Case 9611. Invalid edit code character
• Case 9673. Attached gameplan will not migrate: Object reference not set to an instance of an object.
• Case 7914. Migration agent not surrounding assignments with EVAL, when left operand is a reserved word.
• Case 8534. Missing *IN on Overflow Indicator.
• Case 9566. Added missing EndIf on *TotalCalc SubRutine
• Case 9443. DS fields that are overlaid on other Ds fields that are in turn overlaid on an array are not being recognized as arrays.
• Case 9419. Missing Control Level IF statements when migrating *TotalCalc subroutine
• Case 9371. Constants on O-Specs that use continuation line are migrated with spaces in the middle
• Case 9250. The bounding rectangle for UDATE was not migrated wide enough and when printing the output was truncated.
• Case 9357. Printer O-Specs are silently dropped (not generated).
• Improvements initially reported for Printfiles applied to Printer O-Spec migration. Note: A formula that we used to have to compute additional length based on edit code, was replaced by calling the method to format using editcode and edit word and then measuring the result.
• Case 9342. Printfile migration: Resolve duplicate usage of DATE, TIME.
• Printfile migration: UDATE, PAGE show data; Labels not truncated, Alignment of decimal field using edit code 'J'. Dates alignment to Left.
• Case 8095. Printfile and O-Spec migration: added exceptions to the alignment rules for decimal fields.
• Case 9373. When Printer O-Spec uses UDATE twice on the same format, the two Auto field generated have the same name.
• Case 8736. Improve fix for DDS (Printfile) with SPACEB(n) used after field causes extra row.
• Case 9336. UDATE and PAGE are now being migrated as Auto print control fields.
• Case 9337. Printfiles with PAGE and EditCodes: 4, L, Z are now formatted with Zero supressed and right aligment.
• Case 9296. When processing DDS constants, replace double single quotes, by one single quote.
• Case 9293. Avoid generating Xml comments with "--" (double-hyphen)
• Case 9180. Fix to: "Missing DB(monarchJob.Database) on OPEN command" in CL program migration.
• Case 8937. Log panel message: {0} files were not migrated. Reason: Timed-out waiting for base-files to complete copying.
• Case 9279. Change message "Use DataGate Manager to ..." with "Use DataGate Studio to ...".
• Case 9282. Fix to "Concatenating strings using the dash sign "-" will generates blank spaces after migration". This applies to I specs using CONST keyword.
• Case 8095. When migrating numeric fields, set the alignment property to "Right" aligned (as opposed to Left aligned).
• Case 9250. Several issues with how fields on Printer O-Specs are migrated.
• Case 8736. SPACEB(n) used after field causes extra row, whitespace in migrated print file.
• Case 7812. Unsupported CHKOBJ usage is not migrated
• Case 9143. Message Files escaping characters are not migrated properly.
• Case 9110. Change Target Platform from 'AnyCpu' to 'x86' to force execution as a Win32 application.
• Case 7914. Migration agent not surrounding assignments with EVAL.
• Case 8644. Changes to fix some unit-testing problems. This applies to the Collector new program only.
• Related to Case 8605. The first record of each message is now written to the output correctly.
• Related to Case 8605. The Xml element is now completely formatted.
• Related to Case 8605. The Collector now computes the xml correctly.
• Related to Case 8605. Changed the output file definition to match 100 bytes (record length)
• Related to Case 8605. Makefile updated to create new output file for MsgFRtv2
• Related to Case 8605. Added DDS definition for disk file MSGFRECS2
• Case 8605. Added new program to makefile
• Case 8605. New Collector program that optimizes the logic for the former MsgFReader program.
• Case 8186. Incorrect record name for ExceptSpec.
• Case 7914. Migration agent not surrounding assignments with EVAL.