Package.MaxConcurrentExecutables Property

Article
12/03/2008

Gets or sets the number of threads that a package can create.

Namespace: Microsoft.SqlServer.Dts.Runtime
Assembly: Microsoft.SqlServer.ManagedDTS (in microsoft.sqlserver.manageddts.dll)

Syntax

'Declaration
Public Property MaxConcurrentExecutables As Integer

public int MaxConcurrentExecutables { get; set; }

public:
property int MaxConcurrentExecutables {
    int get ();
    void set (int value);
}

/** @property */
public int get_MaxConcurrentExecutables ()

/** @property */
public void set_MaxConcurrentExecutables (int value)

public function get MaxConcurrentExecutables () : int

public function set MaxConcurrentExecutables (value : int)

Property Value

An Integer that contains the number of threads that a package can create.

Remarks

Updated text:5 December 2005

Valid values are one and higher, or -1. Other values are invalid. A value of -1 allows the maximum number of concurrently running executables to equal the number of processors plus two. Setting this property to zero or any other negative value fails with an error code that indicates an invalid argument.

This property is used when parallelism exists in the workflow. If the workflow is a series of sequential precedence constraints, then this property has no effect.

Example

The following code example sets the MaxConcurrentExecutables to 1, and sets that value on the ForEachLoop so the ForEachLoop will run one task at a time.

Package p;
p.MaxConcurrentExecutables = 1;
ForEachLoop loop;
loop.MaxConcurrent = p.MaxConcurrentExecutables;

Dim p As Package
p.MaxConcurrentExecutables = 1
Dim loop As ForEachLoop
loop.MaxConcurrent = p.MaxConcurrentExecutables

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms