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 |
| END | End directives to Animator and begin directives for user program |
| 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 Environment Variables in your 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:
Indicates the end of directives to Animator and start of command line parameters to your program.
>>-.---.--END------------------------------><
.-/-+ None
Not present
This directive can be followed by text for use in ACCEPT ... FROM COMMAND-LINE.
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 © 2007 Micro Focus (IP) Ltd. All rights reserved.