在 Azure 上設定 Micro Focus CICS BankDemo for Micro Focus Enterprise Developer 4.0

當您在 Azure 上設定 Micro Focus Enterprise Server 4.0 和 Enterprise Developer 4.0 時，您可以測試 IBM z/OS 工作負載的部署。 本文說明如何設定 CICS BankDemo，這是一個隨附於 Enterprise Developer 的應用程式。

CIC 代表客戶資訊控制系統，這是許多線上大型主機應用程式所使用的交易平台。 BankDemo 應用程式非常適合用來學習 Enterprise Server 和 Enterprise Developer 的運作方式，以及如何使用綠色螢幕終端機管理及部署實際應用程式。

必要條件

• 具有 Enterprise Developer 的 VM。 請記住，Enterprise Developer 上面具有完整的 Enterprise Server 執行個體，以供開發和測試之用。 這個執行個體是用於示範的 Enterprise Server 執行個體。

• SQL Server 2017 Express Edition。 下載並且安裝在 Enterprise Developer VM。 Enterprise Server 需要資料庫來管理 CICS 區域，BankDemo 應用程式也會使用稱為 BANKDEMO 的 SQL Server 資料庫。 此示範假設您針對這兩個資料庫使用 SQL Server Express。 安裝時，選取基本安裝。

• SQL Server Management Studio (SSMS)。 SSMS 用於管理資料庫和執行 T-SQL 指令碼。 下載並且安裝在 Enterprise Developer VM。

• Visual Studio 2019 (具有最新的 Service Pack) 或 Visual Studio Community (您可以免費下載)。

• Rumba Desktop 或其他 3270 模擬器。

設定 Windows 環境

在 VM 上安裝 Enterprise Developer 4.0 之後，您必須設定隨附的 Enterprise Server 執行個體。 若要這樣做，您必須安裝一些額外的 Windows 功能，如下所示。

1. 使用 RDP 登入您所建立的 Enterprise Server 4.0 VM。

2. 按一下 [開始] 按鈕旁的 [搜尋] 圖示，然後輸入 Windows 功能。 伺服器管理員 [新增角色與功能精靈] 隨即開啟。

3. 選取 [網頁伺服器 (IIS) 角色]，然後勾選下列選項：

   • Web 管理工具
   • IIS 6 管理相容性 (選取所有可用的功能)
   • IIS 管理主控台
   • IIS 管理指令碼及工具
   • IIS 管理服務

4. 選取 [World Wide Web 服務]，然後勾選下列選項：

   應用程式開發功能：

   • .NET 擴充性
   • ASP.NET
   • 通用 HTTP 功能：新增所有可用的功能
   • 健康情況和診斷：新增所有可用的功能
   • 安全性：
     • 基本驗證
     • Windows 驗證

5. 選取 [Windows 處理序啟用服務] 及其所有子系。

6. 針對 [功能]，請勾選 [Microsoft .NET Framework 3.5.1]，並勾選下列選項：

   • Windows Communication Foundation HTTP 啟用
   • Windows Communication Foundation 非 HTTP 啟用

7. 針對 [功能]，請勾選 [Microsoft .NET Framework 4.6]，並勾選下列選項：

   • 具名管道啟用

   • TCP 啟用

   • TCP 連接埠共用

     

8. 選取所有選項之後，請按 [下一步] 進行安裝。

9. 在 Windows 功能之後，移至 [控制台] > [系統及安全性] > [系統管理工具]，然後選取 [服務]。 向下捲動並確定下列服務正在執行，並設定為 [自動]：

   • NetTcpPortSharing
   • Net.Pipe 接聽程式配接器
   • Net.tcp 接聽程式配接器

10. 若要設定 IIS 和 WAS 支援，請從功能表中找出 Micro Focus Enterprise Developer 命令提示字元 (64 位元)，並以系統管理員身分執行。

11. 輸入 wassetup –i 然後按下 Enter 鍵。

12. 執行指令碼之後，您可以關閉視窗。

設定 SQL Server 的本機系統帳戶

某些 Enterprise Server 程序必須能夠登入 SQL Server 並建立資料庫和其他物件。 這些程序會使用本機系統帳戶，因此您必須將 sysadmin 授權授與該帳戶。

