使用 BAC

由於 BAC 是安全的，並提供根據使用者角色使用功能的許可，因此存取應用程式的第一步是自行驗證。在身分驗證步驟之後，系統會將您重新導向至首頁。首頁會顯示Blusam儲存體中找到的資料集分頁清單：

若要使用資料集清單返回首頁，請選擇應用程式任何頁面左上角的AWS Transform for mainframe標誌。下圖顯示標誌。

標記為「Blusam組態」的可摺疊標頭包含使用Blusam儲存組態的相關資訊：

Persistence：持久性儲存引擎 (PostgreSQL)
Cache Enabled：是否啟用儲存快取

在標頭的右側，有兩個下拉式清單，每個清單都會列出與資料集相關的操作：

大量動作
建立動作

若要了解這些清單的詳細內容，請參閱現有的資料集操作。

未進行任何資料集選取時，會停用大量動作按鈕。

您可以使用搜尋欄位，根據資料集名稱將清單建檔：

顯示 KSDS 資料集的搜尋欄位和資料表，其中包含索引鍵、記錄和日期等詳細資訊。

以下分頁清單顯示每個資料表資料列一個資料集，其中包含下列資料欄：

選取核取方塊：選取目前資料集的核取方塊。
名稱：資料集的名稱。
類型：資料集的類型，下列其中一項：
- KSDS
- ESDS
- RRDS
金鑰：顯示或隱藏金鑰詳細資訊的連結（如果有的話）。例如，指定的 KSDS 具有強制性主索引鍵和一個替代索引鍵。

每個金鑰有一個資料列，其中包含下列資料欄。所有欄位都無法編輯。
- 金鑰性質：主金鑰或替代金鑰
- 名稱：金鑰的名稱
- 唯一：金鑰是否接受重複的項目
- 位移：記錄中索引鍵開始的位移
- 長度：記錄中金鑰部分的位元組長度
記錄：資料集中的記錄總數。
記錄大小上限：記錄的大小上限，以位元組表示。
固定記錄長度：核取方塊，指出記錄是固定長度（已選取）還是變數長度（未選取）。
壓縮：核取方塊，指出壓縮是否套用（選取）至已儲存的索引（未選取）。
建立日期：在Blusam儲存體中建立資料集的日期。
上次修改日期：上次在Blusam儲存中更新資料集的日期。
快取：顯示或隱藏套用至此資料集之快取策略詳細資訊的連結。
- 在啟動時啟用快取：用於指定此資料集啟動快取策略的核取方塊。如果選取，資料集會在啟動時載入快取。
- 暖機快取：將指定資料集載入快取的按鈕，立即開始（但補充快取需要一些時間，取決於資料集大小和金鑰數量）。將資料集載入快取後，會出現類似下列的通知。
動作：可能資料集操作的下拉式清單。如需詳細資訊，請參閱現有的資料集操作。

在頁面底部，有一個一般分頁導覽小工具，用於瀏覽資料集清單的頁面。

現有的資料集操作

對於分頁清單中的每個資料集，有一個動作下拉式清單，其中包含下列內容：

清單中的每個項目都是作用中連結，可讓您對資料集執行指定的動作：

讀取：瀏覽資料集中的記錄
載入：從舊版資料集檔案匯入記錄
匯出：將記錄匯出至一般檔案（與舊版系統相容）
清除：從資料集中移除所有記錄
刪除：從儲存體移除資料集

以下各節提供每個動作的詳細資訊。

從資料集瀏覽記錄

當您為指定的資料集選擇讀取動作時，您會得到以下頁面。

Blusam 管理主控台顯示具有篩選條件選項和空白資料表的 dataset AWS .M2.CARDDEMO.CARDDATA.VSAM.KSDS。

頁面是由以下組成：

標頭，具有：
- 資料集：資料集名稱
- 記錄大小：固定記錄長度，以位元組表示
- 記錄總數：為此資料集儲存的記錄總數
- 顯示組態按鈕（右側）：顯示/隱藏資料集組態的切換按鈕。一開始，組態會隱藏。使用按鈕時，您會看到組態的組態，如下圖所示。
  
  顯示組態時，兩個新按鈕：儲存和重設，分別用於：
  - 儲存此資料集和目前工作工作階段的組態
  - 將所有欄位的組態重設為預設值。
- 可設定屬性清單，以量身打造指定資料集的瀏覽體驗。

