Sun Worklist Manager Service Engine User's Guide

Worklist Manager Service Engine Runtime Property Descriptions

The following table lists and describes each Worklist Manager Service Engine runtime property.

Table 1 WLM SE General Runtime Properties

Property 

Description 

Description 

A general description of the JBI component. 

Name 

A unique name for the WLM SE in the JBI environment. If you install more than one WLM Service Engine in a JBI environment, make sure that each has a unique name. When the service unit deploys the component, it is matched with the target component name defined in its descriptor file, jbi.xml, which can be modified as needed.

State 

The current state of the JBI component. This value can be either Started, Stopped, or Shutdown. 

Type 

The type of JBI component (service-engine or binding-component). 

Table 2 WLM SE Identification Runtime Properties

Property 

Description 

Version 

The version number of the installed service engine. 

Build Number 

The build number of the installed service engine. 

Table 3 WLM SE Configuration Runtime Properties

Property 

Description 

Default Value 

DataSource JNDI 

The JNDI name of the JDBC resource for the Worklist Manager database. The name of the default JDBC resource created for the default JavaDB database is jdbc/__workflow. 

jdbc/__workflow 

DataSource Type 

The database platform used by the Worklist Manager database. 

Derby 

Max Thread Count 

The maximum number of threads that can be concurrently processed by the WLM SE. 

10 

Test Mode 

An indicator of whether the WLM SE is running in testing mode. When this option is selected, the Worklist Manager database schema is dropped and recreated each time you start the WLM SE. If it is not selected, the existing Java DB database remains intact each time you start the WLM SE. 

Deselected 

Persistence Enabled 

An indicator of whether persistence is enabled for the WLM SE. Currently, the only supported option is to have persistence enabled. 

Selected 

Update index on engine start 

An indicator of whether the full-text index is updated when you start the WLM SE. When this option is selected, the index is updated. 

This is required when a large number of database records are archived and deleted, or after the database has fun for some time (to improve full-text search efficiency). 

Selected 

Index root directory System Property 

The file system directory to use as the root directory for storing the full-text index. This property must be set when the application server is started, and the directory must exist and be accessible. 

java.io.tmpdir 

LDAP used 

An indicator of whether you are using an LDAP directory for authentication and for selecting users and user groups for tasks. The remaining properties below are only used if this option is selected. 

Deselected 

LDAP host 

The address of the server on which the LDAP directory is stored. 

localhost 

LDAP Port 

The port number for the LDAP server. This is used if SSL is not enabled for LDAP in the following property. 

389 

Is SSL enabled for LDAP 

An indicator of whether you are using SSL to connect to the LDAP server. If this option is selected, the LDAP server connection uses the ldaps:// prefix.

Deselected 

LDAPS port 

The SSL port number for the LDAP server, if SSL is enabled. 

636 

Login Type 

The security level used for logging on to the LDAP server. Select one of the following options: 

  • none: Authentication is not required. Use this option for anonymous access.

  • simple: Authentication requires a user name and password. If you select this option, enter the security information in the following two properties.

none 

LDAP search login DN 

The distinguished named (DN) of the security principal used for LDAP searches. This is required if the Login Type is simple. 

No default value. 

LDAP search login password 

The password for the above security principal. This is required if the Login Type is simple. 

No default value. 

uid attribute name 

The name of the unique ID attribute for each the LDAP user entry. This is used to retrieve the name of a person from the DN. 

uid 

manager attribute name 

The name of the attribute in the LDAP user entry that specifies the user's managers. This is used to retrieve the DN for the person's manager from that person's LDAP entry. 

manager 

email attribute name 

The name of the attribute in the LDAP user entry that specifies the user's email address. This is used to retrieve a person's email address from their LDAP entry. 

mail 

Base DN in search 

The base DN under which LDAP searches are run; for example, dc=company,dc=com. Note that queries run more efficiently under a more specific DN.

dc=example,dc=com 

Scope Type 

