An attribute can describe a single characteristic, a component, or a product. Attributes are key parts of a component MIF file. Attributes for groups vary according to the type of product. To view the information that is defined in the MIF database, use the following List commands:
Management applications must provide code to deal appropriately with the
status codes that the Service Layer returns. The following table lists
the error codes that the Service Layer returns. The table contains the
return code, the #define used in the VPD, and a list of probable
causes for the return code. The list of probable causes is in sequence
from most likely to occur to least likely to occur. ┌──────────────────────────────────────────────────────────────────────────────┐│Table1
.DMIReturnCodeTable │
├─────────────────────────┬────────────────────────────────────────────────────┤
│ RETURN CODE │ #define DESCRIPTION │
├─────────────────────────┴────────────────────────────────────────────────────┤
│ NON-ERROR CONDITION CODES │
├─────────────────────────┬────────────────────────────────────────────────────┤
│ 0x00000000 │ SLERR_NO_ERROR │
│ │ │
│ │ o Good return code; no errors found │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000001 │ SLERR_NO_ERROR_MORE_DATA │
│ │ │
│ │ o Good return code; no errors found, but more │
│ │ data is available │
├─────────────────────────┴────────────────────────────────────────────────────┤
│ DATABASE ERRORS │
├─────────────────────────┬────────────────────────────────────────────────────┤
│ 0x00000100 │ DBERR_ATTRIBUTE_NOT_FOUND │
│ │ │
│ │ o An invalid attribute ID was specified on the │
│ │ command being executed │
│ │ │
│ │ o An invalid component or group ID was specified │
│ │ on the command being executed │
│ │ │
│ │ o Component instrumentation has been specified, │
│ │ but it is not available │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000101 │ DBERR_VALUE_EXCEEDS_MAXSIZE │
│ │ │
│ │ o A string is too large (> 508 bytes) │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000102 │ DBERR_COMPONENT_NOT_FOUND │
│ │ │
│ │ o An invalid component ID was specified on the │
│ │ command being executed │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000103 │ DBERR_ENUM_ERROR │
│ │ │
│ │ o Specifying a value for an enumeration that is │
│ │ not defined in the component │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000104 │ DBERR_GROUP_NOT_FOUND │
│ │ │
│ │ o An invalid group ID was specified on the │
│ │ command being executed │
│ │ │
│ │ o An invalid component ID was specified on the │
│ │ command being executed │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000105 │ DBERR_ILLEGAL_KEYS │
│ │ │
│ │ o Invalid keys specified │
│ │ │
│ │ o Invalid key count specified │
│ │ │
│ │ o An invalid component or group ID was specified │
│ │ on the command being executed │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000106 │ DBERR_ILLEGAL_TO_SET │
│ │ │
│ │ o The attribute access is read only, so the │
│ │ attribute cannot be set │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000107 │ DBERR_OVERLAY_NAME_NOT_FOUND │
│ │ │
│ │ o Currently not in use │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000108 │ DBERR_ILLEGAL_TO_GET │
│ │ │
│ │ o The attribute access is write-only, so the │
│ │ attribute cannot be read │
└─────────────────────────┴────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────┐
│ Table 1. DMI Return Code Table │
├─────────────────────────┬────────────────────────────────────────────────────┤
│ RETURN CODE │ #define DESCRIPTION │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000109 │ DBERR_NO_DESCRIPTION │
│ │ │
│ │ o There is no description for the requested com- │
│ │ ponent, group, or attribute │
│ │ │
│ │ o If a component description is being requested, │
│ │ the component ID specified on the command │
│ │ could be invalid │
│ │ │
│ │ o If a group description is being requested, the │
│ │ group or component ID specified on the command │
│ │ could be invalid │
│ │ │
│ │ o If an attribute description is being │
│ │ requested, the attribute, group, or component │
│ │ ID specified on the command could be invalid │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x0000010A │ DBERR_ROW_NOT_FOUND │
│ │ │
│ │ o For the keys specified, the table row cannot │
│ │ be found │
│ │ │
│ │ o Invalid keys specified │
│ │ │
│ │ o Invalid key count specified │
│ │ │
│ │ o An invalid component or group ID was specified │
│ │ on the command being executed │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x0000010B │ DBERR_DIRECT_INTERFACE_NOT_REGISTERED │
│ │ │
│ │ o A direct interface is indicated but not regis- │
│ │ tered with the service layer │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x0000010C │ DBERR_DATABASE_CORRUPT │
│ │ │
│ │ o Currently not in use │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x0000010D │ DBERR_ATTRIBUTE_NOT_SUPPORTED │
│ │ │
│ │ o Attribute marked as not supported │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x0000010E │ DBERR_LIMITS_EXCEEDED │
│ │ │
│ │ o More than the maximum number of elements │
│ │ allowed in the database (for example, the │
│ │ current limit for components is 256) │
├─────────────────────────┴────────────────────────────────────────────────────┤
│ SERVICE LAYER ERRORS │
├─────────────────────────┬────────────────────────────────────────────────────┤
│ 0x00000200 │ SLERR_BUFFER_FULL │
│ │ │
│ │ o Response buffer is full │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000201 │ SLERR_ILL_FORMED_COMMAND
│
│ │ │
│ │ o Confirm buffer length too large │
│ │ │
│ │ o Keys for a table (group) not in order │
│ │ │
│ │ o listcomponent command with group keys but not │
│ │ a class string │
│ │ │
│ │ o An offset in the command points to beyond the │
│ │ end of the command buffer │
│ │ │
│ │ o Confirm buffer length < 512 │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000202 │ SLERR_ILLEGAL_COMMAND │
│ │ │
│ │ o Not one of the valid DMI commands │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000203 │ SLERR_ILLEGAL_HANDLE │
│ │ │
│ │ o Invalid management handle │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000204 │ SLERR_OUT_OF_MEMORY │
│ │ │
│ │ o A memory allocation failed. Check this pos- │
│ │ sible cause: │
│ │ │
│ │ - A buffer length set too large │
└─────────────────────────┴────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────┐
│ Table 1. DMI Return Code Table │
├─────────────────────────┬────────────────────────────────────────────────────┤
│ RETURN CODE │ #define DESCRIPTION │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000205 │ SLERR_NULL_COMPLETION_FUNCTION │
│ │ │
│ │ o There was no callback function specified on │
│ │ the register, and a command has been executed │
│ │ that will require a callback function │
│ │ │
│ │ o There was no callback or indication functions │
│ │ specified on the register │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000206 │ SLERR_NULL_RESPONSE_BUFFER │
│ │ │
│ │ o On a command that requires a response buffer, │
│ │ one has not been specified │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000207 │ SLERR_CMD_HANDLE_IN_USE │
│ │ │
│ │ o Currently not in use │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000208 │ SLERR_ILLEGAL_DMI_LEVEL │
│ │ │
│ │ o The iLevelCheck field on the command is not │
│ │ the same as the level of the DMI service layer │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000209 │ SLERR_UNKNOWN_CI_REGISTRY │
│ │ │
│ │ o The component instrumentation handle │
│ │ (iCiHandle) is not valid │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x0000020A │ SLERR_COMMAND_CANCELED │
│ │ │
│ │ o Currently not in use │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x0000020B │ SLERR_INSUFFICIENT_PRIVILEGES │
│ │ │
│ │ o Currently not in use │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x0000020C │ SLERR_NULL_ACCESS_FUNCTION │
│ │ │
│ │ o Entry point to the component instrumentation │
│ │ is null │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x0000020D │ SLERR_FILE_ERROR │
│ │ │
│ │ o Could not delete a component from the MIF │
│ │ database │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x0000020E │ SLERR_EXEC_FAILURE │
│ │ │
│ │ o Currently not in use │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x0000020F │ SLERR_BAD_MIF_FILE │
│ │ │
│ │ o The MIF database cannot be opened │
│ │ │
│ │ o There is an error in the MIF file that is │
│ │ being installed │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000210 │ SLERR_INVALID_FILE_TYPE │
│ │ │
│ │ o A MIF file that is being installed has an │
│ │ invalid file type │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000211 │ SLERR_SL_INACTIVE │
│ │ │
│ │ o The service layer cannot be contacted and is │
│ │ probably not running │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000212 │ SLERR_UNICODE_NOT_SUPPORTED │
│ │ │
│ │ o Currently not in use │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000213 │ SLERR_CANT_UNINSTALL_SL_COMPONENT │
│ │ │
│ │ o Currently not in use │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00000214 │ SLERR_NULL_CANCEL_FUNCTION │
│ │ │
│ │ o Entry point to the cancel function of the com- │
│ │ ponent instrumentation is null │
└─────────────────────────┴────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────┐
│ Table 1. DMI Return Code Table │
├─────────────────────────┬────────────────────────────────────────────────────┤
│ RETURN CODE │ #define DESCRIPTION │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00003000 │ SLERR_NOT_INITIALIZED │
│ │ │
│ │ o Service layer is not initialized and is not │
│ │ running │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00003001 │ SLERR_IPC_CREATE_ERROR │
│ │ │
│ │ o Could not communicate or establish communi- │
│ │ cations with the service layer │
│ │ │
│ │ o On a synchronous invoke, could not get exclu- │
│ │ sive use of the synchronous interface │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00003002 │ SLERR_THREAD_CREATE_ERROR │
│ │ │
│ │ o A thread in the service layer cannot be │
│ │ created │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00003003 │ SLERR_QUEUE_CREATE_ERROR │
│ │ │
│ │ o Cannot create the queue for the tasker │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00003004 │ SLERR_SL_TERMINATED │
│ │ │
│ │ o Currently not in use │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00003005 │ SLERR_CMD_EXCEPTION │
│ │ │
│ │ o A trap occurred in the service layer, probably │
│ │ due to an invalid command │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00003006 │ SLERR_SYNC_SETUP_ERROR │
│ │ │
│ │ o Cannot create the event semaphore used on the │
│ │ synchronous dmiinvoke call │
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00003007 │ SLERR_SL_DLL_MISMATCH │
│ │ │
│ │ o The versions of the Service Layer (SL) and the │
│ │ DMIAPI.DLL are incompatible
│
├─────────────────────────┼────────────────────────────────────────────────────┤
│ 0x00003008 │ SLERR_IPC_ERROR │
│ │ │
│ │ o Cannot set up the shared memory with the │
│ │ Service Layer │
└─────────────────────────┴────────────────────────────────────────────────────┘
The SystemView Agent Programmer's Guide on the system has details of the DmiRegisterMgmtCmd command. The Guide also describes the Get, Set, and List commands available to management applications as well as the list of status codes.