英文目次

1 Document Introduction
1.1 Document Purpose
1.2 AIS Documents Organization
1.3 History
1.4 References
1.5 How to Provide Feedback on the Specification
1.6 How to Join the Service Availability. Forum
1.7 Additional Information
1.7.1 Member Companies
1.7.2 Press Materials
2 Overview
2.1 Users of the Notification Library
2.1.1 Producer
2.1.2 Consumer
2.1.2.1 Subscriber
2.1.2.2 Reader
2.2 SNMP Interface
2.3 CIM/WBEM Interface
2.4 Notification Service
2.4.1 Notification Library
2.4.2 Notification Server
2.4.3 Transport Service
2.5 Logging Service
3 Notification Service API
3.1 Notifications
3.2 Notification Filters
3.3 Notification Types
3.3.1 Alarm Notification
3.3.2 State Change Notification
3.3.3 Object Create / Delete and Attribute Change Notifications
3.3.4 Security Alarm Notification
3.4 Common Parameters
3.4.1 Event Type
3.4.2 Notification Object
3.4.3 Notifying Object
3.4.4 Notification Class Identifier
3.4.5 Notification Identifier
3.4.6 Correlated Notifications
3.4.7 Event Time
3.4.8 Additional Text
3.4.9 Additional Information
3.5 Notification-specific Parameters
3.5.1 Alarm
3.5.1.1 Probable Cause
3.5.1.2 Specific Problems
3.5.1.3 Perceived Severity
3.5.1.4 Trend Indication
3.5.1.5 Threshold Information
3.5.1.6 Monitored Attributes
3.5.1.7 Proposed Repair Actions
3.5.2 State Change
3.5.2.1 Source Indicator
3.5.2.2 Changed State Attribute List
3.5.3 Object Creation/Deletion
3.5.3.1 Source Indicator
3.5.3.2 Attribute List
3.5.4 Attribute Value Change
3.5.4.1 Source Indicator
3.5.4.2 Changed Attribute List
3.5.5 Security Alarm
3.5.5.1 Security Alarm Cause
3.5.5.2 Security Alarm Severity
3.5.5.3 Security Alarm Detector
3.5.5.4 Service User
3.5.5.5 Service Provider
3.6 Notification Delivery Characteristics
3.6.1 Discarded Notifications
3.7 Integration of HPI Events
3.8 Semantic Identification of Notification Elements
3.9 Internationalization Issues
3.10 API Design Goals
3.11 Include File and Library Name
3.12 Type Definitions
3.12.1 Handles
3.12.1.1 SaNtfHandleT
3.12.1.2 SaNtfNotificationHandleT
3.12.1.3 SaNtfNotificationFilterHandleT
3.12.1.4 SaNtfReadHandleT
3.12.2 Callbacks
3.12.2.1 SaNtfCallbacksT
3.12.3 SaNtfNotificationTypeT
3.12.4 SaNtfEventTypeT
3.12.5 Notification Object
3.12.6 Notifying Object
3.12.7 SaNtfClassIdT
3.12.8 SaServicesT
3.12.9 SaNtfElementIdT
3.12.10 SaNtfIdentifierT
3.12.11 Event Time
3.12.12 SaNtfValueTypeT
3.12.13 SaNtfValueT
3.12.14 Additional Text
3.12.15 SaNtfAdditionalInfoT
3.12.16 SaNtfProbableCauseT
3.12.17 SaNtfSpecificProblemT
3.12.18 SaNtfSeverityT
3.12.19 SaNtfSeverityTrendT
3.12.20 SaNtfThresholdInformationT
3.12.21 SaNtfProposedRepairActionT
3.12.22 SaNtfSourceIndicatorT
3.12.23 SaNtfStateChangeT
3.12.24 SaNtfAttributeT
3.12.25 SaNtfAttributeChangeT
3.12.26 SaNtfServiceUserT
3.12.27 SaNtfSecurityAlarmDetectorT
3.12.28 SaNtfNotificationHeaderT
3.12.29 SaNtfObjectCreateDeleteNotificationT
3.12.30 SaNtfAttributeChangeNotificationT
3.12.31 SaNtfStateChangeNotificationT
3.12.32 SaNtfAlarmNotificationT
3.12.33 SaNtfSecurityAlarmNotificationT
3.12.34 Default variable notification data size
3.12.35 SaNtfSubscriptionIdT
3.12.36 SaNtfNotificationFilterHeaderT
3.12.37 SaNtfObjectCreateDeleteNotificationFilterT
3.12.38 SaNtfAttributeChangeNotificationFilterT
3.12.39 SaNtfStateChangeNotificationFilterT
3.12.40 SaNtfAlarmNotificationFilterT
3.12.41 SaNtfSecurityAlarmNotificationFilterT
3.12.42 SaNtfSearchModeT
3.12.43 SaNtfSearchCriteriaT
3.12.44 SaNtfSearchDirectionT
3.12.45 SaNtfNotificationTypeFilterHandlesT
3.12.46 SaNtfNotificationsT
3.13 Library Life Cycle
3.13.1 saNtfInitialize()
3.13.2 saNtfSelectionObjectGet()
3.13.3 saNtfDispatch()
3.13.4 saNtfFinalize()
3.14 Operations of the Producer API
3.14.1 saNtfObjectCreateDeleteNotificationAllocate()
3.14.2 saNtfAttributeChangeNotificationAllocate()
3.14.3 saNtfStateChangeNotificationAllocate()
3.14.4 saNtfAlarmNotificationAllocate()
3.14.5 saNtfSecurityAlarmNotificationAllocate()
3.14.6 saNtfPtrValAllocate()
3.14.7 saNtfArrayValAllocate()
3.14.8 saNtfNotificationSend()
3.14.9 saNtfNotificationFree()
3.15 Consumer Operations
3.15.1 Filtering
3.15.2 Common Consumer Operations
3.15.2.1 saNtfLocalizedMessageGet()
3.15.2.2 saNtfLocalizedMessageFree()
3.15.2.3 saNtfPtrValGet()
3.15.2.4 saNtfArrayValGet()
3.15.2.5 saNtfObjectCreateDeleteNotificationFilterAllocate()
3.15.2.6 saNtfAttributeChangeNotificationFilterAllocate()
3.15.2.7 saNtfStateChangeNotificationFilterAllocate()
3.15.2.8 saNtfAlarmNotificationFilterAllocate()
3.15.2.9 saNtfSecurityAlarmNotificationFilterAllocate()
3.15.2.10 saNtfNotificationFilterFree()
3.15.3 Operations of the Subscriber API
3.15.3.1 saNtfNotificationSubscribe()
3.15.3.2 saNtfNotificationUnsubscribe()
3.15.3.3 SaNtfNotificationCallbackT
3.15.3.4 SaNtfNotificationDiscardedCallbackT
3.15.4 Operations of the Reader API
3.15.4.1 saNtfNotificationReadInitialize()
3.15.4.2 saNtfNotificationReadNext()
3.15.4.3 saNtfNotificationReadFinalize()
3.16 Notification Suppression
4 Configuration
4.1 Trap OID Mapping
4.2 Internationalization
Appendix A API Usage Examples
Producer Side (example function) �� Object Create Delete Notification
Producer Side (example function) �� Attribute Change Notification
Producer Side (example function) �� State Change Notification
Producer Side (example function) �� Alarm Notification
Producer Side (example function) �� Security Alarm Notification
Consumer Side (example function) �� Subscribe for Notifications
Consumer Side (example function) �� Read Logged Notifications

