[z/OS]

建立 MFT 代理程式或日誌程式指令資料集

您可以從特定 Managed File Transfer AgentManaged File Transfer LoggerManaged File Transfer 指令範本資料集建立 PDSE 指令資料集,以進行特定協調。

關於此作業

請完成下列步驟:

程序

  1. 複製 MFT 指令範本 PDSE 程式庫資料集 SBFGCMDS。
    [z/OS]SBFGCMDS 必須複製到新的程式庫,例如 prefix.agent.JCL_。 進行下列取代作業時,您可以使用經過更新的 SBFGCMDS(BFGCOPY) 成員:
    • ++supplied-library++ 取代為 SBFGCMDS PDSE 的完整名稱。
    • [z/OS]+ + service-library + + 取代為新 MFT 指令 PDSE 程式庫資料集的完整名稱。 ++service-library++ 是建立的代理程式或日誌程式服務的輸出資料集。
  2. 若為新的 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 會定義所有額外需要的自訂環境變數。

  3. 針對新的 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 中定義的任何內容進行更新。