1. 啟動 SSMS，然後按一下 [連線]，以使用 Windows 驗證連線到本機 SQLEXPRESS Server。 應該可在 [伺服器名稱] 清單中取得。

2. 在左側展開 [安全性] 資料夾，然後選取 [登入]。

3. 選取 [NT AUTHORITY\SYSTEM]，然後選取 [屬性]。

4. 選取 [伺服器角色]，然後勾選 [sysadmin]。

   

建立 BankDemo 資料庫及其所有物件

1. 開啟 Windows 檔案總管並且瀏覽至 C:\Users\Public\Documents\Micro Focus\Enterprise Developer\Samples\Mainframe\CICS\DotNet\BankDemo\SQL。

2. 將 BankDemoCreateAll.SQL 檔案的內容複製到剪貼簿中。

3. 開啟 SSMS。 在右側按一下 [伺服器]，然後選取 [新增查詢]。

4. 將剪貼簿的內容貼到 [新增查詢] 方塊中。

5. 從查詢上方的 [命令] 索引標籤按一下 [執行]，以執行 SQL。

查詢應該會執行且沒有任何錯誤。 完成時，您會有 BankDemo 應用程式的範例資料庫。

確認已建立資料庫資料表和物件

1. 以滑鼠右鍵按一下 [BANKDEMO] 資料庫，然後選取 [重新整理]。

2. 展開 [資料庫]，然後選取 [資料表]。 您應該會看到如下的內容。

   

在 Enterprise Developer 中建置應用程式

1. 開啟 Visual Studio 並登入。

2. 在 [檔案] 功能表選項底下，選取 [開啟專案/解決方案]，瀏覽至 C:\Users\Public\Documents\Micro Focus\Enterprise Developer\Samples\Mainframe\CICS\DotNet\BankDemo，然後選取 [sln] 檔案。

3. 花一些時間檢查物件。 COBOL 程式會在方案總管中以 CBL 副檔名以及 CopyBooks (CPY) 和 JCL 顯示。

4. 以滑鼠右鍵按一下 [BankDemo2] 專案，並選取 [設定為啟始專案]。

   注意

   BankDemo 專案會使用 HCOSS (適用於 SQL Server 的主機相容性選項)，這不適用於此示範。

5. 在 [方案總管] 中以滑鼠右鍵按一下 [BankDemo2] 專案，然後選取 [建置]。

   注意

   在解決方案層級建置會導致錯誤，因為尚未設定 HCOSS。

6. 建置專案時，請檢查 [輸出] 視窗。 它應該類似下圖。

   

將 BankDemo 應用程式部署到 Region 資料庫

1. 以系統管理員身分開啟 Enterprise Developer 命令提示字元 (64 位元)。

2. 瀏覽至 %PUBLIC%\Documents\Micro Focus\Enterprise Developer\samples\Mainframe\CICS\DotNet\BankDemo。

3. 在命令提示字元中，執行 bankdemodbdeploy 並包含要部署的資料庫參數，例如：

   bankdemodbdeploy (local)/sqlexpress
   

在 Enterprise Administrator for .NET 中建立 BankDemo 區域

1. 開啟 Enterprise Server for .NET Administration UI。

2. 若要啟動 MMC 嵌入式管理單元，請從 Windows [開始] 功能表選擇[Micro Focus Enterprise Developer] > [組態] > [Enterprise Server for .NET Admin]。(針對 Windows Server，選擇 Micro Focus Enterprise Developer > Enterprise Server for .NET Admin])。

3. 展開左窗格中的 [區域] 容器，然後以滑鼠右鍵按一下 [CICS]。

4. 選取 [定義區域] 以建立名為 BANKDEMO 的新 CICS 區域，此區域裝載於 (本機) 資料庫中。

5. 提供資料庫伺服器執行個體，按 [下一步]，然後輸入區域名稱 BANKDEMO。

   

6. 若要選取跨區域資料庫的區域定義檔案，請在 C:\Users\Public\Documents\Micro Focus\Enterprise Developer\Samples\Mainframe\CICS\DotNet\BankDemo 中找到 region_bankdemo_db.config。

   

