z/OS Connect 資料轉換用的轉換

z/OS® Connect 特性是在 WebSphere® Application Server for z/OS Liberty 環境中執行。您可以使用 BBGLS2JS 和 BBGJS2LS 工作控制語言 (JCL) 工具,來產生必要的 z/OS Connect 構件,以協助資料的轉換。

BBGLS2JS:將高階語言轉換成連結檔和綱目檔,來進行 z/OS Connect 資料轉換

「BBGLS2JS 工作控制語言」程序會從高階資料結構產生 「JavaScript 物件表示法 (JSON)」綱目檔和連結檔。產生的檔案供 z/OS Connect 資料轉換程序使用。它是以 「客戶資訊控制中心 (CICS®) 交易伺服器行動延伸」特性套件中的 DFHLS2JS 為基礎。

如需 BBGLS2JS 工具的用法資訊與範例,請參閱說明文件。其中,說明文件是參照 DFHLS2JS,而使用 BBGLS2JS。https://www.ibm.com/support/knowledgecenter/SSGMCP_5.1.0/com.ibm.cics.ts51.home.doc/library/library_pdf_collections.html

符號參數

BBGLS2JS 中定義的符號參數如下:

WLPDIR=path 這是必要參數,指定「UNIX 系統服務」檔案系統中的 WebSphere Application Server Liberty 目錄名稱。

TMPDIR=tmpdir 指定 IBM® z/OS Unix 系統服務中供 BBGLS2JS 作為暫時工作區的目錄位置。用來執行工作的使用者 ID 必須具備這個目錄的讀取和寫入權。這是選用參數,如果沒有指定,預設值為 /tmp

當您編寫 java.io.tmpdir 自訂內容時,請指定 Java API 的絕對路徑,以使用新的暫時工作區。對於 Script,請指定 TMPDIR 環境變數,以指向這個新的暫存目錄。

TMPFILE=tmpprefix 指定 BBGLS2JS 用來建構暫時工作區檔案名稱的字首。這是選用參數,如果沒有指定,預設值為 LS2JS。

輸入參數

所記載的 DFHLS2JS 輸入參數亦適用於 BBGLS2JS。指定給 PGMNAME 參數的值會用於產生的 JSON 綱目中。

下列範例顯示如何建立 JCL,以執行 BBGLS2JS 工具:

//LS2JS JOB  'accounting information',name,MSGCLASS=A
//JCLLIB JCLLIB ORDER=EXAMPLE.DSNAME  
//JAVAPROG EXEC BBGLS2JS,
// WLPDIR='/opt/IBM/wlp'
//INPUT.SYSUT1 DD *
PDSLIB=TEST.DSNAME
REQMEM=CDATA2
RESPMEM=CDATA2
MAPPING-LEVEL=3.0
MINIMUM-RUNTIME-LEVEL=3.0
CHAR-VARYING=COLLAPSE
STRUCTURE=(requestData,requestData)
JSON-SCHEMA-REQUEST=/u/user1/json/getcustc_request.json
JSON-SCHEMA-RESPONSE=/u/user1/json/getcustc_response.json
LANG=C
LOGFILE=/u/user1/wsbind/getcustc.log
URI=http://myserver.example.org:8080/exampleApp/example
PGMINT=COMMAREA
PGMNAME=GETCUSTC
WSBIND=/u/user1/getcustc.wsbind
/*

BBGJS2LS:將 JSON 綱目轉換成高階語言,來進行 z/OS Connect 資料轉換

BBGJS2LS JCL 程序會從 JSON 綱目產生高階語言資料結構和連結檔。產生的檔案供 z/OS Connect 資料轉換程序使用。它是以 「CICS 交易伺服器行動延伸」特性套件中的 DFHJS2LS 為基礎。

如需 BBGJS2LS 工具的用法資訊與範例,請參閱說明文件。其中,說明文件是參照 DFHJS2LS,而使用 BBGJS2LS。https://www.ibm.com/support/knowledgecenter/SSGMCP_5.1.0/com.ibm.cics.ts51.home.doc/library/library_pdf_collections.html

符號參數

BBGJS2LS 中定義的符號參數如下:

WLPDIR=path 這是必要參數,指定「UNIX 系統服務」檔案系統中的 WebSphere Application Server Liberty 目錄名稱。

TMPDIR=tmpdir 指定 z/OS UNIX 中供 BBGJS2LS 作為暫時工作區的目錄位置。用來執行工作的使用者 ID 必須具備這個目錄的讀取和寫入權。這是選用參數,如果沒有指定,預設值為 /tmp

TMPFILE=tmpprefix 指定 BBGJS2LS 用來建構暫時工作區檔案名稱的字首。這是選用參數,如果沒有指定,預設值為 JS2JS。

輸入參數

所記載的 DFHJS2LS 輸入參數亦適用於 BBGJS2LS。指定給 PGMNAME 參數的值會用於產生的高階語言結構名稱中。

下列範例顯示如何建立 JCL,以執行 BBGJS2LS 工具:

//JS2LS JOB  'accounting information',name,MSGCLASS=A
//  SET QT=''''
//JCLLIB JCLLIB ORDER= EXAMPLE.DSNAME
//JAVAPROG EXEC BBGJS2LS,
// WLPDIR='/opt/IBM/wlp'
//INPUT.SYSUT1 DD *
PDSLIB=TEST.DSNAME
REQMEM=CPYBK1
RESPMEM=CPYBK2
JSON-SCHEMA-REQUEST=example.json
JSON-SCHEMA-RESPONSE=example.json
LANG=COBOL
LOGFILE=/u/exampleapp/wsbind/example.log
MAPPING-LEVEL=3.0
CHAR-VARYING=NULL
INLINE-MAXOCCURS-LIMIT=2
PGMNAME=DFH0XCMN
URI=exampleApp/example
PGMINT=COMMAREA
SYNCONRETURN=YES
WSBIND=/u/exampleapp/wsbind/example.wsbind
/*

指示主題類型的圖示 參照主題

檔名:rwlp_zconnect_conv_datatrans.html