z/OS Connect proporciona la posibilidad de transformar opcionalmente cargas útiles de solicitudes y respuestas que se utilizan para llamar a un activo empresarial en los sistemas operativos z/OS. z/OS Connect proporciona dos programas de utilidad nuevos denominados
BBGLS2JS y BBGJS2LS.
Antes de empezar
Antes de crear los archivos de enlace y de esquema, asegúrese de que la configuración cumple estas condiciones previas:
- Las estructuras de lenguaje de alto nivel tienen que cumplir con
los siguientes criterios:
- Las estructuras de datos deben definirse independientemente del programa de
origen; por ejemplo, en un libro de copias de COBOL.
- Si el programa de aplicación PL/I o COBOL utiliza estructuras de datos de entrada
y de salida distintas, las estructuras de datos deben definirse en dos
miembros distintos de un conjunto de datos particionados. Si se utiliza la misma
estructura para el entrada y la saluda, la estructura debe definirse como un
único miembro.
- En el caso de C y C++, las estructuras de datos pueden estar en el mismo
miembro de un conjunto de datos particionados.
- Las estructuras de lenguaje deben estar disponibles en un conjunto de datos particionados.
- Debe definir en Open Multiple Virtual Storage (OMVS) el ID de usuario que utiliza
BBGLS2JS o BBGJS2LS para su ejecución.
- El ID de usuario debe disponer de permiso de lectura para las bibliotecas UNIX y PDS de z/OS® y permiso de escritura para los directorios que se han especificado en los parámetros de salida LOGFILE, WSBIND y JSON-SCHEMA-REQUEST y JSON-SCHEMA-RESPONSE.
- El ID de usuario dispone de una asignación de almacenamiento lo suficientemente grande para ejecutar
Java™. Puede utilizar cualquier versión de Java admitida. Los programas de utilidad BBGLS2JS/BBGJS2LS utilizan la versión
Java que especifica JAVA_HOME en el entorno USS de forma predeterminada. De lo contrario, el ID utiliza la versión de Java
especificada en la sentencia PATH.
Acerca de esta tarea
El programa de utilidad BBGLS2JS lee un libro de copias en
COBOL o PLI, o un archivo de estructuras en C y genera un archivo de enlaces y archivos de esquemas
JSON.
El programa de utilidad BBGJS2LS lee un esquema JSON y genera el archivo de enlace y el archivo de estructura de lenguajes correspondientes
(libro de copias en COBOL o PL/I, o archivo de cabecera de estructuras en C). Los programas de utilidad son similares a las herramientas
DFHLS2JS y DFHJS2LS existentes, que forman parte del paquete de características CICS Transaction Server Mobile Extensions. Mientras los parámetros de entrada son los mismos, los parámetros simbólicos son distintos.
Procedimiento
- Consiga el procedimiento JCL BBGLS2JS. Los procedimientos JCL BBGLS2JS y BBGJS2LS están disponibles en GitHub. Para obtener información sobre cómo utilizar el JCL, consulte el archivo de lectura en
GitHub. Tendrá que copiar el procedimiento de JCL desde esta ubicación en un miembro denominado BBGLS2JS en una biblioteca de procedimientos de
JCL de su sistema z/OS.
- Utilice el procedimiento BBGLS2JS para generar un archivo de enlaces de servicios de
z/OS Connect a partir de una estructura de lenguaje. Tendrá que proporcionar JCL para invocar el procedimiento BBGLS2JS con los parámetros de entrada.
Consulte la documentación de referencia de BBGLS2JS para obtener información sobre los parámetros de entrada y un trabajo de ejemplo que le ayudará a utilizar el procedimiento.
Cuando someta el procedimiento BBGLS2JS, el programa de utilidad generará el archivo de enlaces de servicio en la ubicación que haya especificado con el parámetro WSBIND. Los esquemas JSON generados se colocan en la ubicación que haya especificado con los parámetros
JSON-SCHEMA-REQUEST y JSON-SCHEMA-RESPONSE.
- Revise el esquema JSON generado. Estos esquemas se utilizan para definir formatos de datos de entrada y salida para interactuar con el servicio de
z/OS Connect. El desarrollador de aplicaciones debe utilizar estos esquemas al crear una aplicación que invoque al servicio y pase la carga útil de solicitudes JSON.
Nota: El cambio del esquema generado invalida el archivo de enlaces generado en WSBIND. Si desea cambiar el esquema, por ejemplo, para renombrar los campos en el esquema, debe utilizar BBGJS2LS para generar un nuevo archivo de enlaces y un conjunto nuevo de estructuras de lenguaje. El programa de aplicación se debe volver a compilar para que utilice las estructuras del lenguaje nuevo.