7. 按一下完成。

建立 XA 資源定義

1. 在 [Enterprise Server for .NET Administration] UI 的左窗格中，展開 [系統]，然後展開[XA 資源定義]。 此設定會定義區域如何與 Enterprise Server 和應用程式資料庫交互操作。

2. 以滑鼠右鍵按一下 [XA 資源定義]，然後選取 [新增伺服器執行個體]。

3. 在下拉式方塊中，選取 [資料庫服務執行個體]。 這會是本機電腦 SQLEXPRESS。

4. 從 XA 資源定義 (machinename\sqlexpress) 容器底下選取執行個體，然後按一下 [新增]。

5. 選取 [資料庫 XA 資源定義]，然後針對[名稱] 和 [區域] 輸入 BANKDEMO。

   

6. 按一下省略符號 (...) 以顯示連接字串精靈。 針對 [伺服器名稱]，輸入 (local)\SQLEXPRESS。 針對 [登入]，選取 [Windows 驗證]。 針對資料庫名稱，輸入 BANKDEMO

   

7. 測試連線。

啟動 BANKDEMO 區域

1. 瀏覽至 [區域容器] 底下的 [BANDEMO CICS 區域]，然後從 [動作] 窗格中選取 [編輯區域啟動檔案]。 向下捲動至 SQL 屬性，然後針對 [XA 資源名稱] 輸入 bankdemo，或使用省略符號來選取。

2. 按一下 [儲存] 圖示以儲存變更。

3. 以滑鼠右鍵按一下 [主控台] 窗格中的 [BANKDEMO CICS 區域]，然後選取[啟動/停止區域]。

4. 在中間窗格中出現的 [啟動/停止區域] 方塊底部，選取 [啟動]。 幾秒鐘之後，區域就會啟動。

   

   

建立接聽程式

建立可存取 BankDemo 應用程式的 TN3270 工作階段接聽程式。

1. 在左窗格中，展開 [組態編輯器]，然後選取 [接聽程式]。

2. 按一下 [開啟檔案] 圖示，然後選取 [seelistener.exe.config] 檔案。 每次 Enterprise Server 啟動時，都會編輯並載入此檔案。

3. 請注意先前定義的兩個區域 (ESDEMO 和 JCLDEMO)。

4. 若要建立 BANKDEMO 的新區域，請以滑鼠右鍵按一下 [區域]，然後選取 [新增區域]。

5. 選取 [BANKDEMO 區域]。

6. 以滑鼠右鍵按一下 [BANKDEMO 區域] 並選取 [新增通道]，以新增 TN3270 通道。

7. 針對 [名稱]，輸入 TN3270。 針對 [連接埠]，輸入 9024。 ESDEMO 應用程式使用連接埠 9230，因此您必須使用不同的連接埠。

8. 若要儲存檔案，請按一下 [儲存] 圖示，或選擇 [檔案] > [儲存]。

9. 若要啟動接聽程式，請按一下 [啟動接聽程式] 圖示，或選擇 [選項] > [啟動接聽程式]。

   

設定 Rumba 以存取 BankDemo 應用程式

您需要執行的最後一件事是使用 Rumba (3270 模擬器) 來設定 3270 工作階段。 此步驟可讓您透過您所建立的接聽程式存取 BankDemo 應用程式。

1. 從 Windows [開始] 功能表啟動 Rumba Desktop。

2. 在 [連線] 功能表項目下，選取 [TN3270]。

3. 針對 IP 位址按一下 [插入]，然後輸入 127.0.0.1，然後針對使用者定義的連接埠輸入 9024。

4. 按一下對話方塊底部的 [連線]。 此時會出現黑色 CICS 畫面。

5. 輸入 bank 以顯示 BankDemo 應用程式的初始 3270 畫面。

6. 針對使用者識別碼輸入 B0001，針對密碼輸入任何項目。 第一個畫面 BANK20 隨即開啟。

恭喜！ 您現在可以使用 Micro Focus Enterprise Server 在 Azure 中執行 CICS 應用程式。

下一步

• 在 Azure 上的 Docker 容器執行 Enterprise Server
• 大型主機移轉 - 入口網站
• 虛擬機器
• 疑難排解