List of all EDM configuration variables
The following table gives a short description of all the configurable variables in EDMserver.
1 | Variable name | Comments | Default value |
2 | AUTOMATIC_RESTART_OF_ABNORMAL_TERMINATED_APPSERVERS | If "TRUE" EDMappServers will automatically restart on abnormal termination. Use the -ar EDMserver argument to trun this option to TRUE or use the supervisor. | FALSE |
3 | CLIENTS_TO_SERVER_FILE_TRANSFER | ||
4 | EDM_ALL_GROUPS_ACCESS_RIGHTS_CHECKING | FALSE | |
5 | EDM_APPSERVER_EXECUTABLE_NAME | This will point to the Appserver executable to be used as the EDMappServer. The executable must be inside the EDM\bin installation folder. | edmappserver.exe |
6 | EDM_APPSERVER_COMMAND_LINE_ARGUMENTS | ||
7 | EDM_APPSERVER1_TMP_DIR | Temporally folder for the EDMappserver. | |
8 | EDM_APPSERVER2_TMP_DIR | ||
9 | EDM_APPSERVER3_TMP_DIR | ||
10 | EDM_APPSERVER4_TMP_DIR | ||
11 | EDM_APPSERVER5_TMP_DIR | ||
12 | EDM_APPSERVER6_TMP_DIR | ||
13 | EDM_APPSERVER7_TMP_DIR | ||
14 | EDM_APPSERVER8_TMP_DIR | ||
15 | EDM_APPSERVER9_TMP_DIR | ||
16 | EDM_APPSERVER10_TMP_DIR | ||
17 | EDM_CLIENT_MEMORY_BLOCKS | Defines the database cache size in number of database blocks for an EDMfatClient. To be effective, this configuration variable must be set before the actual EDMfatClient opens the session. The value of this configuration variable normally has a great influence of system performance. The value should be seen in relation to the size of physical memory and size of virtual memory (swapping file) in the actual system. A "normal" value should be in the range from 25000 to 75000 (25MB – 75MB). The default value is 50000. | 50000 |
18 | EDM_CLIENTS_OPEN_MODEL_PERMISSION | Due to security and performance reasons, it may be wanted to limit the models (populations) that can be opened by an EDMfatClient. This configuration variable is used to define such limits. All EDMfatClients can always open system models, i.e., models that are implicitly created at EDMdatabase creation time. Opening of any other models must be according to the setting of EDM_CLIENTS_OPEN_MODEL_PERMISSION. | |
19 | EDM_CHECKING_MODELS_IN_OPEN_DB | {0 ,3,"EDM_CHECKING_MODELS_IN_OPEN_DB" ,&A_EDM_CHECKING_MODELS_IN_OPEN_DB[0] ,false ,&checkModelsInOpenDatabase ,0 ,sdaiINTEGER,&def_checking_models_in_open_db ,false}, PUBLIC char *legalOpenDbChecks[] = {"NONE","OPEN_MODELS", "CHECK_MODEL_CONTENTS", "CHECK_MODEL_CONTENTS_VERBOSE",NULL}; | OPEN_MODELS |
20 | EDM_DB_BLOCK_SIZE | Defines the size of the EDMdatabase physical block size and the EDMserver cache block size, i.e., units (in bytes) of data to transfer between the database on disc and the EDMserver cache. | 2048 |
21 | EDM_DEFAULT_DATA_REPOSITORY_PROTECTION | Default protection assigned to the "built-in" repository named "DataRepository" when an EDMdatabase is created. Hence, to get any effect, this configuration variable must be set before an EDMdatabase is created. | 7399 |
22 | EDM_DEFAULT_GROUP_ARCHIVED_MODELS_PROTECTION | The default protection assigned to an EDMarchivedModel that is owned by an EDMgroup only, i.e., not owned by any EDMuser. The value of this configuration variable is kept in the EDMdatabase instance in the SystemRepository.ExpressDataManager model and will be inherited to the attribute "DEFAULT_ARCHIVED_MODELS_PROTECTION" in the EDMgroup instance when the EDMgroup is created. Hence later updates of this attribute for a particular EDMgroup will change the configuration value for this particular EDMgroup. This protection will be assigned to an EDMarchivedModel at its creation time. This configuration variable can be set at any time and will be immediate effective on later created EDMgroup. For legal value of protection see ??? | 21120 |
23 | EDM_DEFAULT_GROUP_DATA_MODELS_PROTECTION | he default protection assigned to an EDMdataModel that is owned by an EDMgroup only, i.e., not owned by any EDMuser. The value of this configuration variable is kept in the EDMdatabase instance in the SystemRepository.ExpressDataManager model and will be inherited to the attribute "DEFAULT_DATA_MODELS_PROTECTION" in the EDMgroup instance when the EDMgroup is created. Hence later updates of this attribute for a particular EDMgroup will change the configuration value for this particular EDMgroup. This protection will be assigned to an EDMdataModel at its creation time. This configuration variable can be set at any time and will be immediate effective on later created EDMgroup. For legal value of protection see ??? | 24289 |
24 | EDM_DEFAULT_GROUP_DICTIONARY_MODELS_PROTECTION | The default protection assigned to an EDMdictionaryModel that is owned by an EDMgroup only, i.e., not owned by any EDMuser. The value of this configuration variable is kept in the EDMdatabase instance in the SystemRepository.ExpressDataManager model and will be inherited to the attribute "DEFAULT_DICTIONARY_MODELS_PROTECTION" in the EDMgroup instance when the EDMgroup is created. Hence later updates of this attribute for a particular EDMgroup will change the configuration value for this particular EDMgroup. This protection will be assigned to an EDMdictionaryModel at its creation time. This configuration variable can be set at any time and will be immediate effective on later created EDMgroup. For legal value of protection see ??? | 22181 |
25 | EDM_DEFAULT_GROUP_EXTRA_SCHEMATA_PROTECTION | The default protection assigned to EDMquerySchema and EDMruleSchema that are owned by an EDMgroup only, i.e., not owned by any EDMuser. The value of this configuration variable is kept in the EDMdatabase instance in the SystemRepository.ExpressDataManager model and will be inherited to the attribute "DEFAULT_EXTRA_SCHEMATA_PROTECTION" in the EDMgroup instance when the EDMgroup is created. Hence later updates of this attribute for a particular EDMgroup will change the configuration value for this particular EDMgroup. This protection will be assigned to an EDMquerySchema and EDMruleSchema at its creation time. This configuration variable can be set at any time and will be immediate effective on later created EDMgroup. For legal value of protection see ??? | 26409 |
26 | EDM_DEFAULT_GROUP_MODEL_REPOSITORIES_PROTECTION | The default protection assigned to an EDMmodelRepository that is owned by an EDMgroup only, i.e., not owned by any EDMuser. The value of this configuration variable is kept in the EDMdatabase instance in the SystemRepository.ExpressDataManager model and will be inherited to the attribute "DEFAULT_MODEL_REPOSITORIES_PROTECTION" in the EDMgroup instance when the EDMgroup is created. Hence later updates of this attribute for a particular EDMgroup will change the configuration value for this particular EDMgroup. This protection will be assigned to an EDMmodelRepository at its creation time. This configuration variable can be set at any time and will be immediate effective on later created EDMgroup. For legal value of protection see ??? | 24289 |
27 | EDM_DEFAULT_STRING_ENCODING | ISO-8859-1 | |
28 | EDM_DEFAULT_USER_ARCHIVED_MODELS_PROTECTION | The default protection assigned to an EDMarchivedModel that has an EDMuser as owner. The value of this configuration variable is kept in the EDMdatabase instance in the SystemRepository.ExpressDataManager model and will be inherited to the attribute "DEFAULT_ARCHIVED_MODELS_PROTECTION" in the EDMuser instance when the EDMuser is created. Hence later updates of this attribute for a particular EDMuser will change the configuration value for this particular EDMuser. This protection will be assigned to an EDMarchivedModel at its creation time. This configuration variable can be set at any time and will be immediate effective on later created EDMuser. | 21120 |
29 | EDM_DEFAULT_USER_DATA_MODELS_PROTECTION | The default protection assigned to an EDMdataModel that has an EDMuser as owner. The value of this configuration variable is kept in the EDMdatabase instance in the SystemRepository.ExpressDataManager model and will be inherited to the attribute "DEFAULT_DATA_MODELS_PROTECTION" in the EDMuser instance when the EDMuser is created. Hence later updates of this attribute for a particular EDMuser will change the configuration value for this particular EDMuser. This protection will be assigned to an EDMdataModel at its creation time. This configuration variable can be set at any time and will be immediate effective on later created EDMuser. For legal value of protection see ??? | 24289 |
30 | EDM_DEFAULT_USER_DICTIONARY_MODELS_PROTECTION | The default protection assigned to an EDMdictionaryModel that has an EDMuser as owner. The value of this configuration variable is kept in the EDMdatabase instance in the SystemRepository.ExpressDataManager model and will be inherited to the attribute "DEFAULT_DICTIONARY_MODELS_PROTECTION" in the EDMuser instance when the EDMuser is created. Hence later updates of this attribute for a particular EDMuser will change the configuration value for this particular EDMuser. This protection will be assigned to an EDMdictionaryModel at its creation time. This configuration variable can be set at any time and will be immediate effective on later created EDMuser. For legal value of protection see ??? | 30637 |
31 | EDM_DEFAULT_USER_EXTRA_SCHEMATA_PROTECTION | The default protection assigned to EDMquerySchema and EDMruleSchema that have an EDMuser as owner. The value of this configuration variable is kept in the EDMdatabase instance in the SystemRepository.ExpressDataManager model and will be inherited to the attribute "DEFAULT_EXTRA_SCHEMATA_PROTECTION" in the EDMuser instance when the EDMuser is created. Hence later updates of this attribute for a particular EDMuser will change the configuration value for this particular EDMuser. This protection will be assigned to an EDMquerySchema and EDMruleSchema at its creation time. This configuration variable can be set at any time and will be immediate effective on later created EDMuser. For legal value of protection see ??? | 26409 |
32 | EDM_DEFAULT_USER_MODEL_REPOSITORIES_PROTECTION | The default protection assigned to an EDMmodelRepository that has an EDMuser as owner. The value of this configuration variable is kept in the EDMdatabase instance in the SystemRepository.ExpressDataManager model and will be inherited to the attribute "DEFAULT_MODEL_REPOSITORIES_PROTECTION" in the EDMuser instance when the EDMuser is created. Hence later updates of this attribute for a particular EDMuser will change the configuration value for this particular EDMuser. This protection will be assigned to an EDMmodelRepository at its creation time. This configuration variable can be set at any time and will be immediate effective on later created EDMuser. | 24289 |
33 | EDM_EVM_MAX_MEM_USAGE | Defines the maximum virtual memory (in bytes) that can be consumed by the EDMexpressVM before an exception is raised. When the value of EDM_EVM_MAX_MEM_USAGE is set to 0 (zero) there will be no maximum size of the virtual memory allocated by the EDMexpressVM. Hence, an exception will not be raised until the system is "out of virtual memory". This may lead to malfunctions on some systems platforms that sometimes cannot be repaired until the EXPRESS Data Manager is terminated and restarted (due to operating system malfunctions). | 0 |
34 | EDM_EXTENDED_LOWERCASE_CHARACTERS | ||
35 | EDM_EXTENDED_NAME_CHARACTERS | ||
36 | EDM_EXTENSIVE_ACCESS_CHECKING | EDM provides two levels of object ownership/protection and object access checking, i.e., "standard access checking" and "extensive access checking". This configuration variable should be set to TRUE when "extensive access checking" should be used; else it should be set to FALSE. This configuration value must be set before an EDMdatabase is created to have any effect. Normally EDMdatabase that will be used by an EDMserver™ should be created with EDM_EXTENSIVE_ACCESS_CHECKING = TRUE. For detailed description of object ownership, protection and access-rights see ??? | FALSE |
37 | EDM_HOME | The file path of the directory (folder) containing the actual EDM installation. This mandatory configuration parameter is set when the EDM is installed. This configuration variable is used by the EDMsupervisor command Schemata>GenerateInterface>Cpp. Hence, this configuration variable must be set before this command is invoked. Application programmers should use this variable when referring to include files and libraries. | |
38 | EDM_HOST | Configuration variable that defines the host name or host IP address to the system (host) that runs the actual EDMserver. This configuration variable is effective for EDMfatClients including EDMappservers. | |
39 | EDM_IMPLICIT_INSTANCE_CREATION | In EDMexpressX instances are implicitly created when referenced with dot notation, on the left-hand side of an Assignment statement. In the Express language this "automatic instance creation" mechanism is by default not active. This mechanism is activated if the value of EDM_IMPLICIT_INSTANCE_CREATION is set to TRUE. If the value of EDM_IMPLICIT_INSTANCE_CREATION is FALSE the "automatic instance creation" mechanism is disabled. | TRUE |
40 | EDM_INSTANCE_CONTAINERS | This configuration variable defines if an EDMdatabase can contain EdmInstanceContainer or not. The available value to be assigned is TRUE or FALSE. Hence this configuration variable must be set before the actual EDMdatabase is created to get any effect. | TRUE |
41 | EDM_MANDATORY_WRITE_TRANSACTIONS | FALSE | |
42 | EDM_MAX_DIRTY_MEMORY_BLOCKS_IN_MODEL | This configuration variable defines the maximum number of "written-in" (updated) cache blocks a model can have in the EDM cache before starting to "steel" (write-back and reuse block) own blocks. This configuration variable is provided as an instrument for increasing system performance. Normally the default setting is acceptable. See system tuning ??? | 5000 |
43 | EDM_MAX_MODEL_TRANSACTION_VERSIONS | {0 ,0,"EDM_MAX_MODEL_TRANSACTION_VERSIONS" ,&A_EDM_MAX_MODEL_TRANSACTION_VERSIONS[0] ,false ,&maxModelTransactionVersions ,0 ,sdaiINTEGER,&def_maxModelTransactionVersions ,false}, | 50 |
44 | EDM_MAX_START_CLIENT_WAITING_TIME | This configuration variable defines the maximum times in second an EDMremoteClient will wait for getting service by an EDMappserver before returning with a time-out response. | 2 |
45 | EDM_MAX_STEP_FILE_SIZE_FOR_IN_MEMORY_MAPPING | The STEP File (SPF) read operation maintains a mapping table that holds the relation between SPF identifiers and EDMdatabase identifiers. This mapping table can be located in virtual memory or as volatile data in the database. Mapping table in virtual memory improves performance, but size is limited to available virtual memory. | 2000 |
46 | EDM_MEMORY_BLOCKS | Defines the database cache size in number of database blocks for a stand-alone (single-user) EDM system. To be effective, this configuration variable must be set before the actual EDM system opens the session. The value of this configuration variable normally has a great influence of system performance. The value should be seen in relation to the size of physical memory and size of virtual memory (swapping file) in the actual system. A "normal" value should be in the range from 25000 to 75000 (25MB – 75MB). The default value is 25000. | 25000 |
47 | EDM_MEMORY_DEBUGGER | EDM has a built-in virtually memory trace for the allocation and release of virtual memory. This functionality is normally only used by (EDM) specialists for system debugging. The trace result written to a file. This configuration variable specifies the full filename of this file. | |
48 | EDM_MIN_MEMORY_BLOCKS | This configuration variable defines the minimum number of database blocks in the EDMcache. The setting of this configuration value is normally only for EDM system specialists during system debugging. | 1000 |
49 | EDM_OPEN_SDAI_USER | TRUE | |
50 | EDM_REAL_TOLERANCE | Set this variable with a value to denote the precision of REAL numbers used throughout the EXPRESS Data Manager system. The default value is 0.000000001. | 1000000E-009 |
51 | EDM_SERVER_CLIENTS_FILES_PATH | ||
52 | EDM_SERVER_MEMORY_BLOCKS | Defines the database cache size in number of database blocks for an EDMserver. To be effective, this configuration variable must be set before the actual EDMserver opens the session. The size of the cache in an EDMserver is normally relatively small, i.e., typically in the range 5000 – 10000 (5MB – 10MB). The default value is 5000. | 5000 |
53 | EDM_SERVER_REPORT_FILES_DIRECTORY | ||
54 | EDM_SERVER_TMP_DIR | ||
55 | EDM_SERVICE_PORT | This configuration variable defines the communication port to the actual EDMserver for an EDMfatClient, include EDMfatClient running as an EDMappserver. The value must be defined as a numeric value, not a name. The combination of EDM_HOST and EDM_SERVICE_PORT defines a unique EDMserver in the universe. | 0 |
56 | EDM_SHRINK_DATABASE_ON_CLOSE_DATABASE | TRUE | |
57 | EDM_STEP_FILE_AUTHOR | Set variable with information to be included in the header section of a STEP File when no particular "STEP Header Model" is specified in the invocation of the STEP Write operation. | |
58 | EDM_STEP_FILE_LINE_LENGTH | Defines the maximum characters per line in a STEP Physical File (P21, IFC) produced by the EXPRESS Data Manager. Specifying a length of 0 means that there will be no line breaks within one entity instance on the STEP file. The default value of EDMI_STEP_FILE_LINE_LENGTH is 72. | 72 |
59 | EDM_TRANSACTION_SECURITY | This configuration variable defines how the transactions should be handled in the EDMserver. The four legal values (strings) for this configuration variable are:
| |
60 | EDM_UNPACKED_MODELS | Defining this variable to FALSE, causes the EXPRESS Data Manager to allocate new space when data is created/updated in the database, instead of recovering old and released spaces, i.e., no garbage collection of the database will be performed. | FALSE |
61 | EDM_USER_DEFINED_COMPLEX_ENTITIES | For those unfamiliar with the concept of complex entities, please refer to EDMassist Volume III for explanation of the handling of complex entities before setting this variable. | 15 |
62 | EDM_XPX_INTEGER_HASH_WIDTH | This variable is used for performance tuning. Set variable with a value denoting the size of the hash tables used by the EDMmodelConverter functions xpxMapInstance and xpxMapInteger. | 1024 |
63 | EDMI_APPSERVER_COMMUNICATION_RETRIES | This configuration variable defines the number of retries that will be performed in communication between an EDMremoteClient and an EDMappserver in case of any communication error (time-out or others). For each retry the actual EDMremoteClient will ask the EDMserver for assigning a new EDMappserver. | 10 |
64 | EDMI_CHANGING_APPSERVER_FREQUENCY | The first time an EDMremoteClient is invoking an EDMserver with a new EDMserverContext, the EDMserver is assigning a particular EDMappserver for this communication and normally this communication is "fixed" until the termination of the actual EDMremoteClient. For performance reasons it may be interesting to change this "fixed" communication between one EDMremoteClient.EDMserverContext and a particular EDMappserver. This configuration variable can be used to specify that the actual EDMremoteClient will ask the EDMserver after a new EDMappserver to communicate with through the actual EDMserverContext after the number of communication-calls specified in this configuration variable. When this configuration variable is set to 0 (zero), the actual EDMremoteClient.EdmServerContext will always use the EDMappserver assigned by the EDMserver in the first invocation. | 0 |
65 | EDMI_COMMUNICATION_TYPE | This configuration variable defines the communication type for an EDMfatClient to an EDMserver. The available choices are TCP and HTTP. | |
66 | EDMI_HTTP_TUNNEL_NAME | When the communication type between an EDMfatClient and the EDMserver is HTTP, this configuration variable defines the receiving tunnel on the server. This value is appended to the server name and port to form the complete URL used, for example using: | |
67 | EDMI_HTTP_TUNNEL_HOST | When the communication type between an EDMfatClient and the EDMserver is HTTP, this configuration variable defines the name of the host (system) that runs the EDMIhttpTunnel. The value can be specified as a name or an IP address. | |
68 | EDMI_HTTP_TUNNEL_PORT | When the communication type between an EDMfatClient and the EDMserver is HTTP, this configuration variable defines the communication port number used for communication to the EDMIhttpTunnel. The value of this configuration variable must be specified as a numeric value. | 0 |
69 | EDMS_IFC_3D_VIEWER | This configuration variable defines the full path to an IFC 3D viewer that can receive data in ifcXML format and can be invoked with the actual ifcXML file name as the argument in the invocation. This configuration variable is used by the command Data>Xml>WriteXmlDocument(P28e2) in the EDMsupervisor. | |
70 | EDMS_TMP_DIR | Define the directory where the EXPRESS Data Manager temporary files should be stored. The default is the temporary directory for the logged in user. This directory is named as: | |
71 | EDMS_FILE_ROOT | ||
72 | IS_DEVELOPMENT_SERVER | FALSE | |
73 | JAVA_HOME | ||
74 | LOGGING_LOGGED_ON_USERS | ||
75 | LOGGING_SERVER_MESSAGES | ||
76 | PROXY_SERVER | In case an EDMfatClient using HTTP communication type in communication with an EDMserver, and must communicate through a proxy server, this configuration variable defines the name of the proxy server. The name can be specified as a name or a numeric IP address. | |
77 | PROXY_SERVER_PORT | In case an EDMfatClient using HTTP communication type in communication with an EDMserver, and must communicate through a proxy server, this configuration variable defines the communication port on the proxy server. This value must be specified as a numeric value. | 0 |
78 | SERVER_TO_CLIENTS_FILE_TRANSFER | ||
79 | START_APPSERVER_VIRTUAL_MEMORY_LOGGING | ||
80 | START_SERVER_VIRTUAL_MEMORY_LOGGING | ||
81 | STOP_APPSERVER_VIRTUAL_MEMORY_LOGGING | ||
82 | STOP_SERVER_VIRTUAL_MEMORY_LOGGING | ||
83 | DATABASE_NAME | ||
84 | DATABASE_LOCATION | ||
85 | LOCAL_DATABASE_NAME | only relevant in an EDMserver systems. In a single user system is equal to DATABASE_NAME | |
86 | LOCAL_DATABASE_LOCATION | only relevant in an EDMserver systems. In a single user system is equal to DATABASE_LOCATION | |
87 | MY_PID | ||
88 | MY_APPSERVER_PORT | ||
89 | MY_SERVER_PORT | ||
90 | MY_HOST_NAME | ||
91 | MY_IP_ADDRESS | ||
92 | MY_SERVER_HOST | ||
93 | MY_SERVER_NAME | ||
94 | MIN_FREE_DISC_SPACE_BEFORE_WARNING | The minimum percentage free disc space out of total disc space, available to EDMserver before a warning is written to the console and a report is written to the EDM server report file. The actual write transaction will be executed. The default value is 10%. | |
95 | MIN_FREE_DISC_SPACE_BEFORE_ERROR | The minimum percentage free disc space out of total disc space, available to EDMserver before a an error is written to the console and a report is written to the EDM server report file. The actual write transaction will not be performed, it will return with the actual error message you report. The default value is 5%. | |
96 | ECORE_1144_PATCH | Boolean variable turning on patch for EDMtruePLM server to avoid appserver misbehavior in some special cases. Flag needs to be set on appservers with -ae or sysenv method, since supervisor doesn't always communicate updated config parameters to appserver after startup. NOTE:as of edmcpore-v602.30.134 this fix modifies the transaction system it might have unforeseen consequences with regards to backwards compatibility. | FALSE |
97 |