PreviousWorking With Animator Debugging TutorialsNext

Chapter 4: Directives for Animator

This chapter describes the Animator directives you can use to control the animation of your program.

4.1 Animator Directives Summary

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.

4.2 Using COBANIMOPT

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

4.3 Description of Directives

This section describes the Animator directives.

4.3.1 Key to 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.

Syntax:
>>--.----------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.

Parameters:

Lists and describes valid parameters, if any, for the directive.

Default:

Indicates the directive's default setting

Comments:

Contains any additional information about the directive.


COBAIF

Specifies whether to load and save Animator session information.

Syntax:
>>-.----.---COBAIF------------+ 
   .-NO-+
Parameters:

None

Default:

COBAIF"idy-path"

Comments:

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.


MIXEDLANGDEBUG

Use non-system level debugging. Enables mixed-language debugging.

Syntax:
 >>--.----.---MIXEDLANGDEBUG------------><  
     .-NO-+
Parameters:

None.

Default:

NOMIXEDLANGDEBUG


MULTITHREAD

Use the multi-threaded run-time system, enabling you to debug multi-threaded applications.

Syntax:
 >>-.----.--MULTITHREAD----------------------><  
    .-NO-+
Parameters:

None

Default:

NOMULTITHREAD

Comments:

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.


RESEQ

Specifies that COBOL line sequence numbers should appear on the Animator's source display.

Syntax:
 >>-.----.--RESEQ----------------------><  
    .-NO-+
Parameters:

None

Default:

RESEQ

Remarks:

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


ZEROSEQ

Specifies that leading zeros should appear in the sequence numbers in columns 1 through 6.

Syntax:
 >>-.----.--ZEROSEQ----------------------><  
    .-NO-+
Parameters:

None

Default:

NOZEROSEQ

Remarks:

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.
PreviousWorking With Animator Debugging TutorialsNext