IBM BPM, V8.0.1, All platforms > Administer the IT infrastructure > Administer Business Process Choreographer > Use scripts to administer Business Process Choreographer > Delete Business Process Choreographer objects

Delete human task templates that are no longer valid

Use an administrative script to delete, from the Business Process Choreographer database, human task templates that are no longer valid.

You must know both the name of the template and the ValidFromUTC value for the template that you want to delete. If you do not have that information, perform Listing information about process and task templates first. The following conditions must be met:

• Run the script in the connected mode, that is, the application server must be running.

• You must have either operator or deployer authority.

• If Business Process Choreographer is configured on a cluster, then at least one cluster member must be running.
• If you are not working with the default profile, use the wsadmin -profileName profile option to specify the profile.

The deleteInvalidTaskTemplate.py script removes from the database those templates, and all objects that belong to them, that are not contained in any corresponding valid application in the WebSphere configuration repository. This situation can occur if deploying an application was canceled or the application was not stored in the configuration repository by the user. These templates usually have no impact. They are not shown in Business Process Choreographer Explorer.

You cannot use this script 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.

Procedure

1. Change to the Business Process Choreographer subdirectory where the administrative script is located.
   

   cd  INSTALL_ROOT/ProcessChoreographer/admin

   cd INSTALL_ROOT/ProcessChoreographer/admin

   cd INSTALL_ROOT\ProcessChoreographer\admin

2. Delete, from the database, human task templates that are no longer valid.
   

    INSTALL_ROOT/bin/wsadmin.sh  -f deleteInvalidTaskTemplate.py
        (([-node  nodeName] -server  server_name) | (-cluster  cluster_name))
        -templateName  templateName
        -validFromUTC  timestamp
        -nameSpace  nameSpace

   

    INSTALL_ROOT/bin/wsadmin.sh  -f deleteInvalidTaskTemplate.py
        (([-node  nodeName] -server  server_name) | (-cluster  cluster_name))
        -templateName  templateName
        -validFromUTC  timestamp
        -nameSpace  nameSpace

   

    INSTALL_ROOT\bin\wsadmin -f deleteInvalidTaskTemplate.py
        (([-node  nodeName] -server  server_name) | (-cluster  cluster_name))
        -templateName  templateName
        -validFromUTC  timestamp
        -nameSpace  nameSpace

   Where:

   -node nodeName

   The name of the node where Business Process Choreographer is configured. This is optional when specifying the server name. The default is the local node.

   -server serverName

   The name of the server where Business Process Choreographer is configured. This is required if a cluster is not specified.

   -cluster clusterName

   The name of the cluster where Business Process Choreographer is configured. This is required if Business Process Choreographer is configured on a cluster.

   -templateName templateName

   The name of the template to be deleted.

   -validFromUTC timestamp

   The date and time from which the template is valid in Coordinated Universal Time (UTC). The string must 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.

3. If the script triggers long-running work on the server, the script might fail if the connection timeout is not long enough to complete the action. Check the SystemOut.log file on the server to see whether you need to restart the script. If the timeout happens often, consider increasing the value of the timeout property for the connector you are using, or adjusting the script parameters to reduce the amount of work done on the server.
   

Delete Business Process Choreographer objects

Related concepts:
How time zones are handled in Business Process Choreographer

Related information:
Connection timeout when running a wsadmin script