| Component Frameworks |
This appendix describes the available switches for the OO support in the run-time system. Each entry describes the effect of the switch when it is set on. The default setting which applies if you do not explicitly set any of these switches is also given.
All OO RTS switches are set in the environment variable OOSW. Specify a minus "-" before a switch to turn it off, and a plus "+" to turn it on. You can concatenate several switch settings into OOSW at a time. For example:
OOSW=-v+d export OOSW
turns off the v switch and turns on the d switch.
Switch names are all case sensitive.
The following switches are available:
| d | Debug switch. |
| f | Set name of trace file. |
| lfilename | Class Library load switch. |
| t | Generate trace file. |
| +g1 | Set guard page before Object-Storage and memory allocations |
| +g2 | Set guard page after Object-Storage and memory allocations |
Enables debugging by preventing reuse of object handles from finalized objects.
| Default: | -d |
In normal operation, each time an object is finalized its object handle is available for reuse by the run-time system and can be assigned when a new object is created. Setting +d prevents the run-time system from reallocating object handles.
Do not use this switch for production applications - the run-time system can eventually run out of memory to allocate new handles. For more information, see the section Preventing Reallocation of Object Handles in the chapter Debugging Object COBOL Applications.
Enables you to name the message trace file. Properties:
| Default: | +ftrace.log |
Setting this switch to -f also has the effect of naming the log file trace.log.
Sets a guard page before Object-Storage sections and before memory allocated through class library method "malloc".
| Default: | -g1 |
You cannot set +g1 and +g2 at the same time. Only set +g1 when debugging as it increases memory overhead.
This switch is not available on all UNIX platforms. Check the release notes for your platform.
Sets a guard page after Object-Storage sections and after memory allocated through class library method "malloc".
| Default: | -g2 |
You cannot set +g1 and +g2 at the same time. Only set +g2 when debugging as it increases memory overhead.
This switch is not available on all UNIX platforms. Check the release notes for your platform.
Sets the Class Library to be preloaded by the run-time system.
| Default: | +lclass |
Set the class library load switch to -l to disable loading of the Class Library. You can use this if you want to animate classes (see the section Animating the Class Library in the chapter Introduction to the Class Library).
If you have your own class library in a .lbr file, you can load that instead of the Micro Focus Class Library. Set:
+lfilename
You can load more than one class library with the +l switch; separate the names with colons ":". For example:
+llib1:lib2
Do not leave any spaces between the names.
Generate a trace file showing every message sent by your application.
| Default: | -t |
A trace file shows you the messages sent by your application and is useful for debugging. Do not set this switch when running production applications - trace slows down execution, and the log file will grow in size continuously while the application runs.
Copyright © 1999 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names
used herein are protected by international law.
| Component Frameworks |