資訊來源標籤

使用資訊來源標籤,可以定義這個擷取規格取得發出的商業資訊的位置。

這個標籤是由您先前在事件連結標籤中定義的商業資訊項目表格所組成。 您必須輸入每一個發出的商業資訊項目的資訊來源。

使用此標籤,可以將與事件規格相關聯的商業資訊項目對映至此擷取點的可用資料項目。

資訊來源標籤的影像。

資訊來源表格中的欄位,是您可以在「編輯資訊來源」畫面中編輯的選項摘要。

應用程式擷取點的編輯資訊來源畫面

若要開啟資訊來源的「編輯資訊來源」畫面,請選取表格中的資訊來源並按一下編輯,或按兩下資訊來源。
圖 1. 這個影像顯示如果對應用程式擷取點選取 REWRITE,您可能會看到的「資訊來源」畫面。
應用程式擷取點的編輯資訊來源畫面的影像。

可用資料窗格欄位

編輯資訊來源」畫面的「可用資料」窗格包含下列欄位:
環境定義
環境定義欄位會用於擷取應用程式環境定義的相關資料。有效的環境定義選項包括:
PROGRAM
TRANSID
USERID
事件選項
事件選項會用來擷取 CICS 指令上的選項值。事件選項會視指定的擷取點而有所不同。
應用程式資料
擷取規格中的述詞會用於過濾 CICS 指令中指定的應用程式資料。 應用程式資料會視指定的擷取點而有所不同。 只有在「可用資料」窗格中選取了應用程式資料的項目時,才能使用位於「編輯資訊來源」畫面右側的記錄定義檔匯入和格式化選項。
根據您在「編輯資訊來源」畫面的「可用資料」窗格中所選取的選項,「編輯資訊來源」畫面的其餘窗格中可以使用下列欄位:
儲存器
指定 CICS 通道儲存器。只有當應用程式資料指定了通道時,才能選取儲存器欄位。在所有其他情況下,此欄位會停用。

如果您要匯入語言結構,請按一下從匯入的語言結構中選取。接著您可以從語言結構中,選取要擷取的欄位。若您使用這個方法,則類型偏移長度欄位會自動完成。 另外,您也可以指定類型偏移長度值。

類型
指定應用程式資料述詞的資料類型。下列資料類型可用:
  • 二進位浮點數
  • 字元
  • 以空值終止的字元
  • 十進位浮點數
  • 十六進位
  • 以空值終止的十六進位
  • 十六進位浮點數
  • 聚集十進位
  • 帶正負號的半字
  • 帶正負號的全字
  • 不帶正負號的半字
  • 不帶正負號的全字
  • 區化十進位
偏移
指定從頭(資料開始處)開始的距離。 偏移 0 表示欄位開頭。
長度
要擷取的欄位長度。長度為 0 表示一直擷取到資料區或儲存器的尾端。舉例來說,在發出儲存器的內容而不考慮其長度時,這個值會很有用。
精準度
選取數值和科學商業資訊項目的精準度。對於其他商業資訊項目,會停用這個欄位。
字碼頁
選取字碼頁。對於某些商業資訊項目(如來自另一個來源的應用程式資料),會停用這個欄位。
靜態資料
您可以定義不超過 255 個字元(含空格)的靜態值。有效的字集如下:
A-Z、a-z、0-9、`¬¦!"£$%^&*()_+-={}:@~;'#<>?,./| 

系統擷取點的編輯資訊來源視窗

若要開啟資訊來源的「編輯資訊來源」畫面,請選取表格中的資訊來源並按一下編輯,或按兩下資訊來源。CICS 知道所有資訊來源的格式。
圖 2. 這個影像顯示如果對系統擷取點選取 FILE ENABLE,您可能會看到的「資訊來源」畫面。
系統擷取點的編輯資訊來源畫面的影像。
編輯資訊來源」畫面的「可用資料」窗格包含下列欄位:
環境定義
環境定義欄位會用於擷取系統環境定義的相關資料。有效的環境定義選項包括:
TRANSID
USERID
系統事件資料
「系統事件資料」欄位會用來擷取發生的系統事件的相關資料。系統事件資料會視指定的擷取點而有所不同。
靜態資料
您可以定義不超過 255 個字元(含空格)的靜態值。有效的字集如下:
A-Z、a-z、0-9、`¬¦!"£$%^&*()_+-={}:@~;'#<>?,./| 

根據您在擷取點標籤的「系統擷取點」窗格中所選取的選項,「編輯資訊來源」畫面中會有下列可用選項:

DB2 CONNECTION STATUS 的資訊來源

表 1.
選項 說明
DB2ID

若您未使用群組連接,這個選項會傳回 CICS DB2 連接裝置所連接之 DB2 子系統的名稱,或者若未連接 CICS DB2 連接裝置,則傳回您對 CICS 指定要連接之 DB2 子系統的名稱。

如需相關資訊,請參閱 INQUIRE DB2CONN 中的 DB2ID。

DB2GROUPID

如果您使用群組連接,則此選項會傳回您所指定之 DB2 子系統的資料共用群組或子群組的名稱。

