![[z/OS]](ngzos.gif)
建立 MFT 代理程式或日誌程式指令資料集
您可以從特定 Managed File Transfer Agent 或 Managed File Transfer Logger 的 Managed File Transfer 指令範本資料集建立 PDSE 指令資料集,以進行特定協調。
關於此作業
請完成下列步驟:
程序
- 複製 MFT 指令範本 PDSE 程式庫資料集 SBFGCMDS。
SBFGCMDS 必須複製到新的程式庫,例如 prefix.agent.JCL_。 進行下列取代作業時,您可以使用經過更新的 SBFGCMDS(BFGCOPY) 成員:- 將 ++supplied-library++ 取代為 SBFGCMDS PDSE 的完整名稱。
將 + + service-library + + 取代為新 MFT 指令 PDSE 程式庫資料集的完整名稱。 ++service-library++ 是建立的代理程式或日誌程式服務的輸出資料集。
- 若為新的 MFT 指令 PDSE 程式庫資料集,請編輯成員 BFGCUSTM ,這是用來為代理程式或日誌程式自訂指令的 JCL Script。 每一個變數都會以 ++variable name++ 的格式指定,您必須將其取代為必要值。 如需各種 JCL 變數的說明,請參閱 z/OS JCL 變數。 BFGSTDIN DD 陳述式會定義三個種類的變數:Variables、Properties 及 Environment。 陳述式會採用下列格式:
[Variables] variable1=value1 variable2=value2 .... variableN=valueN [Properties] property1=property value1 property2=property value2 ... propertyN=property valueN [Environment] custom_variable1=value1 custom_variable2=value2 .... custom_variableN=valueN變數會定義每一個指令所需的一組設定及環境變數。
內容定義會置換 MFT 配置內容。 您可以視需要新增代理程式或日誌程式內容,為您的環境自訂代理程式或日誌程式。 如需所有內容的清單,請參閱 配置內容檔。 提供此機能是為了節省存取 MFT 配置內容檔的權限,這些檔案作為「 UNIX® 系統服務」檔案進行維護。
Environment 會定義所有額外需要的自訂環境變數。
- 針對新的 MFT 指令 PDSE 程式庫資料集提交工作 BFGCUSTM。 此工作會產生適用於代理程式或日誌程式的 JCL 指令集,作為 PDSE 的新成員。 如需指令的完整清單,請參閱 z/OS 代理程式及日誌程式指令 JCL Script。
工作 BFGCUSTM 會對包括 DISP=OLD 之 DD 陳述式的 JCL 所在的程式庫進行更新。 您必須在提交之後結束編輯器,讓工作執行。
請檢查輸出工作日誌,以確認 JCL Script 已順利執行。 如果執行失敗,請予以更正,然後重新提交 BFGCUSTM 工作。
BFGCUSTM JCL Script 也會視需要更新「 UNIX 系統服務 MFT 」配置內容檔,以讓檔案保持同步。 如果 CoordinationQMgr 內容定義的配置不存在,則會輸出警告訊息,而且您必須執行產生的 BFGCFCR 和 BFGCMCR 工作,才能建立配置內容檔。 必須針對代理程式執行 BFGAGCR,而針對日誌程式編輯執行 BFGLGCRS。 如果指定的配置已存在,該配置將會以 BFTCUSTM JCL Script 中定義的任何內容進行更新。