Caché Upgrade Checklists - InterSystems Documentation

Caché 2008.1 Upgrade Checklist8.3.4 Command-line Debugging ChangesThe ZBREAK command has been extended with new arguments that permit finer control over instruction stepping. Forexample, it is now possible to bypass stepping into language support routines and method calls, particularly the %Destructmethod.Details on the improved operation are contained in the ZBREAK command reference material, and the section on debuggingin the guide to Caché ObjectScript.8.3.5 Studio Changes8.3.5.1 Source Control Document CompatibilityThe %Studio.SourceControl.Interface class implementation has changed in this version of Caché. However, Studio will nowdetect which version of the class is being used and act accordingly. This will allow more controlled conversion of existingapplications using source control in Caché.8.3.5.2 Version CompatibilityThis version of Studio will refuse connections to servers running versions of Caché before 5.2. This is a consequence ofthe security features added in that release. When a connection is refused, developers will see a message, “Version mismatch.Server should be version 5.2 or higher.”8.3.6 Caché Terminal Changes8.3.6.1 Terminal IdentificationIn this version, the TERMINAL has been modified to display the machine and instance of Caché it is connecting to. Theseitems are displayed BEFORE any prompt for a user ID or password occurs. Those terminal scripts that assume the firstoutput from TERMINAL is the prompt for a username should be changed to explicitly look for the prompt. Otherwise,they may intermittently fail depending on the timing of the output.8.3.6.2 Support For Telnet Terminal TypesCaché Terminal now supports the “Terminal Type” telnet option. At process startup, Caché will perform the “TerminalType” telnet option negotiation. If the telnet client agrees and sends the terminal type, Caché will define the WindowsTERM environment variable. The value of this variable can be retrieved from within Caché through the function,$System.Util.GetEnviron("TERM").8.3.6.3 ZWELCOMEThis version of Caché provides a mechanism to invoke specific code to be executed when a terminal connection is made,but before the user login takes place.The terminal initiation code checks for the existence of a routine called, ZWELCOME in the %SYS namespace. If sucha routine is found, it is invoked immediately prior to the terminal login sequence, if any. The name of the routine impliesits intended use, as a custom identification and welcome message to users.CAUTION:The ZWELCOME routine executes in the %SYS namespace with an empty $USERNAME and $ROLESset to %ALL. Care should be taken to ensure that the failure modes of ZWELCOME are benign.204 Caché Upgrade Checklists