Upgrade Guide - Prolifics

The f5upg UtilityThe reason for this difference is that conversion of JAM screens in earlier versions ofthe product was a deterministic operation. In other words, there were no conceptualshifts in how JAM dealt with objects from version to version, so the conversion utilitiesmerely had to map one binary representation of a concept into another. For theconversion from JAM 5 to JAM 6, the process is not strictly deterministic, but mustuse various heuristics specified by the user as command line options to effect thedesired conversions. It is possible that you will need to use different combinations ofcommand line options for different screens in the application you are converting,although in all likelihood most of your screens will be converted the same way.Although it is possible with f5upg to specify the same file name for input and outputand consequently overwrite your JAM 5 input screen binary with a JAM 6 screenbinary of the same name, we would strongly recommend that you not use thisapproach. Keep your JAM 5 screens available for the entire time you are upgradingyour application until you are completely satisfied with the conversion. It might be thaton looking at a particular converted screen, you could get something more along thelines of what you want by using a different combination of options to control theconversion heuristics.Even if you did not use it, you should be aware of the product JAM/Pi, or PresentationInterface, which was a layered product in the JAM 5 world and is now fully integratedwith JAM in the JAM 6 world. JAM/Pi allowed JAM 5 users to create JAMapplications in GUI environments. Much of the complexity of converting JAM 5screens to JAM 6 arises from the need to convert the JPL extensions used in JAM 5 tospecify GUI-specific field and screen attributes to the JAM 6 environment. If you didnot use JAM/Pi in JAM 5, much of the remaining part of this document may appearmore complicated than necessary.Invoking f5upgThe utility should be invoked from the command line with the following syntax:f5upg [-5bcdfklmp] [-g type] [-v num] [-s color] JAM5_screenJAM7_screenArguments and OptionsJAM5_screenThe name of the JAM 5 screen that you wish to convert.Upgrade Guide 4-13