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 用作临时工作空间的目录位置。运行作业时所使用的用户标识必须具有对此目录的读和写许可权。它是可选参数,如果未指定此参数,那么缺省值为 /tmp

对 Java API 指定绝对路径以在编写 java.io.tmpdir 定制属性时使用新的临时工作空间。对于脚本,指定环境变量 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 用作临时工作空间的目录位置。运行作业时所使用的用户标识必须具有对此目录的读和写许可权。它是可选参数,如果未指定此参数,那么缺省值为 /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