可設定的屬性符合中所述的組態屬性BAC 專用組態檔案。請參閱該章節以了解每個資料欄和適用值的意義。您可以在這裡為資料集重新定義每個值，並為工作工作階段儲存（使用儲存按鈕）。儲存組態後，會出現類似下圖所示的橫幅。

橫幅指出當您離開目前頁面時，工作工作階段會結束。

有一個額外的可設定屬性，未記錄在組態區段中：記錄大小。這用於指定指定的記錄大小，以位元組表示，這會篩選此資料集適用的遮罩：只有總長度符合指定記錄大小的遮罩才會列在資料遮罩下拉式清單中。

從資料集擷取記錄是由搜尋按鈕觸發，使用附近的所有選項和篩選條件。

第一行選項：

資料遮罩下拉式清單會顯示適用的遮罩（遵守記錄大小）。請注意，比對記錄大小不足以成為有效的適用遮罩。遮罩定義也必須與記錄內容相容。此處選擇的資料遮罩具有
最大結果：限制搜尋擷取的記錄數量。資料集的無限制（分頁）結果設為 0。
搜尋按鈕：使用篩選條件和選項啟動記錄擷取
清除遮罩按鈕：如果有的話，將清除使用過的遮罩，並將結果頁面切換回原始金鑰/資料呈現。
清除篩選條件按鈕：將清除使用過的篩選條件（如果有的話），並相應地更新結果頁面。
所有欄位切換：選取時，無論如何skip = true都會顯示使用定義的遮罩項目，否則skip = true會隱藏使用的遮罩項目。

下一行篩選條件：可以根據從指定遮罩套用至欄位（資料欄）的篩選條件使用情況來定義篩選條件清單，如下圖所示。

篩選遮罩：要從中挑選篩選資料欄的遮罩名稱。當您選擇欄位時，會顯示適用的遮罩清單。您可以從該清單中選擇您想要的遮罩。
篩選欄：遮罩中的欄位名稱（欄），用於篩選記錄。當您選擇欄位時，會出現遮罩資料欄清單。若要填入篩選條件資料欄欄位，請選擇所需的儲存格。
篩選條件運算子：要套用至所選資料欄的運算子。下列運算子可供使用。
- 等於：記錄的資料欄值必須等於篩選條件值
- 開頭為：記錄的資料欄值必須以篩選條件值開頭
- 結尾為：記錄的資料欄值必須以篩選條件值結尾
- 包含：記錄的資料欄值必須包含篩選條件值
篩選條件選項：
- 反向：套用篩選條件運算子的反向條件；例如，「等於」被「不等於」取代；
- 忽略大小寫：忽略篩選條件運算子的英數字元比較大小寫
篩選條件值：篩選條件運算子與篩選條件資料欄用於比較的值。

設定最少數量的篩選條件項目後（至少必須設定篩選條件遮罩、篩選條件欄、篩選條件運算子和篩選條件值），即會啟用新增篩選條件按鈕，然後按一下該按鈕會在擷取的記錄上建立新的篩選條件。在頂端新增另一個空白篩選條件列，而新增的篩選條件具有移除篩選條件按鈕，可用於隱藏指定的篩選條件：

當您啟動搜尋時，篩選的結果會出現在分頁資料表中。

注意

和或會連結後續篩選條件。每個新的篩選條件定義都從設定連結運算子開始，如下圖所示。
可能沒有任何記錄符合指定的篩選條件。

否則，結果資料表看起來如下圖所示。

標頭表示符合篩選條件的記錄總數。在標頭之後，您會看到以下內容。

提醒已使用的資料遮罩（如果有的話）和篩選條件。
重新整理按鈕，可用來觸發整個結果資料表的重新整理，其中包含來自Blusam儲存體的最新值（因為它可能已由其他使用者更新，例如）。

對於每個擷取的記錄，資料表都有一列，顯示將資料遮罩套用至記錄內容的結果。每個資料欄都是根據資料欄類型（以及使用選取的編碼）對記錄子部分的解釋。每一列左側有三個按鈕：

放大鏡按鈕：會導向顯示詳細記錄內容的專用頁面
筆按鈕：會導向記錄內容的專用編輯頁面：
垃圾桶按鈕：用於從 blusam 儲存中刪除指定的記錄

詳細檢視記錄的內容：

