Upgrade Guide - Prolifics

The f5upg UtilityConversion of Menu Arrays to List BoxesBy default, as mentioned above, JAM 5 menu fields are converted to push buttons.This is not necessarily optimal if your application had menu arrays, in particularscrolling menu arrays. If you specify the -l command line flag, all menu arrays areconverted to list boxes rather than push buttons. Any single non-scrolling menu fields(not part of an array) are still converted to push buttons, even if -l is specified. (Anon-scrolling list box with one element doesn't make sense).Please be warned that the way JAM menu fields work means that their conversion tolist boxes will likely cause them to operate in a way that is slightly different from mostGUI standards. This is why the -l option is not the default behavior.Note also that if there are JAM/Pi extensions specifying widget type, this option willbe overridden for that field.Conversion of BordersIn JAM 5, screens were created without borders by default. JAM/Pi screens, on theother hand, had borders unless the JAM/Pi extension noborder was set in the screenJPL. JAM/Pi users might, therefore, have created JAM screens without ever givingthem borders and enjoyed the experience of the screens with borders nonetheless.By default f5upg only designates a border for the JAM 6 screen if there was a borderspecified in the JAM 5 character mode instantiation of the screen. However, if you setthe -b command line flag, f5upg gives all screens a border even if the character modeJAM 5 screen did not have one. Only those screens marked as noborder will, in fact,not have a border.Conversion of Onscreen Control FieldsUnder JAM 5, the typical configuration of a menu involved a field (or array) with themenu bit set followed immediately on the screen by a corresponding field (or array)which held a control string. These control fields, usually hidden from view, were fieldsin their own right, and had field numbers, and could be accessed via the sm_getfieldand sm_putfield. This was not the only way menu fields could be used, however.4-18 Upgrading to JAM 7 from JAM 5