Deleting process templates and task templates that are no longer valid

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

  1. 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
  2. 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.

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