HP 3000 Manuals

Functions [ COBOL/HP-UX Operating Guide for the Series 700 and 800 ] MPE/iX 5.0 Documentation


COBOL/HP-UX Operating Guide for the Series 700 and 800

Functions 

Animator functions are accessed from menus.  The function-names are
sometimes abbreviated on the menus; however, this description uses 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
route to access a given function, follow the sequence of keystrokes.  For
example, to reach the Set Breakpoints function, from the Animator Main
menu, press the Breakpoints key (B) followed by the Set Breakpoints key
(S).

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 the 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 

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                          A, Ctrl 

Cursor-name Locate               L, C 

Cursor-name Query                Q, C 

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 Condition          E, U 

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, <-/up arrow/->/down arrow 

Next Reset                       R, N 

Next-if                          I 

On Count Breakpoint              B, O 

Organize Monitors                Q, O 

Page Left/Right                  Ctrl + <-/->

Perform-level                    P 

Query                            Q 

Query data-name                  Q, C 

Query data-name Alternate        Q, C, Alt 

Quit-perform                     R, Q 

Redraw                           Q, C, Alt+F10, F9 

Refresh Text                     T, R 

Repeat Query                     Q, R 

Reset-execution                  R 

Same Level                       Q, C, F9 

Scroll Up/Down                   Ctrl+F9/F10 

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- left/right/up/down  Q, C, Alt+F10, F5/F6/F7/F8 

Word <                           F9 

Word >                           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.

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 allows 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.

Not available in Base Animator.

Alter Path  

Searches for a file on a different path from the one you originally
specified.  You may enter any valid path specification, but you must
terminate it with a directory separator (/).

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 you to change the speed of execution and
allowing you to enter Zoom mode.

Not available in Base Animator.

Breakpoints 

Displays the Breakpoints menu which is described in the section "Menus"
 earlier in this chapter.  For a description of the functions on this
menu, see Cancel All Breakpoints, Do At Breakpoint, Examine Breakpoints,
If Breakpoints, On Count Breakpoint, Set Breakpoint, Un-set Breakpoint,
Zoom 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.

Cursor-name Locate  

Finds the location in the source code where a data item, file-name or
procedure is declared.

The cursor control keys can be used to position the cursor in the program
text, structure diagram, or monitor window.  Data items and file-names
may be located either from their monitor windows or name in the text.
Procedure-names may be located from their names within the program text.

Cursor-name Query  

Displays the contents of the data item at the current cursor position.
It gives you access to other functions which allow 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 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 in a window or 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 allows 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 may 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.

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. 

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 allows the current
execution path to be examined at the PERFORM level.

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 active only 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"
 earlier in this chapter.  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 up arrow 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 down arrow 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 next COBOL statement that has a
breakpoint set on it.  After displaying the last breakpoint in the
program, the function displays the first breakpoint in the program.

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 allows you to see the contents of the current Until
Condition.  See the Set Until Condition function.

Not available in Base Animator.

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 in 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 = 1 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 #.  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 screen 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 that 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 (zoom) is created at compilation time and may be
altered using the FLASH 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 Ctrl+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 reappear on the screen only if their value
changes or if a text refresh is done.

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.

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 allowed 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 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 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, Enter-name Locate, Up Perform Level and Down Perform Level.

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.  Not available in Base Animator.

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 allowed 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.

Not available in Base Animator.

Monitor-off  

Switches off the monitor display of a queried data item.  See also Hide
Monitors.

Monitor-slide 

Toggles to allow 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 use the cursor keys to move the
window in the appropriate direction.

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.

The frequency must be in the range 2 to 255 inclusive.  Once the
frequency has been entered, the normal Breakpoint menu appears, allowing
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.

Page Left/ Right (Ctrl+<-/->) 

Enables you to scroll either the previous or the next page onto the
screen, line by line, by using the <- or the -> key respectively.

Perform-level 

Displays the Perform-level menu which is described in the section "Menus"
 earlier in this chapter.  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"  
earlier in this chapter.  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"  earlier in this chapter.  For a description of the functions
on this menu, see Contained Data, Containing Data, Down-table, Hex,
Hex/ASCII, Same Level and Up-table.

Query Data-name Alternate 

Displays the Query Data-name Alternate menu, which is described in the
section "Menus"  earlier in this chapter.  For a description of the
functions on this menu, see Add List, Alter Monitor Window, Delete List,
Down List, Insert List Left, Insert List Right, Locate-declaration,
Move-window, Redraw, Up-List, Update List and Window-size.

Query Data-name Control 

Displays the Query Data-name Control menu, which is described in the
section "Menus"  earlier in this chapter.  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 Text  

Refreshes the display of all monitors and the source text.

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"  earlier in this chapter.  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  

Scrolls the text rapidly towards the beginning (Up) or end (Down) of the
file.  Press any key to stop scrolling in either direction.

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.

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.

The Threshold Level remains set until you explicitly change it.

Set Until Condition  

Enables you to set a conditional program breakpoint that causes execution
to halt when the condition becomes true.  This function operates only if
you are in Go or Zoom mode.

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 vertically 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"  
earlier in this .  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.

You must set the program break before using the Zoom command.

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, 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 when the current PERFORM range is
exited.  The related function, Down Perform Level, cancels the result of
Up Perform Level.

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
message appears.

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 from 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 

Enable 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 < 

Moves the cursor to the previous word in the program text.  If the cursor
is positioned on the first word on a line, the function moves the cursor
to the last word on the previous line and scrolls the text if necessary.

Word > 

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 Escape, unless your program is executing a Micro
Focus format ACCEPT, in which case the 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.

Default Animator Function Keys 

The table below shows the default keystrokes assigned to the Animator
functions.  For a list of the keystrokes assigned to UNIX, see Appendix N
, UNIX Key Usage Chart.

          The Default Animator Function Keys 

 Function Key           Meaning          Default Key 
    Number 

     0-64      Function keys 0 to 64     KEY_F (0-64)
      65       Escape                    Esc
      66       Page Up                   KEY_PPAGE or Ctrl+U
      67       Page Down                 KEY_NPAGE or Ctrl+D
      68       10xPage Up                KEY_SR or Ctrl+B
      69       10xPage Down              KEY_SF or Ctrl+F
      70       Top of source             Ctrl+T
      71       Bottom of source          Ctrl+V



MPE/iX 5.0 Documentation