Use the administrative commands to delete, from the database, process
templates and task templates that are no longer valid.
Before you begin
Before you begin this procedure, the application server on which
templates are to be deleted must be running. That is, the -conntype
none option of wsadmin cannot be used, because a
server connection is required. No special authority is required to run this
command, even if security is enabled.
Why and when to perform this task
Use the methods described here to remove, from the database, templates
and all objects that belong to them if no corresponding valid application
in the WebSphere® configuration
repository contains them. This situation can occur if an application installation
was canceled or not stored to the Configuration Repository by the user. These
templates usually have no impact. They are not shown in Business Process Choreographer
Explorer.
There are rare situations in which these templates cannot
be filtered. They must then be removed from the database with the following
scripts.
You cannot use the scripts to remove templates of valid applications
from the database. This condition is checked and a ConfigurationError exception
is thrown if the corresponding application is valid.
Steps for this task
- Change to the Business Process Choreographer subdirectory where the administration
scripts are located.
On Windows
® systems,
enter:
cd install_root\ProcessChoreographer\admin
On Linux
® and UNIX
® systems,
enter:
cd install_root/ProcessChoreographer/admin
- Delete, from the database, business process templates or human
task templates that are no longer valid.
To delete, on Windows systems, a business process
template that is no longer valid, enter one of the following commands. The
differences between the commands are emphasized:
install_root\bin\wsadmin –lang jython -f deleteInvalidProcessTemplate.py
-server serverName
-template templateName
-validFrom validFromString
[-profileName profileName]
install_root\bin\wsadmin –lang jython -f deleteInvalidProcessTemplate.py
-server serverName
-node nodeName
-template templateName
-validFrom validFromString
[-profileName profileName]
install_root\bin\wsadmin –lang jython -f deleteInvalidProcessTemplate.py
-cluster clusterName
-template templateName
-validFrom validFromString
[-profileName profileName]
To delete, on UNIX and Linux systems, a business process template
that is no longer valid, enter one of the following commands. The differences
between the commands are emphasized:
install_root/bin/wsadmin.sh –lang jython -f deleteInvalidProcessTemplate.py
-server serverName
-template templateName
-validFrom validFromString
[-profileName profileName]
install_root/bin/wsadmin.sh –lang jython -f deleteInvalidProcessTemplate.py
-server serverName
-node nodeName
-template templateName
-validFrom validFromString
[-profileName profileName]
install_root/bin/wsadmin.sh –lang jython -f deleteInvalidProcessTemplate.py
-cluster clusterName
-template templateName
-validFrom validFromString
[-profileName profileName]
Where:
- cluster clusterName
- The name of the cluster. Required if the business process container is
configured for a WebSphere cluster. You can specify the cluster
name or the server name and node name.
- node nodeName
- Optional when specifying the server name. This name identifies the node.
The default is the local node. You can specify the server name and node name
or the cluster name.
- server serverName
- The name of the server. Required if the cluster name is not specified.
You can specify the server name and node name or the cluster name.
- template templateName
- The name of the process template or task template to be deleted.
- validFrom validFromString
- The date from which the template is valid (in UTC) as displayed in the
administrative console. The string should have the following format: 'yyyy-MM-ddThh:mm:ss'
(year, month, day, T, hours, minutes, seconds). For example, 2005-01-31T13:40:50
- nameSpace nameSpace
- The target namespace of the task template.
- profileName profileName
- The name of a user-defined profile. Specify this option if you are not
working with the default profile.
Example
Note: The jacl version of the cleanup unused staff query script, deleteInvalidTaskTemplate.jacl,
is deprecated. It is available in the util subdirectory of
the ProcessChoreographer directory and it takes the same
parameters as described here, but the –lang jython option
must be omitted.