Some environment variables must be defined before running DSOM. Unless noted,
these environment variables are required in both the AIX and OS/2 environments.
HOSTNAME=<name>
Each machine that is running
DSOM must have its HOSTNAME variable set.
USER=<name>
USER specifies the name of the DSOM user running
a client program.
SOMIR=<file(s)>
SOMIR
specifies a list of files (separated by a colon on AIX and a semicolon on
OS/2) which together make up the Interface Repository. See Chapter 7, "The
Interface Repository Framework," for more information on how to set this
variable.
Note: For DSOM, it is preferable to use full pathnames in the list
of IR files, since the IR will be shared by several programs that may not
all be started in the same directory.
SOMSOCKETS=<name>
SOMSOCKETS specifies the name of the SOM Sockets
subclass that implements the sockets services.
Note: For Workstation DSOM, this variable is effectively ignored.
(However, it may be used by the Event Management Framework.)
SOMDDIR=<directory>
SOMDDIR specifies the directory where various DSOM
files should be located, including the Implementation Repository files.
See the later section in this chapter entitled "Registering servers and
classes" for more information.
Note: If this value is not set, DSOM will attempt to use a default
directory: $SOMBASE/etc/dsom on AIX, and %SOMBASE%\ETC\DSOM on OS/2.
SOMDPORT=<integer>
In DSOM, servers, clients and DSOM daemons communicate
with each other using a "sockets" abstraction. In particular DSOM clients
establish connections to DSOM servers by communicating with the DSOM daemon,
somdd, running on each server machine. The daemon is designed to
listen for client requests on a well-known port.
Normally, somdd will look in the /etc/services (for AIX) or %ETC%\SERVICES
(for OS/2) file for its well-known port number. However, if the user has
set the SOMDPORT environment variable, the value of SOMDPORT will be used
and the "services" file will not be consulted. The user should pick a 16-bit
integer that is not likely to be in use by another application (check the
"services" file for ports reserved for use on your machine). Typically,
values below 1024 are reserved and should not be used.
Note: If there is no "services" file and the SOMDPORT environment
variable is not set, DSOM will use a default port number (currently 9393).
SOMDTIMEOUT=<integer>
SOMDTIMEOUT
specifies how long a receiver should wait for a message. The value should
be expressed in seconds. The default value is 600 seconds (10 minutes).
SOMDDEBUG=<integer>
SOMDDEBUG
may optionally be set to enable DSOM run-time error messages. If set to
0, error reporting is disabled. If set to 1, error reporting is enabled.
Error reports may be directed to the file named by SOMDMESSAGELOG, if set.
SOMDMESSAGELOG=<file>
SOMDMESSAGELOG
may optionally be set to the name of a file where DSOM run-time error messages
are recorded. If not set, error messages will be reported on the standard
output device.
SOMDNUMTHREADS=<integer>
SOMDNUMTHREADS
may optionally be set to the maximum number of requests threads created
per server. If SOMDNUMTHREADS is not set, then a separate thread will be
created for each request. This environment variable is only supported on
OS/2.
Note: You may want to verify your environment variable settings by running
somdchk. See "Verifying the DSOM environment with 'somdchk' later
in this chapter.
[Back: Configuring DSOM Applications]
[Next: Registering class interfaces]