Using the taskconfig.jacl script to configure the human task container

This script file configures the human task container.

Purpose

This script file configures all the resources that are required by the Human Task Manager.

This file is in the folder install_root/ProcessChoreographer.

Attention: If you run the bpeconfig.jacl script, you need not run the taskconfig.jacl script, because the bpeconfig.jacl script calls the taskconfig.jacl script.

Running the script interactively

To run taskconfig.jacl in an interactive dialog session:
On UNIX and Linux systems, enter the command:
install_root/bin/wsadmin.sh
       -f install_root/ProcessChoreographer/taskconfig.jacl 
       [-conntype none]
       [-username userName]
       [-password password]       
On Windows systems, enter the command:
install_root\bin\wsadmin.bat
       -f install_root\ProcessChoreographer\taskconfig.jacl
       [-conntype none]
       [-username userName]
       [-password password]
In a standalone server environment:
  • Include the option conntype none only if the deployment manager is not running.
  • If global security is enabled, include the options username and password.
In a Network Deployment environment:
  • Run the taskconfig.jacl script on the deployment manager node.
  • Include the option conntype none only if the deployment manager is not running.
  • If the deployment manager is running, do not use the option conntype none.
  • If global security is enabled, include the options username and password.

Configuring the human task container noninteractively

If you provide the necessary parameters on the command line, you will not be prompted for them. To configure a business process container that uses the default messaging JMS provider with a Cloudscape database type, enter the following:

On UNIX and Linux systems, if your current directory is install_root/ProcessChoreographer, enter the command:

../bin/wsadmin.sh -conntype none -f taskconfig.jacl
       -adminHTMUsers userList
       -adminHTMGroups groupList
       -monitorHTMUsers userList
       -monitorHTMGroups groupList
       -jmsHTMRunAsUser userID
       -jmsHTMRunAsPwd password
       -mqType MQSeries
       -mqUser mqm
       -mqPwd mqm
       -mqHome /usr/mqm
       -mailServerName hostName
       -mailUser userID
       -mailPwd password

Parameters

adminHTMUsers userList
Where userList is the list of names of users, from the WebSphere registry, to which to map the HTMSystemAdminstrator Java 2 Enterprise Edition (J2EE) role. The separator character is |. This property is needed to install the task container. This parameter has no default value. This parameter has no default value. Either or both adminHTMUsers or adminHTMGroups must be set.
adminHTMGroups groupList
Where groupList is the list of names of groups, from the WebSphere registry, to which to map the HTMSystemAdminstrator J2EE role. The separator character is |. This property isneeded to install the task container. This parameter has no default value. Either or both monitorHTMUsers or adminHTMGroups must be set.
monitorHTMUsers userList
Where userList is the list of names of users, from the WebSphere registry, to which to map the HTMSystemMonitor J2EE role. The separator character is |. This property is needed to install the task container. This parameter has no default value. Either or both monitorHTMUsers or monitorHTMGroups must be set.
monitorHTMGroups groupList
Where groupList is the list of names of groups, from the WebSphere registry, to which to map the HTMSystemMonitor J2EE role. The separator character is |. This property is needed to install the task container. This parameter has no default value. Either or both monitorHTMUsers or monitorHTMGroups must be set.
jmsHTMRunAsUser userID
Where userID is the run-as user ID for the task container message-driven bean. This property is needed to install the task container. This parameter has no default value. It must be set.
msHTMRunAsPwd password
Where password is the password for the task container message-driven bean. This property is needed to install the task container. This parameter has no default value. It must be set.
mqType JMSProviderType
Where JMSProviderType is the type of Java Message Service (JMS) provider to use for process choreographer. It is needed to create the queue manager and the queues, and to create the listener ports and the queue connection factories.

Where JMSProviderType is one of the following values:

WPM
For default messaging
MQSeries
For WebSphere MQ
mqUser userID
Where userID is the user ID to access WebSphere MQ. It is needed to create the queue manager and the queues, when using the "MQSeries" JMS provider on non-Windows platforms, and to create the listener ports and the queue connection factories, when using the JMS provider for WPM.

Default values for userID:

Windows platforms
currently_logged-on_user
Other platforms
mqm
mqPwd password
Where password is the password to access WebSphere MQ. It is needed to create the queue manager and the queues, when using the "MQSeries" JMS provider on non-Windows platforms, and for creating the listener ports and the queue connection factories, when using the JMS provider for WPM. This parameter has no default value.
mqHome installationDirectory
Where installationDirectory is the installation directory of WebSphere MQ. It is needed to create the queue manager and the queues (Windows only) and for creating the listener ports and the queue connection factories.

Default values for installationDirectory:

Windows platforms
current_drive\Program Files\IBM\WebSphere MQ
AIX platform
/usr/mqm
iSeries platform
/QIBM/ProdData/mqm
SunOS platform
/opt/mqm
qmNameGet getQueueManagerName
Where getQueueManagerName is the name of the queue manager for GET requests. It is used with only the JMS provider designated MQSeries. It is needed to create the queue manager and the queues, and to create the listener ports and the queue connection factories. It must not contain the - character.

Default value for getQueueManagerName: BPC_nodeName_serverName

qmNamePut putQueueManagerName
Where putQueueManagerName is the queue manager name for PUT requests. It is used only when the mqClusterName parameter has been set. It is needed to create the queue manager and the queues, and to create the listener ports and the queue connection factories. It must not contain the - character, and it must not be the same as used for the qmNameGet parameter.

Default value for putQueueManagerName:BPCC_nodeName_serverName

mailServerName mailServerName
Where mailServerName is the host name of the mail server to be used to send notification mails.
mailUser mailUserID
Where mailUserID is the user ID to access the mail server. It is needed to create the mail session for the human task manager to send notification mails.

Default: Empty: no authentication is required to access the mail server.

mailPwd mailPassword
Where mailPassword is the password to access the mail server. It is needed to create the mail session for the Human Task Manager to send notification mails.
profile profileName
Where profileName is the name of a user-defined profile. Specify this option if you are not configuring the default profile.

Installing the SchedulerCalendars system application

The task container requires the SchedulerCalendars system application. This application is not installed automatically on federated nodes and cannot be installed automatically during the installation of Business Process Choreographer. Therefore, whenever you configure the human task container in a Network Deployment (ND) environment, either by running the bpeconfig.jacl or taskconfig.jacl script or by running the administrative console wizard, install the SchedulerCalendars system application as described in Installing the WebSphere SchedulerCalendars application on federated nodes.


Terms of use | | Broken links

Last updated: Tue Feb 21 17:47:12 2006

(c) Copyright IBM Corporation 2005.
This information center is powered by Eclipse technology (http://www.eclipse.org)