User Guide

10.5 HotFix 2
- 10.5 HotFix 1
- 10.5
- 10.2 HotFix 1
- 10.2
- 10.1
- 10.0 HotFix 1
- 10.0

Back Next

Environment Variables

Environment variables are used to control certain aspects of the Data Clustering Engine’s behaviour. Most of them are set in various scripts, which are modified when the DCE is installed and/or initially configured. They can also be added or changed from the Settings window within the DCE Console, except the SSA_XXHOST and SSA_XXPORT variables, which must be set before the DCE Server is launched.

SSA_DCETHREADS: Used to define the maximum number of threads used by the clustering process. Refer to the
Utilizing multiple CPUs
section for more details.
SSACACHEOPT: Defines the internal workings of the database cache( For internal use only).
SSACACHEOPT=option-string
where
option-string
is a series of characters, one per option:; Option1: file buffering

d
default buffering

o
no buffering

b
buffer size set to SSABSIZE; Option2: cache allocation strategy

n
preallocate whole cache at startup

l
lazy allocation (demand based)
SSACACHESIZE: Defines the size of the memory cache established by SSA-DB. The default size is operating system dependent and is 4MB in almost all cases.
SSACACHESIZE=n[b|k|m|g]
where

n
Represents the number of allocation units

b
Blocks (2048 bytes)

k
Kilo-bytes (kB)

m
Mega-bytes (MB)

g
Giga-bytes (GB)
SSAEXTENTSIZE: Defines the maximum extent size when creating a Large File.
SSAEXTENTSIZE=n[k|m|g]
where

n
Represents the number of allocation units

k
Kilo-bytes (kB)

m
Mega-bytes (MB)

g
Giga-bytes (GB)

The actual size of each extent is actually one less that the size nominated by this parameter. Refer to the
Large File Support
section for more details.
SSAJAVA: The name of the Java executable. Usually set to "java".
SSALDR_KEYTH: The Loader utility
LOADIT
automatically creates n key generation threads, where n is the number of CPUs available. You may override this value by setting an environment variable SSALDR_KEYTH=n.
SSALDR_RBSIZE: The Loader utility
LOADIT
uses this environment variable to control the memory usage of its Reader thread. For example,

SSALDR_RBSIZE=5000 allocates enough memory for 5000 input records (which is the default value for this setting).

This variable is also used to calculate the size of the key generation output queues. They are calculated as
SSALDR_RBSIZE / number_of_key_threads * 8
SSAOPTS: This environment variable is used for setting tracing and logging level.; Some times Informatica Corporation Technical Support personnel may ask you to set this to other values to help Informatica to assist you in any problem situations. Refer to the
Troubleshooting
section for further details.
SSAPR: When using the SSA-NAME3 Version 2 Standard Populations rules, the SSAPR variable needs to be set to the pr directory. This variable is normally set during the DCE installation procedure. If using a SSA-NAME3 population directory from another location, this variable can be set from the DCE Console’s
Settings Environment Settings
dialog.
SSASORTMEM: Used to define the maximum amount of memory to be used by SSA-SORT. It accepts sizes in bytes/k- B/MB/GB.
SSASORTMEM=n[k|m|g]
SSAWORKDIR: The DCE Server uses the value of the SSAWORKDIR environment variable as its default working directory. All the files that the Server creates are placed in to this directory unless the Console Client or the Project definition override this setting.
SSA_CSHOST: The TCP/IP
host:port
address of the DCE Console Server.
SSA_CSPORT: The TCP/IP
port
number on which the DCE Console Server is listening.
SSA_RBHOST: The TCP/IP
host:port
address of the DCE Rulebase Server.
SSA_RBPORT: The TCP/IP
port
number on which the DCE Rulebase Server is listening.
SSA_SEHOST: The TCP/IP
host:port
address of the DCE Search Server.
SSA_SEPORT: The TCP/IP
port
number on which the DCE Search Server is listening.
SSA_RBNAME: The default value for the Rulebase name in format
sdb:file:path/filename

When the DCE Console is launched, it connects to the Rulebase Server listening on the address specified in SSA_RBHOST and tries to open the Rulebase named in this parameter. The file name extension
".db"
is automatically added to the given
filename
.

If this Rulebase does not exist, the user is prompted whether or not it should be automatically created at that point.
This environment variable should contain the name of the Rulebase as seen on the computer running the Rulebase Server.

You cannot use the same
filename
for the Rulebase and a Project to be stored in the same SSAWORKDIR as this will lead to a file naming conflict.

n	preallocate whole cache at startup
l	lazy allocation (demand based)

n	Represents the number of allocation units
b	Blocks (2048 bytes)
k	Kilo-bytes (kB)
m	Mega-bytes (MB)
g	Giga-bytes (GB)

d	default buffering
o	no buffering
b	buffer size set to SSABSIZE

Rename Saved Search

Table of Contents

User Guide

User Guide

Environment Variables

Environment Variables