IBM BPM, V8.0.1, All platforms > Reference > Commands and scripts > Business Process Choreographer administrative scripts

deleteInvalidProcessTemplate.py script

Use the deleteInvalidProcessTemplate.py administrative script to delete, from the database, process templates and task templates that are no longer valid.

The deleteInvalidProcessTemplate.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 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.

The deleteInvalidProcessTemplate.py administrative script is run using the wsadmin scripting client.

Prerequisites

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.

Location

The deleteInvalidProcessTemplate.py administrative script is in the Business Process Choreographer admin directory.

Syntax

 -f deleteInvalidProcessTemplate.py
         (([-node  nodeName] -server  server_name) | (-cluster  cluster_name))
         -templateName  templateName
         -validFromUTC  timestamp

Parameters

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

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

-server serverName

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

-templateName templateName

Optionally, specifies the name of the task template whose instances will be deleted. If you specify this option you must also specify the nameSpace parameter. If there are multiple task templates sharing the same name but with different validFromUTC dates the instances for all task templates with that name are deleted unless you use the validFromUTC parameter to specify a particular template.

-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

Examples

Business Process Choreographer administrative scripts

Related tasks:
Delete process templates that are no longer valid