The runppmdelete argument

-ps <file name>

This argument is used to specify the XML file containing the paramset.

-mode <test|execute>

test: This argument enables you to perform a test run using the output statistics to identify which process instances and how many would be deleted. This does not make any changes to the database.

execute: The process instances are deleted. This operation cannot be undone. A statistics is output.

Default value: test

-excluding <n>[y|q|m|w|d|h]

The process instances lying in the specified time period are not deleted, even if they are included in the filter. The period is specified as a number of particular sections of time. The starting time of the command line program is used as the reference time.

Abbreviation

Time section

Example

y

Year

1y: Process instances from January 1st of the current year to the start time of the command line program are not deleted.

q

Quarter

2q: Process instances for the current last completed quarter are not deleted.

m

Month

-

w

Week

4w: Process instances for the current week and the last three weeks are not deleted.

d

Day

-

h

Hour

24h: Process instances for the current hour and the last 23 hours are not deleted.

Example

In the analysis component, the Number of processes measure has been displayed over time with a filter for the Customer/Austria dimension for the Other orders process type. The corresponding paramset was saved in the file paramset.xml:

<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE paramset SYSTEM "paramset.dtd">

<paramset>

<analysewizparam selectedrow="0"/>

<chartparam>

<chart-chartposition> 0.175,0.1</chart-chartposition>

<chart-legend-visible> false</chart-legend-visible>

<chart-zoom>75</chart-zoom>

<chart-scale>1.0,10.00.10.0</chart-scale>

<chart-colinfo/>

</chartparam>

<cpiparam/>

<epkparam/>

<favoritparam usecache="yes"/>

<kiquery usecache="yes" showzero="auto">

<keyindicator>

<criterion name="PNUM">Number of processes</criterion>

</keyindicator>

<iteration>

<criterion name="TIME">Time</criterion>

<refinement name="BY_MONTH">By month</refinement>

</iteration>

<filter>

<criterion name="PROCESSTYPE">Process type</criterion>

<filteritem operator="or">

<datalist usewildcard="no">

Order processing

<dataitem>

Order processing\Other orders

<datatype name="TEXTPAIR">Text pair</datatype>

<scale name="LEVEL1SCALE">Rough</scale>

</dataitem>

</datalist>

</filteritem>

</filter>

<filter>

<criterion name="PRINCIPAL">Sold-to party</criterion>

<filteritem operator="or">

<datalist usewildcard="no">

AUSTRIA (A)

<dataitem>

A{AUSTRIA}

<datatype name="TEXTPAIR">Text pair</datatype>

<scale name="LEVEL2SCALE" factor="2.0">

Detailed

</scale>

</dataitem>

</datalist>

</filteritem>

</filter>

</kiquery>

<navparam>

<nav-view>chart</nav-view>

</navparam>

<tableparam view="listtable">

<tbl-cross totalresult="yes"/>

<tbl-instance split="horizontal"/>

</tableparam>

</paramset>

Executing the following command line will delete all process instances with the Sold-to party Austria:

runppmdelete -user system -password manager -ps paramset.xml -mode execute

-recoveryfile {yes|no}

With -recoveryfile yes (default setting) you specify that the analysis server recovery files relevant for process analysis are to be created after successful deletion under <installation directory<\ppmmashzone\server\bin\work\data_ppm\recovery\<client>.