Errors and Return Values

WS-Management operations report failure by returning WS-Management faults, as described in the WS-Management specification. The Intel AMT implementation does not perform some of the SHOULD statements in the WS-Management specification relating to faults.

The implementation returns errors relating to Intel AMT features in two ways:

   WS-Management methods corresponding to WBEM intrinsic operations (i.e. get, put, create, delete, enumerate and pull) will return a "wsman-internal-error” fault, with a detail field containing ”PT_STATUS". PT_STATUS is the Intel AMT status code.

   The WBEM extrinsic methods report failure by returning an error code and do not result in WS-Management errors. In such "invoke" methods, the return values are defined in the method description in the MOF file. In many cases, for standard CIM classes, the relevant Intel AMT return values are returned in the “Vendor Specific” range of the return value map of the method. In such a case, the return value is the beginning of the “Vendor Specific” range + the PT_STATUS value. The “Vendor Specific” range starts at 32768 in most instances. DMTF profiles restrict the use of vendor specific error value. When an error occurs in such a case that is not represented by a profile error code, Intel AMT resorts to a WS-Management error. See Intel AMT Returned Numeric Values (PT_STATUS codes) for the associated codes in hexadecimal, decimal, and the sum of the decimal code +32768.

Fault Return Example

The following example shows the structure of what may be returned as a WS-Management fault.

In the example ws-man:fault, the detail text format is “AMT-STATUS %d”

<a:Body>

    <a:Fault>

      <a:Code>

        <a:Value>a:Receiver</a:Value>

        <a:Subcode>

          <a:Value>e:InternalError</a:Value>

        </a:Subcode>

      </a:Code>

      <a:Reason>

        <a:Text xml:lang="en-US">The service cannot comply with the request due to internal processing errors.</a:Text>

      </a:Reason>

      <a:Detail>

        <a:Text xml:lang="en-US">AMT-STATUS 1</a:Text>

      </a:Detail>

    </a:Fault>

</a:Body>

 

See Also:

   Intel AMT Returned Numeric Values (PT_STATUS codes)

   Description of PT_STATUS Responses

 

Copyright © 2006-2022, Intel Corporation. All rights reserved.