和文目次

1 イントロダクション
1.1 本書の目的
1.2 AISドキュメント構成
1.3 ヒストリー
1.4 リファレンス
1.5 仕様にフィードバックするには？
1.6 サービスアベイラビリティフォーラムに参加するには？
1.7 追加情報
1.7.1 メンバ企業
1.7.2 プレス資料
2 概要
2.1 通知ライブラリのユーザー
2.1.1 プロデューサー
2.1.2 コンシューマー
2.1.2.1 参加者
2.1.2.2 リーダー
2.2 SNMPインターフェース
2.3 CIM/WBEM インターフェース
2.4 通知サービス
2.4.1 通知ライブラリ
2.4.2 通知サーバー
2.4.3 転送サービス
2.5 ロギングサービス
3 通知サービスAPI
3.1 通知
3.2 通知フィルター
3.3 通知タイプ
3.3.1 アラーム通知
3.3.2 状態変更通知
3.3.3 オブジェクト生成/削除と属性変更通知
3.3.4 セキュリティーアラーム通知
3.4 共通パラメーター
3.4.1 イベントタイプ
3.4.2 通知オブジェクト
3.4.3 通知オブジェクト
3.4.4 通知クラス識別子
3.4.5 通知識別子
3.4.6 相互通知
3.4.7 イベント時間
3.4.8 追加テキスト
3.4.9 追加情報
3.5 通知指定パラメーター
3.5.1 アラーム
3.5.1.1 推定原因
3.5.1.2 問題特定
3.5.1.3 重度
3.5.1.4 傾向指標
3.5.1.5 スレッシュホールド情報
3.5.1.6 監視属性
3.5.1.7 修復アクション候補
3.5.2 状態変更
3.5.2.1 ソース指示子
3.5.2.2 変更状態属性リスト
3.5.3 オブジェクト生成/削除
3.5.3.1 ソース指示子
3.5.3.2 属性リスト
3.5.4 属性値変更
3.5.4.1 ソース指示子
3.5.4.2 変更属性リスト
3.5.5 セキュリティーアラーム
3.5.5.1 セキュリティーアラーム原因
3.5.5.2 セキュリティーアラーム重度
3.5.5.3 セキュリティーアラーム検出者
3.5.5.4 サービスユーザー
3.5.5.5 サービス提供者
3.6 通知配布の特徴
3.6.1 通知の破棄
3.7 HPIイベントのインテグレーション
3.8 通知要素のセマンティクス指標
3.9 国際化
3.10 APIデザインのゴール
3.11 インクルードファイルとライブラリ名
3.12 型定義
3.12.1 ハンドル
3.12.1.1 SaNtfHandleT
3.12.1.2 SaNtfNotificationHandleT
3.12.1.3 SaNtfNotificationFilterHandleT
3.12.1.4 SaNtfReadHandleT
3.12.2 コールバック
3.12.2.1 SaNtfCallbacksT
3.12.3 SaNtfNotificationTypeT
3.12.4 SaNtfEventTypeT
3.12.5 通知オブジェクト
3.12.6 通知オブジェクト
3.12.7 SaNtfClassIdT
3.12.8 SaServicesT
3.12.9 SaNtfElementIdT
3.12.10 SaNtfIdentifierT
3.12.11 イベント時間
3.12.12 SaNtfValueTypeT
3.12.13 SaNtfValueT
3.12.14 追加テキスト
3.12.15 SaNtfAdditionalInfoT
3.12.16 SaNtfProbableCauseT
3.12.17 SaNtfSpecificProblemT
3.12.18 SaNtfSeverityT
3.12.19 SaNtfSeverityTrendT
3.12.20 SaNtfThresholdInformationT
3.12.21 SaNtfProposedRepairActionT
3.12.22 SaNtfSourceIndicatorT
3.12.23 SaNtfStateChangeT
3.12.24 SaNtfAttributeT
3.12.25 SaNtfAttributeChangeT
3.12.26 SaNtfServiceUserT
3.12.27 SaNtfSecurityAlarmDetectorT
3.12.28 SaNtfNotificationHeaderT
3.12.29 SaNtfObjectCreateDeleteNotificationT
3.12.30 SaNtfAttributeChangeNotificationT
3.12.31 SaNtfStateChangeNotificationT
3.12.32 SaNtfAlarmNotificationT
3.12.33 SaNtfSecurityAlarmNotificationT
3.12.34 デフォルトの可変通知データサイズ
3.12.35 SaNtfSubscriptionIdT
3.12.36 SaNtfNotificationFilterHeaderT
3.12.37 SaNtfObjectCreateDeleteNotificationFilterT
3.12.38 SaNtfAttributeChangeNotificationFilterT
3.12.39 SaNtfStateChangeNotificationFilterT
3.12.40 SaNtfAlarmNotificationFilterT
3.12.41 SaNtfSecurityAlarmNotificationFilterT
3.12.42 SaNtfSearchModeT
3.12.43 SaNtfSearchCriteriaT
3.12.44 SaNtfSearchDirectionT
3.12.45 SaNtfNotificationTypeFilterHandlesT
3.12.46 SaNtfNotificationsT
3.13 ライブラリライフサイクル
3.13.1 saNtfInitialize()
3.13.2 saNtfSelectionObjectGet()
3.13.3 saNtfDispatch()
3.13.4 saNtfFinalize()
3.14 生成APIの操作
3.14.1 saNtfObjectCreateDeleteNotificationAllocate()
3.14.2 saNtfAttributeChangeNotificationAllocate()
3.14.3 saNtfStateChangeNotificationAllocate()
3.14.4 saNtfAlarmNotificationAllocate()
3.14.5 saNtfSecurityAlarmNotificationAllocate()
3.14.6 saNtfPtrValAllocate()
3.14.7 saNtfArrayValAllocate()
3.14.8 saNtfNotificationSend()
3.14.9 saNtfNotificationFree()
3.15 コンシューマーの操作
3.15.1 フィルタリング
3.15.2 共通のコンシューマーの操作
3.15.2.1 saNtfLocalizedMessageGet()
3.15.2.2 saNtfLocalizedMessageFree()
3.15.2.3 saNtfPtrValGet()
3.15.2.4 saNtfArrayValGet()
3.15.2.5 saNtfObjectCreateDeleteNotificationFilterAllocate()
3.15.2.6 saNtfAttributeChangeNotificationFilterAllocate()
3.15.2.7 saNtfStateChangeNotificationFilterAllocate()
3.15.2.8 saNtfAlarmNotificationFilterAllocate()
3.15.2.9 saNtfSecurityAlarmNotificationFilterAllocate()
3.15.2.10 saNtfNotificationFilterFree()
3.15.3 参加者APIの操作
3.15.3.1 saNtfNotificationSubscribe()
3.15.3.2 saNtfNotificationUnsubscribe()
3.15.3.3 SaNtfNotificationCallbackT
3.15.3.4 SaNtfNotificationDiscardedCallbackT
3.15.4 リーダーAPIの操作
3.15.4.1 saNtfNotificationReadInitialize()
3.15.4.2 saNtfNotificationReadNext()
3.15.4.3 saNtfNotificationReadFinalize()
3.16 通知の抑制
4 構成
4.1 トラップ OID マッピング
4.2 国際化
Appendix A APIの使用例
Producer Side (example function) �� Object Create Delete Notification
Producer Side (example function) �� Attribute Change Notification
Producer Side (example function) �� State Change Notification
Producer Side (example function) �� Alarm Notification
Producer Side (example function) �� Security Alarm Notification
Consumer Side (example function) �� Subscribe for Notifications
Consumer Side (example function) �� Read Logged Notifications

