Tutoriel : Déployer CardDemo une application sur NTT DATA

1. Connectez-vous à l'instance EC2 UniKix d'exécution en tant queec2-user.

2. Consultez la liste des UniKix logiciels prépackagés dans l'AMI, tels que TPE, BPE et COBOL, ainsi que d'autres logiciels provenant de l'emplacement des UniKix produits NTT DATA en utilisant la commande suivante dans votre instance EC2 :

   ls -l /opt/software/

3. Examinez l' CardDemo application migrée. Vous verrez tout le code source, y compris les cartes BMS, les programmes COBOL, les cahiers COBOL et les JCL. Vous trouverez également l'exportation des catalogues BPE et TPE, les définitions de ressources CICS et les données migrées telles que les fichiers séquentiels et les fichiers VSAM en procédant comme suit :

   ls  $HOME/migrated_app/*/*

4. Créez une structure de dossiers en exécutant le create_project script à l'aide de la commande suivante :

   sh $HOME/bin/create_project

5. Activez l' CardDemo environnement en recherchant le fichier de carddemo.env configuration à l'aide de :

   source $HOME/bin/carddemo.env

1. Créez une région TPE à l'aide de la kixregion createRegion commande qui nécessite des entrées telles que $KIXSYS$JAVA_HOME, et$KIXLICDIR. Ces variables d'environnement sont déjà configurées dans le fichier de carddemo.env configuration.

   kixregion createRegion $KIXSYS $JAVA_HOME $KIXLICDIR

2. Configurez la région TPE à l'aide de la kixregion setAttr commande.

   kixregion setAttr $KIXSYS server.tx.languages.cobol.enabled true
   kixregion setAttr $KIXSYS server.tx.languages.cobol.flavor vcobol
   kixregion setAttr $KIXSYS server.tx.languages.cobol.home $VCOBOL
   kixregion setAttr $KIXSYS maps.location $PROJECT_ROOT/maps
   kixregion setAttr $KIXSYS programs.location $PROJECT_ROOT/loadlib
   kixregion setAttr $KIXSYS environment.KIXDATA $KIXDATA
   kixregion setAttr $KIXSYS td.jobq.submission.node $EBMHOME
   kixregion setAttr $KIXSYS td.jobq.submission.subsys $EBMSYS

3. Générez le fichier d'environnement utilisateur spécifique à cette région TPE en exécutant la kixregion createScript commande. Cette commande crée ou met à jour $KIXSYS/bin/userenv en fonction de la configuration de la région TPE.

   kixregion createScript $KIXSYS

4. Activez la région TPE en recherchant le fichier d'environnement utilisateur ($KIXSYS/bin/userenv).

   source $KIXSYS/bin/userenv

5. Créez la région TPE en exécutant la kixinstall2 commande.

   kixinstall2

1. Modifiez la propriété et les autorisations deINSTEBM.

   sudo chown root $INSTEBM 
   sudo chmod 4755 $INSTEBM

2. Créez un nœud BPE à l'aide de la INSTEBM commande. Le répertoire du nœud BPE est fourni en tant que paramètre d'entrée.

   $INSTEBM $EBMHOME

3. Activez l'environnement batch en recherchant le batchenv fichier depuis le nœud BPE nouvellement créé.

   source $EBMHOME/batchenv

4. Créez le sous-système BPE dans ce nœud à l'aide du gestionnaire d'administration des lots (bam). La bam commande ouvre l'interface du gestionnaire d'administration des lots.

   bam

   1. Démarrez le nœud BPE à l'aide de l'interface BAM. Choisissez l'option 2, Environnements système, dans le menu principal.

      

   2. Choisissez l'option 2, Démarrer/ (Stop) Batch Node pour démarrer le nœud BPE.

      

   3. Une fois démarré, appuyez deux fois sur la touche Retour pour revenir au menu principal de BAM.

      

   4. Pour créer le sous-système BPE, choisissez l'option 3, Applications et sous-systèmes.

      

   5. Choisissez ensuite l'option 3, Créer un sous-système.

      

   6. Entrez le nom du sous-système sous la formesys1.

      

   7. Choisissez l'option 3, Gestion des données.

      

   8. Choisissez l'option 5, car l' CardDemo application implique à la fois des fichiers séquentiels et des fichiers VSAM.

      

   9. (Facultatif) Appuyez sur « R » pour revenir à la page Créer un menu et passez en revue les différentes options de configuration disponibles.

   10. Sur la page Créer, entrez « C » pour créer le sous-système. sys1

       

   11. Vérifiez les paramètres, puis saisissez « C » pour continuer pour les autres paramètres d'environnement. Ces paramètres d'environnement sont préremplis en raison des variables d'environnement nécessaires définies dans le fichier d'carddemo.envinstallation et de la mise en place de la structure de dossiers recommandée.

   12. Entrez « y » pour confirmer et enregistrer les paramètres d'environnement actuels.

       

   13. Entrez « y » pour afficher le journal lors de la création du sous-système.

       

   14. Appuyez sur la touche Retour jusqu'à ce que vous reveniez au menu principal et quittiez l'interface BAM en sélectionnant l'option Quitter.

       
       
       

5. Activez le sous-système BPE en recherchant le batchenv avec le nom du sous-système. sys1

   source $EBMHOME/batchenv sys1

1. Activez à nouveau l' CardDemo environnement en vous procurant le fichier de carddemo.env configuration.

   source $HOME/bin/carddemo.env

2. Accédez au répertoire source COBOL.

   cd $MIGAPP_DIR/cbl

3. Compilez le programme Cobol à CBACT01C.cbl l'aide d'un compile script.

   compile CBACT01C.cbl

4. Compilez tous les programmes Cobol à l'aide d'un compile.all script.

   compile.all

5. Accédez au répertoire source des cartes BMS.

   cd $MIGAPP_DIR/bms

6. Compilez la carte BMS à COACTUP.bms l'aide d'un compbms script.

   compbms COACTUP.bms

7. Compilez toutes les cartes BMS à l'aide d'un compbms.all script.

   compbms.all

8. Vérifiez les fichiers binaires compilés pour les cartes COBOL et BMS.

   ls $PROJECT_ROOT/loadlib
   ls $PROJECT_ROOT/maps

9. Déployez d'autres artefacts d'application tels que JCL, des procédures, des fichiers de données et des définitions de ressources CICS à l'aide du deploy_app script.

   deploy_app

10. Accédez au répertoire JCL du projet.

    cd $PROJECT_ROOT/jcl

11. Traduisez JCL ACCTFILE en BPE JCL Macro. Utilisez la mvstrans commande en utilisant l'option « -v » pour la vérification JCL et l'option « -f » pour créer la macro.

    mvstrans ACCTFILE -v
    mvstrans ACCTFILE -f

12. Traduisez la procédure JCL REPROC en macro de procédure JCL BPE. Utilisez la mvstrans commande avec l'option « -p » ainsi que l'option « -v » pour la vérification et l'option « -f » pour créer la macro.

    mvstrans REPROC -v -p
    mvstrans REPROC -f -p

13. Traduisez toutes les JCL et les procédures JCL.

    for file in "./jmvs/*"; do mvstrans $file -f; done > jmvs.out
    for file in "./mvsp/*"; do mvstrans $file -p -f; done > mvsp.out

1. Importez le catalogue BPE à l'aide de loadcat la commande.

   loadcat $MIGAPP_DIR/catlg/bpe/BPECAT*

2. Accédez au répertoire $KIXSYS.

   cd $KIXSYS

3. Importez le catalogue TPE à l'aide de kiximpcat la commande.

   kiximpcat -c CATALOG -l CATALOG.lst

4. Importez des définitions de ressources CICS à l'aide de la commande kiximptbl.

   kiximptbl

1. Exécutez la kixverify commande sur tous les fichiers VSAM pour vous assurer qu'ils sont réinitialisés et que tous les fichiers précédemment ouverts sont fermés.

   kixverify -r ALL

2. Démarrez la région TPE.

   kixregion start $KIXSYS

3. Assurez-vous que le BPE et le TPE sont connectés. Ceci est crucial car les fichiers VSAM appartiennent à TPE et toute opération par lots accédant au VSAM nécessite une connexion à TPE.

   ebmsys -t

   

Connectez-vous à TPE à l'aide de l'émulateur de terminal TN3270

• Lancez le terminal TN3270 à l'aide de la commandekixterm.

  kixterm

  

1. Obtenez l'adresse IP de l'instance UniKix d'exécution depuis la console Amazon EC2.

2. Obtenez le numéro de port pour vous connecter à la région TPE à l'aide de l'émulateur de terminal TN3270. Vous pouvez le trouver sur TNServer à ListenPort partir du fichier unikixrc.cfg.

   cat $KIXSYS/unikixrc.cfg

   

3. Configurez votre émulateur de terminal TN3270 pour utiliser l'adresse IP de l'instance d' UniKix exécution et le numéro de port 15440.

1. Après vous être connecté à l'émulateur de terminal TN3270, appuyez sur la touche « Entrée » pour effacer l'écran TPE et entrer la transaction initiale.

2. Sur la transaction initiale CC00 (écran de connexion), entrez le nom USER001 d'utilisateur et le mot PASSWORD de passe.

   

3. Choisissez l'option « 01 » dans le menu principal pour afficher les comptes.

   

4. Dans l'écran Afficher le compte, entrez un numéro de compte (par exemple, 00000000010). Vous devriez voir les informations de compte renseignées à partir des données migrées.

   

5. Appuyez deux fois sur la touche « PF03 » pour revenir à l'écran de connexion et quittez le terminal TN3270 en appuyant sur « Ctrl+C » (Windows) ou « Cmd+C » (Macbook).

1. Accédez au répertoire JCL.

   cd $MBMSUB

2. Soumettez la tâche MFCATGL1 et observez les résultats du journal des tâches.

   BPESUB READCARD

3. Vous pouvez éventuellement consulter les journaux des tâches à partir du $SUBSYS_OUTDIR répertoire.

   ls -lrt $SUBSYS_OUTDIR/*

1. Entrez le nom de la transaction commeCTBL.

2. Dans le menu Gestionnaire de tableaux, choisissez l'option Tableaux standard.

3. Sur l'écran Tableaux standard, choisissez l'option Tableau de configuration VSAM.

4. Vérifiez si vous vous connectez au nœud batch ? est réglé sur «  Y » et le répertoire des nœuds est correct.