An indicator for the LDAP search of the starting point how deep from the base DN to search. Select one of the following options: 

  • sub: Searches LDAP entries at all levels below and including the base DN specified above.

  • one: Searches LDAP entries only at the level just below the base DN specified above. This does not search entries at the base DN level and does not search any levels other than the one below the base DN.

  • base: Searches LDAP entries only at the base DN level.

sub 

User filter 

A filter to use for an LDAP user search. The default value is (uid=%s), which expands the search to the user's ID.

(uid=%s) 

Group filter 

A filter to use for an LDAP group search. The default value is (cn=%s), which expands the search to the group's ID.

cn=%s) 

Table 4 WLM SE Runtime Statistics

Property 

Description 

Activated Endpoints 

The number of activated endpoints. 

Active Exchanges 

The number of active exchanges. 

Avg. Component Time 

The average message exchange component time in milliseconds. 

Avg. D.C. Time 

The average message exchange delivery channel time in milliseconds. 

Avg. Msg. Service Time 

The average message exchange message service time in milliseconds. 

Avg. Response Time 

The average message exchange response time in milliseconds. 

Completed Exchanges 

The total number of completed exchanges. 

Error Exchanges 

The total number of error exchanges. 

Received Dones 

The total number of received dones. 

Received Errors 

The total number of received errors. 

Received Faults 

The total number of received faults. 

Received Replies 

The total number of received replies. 

Received Requests 

The total number of received requests. 

Sent Dones 

The total number of sent dones. 

Sent Errors 

The total number of sent errors. 

Sent Faults 

The total number of sent faults. 

Sent Replies 

The total number of sent replies. 

Sent Requests 

The total number of sent requests. 

Up Time 

The up time of this component in milliseconds. 

The Loggers properties specify the level of logging for each event. You can set the logging level for each logger to any of the following levels:

By default, these are all set to the INFO level.

Table 5 WLM SE Logger Runtime Properties

Property 

WLM Component 

sun-wlm-engine 

com.sun.jbi.engine.workflow 

WorkflowEngine 

com.sun.jbi.engine.workflow.WorkflowEngine 

WorkflowSEBootstrap 

com.sun.jbi.engine.workflow.WorkflowSEBootstrap 

WorkflowSEInOutThread 

com.sun.jbi.engine.workflow.WorkflowSEInOutThread 

WorkflowSELifeCycle 

com.sun.jbi.engine.workflow.WorkflowSELifeCycle 

WorkflowSEServiceUnitManager 

com.sun.jbi.engine.workflow.WorkflowSEServiceUnitManager 

WLMSEComponentManager 

com.sun.jbi.engine.workflow.base.WLMSEComponentManager 

WLMSEConfiguration 

com.sun.jbi.engine.workflow.base.WLMSEConfiguration 

WLMSEEndPointManager 

com.sun.jbi.engine.workflow.base.WLMSEEndPointManager 

WLMSEExchangeHandler 

com.sun.jbi.engine.workflow.base.WLMSEExchangeHandler 

WLMSEServiceUnitManager 

com.sun.jbi.engine.workflow.base.WLMSEServiceUnitManager 

DeploymentLookup 

com.sun.jbi.engine.workflow.com.sun.jbi.common.qos.descriptor.DeploymentLookup 

MessagingChannel 

com.sun.jbi.engine.workflow.com.sun.jbi.common.quos.messaging.MessagingChannel 

EndpointLifeCycle 

com.sun.jbi.engine.workflow.com.sun.jbi.component.tooklit.endpoint.EndpointLifeCycle 

AcceptPoller 

com.sun.jbi.engine.workflow.com.sun.jbi.component.toolkit.lifecycle.impl.AcceptPoller 

DBOperation 

com.sun.jbi.engine.workflow.db.opt.WorkflowSEInOutProvider 

WorkflowSEInOutProvider 

com.sun.jbi.engine.workflow.process.WorkflowSEInOutProvider 

PersistenceTaskManagerImpl 

com.sun.jbi.engine.workflow.runtime.model.impl.PersistenceTaskManagerImpl