HP 3000 Manuals

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

Descriptions of Directives 

Descriptions for all of the Animator directives 
appear alphabetically.  Each description contains the following entries.

Key.   

Syntax: 


            

Shows the syntax of the Animator directives using diagrams called
railroad tracks, 
in which a directive and its parameters are shown joined by lines
indicating the order in which they should be written.  You read these
diagrams left-to-right.  Each diagram starts with right triangle, right
triangle and ends with right triangle, left triangle.  Sometimes the
track forks to show alternatives and then joins up again.  The length of
a track has no significance.

Parameters for directives are shown in quotation marks (" ") or after the
equals sign (=), although parentheses can be used instead, unless
otherwise stated.  Remember that if you use quotation marks or the equals
sign, you must escape them using the backslash character (\).  For
details on setting Animator directives, see Chapter 4 , Animating.

Parameters: 

Lists and describes valid parameter(s), if any, for the directive.

Default: 

Indicates the directive's default setting.

$SET: 

Shows whether you can put the directive on a $SET statement in your
source program; "Initial" in this entry means it is allowed only on an
initial $SET statement.

8BITCHAR 

Controls the display of characters with ASCII values which are not in the
ranges x"20" to x"7E" and x"A0" to x"FE".  Setting this directive on
allows these characters to be sent to the terminal for display when
querying an item in text mode.

Syntax: 


            

Parameters: 

None

Default: 

NO8BITCHAR

If this directive is not set, then such characters are displayed as the ^
symbol.

ANIMINT 

This directive allows you to select the user interface program to be used
when you invoke ANIMATOR. The interface program that you supply for
program-name can be either basanim, advanim or anmint.  You do not need
to include an extension when specifying a Micro Focus interface
program-name.

Syntax: 


            

Parameters: 

program-name         Name of an interface program which controls the way
                     in which Animator performs

Default: 

ANIMINT=anmint

This directive is reserved for use with add-on products supplied by Micro
Focus.  Do not change its setting unless you have an appropriate add-on
product.

BREAK 

Sets a breakpoint at the specified paragraph or section.

Syntax: 


            

Parameters: 

proc-name            Name of a paragraph or section in the program being
                     animated

Default: 

NOBREAK

BREAKPOINTS 

Specifies the number of breakpoints that can be set in any one program.

Syntax: 


            

Parameters: 

integer              Integer between 4 and 100 defining the number of
                     breakpoints allowed.

Default: 

BREAKPOINTS "100"

Only 12 bytes are allocated for each breakpoint you allow for, so you
need only change this value if you are very short of memory.

With cross-session or cooperative animation, the number of breakpoints
allowed defaults to 4 and cannot be changed.

COBAIF 

Specifies where to load and save Animator session information.

Syntax: 


            

Parameters: 

path-name            The location of the Animator information file

Default: 

COBAIF

Specifying COBAIF causes Animator to load and save session information
for the current program.  The information file contains details of
breakpoints and monitors.  Its extension is .aif.  Animator will look for
an .aif file in the path list defined by the COBAIF environment variable.
See Appendix I , Environment Variables for details.

If you specify COBAIF with no parameter, Animator will first look for the
.aif file in the current directory.

If you accept the default, Animator will first look for the .aif file in
the directory that contains the .idy file.

Specifying path-name overrides the COBAIF environment variable, causing
Animator to look for the .aif file in the location specified.

END 

Indicates the end of directives to Animator and start of parameters to
your program.

Syntax: 


            

Parameters: 

None

Default: 

Not present

FILECASE 

Controls whether or not Animator converts file-names to upper case for
use in comparisons.

Syntax: 


            

Parameters: 

None

Default: 

NOFILECASE

FLASH 

Sets the default condition under which Animator will automatically
display the user screen.

Syntax: 


            

Parameters: 

mode                 The mode in which Animator will display the user
                     screen

Default: 

FLASH "ZOOM"

The possible values of mode are:

STEP                  Display user screen before executing each
                      statement.

ZOOM                  Display user screen before zooming.

This directive is reserved for use with add-on products supplied by Micro
Focus.  Do not change its setting unless you have an appropriate add-on
product.

The setting can be altered from within Animator.

Using this directive, you can make Animator display the user screen
before it calls a subprogram written in another language.  This will
prevent the subprogram's output overwriting the Animator screen.

FLASH-CALLS 

Makes Animator display the user screen at every CALL statement and
whenever a PERFORM statement is stepped over.

Syntax: 


            

Parameters: 

None

Default: 

NOFLASH-CALLS

This should be used when the program being animated makes calls to
non-COBOL programs that write to the screen.

HIGHLIGHT/ HILITE 

Specifies whether or not to highlight the line that the Animator is
currently on.

Syntax: 


            

Parameters: 

None

Default: 

HILITE/ HIGHLIGHT

RESEQ 

Makes COBOL line sequence numbers appear on Animator's display of the
source.

Syntax: 


            

Parameters: 

None

Default: 

RESEQ

Do not use this if the program contains ++INCLUDE or -INC statements.

SCREENPAGE 

Causes the screen to page up or down when you scroll to or Step to a line
of code not displayed on the current screen.  When you do this, the
current line appears either as the third line from the top of the next
screen or the third line from the bottom of the previous screen.

Syntax: 


            

Parameters: 

None

Default: 

SCREENPAGE

If this directive is not set, you can scroll or Step continuously through
your source code.

ZOOM 

Invokes Animator in zoom mode

Syntax: 


            

Parameters: 

program-name         Zoom until this subprogram is entered.

Default: 

NOZOOM

In zoom mode, Animator executes the program at full speed, displaying the
user screen rather than the source code.

MPE/iX 5.0 Documentation