三個切換按鈕，用於隱藏或顯示一些資料欄：
- 隱藏/顯示類型
- 隱藏/顯示顯示旗標
- 隱藏/顯示範圍
若要離開此專用頁面並返回結果資料表，請選擇關閉。
每一列代表資料遮罩中的資料欄，其中包含下列資料欄：
- 名稱：資料欄的名稱
- 類型：資料欄的類型
- 顯示：顯示指示器；如果使用定義相符的遮罩項目，則會顯示綠色檢查skip = false，否則會顯示紅色交叉
- 從 & 到：記錄子部分的 0 型範圍
- 值：記錄子部分的解譯值，使用類型和編碼

編輯記錄的內容：

編輯頁面類似於上述檢視頁面，但遮罩項目值是可編輯的。三個按鈕控制更新程序：

重設：將可編輯的值重設為初始記錄值（在任何版本之前）；
驗證：驗證有關遮罩項目類型的輸入。對於每個遮罩項目，將使用視覺化標籤列印驗證結果 (OK如果驗證成功，則為核取方塊，如果驗證失敗，則為ERROR紅色交叉，以及提供驗證失敗提示的錯誤訊息）。如果驗證成功，將顯示兩個新按鈕：
- 儲存：嘗試將現有記錄更新為Blusam儲存體
- 儲存副本：嘗試在Blusam儲存體中建立新的記錄
- 如果成功將記錄儲存到儲存體，則會顯示訊息，且頁面會切換至唯讀模式（無法再編輯遮罩項目值）：
- 如果記錄因任何原因持續儲存失敗，則錯誤訊息會以紅色顯示，並提供失敗原因。最常見的失敗案例是，儲存記錄會導致金鑰損毀（無效或重複的金鑰）。如需圖例，請參閱下列備註。
- 若要結束，請選擇關閉按鈕。
取消：結束編輯工作階段、關閉頁面，並帶您返回記錄清單頁面。

請注意：

驗證機制只會檢查遮罩項目值是否正式相容於遮罩項目類型。例如，請參閱對數值遮罩項目的失敗驗證：
驗證機制可能會嘗試自動更正無效輸入，以藍色顯示資訊性訊息，指出值已根據其類型自動更正。例如，輸入 7XX0 做為數值fd_trncat_cd遮罩項目中的數值：

呼叫驗證會導致下列情況：
驗證機制不會檢查指定值在金鑰完整性方面是否有效（如果指定資料集涉及任何唯一金鑰）。例如，儘管驗證成功，如果提供的值導致無效或重複的金鑰情況，持久性將會失敗，並顯示錯誤訊息：

刪除記錄：

若要刪除記錄，請選擇垃圾桶按鈕：

將記錄載入資料集

若要將記錄載入資料集，請選擇動作，然後選擇載入。

出現具有載入選項的視窗。

一開始，伺服器負載和藍上負載按鈕都會停用。

讀取參數：

記錄長度類型：
- 固定或可變記錄長度：使用選項按鈕指定舊版資料集匯出是否使用固定長度記錄或可變長度記錄（記錄預期以 RDW 位元組開頭）。如果您選擇固定，則必須在輸入欄位中將記錄長度指定為正整數值（以位元組為單位）。值應該由來自資料集的資訊預先填入。如果您選擇變數，則指定的輸入欄位會消失。
- 檔案選取：
  - 本機：使用下面的檔案選擇器，從本機電腦選擇資料集檔案（注意：檔案選擇器使用瀏覽器的地區設定來列印其訊息 -- 此處為法文，但在您的端上可能看起來不同，這是預期的）。進行選取後，系統會使用資料檔案名稱更新視窗，並啟用在伺服器上載入按鈕：
    
    選擇在伺服器上載入。進度列結束之後，Load on Blusam 按鈕就會啟用：
    
    若要完成對Blusam儲存體的載入程序，請選擇 Load on Blusam。否則，請選擇 Cancel (取消)。如果您選擇繼續載入程序，載入程序完成後，右下角會顯示通知：
  - 伺服器：選擇此選項會在伺服器上載入按鈕消失時顯示輸入欄位。輸入欄位是您必須在Blusam伺服器上指定資料集檔案的路徑（假設您已先將指定檔案傳輸至Blusam伺服器）。指定路徑後，Load on Blusam 會啟用：
    
    若要完成載入程序，請選擇 Load on Blusam。否則，請選擇 Cancel (取消)。如果您選擇繼續載入，載入程序完成後會出現通知。通知與瀏覽器的負載不同，因為它會顯示資料檔案伺服器路徑，後面接著伺服器的字詞：
    
    $成功通知顯示來自伺服器的檔案路徑 C：\Work\Cobot\cartdemo-main\data\carbxref.txt。$

從資料集匯出記錄

若要匯出資料集記錄，請選擇目前資料集列中的動作，然後選擇匯出：

出現下列快顯視窗。

選項：

若要：選項按鈕選擇，以選擇匯出目的地，無論是在瀏覽器 (本機（在瀏覽器上）) 中下載，或是託管 BAC 應用程式之伺服器上的特定資料夾。如果您選擇使用伺服器選擇匯出，則會顯示新的輸入欄位：

如輸入欄位右側的紅色星號所示，您必須在伺服器上提供有效的資料夾位置（傾印按鈕會在未提供資料夾位置時處於非作用中狀態）。

若要匯出至伺服器，如果您打算在匯出後操作匯出的資料集檔案，您必須擁有伺服器檔案系統的足夠存取權。

壓縮傾印：產生壓縮封存而非原始檔案的核取方塊。

選項：若要在變數長度記錄資料集的情況下，在匯出的資料集的每個記錄開頭包含記錄描述詞 (RDW)，請選擇包含 RDW 欄位。

若要啟動資料集匯出程序，請選擇傾印。如果您選擇匯出至瀏覽器，請檢查匯出資料集檔案的下載資料夾。檔案將具有與資料集相同的名稱：

檔案總管會顯示以 name AWS .M2.CARDDEMO.CARDXREF.VSAM.KSDS 匯出的 KSDS 檔案。

請注意：

對於 KSDS，記錄將按照主索引鍵順序匯出。
對於 ESDS 和 RRDS，記錄將按照 RBA （相對位元組地址）順序匯出。
對於所有資料集類型，記錄都會匯出為原始二進位陣列（不會進行任何種類轉換），以確保與舊版平台的直接相容性。

從資料集清除記錄

若要清除資料集中的所有記錄，請選擇動作，然後選擇清除：

從資料集移除所有記錄後，會出現下列通知。

刪除資料集

若要刪除資料集，請選擇動作，然後選擇刪除：

刪除資料集後，會出現下列通知：

大量操作

資料集有三種大量操作可用：

Export (匯出)
Clear
刪除

大量操作只能套用至資料集的選擇（至少需要選取一個資料集）；選取資料集是透過資料集清單資料表左側的勾選選擇核取方塊來完成。選取至少一個資料集將啟用大量動作下拉式清單：

除了特定動作適用於所選資料集而非單一資料集之外，這些動作與上述動作類似，如需詳細資訊，請參閱專用動作文件。快顯視窗文字內容將略有不同，以反映大量性質。例如，嘗試刪除數個資料集時，快顯視窗會如下所示：

建立操作

建立單一資料集

選擇動作，然後選擇建立單一資料集：

然後，資料集建立表單將顯示為快顯視窗：

資料集建立表單，其中包含 DataSet 名稱、記錄大小上限、DataSet 類型和選項的欄位。

您可以為資料集定義指定下列屬性：

啟用和停用命名規則：使用「停用命名規則/啟用命名規則」切換小工具來停用和啟用資料集命名慣例。我們建議您將切換保留在預設值上，並啟用資料集命名規則（切換小工具應顯示「停用命名規則」)：
資料集名稱：資料集的名稱。如果您指定的名稱已在使用中，則會出現下列錯誤訊息。

