Home » HP Manuals » Desktops » HP Model 755/125cL » Manual Viewer

HP Model 755/125cL HP-UX DMI 2.0 Developer's Guide: HP-UX/HP 9000 Computers, - Page 111

Error Handling and Messaging

Get HP Model 755/125cL - Workstation PDF manuals and user guides

Add to My Manuals
Save this manual to your list of manuals

Page 111 highlights

11 Error Handling and Messaging The following table contains DMI non-error messages. Table 11-1 DMI Non-Error Messages SYMBOL DMI_NO_ERROR DMI_NO_ERROR_MORE_ VALUE 0x00000 0x00001 DATA DMI_DEFAULT_LANGUAGE-R 0x00002 ETURNED DESCRIPTION Success More data is available The item requested did not have a language mapping installed that matched the one requested. The value was returned using the default language The following table contains DMI error messages. Table 11-2 DMI Error Messages SYMBOL DMIERR_OVERLAY_NOT_ FOUND VALUE 0x00001 DMIERR_ATTRIBUTE_NOT_ FOUND DMIERR_VALUE_EXCEEDS_ MAXSIZE DMIERR_COMPONENT_NOT_ FOUND DMIERR_ENUM_ERROR DMIERR_GROUP_NOT_ 0x00100 0x00101 0x00102 0x00103 0x00104 FOUND DMIERR_ILLEGAL_KEYS DMIERR_ILLEGAL_TO_SET DMIERR_OVERLAY_NAME_ 0x00105 0x00106 0x00107 NOT_FOUND DMIERR_ILLEGAL_TO_GET DMIERR_ROW_NOT_FOUND DMIERR_DIRECT_INTERFACE_ NOT_REGISTERED DMIERR_DATABASE_ 0x00108 0x0010a 0x0010b 0x0010c CORRUPT DESCRIPTION Unable to retrieve the overlay path name or statement from the database Attribute not found Value exceeds maximum size Component ID is not found Enumeration error Group not found Illegal keys Illegal to set Component instrumentation not found Illegal to get Row not found Direct interface not registered MIF database is corrupt 111

