Exécutez l'application Java EE sur CICS
introduction
Quand vous pensez à CICS (CICS Transaction Server for z / OS), vous pourriez penser que l'écriture d'applications dans des langages tels que COBOL, PL / I et assembleur est la norme, mais la prise en charge de Java a été ajoutée depuis longtemps. .. Dans les versions plus récentes, Liberty (WAS: une version allégée de WebSphere Application Server) s'exécute sur CICS. En d'autres termes, vous pouvez exécuter des applications Java EE sur CICS.
Par exemple, si vous disposez d'une application CICS existante et que vous souhaitez créer une interface pour le Web pour y accéder à partir du Web, vous ne pouvez le faire qu'avec CICS sans acheter un serveur d'applications distinct.
Voici un résumé des paramètres minimaux pour exécuter Liberty sur CICS et les étapes pour exécuter l'exemple d'application.
Maintenance de l'environnement d'exécution
En gros, suivez la description ici. https://www.ibm.com/support/knowledgecenter/SSGMCP_5.3.0/com.ibm.cics.ts.java.doc/JVMserver/config_jvmserver_liberty.html
Les informations de propriété et les journaux du serveur Liberty s'exécutant sur CICS sont gérés dans des fichiers sur USS. Par conséquent, préparez d'abord les répertoires et fichiers utilisés par la fonction CICS-Liberty sur USS (Unix System Service).
Annuaire USS
Créez le répertoire suivant.
- / var / cicsts / cicsts53 / CT53H4A1 / JVMProfiles / (pour le placement du fichier de propriétés JVM)
- / var / cicsts / cicsts53 / CT53H4A1 / work / (répertoire de travail où les journaux, etc. sont sortis)
Fichier de propriétés JVM
Préparez un fichier qui définit Liberty et ses propriétés JVM prérequises. En effet, le modèle fourni par le produit est fourni dans <répertoire d'installation> /JVMProfiles/DFHWLP.jvmproperties, copiez-le donc dans /var/cicsts/cicsts53/CT53H4A1/JVMProfiles/DFHWLP.jvmproperties et modifiez-le. Les paramètres minimum requis sont les suivants.
DFHWLP.jvmproperties
JAVA_HOME=/usr/lpp/java/J7.1_64/
WORK_DIR=/var/cicsts/cicsts53/CT53H4A1/work
WLP_INSTALL_DIR=/usr/lpp/cicsts/cicsts53/wlp
-Dcom.ibm.cics.jvmserver.wlp.autoconfigure=true
-Dcom.ibm.cics.jvmserver.wlp.server.host=*
-Dcom.ibm.cics.jvmserver.wlp.server.http.port=53481
-Dcom.ibm.cics.jvmserver.wlp.server.https.port=53482
Spécifiez le JAVA_HOME Java à utiliser, le répertoire de travail, le numéro de port écouté par Liberty, etc.
SIT Dans SIT de la région CICS, spécifiez le répertoire du fichier de propriétés préparé ci-dessus avec le paramètre JVMPROFILEDIR.
SIT
JVMPROFILEDIR=/var/cicsts/cicsts53/CT53H4A1/JVMProfiles
Lancez la région CICS avec ce paramètre SIT activé.
Définition des ressources CICS: définition du serveur JVM
Pour exécuter Liberty sur CICS, vous devez créer et installer une définition de ressource appelée définition de serveur JVM qui spécifie le fichier de propriétés préparé sur USS. Encore une fois, un exemple est fourni pour le groupe DFH $ WLP, afin que vous puissiez le copier et l'utiliser.
Exemple de définition de serveur JVM
OBJECT CHARACTERISTICS CICS RELEASE = 0700
CEDA View JVmserver( DFHWLP )
JVmserver : DFHWLP
Group : TAGGRP
DEScription : CICS JVM server to run WLP samples
Status : Enabled Enabled | Disabled
Jvmprofile : DFHWLP (Mixed Case)
Lerunopts : DFHAXRO
Threadlimit : 015 1-256
DEFINITION SIGNATURE
DEFinetime : 01/29/16 09:08:50
CHANGETime : 01/29/16 09:08:50
CHANGEUsrid : CICSUSER
CHANGEAGEnt : CSDApi CSDApi | CSDBatch
CHANGEAGRel : 0700
Le fichier avec l'extension ".jvmprofile" ajouté à la valeur de Jvmprofile (DFHWLP dans l'exemple ci-dessus) spécifié ici est recherché dans le répertoire spécifié par JVMPROFILEDIR de SIT.
Après avoir créé la définition JVMServer, installons-la. Ensuite, le message suivant sera affiché dans le JOBLOG de CICS.
DFHRD0131 I 03/07/2017 19:14:04 CT53H4A1 TCP00045 CICSUSER CEDA INSTALL JVMSERVER(DFHWLP)
0045 CEDA CICSUSER 03/07/17 19:14:04 INSTALL JVMSERVER(DFHWLP) GROUP(TAGGRP)
DFHPG0210 03/07/2017 19:14:04 CT53H4A1 IBMUSER CJSR Resource definition for DFHAXRO has been system autoinstalled.
DFHSJ0207 03/07/2017 19:14:09 CT53H4A1 JVMSERVER DFHWLP is running Java version 1.7.1.
DFHSJ0919 I 03/07/2017 19:14:17 CT53H4A1 IBMUSER JVMSERVER DFHWLP is processing any queued bundles.
DFHSJ0915 03/07/2017 19:14:17 CT53H4A1 IBMUSER JVMSERVER DFHWLP is now enabled and is ready for use.
DFHSJ0901 I 03/07/2017 19:14:17 CT53H4A1 JVMSERVER DFHWLP Java full version is: JRE 1.7.0 IBM J9 2.7 z/OS s390x-64 Compressed
References 20140410_195893 (JIT enabled, AOT enabled) J9VM - R27_Java727_SR1_20140410_1931_B195893 JIT -
tr.r13.java_20140410_61421 GC - R27_Java727_SR1_20140410_1931_B195893_CMPRSS J9CL - 20140410_195893.
Le serveur de Liberty est maintenant sur CICS!
Contrôle de fonctionnement
Si vous vérifiez les informations du port que vous écoutez avec la commande NETSTAT, etc., vous pouvez voir que vous écoutez sur le port spécifié précédemment dans le fichier de propriétés.
Exemple NETSTAT
398 00000090 CT53H4A1 000015DC 0.0.0.0..53481 0.0.0.0..0 LISTEN
398 00000090 CT53H4A1 000015DD 0.0.0.0..53482 0.0.0.0..0 LISTEN
Le serveur Liberty fonctionne sur CICS, donc connectons-nous à partir du navigateur.
Vous pouvez voir l'écran d'accueil en accédant à http: // hostname: 53481 /.
De plus, si vous accédez à l'application Web fournie par défaut, vous pouvez vérifier les informations environnementales suivantes.
Ceci complète l'environnement d'exécution minimum. C'est facile.
Maintenance de l'environnement de développement
La description de cette zone est la base. https://www.ibm.com/support/knowledgecenter/en/SSGMCP_5.3.0/com.ibm.cics.ts.java.doc/topics/installingthelibertyprofile.html
Soit dit en passant, même s'il s'agit d'une application CICS, nous développons une application Java EE qui tourne sous Liberty, donc l'environnement de développement n'est pas l'écran 3270 de PCOM, mais bien sûr Eclipse sur PC. Un plug-in SDK pour CICS-Liberty est fourni pour Eclipse, vous pouvez donc créer un environnement de développement en l'ajoutant. Vous pouvez utiliser n'importe quel Eclipse gratuit (bien que l'intégrité de la version soit requise), mais CICS fournit un outil de gestion basé sur Eclipse (gratuit) appelé CICS Explorer, donc c'est tout. C'est une bonne idée d'obtenir et de mettre le SDK là-bas.
CICS Explorer Reportez-vous à la description suivante ... Installez CICS Explorer (https://www.ibm.com/support/knowledgecenter/SSGMCP_5.3.0/com.ibm.cics.core.help/topics/concepts/install_planning.html)
Il existe deux façons de l'installer, et il peut être difficile de comprendre si Eclipse est installé à l'avance ou si z / OS Explorer est installé, mais le moyen le plus rapide est au bas du site suivant. Sélectionnez l'option 1 à partir de Scrach dans «Utilisation d'Eclipse (p2)» et téléchargez l'explorateur CICS pour votre plate-forme. https://developer.ibm.com/mainframe/products/downloads/eclipse-tools/#p2 Maintenant que vous avez un zip, décompressez-le. Lorsque vous le décompressez, vous trouverez zosexplorer.exe, alors exécutez-le pour le démarrer. (Même si vous téléchargez CICS Explorer, le fichier exécutable est zosexplorer.exe.)
Plug-in SDK
Reportez-vous à la description suivante ... Installing the CICS SDK for web and JSP
Dans le menu CICS Explorer, sélectionnez Help-Install New Software Site de mise à jour d'IBM Explorer pour z / OS - Sélectionnez http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua/.
Vous devez être connecté au Web car il sera téléchargé et installé à partir du site Web.
Développez IBM CICS Explorer et sélectionnez et installez IBM CICS SDK pour la prise en charge des servlets et JSP, IBM CICS SDK pour les servlets et la prise en charge de la traduction JSP.
divers paramètres
Définissez certains paramètres pour améliorer l'environnement de développement.
Paramètre de version cible de CICS
Sur Eclipse (CICS Explorer), spécifiez la version des CCD à cibler pour le développement.
Sélectionnez un paramètre,
Développement de plugins - Sélectionnez une plateforme cible et
Sélectionnez la version CICS cible. (Ici, CICS TS V5.3 avec Liberty et PHP)
Configuration FTP
Si vous souhaitez déployer une application de CICS Explorer vers le CICS cible, vous devez transférer l'application créée sur USS. Créez une configuration de connexion FTP afin de pouvoir déployer à partir de CICS Explorer.
Ouvrez la vue de connexion hôte et définissez la configuration FTP dans l'élément FTP de z / OS.
Si vous pouvez établir une connexion FTP à partir de CICS Explorer, elle sera marquée en vert comme indiqué ci-dessous.
Annuaire USS
Préparez un répertoire sur USS pour placer l'application. L'application CICS-Liberty est associée à une ressource appelée définition BUNDLE sur CICS, créez donc un répertoire appelé bundles comme indiqué ci-dessous. /var/cicsts/cicsts53/CT53H4A1/bundles/
Exemple d'application
Maintenant que l'environnement de développement est en place, créons un exemple de projet d'application fourni par le SDK CICS, déployez-le sur CICS-Liberty et exécutez-le.
Créer un exemple de projet
Reportez-vous à la description suivante ... Creating the servlet examples
Dans File-New-Sample, sélectionnez CICS Hello World.
L'exemple de projet d'application CICS Hello World est maintenant importé dans Eclipse.
C'est aussi simple qu'une application avec un seul jsp.
Il contient également la définition d'un bundle CICS (cics.xml) pour la gestion en tant que ressource sur CICS.
Déployer
Reportez-vous à la description suivante ... Deploying the servlet examples
Déployons cette application.
Cliquez avec le bouton droit sur le projet nommé xxx.bundle et sélectionnez Exporter le projet groupé vers le système de fichiers z / OS UNIX.
Sélectionnez Exporter vers un emplacement spécifique dans le système de fichiers et Suivant
Sélectionnez le répertoire de destination du déploiement préparé ci-dessus et exportez-le.
L'application est maintenant placée sur USS.
Enfin, pour que cette application soit reconnue par CICS, ajoutez une définition de ressource appelée définition BUNDLE sur CICS. La définition BUNDLE pour cet exemple est fournie dans le groupe DFH $ WLP, donc copiez-la, modifiez-la en conséquence et installez-la.
Exemple de définition de BUNDLE
OVERTYPE TO MODIFY CICS RELEASE = 0700
CEDA ALter Bundle( WLPHELLO )
Bundle : WLPHELLO
Group : TAGGRP
DEScription ==> CICS Bundle for Liberty Hello servlet
Status ==> Enabled Enabled | Disabled
BUndledir ==> /var/cicsts/cicsts53/CT53H4A1/bundles/com.ibm.cics.server.
(Mixed Case) ==> examples.wlp.hello.bundle_1.0.1
==>
==>
==>
BAsescope ==>
(Mixed Case) ==>
==>
==>
==>
DEFINITION SIGNATURE
DEFinetime : 03/07/17 21:02:49
CHANGETime : 03/07/17 21:04:26
SYSID=H4A1 APPLID=CT53H4A1
Le message suivant est émis vers le JOBLOG CICS.
+CWWKG0016I: Starting server configuration update.
+CWWKG0017I: The server configuration was successfully updated in 636
0.031 seconds.
+CWWKZ0001I: Application com.ibm.cics.server.examples.wlp.hello.war 637
started in 0.069 seconds.
Courir
Accédons à l'application déployée sur CICS-Liberty depuis un navigateur.
Accédez à l'URL suivante à partir d'un navigateur http://hostname:53481/com.ibm.cics.server.examples.wlp.hello/
C'est OK si l'application renvoie l'écran suivant.
Vous pouvez voir que le nom de la région CICS (applid) est renvoyé.
en conclusion
Ici, nous avons introduit une série d'étapes pour exécuter l'application CICS-Liberty. Bien que nous ne soyons pas entrés dans le contenu de l'application, l'application CICS-Liberty fournit une interface Java équivalente à l'API EXEC CICS appelée JCICS, afin que vous puissiez accéder aux ressources CICS directement à partir de Java. En utilisant cette fonction CICS-Liberty, il peut être plus facile d'utiliser les applications CICS existantes sur le Web et de développer des extensions en Java.
Recommended Posts