本文

1 イントロダクション

1.1 本書の目的

1.2 AISドキュメント構成

1.3 ヒストリー

1.4 リファレンス

1.5 仕様にフィードバックするには？

1.6 サービスアベイラビリティフォーラムに参加するには？

1.7 追加情報

1.7.1 メンバ企業

1.7.2 プレス資料

2 概要

2.1 通知ライブラリのユーザー

2.1.1 プロデューサー

2.1.2 コンシューマー

2.1.2.1 参加者

2.1.2.2 リーダー

2.2 SNMPインターフェース

2.3 CIM/WBEM インターフェース

2.4 通知サービス

2.4.1 通知ライブラリ

2.4.2 通知サーバー

2.4.3 転送サービス

2.5 ロギングサービス

3 通知サービスAPI

3.1 通知

3.2 通知フィルター

3.3 通知タイプ

3.3.1 アラーム通知

3.3.2 状態変更通知

3.3.3 オブジェクト生成/削除と属性変更通知

3.3.4 セキュリティーアラーム通知

3.4 共通パラメーター

3.4.1 イベントタイプ

3.4.2 通知オブジェクト

3.4.3 通知オブジェクト

3.4.4 通知クラス識別子

3.4.5 通知識別子

3.4.6 相互通知

3.4.7 イベント時間

