SessionStartInfo.ResourceUnitType Property

  • Article

Determines whether cores, nodes, or sockets are used to allocate resources for the service instance job.

Namespace: Microsoft.Hpc.Scheduler.Session
Assembly: Microsoft.Hpc.Scheduler.Session (in Microsoft.Hpc.Scheduler.Session.dll)

Usage

'Usage
Dim instance As SessionStartInfo
Dim value As Nullable(Of JobUnitType)

value = instance.ResourceUnitType

instance.ResourceUnitType = value

Syntax

'Declaration
<ObsoleteAttribute("ResourceUnitType is obsolete. Use SessionResourceUnitType")> _
Public Property ResourceUnitType As Nullable(Of JobUnitType)

[ObsoleteAttribute("ResourceUnitType is obsolete. Use SessionResourceUnitType")] 
public Nullable<JobUnitType> ResourceUnitType { get; set; }

[ObsoleteAttribute(L"ResourceUnitType is obsolete. Use SessionResourceUnitType")] 
public:
property Nullable<JobUnitType> ResourceUnitType {
    Nullable<JobUnitType> get ();
    void set (Nullable<JobUnitType> value);
}

/** @property */
public Nullable<JobUnitType> get_ResourceUnitType ()

/** @property */
public void set_ResourceUnitType (Nullable<JobUnitType> value)

public function get ResourceUnitType () : Nullable<JobUnitType>

public function set ResourceUnitType (value : Nullable<JobUnitType>)

Property Value

The unit type. The default is Core. For possible values, see the JobUnitType enumeration.

Remarks

The resource units that you specify should be based on the threading model that the service uses. Specify Core if the service is linked to non-thread safe libraries. Specify Node if the service is multithreaded. Specify Socket if the service is single-threaded and memory-bus intensive.

By default, if you specify Core, the broker sends the service one message at a time. If you specify Node, the broker batches together the number of messages that is equal to the number of cores on the node, and then sends them to the service. If you specify Socket, the broker batches together the number of messages that is equal to the number of cores on the socket, and then sends them to the service.

To override the default behavior, configure the ServiceThrottlingBehavior section of your service.dll.config file to specify the maximum concurrent calls that the service can accept. For example, if you are using the Parallel Extension, you can specify the following service behavior in the service.dll.config file to override the default behavior for the node resource unit type so that the service receives only one request at a time.

<serviceBehaviors>
    <behavior  name="Throttled">
        <serviceThrottling maxConcurrentCalls="1" />
    </behavior>
</serviceBehaviors>

The broker uses the value of maxConcurrentCall as the capacity of the service. This lets the administrator or software developer use a standard WCF setting to fine tune the dispatching algorithm of the broker node to fit the processing capacity of the service.

If you set the unit type, it must be the same as in the template, if one is specified.

Platform Note: This property is obsolete for Windows HPC Server 2008 R2. Use the SessionResourceUnitType property instead.

Thread Safety

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

Platforms

Development Platforms

Microsoft Windows HPC Server 2008, Windows HPC Server 2008 R2, Windows Server 2008 R2, Windows Server 2008, Windows 7, Windows Vista, Windows XP

Target Platforms

Windows Server 2003 R2 with HPC Pack 2008 R2 Client Utilities, Microsoft Windows HPC Server 2008, Windows Server 2008 with HPC Pack 2008 Client Utilities, Windows Vista with HPC Pack 2008 Client Utilities, Windows XP with HPC Pack 2008 Client Utilities, Windows HPC Server 2008 R2, Windows Server 2008 R2 with HPC Pack 2008 R2 Client Utilities, Windows Vista with SP2 and HPC Pack 2008 R2 Client Utilities, Windows XP with SP2 (32-bit version) or SP3 (64-bit version) and HPC Pack 2008 R2 Client Utilities

Change History

See Also

Reference

SessionStartInfo Class
SessionStartInfo Members
Microsoft.Hpc.Scheduler.Session Namespace
SessionResourceUnitType
JobUnitType
UnitType
SessionStartInfo.MaximumUnits
SessionStartInfo.MinimumUnits

Build Date:

2012-06-21