Category:Debugger Release Notes: Difference between revisions

Added "jandeb_" prefix to all generated JavaScript function names in generated Proxy Auto Config (PAC) files.

Support Microsoft IPV6 extensions in existing PAC files (FindProxyForURLEx function).

Send Client version information to the mainframe: the build and tag number are reported in the MSIR.1077 message.

Physical changes and additions to the Client user interface:

• New Preferences window option:

The new IE Options area and IE Mode drop down menu replace the former Web Browser Options area and Automatically Maintain IE proxy settings option. In addition, IE Mode options are available to invoke automatic creation and maintenance of Proxy Auto Config (PAC) files, which designate the only host URLs the Debugger Client will handle requests for as a proxy server.  

• The Proc Selection page now has Black List filtering to accompany the already existing White List filtering, and your filtering selection now persists over runs of the Client.

Macro and command changes:

New commands:

• disableButton and enableButton commands disable and enable Client button bar buttons, and labelButton lets you replace the label of a button.

• generatePac command restricts the Debugger Client's role as proxy server to handling only Internet Explorer requests for hosts (onlines) specified in debuggerConfig.xml.

• setBlackList and setWhiteList commands let you temporarily override (but not change) the contents of an existing Black List or White List file.

• setIEMode controls whether, and the host URLs for which, the Debugger will serve as the proxy server for users of the Internet Explorer browser.

• setTitle and restoreTitle let you change the title of the Client's main window.

• showIE displays the current IE browser operating mode (the setIEMode setting that is in effect) and displays the current values of IE settings that pertain to the Debugger Client.

• turnOnBlackList, turnOffBlackList, and reloadBlackList are analogous to the already existing turnOnWhiteList, turnOffWhiteList, reloadWhiteList commands.

Changed commands:

• The continueIf and continueMacroIf macro only commands now support expressions.

New Client functions:

• &&currentTitle and &&originalTitle display the current and default titles of the Client main window.

• &&exists tests if a macro variable is defined.

• &&blackOrWhiteList tests whether black list filtering, white list filtering, or neither is in effect.

• &&ieMode returns the setting of the IE Mode option in the Client's Preferences window.

Other changes:

• Documentation added for setting up a Chrome browser as a Client proxy.

• A work folder specification is added as the fourth parameter to a command line Client invocation

Macro and command changes:

• nsLookup command added to aid in debugging setup problems

• Assorted bug fixes.

Physical changes and additions to the Client user interface:

• Status message improvements:
  • Added a display of the value (if ten characters or less) to the message received after a successful "run until variable = value" execution.
  • The macroTrace, mapButton, mapKey, clearButton, and setPreference commands now report after a successful operation (in the Status bar, Console, and Client log).

Macro and command changes:

• New help command options:
  • preference displays the preferences available to users via options of the setPreference command.
  • ignoredFiles displays the Debugger's filtered file types (see step 4).

• New ignoredFileTypeList option of the setPreference command allows on off toggling of file type filtering.

New Client functions:

• &&exists tests if a macro variable is defined.

• &&currentRunningMacro returns the file system path of a currently running macro.

• &&preference returns the current value of a specified Client preference.

Physical changes and additions to the Client user interface:

• Help menu Commands option now displays individual command syntax

• Command line tool now maintains persistent history of commands, reviewable via the keyboard up/down arrow keys

• macroTrace processing log now shows syntax help if commands have syntax errors

• Watch Window color panel option (Out of Scope) for Watch Window items not in code in currently active tab (Source Code or Daemon).

• Degree of transparency of windows is now user settable

• Search box widened for "Hide Lower" mode

• Selecting Add Watch (from context menu for a Source Code line) automatically opens external Watch Window if Client in "Hide Lower" mode

• Support master thread and daemon thread interaction (ReturnToDaemon method/Continue method)

Macro and command changes:

• New commands:
  • setStatusMessage lets you set a message in the Client Status bar
  • unSet deletes macro variables

• <> ("not equal" operator) added to assert command

• Argument added to help command to display help for a specific command or function