Section	Page
1 Introduction	13
Terminology	13
Component Interface API	13
Component	13
Component Instrumentation (CI)	13
Direct Interface	14
Desktop Management Interface (DMI)	14
Distributed Management Task Force (DMTF)	14
Indication Server	14
Management Interface API	14
Management Interface Client	14
Management Interface Server	14
Management Interface Format (MIF)	15
MIF Database	15
MIF File	15
Overlay Component	15
Row	16
Scalar Group	16
Service Provider (SP)	16
Table Group	16
Overview of the Desktop Management Interface	17
Installing DMI	19
2 SDK Tools	21
The MIF Browser	22
QueryDB	23
DMI Log Viewer	24
3 Component Interface Concepts	25
Static vs. Dynamic Data	26
Direct Interface vs. Overlay Instrumentation	28
Direct-Interface Instrumentation	28
Debugging Direct-Interface Instrumentation	28
Overlay Instrumentation	28
Group-Level Security	30
Modifying Groups to Use Security Tokens	30
Security Token Handling	31
4 Writing Component MIF Files	33
Management Information Format (MIF) Files	33
Example MIF	35
5 Component Interface Data Structures	37
DmiAccessData	38
DmiAccessDataList	39
DmiRegisterInfo	40
6 Component Interface Functions	41
Service Provider Functions for Components	42
DmiMainLoop()	42
DmiOriginateEvent()	42
DmiRegisterCi()	43
DmiUnregisterCi()	43
Component Provider Functions	44
CiGetAttribute()	44
CiGetNextAttribute()	45
CiReleaseAttribute()	45
CiReserveAttribute()	45
CiSetAttribute()	45
CiAddRow()	46
CiDeleteRow()	46
Optional Component Interface Support Functions	47
validateToken()	47
7 Management Interface Concepts	49
DCE/RPC Remotability	50
MI Security	51
Group-Level Security	51
Machine List Protection	52
User Name Check on HP-UX Clients	52
8 Management Interface Data Structures	53
DMI Data Types	54
DMI Enumerated Types	55
DmiAccessMode	55
DmiDataType	56
DmiFileType	57
DmiRequestMode	58
DmiSetMode	58
DmiStorageType	58
DMI Data Structures	59
DmiAttributeData	59
DmiAttributeIds	60
DmiAttributeInfo	61
DmiAttributeList	62
DmiAttributeValues	62
DmiClassNameInfo	62
DmiClassNameList	63
DmiComponentInfo	64
DmiComponentList	65
DmiDataUnion	65
DmiEnumInfo	65
DmiEnumList	66
DmiFileDataInfo	66
DmiFileDataList	66
DmiFileTypeList	67
DmiGroupInfo	68
DmiGroupList	69
DmiMultiRowData	69
DmiMultiRowRequest	69
DmiNodeAddress	70
DmiOctetString	70
DmiRowData	71
DmiRowRequest	72
DmiString	73
DmiStringList	73
DmiTimestamp	74
9 Management Interface Functions	75
Service Provider Functions for Management Applications	76
Initialization Functions	76
DmiGetConfig()	76
DmiGetVersion()	76
DmiMainLoop()	76
DmiRegister()	76
DmiRemoteRegister()	76
DmiRemoteUnregister()	77
DmiSetConfig()	77
DmiUnregister()	77
Listing Functions	77
DmiListAttributes()	77
DmiListClassNames()	77
DmiListComponents()	78
DmiListComponentsByClass()	78
DmiListGroups()	78
DmiListLanguages()	78
Operation Functions	79
DmiAddRow()	79
DmiDeleteRow()	79
DmiGetAttribute()	79
DmiGetMultiple()	79
DmiSetAttribute()	79
DmiSetMultiple()	80
Database Administration Functions	80
DmiAddComponent()	80
DmiAddGroup()	80
DmiAddLanguage()	80
DmiDeleteComponent()	80
DmiDeleteGroup()	81
DmiDeleteLanguage()	81
Management Application Provider Functions	82
Indication Functions	82
DmiComponentAdded()	82
DmiComponentDeleted()	82
DmiDeliverEvent()	82
DmiGroupAdded()	83
DmiGroupDeleted()	83
DmiLanguageAdded()	83
DmiLanguageDeleted()	83
DmiSubscriptionNotice()	83
Optional Management Interface Support Functions (Memory Handling, Security and Message Logging)	85
Memory Handling and Security Functions	85
DmiAlloc()	85
DmiCopyAttributeData()	85
DmiCopyAttributeIds()	85
DmiCopyAttributeList()	85
DmiCopyAttributeValues()	85
DmiCopyClassNameInfo()	86
DmiCopyClassNameList()	86
DmiCopyComponentInfo()	86
DmiCopyComponentList()	86
DmiCopyDataUnion()	86
DmiCopyEnumInfo()	86
DmiCopyEnumList()	87
DmiCopyFileDataInfo()	87
DmiCopyFileDataList()	87
DmiCopyFileTypeList()	87
DmiCopyGroupInfo()	87
DmiCopyGroupList()	87
DmiCopyMultiRowData()	87
DmiCopyMultiRowRequest()	88
DmiCopyNodeAddress()	88
DmiCopyOctetString()	88
DmiCopyRowData()	88
DmiCopyRowRequest()	88
DmiCopyString()	88
DmiCopyStringList()	89
DmiCopyTimestamp()	89
DmiCopyUnicodeString()	89
DmiDupAttributeData()	89
DmiDupAttributeIds()	89
DmiDupAttributeInfo()	89
DmiDupAttributeList()	90
DmiDupAttributeValues()	90
DmiDupClassNameInfo()	90
DmiDupClassNameList()	90
DmiDupComponentInfo()	90
DmiDupComponentList()	90
DmiDupDataUnion()	91
DmiDupEnumInfo()	91
DmiDupEnumList()	91
DmiDupFileDataInfo()	91
DmiDupFileDataList()	91
DmiDupFileTypeList()	91
DmiDupGroupInfo()	91
DmiDupGroupList()	92
DmiDupMultiRowData()	92
DmiDupMultiRowRequest()	92
DmiDupNodeAddress()	92
DmiDupOctetString()	92
DmiDupRowData()	92
DmiDupRowRequest()	93
DmiDupString()	93
DmiDupStringList()	93
DmiDupTimestamp()	93
DmiDupUnicodeString()	93
DmiFree()	93
DmiFreeAttributeData()	94
DmiFreeAttributeIds()	94
DMIFreeAttributeInfo()	94
DmiFreeAttributeList()	94
DmiFreeAttributeValues()	94
DmiFreeClassNameList()	94
DmiFreeComponentList()	94
DmiFreeClassNameInfo()	95
DmiFreeComponentInfo()	95
DmiFreeDataUnion()	95
DmiFreeEnumInfo()	95
DmiFreeEnumList()	95
DmiFreeFileDataInfo()	95
DmiFreeFileDataList()	95
DmiFreeFileTypeList()	96
DmiFreeGroupInfo()	96
DmiFreeGroupList()	96
DmiFreeMultiRowRequest()	96
DmiFreeMultiRowData()	96
DmiFreeNodeAddress()	96
DmiFreeOctetString()	96
DmiFreeRowData()	97
DmiFreeRowRequest()	97
DmiFreeString()	97
DmiFreeStringList()	97
DmiFreeTimestamp()	97
DmiFreeUnicodeString()	97
DmiGetSubscriptionAddress()	97
DmiIndicationListen()	98
DmiListRpcTypes()	98
DmiListTransportTypes()	98
DmiNewAttributeData()	98
DmiNewAttributeIds()	98
DmiNewAttributeInfo()	98
DmiNewAttributeList()	98
DmiNewAttributeValues()	99
DmiNewClassNameInfo()	99
DmiNewClassNameList()	99
DmiNewComponentInfo()	99
DmiNewComponentList()	99
DmiNewDataUnion()	99
DmiNewEnumInfo()	99
DmiNewEnumList()	100
DmiNewFileDataInfo()	100
DmiNewFileDataList()	100
DmiNewFileTypeList	100
DmiNewGroupInfo()	100
DmiNewGroupList()	100
DmiNewMultiRowData()	100
DmiNewMultiRowRequest()	101
DmiNewNodeAddress()	101
DmiNewOctetString()	101
DmiNewRowData()	101
DmiNewRowRequest()	101
DmiNewString()	101
DmiNewStringList()	102
DmiNewTimestamp()	102
DmiNewUnicodeString()	102
DmiSetDefaultNode()	102
DmiSetIndicationCallbacks()	102
DmiStopIndicationListening()	102
generateToken()	103
dmiLogMessage()	103
10 Events and Indications	105
About DMI 2.0 Events and Indications	105
Event Indications	105
DmiComponentAdded()	105
DmiComponentDeleted()	105
DmiDeliverEvent()	105
DmiGroupAdded()	106
DmiGroupDeleted()	106
DmiLanguageAdded()	106
DmiLanguageDeleted()	106
DmiSubscriptionNotice()	107
Monitoring Events	108
Registering With a Host's SP	108
Creating a DCE/RPC Endpoint	108
Adding Rows to the SP Tables	108
Procedural Entry Points	110
11 Error Handling and Messaging	111
A An HP-UX DMI 2.0 Example Code	115
The Example Management Application	116
The Example Component	117
Compiling the Example	119
Running the Example	120
B Component Interface Skeleton	121
Directory	121
/usr/dmi/examples/ci/skeleton	121
Files	121
/var/dmi/mif/C/ci_skeleton.mif	121
/usr/dmi/examples/ci/skeletonCode/Makefile	121
/usr/dmi/examples/ci/skeletonCode/ci_skeletonMain.h	121
/usr/dmi/examples/ci/skeletonCode/ci_skeletonCallbac ks.h	121
/usr/dmi/examples/ci/skeletonCode/ci_skeletonCallbac ks.c	122
/usr/dmi/examples/ci/skeletonCode/ci_skeletonSpecifi c.c	122
/usr/dmi/examples/ci/skeletonCode/ci_skeletonMain.c	122
C HP-UX Systems MIF Groups Quick Reference	123
Component Information Groups	124
System Information Groups	125
Logical Volume Manager Groups	127
Network Configuration Groups	128
D HP-UX Software MIF Groups Quick Reference	129
General Groups	130
Bundle Groups	131
Product and Subproduct Groups	132
Fileset Groups	133