資訊來源標籤

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

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

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

資訊來源標籤

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

應用程式擷取點的資訊來源對話框

若要開啟資訊來源的「資訊來源」對話框,請選取表格中的資訊來源,然後按一下編輯,或者按兩下資訊來源。

下列範例顯示為應用程式擷取點選取 REWRITE 時的「資訊來源」對話框。

圖 1. 應用程式擷取點的資訊來源對話框
應用程式擷取點的「資訊來源」對話框。

可用資料欄位

「可用資料」區段包含下列欄位:
環境定義
環境定義欄位是用於擷取應用程式環境定義的相關資料。有效的環境定義選項包括:
PROGRAM
TRANSID
USERID
事件選項
事件選項是用於擷取 CICS® 指令上的選項值。事件選項會視指定的擷取點而有所不同。
應用程式資料
擷取規格中的述詞是用於過濾 CICS 指令中所指定的應用程式資料。 應用程式資料會視指定的擷取點而有所不同。只有在「可用資料」區段中選取了應用程式資料的項目時,才能在對話框中使用記錄定義檔匯入及格式化選項。
視您在「可用資料」區段中選取的選項而定,「資訊來源」對話框中可用的欄位如下:
儲存器
指定 CICS 通道儲存器。只有當應用程式資料指定了通道時,才能選取儲存器欄位。在所有其他狀況下,會停用此欄位。

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

類型
指定應用程式資料述詞的資料類型。可用的資料類型如下:
  • 二進位浮點
  • 字元
  • 以空值結尾的字元
  • 十進位浮點
  • 十六進位
  • 以空值結尾的十六進位
  • 十六進位浮點
  • 聚集十進位
  • 帶正負號的半字
  • 帶正負號的全字
  • 不帶正負號的半字
  • 不帶正負號的全字
  • 區化十進位
偏移
指定從頭(資料開始處)開始的距離。偏移 0 表示欄位開頭。
長度
指定要擷取的欄位長度。如果指定長度 0,則會一直擷取到資料區或儲存器的尾端。指定長度 0 具有下列效果:
  • 如果 API 指令中的資料區長度由 API 指令的另一個引數所指定(或由轉換器提供預設值),則會擷取資料區或儲存器的所有內容,而不管其長度為何。例如,若在 LINK 指令上指定 COMMAREA 和 LENGTH,則會擷取所有資料。
  • 如果 API 指令中所擷取的資料區沒有長度引數,則不會擷取任何資料。例如,若在 READ 指令上指定 RIDFLD,或在 RECEIVE MAP 指令上指定 INTO,但沒有相關聯的長度引數,則擷取的資料位元組為 0。
精準度
選取數值和科學記號商業資訊項目的精準度。對於其他商業資訊項目,則會停用此欄位。
字碼頁
選取字碼頁。對於某些商業資訊項目(例如來自另一個來源的應用程式資料),會停用此欄位。如需字碼頁的相關資訊,請參閱編碼字集參照資料
靜態資料
若要將不可變更的資料傳遞給事件消費者,則可以指定要與事件相關聯的靜態資料。您可以定義最多 255 個字元(含空格)的靜態值。有效的字集如下:

0-9 A-Z a-z `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|

系統擷取點的資訊來源對話框

若要開啟資訊來源的「資訊來源」對話框,請選取表格中的資訊來源,然後按一下編輯,或者按兩下資訊來源。CICS 知道所有資訊來源的格式。

下列範例顯示為系統擷取點選取 FILE ENABLE 時的「資訊來源」對話框。

圖 2. 系統擷取點的資訊來源對話框
系統擷取點的「資訊來源」對話框
「可用資料」區段包含下列欄位:
環境定義
環境定義欄位是用於擷取系統環境定義的相關資料。有效的環境定義選項包括:
TRANSID
USERID
系統事件資料
「系統事件資料」欄位是用來擷取所發生系統事件的相關資料。系統事件資料會視指定的擷取點而有所不同。
靜態資料
若要將不可變更的資料傳遞給事件消費者,則可以指定要與事件相關聯的靜態資料。您可以定義最多 255 個字元(含空格)的靜態值。有效的字集如下:

0-9 A-Z a-z `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|

下表列出「資訊來源」對話框中可用的欄位(視您在擷取點標籤的「系統擷取點」窗格中所選取的系統擷取點而定)。

Db2 CONNECTION STATUS 的資訊來源

表 1. Db2 CONNECTION STATUS 的資訊來源
選項 說明
Db2 ID

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

如需相關資訊,請參閱 INQUIRE Db2 CONN 中的 Db2 ID。

Db2 GROUPID

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

如需相關資訊,請參閱 INQUIRE Db2 CONN 中的 Db2 GROUPID。

Db2 RELEASE

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

如需相關資訊,請參閱 INQUIRE Db2 CONN 中的 Db2 RELEASE。

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

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

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

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

FILE ENABLE STATUS 的資訊來源

表 2. FILE ENABLE STATUS 的資訊來源
選項 說明
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 OPEN STATUS 的資訊來源
選項 說明
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 的資訊來源
選項 說明
INSERTnn 指定您要查詢之訊息的 INSERTnn 值,其中 nn 是從 1 到 30 的插入 ID。
MESSAGE_ID 指定您要查詢之訊息的 9 個字元訊息號碼。
MESSAGE_TEXT 將訊息的整個文字指定為事件中的輸出欄位。如果您要擷取整個訊息,請使用此選項。擷取的訊息文字上限長度為 1024 個位元組。如果訊息長於 1024 個位元組,則會將其截斷。
註: 除了傳送至 CICS 主控台的訊息會以英文擷取以外,所有其他訊息皆會以 NATLANG 系統起始設定參數所定義的語言進行擷取。

TASK THRESHOLD 的資訊來源

表 5. TASK THRESHOLD 的資訊來源
選項 說明
FROM_TASKS

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

TO_TASKS

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

MAXTASKS

傳回可在此 CICS 系統中隨時分派的作業數上限。

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

PERCENT_MAXTASKS

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

TRANCLASS TASK THRESHOLD 的資訊來源

表 6. TRANCLASS TASK THRESHOLD 的資訊來源
選項 說明
TRANCLASS

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

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

FROM_ACTIVE

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

TO_ACTIVE

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

MAXACTIVE

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

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

PERCENT_MAXACTIVE

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

UNHANDLED TRANSACTION ABEND 的資訊來源

表 7. UNHANDLED TRANSACTION ABEND 的資訊來源
選項 說明
TRANSACTION

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

ABCODE

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

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