OPALE - 10.1 - Programme de Duplication d'environnements MAPDUPENV

Différence entre versions

De MappingDoc
(Limites)
(Option 2 : Création d'un nouvel environnement à partir d'un autre)
 
(46 révisions intermédiaires par le même utilisateur non affichées)
Ligne 5 : Ligne 5 :
 
==Cas d'usages possibles==
 
==Cas d'usages possibles==
  
Il y a plusieurs cas d'usages possibles de ce programme :
+
Il y a plusieurs cas d'usages possibles pour ce programme :
  
 
*Besoin de duplication d'un environnement à l'identique (Pour faire des tests sans impacter l'environnement de production)
 
*Besoin de duplication d'un environnement à l'identique (Pour faire des tests sans impacter l'environnement de production)
Ligne 14 : Ligne 14 :
 
Ce programme composé de 3 options qui consistent à :
 
Ce programme composé de 3 options qui consistent à :
  
     Option 1 : Importation des paramètres d'un environnement MAPPING vers un autre (Ex : MAP400BIS)
+
     Option 1 : Importation de la configuration d'un autre environnement MAPPING (Ex : MAP400BIS)
 
     Option 2 : Création d'un nouvel environnement (Ex : MAP400TER) à partir d'un autre environnement MAPPING (MAP400 et/ou MAP400BIS et/ou autres)
 
     Option 2 : Création d'un nouvel environnement (Ex : MAP400TER) à partir d'un autre environnement MAPPING (MAP400 et/ou MAP400BIS et/ou autres)
 
     Option 3 : Mise en place de ce nouvel environnement (MAP400TER) sur le serveur de production (A utiliser que si le serveur de production n'est pas le même que le serveur de dev)
 
     Option 3 : Mise en place de ce nouvel environnement (MAP400TER) sur le serveur de production (A utiliser que si le serveur de production n'est pas le même que le serveur de dev)
Ligne 32 : Ligne 32 :
 
     MAP400 : bibliotèque d'origine copié (Exemple : Production)
 
     MAP400 : bibliotèque d'origine copié (Exemple : Production)
 
     MAP400BIS : bibliotèque intermédiaire à créer (Exemple : Qualification)
 
     MAP400BIS : bibliotèque intermédiaire à créer (Exemple : Qualification)
     MAP400BIS : Nouvelle bibliotèque finale à créer (Exemple : Future production)
+
     MAP400TER : Nouvelle bibliothèque finale à créer (Exemple : Future production)
 
     MAP400.SAVF : Fichier SAVF contenant la bibliotèque à dupliquer (Exemple : Production)
 
     MAP400.SAVF : Fichier SAVF contenant la bibliotèque à dupliquer (Exemple : Production)
 
     SAVIFS.SAVF : Fichier SAVF contenant le contenu du répertoire /home/mapping à copier (Exemple : Production)
 
     SAVIFS.SAVF : Fichier SAVF contenant le contenu du répertoire /home/mapping à copier (Exemple : Production)
     SAVIFSQ.SAVF : Fichier SAVF contenant le contenu du répertoire /home/MAPQOPALE/mapping à copier (Exemple : Qualification)
+
     SAVIFSQ.SAVF : Fichier SAVF contenant le contenu du répertoire /home/MAP400BIS/mapping à copier (Exemple : Qualification)
  
Nom du programme
+
==Nom du programme==
  
 
MAPDUPENV
 
MAPDUPENV
Version
 
  
Disponible à partir de la version : v10.0.3b.38092
+
==Version==
Appel du programme
+
 
 +
Disponible à partir de la version : IBM-i v10.0 (OPALE)
 +
 
 +
==Appel du programme==
  
 
CALL PGM(MAPDUPENV)
 
CALL PGM(MAPDUPENV)
Détails techniques
 
Menu principal :
 
  
L'appel du programme devra afficher un menu mettant en avant 3 options distinctes :
+
==Détails techniques==
 +
===Menu principal===
 +
 
 +
L'appel du programme (CALL PGM(MAPDUPENV) affiche un menu mettant en avant 3 options distinctes :
 +
 
 +
    Option 1 : Importation de la configuration d'un autre environnement MAPPING
 +
    Option 2 : Création d'un nouvel environnement à partir d'un autre environnement MAPPING (MAP400 et/ou MAP400BIS et/ou autres)
 +
    Option 3 : Mise en place de ce nouvel environnement sur autre autre serveur distant (Dans notre use case, A utiliser que si le serveur de production n'est pas le même que le serveur de dev)
 +
 
 +
====Option 1 : Importation des paramètres d'un environnement MAPPING vers un autre====
 +
=====Prérequis=====
 +
*SAVF de la bibliothèque source MAP400            (SAVOBJ OBJ(*ALL) LIB(MAP400) DEV(*SAVF) SAVF(QGPL/MAP400)
 +
*SAVF du contenu du répertoire IFS /home/mapping/ SAV DEV('/qsys.lib/QGPL.lib/MAPIFS.FILE') OBJ(('/home/MAP400/*'))
 +
 
 +
*Avoir installé un nouvel environnement (Ex : MAP400BIS) avec le setup correspondant sur l'environnement de destination.
 +
 
 +
=====Principes techniques=====
 +
L'option 1 consiste à importer les objets de l'environnement source MAP400 (règles, actions, maquettes) vers l'environnement courant (MAP400BIS). Cela aura pour but d'alimenter un deuxième environnement avec le contenu du premier en le rendant étanche par rapport à ce premier. <br>
 +
(Exemple : Créer un environnement pour tester une mise à jour)
 +
 
 +
=====Ecran=====
 +
 
 +
L'écran contient les paramètres suivants :
 +
 
 +
Environnement de destination    (1)            (Ex : MAP400BIS)                                       
 +
                                         
 +
                                         
 +
                                         
 +
Environnement d'origine : (2)                  (Ex : MAP400)               
 +
                                         
 +
Nom du savefile pour la biblio : (3)          (Ex : SAV400)         
 +
Nom du savefile pour l'IFS . . (4)            (Ex : SAVIFS)
 +
 
 +
(1) Environnement de destination : Environnement MAPPING courant (MAPENV en ligne)<br>
 +
(2) Environnement d'origine : Nom de la bibliothèque MAPPING présent dans le SAVFILE indiqué dans le paramètre (3)  <br>
 +
(3) Nom du savefile pour la biblio : Nom du savfile contenant la bibliothèque source (sans extension) (Ex : SAV400)  <br>
 +
(4) Nom du savefile pour l'IFS : Nom du savfile contenant le contenu du répertoire IFS mapping (sans extension) (Ex : SAVIFS) <br>
  
    Option 1 : Copie des objets dans un nouvel environnement existant avec modification de valeurs
+
=====Résultat final obtenu=====
    Option 2 : Duplication d'un environnement à partir d'un ou des autres environnements avec modifications de valeurs (Sans lancer le nouveau setup)
 
    Option 3 : Duplication d'un environnement MAPPING à l'identique (Sans aucune modification)
 
  
Option 1 : Importation des paramètres d'un environnement MAPPING vers un autre
+
Nouvel environnement (MAP400BIS) prêt à l'emploi ISO avec l'environnement copié (Exemple:MAP400) (avec toutes les OUTQs monitorées dans MAP400BIS) à l'exception des clés logiciels.
 +
Le sous système de l'environnement MAP400BIS arrêté
  
L'option 1 consiste à importer les objets de l'environnement source MAP400 (règles, actions, maquettes) vers l'environnement courant (MAP400BIS). Cela aura pour but d'alimenter un deuxième environnement avec le contenu du premier en le rendant étanche par rapport à ce premier. (Exemple : Créer un environnement pour tester une mise à jour)
+
====Option 2 : Création d'un nouvel environnement à partir d'un autre====
Prerequis
 
  
    SAVF de la bibliothèque source MAP400 dans le cas où les 2 environnements sont sur 2 machines distinctes.
 
    SAVF du contenu du répertoire IFS /home/mapping/ dans le cas où les 2 environnements sont sur 2 machines distinctes.
 
    Avoir installé un nouvel environnement (MAP400BIS) avec le setup correspondant sur l'environnement de destination.
 
  
Ecran :
+
=====Prérequis=====
 +
Avoir un autre environnement validé (Ex : MAP400BIS)
  
L'écran devra contenir les paramètres suivants :
+
=====Principes techniques=====
 +
L'option 2 consiste à la création de l'environnement de production (Ex : MAP400TER) se basant sur un autre (Ex : MAP400BIS). (sans devoir lancer de setup) <br>
 +
(Exemple : Créer un environnement de production (Ex : MAP400TER) à partir d'un environnement de qualification validé (Ex : MAP400BIS))
  
    Nom de l'environnement de destination : Valeur non modifiable prennant l'environnement stipulé dans la MAPENV en ligne
+
=====Ecran=====
    Nom du savf ou bib référent (Défaut : "")
 
        Avoir une coche SAVF à cocher dans le cas d'un savf et avoir les 2 champs qui arraissent pour renseigner les 2 savf (IFS et BIB)
 
        Sinon avoir un champs qui apparait afin de taper le nom de la bib référent MAP400 (Le programme va alors copier le contenu du chemin IFS de la MAPENV MAP400)
 
  
Le programme va devoir faire la copie des objets suivants selon les paramètres suivants :
+
L'écran contient les paramètres suivants :
  
    MAP400 --> MAP400BIS
+
Environnement courant                      (1)                (Ex : MAP400BIS)                   
        CLES : non Ne pas récupérer les clefs
+
Environnement d'origine                    (2)               (Ex : MAP400)                                
        MAPENV :
+
                                                           
            Récupération à l'identique que la production
+
Nom du savefile pour la biblio             (3)          (Ex : SAV400)                     
                Identifiant de la société
+
Nom du savefile pour l'IFS . .            (4)          (Ex : SAVIFS)                 
                Fichier Langue + ID Langue
+
Nouvel environnement à créer .             (5)                           
                Port de connexion M-Connect
+
Nom du sous-système  . . . . .  MAPS      (6)                     
                Version d'archivage
+
Copie de                        Origine :   *ORIGINAL *CURRENT  *NONE
                Séparateur de millier
+
Paramètres d'environnement . .  *CURRENT                   
                Support Unicode
+
Règles Mapping . . . . . . . .  *CURRENT                   
                ID Caractère et Page de Code
+
Actions  . . . . . . . . . . .  *CURRENT                   
                Table de conversion (Archivage)
+
Relations entre outq . . . . .  *CURRENT                   
                Table de conversion (Importation)
+
Paramètres imprimantes . . . .  *CURRENT                      
                Longueur écriture sur PRTF M-Storage
+
Formats Mapping  . . . . . . .  *CURRENT                   
                Nouveau nom de spool
+
Taux de conversion . . . . . .  *CURRENT                   
                Cumul FDP, police et spool
+
Paramètres des mails . . . . .  *CURRENT                   
                Adresse IP
+
Historique des mails . . . . .  *CURRENT                   
                Port
+
Formats M-Connect  . . . . . .  *CURRENT
                Langue
 
             Valeurs à modifier
 
                Bibliothèque des Programmes --> MAP400BIS
 
                Bibliothèque des Fichiers --> MAP400BIS
 
                Chemin d'archivage de M-Storage --> /home/MAP400BIS/mapout/
 
                Chemin du dossier des Fonds de Page --> /home/MAP400BIS/mapping/
 
                Chemin du dossier M-Connect --> /home/MAP400BIS/mapreport/
 
        ACTIONS:
 
            Récupération à l'identique que la production
 
                ACTION
 
                ACTLIG
 
        REGLES :
 
             Valeurs à modifier
 
                SPLMAP
 
                    Remplacer les paramètres suivants :
 
                        Toutes les conditions des opérateurs d'OUTQ d'entrée xxx/OUTQIN en MAP400BIS/OUTQIN)
 
        RELATIONS ENTRE OUTQS :
 
            Valeurs à modifier
 
                OUTOUT
 
                     Remplacer les paramètres suivants :
 
                        OUTQIN : Garder les noms des outqin les même mais changer leurs bibliotèque en MAP400BIS
 
                        OUTQOUT : Ne rien changer
 
                        DATAQ : Garder les noms de DATAQ le mêmes mais changer leurs bibliotèque en MAP400BIS
 
        FORMATS DESIGNER :
 
            Récupération à l'identique que la production
 
                MAPOBJ
 
                MAPLNK
 
                MAPLNKL1
 
                MAP3
 
                MAP3L1
 
                MAP1
 
                MAP2D
 
                MAP2H
 
                MAP
 
  
Restauration du SAVIFS.SAVF et placer son contenu dans /home/MAP400BIS/mapping/ ou copie direct IFS si pas SAVF####
+
(1) Environnement en cours: Environnement MAPPING courant (MAPENV en ligne)<br>
Récupération des paramètres d'emails
+
(2) Environnement d'origine : Nom de la bibliothèque MAPPING présente dans le SAVFILE indiqué dans le paramètre (3)  <br>
 +
(3) Nom du savefile pour la biblio : Nom du savfile contenant la bibliothèque source (sans extension) (Ex : SAV400)  <br>
 +
(4) Nom du savefile pour l'IFS : Nom du savfile contenant le contenu du répertoire IFS mapping (sans extension) (Ex : SAVIFS) <br>
 +
(5) Nouvel environnement à créer : Nom du nouvel environnent à créer (Ex : MAP400TER) <br>
 +
(6) Nom du nouveau sous système à créer : Nom du nouveau sous système à créer (Ex : MAPS400TER) <br>
 +
A CONTINUER
  
    Détails à rajouter
 
  
Récupération des format Connect
+
*CURRENT  : Prendre les données de l'environnement courant  (Ex : MAP400BIS)<br/>
 +
*ORIGINAL : Prendre les données de l'environnement d'origine (Ex : MAP400 se situant dans le savfile SAV400)<br/>
 +
*NONE : Aucune récupération. Les objets seront créés à blanc.<br/>
  
    Détails à rajouter
 
  
Création des OUTQIN dans MAP400BIS
+
=====Résultat final obtenu=====
Reveil des liens entre les OUTQ et DATAQ
 
Résultat obtenu à la fin des traitements de l'option 1 :
 
  
    Bibliothèque MAP400BIS prête à l'emploi ISO avec l'environnement copié (Exemple:production) (avec toutes les OUTQs monitorées dans MAP400BIS) à l'exception des clés logiciels.
+
Nouvel environnement (MAP400TER) prêt à l'emploi incluant les objets copiés avec les environnement COURANT et/ou d'ORIGINE (Exemple:MAP400 et/ou MAP400BIS) à l'exception des clés logiciels.
    Le sous système de l'environnement MAP400BIS arrêté
+
Le sous système de l'environnement MAP400TER arrêté

Version actuelle datée du 18 janvier 2021 à 09:54

Introduction

Ce programme tourne exclusivement sur IBM-i. Celui-ci permet de façiliter les duplications d'environnements MAPPING IBM-i.

Cas d'usages possibles

Il y a plusieurs cas d'usages possibles pour ce programme :

  • Besoin de duplication d'un environnement à l'identique (Pour faire des tests sans impacter l'environnement de production)
  • Besoin de duplication d'un environnement avec une version plus récente afin de préparer une mise à jour.
  • Besoin de création d'un environnement à partir d'un autre environnement sans passer par le setup


Ce programme composé de 3 options qui consistent à :

   Option 1 : Importation de la configuration d'un autre environnement MAPPING (Ex : MAP400BIS)
   Option 2 : Création d'un nouvel environnement (Ex : MAP400TER) à partir d'un autre environnement MAPPING (MAP400 et/ou MAP400BIS et/ou autres)
   Option 3 : Mise en place de ce nouvel environnement (MAP400TER) sur le serveur de production (A utiliser que si le serveur de production n'est pas le même que le serveur de dev)

Limites

   Ce programme ne gère pas les cas où la bibliotèque de fichiers est différente de celle de programmes.
   Ce programme ne gère pas les appel de CL dans les actions (L'exécution de ces CLs sur MAP400BIS pourront impacter MAP400)
   Ce programme ne gère pas les clefs. Les clefs devront être entrées dans les nouveaux environnements.
   Les outqs monitorées par MAPPING ne peuvent pas avoir le même nom dans des libs différentes. (exemple : QUSRSYS/OUTQIN et QGPL/OUTQIN)

Suppositions

Dans cette documentation, on prend pour supposition les choses suivantes :

   IFS de production : /home/mapping
   MAP400 : bibliotèque d'origine copié (Exemple : Production)
   MAP400BIS : bibliotèque intermédiaire à créer (Exemple : Qualification)
   MAP400TER : Nouvelle bibliothèque finale à créer (Exemple : Future production)
   MAP400.SAVF : Fichier SAVF contenant la bibliotèque à dupliquer (Exemple : Production)
   SAVIFS.SAVF : Fichier SAVF contenant le contenu du répertoire /home/mapping à copier (Exemple : Production)
   SAVIFSQ.SAVF : Fichier SAVF contenant le contenu du répertoire /home/MAP400BIS/mapping à copier (Exemple : Qualification)

Nom du programme

MAPDUPENV

Version

Disponible à partir de la version : IBM-i v10.0 (OPALE)

Appel du programme

CALL PGM(MAPDUPENV)

Détails techniques

Menu principal

L'appel du programme (CALL PGM(MAPDUPENV) affiche un menu mettant en avant 3 options distinctes :

   Option 1 : Importation de la configuration d'un autre environnement MAPPING
   Option 2 : Création d'un nouvel environnement à partir d'un autre environnement MAPPING (MAP400 et/ou MAP400BIS et/ou autres)
   Option 3 : Mise en place de ce nouvel environnement sur autre autre serveur distant (Dans notre use case, A utiliser que si le serveur de production n'est pas le même que le serveur de dev)

Option 1 : Importation des paramètres d'un environnement MAPPING vers un autre

Prérequis
  • SAVF de la bibliothèque source MAP400 (SAVOBJ OBJ(*ALL) LIB(MAP400) DEV(*SAVF) SAVF(QGPL/MAP400)
  • SAVF du contenu du répertoire IFS /home/mapping/ SAV DEV('/qsys.lib/QGPL.lib/MAPIFS.FILE') OBJ(('/home/MAP400/*'))
  • Avoir installé un nouvel environnement (Ex : MAP400BIS) avec le setup correspondant sur l'environnement de destination.
Principes techniques

L'option 1 consiste à importer les objets de l'environnement source MAP400 (règles, actions, maquettes) vers l'environnement courant (MAP400BIS). Cela aura pour but d'alimenter un deuxième environnement avec le contenu du premier en le rendant étanche par rapport à ce premier.
(Exemple : Créer un environnement pour tester une mise à jour)

Ecran

L'écran contient les paramètres suivants :

Environnement de destination    (1)            (Ex : MAP400BIS)                                         
                                          
                                          
                                          
Environnement d'origine : (2)                  (Ex : MAP400)                
                                          
Nom du savefile pour la biblio : (3)           (Ex : SAV400)           
Nom du savefile pour l'IFS . . (4)             (Ex : SAVIFS)

(1) Environnement de destination : Environnement MAPPING courant (MAPENV en ligne)
(2) Environnement d'origine : Nom de la bibliothèque MAPPING présent dans le SAVFILE indiqué dans le paramètre (3)
(3) Nom du savefile pour la biblio : Nom du savfile contenant la bibliothèque source (sans extension) (Ex : SAV400)
(4) Nom du savefile pour l'IFS : Nom du savfile contenant le contenu du répertoire IFS mapping (sans extension) (Ex : SAVIFS)

Résultat final obtenu

Nouvel environnement (MAP400BIS) prêt à l'emploi ISO avec l'environnement copié (Exemple:MAP400) (avec toutes les OUTQs monitorées dans MAP400BIS) à l'exception des clés logiciels. Le sous système de l'environnement MAP400BIS arrêté

Option 2 : Création d'un nouvel environnement à partir d'un autre

Prérequis

Avoir un autre environnement validé (Ex : MAP400BIS)

Principes techniques

L'option 2 consiste à la création de l'environnement de production (Ex : MAP400TER) se basant sur un autre (Ex : MAP400BIS). (sans devoir lancer de setup)
(Exemple : Créer un environnement de production (Ex : MAP400TER) à partir d'un environnement de qualification validé (Ex : MAP400BIS))

Ecran

L'écran contient les paramètres suivants :

Environnement courant                      (1)                (Ex : MAP400BIS)                    
Environnement d'origine                    (2)                (Ex : MAP400)                                  
                                                            
Nom du savefile pour la biblio             (3)          (Ex : SAV400)                      
Nom du savefile pour l'IFS . .             (4)          (Ex : SAVIFS)                   
Nouvel environnement à créer .             (5)                            
Nom du sous-système  . . . . .  MAPS       (6)                      
Copie de                        Origine :   *ORIGINAL *CURRENT  *NONE
Paramètres d'environnement . .  *CURRENT                     
Règles Mapping . . . . . . . .  *CURRENT                     
Actions  . . . . . . . . . . .  *CURRENT                     
Relations entre outq . . . . .  *CURRENT                     
Paramètres imprimantes . . . .  *CURRENT                     
Formats Mapping  . . . . . . .  *CURRENT                     
Taux de conversion . . . . . .  *CURRENT                     
Paramètres des mails . . . . .  *CURRENT                     
Historique des mails . . . . .  *CURRENT                     
Formats M-Connect  . . . . . .  *CURRENT

(1) Environnement en cours: Environnement MAPPING courant (MAPENV en ligne)
(2) Environnement d'origine : Nom de la bibliothèque MAPPING présente dans le SAVFILE indiqué dans le paramètre (3)
(3) Nom du savefile pour la biblio : Nom du savfile contenant la bibliothèque source (sans extension) (Ex : SAV400)
(4) Nom du savefile pour l'IFS : Nom du savfile contenant le contenu du répertoire IFS mapping (sans extension) (Ex : SAVIFS)
(5) Nouvel environnement à créer : Nom du nouvel environnent à créer (Ex : MAP400TER)
(6) Nom du nouveau sous système à créer : Nom du nouveau sous système à créer (Ex : MAPS400TER)
A CONTINUER


  • CURRENT : Prendre les données de l'environnement courant (Ex : MAP400BIS)
  • ORIGINAL : Prendre les données de l'environnement d'origine (Ex : MAP400 se situant dans le savfile SAV400)
  • NONE : Aucune récupération. Les objets seront créés à blanc.


Résultat final obtenu

Nouvel environnement (MAP400TER) prêt à l'emploi incluant les objets copiés avec les environnement COURANT et/ou d'ORIGINE (Exemple:MAP400 et/ou MAP400BIS) à l'exception des clés logiciels. Le sous système de l'environnement MAP400TER arrêté