# Diagnostic Classes

## Diagnostic Test Schema Diagram

## IANet_DiagTest

### Purpose

IANet_DiagTest is subclassed from CIM_DiagnosticTest. The class provides a generic vehicle to run and control Diagnostic tests for an Intel PROSet for Windows Device Manager supported Ethernet adapter. The superclass, CIM_DiagnosticTest, is designed to generically support the testing of any computer hardware on a CIM enabled system. Properties of the class are descriptive in nature and the mechanics of the testing are provided by the exposed methods.

### Instances

Key is Name and in this provider it is the concatenation of a numeric index of the test @ the GUID of the referenced adapter (e.g. 1@{12345678-9ABC-DEF0-1234-123456789012}). This key value is, in one sense, redundant information, as all information to reference an adapter and test is passed as object parameters to the RunTest and other methods. Still, the instance must be consistent with parameters to the method or the provider will reject the command. Other properties provide other description and run time information.

### Creating Instances

The user cannot create instances of IANet_DiagTest.

### Deleting Instances

The user cannot delete instances of IANet_DiagTest.

### Modifying Properties

There are no user-modifiable properties for this class.

### Local Properties

This class implements the following local properties:

- Grouped : indicates whether the test are grouped under a specific category
- GroupID : the identification number of the group of which this test belongs
- TestID : the specific test identification number

### Associations

- An instance of IANet_DiagTestForMSE associates an IANet_DiagTest with an IANet_PhysicalEthernetAdapter.
- An instance of IANet_DiagResultForTest associates an IANet_DiagTest with an IANet_DiagResult instance.
- An instance of IANetDiagSettingForTest associates an IANet_DiagTest with an IANet_DiagSetting.

### Unsupported Properties

Caption, Description, InstallDate, OtherCharacteristicDescription

### Methods

This class supports the following methods:

RunTest | Runs a test as defined by three parameters referencing: SystemElement - defines the adapter, which we are to run the test on by referring to an instance of SystemElement, which will always be the subclass IANet_EthernetAdapter. Setting - defines the test to be run, and the manner in which it is run by referring to an instance of CIM_DiagnosticSetting, which will always be the subclass IANet_DiagSetting. Result - defines an instance of the class CIM_DiagnosticResult, which will always be the class IANet_DiagResult.
DiscontinueTest | Attempts to stop a diagnostic test in progress as defined by two parameters referencing SystemElement and Result. These parameters function the same as RunTest. A third parameter TestingStopped returns a BOOLEAN value, which indicates if the command was successful in stopping the test.
ClearResults | Clears test results using parameters: SystemElement ResultsNotCleared The referenced parameter ManagedSystemElement, combined with this object’s object path combine to reference instances of DiagnosticResultForMSE, which will be deleted. Also, all references of DiagnosticResult objects referenced by DiagnosticResultForMSE will be deleted. Also, all instances of DiagnosticResultForTest, which refer to the deleted DiagnosticResult objects, will be deleted. Finally, the string array Output parameter ResultsNotCleared will list the keys of the DiagnosticResults, which could not be cleared.

## IANet_DiagSetting

### Purpose

Instances of IANet_DiagSetting provide specific run time diagnostic test directives. Directives used are in common to all tests and are bound to the superclass CIM_DiagnosticSetting. These include properties such as ReportSoftErrors and HaltOnError. There are no additional properties added to the subclass IANet_DiagSetting.

### Creating Instances

The user cannot create instances of this class.

### Deleting Instances

The user cannot delete instances of this class.

### Modifying properties

UpdateInstanceAsync is implemented and can be used to set test parameters to “Halt On Error”, “Report Soft Errors”, “Report Status Messages”, “Quick Mode”, “Test Warning Level” and “Percent Of Test Coverage”.

### Associations

An instance of IANetDiagSettingForTest associates an IANet_DiagTest with an IANet_DiagSetting.

### Unsupported Properties

The following properties are not supported by NCS2:

Caption, Description

### Methods

None

## IANet_DiagResult

### Purpose

Instances of IANet_DiagResult display result data for a particular test run on a particular Adapter. Instances of this class correspond identically to instances of IANet_DiagTest and IANet_DiagSetting.

### Instances

Instances of IANet_DiagResult correspond to results of a particular test run on a specific adapter. The format for the key is the same as IANet_DiagTest and IANet_DiagSetting. The instance is able to store any arbitrary test results as any data, which does not fit the defined properties, can be placed into the TestResults Array property. Any time a new test is run on an adapter, the new instance overwrites the existing instance of test results corresponding to that adapter and test combination.

### Creating Instances

The user cannot create instances of this class

### Deleting Instances

The user cannot delete instances of this class

### Modifying Properties

The user cannot modify instances of this class

### Local Properties

This class implements the following local properties:

- TestResultIds : indicates the result string ID’s
- TestResultsAttr : the type of the result string

### Associations

- An instance of IANet_DiagResultForTest associates an IANet_DiagTest with an IANet_DiagResult instance.
- An instance of IANet_DiagResultForMSE associates an IANet_PhysicalEthernetAdapter with an IANet_DiagResult instance.

### Unsupported Properties

The following properties are not supported by NCS2:

EstimatedTimeOfPerforming, OtherStateDescription.

### Methods

None

Home

Copyright© 2004 Intel Corporation. Legal Information