Creating and enabling a case history store by using the command line

You must create and enable an event export store if you want to use extended case history features. For example, if you want to view the progression of a case over time by using the Timeline Visualizer widget, you must create and enable a case history store.

Before you begin

You must prepare a database for recording extended case history before you create and enable the case history store.

About this task

You must specify a case management target object store to associate with the case history store. You must also specify the schema name for the case history store database, and a database connection. If a database connection is not specified, the database connection for the target object store is used.

Attention: If the Content Platform Engine server that serves as the backend to the IBM® Business Automation Workflow system is configured as a cluster, create and enable the case history store when only a single Content Platform Engine server is available. This is typically during a maintenance window when all but one of the application server instances hosting the Content Platform Engine server can be stopped.

Procedure

To create and enable a case history store:

  1. Change the current directory to the install_root/CaseManagement/configure directory. Where install_root is the location where IBM Business Automation Workflow is installed.
  2. Create and enable a case history store by running the following command. Do not enter any line breaks when you enter the command. 
    configmgr_cl createCaseHistoryStore
 -profile myprofile
 -cmtos target_object_store
 -schemaName schema_name
 -dbConnName database_connection
  [-help]
    -profile myprofile
    Specifies the profile to use. The myprofile value can be one of the following items:
    • The name of the profile, such as develop1. The profile is located in the install_root/CaseManagement/configure/profiles directory. install_root is the location where IBM Business Automation Workflow is installed.
    • The full path to the profile directory, such as "install_root\CaseManagement\configure\profiles\develop1" or /install_root/CaseManagement/configure/profiles/develop1.
    • The full path to the profile input file, such as "install_root\CaseManagement\configure\profiles\develop1\develop1.cfgp" or /install_root/CaseManagement/configure/profiles/develop1/develop1.cfgp.
    -cmtos target_object_store
    Specifies the display name for a case management target object store.
    -schemaName schema_name
    Specifies the name of the schema to use for the case history store.
    -dbConnName database_connection
    Specifies the display name of the database connection. You can view and define database connections by using the Administration Console for Content Platform Engine.
    -help
    Optional and displays a brief message on the command syntax instead of running the command.