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

deleteAuditLog.py administrative script

Use the deleteAuditLog.py administrative script to selectively delete audit log entries for the Business Flow Manager.

Prerequisites

The following conditions must be met:

• Run the script in connected mode, that is, the application server must be running. Do not use the wsadmin -conntype none option.

• If Business Process Choreographer is configured on a cluster, then at least one cluster member must be running.

• If WebSphere administrative security is enabled, and your user ID does not have operator authority, include the wsadmin -user and -password options to specify a user ID that has operator authority.
• If you are not working with the default profile, use the wsadmin -profileName profile option to specify the profile.

Location

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

Syntax

 -f deleteAuditLog.py 
       (([-node  nodeName] -server  server_name) | (-cluster  cluster_name))
       ( -all | -timeUTC  timestamp | -timeLocal  timestamp 
              | -processtimeUTC  timestamp | -processtimeLocal  timestamp )
       [-slice  size]

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.

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

-all

Deletes all the audit log entries in the database. The deletion is done in multiple transactions. Each transaction deletes the number of entries specified in the slice parameter, or the default number.

-timeUTC timestamp

Use this option to specify the deletion cutoff date and time in Coordinated Universal Time (UTC). Only audit log entries that are older than the time you specify for timestamp are deleted. Its format must be: YYYY-MM-DD['T'HH:MM:SS]. If you specify only the year, month, and day, the hour, minutes, and seconds are set to 00:00:00 UTC.

-timeLocal timestamp

Use this option to specify the deletion cutoff date and local time on the server. Only audit log entries that are older than the time you specify for timestamp are deleted. Its format must be: YYYY-MM-DD['T'HH:MM:SS]. If you specify only the year, month, and day, the hour, minutes, and seconds are set to 00:00:00 local time on the server.

-processTimeUTC timestamp

Use this option to specify the deletion cutoff date and time in UTC. Only audit log entries that belong to a process that finished before the time you specify for timestamp are deleted. Its format must be: YYYY-MM-DD['T'HH:MM:SS]. If you specify only the year, month, and day, the hour, minutes, and seconds are set to 00:00:00 UTC.

-processTimeLocal timestamp

Use this option to specify the deletion cutoff date and local time on the server. Only audit log entries that belong to a process that finished before the time you specify for timestamp are deleted. Its format must be: YYYY-MM-DD['T'HH:MM:SS]. If you specify only the year, month, and day, the hour, minutes, and seconds are set to 00:00:00 local time on the server.

-slice size

Used with the -all parameter, size specifies the number of entries included in each transaction. The optimum value depends on the available log size for your database system. Higher values require fewer transactions but you might exceed the database log space. Lower values might cause the script to take longer to complete the deletion. The default size for the slice parameter is 250.

Business Process Choreographer administrative scripts

Related tasks:
Delete audit log entries, using administrative scripts