Conversión para la transformación de datos de z/OS Connect
La característica z/OS Connect se ejecuta en un entorno de Liberty de WebSphere Application Server para z/OS. Puede utilizar las herramientas JCL (lenguaje de control de trabajos) BBGLS2JS y BBGJS2LS para generar los artefactos de z/OS Connect necesarios para facilitar la conversión de datos.
BBGLS2JS: Conversión de lenguaje de alto nivel a archivo de enlace y esquema para la transformación de datos de z/OS Connect
El procedimiento JCL lenguaje de control de trabajos) BBGLS2JS genera un esquema JSON (JavaScript Object Notation) y archivos de enlace a partir de una estructura de datos de alto nivel. Los archivos que se generan son utilizados por el proceso de transformación de datos de z/OS Connect. Se basa en DFHLS2JS del paquete de características CICS (Customer Information Control Center) Transaction Server Mobile Extensions.
Consulte la documentación para obtener información y ejemplos de utilización de la herramienta BBGLS2JS. Donde la documentación hace referencia a DFHLS2JS, utilice BBGLS2JS. https://www.ibm.com/support/knowledgecenter/SSGMCP_5.1.0/com.ibm.cics.ts51.home.doc/library/library_pdf_collections.html
Los siguientes parámetros simbólicos se definen en BBGLS2JS:
WLPDIR=path Un parámetro obligatorio que especifica el nombre del directorio de WebSphere Application Server Liberty en el sistema de archivos de UNIX System Services.
TMPDIR=tmpdir Especifica la ubicación de un directorio en IBM® z/OS Unix System Services que BBGLS2JS utiliza como espacio de trabajo temporal. El ID de usuario que se utiliza para ejecutar el trabajo debe tener permiso de lectura y grabación para este directorio. Es un parámetro opcional y, si no se especifica, el valor predeterminado es /tmp.
Debe especificar una vía de acceso absoluta para que una API Java utilice un nuevo espacio de trabajo temporal cuando se codifique la propiedad personalizada java.io.tmpdir. Para scripts, debe especificar la variable de entorno TMPDIR para que apunte a este nuevo directorio temporal.
TMPFILE=tmpprefix Especifica un prefijo que BBGLS2JS utiliza para construir los nombres de los archivos de espacio de trabajo temporal. Es un parámetro opcional y, si no se especifica, el valor predeterminado es LS2JS.
Los parámetros de entrada documentados para DFHLS2JS también son aplicables a BBGLS2JS. El valor que se especifica para el parámetro PGMNAME se utiliza en el esquema JSON generado.
El ejemplo siguiente muestra cómo crear el JCL para ejecutar la herramienta 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: Conversión de esquema JSON a lenguaje de alto nivel para la transformación de datos de z/OS Connect
El procedimiento JCL BBGJS2LS genera una estructura de datos de lenguaje de alto nivel y un archivo de enlace a partir de un esquema JSON. Los archivos que se generan son utilizados por el proceso de transformación de datos de z/OS Connect. Se basa en DFHJS2LS del paquete de características CICS Transaction Server Mobile Extensions.
Consulte la documentación para obtener información y ejemplos de utilización de la herramienta BBGJS2LS. Donde la documentación hace referencia a DFHJS2LS, utilice BBGJS2LS. https://www.ibm.com/support/knowledgecenter/SSGMCP_5.1.0/com.ibm.cics.ts51.home.doc/library/library_pdf_collections.html
Los siguientes parámetros simbólicos se definen en BBGJS2LS:
WLPDIR=path Un parámetro obligatorio que especifica el nombre del directorio de WebSphere Application Server Liberty en el sistema de archivos de UNIX System Services.
TMPDIR=tmpdir Especifica la ubicación de un directorio en z/OS UNIX que BBGJS2LS utiliza como espacio de trabajo temporal. El ID de usuario que se utiliza para ejecutar el trabajo debe tener permiso de lectura y grabación para este directorio. Es un parámetro opcional y, si no se especifica, el valor predeterminado es /tmp.
TMPFILE=tmpprefix Especifica un prefijo que BBGJS2LS utiliza para construir los nombres de los archivos de espacio de trabajo temporal. Es un parámetro opcional y, si no se especifica, el valor predeterminado es JS2JS.
Los parámetros de entrada documentados para DFHJS2LS también son aplicables a BBGJS2LS. El valor que se especifica para el parámetro PGMNAME se utiliza en el nombre de la estructura de lenguaje de alto nivel generada.
El ejemplo siguiente muestra cómo crear el JCL para ejecutar la herramienta 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
/*