3.4.8 追加テキスト

3.4.9 追加情報

3.5 通知指定パラメーター

3.5.1 アラーム

3.5.1.1 推定原因

3.5.1.2 問題特定

3.5.1.3 重度

3.5.1.4 傾向指標

3.5.1.5 スレッシュホールド情報

3.5.1.6 監視属性

3.5.1.7 修復アクション候補

3.5.2 状態変更

3.5.2.1 ソース指示子

3.5.2.2 変更状態属性リスト

3.5.3 オブジェクト生成/削除

3.5.3.1 ソース指示子

3.5.3.2 属性リスト

3.5.4 属性値変更

3.5.4.1 ソース指示子

3.5.4.2 変更属性リスト

3.5.5 セキュリティーアラーム

3.5.5.1 セキュリティーアラーム原因

3.5.5.2 セキュリティーアラーム重度

3.5.5.3 セキュリティーアラーム検出者

3.5.5.4 サービスユーザー

3.5.5.5 サービス提供者

3.6 通知配布の特徴

3.6.1 通知の破棄

3.7 HPIイベントのインテグレーション

3.8 通知要素のセマンティクス指標

3.9 国際化

3.10 APIデザインのゴール

3.11 インクルードファイルとライブラリ名

3.12 型定義

3.12.1 ハンドル

3.12.1.1 SaNtfHandleT

3.12.1.2 SaNtfNotificationHandleT

3.12.1.3 SaNtfNotificationFilterHandleT

3.12.1.4 SaNtfReadHandleT

3.12.2 コールバック

3.12.2.1 SaNtfCallbacksT

3.12.3 SaNtfNotificationTypeT

3.12.4 SaNtfEventTypeT

3.12.5 通知オブジェクト

3.12.6 通知オブジェクト

3.12.7 SaNtfClassIdT

