Configuration Options

About Options

Except as noted, the following configuration options can be set for both DataFlux Data Management Studio and DataFlux Data Management Server. These options are typically set in the app.cfg file.
Note: When editing a configuration file, save it as an ASCII or UTF-8 file. If it is saved as a Unicode file, the software can fail to start and will log this error message: "Read failed due to missing file or possibly invalid content in 'c:\path\file.cfg.'"

Base or General Application Options

DEFAULT_UMASK
(Optional) On DataFlux Data Management UNIX server hosts, this specifies the default umask value to use when creating output files, such as the output files from jobs. The umask value must be numeric. If not set, the shell's umask value is used. Example: default_umask = 002.
ODBC_INI
(Optional) For DataFlux Data Management UNIX server hosts, this overrides the location of the odbc.ini file.
BASE/APP_CONTAINER_DOMAIN
(Optional) This identifies the authentication domain expected by the application container services. If it is not specified, the DefaultAuth value is used.
BASE/APP_CONTAINER_LOC
(Optional) This identifies where to locate the application container services. In most cases this is not required. If it is required, the value is typically an HTTP URI. In addition, app.cfg should always set this option to point to the metadata server (IOM://<host><port>).
BASE/APP_VER
(Optional) The application version number.
BASE/AUTH_DEFAULT_DOMAIN
(Optional) This identifies the default for resolving the identity domain.
In a metadata configuration, it is possible for the authenticated credentials to resolve the identity of a person who has multiple logins that use the same user ID. When more than one login matches the resolved user ID, the authentication domain for the presented credentials is determined in the following order:
  • BASE/AUTH_DEFAULT_DOMAIN — If the value of this option is specified and the specified value matches the authentication domain of one of the logins, then this is used. If this option is not specified, and if the specified value is not an authentication domain for one of the logins, the next rule is executed.
  • DefaultAuth — If DefaultAuth matches the domain of one of the logins, the presented credentials are associated with the DefaultAuth domain. If no match is found, continue to the next rule.
  • The first login — The authentication domain of the first login containing a user ID that matches the presented credentials is used.
BASE/AUTH_SEARCH_DOMAIN
(Optional) This specifies whether to search through all domain credentials. When set to true, the set of credentials associated with the current domain is searched to find a set that is usable by the given authenticated user. If multiple credentials are found, the first complete set is used.
BASE/AUTH_SERVER_LOC
(Optional) This specifies the location of the authenticating server and is typically specified during installation in the app.cfg file. If an authenticating server connection is attempted, but this option is not set, localhost:21030 is used as the host and port.
The basic format of the authentication server IOM URI is iom://<host>:<port>, where <host> is the name of the computer executing the authentication server and <port> is the port to contact the authentication server. If the authenticating server is a DataFlux Authentication Server, then the port should be specified as 21030 unless the default server has been changed.
If the authenticating server is a SAS Metadata Server, then the port should be 8561 unless the default server has been changed.
If your SAS Metadata Server is installed as a cluster of multiple hosts, then this option points to the metadata cluster profile. The pathname used by the option is the physical location that is recognized by the operating environment. The file must be accessible from the current process. The following example illustrates a typical value: BASE/AUTH_SERVER_LOC=c:\SAS\Config\Lev1\metadataConfig.xml The example includes the default name and location of the metadata cluster profile.
For information about valid encodings, see the SAS National Language Support (NLS): Reference Guide.
BASE/AUTH_SERVER_PASS
(Optional) This identifies the password to present when connecting to the authenticating server as defined by BASE/AUTH_SERVER_LOC
Typically, the BASE/AUTH_SERVER_LOC is specified during installation in the app.cfg file. Separating the user name (BASE/AUTH_SERVER_USER) and password (BASE/AUTH_SERVER_PASS) from the authenticating server location (BASE/AUTH_SERVER_LOC) enables you to run the batch command (dmpexec) with the authenticate option (-a) with individual credentials. For more information see “Running Jobs from the Command Line” in the DataFlux Data Management Studio: User's Guide.
(Optional) BASE/AUTH_SERVER_REPOSNAME
This identifies the name of the authenticating server metadata repository containing information to be searched when items are looked up in the metadata.
BASE/AUTH_SERVER_SSPI
(Optional) This identifies support for Security Support Provider Interface (SSPI). It enables support for single-sign on (SSO) to the SAS Metadata Server. The default is NO (no support for single-sign on). Specify YES to enable single-sign-on connections to the SAS Metadata Server from DataFlux Data Management Studio. Add this option to a user's app.cfg file or the default app.cfg file for DataFlux Data Management Studio. Do not set this option in the configuration files for DataFlux Data Management Servers.
BASE/AUTH_SERVER_USER
(Optional) This identifies the user name to present when connecting to the authenticating server as defined by BASE/AUTH_SERVER_LOC.
Typically, the BASE/AUTH_SERVER_LOC is specified during installation in the app.cfg file. Separating the user name (BASE/AUTH_SERVER_USER) and password (BASE/AUTH_SERVER_PASS) from the authenticating server location (BASE/AUTH_SERVER_LOC) enables you to run the batch command (dmpexec) with the authenticate option (-a) with individual credentials. For more information see “Running Jobs from the Command Line” in the DataFlux Data Management Studio: User's Guide.
BASE/DMSTUDIO
(Optional) This indicates whether to use the dmstudio process. If this option is set to true (value of 1), it indicates that the application is using the dmstudio process (not processes started by the application, like batch.cfg, for example). The user should not adjust or override this value.
BASE/DATE_FORMAT
(Optional) Specifies how to format dates. Possible values, if specified, are iso8601 and iso8601_no_milli. The later does not include the millisecond portion of the ISO8601 standard.
BASE/EMAILCMD
(Required). This option specifies the command that is used to send email. The command can include %T and %B where %T is replaced with the recipient and %B is a file containing the body of the message. Monitor event, as well as the architect node, use this option.
BASE/EXE_PATH
(Optional) This is the path containing executables. The user should never need to set this.
BASE/FTPGETCMD
(Required) This is the command used for FTP Get Functionality. This should default in the install, as follows:
  • %U: Replace with user name.
  • %P: Replace with password.
  • %S: Replace with server.
  • %T: Replace with local directory.
  • %F: Replace with Files to download, multiple separated by spaces.
  • %L: Replace with the log file to pipe the output.
BASE/FTPPUTCMD
(Required) This specifies the command used for FTP Put Functionality. This should default in the install the same as BASE/FTPGETCMD.
BASE/HIGH_PRECISION_TIMER
(Optional) This is a DAC log setting to allow higher precision timing at the expense of forcing all threads to CPU core 1. This is available only on Windows and can decrease multithreaded performance.
BASE/JOB_LOG_ENCODING
(Optional) This specifies the encoding for the job log on a DataFlux Data Management Server.
By default, the log is written in the encoding associated with the locale of the process for the executed job. For English-speaking organizations, this might be LATIN-1 or UTF-8. If a log line contains characters that cannot be represented in the encoding, the log line is not written to the log file. This option enables you to assign the encoding of the job log.
Note: This option must be set on the DataFlux Data Management Server where jobs are executed. It has no effect on DataFlux Data Management Studio job logs.
BASE/LIBRARY_PATH
(Optional) This is the path in which the Java JAR dependencies reside. The path is automatically determined (DFBCO_EXE_PATH/lib) by start-up code, so you should not need this setting in a configuration file.
BASE/LOGCONFIG_PATH
(Optional) This is the full path to the log configuration file. If set, this must be set in the application executable (dis.cfg, and so on) configuration file, not the app.cfg, or macros.cfg files. If it is not set, it defaults to logging.xml in the etc directory.
BASE/LOGEXCEPTIONS
(Optional) This is used for Exception logging and defaults to off. This must be set before starting the application of interest, because this setting is read only at start-up.
Set this option to either 1 or a combination of letters where: M = do not show module info, V = turn verbose on, U = install the Unhandled Exception Filter, C = install the continue Exception Filter, and f = do not install the first chance exception filter. Setting it to 1 shows all the information.
Note: This only works from DataFlux Data Management Studio, not DataFlux Data Management Server.
BASE/MACROS_PATH
(Optional) This is the path for system macros.cfg file. If not specified, this file is located in the etc subfolder of the installation folder.
BASE/MAINTAIN_GROUP
(Optional) This specifies whether to maintain the current execution group or job. When present in the configuration, the current process is queried to determine whether it is already in a group or job. If it is, the child processes stays in the existing group instead of being associated with a new group or job.
Note: If you use remote access software such as Citrix or Microsoft RemoteApps to run DataFlux Data Management Studio as a published application (not streamed), and jobs are failing due to a "CreateProcess() Access Denied" error, you should set the BASE/MAINTAIN_GROUP=YES option in the app.cfg file on the computer where the DataFlux Data Management Studio jobs are executed. If you do not set this option, the jobs will not execute.
BASE/MESSAGE_LOCALE
(Optional) This specifies which error message locale to use. If not specified, it is determined from the system locale.
BASE/MESSAGE_LEVEL
(Optional) This specifies the error level of messages. Possible values include 0 (or not specified) for normal messages or 1, which includes source file and line number in messages.
BASE/MESSAGE_PATH
(Optional) This specifies the path to the message directory. This setting is not needed in a configuration file because it is automatically determined by start-up code.
BASE/MONITOR_FREQUENCY
(Optional) Disabled by default, this enables the logging of job node statistics while a job is running. If this option is disabled (or its value is -1), then node statistics are logged only when the job has finished executing.
If you want to log node statistics while the job is running, specify the number of milliseconds that the software should wait between logging statistics. The higher the frequency, the more run-time details about node execution are logged in to the job’s log file. However, the additional collection and logging of information affects the job’s performance.
Note: To enable monitor reporting, set the monitoring logger LOG_PREFIX_MONITORING. This provides monitoring information at job completion.
BASE/PLUGIN_PATH
(Optional) This is the path used by all subsystems to find plug-ins. This setting is not needed in a configuration file because it is automatically determined by start-up code.
BASE/PRIMARY_LICENSE
(Required) This is the primary licensing method. This needs to be set in the configuration file with a value of DATAFLUX or SAS.
BASE/PRIMARY_LICENSE_LOC
(Required) This is the server or file location for the primary licensing method.
BASE/REPOS_SYS_PATH
(Optional) This is the system path for repository configuration files and should be automatically determined by dfcurver.
BASE/REPOS_USER_PATH
(Optional) This is the user directory containing repository configuration files. It should be automatically determined by dfcurver.
BASE/REPOS_FILE_ROOT
(Optional) This overrides the root of the repository for URI lookups. If specified, this is used as the root for the repository when resolving the URI. The path in the URI is concatenated to this path to give the actual filename of a URI.
BASE/REPOS_EVENT_WAIT_QUERYMS
(Optional) This is the repository event processing wait time between processing queries. It specifies how frequently in milliseconds to query the repository for changes in the event table. This might need to be changed due to slow servers or IT issues. This is an overriding value and the default is used if no value is set by the user. A setting of -1 disables events from client.
BASE/REPOS_EVENT_CLEAN_TIMEMIN
(Optional) This sets the repository event processor that removes all events older than X minutes before start-up.
BASE/ROWSET_SIZE
(Optional) This sets the suggested RowSet size. If specified, the value is used to calculate the maximum number of rows each rowset collection should contain.
BASE/SECONDARY_LICENSE
(Required) This is the secondary licensing method. This must be set in the configuration file as either DATAFLUX or SAS.
BASE/SECONDARY_LICENSE_LOC
(Required) This is the location of the secondary license file or server and must be set in the configuration file.
BASE/SHARED_OUTPUT_PATH
(Optional) This is the directory in which to write shared output files. If set, some log and status files write files to this directory. If not set, it defaults to the value specified in "BASE/TEMP".
BASE/SORTBYTES
(Optional) This specifies the bytes to use when sorting.
BASE/SORTMERGES
(Optional) This specifies whether to merge when sorting.
BASE/SORTTEMP
(Optional) This specifies the temporary file location to be used during the sort. This can contain multiple directories separated by the appropriate host path separator character (':' on UNIX and ';' on Windows).
Note: If the SAS sort is being used, this option's value is not used.
BASE/SORTTHREADS
(Optional) This specifies the number of sort threads.
BASE/SORT_KEEPVAR
(Optional) This specifies the short version of the global temporary record width conversion option. It enables a plug-in to locally set the BASE/SORT_KEEPVAR global option.
When this Boolean value is set to true, the temporary data file honors the variable-width record indicator at temporary data file creation time. When the value is set to false (default), the temporary data file sort support converts a variable-width file to a fixed-width file, if the record does not contain any string fields, or if the lengths of the string fields in a record are within the overhead threshold necessary to sort variable-width records. Set to true to mimic behavior prior to the 2.4 release.
Note: This is a significantly advanced parameter that should rarely be manipulated.
BASE/TEMP
(Optional) This is the directory in which to write temporary files. If not specified, the value of the TEMP/TMP environment variable value is used.
BASE/TEXTMINE_LITI_LANG_LOCATION
(Optional) This is a document extraction node option to specify the install location of Teragram text mining LITI Language file directory. This allows the user to find the LITI language files installed and present the user with the list of provided languages and LITI files for usage in contextual extraction. This option overwrites the default location of DFEXEC_HOME/share/liti.
BASE/TIME_BASE
(Optional) This specifies whether to use Greenwich Mean Time (GMT). Valid values are GMT and LOCAL, which is the default. If this is set to GMT, the current date returns in GMT instead of the localized time. This affects anything that uses the current date timestamp.
BASE/UPDATE_LEVEL
(Optional) This specifies the application update level. Defaults to 0. It can be used as a minor revision number.
BASE/USE_SASSORT
(Optional) This indicates whether the SAS sort is to be used. A Boolean is set to True to indicate that the SAS sort is to be used. If not specified or set to False, then the DataFlux Data Management sort is used.
BASE/USER_PATH
(Optional) In the GUI application, this represents the path where user configuration files are stored. This should be automatically determined by dfcurver.

Data Access Component Logging Options

DAC/DISABLESYSCATENUM
(Optional) This sets the enumeration of SYSCAT DSNs. When set to yes, 1, or true, this setting disables the listing of the SYSCAT type DSNs into DSNs that are on that server.
DAC/DFTKDISABLECEDA
(Optional) This disables CEDA support. Any value turns it on.
DAC/DFTKLOGFILE
(Optional) This sets the filename for the DFTK logging.
DAC/DFTK_PROCESS
(Optional) This specifies whether to run DFTK out of process. The default is off. Any value turns it on.
DAC/DFTK_PROCESS_TKPATH
(Optional) This specifies the TKTS path for DFTK when it is running out of process. This path defaults to a core/sasext directory off of the executable directory.
DAC/DSN
(Optional) This specifies the DSN directory for TKTS. The path defaults to DFEXEC_HOME/etc/dftkdsn.
DAC/SAVEDCONNSYSTEM
(Optional) This specifies the location of the system’s saved connections. The path defaults to DFEXEC_HOME/etc/dsn.
DAC/SAVEDCONNUSER
(Optional) This specifies the location of the user’s-saved connections. The path defaults to the user's application directory/DataFlux/dac/9.0.
DAC/TKTSLOGFILE
(Optional) This sets the filename for the TKTS logging.
DAC/TKTSLOGFLAGS
(Optional) This sets the TKTS logging flags. Enter a string containing a semi-colon delimited list of items that can include the following:
  • PARAM_DATA
  • INCOL_DATA
  • OUTCOL_DATA
  • TIMESTAMP
  • GETDATA
  • PUTDATA
  • APPEND
  • NOFLUSH

Monitor Options

MONITOR/DUMP_JOB_DIR
(Optional) This specifies a directory to store temporary jobs created by the business rule monitor so that they can be debugged. By default, this option is not set and the monitor does not store temporary jobs on disk.
MONITOR/BULK_ROW_SIZE
(Optional) This specifies the size of the bulk packet. The default value is 1000. This affects row-logging events, as well as historic custom and standard metrics. This value can be changed to enhance the performance of jobs that monitor business rules when those jobs include row-logging events.

Profile Options

PROF/DEBUG_MODE
(Optional) This sets the value for the frequency distribution (FRED) engine debug mode. Possible values include 0 (not debug mode) or 1 (debug mode). The default is 0.
PROF/LOCK_RETRIES
(Optional) This specifies the number of times to retry SQLite repository connection when a connect attempt times out. A value of -1 retries until a connection is established.
PROF/PER_TABLE_BYTES
(Optional) This sets the value for the frequency distribution engine per table bytes. You can use any numeric value. Default is -1 (frequency distribution engine default).
PROFCONFIG/MAXFREQCACHE
(Optional) This specifies the amount of memory in kilobytes that the frequency distribution engine uses. If not specified, the default is 128kb.

QKB Options

QKB/ALLOW_INCOMPAT
(Optional) This allows data jobs to run even when the software detects that a QKB definition invoked by the job was saved by a version of the software that is later than the current version of the software. Default is NO. The default behavior is for these definitions to fail to load. Results obtained when this option is turned on are undefined.
QKB/COMPATVER
(Optional) This tells DataFlux Data Management Studio which version of the QKB to use when running a data job. Possible values include dfpower82, unity21, unity22, or dmp21 through dmp26. If not specified, it defaults to the latest version. You can use this option if you want to use the latest version of DataFlux Data Management Studio, but want the outputs of your QKB-related Data Job nodes (for example, matchcodes) to be exactly the same as the outputs for earlier versions.
QKB/ON_DEMAND
(Optional) This loads QKB definitions on demand. Default is YES. The application start-up creates a QKB pool that sets the option for all consumers (Profile, Explorer, and Nodes) with the exception of the Expression Engine, which has its own initialization. Set this option to No to find errors within definitions and to see error messages specific to Pattern Logic nodes.
If used for a data job, this option allows QKBs to load definitions as needed instead of loading all of them at the beginning. These definitions are kept in memory for future runs that reuse that process.
If used for a service, each loaded service loads its own QKB. Once a service is loaded into memory and runs at least once, it keeps the QKB loaded from the previous run and does not have to be loaded again. Note that a QKB in memory is not shared across different services or threads, so each initiation of either a new service or a new thread for an existing service causes the QKB to be loaded. This could have an implication on memory and performance.
QKB/PATH
(Required by QKB products.) This is the path to QKB. The path is set to the default QKB as defined in the application.
QKB/SURFACEALL
(Optional) This surfaces all parse definitions in the Data Job interface, even definitions for which the "Surface" flag is unchecked in Customize. The default is NO.
Note: The application start-up creates a QKB pool that sets the option for all consumers (Profile, Explorer, and Nodes) with the exception of the Expression Engine that continues to have its own initialization.

Architect Client (UI) Settings Option

ARCHITECT/AutoPassThru
(Optional) This provides client options to set mappings. Maintained by the client, choices are 0 (target), 1 (Source and Target), and 2 (All). This determines whether data flow nodes should automatically fill their pass-through list from their parent nodes.

Architect and Miscellaneous Node Options (defined in ids.h)

CLUSTER/BYTES
(Optional) This specifies the bytes to use when clustering.
CLUSTER/LOG
(Optional) This specifies whether a clustering log is needed.
CLUSTER/TEMP
(Optional) This specifies the cluster temporary path.
FRED/LOG
(Optional) This specifies whether a FRED log is needed.
JAVA/CLASSPATHS
(Optional) This specifies the Java classpath. This overrides the Java class path for the Java plug-in node. You generally should not need to set this.
JAVA/DEBUG
(Optional) This specifies the Java debug options.
JAVA/DEBUGPORT
(Optional) This specifies the port to remotely debug Java.
JAVA/VMHEAP_INIT
(Optional) This specifies the initial size of the JVM in megabytes. This should be used if you are using JVM 1.6. Start at 16 and decrease if you keep getting errors.
JAVA/VMHEAP_MAX
(Optional) this specifies the maximum amount of heap space the JVM uses in megabytes. This should be used if you are using JVM 1.6. You can decrease this along with JAVA/VMHEAP_INIT.
VERIFY/CACHESIZE
(Optional) This specifies the cache size by percentage.
VERIFY/CANADA
(Required by SERP nodes) This specifies the path to the Canadian data. The Canada installation should maintain this.
VERIFY/GEO
(Required by Geocode) This specifies the location of the Geocode/Phone data. The Geocode installation should maintain this.
VERIFY/PRELOAD
(Optional) This preloads defined state data into memory for address verification. It is set in the app.cfg file. Valid value can be ALL.
VERIFY/USEDPV
(Optional) This enables or disables Delivery Point Value (DPV) processing to confirm that the address actually exists.
VERIFY/USEELOT
(Optional) This enables or disables Enhanced Line of Travel (eLOT) processing, which enables mailers to sort their mailings in approximate carrier-casing sequence using an eLOT sequence number and to qualify for enhanced carrier route presort discounts.
VERIFY/USELACS
(Optional) This enables or disables Locatable Address Conversion System (LACS) processing that enables mailers to identify and convert a rural-route address to a city-style address.
VERIFY/USERDI
(Optional) This enables or disables Residential Delivery Indicator (RDI) processing that confirms whether a particular address is residential or business.
VERIFY/USPS
(Required by the USPS) This specifies the USPS data path. This is maintained by the USPS installation.
VERIFY/USPSINST
(Required) This determines whether the USPS data is installed or if sample data is being used. This is maintained by the USPS installation.
VERIFYINTL/CFG
(Required by international verification) This is the address verification configuration file. The component’s installation should maintain the path.
VERIFYWORLD/DB
(Required for Platon) This specifies the Platon library universal unlock code. The component’s installation should maintain the path.
VERIFYWORLD/UNLK
(Required for Platon) This specifies the Platon data path. The component’s installation should maintain the path.
VERLQT/COUNTRY_INIT_FILTER
(Optional) This is a comma-separated list of two-letter country codes. This limits the countries from which the user can choose and for which Loqate can load data.
VERLQT/LOQATE_DATA_PATH
(Required) This is the path to the Loqate data installation folder.
VERLQT/LOQATE_LOG_PATH
(Optional) This is the path for the Loqate log file. This is the log generated by the Loqate engine, not by the application code. It can be useful for debugging.
VERLQT/MAX_REF_PAGE_CACHE_SIZE
(Optional) This specifies the maximum reference data cache size. Default is 300000. Larger values allow for more referenced data to be cached, which can improve performance. However, this also increases the amount of memory your process attempts to consume. If you encounter out-of-memory errors, try lowering this value.
VERLQT/PRELOADTABLELIST
(Optional) This is a comma-delimited list of country data table names that can be found in the Loqate data folder. Use "*" to load all countries. This is intended to improve performance by pre-loading data for specific countries. Note that this can use a very large amount of memory.

Address Update (NCOA) Options (in dfncoa_appcfg.h)

NCOA/DFAV_CACHE_SIZE
(Optional) This sets the verify cache percentage for the USPS data. The higher the value, the more data is cached. The faster the processing, the more memory is used. The default is 0. It resides in macros/ncoa.cfg.
NCOA/DFAV_PRELOAD
(Optional) This sets the verify preload options for the USPS data. Valid values are ALL or an empty string. Using ALL requires a large amount of memory. It resides in macros/ncoa.cfg.
NCOA/DVDPATH
(Required) This is the path to the unpacked and unzipped NCOA data. It resides in macros/ncoa.cfg.
NCOA/QKBPARSEDEFN
(Optional) This is the path to the QKB parse definition used for address updates. The default is Name (Address Update), and it resides in macros/ncoa.cfg.
NCOA/QKBPATH
(Required) This is the path to the QKB used for Address Update name parsing. It resides in macros/ncoa.cfg.
NCOA/REPOSCONNECTION
(Required) This specifies the connection string used to connect to the Address Update repository. This overrides NCOA/REPOSDSN, and one or the other is required. This is typically set by the Address Update Admin utility and resides in the app.cfg.
NCOA/REPOSDSN
(Required) This specifies the DSN used to connect to the Address Update repository. It is overridden by NCOA/REPOSCONNECTION, and one or the other is required. This is typically set by the Address Update Administration utility and resides in the app.cfg.
NCOA/REPOSPREFIX
(Required) This is the table prefix used on the Address Update tables. This is typically set by the Address Update Administration utility and resides in the app.cfg.
NCOA/REPOSTYPE
(Required) This specifies the repository type. Valid values are: 0 (Guess), 1 (ODBC), or 2 (DFTK). If the value is 0, the node attempts to determine the type from the connection string. This is typically set by the Address Update Administration utility and resides in the app.cfg.
NCOA/USPSPATH
(Required) This is the path to the USPS CASS/DPV/etc data. It resides in macros/ncoa.cfg.

IntelliServer Option

DFCLIENT/CFG
(Required) This is used for IntelliServer. It is maintained by the dfIntelliServer installation, which is typically located at C:\Program Files\DataFlux\dfIntelliServer\etc\dfclient.cfg. Modify the dfclient.cfg file to point to the server and port.

Pooling Options

For puddle options, the name of the puddle is placed after 'POOLING/' (for example, POOLING/WFEJOB/MAXIMUM_PROCESSES). If no puddle name is specified, it is globally applied to all puddles. Here are some examples of puddles: WFEJOB - batch jobs on DMServer, WFESVC - Process services on DMSERVER, and APISVC - DFAPI services.
POOLING/CHILD_MAXIMUM_LAUNCHES
(Optional) This specifies the throttling for launches. When specified, the number of concurrent child process launches is limited by this value. If the current child launch request exceeds the specified value, the launch waits until the number of launching processes is below the specified value. If zero or not is specified, no limit exists for concurrent child launches.
POOLING/GET_PROCESS_TIMEOUT
(Optional) This specifies the length of time, in seconds, the process requester should wait for a process to become available before it times out. If zero, the requester waits indefinitely. The acquire process time-out is in terms of the acquisition of a process and the process pooling handshaking. It does not consider the time required by the requester to complete application-level initialization. Default: no time-out.
POOLING/IDLE_TIMEOUT
(Optional) This specifies the length of time, in seconds, the process remains idle before it is terminated. If zero, idle processes are not terminated. Default: 0. This is a puddle option.
POOLING/MAXIMUM_ERRORS
(Optional) This specifies the maximum number of pooled process errors before the process is terminated. The default is 0 (never terminate it).
POOLING/MAXIMUM_PROCESSES
(Optional) This specifies the maximum number of concurrent pooled processes. If 0, the number of concurrent pooled processes is unlimited. Default is unlimited after 2.2 (previously was 10). If POOLING/GET_PROCESS_TIMEOUT is set, it waits for that amount of time to get a new process if it needs one.
POOLING/MAXIMUM_USE
(Optional) This specifies the maximum number of pooled process uses before the process is terminated. The default is 0 (unlimited).

Repository Option

REPOS/CREATE_SPEC_PATH
(Optional) This specifies the path to the RepositoryTableCreationXML file containing the custom SQL that configures the commands to create tables and indexes in the repository.
REPOS/FORCE_FILE_BASED
(Optional) This specifies how to create the repository table or index. It provides a means of configuring the commands that are used to create tables and indexes in the repository.
REPOS/TABLE_LIST_PATH
(Optional) This defines the repository XML table. The directory should contain XML files for any tables that the repository library should add during creation or update. If set, this directory contains the XML files; if not set, look in DFEXEC_HOME/etc/reposcreate.

Other Options

EXPRESS_MAX_STRING_LENGTH
(Optional) This specifies the maximum size of strings declared in the expression nodes. The default maximum length of any string in this node is 5,242,880 bytes (5MB). This enables specifying a larger value in bytes. If performance issues arise, then the suggested setting is 65536 bytes.
EXPRESSION/UDFDIR
(Optional) This specifies where to look for UDF files. If not specified, look for UDF files in installationdir/etc/udf.
JAVA/COMMAND
(Optional) This is the command used to launch the Java proxy process. The default is Java. The Java command must be compatible with launching from the command line. Here are some examples:
  • JAVA/COMMAND = Java
  • JAVA/COMMAND = Java -Djavax.net.ssl.trustStore=C:\Store\jssecacerts
  • JAVA/COMMAND = Java -Djavax.net.ssl.trustStore="C:\Cert Store\jssecacerts"
  • JAVA/COMMAND = "C:\Program Files\Java\jre6\bin\java"
MDM/REPOSITORY_ROOT_FOLDER
(Optional) This allows the foundations/master_data to be overwritten by the user when putting the contents of [INSTALL_ROOT]/share/mdm into a repository.
Last updated: June 2, 2017