建立連結檔和綱目檔,以便與 z/OS Connect 搭配使用

藉由 z/OS Connect,您能夠選擇性地轉換要求和回應有效負載,以用於呼叫 z/OS 作業系統上的商業資產。z/OS Connect 提供兩個新的公用程式,稱為 BBGLS2JS 和 BBGJS2LS。

開始之前

建立連結檔和綱目檔之前,請確定您的設定符合下列前置條件:
  • 您的高階語言資料結構必須符合下列準則:
    • 資料結構必須與來源程式分開定義;例如,定義在 COBOL 記錄定義檔中。
    • 如果 PL/I 或 COBOL 應用程式針對輸入及輸出使用不同的資料結構,必須將這些資料結構定義在分割資料集的兩個不同成員中。如果輸入及輸出使用相同的結構,必須將該結構定義在單一成員中。
    • 若為 C 和 C++,您的資料結構可以位於分割資料集的相同成員中。
  • 分割資料集中必須有可用的語言結構。
  • 您必須將 BBGLS2JS 或 BBGJS2LS 用來執行的使用者 ID,定義給「開放式多重虛擬儲存體 (OMVS)」。
  • 使用者 ID 對 z/OS® UNIX 和 PDS 程式庫必須具備讀取權,且對 LOGFILE、WSBIND,以及 JSON-SCHEMA-REQUEST 和 JSON-SCHEMA-RESPONSE 輸出參數所指定的目錄必須具備寫入權。
  • 使用者 ID 必須有夠大的儲存體配置來執行 Java™。您可以使用任何支援的 Java 版本。依預設,BBGLS2JS/BBGJS2LS 公用程式會使用 USS 環境中的 JAVA_HOME 所指定的 Java 版本。否則,ID 會使用 PATH 陳述式中所指定的 Java 版本。

關於這項作業

BBGLS2JS 公用程式會讀取 COBOL 記錄定義檔、PLI 或 C 結構檔案,並產生一個連結檔和 JSON 綱目檔。BBGJS2LS 公用程式會讀取 JSON 綱目,並產生對應的連結檔和語言結構檔 (COBOL 記錄定義檔、PL/I 或 C 結構標頭檔)。這些公用程式類似於現有的 DFHLS2JS 和 DFHJS2LS 工具,這些工具是 CICS Transaction Server Mobile Extensions 特性套件的一部分。儘管輸入參數相同,但是符號參數並不同。

程序

  1. 取得 BBGLS2JS JCL 程序。 BBGLS2JS 和 BBGJS2LS JCL 程序可在 GitHub 上找到。如需如何使用 JCL 的相關資訊,請參閱 GitHub 上的 Readme 檔。您需要將 JCL 程序從這個位置,複製到您 z/OS 系統上 JCL 程序庫中名稱為 BBGLS2JS 的成員中。
  2. 利用 BBGLS2JS 程序,從語言結構產生一個 z/OS Connect 服務連結檔。 您需要提供 JCL,以使用輸入參數來呼叫 BBGLS2JS 程序。如需輸入參數以及可協助您使用程序之範例工作的相關資訊,請參閱 BBGLS2JS 參考文件。在您提交 BBGLS2JS 程序時,公用程式會在您使用 WSBIND 參數指定的位置中,產生服務連結檔。所產生的 JSON 綱目會放在您使用 JSON-SCHEMA-REQUEST 和 JSON-SCHEMA-RESPONSE 參數指定的位置中。
  3. 檢閱產生的 JSON 綱目。 這些綱目用來定義輸入及輸出資料格式,以便與 z/OS Connect 服務互動。應用程式開發人員在建立應用程式來呼叫服務及傳遞 JSON 要求有效負載時,必須使用這些綱目。
    註: 如果變更產生的綱目,會讓產生於 WSBIND 的連結檔失效。比方說,如果您想變更綱目,以重新命名綱目內的欄位,您必須使用 BBGJS2LS,來產生新的連結檔及新的一組語言結構。應用程式必須重新編譯,以使用新的語言結構。

指示主題類型的圖示 作業主題

檔名:twlp_zconnect_binding_and_schema.html