使用 IMS Isolation with an Eclipse IDE 為 IMS 應用程式建立除錯設定檔

您可以建立並啟動 IMS 隔離設定檔，以透過在專用 IMS 區域中啟動除錯器來隔離除錯階段作業與其他使用者。 一次只能啟動一個專用區域，且一個 IMS 「隔離」或非 CICS 設定檔可以處於作用中。

關於這項作業

IMS 隔離設定檔包含下列資訊片段:
  • 要由除錯器配置的專用區域及交易詳細資料。 專用區域選項只儲存在 Eclipse 工作區中，在您除錯或執行程式碼涵蓋面之前，用來配置交易及啟動專用區域。
  • 用來觸發除錯器及其他除錯器配置選項的過濾器。 用來觸發除錯器的過濾器儲存在稱為 EQAUOPTS 檔案的循序資料集中，就像非 CICS 設定檔一樣。
附註: IMS 隔離設定檔僅在 IBM® Developer for z/OS® Enterprise Edition中可用。

程序

  1. 開啟 z/OS 除錯器設定檔 視圖。
  2. 若要建立 IMS 隔離設定檔，請以下列其中一種方式開啟 除錯設定檔編輯器 :
    • 按一下視圖工具列中的 建立 IMS 隔離設定檔 圖示 (建立 IMS 隔離設定檔圖示)。
    • 在視圖中按一下滑鼠右鍵，然後選取 建立 IMS 隔離設定檔。
  3. 指定適當的值。 若要導覽至欄位，您也可以 使用快速大綱。
    顯示/隱藏提示
    按一下此鏈結以顯示或隱藏區段的說明。
    設定檔名稱
    指定設定檔名稱。 當您建立新的設定檔時，會自動產生名稱。 您可以使用此名稱或指定不同的名稱，但名稱必須是唯一的。
    選用項目: 說明
    指定設定檔的說明。 說明會儲存在本端，並顯示在 z/OS 除錯器設定檔 視圖中，以協助您識別設定檔。
    連線
    選取設定檔作用中的 遠端系統瀏覽器 z/OS 連線。 如果沒有可用的連線，請按一下 新建 ，以建立新的 z/OS 連線。
    位置
    指定設定檔的位置。
    • 如果您連接至支援 除錯設定檔服務 API的 Remote System Explorer z/OS 連線，則會自動從 API 擷取位置名稱，且無法修改。
    • 如果您要連接至不支援 Debug Profile Service API 或 Debug Profile Service 不在執行中的 Remote System Explorer z/OS 連線， 您必須指定儲存「 IMS 隔離設定檔」的 EQAUOPTS 檔案名稱。 此欄位預先填入 IBM 隨附的預設 EQAUOPTS 檔案，但系統程式設計師可能已變更該檔案。 請向系統程式設計師確認正確的值。
    ADFz 一般元件伺服器埠
    指定 ADFz Common Components 伺服器 執行所在的埠號。 確保系統程式設計師 已安裝並配置 ADFz Common Components 伺服器的 IMS 交易隔離延伸，並且已啟用 IMS 隔離 API。
    附註: 如果可以使用 除錯設定檔服務 來存取 IMS 交易隔離機能，則會停用此欄位。
    預設編碼
    選取編碼以與 ADFz Common Components 伺服器進行通訊。 預設選項是 Cp037。
    附註: 如果可以使用 除錯設定檔服務 來存取 IMS 交易隔離機能，則會停用此欄位。
    IMS 隔離配置
    IMS 系統 ID
    從擷取自 主機的清單中選取 IMS 系統 ID。 您必須選取系統 ID 來新增交易。
    區域名稱
    指定專用區域的區域名稱。 只有在 除錯設定檔服務 正在與 z/OS 除錯器 16.0.0 或更新版本的所選 RSE 連線上執行或 ADFzCC 伺服器與 z/OS 除錯器 15.0.3 或更新版本搭配使用，並套用 APAR PH41774 的 PTF 時，才能指定此選項。 否則，它會預設為 @&USER，其中當您登錄交易、啟動專用區域或啟動設定檔時，會將 &USER 取代為透過 遠端系統瀏覽器 鑑別的使用者 ID。
    工作類別
    指定要用作隔離區域之工作類別的字元。 有效字元為 A-Z、0-9。 將欄位保留空白，以使用預設工作類別。 只有在透過 除錯設定檔服務提供 IMS 隔離支援時，才會啟用此欄位。
    交易
    必須新增並選取至少一個交易，以在 IMS 隔離設定檔中登錄。 已向 IMS 交易隔離機能登錄已勾選的交易以進行除錯。 請使用下列按鈕來更新交易表格:
    新增
    開啟「 交易 」對話框，您可以在其中選取一個以上要新增至設定檔的交易。 如果您是使用 除錯設定檔服務，請指定過濾器並按 Enter 鍵，或按一下 重新整理 以在選取之前擷取交易清單。
    附註: 您需要指定確切的交易名稱，或使用萬用字元 (*) 來取得符合型樣的交易清單。
    移除
    從表格中移除選取的交易。
    設定型樣
    開啟「 修改遞送型樣 」視窗，以指定下列交易遞送型樣資訊:
    訊息
    型樣相符訊息文字。 長度上限為 32 個位元組。
    開始範圍
    指定訊息文字比對應開始的索引。 最大長度為 32767。
    範圍長度
    指定在訊息文字比對期間要搜尋的型樣長度。 最大長度為 32767。
    區分大小寫
    指出型樣相符訊息文字區分大小寫。
    訊息為十六進位
    指出型樣相符訊息文字是十六進位。
    啟動/停止區域
    視所選取交易的專用區域狀態而定，按一下此按鈕會啟動或停止與交易相關聯的區域。
    重新整理
    連接至 IMS 交易隔離機能 ，並重新整理表格中的交易資訊。
    STEPLIB
    使用輸入欄位，將使用者程式庫新增至將新增至建立專用區域之 JES 工作中 STEPLIB 的程式庫清單。 下列按鈕可用來更新清單:
    新增
    將輸入欄位中的檔案庫新增至清單。
    瀏覽
    尋找您要使用 Remote System Explorer新增的程式庫。
    移除
    從清單中移除選取的檔案庫。
    上移
    在清單中向上移動選取的檔案庫。
    下移
    在清單中向下移動選取的檔案庫。
    過濾器
    載入模組或 DLL/程式或 C 函數
    請至少指定一個至最多八個載入模組或 DLL 及程式或 C 函數配對。 按兩下或在表格中按 Enter 鍵以新增或修改項目。
    附註: 除非您要對所有應用程式進行除錯，否則請避免只對載入模組或 DLL 與程式或 C 函數兩者使用萬用字元 (*)。
    選用項目: 除錯器選項
    測試層次
    從 TEST 執行時期選項清單中選取 TEST 或 NOTEST 。
    TEST
    使用此選項可根據指定的選項提供 z/OS Debugger 控制項。
    • 如果使用 CEETEST、 PLITEST或 __ctest()啟動 z/OS Debugger ，則會使用除錯設定檔中的選項。
    • 如果使用 CALL CEETEST 或同等項目來啟動 z/OS Debugger ， 從啟動 z/OS Debugger的程式返回之後，您無法對高階非 Language Environment ® 程式進行除錯或截取高階程式中發生的非 Language Environment 事件。
    NOTEST
    使用此選項，以避免在程式起始設定時啟動 z/OS Debugger 。 不過，您仍然可以使用 CEETEST、 PLITEST或 __ctest() 函數來啟動 z/OS Debugger。 在此情況下，當啟動 z/OS Debugger 時，會使用以 NOTEST 指定的子選項。
    錯誤層次
    從 TEST 執行時期子選項清單中選取 ALL、 ERROR 或 NONE 。
    ALL
    指定下列出現項目會導致 z/OS Debugger 取得控制，而不論是否針對該狀況定義岔斷點。
    • 注意岔斷
    • 程式的 ABEND
    • 嚴重性 1 及以上之任何程式或 Language Environment 條件
    錯誤
    指定只有下列條件會導致 z/OS Debugger 在沒有使用者定義岔斷點的情況下取得控制:
    • 若為 C 及 C + +: 注意岔斷、程式終止、嚴重性 2 或更高嚴重性的預先定義「語言環境」狀況、 SIGUSR1、 SIGUSR2、SIGINT 或 SIGTERM 以外的任何 C 及 C++ 狀況。
    • 若為 COBOL: 注意岔斷、程式終止、嚴重性 2 或更高嚴重性的預先定義「語言環境」狀況。
    • 若為 PL/I: 注意岔斷、程式終止、預先定義的「嚴重性 2」或以上的「語言環境」狀況。
    NONE
    指定只有在針對某個狀況定義岔斷點時， z/OS Debugger 才會從該狀況取得控制。
    提示層次
    從 TEST 執行時期子選項清單中選取 PROMPT 或 NOPROMPT 。
    PROMPT
    指出您希望 z/OS Debugger 在 Language Environment 起始設定之後立即啟動。 從喜好設定檔案中讀取指令，然後讀取任何指定的主要指令檔。 如果這些檔案都不存在，則將從您的終端機或工作站讀取指令。
    noPrompt
    指出您不希望 z/OS Debugger 在 Language Environment 起始設定之後立即啟動。 相反地，您的應用程式開始執行。
    如果您指定 NOPROMPT 子選項，則在您從啟動 z/OS Debugger的程式返回之後，無法對高階非 Language Environment 程式進行除錯或截取高階程式中發生的非 Language Environment 事件。
    在未使用 EQANMDBG啟動 Language Environment 執行時期的情況下執行 z/OS Debugger 時，會忽略 NOPROMPT 選項; PROMPT 一律有效。

    指令資料集
    指定包含要在除錯階段作業啟動時執行之起始除錯器指令的有效完整資料集名稱，或按一下 瀏覽 以選取資料集。 也接受有效的 VADSCPnnnnn 項目。
    附註: 並非所有指令都允許在遠端除錯階段作業中。 如果這些指令包含在指令資料集中，您可能會在「 除錯主控台 」視圖中看到錯誤。
    喜好設定資料集
    請指定包含自訂除錯階段作業之除錯器指令的有效完整資料集名稱，或按一下 瀏覽 以選取資料集。
    附註: 並非所有指令都允許在遠端除錯階段作業中。 如果這些指令包含在喜好設定資料集中，您可能會在「 除錯主控台 」視圖中看到錯誤。
    EQAOPTS 檔案
    指定包含除錯階段作業之 EQAOPTS 指令的資料集名稱，或按一下 瀏覽 以選取檔案。
    Language Environment 選項
    指定您的程式可能需要的任何其他 Language Environment (LE) 選項。 您可以變更網站容許您置換的任何 Language Environment 選項，但 STACK 選項除外。 此選項不適用於非 CICS ® 設定檔。
    選用: 進階連線選項
    指定這些選項以連接至現行用戶端以外的用戶端，例如遠端控制程式碼涵蓋面，或將除錯階段作業傳送至另一個使用者的用戶端。
    連結到指定用戶端資訊
    選取此選項以強制除錯設定檔使用您指定的連線資訊。 請指定 IP 及埠，或使用者 ID。
    IP
    指定在觸發除錯或程式碼涵蓋面階段作業時要連接的 IP 名稱或位址。
    埠
    指定除錯常駐程式或遠端控制程式碼涵蓋面收集器正在接聽送入階段作業的 TCP/IP 埠。
    使用者 ID
    當 除錯管理程式 在執行中，且您想要將除錯階段作業傳送至另一個使用者的用戶端時，請使用這個選項。 該使用者必須登入 遠端系統瀏覽器。
  4. 按一下編輯器工具列中的 儲存而不啟動 圖示 (「儲存並啟動以進行除錯」圖示) ，以儲存設定檔而不啟動，或按一下編輯器工具列中的 儲存並啟動以進行除錯 圖示 (「儲存並啟動以進行除錯」圖示) 或 儲存並啟動以進行編譯的程式碼涵蓋面 圖示 (「儲存並啟動已完成的程式碼涵蓋面」圖示) ，以儲存並啟動遠端連線上的設定檔。
    (選用) 按 M1 + Sa 儲存而不啟動， M1 + Da 儲存並啟動以進行除錯。 或按 M1 + M2 + Ca 以儲存並啟動程式碼涵蓋面。
    1. M1 在 macOS上是 COMMAND 鍵，在大部分其他平台上是 Ctrl 鍵。 M2 是 SHIFT 鍵。