如需相關資訊,請參閱 INQUIRE DB2CONN 中的 DB2GROUPID。

DB2RELEASE

傳回 4 個字元的值,指出 CICS 連接之 DB2 子系統的版本和版次層次。

如需相關資訊,請參閱 INQUIRE DB2CONN 中的 DB2RELEASE。

FROM_CONNECTST
代表 CICS DB2 連線狀態的字串。可能的值包括:
  • CONNECTED
  • NOTCONNECTED
  • CONNECTING
  • DISCONNING

如需相關資訊,請參閱 INQUIRE DB2CONN 中的 CONNECTST。

TO_CONNECTST
代表 CICS DB2 連線狀態的字串。可能的值包括:
  • CONNECTED
  • NOTCONNECTED
  • CONNECTING
  • DISCONNING

如需相關資訊,請參閱 INQUIRE DB2CONN 中的 CONNECTST。

FILE ENABLE STATUS 的資訊來源

表 2.
選項 說明
FILE

指定您查詢之檔案的 8 個字元名稱。

如需相關資訊,請參閱 INQUIRE FILE 中的 FILE。

DSNAME

傳回與 FILE 定義相關聯之 BDAM 資料集或 VSAM 物件的 44 個字元名稱。

如需相關資訊,請參閱 INQUIRE FILE 中的 DSNAME。

FROM_ENABLESTATUS
識別應用程式是否可以存取檔案的字串。可能的值包括:
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

如需相關資訊,請參閱 INQUIRE FILE 中的 ENABLESTATUS。

TO_ENABLESTATUS
識別應用程式是否可以存取檔案的字串。可能的值包括:
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

如需相關資訊,請參閱 INQUIRE FILE 中的 ENABLESTATUS。

OPENSTATUS
識別檔案為開啟、已關閉或處於過渡狀態的字串。可能的值包括:
  • CLOSED
  • CLOSEREQUEST
  • OPEN

如需相關資訊,請參閱 INQUIRE FILE 中的 OPENSTATUS。

FILE OPEN STATUS 的資訊來源

表 3.
選項 說明
FILE

指定您查詢之檔案的 8 個字元名稱。

如需相關資訊,請參閱 INQUIRE FILE 中的 FILE。

DSNAME

傳回與 FILE 定義相關聯之 BDAM 資料集或 VSAM 物件的 44 個字元名稱。

如需相關資訊,請參閱 INQUIRE FILE 中的 DSNAME。

FROM_OPENSTATUS
識別檔案為開啟、已關閉或處於過渡狀態的字串。可能的值包括:
  • CLOSED
  • CLOSEREQUEST
  • OPEN

如需相關資訊,請參閱 INQUIRE FILE 中的 OPENSTATUS。

TO_OPENSTATUS
識別檔案為開啟、已關閉或處於過渡狀態的字串。可能的值包括:
  • CLOSED
  • CLOSEREQUEST
  • OPEN

如需相關資訊,請參閱 INQUIRE FILE 中的 OPENSTATUS。

ENABLESTATUS
識別應用程式是否可以存取檔案的字串。可能的值包括:
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

如需相關資訊,請參閱 INQUIRE FILE 中的 ENABLESTATUS。

MESSAGE 的資訊來源

表 4.
選項 說明
MESSAGE_ID 指定您所查詢之訊息的 9 字元訊息號碼。
INSERTnn 指定您所查詢之訊息的 INSERTnn 值。其中,nn 是 1 到 22 的插入項目 ID。

TASK THRESHOLD 的資訊來源

表 5.
選項 說明
FROM_TASKS

指定在事件之前連接的作業數。

TO_TASKS

指定在事件之後連接的作業數。

MAXTASKS

傳回在這個 CICS 中的任何時間,可進行分派的作業數上限。

如需相關資訊,請參閱 INQUIRE SYSTEM 中的 MAXTASKS。

PERCENT_MAXTASKS

指定已越過的臨界值(以作業數上限的百分比顯示)。

TRANCLASS TASK THRESHOLD 的資訊來源

表 6.
選項 說明
TRANCLASS

指定您查詢之交易類別的 8 個字元名稱。如果類別是舊版 CICS 中使用的其中一個編號類別,其名稱會是 DFHTCLnn,其中 nn 是兩位數的類別號碼。

如需相關資訊,請參閱 INQUIRE TRANCLASS 中的 TRANCLASS。

FROM_ACTIVE

傳回在事件之前,交易類別中的作用中作業數。

TO_ACTIVE

傳回在事件之後,交易類別中的作用中作業數。

MAXACTIVE

傳回可在交易類別中同時執行的作業數上限。

如需相關資訊,請參閱 INQUIRE TRANCLASS 中的 MAXACTIVE。

PERCENT_MAXACTIVE

指定已越過的臨界值(以作用中作業數上限的百分比顯示)。

UNHANDLED TRANSACTION ABEND 的資訊來源

表 7.
選項 說明
TRANSACTION

指定發出未處理的交易異常終止的交易 ID。

ABCODE

指定 4 字元的交易傾出異常終止碼。

如需相關資訊,請參閱新增擷取規格