這個主題是 Common Base Event 綱目 1.0.1 版中所定義之元素、複式類型和群組的參照。
AssociatedEvent 類型可分組相關事件, 可讓您識別相關事件及其 associationEngine。associationEngine「可能」 是建立關聯生之應用程式的參照。
這個屬性指定對應於與此事件相關之事件的 globalInstanceIds 陣列。
AssociationEngine 識別建立相關事件之間的關聯性之應用程式。 此外,AssociationEngine 提供說明關聯性類型的內容。 AssociationEngine 是 XML 綱目中的獨立式實體, 且由 AssociationEngine 識別之應用程式所建立的 AssociatedEvents 參照 AssociationEngine。 這會刪除在每個相關事件中重複相同資料的需求。
元素的主要 ID。這個內容「必須」是廣域唯一的。 此值的建議值為 128 位元或 256 位元的「廣域唯一 ID」(以十六進位字串代表)。 此值一旦設定完後,便「不可」再變更。這是「必要」的內容。
這個內容應該包含這個 AssociationEngine 所建立的關聯類型。 部分已定義好的關聯性如下: - 包含 - 已清除 - 原因 - 多組件 - 相互關聯 這是「必要」的內容。這個內容的字串長度「不可」超過 64 字元。
建立關聯的應用程式名稱(例如,我的相關性引擎名稱)。 這是「必要」的內容。這個內容的字串長度「不可」超過 64 字元。
AvailableSituation 會處理元件所報告的狀況(關於其作業狀態及可用性)。 這個狀況會識別產品是否已安裝、是否可運作以及是否準備好要處理功能要求和管理要求, 藉以提供可在元件上執行之作業的環境定義。 現有的訊息包含現在已準備好處理要求、線上及離線等文字,例如: ADMC0013I: 埠 8880 可以使用 SOAP 連接器 ADMC0026I: 埠 2809 可以使用 RMI 連接器
這個內容指定狀況所報告之元件的作業狀態。operationalDisposition 是具有下列一組值的字串: - STARTABLE - NONSTARTABLE 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
這個內容指定導致要報告狀況之實體或元件的可用性處置。 availabilityDisposition 是具有下列一組值的字串: - AVAILABLE - NOT AVAILABLE 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
這個內容指定導致要報告狀況之元件作業的處理處置。 processingDisposition 是具有下列一組值的字串: - FUNCTION_PROCESS - FUNCTION_BLOCK - MGMTTASK_PROCESS - MGMTTASK_BLOCKED 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
這個元素定義此事件所參照的環境定義。 藉由與在執行工作單位期間所產生的訊息或事件產生關聯的方式,用來與問題分析產生關聯的資料保留在這個複式類型中。
這個元素可讓您為了延伸,而指定 application-supplied name-type-value 集合。 這個機制可新增未在 CommonBaseEvent 資料模型中指定的其他屬性。 假設這裡所指定的集合是產品的特定資料。
這個元素可讓相互關聯的事件群組在一起, 並以相對應的關聯引擎相互聯結。
事件或狀況之「報告程式」的元件識別。 如果報告元件與程式碼元件不同,則此為「必要」的內容。 否則「不可」出現這個欄位。
受到事件或狀況之「作用」或「影響」的元件識別。 對於受到狀況影響的元件而言,此為「必要」的內容。
msgDataElement 是參照 MsgDataElement 的內容。 這個內容保留用來指定所有相關資訊的資料,該資訊與事件保留之訊息相關聯。 這是「選用」的內容,且不可再變更。 它由發出事件的元件所提供。
狀況是說明事件所報告之狀況或事件的資料。 狀況資訊包括產品群組和平台共用,且架構和彈性上都可採用產品特定需求的必要內容集或屬性集。 狀況是狀況類型的元素, 其指定導致要報告事件的狀況類型。 這是「必要」的內容,且不可再變更,亦即,一旦設定完後,便「不可」再變更。
所有其他的資料。
識別此事件版本的字串。 如果沒有指定,且 Common Base Event 為 1.0 版,則這個欄位便是「選用」的。 否則「必須」將綱目標頭中所指定的版本填寫到這個欄位中。 版本的字串長度「不可」超過 16 字元。 當應用程式遵循這個規格版本來建立事件時,此欄位應設為 1.0.1
事件的主要 ID。這個內容「必須」是廣域唯一的, 且「可以」當成事件的主鍵使用。這個是「選用」的內容。但是,一旦設定完這個值之後, 就「不可」再變更。建議值為 128 位元或 256 位元的「廣域唯一 ID」, 且開頭「必須」為字母字元(即 a-z 和 A-Z)。
這個事件所代表的事件類別(或 XML 中元素)名稱(例如:CommonBaseEvent)。 此名稱指出預期要出現在這個事件中的所有其他元素。 這是「選用」的內容。如果指定的值是空值,則會把值假設為 CommonBaseEvent。 extensionName 的字串長度「不可」超過 64 字元。
提供事件 ID 的程式碼。不保證這個值是廣域唯一的。這是「選用」的內容。 localInstanceId 的字串長度「不可」超過 128 字元。
這個屬性指定此 Common Base Event 的建立時間。其使用 XML 綱目所指定且名為 dateType 的類型。 範例:2004 年 12 月 31 日下午 12:00 為 "2004-12-31T12:00:00"。
事件正在說明的已知狀態嚴重性(與報告事件的應用程式有關)。 預先定義的嚴重性層次如下(以嚴重性遞增的次序排序): * 0 不明 * 10 當事件只包含一般資訊,且沒有報告錯誤時,「必須」使用資訊。 * 20 當錯誤事件不影響資源的正常作業時,「必須」使用無害。 * 30 如果警告可協助使用者決定是否要採取動作以回應事件時,「必須」使用警告。 * 40 「必須」使用次要錯誤,指出需要採取動作,但當時的狀況並不嚴重。 * 50 「必須」使用重要,指出需要立即採取動作,且範圍廣闊 (可能即將造成重要資源的運作中斷)。 * 60 「必須」使用嚴重,指出已發生錯誤,但已來不及採取捕救措施。 相關聯的值是 0 到 70。若為「不明」,已保留值會從 0 開始,若為「嚴重」,則會從 10 到 60 遞增增加。 您「可以」新增其他嚴重性,但「不可」超過 70。這個是「選用」的內容。
伴隨著事件的文字。一般為已解析的訊息字串,針對特定的語言環境,以人類可讀 的格式呈現。這個是「選用」的內容。 msg 的字串長度「不可」超過 1024 字元。
定義事件的重要性。預先定義的優先順序如下: * 10 低 * 50 中 * 70 高 這個值從 0 到 100。「低」的已保留值為 10,「中」為 50,「高」為 70。 「可以」新增其他內容,但「不可」超過 100。這個是「選用」的內容。
程式碼定義的數字,可以用不同於到達消費者位置的邏輯命令來傳送和處理多個訊息(例如:事件伺服器或管理工具), 序號可協助消費者排序不照次序到達的訊息。這與建立時間和訊息的特定報告程序有關。 這是「選用」的內容,且沒有預設值。
repeatCount 指定相同事件在指定時間間隔內的出現次數。 時間間隔由 elapsedTime 內容所指定。 「相同事件」定義在特定應用程式中,因此,本規格不再定義。 這個內容是「選用」的,且可以變更。repeatCount「可以」由發生事件的元件或事件消費者設定 。 沒有預設值。零值或空值表示事件沒有重複出現。
這是發生相同事件次數的時間間隔或經歷時間(如 repeatCount 內容中所指定)。 這個值的單位為微秒。 如果 repeatCount 沒有指定值(或指定零),則這個是沒有預設值的「選用」內容。 但是,如果 repeatCount 有指定值(非零的值),則 elapsedTime 是「必要」的。
這個元素提供由 sourceComponentId 和 reporterComponentId 元素所識別之元件的詳細資訊。
這個內容指定元件的邏輯識別。其必須包含特定應用程式、 產品或子系統的名稱。在報告程式位置內容所指定的範圍內,這個值必須為唯一的。 componentIdType 內容需要指定的資訊類型。 附註:元件、子元件和 componentIdType 內容 組成一個邏輯群組。Common Base Event 的生產者和消費者應該考量這些內容之間的相互關係。
這個內容指定事件之邏輯元件內容的進一步差異。 其應該包含元件內容的子元件身分識別, 且其定義應該是在事件中所指定的最精確定義,例如, ApplicationServer:mycompany.myapp.AdminConsole。 附註:這個內容可能是應用程式或作業系統的其中一個部分, 例如,模組名稱、類別名稱、類別和方法名稱。
這個內容指定在 componentIdentificationType 元素中所識別之元件內容的格式和意義。 Common Base Event 1.0.1 版規格中有定義下列元件類型: * ProductName:指出元件代表特定的產品。 * DeviceName:指出元件代表裝置。 * SystemName:指出元件代表系統。 * ServiceName:指出元件代表服務。 * Process:指出元件代表程序。 * Application:指出元件代表一或多個元件的集合, 其中在 module.component 表單中指定元件, 在 class.method 表單中指定子元件。 * Unknown:指出元件不是上述任一類型。
這個內容指定在元件內容中所指定元件的實例處理碼或 ID。 在系統上多次出現元件的執行時,這項功能非常有用。 附註:這個內容應會唯一識別元件的特定實例。 有些環境可能會提供適當的建構給 instanceId 內容的值。
這個內容指定具可讀性的應用程式「共用」名稱。 應用程式版本資訊可選擇性地附加在名稱的後面,以 # 符號區隔。 例如,My application#3.2 指定了應用程式為「我的應用程式」以及 3.2 版。
這個內容指定在應用程式內容中所指定的應用程式主機作業環境。 其識別執行應用程式的目前環境。例如, My application 在 BaseAppServer\myNode\server1 上執行主機作業。 executionEnvironment 的版本資訊在內容值的尾端指定,並以 # 字元區隔, 則可以指定為 BaseAppServer\myNode\server1#5.1。
這個內容指定對應於元件位置的實際位址。 這個位址可以是多個不同類型中的其中一個(例如 IP 位址、主機名稱或 MAC 位址), 因此,也要指定 locationType 元素。 附註:位置位址的建議值是完整的主機名稱。
這個內容指定位置內容中之值的格式和意義。已定義下列類型: * IPV4:網際網路通訊協定第 4 版 * IPV6:網際網路通訊協定第 6 版 * NWA:請參閱附註*。 * ISDN:請參閱附註*。 * ICD:請參閱附註*。 * OID-OSI:請參閱附註*。 * Dial:請參閱附註*。 * HWA:請參閱附註*。 * HID:請參閱附註*。 * X25:請參閱附註*。 * DCC:請參閱附註*。 * SNA:請參閱附註*。 * IPX:請參閱附註*。 * E.164:請參閱附註*。 * Hostname:主機系統的名稱 * FQHostname:主機系統的完整名稱 * Devicename:裝置名稱 *附註:請參閱「分散式管理工作小組」(DMTF) 的 Common Informatoin Model (CIM) 中的定義, 網址為:http://www.dmtf.org/standards/cim
這個內容是指定產生事件之執行中元件或子元件的程序 ID 的字串。 這個值是平台特定的。threadId 內容可用來與 processId 一起使用,以進一步描寫元件或子元件。
這個內容是指定 proessId 內容所指定之元件或子元件的執行緒 ID 的字串。 執行中的程序可大量產生一或多個執行緒,以執行它的函數。 threadId 會相對變更。 附註:如果要使用 processId 和 threadId,一般可從主機作業環境或平台中取得。
這個內容會描述給定類型元件之所有實例的特徵。 componentType 是一個字串,包含名稱空間完整名稱(與 LML 完整名稱類似), 可由選用性字首和本端部分組成,可選擇用冒號區隔。 提示:這個內容不是用來唯一識別元件, 而是識別可當成其他限定元使用的元件(或資源)類型,以識別及建立 元件實例名稱的範圍。
ConfigureSituation 會處理識別其配置的元件。 元件對其配置所做的任何變更應該用這個種類來記載。 此外,說明現行配置狀態的訊息也屬於這個種類。 現有的訊息包含埠號為、位址為,和程序 ID 等文字,例如: ADFS0134I: 檔案轉送配置為 host="9.27.11.13"、port="9090"、securityEnabled="false"。
這個內容指定會導致報告該情形的作業成功部署情形。 successDisposition 是具有下列一組值的字串: - SUCCESSFUL - UNSUCESSFUL 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
ConnectSituation 會處理識別連線到其他元件方面問題的狀況。 告知連線失敗、已建立連線或連線結束等訊息,都屬於這個種類。 現有的訊息包含重設連線、連線失敗及無法取得連線等文字,例如: DBMN0015W: 建立連線 {0} 時,發生錯誤 DBMN0033W: 連線關閉失敗 {0} DBMN0023W: 無法關閉連線 {0}
這個內容指定會導致報告該情形的作業成功部署情形。 successDisposition 是具有下列一組值的字串: - SUCCESSFUL - UNSUCESSFUL 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
這個內容指定狀況處置,其為說明狀況的必要參數表示法。 situationDisposition 是具有下列一組值的字串: - INUSE - FREED - CLOSED - AVAILABLE 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
建立這個環境定義資料元素的應用程式名稱。 這是「必要」的內容。這個內容的字串長度「不可」超過 64 字元。
contextValue 內容的資料類型。 這是「必要」的內容。這個內容的字串長度「不可」超過 64 字元。
CreateSituation 會處理元件建立實體時所記載的狀況文件。 告訴您文件或檔案已建立完成,或 EJB 已建立完成等訊息,都屬於這個種類。 現有的訊息包含已建立完成、即將建立以及已存在等文字,例如: ADMR0009I: Document cells/flatfootNetwork/applications/Dynamic Cache Monitor.ear/Dynamic Cache Monitor.ear 已建立完成
這個內容指定會導致報告該情形的作業成功部署情形。 successDisposition 是具有下列一組值的字串: - SUCCESSFUL - UNSUCESSFUL 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
DependencySituation 會處理當元件找不到所需的元件或特性時所產生的狀況。 這個種類包含找不到預期元件「版本」的相關訊息。 告知找不到資源或無可用的應用程式或子系統等訊息,也屬於這個種類。 現有的訊息包含找不到、指定的元件不存在等文字,例如: WSVR0017E: 連結 J2EE 資源 Pet Store JMS Queue Connection Factory 時發生錯誤, 因為 resources.xml 資源的 jms/queue/QueueConnectionFactory 找不到資源連結程式
這個內容指定導致要報告狀況之元件的特性相依關係處置。 featureDisposition 是具有下列一組值的字串: - MET - NOT MET 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
DestroySituation 會在已移除或毀損實體或元件時,處理狀況文件。 告訴您文件已毀損或檔案已刪除的訊息,都屬性這個種類。 現有的訊息包含已建立完成、即將建立以及已存在等單字,例如: CONM6007I: 資料來源 (UDDI.Datasource.techs8.server1) 的連線儲存區已毀損。
這個內容指定會導致報告該情形的作業成功部署情形。 successDisposition 是具有下列一組值的字串: - SUCCESSFUL - UNSUCESSFUL 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
這個延伸資料元素的值陣列,以指定類型的字串形式代表,包含 hexBinary。 您「必須」使用 hexValue 內容來定義 hexBinary 值。hexValue 和值內容互斥。「只能」定義其中一個內容。 這是「選用」的內容。這個內容的字串長度「不可」超過 1024 字元。
hexValue 是字元的陣列,其保留非上述支援類型的任何其他資料類型或 complexType 的資料。 hexValue 和值內容互斥。「只能」定義其中一個內容。 這是「選用」的內容。
子項內容參照其他 ExtendedDataElement 以指定 ExtendedDataElement 的結構清單。 這個清單可讓您建立對應到 CommonBaseEvents 之特定群組的相關 ExtendedDataElement 階層。 因此,使用這個方法可以快速取得對相關 ExtendedDataElement 清單的存取權, 而不需查看和檢查所有 ExtendedDataElement。這個內容是「選用」的,且可以變更。
已延伸資料元素的名稱。在 extendedDataElement 階層的相同層級中,這個名稱「必須」不同於所有其他欄位, 但是不同層級或階層中,可能有相同名稱的子項存在。 這是「必要」的內容。這個內容的字串長度「不可」超過 64 字元。
在值內容中所指定之值的資料類型。 有效的類型列示如下。這些僅是 ExtendedDataElement 類型的有效資料類型。 預設值是 "string"。這是「必要」的內容。這個內容的字串長度「不可」超過 64 字元。
FeatureSituation 會處理宣告元件特性已準備好(或還沒準備好)要接受服務要求的狀況。 指出已可以使用服務,以及無法使用服務或特性等狀況,都屬於這個種類。 現有的狀況包含 現在可供使用、目前可供使用,以及正在埠 123 上接聽傳輸等文字,例如: SRVE0171I: 傳輸 HTTPS 在埠 9443 上接聽 MSGS0601I: 未安裝 WebSphere Embedded Messaging
這個內容指定導致要報告狀況之元件的特性可用性處置。 featureDisposition 是具有下列一組值的字串: - AVAILABLE - NOT AVAILABLE 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
這個元素代表用來指定所有相關資訊的資料,該資訊與事件保留之訊息相關聯。
這個屬性代表當成替代值使用,以將國際化訊息解析成格式化文字的字串陣列。 陣列元素的隱含次序暗示著替代值的次序。如果沒有替代值,則不需要指定 msgCatalogTokens。 這是「選用」的內容。msgCatalogTokens 內容的字串長度「不可」超過 256 字元/每記號。
呈現這個 msg 內容的語言環境。其值是符合 IETF RFC 1766 的語言環境程式碼。這是「選用」的內容。
OtherSituation 種類支援預先定義種類之外的產品特定需求狀況。
ReportSituation 處理元件所報告的狀況, 例如活動訊號或效能資訊等。目前 CPU 使用率、 目前記憶體資料堆大小等資料,都屬於這個種類。現有的訊息包含 使用率、緩衝區大小,以及執行緒數量等文字,例如: IEE890I 主控台備份儲存體中的「WTO 緩衝區」 = 1024
這個內容指定已報告狀況的種類。reportCategory 是具有下列一組值的字串: - PERFORMANCE - SECURITY - HEARTBEAT - STATUS - TRACE - DEBUG - LOG 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
RequestSituation 會處理元件用來識別 要求是否處於完成狀態的狀況。一般來說,這些要求都是元件以要求者身份執行的複式管理作業或交易, 而不是主線簡式要求或交易。現有的訊息包含 已啟動配置同步處理和已完成備份程序等文字,例如: ADMS0003I:配置同步處理已完成。
這個內容指定會導致報告該情形的作業成功部署情形。 successDisposition 是具有下列一組值的字串: - SUCCESSFUL - UNSUCESSFUL 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
這個內容指定狀況要求限定元,其為說明狀況的必要參數表示法。 situationQualifier 是具有下列一組值的字串: - REQUEST INITIATED - REQUEST COMPLETED 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
狀況指定導致要報告事件的狀況類型。 這是「必要」的內容。
situationType 指定導致要報告事件的狀況類型。請參閱 SituationType 定義,以取得詳細資料。 這是「必要」的內容。
categoryName 指定導致要報告事件的狀況類型。categoryName 是具有下列一組值的字串:
這個內容指定所報告狀況的影響範圍。 下表說明值的起始設定。 這是「必要」的內容。這個內容的字串長度「不可」超過 64 字元。
StartSituation 處理元件的啟動程序。 指出元件已開啟啟動程序、元件已完成啟動處理,或 元件已中止啟動處理等訊息,都屬於這個種類。
這個內容指定會導致報告該情形的作業成功部署情形。 successDisposition 是具有下列一組值的字串: * SUCCESSFUL * UNSUCESSFUL 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
這個內容指定狀況限定元,其為說明狀況的必要參數表示法。 situationQualifier 是具有下列一組值的字串: * START INITIATED * RESTART INITIATED * START COMPLETED 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
StopSituation 處理元件的關閉程序。 指出元件已開啟關閉、元件已停止,或 關閉程序失敗等訊息,都屬於這個種類。現有的訊息包含 停止、正在停止、已停止、已完成和正在結束等文字,例如: WSVR0220I:應用程式已停止:{0} WSVR0102E:停止時發生錯誤 {0} MSGS0657I: 正在停止 MQJD JMS Provider
這個內容指定會導致報告該情形的作業成功部署情形。 successDisposition 是具有下列一組值的字串: - SUCCESSFUL - UNSUCESSFUL 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
這個內容指定狀況限定元,其為說明狀況的必要參數表示法。 situationQualifier 是具有下列一組值的字串: - STOP INITIATED - ABORT INITIATED - PAUSE INITIATED - STOP COMPLETED 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
這個內容指定狀況限定元,其為說明狀況的必要參數表示法。 situationQualifier 是具有下列一組值的字串: - STOP INITIATED - ABORT INITIATED - PAUSE INITIATED - STOP COMPLETED 這是「必要」的內容,一旦設定完後,便「不可」再變更。這個內容的字串長度「不可」超過 64 字元。
用來解決訊息型錄中訊息文字的訊息索引或 ID。 這是「選用」的內容,其字串長度「不可」超過 64 字元。
msgCatalogType 內容指定 msgCatalog 的意義和格式。目前,已保留關鍵字的非專屬性清單包括: - Java - XPG 這個內容是「選用」的,且一旦設定完後,便不可再變更。msgCatalogType 內容的字串長度「不可」超過 32 字元。
包含 msgCatalogId 所指定之已翻譯訊息的訊息型錄完整名稱。 這是「選用」的內容,msgCatalog 的字串長度「不可」超過 128 字元。
指定事件的訊息 ID。這個 ID 「應是」字母數字或數值字元的唯一值字串。 它可以很簡單,如同在訊息型錄中識別訊息的數值字元字串,或者字母數字的多組件字串(例如 DBT1234E)。 這是「選用」的內容,msgId 的字串長度「不可」超過 256 字元。
指定 msgId 的意義和格式。如果 msgId 符合 或代表標準或已知的慣例,則由這個內容命名。 例如:IBM3.4、IBM4.4、IBM3.1.4、IBM3.4.1、IBM4.4.1 和 IBM3.1.4.1。 非專屬性的已保留關鍵字包括: - IBM*(* 如下所述) - JMX - DottedName - Unknown 這是「選用」的內容,msgIdType 的字串長度「不可」超過 32 字元。