System Properties ($sysprop)

Document created by DPM Admin Employee on Jul 21, 2017Last modified by Trishala Kalal on Aug 14, 2017
Version 2Show Document
  • View in full screen mode

Provides an easy shortcut for accessing the System Properties in the Composition without having to traverse the object model.

System Property Methods

string value(string itemType, string propertyPath)

Returns the value of the specified System Property.


The "itemType" parameter value indicates the type of item containing the property (not case sensitive):


      • "Composition"
      • "Band"
      • "Track"
      • "MessageClip"
      • "Message"
      • "Browser Action"
      • "Target"
      • "Destination"
      • "Delay"

The "propertyPath" parameter contains a property path as specified for In Situ Substitution Specifications.

This line of code sets a new value into the specified System Property:

void set(string itemType, string propertyPath, var newValue)

The "itemType" and "propertyPath" parameters are the same as for the "value" method.


The "newValue" parameter is the new value for the property.  It can be null.  (The "undefined" value is treated as null.)  The value will be converted to a string.



System Properties



  • StartTimeMillis - Composition start time, expressed as the difference, in milliseconds, between the start time and midnight, January 1, 1970 UTC
  • ServerNumber - The number of the current server for a multi-server Composition. Ranges from zero to n-1, where n is the number of servers. Always zero when the Composition runs all on one server.



  • VUNumber - The virtual user number represented by the Track


Browser Action:

  • Param1 – The value of the first Browser Action parameter
  • Param2 – The value of the second Browser Action parameter
  • Param3 – The value of the third Browser Action parameter
  • Param4 – The value of the fourth Browser Action parameter



  • Type – Either “Constant” to indicate that this Delay has a fixed duration, or “Random” to indicate that this Delay’s duration is chosen at random on each play.
  • Duration – If type is “Constant”, the duration for this Delay, in milliseconds. Not used if type is “Random”.
  • Minimum – If type is “Random”, the minimum of the range from which durations are to be randomly chosen, in milliseconds. Not used if type is “Constant”.
  • Maximum – If type is “Random”, the maximum of the range from which durations are to be randomly chosen, in milliseconds. Not used if type is “Constant”.


Target: Types HTTP and SOAP

  • URL – Full URL
  • HostName – Host name
  • ServicePath – Service path
  • Port – HTTP Port
  • UseSSL – Use SSL (HTTPS)
  • UserName – HTTP Basic Authentication User name
  • Password – HTTP Basic Authentication User password
  • MaximumConnectionsPerHost – Maximum number of connections that will be created for any particular host URI
  • MaximumTotalConnections – Maximum number of active connections for this Target
  • ConnectionTimeout – Connection timeout, in milliseconds, zero means no timeout
  • SocketReadTimeout – Socket read timeout, in milliseconds, zero means no timeout
  • HttpHostOverride – String value to override a target's host value. See How do I override host files for a load test?
  • HttpBinaryConversion – Integer to specify a binary conversion, such as in the conversion of WCF info


Target: Type Browser

    • StartingURL – Starting URL
    • BrowserType – Browser type
    • Conductor – Conductor Name
    • WaitTimeout – Wait timeout for a single wait condition in milliseconds
    • AllowNativeXPath – Whether to use the browser's native XPath for evaluating locators
    • MouseSpeed – The number of pixels to move the mouse in drag and drop or move events
    • WaitInterval – The interval on which to check for the wait condition
    • ActionTimeout – Action timeout in milliseconds
    • FirefoxProfle – The Firefox profile to set. Refer to the Conductor Capabilities, Using Firefox Profiles section.