Information Management IBM InfoSphere Master Data Management, Version 10.1

Entity manager configuration parameters

Configuration files are stored in different locations that depend on whether you use a stand-alone or an embedded entity manager.

Stand-alone entity manager configuration parameters are stored .cfg files in the entitymanager_instance_homeDir/inst/instance_name/conf directory.

If you employ an embedded entity manager, the associated .cfg files are found in the MAD_HOMEDIR/inst/instance_name/conf directory.

The entity manager queue manager configuration file is com.initiate.server.entity.cfg. The parameters contained in this file are listed in this table.
Table 1. Entity manager queue parameters
Parameter Description Default and examples
entityTypes A comma delimited list of the entity types that the queue manager processes. A wildcard character of "*" can be used to indicate all entity types. The character cannot be mixed with additional characters to configure subsets of entity types. Default: *
Valid examples:
  • id
  • id,hh,provider
  • *
Invalid examples:
  • *,id
  • id*
pollSeconds The number of seconds the queue manager waits after it polls the mpi_entique_xx table and finds no entries or the internal queue is full. Default: 10
Valid examples:
  • 5
  • 10
Invalid examples:
  • 0
  • -5
workUnit The row count that is pulled from the mpi_entique_xx table and inserted into the internal queue. This value must be less than the maxQueueDepth parameter. Default: 500
Valid examples:
  • 500
  • 5000
Invalid examples:
  • 0
  • -500
workerThreads The number of threads per entity type that are used to process work in parallel. This number can be based on the number of CPU cores available on the server. Increasing this number does not increase performance if CPU cores are not available and can decrease performance. Default: 1
Valid examples:
  • 1
  • 5
Invalid examples:
  • 0
  • -5
maxQueueDepth The maximum record size of the internal queue used by the worker threads. This number must always be larger than the workUnit and based on the number of queue managers, memory on the server, and database subsystem performance. Default: 5000
Valid examples:
  • 5000
  • 15000
Invalid examples:
  • 0
  • -5000
inputWrkOwner The name of the wrkOwner in the mpi_entique_xx table that this queue manager uses to pull records. This parameter must not be the same as the queueWrkOwner or errorWrkOwner. Default: system

Valid examples: system

Invalid examples: error

queueWrkOwner The name used for the wrkOwner in mpi_entique_xx table for the records this queue manager owns. This parameter must be unique for each queue manager that is running. This parameter must not be the same as the inputWrkOwner or errorWrkOwner. Default: queue
Valid examples:
  • queue
  • queue1
  • queue2
errorWrkOwner The name used for the wrkOwner in the mpi_entique_xx table if a record that is being processed has errored out and errorDequeueEnabled is set to true. Default: error
Valid examples:
  • error
  • error1
  • error2
errorMaxRetryWaitSeconds The number of seconds the queue manager waits before trying a database operation that exceeds the errorRetryAttempts value. This value comes into play only on queue manager operations that involve an mpi_entique_xx that cannot be de-queue or ignored. The minimum value for this parameter is 30 seconds. Default: 60
Valid examples:
  • 30
  • 90
Invalid examples:
  • 15
errorRetryWaitSeconds The number of seconds the queue manager waits between an operation that returned an error and not exceeded the errorRetryAttempts value. Default: 5
Valid examples:
  • 5
  • 10
  • 0
errorRetryAttempts The number of times the queue manager tries an operation before it takes one of these actions:
  • Sets the wrkOwner for the offending mpi_entique_xx record to the errorWrkOwner.
  • Deletes the offending mpi_entique_xx record.
  • Waits for the errorMaxRetryWaitSeconds value for a critical mpi_entique_xx database operation.
Default: 10
Valid examples:
  • 5
  • 10
  • 0
errorDequeueEnabled This true or false setting determines the action that is taken when a recoverable error exceeds the errorRetryAttempts parameter. If this value is set to true, the mpi_entique_xx record has the wrkOwner set to the errorWrkOwner. If the parameters is set to false, the record is deleted from the mpi_entique_xx table. Default: false
Valid examples:
  • true
  • false
workPriorityEnabled This true or false setting determines the order in which records from mpi_entique_xx are processed. If this value is true, the work priority is used to determined how the records are processed. If the value is false, the oldest records are processed first. Default: true
Valid examples:
  • true
  • false
maxWorkPriority The maximum work priority record the queue manager processes. The higher the number, the lower the work priority. This setting is only valid if workPriorityEnabled is set to true. Default: 0
Valid examples:
  • 0
  • 50
Invalid examples:
  • -50
entityLinkerEnabled This true or false setting determines whether entity linking is enabled for this queue manager. Default: true
Valid examples:
  • true
  • false
relationshipLinkerEnabled This true or false setting determines whether relationship linking is enabled for this queue manager. Default: false
Valid examples:
  • true
  • false
Individual implementations can have their own configuration parameters that do not apply to the queue manager.


Feedback

Timestamp Last updated: 14 Nov 2014

Topic URL: