![]() | 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 via the run-time switch +A, or the debug_on_error
run-time tunable; for example:
COBANIMOPT=mixedlangdebug export COBANIMOPT cobrun +A example.int
This section describes the Animator directives.
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.
Specifies whether to load and save Animator session information.
>>-.----.---COBAIF------------+ .-NO-+
None
COBAIF"idy-path"
The Animator information file contains details of breakpoints and monitors. Its extension is .aif.
If no COBAIF directive is specified, the default behavior is to save and load the information files in the directory where the .idy file is found. If NOCOBAIF is specified, no information files are loaded or saved. If COBAIF is specified the information files are saved and loaded in the current directory is used.
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 use the _t versions of the Animator commands as described in Animator Command Line. For information on the advantages and disadvantages of using MULTITHREAD, see the section Multi-threading and 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 these leading zeros.
Copyright © 1999 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 | ![]() |