HP 3000 Manuals HP 3000 Manuals
Functions Animator functions are accessed from menus. The function names are sometimes abbreviated on the menus; however, the descriptions in the following sections use the full names. The following section contains a quick reference listing all of the functions available in Animator. This listing is followed by detailed descriptions of these functions. Function Access The following table lists the functions in alphabetical order and indicates the keys you must press to access them. Thus, to determine the path to access a given function, follow the sequence of keystrokes. For example, to reach the Set Breakpoints function, from the Animator Main menu, you press the Breakpoints key (B) followed by the Set Breakpoints key (S). Some of these keys are symbolic key names which may not be present on your keyboard. For details of the actual keystrokes for your environment, see the appendix UNIX Key Usage Chart.(UNIX) For the purposes of this table, it is assumed that you are using the cursor to identify data-names rather than keying them in; therefore, a C on the menu access path indicates the selection of a data name using the cursor. If, however, you are not using cursor, simply substitute Enter and the name of your data item for the key C to identify fields. Function Menu Access Keys ------------------------------------------------------ 0-9 0-9 Add List Q, C, Alt+F3 Align F3 Alter Monitor Window Q, C, Alt+F10 Alternate Alt Animate A Application-view Ctrl+F7 Breakpoints B Cancel All Breakpoints B, C Cancel Program Break E, P, C Clear Several Contained Data Q, C, F8 Containing Data Q, C, F7 Control Ctrl Cursor-name Locate L, C Cursor-name Query Q, C or Double mouse-click Cursor-position Reset R, C Delete List Q, C, Alt+F4 Do D Do At Breakpoint B, D Down List Q, C, Alt+F6 Down Perform Level L, D Down-table Q, C, F6 Dump List Q, D Enter Enter Enter-name Locate L, E Enter-name Query Q, E Environment E Escape Esc Examine Backtrack E, B, E Examine Breakpoints B, E Examine Until E, U Condition Exchange F4 Exit Perform P, E Find String F Flash E, F Go G Hex Q, C, F3 Hex/ASCII Q, C, F10 Hide Monitors Q, H If Breakpoint B, I Insert List Left Q, C, Alt+F7 Insert List Right Q, C, Alt+F8 Join Text T, J Locate-declaration Q, C, Alt+F9 Look-up F6 Monitor Q, C, F4 Monitor+Break+Change Q, C, Ctrl+F4 Monitor+Fixed Q, C, Ctrl+F5 Monitor-off Q, M Monitor-slide on/off E, M Move-window Q, C, Alt+F10, <-, ^, ->, v Next Reset R, N Next-if I On Count Breakpoint B, O Organize Monitors Q, O Perform-level P Query Q Query data-name Q, C Query data-name Q, C, Alt Alternate Quit-perform R, Q Redraw Q, C, Alt+F10, F9 Refresh T, R Repeat Query Q, R Reset-execution R Same Level Q, C, F9 Scroll Up/Down Ctrl+F9/F10 (continuously) Scroll up/down (1 Ctrl + <-/-> line) Select Program Break E, P, S Set Backtrack E, B, S Set Breakpoint B, S Set Threshold Level E, T, S Set Until Condition E, U Split Text T, S Start R, S Step S Step Perform P, S Text T or Q, C, T This Program Break E, P, T Un-set Backtrack E, B, U Un-set Breakpoint B, U Un-set Threshold Level E, T, U Un-set Until Condition E, U, U Up List Q, C, Alt+F5 Up-perform Level L, U Up-table Q, C, F5 Update List Q, C, Alt+F2 View F2 Watch Monitors W Watch-off Q, W Where F5 Window-size- Q, C, Alt+F10, F5/F6/F7/F8 left/right/up/down Word left F9 Word right F10 Zoom Z Zoom Breakpoint B, Z Function Descriptions This section describes the functions available with Animator. Any not available in base Animator are marked accordingly.
NOTE Mouse support is not provided for UNIX or for the base Animator. UNIX and base Animator users should ignore any references in the following sections to using a mouse.
0-9 . Enable you to vary the speed at which execution progresses in "Go" mode, where 0 is the slowest and 9 is the fastest. Add List . Adds the value you have keyed in to the end of the list of values for the queried data item. Align . Repositions the program text so that the line on which the cursor is currently positioned becomes the third line on the display screen. Alter Monitor Window . Displays the Alter-window menu which enables you to change the size and position of the data monitor. For a description of the functions on this menu, see Move-window, window-size-left/right/up/down and Redraw. You can use the mouse to access your windows for these functions. Not available in base Animator. Alter Path . Searches for a file on a different path from the one you originally specified. You can enter any valid path specification, but you must terminate it with a directory separator (\ on DOS, Windows and OS/2 or / on UNIX). Alternate. Displays the main Alternate menu for Advanced Animator (available with add-on products), which is described in the section Menus. For a description of the functions on this menu, see the documentation provided with your add-on product. Not available in Animator or base Animator. Animate . Displays the contents of all variables for the current statement as monitors, in effect combining the features of Watch windows with Go. The statement is then executed, and the contents of the monitors updated. These monitors are then removed. This process continues for successive statements until the end of the program is reached or you press Escape. A menu is displayed enabling the speed of execution to be changed and enabling Zoom mode to be entered. Not available in base Animator. Application-view. Enables you to view programs within your application while animating the current program using Advanced Animator (available with an add-on product). When the function is selected, a window appears which displays a list of available programs. For a program to appear on the list, it must already have been called by the application. Only .int programs that were compiled for Animation are listed. (DOS, Windows and OS/2) Not available in Animator or base Animator. You can select a program from this list by positioning the cursor on the program name, and pressing Enter. When a program is selected, it is displayed in the normal way by Animator. If the program is not the current program (that is, the program that has the execution point in it), then all functions that cause execution are disabled. All other Animator functions are enabled, giving you the opportunity to do queries and to set breakpoints. To continue with the Animator session, select the current program from the program list. Breakpoints. This function displays the Breakpoints menu which is described in the section Menus. For a description of the functions on this menu, see Cancel all Breakpoints, Do at Breakpoint, Examine Breakpoint, If Breakpoint, On Count Breakpoint, Set Breakpoint, Un-set Breakpoint. Cancel All Breakpoints . Resets all active breakpoints. Cancel Program-Break . Cancels the currently set program break; that is, a breakpoint that is activated when execution reaches the specified program. See also Select Program Break. Clear . Clears the current input field. Contained Data . Displays the contents of the first sub-level of the item that is being queried. This query function is active when a group item is being queried. Containing Data. Displays the contents of the data item in which the selected item occurs. This query function is active when a member of a group item is being queried. Control. Displays the main Control menu for Advanced Animator (available with add-on products), which is described in the section Menus. For a description of the functions on this menu, see Application-view, Scroll Up/Down (1 line) and Scroll Up/Down (continuously). Not available in Animator or base Animator. Cursor-name Locate . Finds the location in the source code where a data item, file-name or procedure is declared. You can use the cursor control keys or the mouse to position the cursor in the program text; you can use the cursor control keys to position the cursor in a structure diagram, or monitor window. Data items and file-names can be located either from their monitor windows or name in the text. Procedure names can be located from their names within the program text. Cursor-name Query . Displays the contents of the data item at either the current cursor position or the position of the mouse pointer (use a double click to activate this function). It gives you access to other functions which enable you to modify and monitor the item. To alter the contents of the queried data simply type in a new value. The new value replaces the item's previous value. If the data item is a dynamic stream, you can update it by using the Do function. You can place the cursor, or select with the mouse, anywhere within the data item or in the data item window. If you do not select the name of a data item, the message: Not data item appears at the bottom of the screen. Following a successful query, the Query data-name submenu appears on the screen with the queried data name on the information line and the value of the data item at the bottom of the screen. Cursor-position Reset . Enables you to alter the sequence of program execution. The statement at the cursor position becomes the current statement. Execution will continue from this statement. This function does not change the value of any data. Delete List . Deletes the current value displayed from the list of values for the data item being queried. Do . Enables you to enter a COBOL statement to be executed immediately. This command enables you to insert a statement in the sequence of execution but does not add it to your program code. To add it, you must key it in using a text editor, then recompile your source code file. Alternatively, you can enter it as a Do At Breakpoint, in which case it will be saved in a file. The COBOL statement cannot exceed 71 characters.
NOTE Although most COBOL statements are supported by the Do command, Animator cannot handle some complex statements. An appropriate error message will be issued in these cases.
Do At Breakpoint . Prompts you for a valid COBOL statement which will be executed along with the current line. Execution is not interrupted. The line containing the breakpoint is highlighted (highlighting is not available in base Animator). When Animator encounters a breakpoint set with the Do option, the COBOL statement is executed immediately before the statement containing the breakpoint. In Zoom or Go mode, execution continues without a break. In Step mode, the Do-statement is executed when the statement containing the breakpoint is stepped onto. A message indicating that the statement has been executed appears at the bottom of the screen. You can repeatedly execute the COBOL statement without retyping it. Entering an invalid COBOL statement will give an error message. On exit from Animator, all the COBOL statements that are currently set using this function are written to a file called progname.edo, where progname is the name of your main program, in the same directory as the source of that program. You can then paste the contents of the .edo file into the program source file.If you have the COBOL Editor, you can do this using the F4=load-DO-statement-file option on the Editor's Command File menu.
NOTE Although most COBOL statements are supported by the Do command, Animator cannot handle some complex statements. An appropriate error message will be issued in these cases.
Down List . Displays the next item in the list of values for the data item being queried. Down Perform Level . Cancels the result of Up Perform Level, which enables the current execution path to be examined at the PERFORM level. (DOS, Windows and OS/2)
NOTE The Up-perform-level and Down-perform-level functions are not available and do not appear on the menu for base Animator or for Micro Focus COBOL for UNIX.
Down-table . Displays the contents of the next table entry. The display of the variable used as the table subscript (shown with the data-name) reflects the current value and is changed by this function. This query function is only active when a table data item is being queried. Dump List . Saves test data that you have created using the Query List functions. The list is written to disk in the current directory using the program name plus an .ils extension. If the specified file-name already exists, the file is overwritten with the new values. This list will be loaded when you re-enter Animator and execute the program for which you have created the list. The file must be in the current directory. Enter . Confirms any selections you have made or data you have keyed in. It may return you to a higher level menu. Where both Escape and Enter options are available, Escape exits without making the update you have keyed in, whereas Enter makes the update and then exits. Enter-name Locate . Displays a menu where you can type in the name of the item to be located in the source code. Moves the cursor to one of the following locations: * the line in which the data item is declared, or * the first occurrence of the file-name in your program, or * the paragraph or section name at the head of a procedure depending upon what you enter at the prompt. If you are working with nested programs, you must be positioned in the program in which that data item is defined for this function to work successfully. Enter-name Query . Prompts you for a data item name, which can be entered in upper or lower case. Following a successful query, the Query data-name submenu appears on the screen with the queried data name on the information line and the value of the data item in a window or at the bottom of the screen. To alter the contents of the queried data, simply type in a new value. The new value replaces the item's previous value. If you are working with nested programs, you must be positioned in the program in which that data item is defined for this function to work successfully. Environment. Displays the Environment menu which is described in the section Menus. For a description of the functions on this menu see This Program Break, Select Program Break, Cancel Program Break, Set Threshold Level, Un-set Threshold Level, Set Until Condition, Un-set Until Condition, Examine Until Condition, Set Backtrack, Un-set Backtrack, Examine Backtrack, Flash, Monitor-slide. Escape . Returns to the higher level menu or exits from Animator altogether if you are at the top menu. Where both Escape and Enter are available options, Escape exits without making the update you have keyed in, whereas Enter makes the update and then exits. Examine Backtrack. Enables you to traverse the recorded execution path. The Set Backtrack function must have been used prior to the execution of at least one line of source code in order for this function to operate. You use the ^ key to backtrack through the execution path starting from the current statement. At any stage you can move forward through the execution path by using the v key.
NOTE Execution does not occur during backtracking; backtracking is purely a viewing facility. During backtracking, statements are stepped in accordance with the current Threshold Level. See the Set Threshold Level function.
Examine Breakpoints . Enables you to review your breakpoints. Each time you execute this function, the cursor is placed on the COBOL statement that has the next breakpoint set on it. After displaying the last breakpoint, the function displays the first breakpoint. In addition, if the Breakpoint menu is active, whenever the cursor is positioned on a statement containing a breakpoint, a message appears on the bottom line of the screen. Examine Until Condition . This function enables you to see the contents of the current Until Condition. See the Set Until Condition function. Exchange . Toggles to move the cursor, and therefore the display of execution, between screens in split-screen mode. You can split the screen in two using the Split Text function. Exit Perform . Executes the remainder of outstanding code in the PERFORM range which includes the current statement. Execution stops on the statement following the end of the PERFORM range. This function operates only if the current statement is within a PERFORM range. If you select this function when you are not in the range of a PERFORM (PERFORM LEVEL = 01) and you are currently in a subprogram, you are asked if you wish to leave the program. If you reply "Yes", the program execution will continue in Zoom mode until the calling program is reached. If you are not in a subprogram, you will be reminded that the PERFORM LEVEL = 01 by an error message. Find String . Finds the next occurrence of a text string in the source program file. You can find a text string in both the main program and COPY-files or in just the main program. By default, the Find function searches all files in the program. Once the find is completed, the cursor is positioned at the beginning of the text string located. The string can be up to 32 characters long and must be entered exactly as written in the source code, using upper- and lower-case letters as appropriate. If you want to include spaces at the end of the string, enter the spaces and terminate them with a hash mark (#). If you wish to find a string in the main program only, enter the string, terminated by a # and an M. The M tells Animator to search just the main file. If you have previously used the Find function during the current session, the last specified string appears in the prompt field. You can use the clear function to clear the string or Enter to search for the same string again. The Find function searches forward only from the current cursor position. You cannot find a string that you have already passed. Flash . Enables you to toggle between Step and Zoom mode to change the conditions which cause Animator to display the user screen. Not available in base Animator. Step executes the current statement in your program and then halts. The user screen is displayed before each statement is executed. Zoom executes your program at maximum speed without showing the source code. The user screen is displayed before entering zoom mode and when executing a COBOL statement that causes the screen to be updated by the user. When you alter this setting, Animator confirms the change which affects only the current program. Flash (step) is of particular use if your COBOL program CALLs a subprogram which is written in another language (for example, Assembler) which could otherwise produce output on the Animator screen. The default setting Flash (zoom) is created at compilation time and can be altered using the FLASH Animator directive at compilation time. Go . Executes automatically each statement in the program one by one, displaying the source code on the screen as it is executed. Go mode is an automatic Step mode; you do not have to press a key to execute each statement as you do in Step mode. You can set the Go execution speed by pressing a key in the range 0 to 9, where 0 is the slowest. You can also set the speed of execution from the Animator Main menu by pressing a number in the range 0 to 9 without selecting the Go function. The current speed is shown on the information line. The default speed is 5. To stop execution in Go mode and return to the Animator Main menu, press Escape. To change to Zoom mode from within Go mode, press Z. The program then executes at full speed without animation. You can break out of Zoom mode by pressing the sequence for Break. Hex . Toggles to change the display of a queried data item to hexadecimal format and to change the menu displayed. You can type over the data using either text or hexadecimal code. Hex/ASCII. Toggles to move the cursor between the hex and ASCII data representations. It is available when you are displaying a queried data item in hex format. You can type over the data using either text or hexadecimal code. Hide Monitors . Hides all monitors. They will only reappear on the screen if their value changes or if a text refresh is done. Not available in base Animator. If Breakpoint . Enables you to set a conditional breakpoint. A conditional breakpoint is a breakpoint that takes effect only if the specified condition is true when the breakpoint is reached. The line containing the breakpoint is highlighted (highlighting is not available in base Animator). The submenu prompts you to enter a condition in COBOL format. Once you have entered a valid statement, pressing the Enter key sets a conditional breakpoint at the current cursor position. Execution stops at this breakpoint only when the condition is true. If the condition you specify is false or does not become true, the Animator ignores the breakpoint and continues executing the program. You can enter any condition enabled by COBOL syntax, including combinations of conditions. You cannot set a conditional breakpoint on a statement that already has an ordinary breakpoint, and vice versa. If you wish to set a conditional breakpoint that is not tied to a particular statement, you should use the Until function. Insert List Left . Inserts a new data value entered into the input field into the list immediately before the currently displayed list value. This function is one of the Query Data list functions. Insert List Right . Inserts a new data value entered into the input field into the list immediately after the currently displayed list value. This function is one of the Query Data list functions. Join Text . Cancels the effect of the Split Text function and returns you to a single screen display of source code. You can use the Refresh Text function to repaint the screen after using the Join Text function. Locate-declaration . Displays the Locate-declaration menu if accessed from the Animator Main menu. For a description of the functions on this menu see Cursor-name Locate and Enter-name Locate, Up Perform Level and Down Perform Level.
NOTE The Up-perform-level and Down-perform-level functions are not available and do not appear on the menu for base Animator or for Micro Focus COBOL for UNIX.
Alternatively, if accessed from the Query Alternate menu, the Locate-declaration function finds the location in the source code of the current query item. Look-up . Repositions the program text so that the line number specified at the prompt becomes the third line on the screen. This provides a quick and easy means of locating a line in your code without having to scroll through it line by line. Monitor . Enables you to display the content of a queried data item as it changes during program execution. See also Monitor-off, Hide Monitors and Alter Monitor Window. Monitor+Break+Change. Monitors the queried data item and performs a breakpoint when the data item changes. Only one of these is enabled at a time. Not available in base Animator. Monitor+Fixed. Causes the monitor to operate on the subscript that was current when the function was selected rather than to follow the subscript. By default, Animator monitors the queried data item and the subscript of the data item. As the subscript changes, the monitor is adjusted to display the relevant data element. Monitor-off . Switches off the monitor display of a queried data item. See also Hide Monitors. Monitor-slide. Toggles to enable you to change the way the monitor windows move on the screen. With this toggle set to on (the default) the monitor window appears at the current cursor position and slides to its final position, towards the right-hand side of the screen. With this toggle set to off, the monitor positions itself immediately in the final position, towards the right hand side of the screen. Not available in base Animator. Move-window. Defines a new window position. You can either use the cursor keys to move the window in the appropriate direction, or you can click the mouse on the top border of the window containing the data-name and drag the window to a new position. Not available in base Animator. Next Reset. Causes the next statement to become the current statement without executing any code. This function does not change the value of any data. Next-if . Zooms through all statements until the next IF statement is encountered. Program execution then stops, and the source code is returned to the screen. Nx-If. See Next-if. On Count Breakpoint . Enables you to set periodic breakpoints that halt execution when a statement has been executed a specified number of times. For example, if you specify a frequency of 3, set the breakpoint and then Zoom, execution breaks the third time that the breakpoint is encountered, and every third time subsequently. The line containing the breakpoint is highlighted (highlighting is not available in base Animator). The frequency must be in the range 2 to 255 inclusive. Once the frequency has been entered, the normal Breakpoint menu appears, enabling you to set the breakpoint or to specify a breakpoint with the Do function. The number selected for the desired frequency appears on the information line. Organize Monitors . Reorganizes the monitors on your screen to their default positions. Not available in base Animator. Perform-level. Displays the Perform-level menu which is described in the section Menus. For a description of the functions on this menu see Step Perform and Exit Perform. Query. Displays the Query menu, which is described in the section Menus. For a description of the functions on this menu, see Cursor-name Query, Enter-name Query, Repeat Query, Monitor-off, Dump-list, Hide Monitors, Organize Monitors and Watch-off. Query Data-name. Displays the Query Data-name menu, which is described in the section Menus. For a description of the functions on this menu, see Contained Data, Containing Data, Down-table, Hex, Hex/ASCII, Monitor Same Level and Up-table Query Data-name Alternate. Displays the Query Data-name Alternate menu, which is described in the section Menus. For a description of the functions on this menu, see Add List, Delete List, Down List, Insert List Left, Insert List Right, Locate-declaration, Redraw, Up List and Update List. Query Data-name Control. Displays the Query Data-name Control menu, which is described in the section Menus. For a description of the functions on this menu, see Monitor+Break+Change and Monitor+Fixed. Quit-perform . Exits from the current PERFORM range without executing the remaining statements. The next executable statement after the PERFORM statement becomes the current statement. You can select this function only when inside the range of a PERFORM. This function does not change the value of any data. Redraw . Redraws the monitor, using the cursor position as the new corner, after you have defined a new corner for your monitor using the Window-size-left/right/up/down function. Not available in base Animator. Refresh . Refreshes the display of all source text and the monitor. Repeat Query . Displays the content of the item which was last queried and displays the Query Data-name submenu. Reset-execution. Displays the Reset-execution menu which is described in the section Menus. For a description of the functions on this menu, see Start, Next, Quit-perform and Cursor-position Reset. Same Level . Displays the content of the next data item that has the same level as the queried data item. The data name appears on the information line. Scroll Up/Down (continuously) . Scrolls the text rapidly towards the beginning (Up) or end (Down) of the file. Press any key to stop scrolling in either direction. Scroll Up/Down (one line)(Ctrl+<-/ ->) . Enables you to scroll up or down, line by line, by using the <- or the -> key respectively. Select Program Break . Prompts you for the name of the program at which you wish execution to halt; that is, a program break. A Program break is a breakpoint that is activated when execution reaches the specified program. Set Backtrack. Causes the execution path to be recorded from the set point onwards. See the Examine Backtrack function for details of how to view the recorded details. Set Breakpoint . Enables you to set a breakpoint at the current cursor position. When Animator encounters the breakpoint, execution halts before executing the statement. The statement containing the breakpoint becomes the current statement. The line containing the breakpoint is highlighted (not available in base Animator). Program breakpoints remain set, so if you leave animation without un-setting (canceling) a breakpoint, the breakpoint will be set the next time you animate the program. You can set up to 100 breakpoints in each program. When a breakpoint is reached, you will see the message: Breakpoint encountered at the bottom of your screen. Set Threshold Level . Enables you to specify a nesting level of subroutines and called subprograms below which PERFORMs and CALLs are executed in Zoom mode rather than being animated. The level will be set according to the level of the current line. The set level then appears on the information line and can be un-set by using the Un-set Threshold Level function. Set Until Condition . Enables you to set a conditional program breakpoint that causes execution to halt when the condition becomes true. This function is similar to a conditional breakpoint except that it is not tied to a particular COBOL statement but to the entire program. With a conditional program breakpoint, the Animator tests the condition before executing each statement and halts if it is true. The condition must conform to the syntax rules for COBOL conditions. You can set only one Until breakpoint in a program. Split Text . Enables you to split a screen horizontally in two at the current cursor position. You must have a minimum of four lines in a split screen. When you have split the screen, you can execute in either half. The Exchange function moves the cursor between the halves. Split-screen mode is particularly useful if you wish to query data declarations or a set of variables in one screen while executing in the other. Start . Makes the first executable statement in the program the current statement. No code is executed. This function does not change the value of any data, so if you use this function to test your program as though you had not executed any code, make sure you reinitialize all of your variables before continuing. Step . Executes the current statement and places the cursor on the next executable statement, which it also highlights. Step Perform . Causes execution of the entire PERFORM range or subprogram in Zoom mode if the current statement is a PERFORM or CALL statement. Execution stops on the statement following the end of the PERFORM range or subprogram. Text . Changes the display of a queried data item to text format and changes the menu displayed if accessed from the Query data-name menu. You can type over the data using either text or hexadecimal code. Alternatively, if accessed from the Animator Main menu, this function displays the Text menu which is described in the section Menus. For a description of the functions on this menu see Split Text, Join Text, Refresh Text and Edit Text. This Program Break . Sets a program break; that is, a breakpoint that occurs when the selected program is re-entered. For example, if This Program Break specifies a program break for the current program, a breakpoint will occur when the program is re-entered after a subprogram call. Un-set Backtrack . Stops the recording of the execution path. Un-set Breakpoint . Cancels a breakpoint at the current cursor position. Un-set Threshold Level . Cancels the current Threshold Level. See Set Threshold Level. If no level is set, then the information line displays the message: Threshold-level = un-set Un-set Until Condition . Cancels the Until Condition if one is active. See the Set Until Condition function. Up-list . Displays the previous item in the list of values for the queried data item. Up Perform Level . Enables the current execution path to be examined at the PERFORM level. This shows where execution will return to when the current PERFORM range is exited. The related function, Down Perform Level, cancels the result of Up Perform Level.
NOTE The Up-perform-level and Down-perform-level functions are not available and do not appear on the menu for base Animator or for Micro Focus COBOL for UNIX.
Up-table . Displays the contents of the previous table entry. The display of the variable used as the table subscript (shown with the data name) reflects the current value and is changed by this function. This query function is active only when a table data item is being queried. If you select an entry that is before the first table entry, a warning beep is sounded. Update List . Changes the value of the displayed item in a list of Query data to a new value which you key in. View. Enables you to view the user screen during animation. The screen changes whenever you execute a statement that echoes a character to the screen. Press any key to return to the source code, unless you are using cross-session animation and you have specified the HOLDVIEW"n" directive, in which case the Animator screen will return automatically after n seconds. View has no effect if you are using cooperative animation. Watch Monitors . Causes the contents of all variables on the current line to be displayed as monitors in the bottom right-hand part of the screen. Using the Watch command a second time causes a single step (see the Step function), updating the contents of the monitors. Using the Watch command a third time removes the Watch monitors created for the previous statement and creates a new set for the current line. Thus, this function enables you to examine the before and after states of variables for any given statement with the minimum of keystrokes. Watch monitors are treated differently than normal monitors: they overlay any normal monitors in the bottom right-hand portion of the screen. The Organize Monitors function makes the watch windows revert to normal monitor windows. A Watch monitor is not created for a field which is already being monitored in some way. Other Query commands treat Watch monitors as normal monitors. Not available in base Animator.
NOTE If the Watch monitors are turned into normal monitors, any subscripted items are monitored with the value of the subscript at the time of conversion.
Watch-off . Removes all watch monitors. Not available in base Animator. Wch. See the Watch Monitors function. Where . Moves the cursor to the start of the current statement, and repositions the program text so that the current statement becomes the third line on the screen. Window-size-left/right/up/down. Enables you to define a new corner for your monitor at the cursor position. Once you have placed the cursor where you want your new corner, use the redraw function to have your monitor updated. Not available in base Animator. Word Left . Moves the cursor to the previous word in the program text. If the cursor is positioned on the first word on a line, this function moves the cursor to the last word on the previous line and scrolls the text if necessary. Word Right. Moves the cursor to the next word in the program text. If the cursor is positioned on the last word on a line, this function moves the cursor to the first word on the next line and scrolls the text if necessary. Zoom . Executes the program at full speed, displaying the user screen rather than the Animator screen containing the source code. You can break out of Zoom mode by pressing the sequence for Break (on DOS, Windows and OS/2) or by pressing Escape (on UNIX), unless your program is executing an Enhanced ACCEPT, in which case the Break or Escape terminates the ACCEPT, and animation continues. If you do not break out of Zoom mode, execution will continue until a STOP RUN statement is encountered. At this point the Animator screen is restored and Step mode resumed. Zoom Breakpoint. Sets a temporary breakpoint at the current cursor position and enters Zoom mode. When this breakpoint is encountered (or execution is interrupted for any other reason) the breakpoint is un-set. Not available in base Animator.