This topic applies only to the IBM Business Process Manager Advanced configuration.

This topic applies only to the IBM Business Process Manager Standard configuration.

setStateObserver.py administrative script

Use the setStateObserver.py administrative script to enable or disable Common Event Infrastructure (CEI), audit events for Business Process Choreographer, or the task history log for the Human Task Manager. In addition, for federated environments that include Process Federation Server, you can enable or disable change logging for BPEL indexes.

Location

The setStateObserver.py administrative script is in the Business Process Choreographer admin directory.

install_root\ProcessChoreographer\admin
install_root/ProcessChoreographer/admin

Syntax

-f setStateObserver.py 
     -bfm 
     -cluster clusterName
     -conntype NONE
     -enable {CEI | AuditLog | TaskHistory | IndexerLog}
     -disable {CEI | AuditLog | TaskHistory | IndexerLog}
     -htm 
     -profileName profileName

Parameters

-f: This parameter specifies the script file to run.
-bfm: Optionally specifies that the enabling or disabling applies only to the Business Flow Manager of Business Process Choreographer, which runs BPEL processes. By default, when you specify neither -bfm nor -htm, the enabling or disabling applies to both the Business Flow Manager and the Human Task Manager.
-cluster clusterName: The name of the cluster where Business Process Choreographer is configured. In a multicluster setup, you must specify the application cluster because that is where Business Process Choreographer is configured.
-conntype NONE: Include this option only if the deployment manager is not running.
-enable CEI | AuditLog | TaskHistory | IndexerLog: Optionally specifies whether to enable CEI logging, audit logging, the Human Task Manager task history, or change logging for BPEL indexes. To specify more than one, use a semi-colon as a separator, for example, to enable CEI and audit logging, use -enable "CEI;AuditLog". The value TaskHistory is not valid if -bfm is specified.
-disable CEI | AuditLog | TaskHistory | IndexerLog: Optionally specifies whether to disable CEI logging, audit logging, the Human Task Manager task history, or change logging for BPEL indexes.
-htm: Optionally specifies that the enabling or disabling applies only to the Business Process Choreographer's Human Task Manager, which runs human tasks. By default, when you specify neither -bfm nor -htm, the enabling or disabling applies to both the Business Flow Manager and the Human Task Manager.
-profileName profileName: Where profileName is the name of the profile to use.

Examples

The following example shows how to enable CEI logging for BPEL process events on myCluster:

For Linux operating system For UNIX operating system Enter the following command:

wsadmin.sh -f setStateObserver.py -cluster myCluster -enable CEI -bfm

For Windows operating system Enter the following command:

wsadmin -f setStateObserver.py -cluster myCluster -enable CEI -bfm