z/OS Connect fournit la possibilité de transformer le cas échéant le contenu des requêtes et réponses utilisées pour appeler un actif métier sur des systèmes d'exploitation z/OS. z/OS Connect fournit deux nouveaux utilitaires nommés BBGLS2JS et BBGJS2LS.
Avant de commencer
Avant de créer vos fichiers de liaison et de schéma, vérifiez que votre configuration répond aux prérequis suivants :
- Vos structures de données en langage de haut niveau doivent se conformer aux critères suivants :
- Les structures de données doivent être définies séparément du programme source ; par exemple, dans un fichier de stockage COBOL.
- Si votre programme d'application PL/I ou COBOL utilise des structures de données différentes pour les entrées et les sorties, ces structures doivent être définies dans deux membres différents dans un ensemble de données partitionnées. Si la même structure est utilisée pour les entrées et les sorties, elle doit être définie dans un seul membre.
- Pour C et C++, vos structures de données peuvent résider dans le même membre d'une ensemble de données partitionnées.
- Les structures du langage doivent être disponibles dans un ensemble de données partitionnées.
- Vous devez définir à OMVS (Open Multiple Virtual Storage) l'ID utilisateur utilisé par BBGLS2JS ou BBGJS2LS pour son exécution.
- L'ID utilisateur doit disposer d'un accès en lecture aux bibliothèques z/OS® UNIX et PDS,
et d'un accès en écriture aux répertoires spécifiés dans les paramètres de sortie
LOGFILE, WSBIND, JSON-SCHEMA-REQUEST et JSON-SCHEMA-RESPONSE.
- L'ID utilisateur doit disposer d'une allocation de stockage suffisante pour exécuter Java™. Vous pouvez utiliser n'importe quelle version Java prise en charge. Les utilitaires BBGLS2JS/BBGJS2LS utilisent par défaut la version Java spécifiée par la variable JAVA_HOME dans l'environnement
USS. Sinon, l'ID utilise la version Java spécifiée dans l'instruction PATH.
Pourquoi et quand exécuter cette tâche
L'utilitaire BBGLS2JS lit un fichier de stockage COBOL ou un fichier de structure PLI ou C et génère un fichier de liaison et des fichiers de schéma JSON.
L'utilitaire BBGJS2LS lit un schéma JSON et génère le fichier de liaison et le fichier de structure de langage (fichier de stockage COBOL ou fichier d'en-tête de structure PL/I ou C) correspondants. Ces utilitaires sont similaires aux outils DFHLS2JS et DFHJS2LS existants, lesquels font partie du module de fonctions CICS Transaction Server Mobile Extensions. Bien que les paramètres d'entrée soient les mêmes, les paramètres symboliques sont différents.
Procédure
- Procurez-vous la procédure JCL BBGLS2JS JCL. Les procédures JCL BBGLS2JS et BBGJS2LS JCL sont disponibles sur le site GitHub. Pour plus d'informations sur l'utilisation du
langage JCL, consultez le fichier Readme sur le site GitHub. Vous devrez copier la procédure JCL depuis cet emplacement vers un membre nommé
BBGLS2JS dans une bibliothèque de procédures JCL sur votre système z/OS.
- Utilisez la procédure BBGLS2JS pour générer un fichier de liaison du service z/OS Connect depuis une structure de langage. Vous devrez fournir le JCL pour appeler la procédure BBGLS2JS avec les paramètres d'entrée.
Pour plus d'informations sur les paramètres d'entrée et un exemple de travail afin de vous aider à utiliser cette procédure, reportez-vous à la documentation de référence BBGLS2JS.
Lorsque vous soumettez la procédure BBGLS2JS, l'utilitaire génère le fichier de liaison de
service à l'emplacement spécifié par le paramètre WSBIND. Les schémas JSON générés sont implantés à l'emplacement spécifié par les paramètres JSON-SCHEMA-REQUEST et JSON-SCHEMA-RESPONSE.
- Examinez le schéma JSON généré. Ces schémas sont utilisés pour définir les formats des données d'entrée et de sortie pour interaction avec le service z/OS Connect. Le développeur d'applications doit utiliser ces schémas lors de la création d'une application pour appeler le service et transmettre le contenu de la requête JSON.
Remarque : Toute modification du schéma généré invalide le fichier de liaison généré spécifié par le paramètre WSBIND. Si vous désirez modifier le schéma, par exemple en renommant les zones du schéma, vous devez utiliser l'utilitaire BBGJS2LS afin de générer un nouveau fichier de liaison et un nouveau jeu de structures du langage. Le programme d'application doit être recompilé afin d'utiliser ces nouvelles structures.