3.12.8 SaServicesT

3.12.9 SaNtfElementIdT

3.12.10 SaNtfIdentifierT

3.12.11 イベント時間

3.12.12 SaNtfValueTypeT

3.12.13 SaNtfValueT

3.12.14 追加テキスト

3.12.15 SaNtfAdditionalInfoT

3.12.16 SaNtfProbableCauseT

3.12.17 SaNtfSpecificProblemT

3.12.18 SaNtfSeverityT

3.12.19 SaNtfSeverityTrendT

3.12.20 SaNtfThresholdInformationT

3.12.21 SaNtfProposedRepairActionT

3.12.22 SaNtfSourceIndicatorT

3.12.23 SaNtfStateChangeT

3.12.24 SaNtfAttributeT

3.12.25 SaNtfAttributeChangeT

3.12.26 SaNtfServiceUserT

3.12.27 SaNtfSecurityAlarmDetectorT

3.12.28 SaNtfNotificationHeaderT

3.12.29 SaNtfObjectCreateDeleteNotificationT

3.12.30 SaNtfAttributeChangeNotificationT

3.12.31 SaNtfStateChangeNotificationT

3.12.32 SaNtfAlarmNotificationT

3.12.33 SaNtfSecurityAlarmNotificationT

3.12.34 デフォルトの可変通知データサイズ

3.12.35 SaNtfSubscriptionIdT

3.12.36 SaNtfNotificationFilterHeaderT

3.12.37 SaNtfObjectCreateDeleteNotificationFilterT

3.12.38 SaNtfAttributeChangeNotificationFilterT

3.12.39 SaNtfStateChangeNotificationFilterT

3.12.40 SaNtfAlarmNotificationFilterT

3.12.41 SaNtfSecurityAlarmNotificationFilterT

3.12.42 SaNtfSearchModeT

3.12.43 SaNtfSearchCriteriaT

3.12.44 SaNtfSearchDirectionT

3.12.45 SaNtfNotificationTypeFilterHandlesT

3.12.46 SaNtfNotificationsT

3.13 ライブラリライフサイクル

3.13.1 saNtfInitialize()

3.13.2 saNtfSelectionObjectGet()

3.13.3 saNtfDispatch()

3.13.4 saNtfFinalize()

3.14 生成APIの操作

3.14.1 saNtfObjectCreateDeleteNotificationAllocate()

3.14.2 saNtfAttributeChangeNotificationAllocate()

3.14.3 saNtfStateChangeNotificationAllocate()

3.14.4 saNtfAlarmNotificationAllocate()

3.14.5 saNtfSecurityAlarmNotificationAllocate()

3.14.6 saNtfPtrValAllocate()

3.14.7 saNtfArrayValAllocate()

3.14.8 saNtfNotificationSend()

3.14.9 saNtfNotificationFree()

3.15 コンシューマーの操作

3.15.1 フィルタリング

3.15.2 共通のコンシューマーの操作

3.15.2.1 saNtfLocalizedMessageGet()

3.15.2.2 saNtfLocalizedMessageFree()

3.15.2.3 saNtfPtrValGet()

3.15.2.4 saNtfArrayValGet()

3.15.2.5 saNtfObjectCreateDeleteNotificationFilterAllocate()

3.15.2.6 saNtfAttributeChangeNotificationFilterAllocate()

3.15.2.7 saNtfStateChangeNotificationFilterAllocate()

3.15.2.8 saNtfAlarmNotificationFilterAllocate()

3.15.2.9 saNtfSecurityAlarmNotificationFilterAllocate()

3.15.2.10 saNtfNotificationFilterFree()

3.15.3 参加者APIの操作

3.15.3.1 saNtfNotificationSubscribe()

3.15.3.2 saNtfNotificationUnsubscribe()

3.15.3.3 SaNtfNotificationCallbackT

3.15.3.4 SaNtfNotificationDiscardedCallbackT

3.15.4 リーダーAPIの操作

3.15.4.1 saNtfNotificationReadInitialize()

3.15.4.2 saNtfNotificationReadNext()

3.15.4.3 saNtfNotificationReadFinalize()

3.16 通知の抑制

4 構成

4.1 トラップ OID マッピング

4.2 国際化

Appendix A APIの使用例

Producer Side (example function) �� Object Create Delete Notification

Producer Side (example function) �� Attribute Change Notification

Producer Side (example function) �� State Change Notification

Producer Side (example function) �� Alarm Notification

Producer Side (example function) �� Security Alarm Notification

Consumer Side (example function) �� Subscribe for Notifications

Consumer Side (example function) �� Read Logged Notifications