如果已啟用，名稱也必須遵守命名慣例：
記錄大小上限：這必須是正整數，代表具有固定長度記錄之資料集的記錄大小。對於具有可變長度記錄的資料集，您可以將其保留空白。
固定長度記錄：指定記錄長度為固定或變數的核取方塊。如果選取，資料集將具有固定長度的記錄，否則記錄長度將是可變的。

當您將舊版資料匯入變數長度記錄資料集時，提供的舊版記錄必須包含記錄描述項 (RDW)，以提供每個記錄的長度。
資料集類型：用於指定目前資料集類型的下拉式清單。支援下列類型。
- ESDS
- LargeESDS
- KSDS
對於 KSDS，您必須指定主索引鍵：

針對主索引鍵，指定下列項目：
- 名稱：此欄位為選用。預設值為 PK。
- 位移：記錄中主索引鍵以 0 為基礎的位移。位移必須是正整數。此欄位為必填。
- 長度：主索引鍵的長度。此長度必須是正整數。此欄位為必填。
對於 KSDS 和 ESDS，您可以選擇選擇備用金鑰標籤前面的加號按鈕來定義備用金鑰的集合。每次選擇該按鈕時，新的備用金鑰定義區段會出現在資料集建立表單中：

對於每個備用金鑰，您需要提供：
- 名稱：此欄位為選用。預設值為 ALTK_#，其中 # 代表從 0 開始的自動遞增計數器。
- 位移：記錄中替代索引鍵的以 0 為基礎的位移。必須為正整數。此欄位為必填。
- 長度：替代索引鍵的長度。此長度必須是正整數。此欄位為必填。
- 唯一：指出替代金鑰是否接受重複項目的核取方塊。如果選取，備用金鑰將定義為唯一（不接受重複的金鑰項目）。此欄位為必填。
若要移除備用金鑰定義，請使用左側的垃圾桶按鈕。
壓縮：用於指定是否使用壓縮來存放資料集的核取方塊。
在啟動時啟用快取：核取方塊，指定是否應在應用程式啟動時將資料集載入快取。

