SOM (OS/2)

Appendix A: Descriptions of OO Run-time Switches

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:

Windows and OS/2: 
set oosw=-v+d

UNIX: 
OOSW=-v+d
export OOSW

turns off the v switch and turns on the d switch.

16-bit :
Switch names are not case sensitive.

32-bit :
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

A.1 List of Switches

d - Debug Switch

Enables debugging by preventing reuse of object handles from finalized objects.

Properties:

Default:	-d
Environment:	All

Remarks:

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.

f - Trace File Name

Enables you to name the message trace file.

Properties:

Default:	+ftrace.log
Environment:	32-bit

Remarks:

Setting this switch to -f also has the effect of naming the log file trace.log.

g1 - Guard page before storage

Sets a guard page before Object-Storage sections and before memory allocated through class library method "malloc".

Properties:

Default:	-g1
Environment:	32-bit

Remarks:

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.

g2 - Guard page before storage

Sets a guard page after Object-Storage sections and after memory allocated through class library method "malloc".

Properties:

Default:	-g2
Environment:	32-bit

Remarks:

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.

l - Class Library Load Switch

Sets the Class Library to be preloaded by the run-time system.

Properties:

Default:	+lclass
Environment:	All

Remarks:

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 .dll (Windows and OS/2 only) or .lbr file, you can load that instead of the Micro Focus Class Library. Set:

+lfilename

Windows and OS/2:
You can load more than one class library with the +l switch; separate the names with semicolons ";". For example:

+llib1;lib2

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

t - Trace File

Generate a trace file showing every message sent by your application.

Properties:

Default:	-t
Environment:	All

Remarks:

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.

16-bit :
The log file is named ootrace.lst.

SOM (OS/2)