實作資料收集服務中使用者定義的種類

「資料收集服務」中使用者定義的種類功能,可讓應用程式將效能資料收集整合到「資料收集服務」中。

這可讓您撰寫資料收集程式、登錄它並與「資料收集服務」整合,而從應用程式收集資料。 「資料收集服務」會在每一個資料收集間隔呼叫資料收集程式,並將資料儲存於資料收集物件中。 您應該使用下面列示的「資料收集物件 API」來存取儲存於資料收集物件中的資料。 只要資料已收集或資料收集物件已保留,您就可以即時存取該資料。

若要實施此功能,您必須:

  1. 開發程式來收集「資料收集服務」中新種類的效能資料。
  2. 為資料收集程式建立工作說明。QGPL 中的工作說明 QPMUSRCAT 提供了範例, 但不代表預設值或建議值。
  3. 登錄新種類並指定資料收集程式。
    • 登錄:QypsRegCollectorDataCategory
    • 取消登錄:QypsDeregCollectorDataCategory

    登錄該種類之後,「資料收集服務」會將它併入可用的資料收集種類清單中。

  4. 新增種類至您的「資料收集服務」設定檔中,然後循環「資料收集服務」
  5. 開發程式來查詢資料收集物件。
    • 擷取作用中管理資料收集物件名稱:QpmRtvActiveMgtcolName(僅用於即時查詢資料收集物件)
    • 擷取管理資料收集物件屬性:QpmRtvMgtcolAttrs
    • 開啟管理資料收集物件:QpmOpenMgtcol
    • 關閉管理資料收集物件:QpmCloseMgtcol
    • 開啟管理資料收集物件儲存庫:QpmOpenMgtcolRepo
    • 關閉管理資料收集物件儲存庫:QpmCloseMgtcolRepo
    • 讀取管理資料收集物件資料:QpmReadMgtcolData

您自訂的資料收集程式目前依每個資料收集間隔執行,而收集的資料保存在資料收集物件中。

您亦可實作這些 API 的 Java™ 版本。所需的 Java 類別位於整合檔案系統 (IFS) 目錄 QIBM/ProdData/OS400/CollectionServices/lib 中的 ColSrv.jar 內。Java 應用程式應將這個檔案併入它們的類別路徑中。有關 Java 實作方式的資訊,請下載 javadocs 的 .zip 檔。

即時查詢資料收集物件

如果您的應用程式需要即時查詢資料收集物件,則必須將查詢與「資料收集服務」同步。 若要這麼做,應用程式應建立一個資料佇列並對「資料收集服務」登錄它。登錄之後, 收集器會在每一個資料收集間隔及資料收集循環結束時發出通知。應用程式應維護資料佇列, 包括完成時移除資料佇列及處理異常結束。若要登錄及取消登錄資料佇列,請參閱下列 API: