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.

CICS TS V5.3 for z/OS Nom de la région CICS: CT53H4A1

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 /. image01.JPG

De plus, si vous accédez à l'application Web fournie par défaut, vous pouvez vérifier les informations environnementales suivantes. image02.JPG

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. image03.JPG

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) image04.JPG

image05.JPG

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. image06.JPG

Si vous pouvez établir une connexion FTP à partir de CICS Explorer, elle sera marquée en vert comme indiqué ci-dessous. image07.JPG

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. image08.JPG

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. image09.JPG

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. image10.JPG

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. image11.JPG

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. image12.JPG 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

Exécutez l'application Java EE sur CICS
Exécutez PostgreSQL sur Java
Exécutez l'applet java sur ubuntu
Comment exécuter Java EE Tutial sur github sur Eclipse
Exécutez le script shell de tomcat sur java8
Création d'applications Web Java sur Windows Server 2016
Compilez et exécutez Java sur la ligne de commande
Exécutez Mecab dans l'environnement Win10 + Eclipse + Java + cmecab-java (version janvier 2020)
Exécutez STS4 sur Mac
Installez Java sur Mac
J'ai essayé d'utiliser Log4j2 sur un serveur Java EE
Exécutez kuromoji dans l'environnement Win10 + Eclipse + Java (version janvier 2020)
Exécuter le traitement sur Ant
Exécutez tiscamera sur Ubuntu 18.04
Java EE sans serveur à partir de Quarkus et Cloud Run
Exécuter R à partir d'un processus Java optimisé par Tomcat sur Amazon Linux
1. Exécutez rapidement des modules Web Java sur Google Kubernetes Engine (GKE)
Gestion des versions Java sur macOS
Installez OpenJDK7 (JAVA) sur ubuntu 14.04
Exécuter un lot avec docker-compose avec Java batch
Rétrograder Java sur openSUSE Linux
Réflexion sur la manipulation de chaînes Java
Activer Java EE avec NetBeans 9
En passant Java Gold SE 8
Exécutez openvpn sur Docker (Windows)
Oracle Java 8 sur Docker Ubuntu
Installez Java sur WSL Ubuntu 18.04
java bonjour le monde, compilez, exécutez
Mettez Oracle Java 8 dans CircleCI 2
Changer la version java sur CentOS
Exécutez Eclipse CDT sur Ubuntu
Application Java CICS-Run - (5) Utiliser JCICSX
Exécutez mruby / c sur PSoC 5
Exécuter Java VM avec Web Assembly
Installez java 1.8.0 sur Amazon linux2