轉碼溢出資料集

自 5.16.0 版起，Mainframe 連接器會建立一張表格，使用 qsam decode 和 qsam encode 指令記錄轉碼程序期間遇到的所有錯誤。這個表格稱為溢出資料集。溢出資料集輸出格式可為下列任一格式：

• 經過最佳化處理的資料列資料欄 (ORC) 檔案
• 佇列式順序存取方法 (QSAM) 檔案

您可以利用這些資訊來稽核或偵錯轉碼程序。

由 qsam decode 建立的溢出資料集

在解碼程序中，qsam decode 指令會建立溢出資料集，並使用下列結構定義。

欄位名稱	類型	說明
列	number	發生錯誤的記錄編號。第一筆記錄是記錄 1。如果無法取得記錄編號，系統會使用 -1。
欄位	string	無法解碼的欄位完整名稱。
錯誤	string	導致記錄解碼失敗的錯誤。
錄製	bytes	整筆記錄。

由 qsam encode 建立的溢出資料集

在編碼程序中，qsam encode 指令會建立溢出資料集，並使用以下結構定義。針對 QSAM 檔案，建議您使用變數記錄長度至少為 1024 的檔案。

欄位名稱	類型	說明
列	number	發生錯誤的記錄編號。第一筆記錄是記錄 1。部分編碼來源可能無法提供一致的資料列號碼。在這種情況下，該列為 -1。
欄位	string	無法編碼的欄位完整名稱。
錯誤	string	導致記錄編碼失敗的錯誤。
錄製	string	整個記錄以 JSON 編碼。