指定屬性定義後，請選擇建立以繼續：

建立視窗將會關閉，並顯示顯示資料集清單的首頁。您可以檢視新建立資料集的詳細資訊。

在多結構描述模式中建立單一資料集

您可以在多結構描述模式中建立資料集，方法是在資料集名稱前面加上結構描述名稱，後面接著管道 (|) 符號（例如，schema1|AWS.M2.CARDDEMO.ACCTDATA.VSAM.KSDS)。

注意

用於建立資料集的結構描述應在application-main.yml組態中指定。如需詳細資訊，請參閱多結構描述組態屬性。

如果未提供結構描述字首，則會在Blusam資料來源組態的Blusam資料來源 URL 中指定的預設結構描述中建立資料集。如果Blusam資料來源 URL 中未指定結構描述，則預設會使用 'public' 結構描述。

注意

在多結構描述模式中，BAC 主控台會在第一欄中顯示資料集的結構描述資訊。

從 LISTCAT 建立資料集

此功能可讓您利用在 AWS 轉換期間為大型主機轉換程序使用 AWS 轉換為大型主機重構轉換中心建立的 LISTCAT JSON 檔案，因為剖析來自舊版平台的 LISTCAT 匯出：LISTCAT 匯出會剖析並轉換為包含資料集定義的 JSON 檔案（名稱、資料集類型、金鑰定義，以及記錄長度是固定的還是可變的）。

擁有 LISTCAT JSON 檔案可讓您直接建立資料集，而不必手動輸入資料集所需的所有資訊。您也可以直接建立資料集的集合，而不必逐一建立資料集。

如果您的專案沒有可用的 LISTCAT JON 檔案（例如，因為轉換時沒有可用的 LISTCAT 匯出檔案），只要您遵守附錄中詳述的 LISTCAT JSON 格式，您一律可以手動建立一個。

從建立動作下拉式清單中，選擇從 LISTCAT 建立資料集。

將顯示以下專用頁面：

在此階段，載入按鈕已停用，這是預期的。

使用選項按鈕指定您要如何提供 LISTCAT JSON 檔案。您有兩個選項：

您可以使用瀏覽器上傳 JSON 檔案。
您可以從伺服器上的資料夾位置選取 JSON 檔案。若要選擇此選項，您必須先將 JSON 檔案複製到伺服器上具有適當存取權限的指定資料夾路徑。

在伺服器上使用 JSON 檔案

在伺服器上設定資料夾路徑，指向包含 LISTCAT JSON 檔案的資料夾：
選擇載入按鈕。所有辨識到的資料集定義都會列在資料表中：

每一列代表資料集定義。您可以使用垃圾桶按鈕從清單中移除資料集定義。

重要
從清單中移除是立即的，沒有警告訊息。
左側的名稱是連結。您可以選擇它來顯示或隱藏資料集定義的詳細資訊，這是可編輯的。您可以自由修改定義，從剖析的 JSON 檔案開始。
若要建立所有資料集，請選擇建立。將建立所有資料集，並將顯示在資料集結果頁面上。新建立的資料集都會有 0 筆記錄。