• New Client functions:
  • &&statusMessage returns most recent Client Status bar message
  • &&numberOfLevels returns the number of source levels being debugged
  • &&amDaemon returns 1 if debugging a daemon, or 0 if not
  • &&selectedTab returns label of selected main window tab, or if none

Physical changes and additions to the Client user interface:

• New Help menu option (Functions) to display Client functions

• Search and Watch Window controls display at bottom of main window when in "Hide Lower" mode

Macro and command changes:

• Macro variables now allowed as arguments to Client functions

• New client functions:
  • &&getMainSearchInputArea
  • &&getVariableOrFieldInputArea
  • &&isWatched
  • &&numberWatched
  • &&numberOfBreakpoints
  • &&sum
  • &&windowStatus
  • String functions:
    • &&concatenate
    • &&index
    • &&length
    • &&substring
    • &&verifyMatch
    • &&verifyNoMatch

• New commands:
  • clearStatus clears current messages from Client Status bar
  • feoDisplay displays current occurrence value in an FEO loop
  • kill stops a running macro (like Kill Running Macro option of Macros menu)
  • reloadLists reloads the Exclude/Include proc/routine lists (see step 2's final bulletpoint)
  • removeCurrentWatch removes currently selected Watch Window item
  • showFunctions displays all the Client functions in alphabetical order

• Command argument of loadWatch and saveWatch allows absolute path name

• New option (valueDisplayOnConsole) of setPreference command to control whether value displays appear in a separate Value window when the Console window is open

• Backslash (\) escape character for searches for strings beginning with an ampersand (&)

• &&arg function now restricted to commands within macros (in previous builds, &&arg could be used outside of a macro, but its results were unpredictable and unreliable)

• Client functions and constants now allowed on continueIf and continueMacroIf

Physical changes and additions to the Client user interface:

• New Preferences window options:
  • Main Button Bar options (Top, Center, Bottom) allow changing the position of the main button bar
  • Main Button Bar option (Extra Buttons) to add extra buttons to the main button bar instead of to a second button bar
  • Main Window Options option (Hide Lower Section) to hide or restore the lower section of the Client main window
  • More Open at Startup options to automatically open external windows at Client startup (for the Watch Window and Audit Trail, Web Buffer, and Execution Trace pages)

• A Step out, Step over, or trace followed by pressing the Enter key launches another step out, step over, or trace if program execution has not completed

• Named buttons may be replaced by separators for visual separation between buttons

• Edit uimore.xml option added to File menu

• Pinned external windows:
  • Context menu options simplify pinning and unpinning  
  • Pin icon in title bar

• Additional StringTokenizer class variables are viewable: CurrentQuoted, CurrentToken, String, and StringLength

Macro and command changes:

• New "global" versions of existing Client functions: &&globalAssertFailureCount, &&globalAssertSuccessCount, and &&globalAssertStatus

• New commands:
  • clearButton removes all mappings from a Client named button
  • clearKey removes all mappings from a Client hot key
  • evaluate builds and runs a Client command
  • hideLower, restoreLower, and toggleLower commands for hiding and restoring the lower section of the Client main window
  • increment and decrement add or subtract 1 from a numeric valued macro variable
  • mainButtonBar positions the main button bar within the Client window
  • mapKey command assigns keyboard shortcuts without requiring a mapping file or Client restart
  • resetGlobalAssertCounts clears counts of new "global" Client functions
  • setBreakpointOnCurrentLine and clearBreakpointOnCurrentLine expand flexibility of the commands for controlling breakpoints
  • Macro only commands:
    • continueMacroIf conditionally processes the macro that contains it
    • includeIf conditionally calls another macro
    • macroWait slows down macro execution

• New option (main) of extraButtonBar command to combine the main and second button bars

• New option (ieAuto) of setPreference command to control automatic proxy maintenance for the Internet Explorer browser

• "[in window] command" format and command parameters now allowed in command mappings (see Note in step 3) for Client button, keyboard shortcuts, and macros

• Button mapping keyword (separator) for mapButton command or mapping file mapping element converts a button to a visual separator

Physical changes and additions to the Client user interface:

• Optional second button bar

• Former Window menu option Open External Button Window renamed to Show Main Button Bar in External Window

• New Preferences window section Open at Startup with checkboxes for button bars:
  • External main button bar  
  • Extra button bar

• On external windows, Enter key searches down (see step 2) when the search text box has focus

Macro and command changes:

• New commands control the pinning of external windows: pin and unPin

• New extraButtonBar command launches an extra button bar

• Addition to buttonBar command:  new option show  

• New mapButton command assigns button mappings without requiring a mapping file or Client restart

• Other new commands:
  • resetAssertCounts clears counts of Client functions
  • restart and restartDefault restart the Client

• The descriptions of the "macro only" commands (continueIf, include, macroTrace, noSpan, setM204Data, and span) are moved to the Client command reference  

Physical changes and additions to the Client user interface:

• Dock and File menus added to the external Button Bar

• External Button Bar now dockable (via Dock menu or buttonBar command)

• Search buttons added to bottom of work windows and external windows

• Three additional Client buttons (bringing total to fifteen) for mapping Client commands

• New Proc Selection tab checkboxes turn on or off the inspection of lists of procedures/routines to exclude or include in source code displays in the Client

Macro and command changes:

• "[in window] command" format applies the searching commands to most any Client window (main, external, or work), as follows:

• Statement execution history now viewable in Source Code (or Daemon) tab, controlled by:
  • New Execution menu options: Select Previous History Line, Select Next History Line, Select First History Line, Select Last History Line
  • New Client commands: previousHistory, nextHistory, firstHistory, lastHistory

• Requirement is removed to have button mappings for the step, run and cancel commands  

• Macro and command changes:
  • New program window position commands: moveBrowserToTop and moveTn3270ToTop
  • The "macro only" restriction for the set and assert commands is removed.
  • New Client commands:
    • previousHistory, nextHistory, firstHistory, lastHistory
    • openExternalButtonWindow, closeExternalButtonWindow

• Physical changes and additions to the Client user interface:
  • Button bar may be moved to an external window via Open External Button Window option of Window menu
  • New Search Prev button searches backwards in the current Client tab (same as ALT-Search button)
  • Windows When Suspended Preference displays the 3270 Emulator window or browser window for code not being debugged
  • Get History option of Execution menu renamed to Get/Display History
  • Preferences dialog box is no longer modal: it can remain open while the Client is active
  • Command Line window now remains on top of your PC's window stack

• Browsing while debugging now allowed for browser on which the Client is defined as proxy server

• Physical changes and additions to the Client user interface:
  • Button bar moved above main window, and Status area moved to strip at bottom of main window
  • Font size in most Client windows is now scalable
  • Two additional Client buttons (bringing the total to twelve) now available for mapping Client commands
  • Editor for client side editing can now be set in the debuggerConfig.xml file  (an alternative to Notepad)
  • READ SCREEN information now displayed in the Client's Audit Trail tab
  • Mouse double click now opens external windows
  • Removed label Variable or Field for text box above Watch Window; changed Trace Changes button label to Trace; changed the former Trace button label to Trace All; changed the former Add Watch button label to Watch.

• Macro and command changes:
  • Macro command line tool is renamed to Command Line and now accepts all commands
  • New macro related commands:

• openCommandLine and closeCommandLine toggle the Command Line tool accessed from the Macros menu

• openMacroConsole is now a synonym for the macroConsole macro command, which opens the Macro Console; and closeMacroConsole closes the console

• createMacro mimics the action of the Macros menu New Macro option

• editMacroFromUISelection mimics the action of the Macros menu Edit Macro option

• runMacroFromUISelection mimics the action of the Macros menu Run Macro option
  • New command and method options for sending user interface commands to the Client:

• CLIENTCOMMAND subcommand of TN3270 DEBUG

• DebuggerTools class additions:
  • New ClientCommand method
  • New StatusMessage method
  • New parameter (to execute Client command) for Break method
  • New parameter (to execute Client command) for Command method
  • The "macro only" restriction for some commands (echo, toggle, varDump, and windowToTop) is removed, and their descriptions are moved to the Client command reference  

• Bug fixes only.

• New Preferences (File > Preferences) option (Use existing IE proxy for URLs not to be debugged) for troubleshooting IE proxy server issues

• Some mapping errors in the ui.xml and uimore.xml files will now invalidate only the individual item and not the entire file

• New selectWatchWindow command to give focus to an external Watch Window

• Debugger Client now targets .NET Framework 3.5 SP1  

• Audit Trail, Web Buffer and Execution Trace windows may now be moved to separate external windows

• Client Window menu lists and tracks new Client external windows

• Multiple issues fixed concerning Client operation on Windows 7, thereby making build 50 the preferred build for Windows 7 users

• Client's display and watch facilities now work for Janus SOAP Arraylist objects the  same as they do for $lists or Stringlists

• New Serialize option in context menu for XmlDoc or XmlNode object variables in the Watch Window for displaying serialized object content

• New Preferences (File > Preferences) option (Macro Autorun) automatically runs a macro when a same named procedure is debugged

• New macro only commands:
  • macroTrace traces all macro statements in the debugging session
  • setM204Data sets a Model 204 %variable or global variable  
  • windowToTop brings specified window to top of window stack

• New Client functions (&&assertFailureCount, &&assertSuccessCount, &&assertStatus) report macro assert command results

• New mappable commands for Client windows:
  • clearHistory and closeHistory for the Execution History window
  • clearMacroConsole and closeMacroConsole for the Macro Console window
  • closeExternalAuditTrailWindow closes an external Audit Trail window
  • closeExternalExecutionTraceWindow closes an external Execution Trace window
  • closeExternalWatchWindow closes an external Watch Window
  • closeExternalWebBufferWindow closes an external Web Buffer window
  • closeExternalWindows closes any open external windows
  • closeValueDisplay closes Value windows
  • openExternalAuditTrailWindow opens an external Audit Trail window
  • openExternalExecutionTraceWindow opens an external Execution Trace window
  • openExternalWebBufferWindow opens an external Web Buffer window

• New showCommands mappable command displays all the Client commands in alphabetical order

• Boolean enumeration variables (for example, %bool1 is enumeration Boolean) may now be set (only to True or False)

• Single quotes now allowed on string literal values in macros, wherever string literals may appear (for example with &&prompt)

• Search path for PDF copy of product User Guide (View PDF Manual option, Client Help menu) now first tries the product installation folder, then the Doc subfolder

• PDF version of Debugger User Guide is installed in the target installation folder instead of in a Doc subfolder.

• New macro commands: loadWatch and saveWatch

• Missing Save option added to File menu on Value windows

• New Client menu option (External Watch Window) and command (openExternalWatchWindow) move the Watch Window to an external window

• The assert command now accepts a Client function as a target (left side)

• Added Proc Selection tab buttons for creating and editing Exclude and Include lists for selectively excluding from debugging the code for particular methods and User Language subroutines

• New Debugger configuration file (debuggerConfig.xml) elements for modifying the default location of Client work files

• New Client functions (&&searchSuccess, &&searchResult, &&procName)

• Binary view of a variable's value now also shows printable characters

• Client Value display windows now are non-modal for ease of use

• New Client menu option (Toggle Init Exclude) and command (toggleInitExclude) control whether to invert the way exclude mode operates: initially excluding code instead of initially including code (until an explicit directive)

• Added Edit White List button to Proc Selection tab

• Added exclude/include procedure lists when debugger directives are on

• Source Code lines can be explicitly excluded from Debugging

• Debugger commands and macros may now be mapped to numeric keys as well as to alphabetic and function keys

• Multiple commands added for Client tab selection and navigation:
  • selectAuditTab
  • selectSourceTab
  • selectWebBufferTab
  • selectExecutionTraceTab
  • selectProcSelectionTab
  • selectNextTab

• pafgi command added for viewing field groups

• Options PAI and PAFGI added to Data Display menu

• Additional text items available for user specified coloring in the Client windows:
  • User Language TEXT and HTML statement blocks  
  • User Language Macro Facility statements

• Add Watch and Display right click options for lines within HTML or TEXT blocks now detect Model 204 field name expressions

• New Client Preferences option (Show long watch values in a Tool Tip) for viewing Watch Window items too wide to fit

• $CURREC calls as well as $FIELDGROUPID and $FIELDGROUPOCCURRENCE calls can now be quickly evaluated/watched

• Added the Value class variable to the expansion of a ScreenField object

• Additional class variables are viewable:  
  • Record class: RecordNumber and FileName variables
  • RecordsetCursor class: RecordNumber, FileName, LoopLockStrength, and State variables
  • FastUnloadTask class: State variable
  • StringTokenizer class: AtEnd and NotAtEnd variables
  • UserStatistics class: LoginToString, RequestToString, and ToString variables
  • CharacterMap class
  • RandomNumberGenerator class

• Support added for viewing fields that belong to Model 204 field groups

• pai command added for viewing all fields in a record

• Fixes for some cases where string data was erroneously shown in binary/hex notation (X'aabbcc' format)

• FloatNamedArrayList class variables now viewable

• Global variables referenced by $GETG calls can now be quickly evaluated/watched by right clicking their program line and selecting Add Watch or Display from the context menu

• $STATUS and $STATUSD calls can now be quickly evaluated/watched by right clicking their program line and selecting Add Watch or Display from the context menu

• New File menu item (Restart with Default Window Size) restarts the Client and displays it with the size and position it occupied when it was first installed

Otherwise, the overall size and position of the Client window as well as the dimensions of its internal windows is stored when the Client closes and reused when the Client is next opened.

• New Macros menu items (Run and Edit) identify the most recently run macro and enable quick execution or editing of that macro

• New mappable command (clearWebBuffer) and Window menu item (Clear Web Buffer) that clear the contents of the Web Buffer tab.

• New mappable commands that help to debug requests that contain objects, lists, or Stringlists. Probably better suited for macros, the commands may also be mapped to buttons or keys:

• expandObject displays a list of object variable names and values for its object instance argument

• expandList displays the list items in the $list or Stringlist referenced by the variable specified as the command argument

• getVariablesForClass displays a list of the names of the variable members in the class specified as the command argument

• New mappable command (valueDisplay) that, like the Value button, displays in a separate window the value of the item currently in the Variable or Field area

• New mappable command (showShortcuts) that displays the Client's current (default as well as mapped) keyboard shortcuts

• New macro only command (macroConsole) that invokes the Macro Console window.

• Class variable members in system exception classes are now viewable

• Increased drop down history of search terms, procedure names, and variables from ten to twenty

• Multiple bug fixes (listed in Client's Help menu, About option).

• User specified colors for text and backgrounds in the Client windows

• Independent coloring for Source Code comments

• Ability to view dummy string substitutions in Model 204 commands (formerly only in User Language statements)

• Additions to the Preferences dialog box:
  • 3270 Emulator option added to bring up 3270 window at pause for user input
  • Web Browser option added to bring up browser window at pause for user input
  • Clear IE Proxy Override option enhances IE automatic proxy server maintenance

• New session highwater mark item added to the output display of the TN3270 DEBUG STATUS command.

• New File menu option (Edit debuggerConfig.xml) opens the debuggerConfig.xml file for editing

• "Web request will NOT be debugged" audit trail messages (see step 4) now indicate reason

• Debugger Client now always becomes the topmost window when a breakpoint is reached

• The Add Watch button now works properly with %variables whose names also have an embedded per cent (%x) character or whose names are enclosed in curly braces {%x}.

• debugTrace tag added to debuggerConfig.xml file for additional diagnostic Client logging

• Bug fixes only.

• The Dataset object is added to the list of viewable classes.

• New Clear Execution Trace menu item and clearExecutionTrace command for clearing the contents of the Execution Trace tab

• Ability to display statement execution history in Execution Trace tab

• Clear button added to Execution History and Macro Console windows.

• New macro related commands: toggle, continueIf, span, and noSpan.

• New optional attribute, startUpMacro, for the mappings element in a ui.xml file mapping of alternative Client buttons, hot keys, and macros

• Improved display of statement execution history  

• Ability to display the Model 204 Universal Buffer  

• Ability to display the value of a Model 204 parameter

• New Execution Menu option (Get History) and mappable command (getHistory) for displaying a history of the statements executed to the current point in a program being debugged

• User items specified during Client session now are preserved in the next session:
  • Previous search strings are accessible in a Search box drop down list.
  • Previous variables specified are accessible in a Variable or Field box drop down list.
  • Watch Window contents are redisplayed by default.
  • Resizing of the Client window is preserved.

• Watch Window operations are no longer prevented when no program is being debugged

• New DebuggerTools class method, Command, runs TN3270 DEBUG commands within a request

• A fix for a rare case where the Watch Window failed to display certain variables in a program involving a persistent session

• Enhancements to Source Preview feature:
  • A Step or Search command is allowed and causes a download of the entire source program
  • A Run command runs the program without a code download

• A fix for the case where the Client was failing to display a compilation error message (M204.1265) for which a Model 204 MSGCTL was being issued

• New option that allows previewing of program code

• Array item references that have spaces between the array name and the left parenthesis are now recognized properly by all the Client features

• Displaying in the Audit Trail tab the names of procedures excluded from debugging by the White List processing feature

• A command for interrupting White List or Run Until processing

• Syntax added for watching mixed case global variables

• Changes to the Search feature to enable keyboard invoked consecutive searches for a given string:
  • The default response to pressing the Enter key while the Search text box has focus is changed from "search from the top" to "search from current line." This lets you press Enter repeatedly to find subsequent occurrences of a search string. Formerly, pressing Enter again found the same occurrence as the first time because it repeated the search from the top.
    Note: This introduces a small upward incompatibility.
  • New focusToSearchBox command gives the input focus to the Search string text area. The CTRL-F key combination is changed to perform the same function by default.

• A console for macro information

• Macro Command Line menu option to run a macro

• Echo command output goes to console if console is open

• A macro running indicator to be displayed on the Client's title bar

• New macro related commands: set, assert, and varDump

• New mappable commands:
  • addWatchOnCurrentLine (with accompanying menu item Add Watch on Current Line)
  • toggleBreakpointOnCurrentLine (with accompanying menu item Toggle Breakpoint on Current Line)
  • reloadWhiteList, turnOnWhiteList, and turnOffWhiteList (with accompanying menu items Reload White List, Turn On White List, and Turn Off White List)

• New menu item (Execution > Run Until Proc) for Run Until processing, and the runUntil command is now mappable

• Lines located via a Search button are now highlighted and displayed in the center of the page

• Jump feature is added  

• New Client macro related command (echo)

• &argstring macro variable for passing arguments to macro commands

• &&prompt function for interactive prompting

• An exception to ordinary request cancellation handling for the purpose of ON UNIT code debugging

• Search buttons now located below the text box for search strings

• A new utility for user created macros

• File types the Janus Debugger will not debug are settable (see step 4)

• New Client Preferences option (Trim blanks from selection) to remove blanks from text copied to the Text Viewer.

• Support for additional level of Client menu and keyboard reconfiguration via the uimore.xml file

• Expanded menu bar, which accommodates all Client commands

• turnOffDebugging programmable command turns off debugging from the Client

• Debugger now recognizes %variable names that include question marks (?) and single quotation marks (')

• Screen and ScreenField objects are added to the list of viewable classes

• Two new TN3270_DEBUG commands (SUSPEND and RESUME)

• NamedArraylist objects are added to the list of viewable classes

• Client's Web Buffer tab displays output if you debug a web thread program that contains an embedded TN3270 DEBUG ON command

• File menu option to create or edit the ui.xml file, which contains button and hot key reconfigurations  

• Settable image/screen items

• Help menu Keyboard Shortcuts display can be printed and saved  

• Viewing the Variables in a system or user defined class

• Print options added to Value window File menu

• New DebuggerTools method (DebugOff) mimics SIRUS DEBUG OFF command

• Text Viewer window for copying, printing, or saving text data from Client pages

• The button whose functionality the Enter key repeats is highlighted by a white background

• Settable buttons and hot keys

You may reconfigure any of the ten contiguous buttons below the main window to invoke a different feature than its default. You also may create your own keyboard shortcuts for commonly used features.

• From Help menu option, keyboard shortcuts can be displayed

• Trace button has a new default hot key combination: CTRL-T

• Enter key is alternative to the Set button in the Set dialog box for changing a variable's value

• Cosmetic changes to buttons

The button widths are now uniform, their labels have a smaller font, and disabled buttons are more obviously so.

• Name of current procedure displays in GUI title bar

• Workstation IP number displays on startup

The Audit Trail page initially displays a line like the following:

Local IP address 198.242.244.234  

• Pressing Enter key repeats last GUI action

Pressing the Enter key has the same effect as clicking the button that is currently highlighted. For example, when a request is first presented in the Source Code tab, the Step button is highlighted. You can step through the program simply by pressing Enter repeatedly.  

• Items in an array of $lists can be displayed in Value window

In this context, subscripts are allowed for $list identifiers. For example:

list %alpha(%i)

• Regular expressions supported in the Search box

• TN3270 DEBUG ON command enhancement simplifies its syntax

Two command parameters are settable in the User 0 stream.

• Options to set multiple breakpoints at once on all lines that match a search string or regex, or on executable statements that follow comment lines that begin with *break

• Breakpoint maximum increased from 40 to 1000 per User Language request

• In FEO loops, display current occurrence value

• Additional way to display the items in a $list or Stringlist variable

You can now right click the variable's name in the Watch Window display.

• Copy page contents to clipboard  

You can press the CTRL-C keyboard key combination to copy the contents of the active (topmost) tab to the Windows clipboard.

• Additional "trace until" option

The Run To Change button continues request execution until the value of a selected variable changes. The new variation to this feature (press Alt key while clicking Run To Change) continues execution unless or until a selected variable's value becomes equal to a value you specify.

• Length limit increased to 255 for %variables whose value you set

• STATUS option for TN3270 DEBUG command

Using the STATUS option produces a simple status report of the Debugger worker threads.

• White List processing enhancements

Processing is moved to the mainframe to eliminate code transfer and provide response time benefit. Also, trailing wild cards are now allowed in the White List.

• Step Out option

By pressing the Alt key and clicking the Client GUI Step Over button, you can immediately discontinue the Debugger processing of a called subroutine, method, or daemon and continue processing at the statement after the call to the subroutine, method, or daemon. This action is called a "Step Out".

• Skipping over Daemon code

By pressing the Alt key and clicking the Client GUI Run button, you can discontinue the interactive debugging of the Daemon object calls in your program. The Daemon code executes but is not displayed in the Debugger Client.

• Assembler language replaces User Language for Debugger internals
  • Downloading a User Language dump file (SIRDEBUG) to install the Debugger Server is no longer necessary.
  • The Windows Installer program (setup.exe) for the Debugger workstation client is downloadable from the web site for Debugger customers.

• Removal of requirements to license Janus SOAP and Janus Sockets to use the Debugger.

A new Debugger Server port type (DEBUGGERSERVER) replaces the SRVSOCK type that is required for earlier versions, and a new port type (DEBUGGERCLIENT) replaces the CLSOCK type that is required for the TN3270 Debugger for earlier versions.

• New File > Preferences option lets you break Debugger execution after READ SCREEN/MENU statements

New message (Full Screen Read Pending) prompts TN3270 Debugger Client users when READ SCREEN is active. Formerly, the message was Waiting for Online.

• Breakpoint maximum increased from 20 to 40 per User Language request

• Searching from bottom to top of page is added (via Alt key) to Search and Search Next buttons

• After failed compilation, F11 and F10 keys allow navigation to next and previous statement, respectively, that did not compile

• Watching variables within a class definition no longer requires explicit %this specification

• Option to restart the Debugger Client

From the file menu, the Restart option shuts down the Debugger Client. The Client then restarts, doing the same processing as if you started it by clicking its desktop icon.

• Main working area is resizable  

You can now drag the black bar just above the page navigation buttons to resize the main working window in the Client.

• Improvements to $list and Stringlist viewing

For a float variable $list handle or for a Stringlist object variable, you can now request a display of its elements, which will be presented in a data viewer similar to the way XML documents are displayed.

• Run Until spans debug sessions

The Run Until spans HTTP requests option is renamed to Run Until spans debug sessions, and it is generalized to work with the TN3270 Debugger as well as with the Janus Debugger. With this option turned on, Run Until continues searching through the source program until it finds the specified procedure, even if the debugging session is interrupted by a loss of the connection to the Online or the TN3270 Debugger is toggled off and on again. When the session resumes, the Client keeps searching for the target procedure.

• Performance statistics kept in log file are enhanced to report the number of bytes received per message incoming to the Debugger Client.

• Right clicking Source Code lines lets you display variable values

As described in Displaying the value of a program data item, this approach lets you display a variable’s value just as if you entered the variable name in the Variable or Field input area, then clicked the Value button.

• The installation kit now installs a required file (gdiplus.dll) to the installation target folder instead of to the system root folder, avoiding any security issues concerning folder write permissions.

• Minor memory use and performance improvements for both source code loading and variable watching.

• Save and restore proxy settings for Microsoft Internet Explorer

The automatic maintenance of proxy settings for Janus Debugger IE users that was added in Build 5 did not save and restore all proxy related settings. It now does.

• Performance improvements for watching variables

The display of the values of watched variables is slightly accelerated.

• Better proxy control for Internet Explorer

For those Janus Debugger users whose browser is Microsoft Internet Explorer, the task of defining the Debugger Client as the proxy server can be handled automatically by the Client when it starts up (and undone when the Client shuts down).

• Improved source line scrolling

To avoid having the current execution position in a source tab be the last line on the page (obscuring the next line of code), the display of the highlighted current position now includes the next two lines.

• Performance improvements for very long programs

Elapsed time for transferring and displaying programs with thousands of lines of code has been reduced by 90%. In addition, a new configuration file setting lets you trace the time the Client spends handling program code (see Tracking Client performance).

• Run Until Procedure processing can ignore the end of an HTTP request

This feature is designed to make it easier to debug HTML frame based web applications, since the Client by default terminates the search for a designated Run Until procedure at the end of an HTTP request. Thus, a procedure search stops by default after each SOUL produced frame in a single HTML frameset statement.

The File > Preferences menu option displays a checkbox that lets you direct the Client to continue across multiple HTTP requests until the specified Run Until procedure name or pattern is satisfied. See Precedence and scope for Run Until.

• Selecting which of multiple web servers are eligible for debugging

After selecting the File > Preferences menu option, you can choose which of the Onlines specified in the Client configuration file (debuggerconfig.xml) are to have their web requests debugged. For more information, see Debugging multiple Web Servers.  

• New hot key combination for Preferences option

The CTRL-P key combination now invokes the Preferences option of the File menu.

• Simplified editing and reloading of a White List

You can now edit or create a white list file (whitelist.txt) with the Windows Notepad editor by selecting Edit White List from the Debugger Client File menu. In addition, instead of restarting the Client to reload the list when done editing, you simply click the Reload White List button on the Proc Selection tab.

White list processing is described in Running only to listed procedures.

• Enhanced status reporting
  • An hourglass cursor displays whenever the Client is waiting for processing to complete on the Online.
  • Additional status area message values indicate that the GUI is waiting for the Online to respond:

• Waiting for Online is displayed when source code is being sent from the Online to the Client workstation, or when the Online is processing the Client's Step, Run, Run Until, or Trace command. The Waiting for Online message is also displayed in TN3270 Debugger sessions whenever the Client awaits a new request from the Online.

• Receiving/Forwarding Web Page is displayed by the Janus Debugger Client when a Web Server's HTTP response to a web request is being read by the Client and forwarded to the web browser.

• Persistent Session Suspended (see Debugging Web Server persistent sessions) is changed to Session awaits browser.
  • When White List processing is toggled on or off from the Proc Selection tab, White list is active or White list turned off is displayed as appropriate.

• New hot key combination for Search command

The CTRL-F key combination now performs the same function as the Search button (see The navigation and execution buttons).

• A summary of the changes since the last build

As described in Versions and builds, you can view a list of the changes in the current build of the Client by selecting About from the Debugger Client File menu.