Configuration File Layout

Specifies the directory path into which theFME Flowwrites all translation results unless theFME_WORKING_DIRis specified in the subsection for a particular job.

Default:Current Working Directory

Specifies theFME Flow’s repositoryrootdirectory path, whereworkspaces run by the FME Engine during translations are contained.

Default:Current Working Directory

Specifies how long, in seconds, translation results are held. The FME Engine periodically checks for, and recursively deletes, all files older than this amount from theFME_WORKING_DIRas a housekeeping measure. The frequency of this automatic deletion check is set by the value ofFME_PURGE_INTERVAL, described next. Whenever automatic file deletion is performed, it occurs after a translation.

Default:If value is zero or directive is absent, results are never deleted – lifetime is infinite.

Specifies, in seconds, the automatic deletion checking period. The FME Engine checks for files older thanFME_RESULT_LIFETIMEand deletes any it finds. This check is performed at theFME_PURGE_INTERVALperiod. Note that the FME Engine decides whether or not to do the check only after each translation. It does not set a timer to trigger the check. This means that the check can occur at the interval set, but may also occur at longer intervals depending on how frequently translations are made.

Default:If this directive is absent, the default is 0 – checks after each translation if there are translation results to purge.

The FME Engine configuration file uses the two pseudo-variables:S

!FME_AUTO_DIR_NAME!

!FME_AUTO_FILE_NAME!

to represent unique names for translation result directories and files respectively. By default, the names have this form:

FME_

For example:

FME_a03508997017636

You can change the defaultFME_prefix to a site-specific value. Site-specific prefixes are defined using theAUTO_DIR_PREFIXdirective to set the prefix of directory names, and theAUTO_FILE_PREFIXdirective to set the prefix for file names. The directives have the following syntax:

AUTO_DIR_PREFIX

AUTO_FILE_PREFIX

The most useful application of these directives is to set the filename prefix with theAUTO_FILE_PREFIXdirective. Doing so allows the names of translation result files to better reflect the originating organization.

When either of these directives is present, the specifiedvalue is used instead ofFME_. When absent, the prefix defaults to theFME_default value.

For example, ifAUTO_FILE_PREFIXNoodle_was specified, the translation result filenames would take this form:

Noodle_

Note that a trailing underscore character in the prefix value is not assumed. If you want your prefix to have one of these characters, you must explicitly include it as part of the prefix value.

You can specify either or both of these directives in the global section and/or in any subsection of the configuration file. When specified in the global section, the prefix is used by all subsections that don't themselves specify one. Subsections that do specify a prefix use that one instead, and do not use any global prefix that was specified.

Default:When the directive is absent, a prefix ofFME_is used.

This timeout is measured in milliseconds. When the FME Engine doesn’t receive any translation requests within this period of time, the FME Engine shuts itself down. TheFME Flowsystem then starts a new FME Engine instance.

在大多数操作条件下设置这个值to its recommended default of zero. This setting means that the FME Engine waits indefinitely for requests and never shuts down due to a lack of incoming requests.

However, you can use this directive to specify a finite timeout period in environments where a network monitor shuts down connections that remain inactive beyond a preset period of time. When this is done to the connection on which an FME Engine is listening to receive requests, the FME Engine can no longer respond and enters a hung state.

Setting this directive to a non-zero value lets the FME Engine terminate itself after the specified time. The FME Engine effectively breaks out of the hung state, allowing theFME Flowsystem to start a new FME Engine instance that can respond, once again, to requests.

Specifies the file paths of one or more root directories. These directories are used by the FME Engine to obtain different types ofResources,如自定义格式,变压器,coordinate system definitions. Use semicolons to separate multiple shared directory file paths.

Default:\Server\resources\shared

Specifies the file path to the FME Engine’s log file. This log file contains a dump of the Engine’s configuration file and other information relating to the overall operation of the FME Engine. Note that this file does not log individual translation request processing, which is logged separately in individual translation log files.

For each FME Engine and, therefore, for each fmeEngineConfig.txt, you need to specify a different fmeEngine.log filename.

You can use the pseudo variable !FME_INSTANCE_NAME! to create a log file named for the instance name like this:\Logs\fmeEngine_!FME_INSTANCE_NAME!.log

This directive includes an additional parameter that follows the file path. The parameter’s value can beTRUEorFALSE, indicating whether or not the log file should be appended to the time of each FME Engine startup.TRUEmeans the file is appended to andFALSEmeans it is overwritten.

Default:\Logs\fmeEngine.log FALSE

Specifies the directory used byFME Flow’s Web User Interface for temporarily uploading data. In a distributed environment, this directory must be accessible to the web server and to the FME Engines. Specifying a UNC path is recommended.

The automatic resource manager determines the optimal total memory the FME Engine process should use. It also dynamically allocates this total memory optimally to the algorithms within FME requesting it.

The FME_ENGINE_MEMORY_REDLINE directive is a hint to the FME Engine on how aggressive it should be in consuming memory. It takes a value between 0 and 1 (0.5 is the default value). For more aggressive memory usage, a value above 0.5 should be used. For safer memory usage, a value below 0.5 should be used. The risk in being too aggressive is the process running out of memory or the machine thrashing. The risk in being to conservative is that the process will take longer to complete.

Default:0.5

SDE30_PERM_CONNECT

Defines a permanent connection to an ESRI SDE Server. This connection is brought up just before the first translation is performed on the FME Engine. The connection is then held by the Engine so subsequent translations need not establish a new SDE connection.

Take care when using this directive because SDE connections are a valuable resource and you should use them sparingly. In general, it’s good practice to first use the FME Engine without any permanent connection. You may consider a permanent connection later, if you find that connecting and disconnecting to SDE is too expensive.

The name of the host computer on which the SDE server is running.

Default:Site-specific

The SDE instance to which the FME Engine is to connect.

Default:port:5151

The database on the instance that is to be connected. When the SDE is on databases such as Oracle the value specified is not used. Although you can specify any value, the convention is to specify the value NOTUSED for the database.

Default:Site-specific

The user account used to log in to the SDE.

Default:Site-specific

The user password of the user account.

Default:Site-specific

FME Engine SUB_SECTION

FILE_DOWNLOAD_SERVICE

STREAM_DOWNLOAD_SERVICE

SERVER_CONSOLE_CLIENT

SERVER_JOB_SUBMITTER

JOB_SUBMITTER_SERVICE

REST_SERVICE

SERVER_SCHEDULER

Identifies the subsection that’s being defined. There is no limit to the number of subsections that you can define. Identify each subsection with a unique– it cannot begin withFME_.

The following global directives are also available to subsections where you can redefine them to have different values:

FME_WORKING_DIR

FME_MAPPING_DIR

AUTO_DIR_PREFIX

AUTO_FILE_PREFIX

SUCCESS_RESPONSE

FAILURE_RESPONSE

Redefined directives override the global value for the particular subsection for which they are defined.

Specifies the path to the default directory containing the per-translation log files generated by the FME Engine for that subsection.

Default:\Logs\

Defines a macro value that is supplied to the FMEworkspacewhen the translation is performed. The first parameterspecifies the name of the macro.

All the tokens up to the next directive or the end of theSUB_SECTIONdefinition form the value for.

You can nest macro references.

When defined, macros are available for use in success and failure response strings, using the pseudo-variable (!macroName!) syntax.

Some FME Engine subsections define a specific macro calledFME_SERVER_DEST_DIRwhose value is set as a path to a unique, system-generated directory. The intention is that this directory is used as an output location for translation result files.Workspaceauthors can reference this value as a published parameter and use it as a well-defined location for destination datasets.