Upgrade Guide - Prolifics

The f5upg UtilityVerbosity LevelThe verbosity level is set with the -v command line option. The -v option is followedby a number ranging from zero to three. When 0 is specified, only critical errors aredisplayed to standard error. Verbosity levels 1, 2, and 3 all provide increasing levels ofinformational messages about the progress of the conversion, the heuristics beingemployed, and the use of features which may be rendered obsolete in future versionsof JAM. These messages generally scroll to the terminal very fast, so if you need themit is recommended that output be directed to a log file.By default, the verbosity level is set to 1.Graphics ConversionThis is only of interest to JAM/Pi users. In that product, boxes and lines could bespecified as attributes of a given screen in that screen's JPL with the box, hline, andvline extensions. In JAM 6, boxes and lines are not attributes of screens, but screenobjects in their own right. The -g option controls how these JAM/Pi extensions areconverted.Specifying -gN merely throws away those graphic objects. Depending on the verbositylevel, when f5upg encounters the JAM/Pi extension for a box or line in a screen JPL,a message is printed to standard output warning the user that the extension could notbe converted. This is the default.Specifying -gS attempts a simple conversion of those graphic objects. In JAM/Pi,boxes and lines were drawn between grid units on the screen for positioning purposes.In JAM 6, since these are objects in their own right, they take up grid units. As a result,this simple conversion will likely require subsequent manual manipulation in theeditor to properly position the graphic element in question.Keep JPL Extensions AroundBy default, f5upg removes any JAM/Pi extensions found in screen or field JPL beforewriting out the output screen. If the -k command line flag is specified, the utility leavesthose extensions there. This does not harm the JPL, since the extensions are treated as4-16 Upgrading to JAM 7 from JAM 5