| Working With Animator | Debugging Tutorials | |
This chapter describes the Animator directives you can use to control the animation of your program.
The following Animator directives are available:
| Directive |
Function |
|---|---|
| COBAIF | Load/save Animator session information |
| MIXEDLANGDEBUG | Set limit on breakpoints |
| MULTITHREAD | Use multi-threaded run-time system |
| RESEQ | Display line sequence numbers in the Animator's source display |
| ZEROSEQ | Display leading zeros in the sequence numbers in columns 1 through 6 |
The COBANIMOPT environment variable enables you to specify directives
additional to those specified on the command line. It is particularly
useful if you invoke Animator using the run-time switch +A, or the debug_on_error
run-time tunable; for example:
COBANIMOPT=mixedlangdebug export COBANIMOPT cobrun +A example.int
Descriptions for all of the Animator directives appear alphabetically. Each description contains the following entries.
A brief description of the function of DIRECTIVE-NAME.
>>--.----------DIRECTIVE-NAME=parameter(s)---.-----><
.--.----.--DIRECTIVE-NAME----------------+
.-NO-+
The syntax of the Animator directives is shown using diagrams called "railroad
tracks". These show a directive and its parameters joined by lines
indicating the order in which they should be written. You read these
diagrams from left to right. Each diagram starts with >>
and ends with >< . Sometimes the track forks to show
alternatives and then joins up again. The length of a track has no
significance.
Lists and describes valid parameters, if any, for the directive.
Indicates the directive's default setting.
Contains any additional information about the directive.
This section describes the Animator directives.
Specifies whether to load and save Animator session information.
>>-.----.---COBAIF------------>< .-NO-+
None
COBAIF
The Animator session information file contains details of breakpoints and monitors. Its extension is .aif.
If NOCOBAIF is specified, no session information files are loaded or saved. If COBAIF is specified, the session information files are saved and loaded in the current directory.
You can specify the directory in which Animator searches for or creates the .aif file using the $COBAIF environment variable; see the appendix Micro Focus Environment Variables in your Server Express User's Guide for details.
Note: Animator session information files are only loaded or saved by Animator if Animator is started using the anim or anim_t command. A session information file is not loaded or saved if, for example, you:
Use non-system level debugging. Enables mixed-language debugging.
>>--.----.---MIXEDLANGDEBUG------------><
.-NO-+
None
NOMIXEDLANGDEBUG
Use the multi-threaded run-time system, enabling you to debug multi-threaded applications.
>>-.----.--MULTITHREAD----------------------><
.-NO-+
None
NOMULTITHREAD
This directive creates a multi-threaded environment within which your multi-threaded programs can run.
You can use either this directive to enable Animator to execute multi-threaded programs, or the _t versions of the Animator commands as described in the section Starting Animator From the Command Line in the chapter Starting Animator. For information on the advantages and disadvantages of using MULTITHREAD, see the section Multi-threading and Animator in the chapter Starting Animator.
Specifies that COBOL line sequence numbers should appear on the Animator's source display.
>>-.----.--RESEQ----------------------><
.-NO-+
None
RESEQ
Do not use RESEQ if the program contains ++INCLUDE or -INC statements.
Specifies that leading zeros should appear in the sequence numbers in columns 1 through 6.
>>-.----.--ZEROSEQ----------------------><
.-NO-+
None
NOZEROSEQ
NOZEROSEQ suppresses leading zeros.
Copyright © 2000 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names
used herein are protected by international law.
| Working With Animator | Debugging Tutorials | |