2.2.5.21 Policy Element

The Policy XML element specifies parameters for managing resource allocation. It is the root element of XML documents that are used in WSRM method parameters.

 <xs:element name="Policy">
   <xs:complexType>
     <xs:sequence>
       <xs:element name="AllocationCriteria"
         maxOccurs="unbounded"
       >
         <xs:complexType name="AllocationCriteria">
           <xs:sequence>
             <xs:element name="ProcessMatchingCriteria">
               <xs:complexType name="ProcessMatchingCriteria">
                 <xs:attribute name="RefName"
                   type="xs:string"
                   use="required"
                  />
               </xs:complexType>
             </xs:element>
             <xs:element name="Affinity"
               type="xs:string"
               minOccurs="0"
              />
             <xs:element name="CPUAllocation"
               type="xs:unsignedByte"
              />
             <xs:element name="ManagementRule"
               type="xs:string"
               minOccurs="0"
              />
             <xs:element name="MaximumWorkingSet"
               type="xs:unsignedInt"
               minOccurs="0"
              />
             <xs:element name="MaximumCommittedMemory"
               type="xs:unsignedShort"
               minOccurs="0"
              />
             <xs:element name="CommittedMemoryExceededOption"
               type="xs:string"
               minOccurs="0"
              />
           </xs:sequence>
           <xs:attribute name="Name"
             type="xs:string"
             use="required"
            />
         </xs:complexType>
       </xs:element>
       <xs:element name="Description"
         type="xs:string"
         minOccurs="0"
        />
     </xs:sequence>
     <xs:attribute name="Name"
       type="xs:string"
       use="required"
      />
   </xs:complexType>
 </xs:element>

Child Elements

Element	Type	Description
AllocationCriteria	AllocationCriteria	A specification of the allocation criteria for a policy, including the process matching criteria (PMC), resources and management regulations.
ProcessMatchingCriteria	ProcessMatchingCriteria	Specifies the name of the PMC being used.
Affinity	xs:string	The processor affinity on a multi-processor computer, in affinity format (section 2.2.1.1).
CPUAllocation	xs:unsignedByte	The percentage of CPU usage for this PMC.
ManagementRule	xs:string	The management rule for CPU allocation, expressed as a resource allocation option (section 2.2.2.8).
MaximumWorkingSet	xs:unsignedInt	The maximum amount of physical memory, in megabytes, that can be assigned to a process by the operating system.
MaximumCommittedMemory	xs:unsignedShort	An upper limit on the committed memory, in megabytes, that a process consumes. If this limit is exceeded, WSRM will take action as specified in <CommittedMemoryExceededOption>.
CommittedMemoryExceededOption	xs:string	The action that will be taken if the <MaximumCommittedMemory> limit is exceeded, expressed as a memory option (section 2.2.2.6).
Description	xs:string	A text description of the policy.

Attributes

Name	Type	Description
RefName	xs:string	The name of the PMC.
Name	xs:string	The name of the <AllocationCriteria> element.<13>
Name	xs:string	The name of the policy.

Additional XML data formats are specified in section 2.2.5.