Conversion pour la transformation de données z/OS Connect

La fonction z/OS Connect s'exécute dans un environnement WebSphere Application Server for z/OS, Liberty. Vous pouvez utiliser les outils BBGLS2JS et BBGJS2LS Job Control Language (JCL) pour générer les artefacts z/OS Connect nécessaire à la simplification de la conversion de données.

BBGLS2JS: Langage évolué pour la liaison et la conversion de fichier schéma pour la transformation de données z/OS

La procédure JCL (Job Control Language) BBGLS2JS génère un schéma JSON (JavaScript Object Notation) et des fichiers de liaison à partir d'une structure de données de haut niveau. Les fichiers qui sont générés sont utilisés par le processus de transformation de données z/OS Connect. Ce processus repose sur l'outil DFHLS2JS du module de fonctions Customer Information Control Center (CICS) Transaction Server Mobile Extensions.

Consultez la documentation pour en savoir plus sur l'utilisation et obtenir des exemples d'utilisation de l'outil BBGLS2JS. Lorsque la documentation fait référence à DFHLS2JS, lisez BBGLS2JS. https://www.ibm.com/support/knowledgecenter/SSGMCP_5.1.0/com.ibm.cics.ts51.home.doc/library/library_pdf_collections.html

Paramètres symboliques

Les paramètres symboliques suivants sont définis dans l'outil BBGLS2JS :

WLPDIR=path Paramètre obligatoire qui indique le nom du répertoire WebSphere Application Server Liberty dans le système de fichiers UNIX System Services.

TMPDIR=tmpdir Indique l'emplacement d'un répertoire dans IBM® z/OS Unix System Services que l'outil BBGLS2JS utilise comme espace de travail temporaire. L'ID utilisateur utilisé pour exécuter le travail doit disposer des droits de lecture et d'écriture sur ce sur répertoire. Il s'agit d'un paramètre facultatif et, s'il n'est pas indiqué, la valeur par défaut est /tmp.

Vous indiquez un chemin d'accès absolu pour une API Java afin d'utiliser un nouvel espace de travail temporaire lorsque vous codez la propriété personnalisée java.io.tmpdir. Pour les scripts, vous spécifiez la variable d'environnement TMPDIR afin de pointer sur ce nouveau répertoire temporaire.

TMPFILE=tmpprefix Indique un préfixe que l'outil BBGLS2JS utilise pour construire les noms des fichiers de l'espace de travail temporaire. Il s'agit d'un paramètre facultatif et, s'il n'est pas indiqué, la valeur par défaut est LS2JS.

Paramètres d'entrée

Les paramètres d'entrée qui sont présentés pour l'outil DFHLS2JS s'appliquent également à l'outil BBGLS2JS. La valeur qui est indiquée pour le paramètre PGMNAME est utilisée dans le schéma JSON généré.

L'exemple suivant illustre la création de la procédure JCL pour exécuter l'outil 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: conversion d'un schéma JSON en langage évolué pour les transformations de données z/OS Connect

La procédure JCL BBGJS2LS génère une structure de données en langage évolué de haut niveau et un fichier de liaison à partir d'un schéma JSON. Les fichiers qui sont générés sont utilisés par le processus de transformation de données z/OS Connect. Il repose sur l'outil DFHJS2LS du module de fonctions CICS Transaction Server Mobile Extensions.

Consultez la documentation pour en savoir plus sur l'utilisation et obtenir des exemples d'utilisation de l'outil BBGJS2LS. Lorsque la documentation fait référence à DFHJS2LS, lisez BBGJS2LS. https://www.ibm.com/support/knowledgecenter/SSGMCP_5.1.0/com.ibm.cics.ts51.home.doc/library/library_pdf_collections.html

Paramètres symboliques

Les paramètres symboliques suivants sont définis dans l'outil BBGJS2LS :

WLPDIR=chemin Paramètre obligatoire qui spécifie le nom du répertoire WebSphere Application Server Liberty dans le système de fichiers UNIX System Services.

TMPDIR=tmpdir Indique l'emplacement d'un répertoire dans z/OS UNIX que l'outil BBGJS2LS utilise comme espace de travail temporaire. L'ID utilisateur utilisé pour exécuter le travail doit disposer des droits de lecture et d'écriture sur ce sur répertoire. Il s'agit d'un paramètre facultatif et, s'il n'est pas indiqué, la valeur par défaut est /tmp.

TMPFILE=tmpprefix Indique un préfixe que l'outil BBGJS2LS utilise pour construire les noms des fichiers de l'espace de travail temporaire. Il s'agit d'un paramètre facultatif et, s'il n'est pas indiqué, la valeur par défaut est JS2JS.

Paramètres d'entrée

Les paramètres d'entrée qui sont présentés pour l'outil DFHJS2LS s'appliquent également à l'outil BBGJS2LS. La valeur qui est spécifiée pour le paramètre PGMNAME est utilisée dans le nom de la structure de langage de haut niveau générée.

L'exemple suivant illustre la création de la procédure JCL pour exécuter l'outil 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
/*

Icône indiquant le type de rubrique Rubrique de référence

Nom du fichier : rwlp_zconnect_conv_datatrans.html