PROC_VER_NUM_INSTANCES

Summary

This attribute defines how many old instances of a procedure are kept in the iProcess database. The most recent instance of a procedure version is always kept. See the Example.

Applies To

This attribute must be set for ALL processes.

Permissible Values

The attribute value must be one of the following:

Value	Meaning
0	There is no limit to the number of instances of a procedure that are kept. This is the default value.
n	`n` number of instances of a procedure will be kept in the iProcess database (where `n` is a positive integer).

Default Value

This attribute is not defined on a newly installed iProcess Engine node. In this case, the default value is:

Machine ID	Process	Instance	Value
0	ALL	0	0

The attribute only appears in the output of the SHOW_ALL_ATTRIBUTES command if you have explicitly assigned a value to it using the SET_ATTRIBUTE command. The default setting is not displayed

Notes

Every time you edit and save a version of a procedure, iProcess creates a new instance of that procedure version.

The PROC_VER_NUM_INSTANCES attribute applies to all old instances of a procedure. Each procedure instance is allocated an instance identifier. Each time a new instance is created the instance identifier is incremented by one.

The instances of a procedure are tidied up as when a procedure is saved. This is because a tidy operation is performed each time a procedure is saved which tidies up the number of instances according to the attribute value you have set.

The first time you set the attribute you can run the swadm tidy_instances command to force a tidy operation to tidy up the number of instances of some or all of your procedures, depending on your requirements. To do this you need to run the swadm tidy_instances command. See Tidy Instances of Procedures for more information.