將大型主機資料封存至 Cloud Storage

本頁說明如何使用 Mainframe Connector，將大型主機資料封存及還原至 Cloud Storage。

事前準備

• 開始使用 Mainframe Connector
• 在大型主機上安裝 Mainframe Connector

將大型主機檔案封存至 Cloud Storage

如要將大型主機的檔案封存至 Cloud Storage，請按照下列步驟操作：

1. 建立儲存空間 bucket 來存放封存檔案。建立值區時，請務必選擇「封存」儲存空間級別。

2. 您可以將大型主機二進位資料原封不動地封存到 Cloud Storage bucket。如要執行這項操作，請使用 scp 指令，如下所示：

   scp --inDD=INPUT_DD
   --gcsOutUri=URI
   --encoding=ENCODING
   –-noConvert

   更改下列內容：

   • INPUT_DD:要複製的資料定義 (DD) 檔案。預設值為 DD INFILE。
   • URI:：要複製檔案的目的地 Cloud Storage 統一資源 ID (URI)。
   • ENCODING: 輸入字元編碼。預設值為 CP037。
   注意： 您也可以使用 qsam decode 指令，將大型主機二進位資料轉換為 ORC、CSV 或 JSON 檔案，並儲存到 Cloud Storage 值區。

將 Cloud Storage 中的檔案還原至大型主機

您可以使用 gsutil cp 指令，將檔案從 Cloud Storage 還原至大型主機資料集。請注意，您無法複製分割資料集 (PDS)。

注意： 您只能使用 gsutil cp 指令，還原以原始格式封存的大型主機二進位資料 (未轉換為任何其他檔案格式)。Mainframe Connector 不支援還原轉換為其他檔案格式的大型主機資料。

如要將檔案從 Cloud Storage 還原至大型主機資料集，請按照下列步驟操作：

1. 在 JCL 中指定要下載至大型主機的檔案 DSN 和空間需求。在下列範例中，輸出檔案的記錄格式 (RECFM) 為 FB。修改 OUTFILE DD 以符合您的需求。

   //OUTFILE  DD DSN=MAINFRAME.DSN.FILE,DISP=(,CATLG),
   //            RECFM=FB,DSORG=PS,
   //            SPACE=(10,(2,1),RLSE),
   //            AVGREC=M,
   //            UNIT=SYSDA
   //SYSPRINT DD SYSOUT=*
   //SYSDUMP  DD SYSOUT=*
   //STDIN DD *
   

2. 以以下格式執行 gsutil cp 指令。如果檔案已存在於大型主機上，請務必在指令中新增 --replace 旗標。

   gsutil cp GCS_URI DSN --recfm=RECFM --lrecl=LRECL --blksize=BLKSIZE --noseek
   

   更改下列內容：

   • GCS_URI：Cloud Storage 檔案的 Cloud Storage URI。例如：gs://bucket/sample.mainframe.dsn。
   • DSN：主機上的 DSN 目的地位置。
   • RECFM：大型主機檔案的記錄格式 (RECFM)。有效值為 F、FB 和 U。請注意，這些值不區分大小寫。
   • LRECL：(選填) 檔案的記錄長度 (LRECL)。值必須是整數，且 >= 0。如果未指定 LRECL，系統會假設檔案採用未定義長度的記錄格式 (U)。
   • BLKSIZE：(選用) 檔案的區塊大小。如果設為 0，系統會決定最佳的區塊大小。值必須是整數，且 >= 0。如果未指定值，系統會將檔案視為未封鎖的檔案。
   • noseek：(選用) 如要提升下載效能，請加入此參數。這項標記預設為 false，也就是啟用搜尋作業。