Range Button

Select the Range radio button (default) to set a unique, sequential integer number, within “blocks” of numbers allocated to each Maestro Server.

The value will be either a number or the string representation of one.

Start – The required starting number (the first number to be allocated).

Server Block Size – The required size of the block of numbers to be allocated to each Maestro Server in the Composition. Each server will allocate numbers from its assigned block.

Range End Action – Specifies what is to happen if a server reaches the end of its block of numbers.

The options are very similar to what happens for the similar situation when using Seed Data:

  • Wrap – Property values will start over at the beginning of the data range.
  • Null – The value of the Custom Property will be set to null.
  • Error – The item containing the Custom Property will fail. Error handling will proceed according to the regular "Failure action" settings of the item, it's parents, and the Composition.
  • Stop Track and Drain – The current instance of the item's parent Track on the current server (and everything in it) is stopped. No new repeats or parallel repeat renewals will occur for that Track on this server. Other instances of the Track on this server that already exist will continue to their normal end, but no new instances will be started on this server. In other words, if using the recommended approach of having each Track represent a "Virtual User," and if using "Parallel Repeat Renewal" to cause each Virtual User to be automatically replaced when it ends, then this setting will cause no new Virtual Users to be created on this server when its seed data runs out.
  • Stop Composition – The entire Composition (on all servers) will be stopped immediately (as if the "Stop" button had been pressed).


If this is given, the Custom Property’s value will be a string, rather than a number, and the string will be the number formatted as specified by the pattern. The standard Java object “DecimalFormat” is used to do the formatting, and any pattern accepted by that object can be used.

The Generated Values form will validate any entered pattern, and display the green check mark (shown above) to indicate a valid pattern. Note that if the pattern is played without this validation an error will appear when the Composition is played.