test entity XML

The elements of the XML are:

Element Description
Controller Optional. If not passed in the request, the value is set to dedicated, meaning that Performance Center assigns a controller at the beginning of the test execution .
Groups/Group [1..n] Required.
Groups/Group/Name Any group name valid in LoadRunner.
Groups/Group/RTS An XML segment containing the data used to define Run Time Settings. See Run-time Settings XML
Groups/Group/Scheduler Required if schedule is by group. The sub-elements of the group scheduler are the same as for a global scheduler. See below, Scheduler/*
Groups/Group/Script/ID Script ID.
Groups/Group/Vusers

If the test is scheduled by scenario and the vusers distribution is by number, value is a positive integer.

If the vusers distribution is by percentage, value is 0-100.

LGDistribution/Amount Required if LGDistribution/Type is all to each group. Non-negative integer.
LGDistribution/Type

Required. One of:

  • all to each group

  • manual

Scheduler Global scheduler. The same element can appear under Groups/Group/Scheduler

Scheduler/Actions/Action [1..n]

Scheduler actions are affected by the WorkloadType/Type. See the Description of WorkloadType/Type.

An action contains exactly one element. The contained element is one of:

  • Duration
  • Initialize
  • StartGroup
  • StartVusers
  • StopVusers

See descriptions of these elements in the following rows.

Scheduler/Actions/Action/Duration

The Duration Type attribute is one of:

  • Type="indefinitely"
  • Type="run for"
  • Type="until complete"

If the workload type is real-world, use Type="run for".

Scheduler/Actions/Action/Duration
     /TimeInterval/Hours
     /TimeInterval/Minutes
     /TimeInterval/Seconds
The time interval. Non-negative integers.
Scheduler/Actions/Action/Initialize Required once for every scheduler. Must be the first action in a global scheduler or the second action in a group scheduler.

The Initialize Type attribute is one of:

  • Type="gradually"
  • Type="just before vuser runs"
  • Type="simultaneously"

Scheduler/Actions/Action/Initialize
     /TimeInterval/Hours
     /TimeInterval/Minutes
     /TimeInterval/Seconds

The time interval. Non-negative integers.

Scheduler/Actions/Action//Initialize
     /WaitAfterInit/Hours
     /WaitAfterInit/Minutes
     /WaitAfterInit/Seconds

The time to wait after initialization. Non-negative integers.
Scheduler/Actions/Action/StartGroup

Valid only if the test scheduler is set to by group. Each scheduler has only one definition for the StartGroup action.

Cyclic start actions are invalid. For example, if group A starts after group B and group C starts after group B, group A cannot start after group C.

The StartGroup Type attribute is one of:

  • Type="immediately"
  • Type="with delay"
  • Type="when group finishes"

Scheduler/Actions/Action/StartGroup
     /TimeInterval/Hours
     /TimeInterval/Minutes
     /TimeInterval/Seconds

The time interval. Non-negative integers.
Scheduler/Actions/Action/StartGroup/Name Any group name valid in LoadRunner.
Scheduler/Actions/Action/StartVusers

The StartVusers Type attribute is one of:

  • Type="simultaneously"
  • Type="gradually"

Populate this element according to Workload type and the StartVusers type.

      Workload type /
StartVusers type
basic real-world
simultaneously basic/simultaneously real-world/simultaneously
gradually basic/gradually real-world/gradually
Scheduler/Actions/Action/StopVusers

The StopVusers Type attribute is one of:

  • Type="simultaneously"
  • Type="gradually"

Populate this element according to the Workload type and StopVusers type

      Workload type /
StopVusers type
basic real-world
simultaneously basic/simultaneously real-world/simultaneously
gradually basic/gradually real-world/gradually
WorkloadType/SubType

Required. One of:

  • by test
  • by group
WorkloadType/Type

Required. One of:

  • basic
  • real-world

The workload type affects the Scheduler/Actions. If the workload type is basic, there can be only one action each of types StartVusers, Duration, and StopVusers, and these actions must be in exactly that order.

If the workload type is real-world, any order of actions is valid. However, we recommend that StartVusers be before StopVusers.

If the workload type is real-world, you must set the number of vusers to start. At all times, the number of started vusers must be greater than or equal to the number of stopped vusers .

WorkloadType/VusersDistributionMode

Required if WorkloadType/SubType is by test. One of:

  • by number

  • by percentage

ClosedExample

See Also

tests
tests/{ID}










_HP_HTML5_bannerTitle.htm