OPALE - 10.1

Programme de Duplication d'environnements MAPDUPENV

De MappingDoc
Révision datée du 26 février 2020 à 08:16 par Jdieu (discussion | contributions) (Détails techniques)

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 de 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 des paramètres d'un environnement MAPPING vers un autre (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 des paramètres d'un environnement MAPPING vers un autre
   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 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.
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 devra contenir les paramètres suivants :

   Nom de l'environnement de destination : Valeur non modifiable prennant l'environnement stipulé dans la MAPENV en ligne
   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 :

   MAP400 --> MAP400BIS
       CLES : non Ne pas récupérer les clefs
       MAPENV :
           Récupération à l'identique que la production
               Identifiant de la société
               Fichier Langue + ID Langue
               Port de connexion M-Connect
               Version d'archivage
               Séparateur de millier
               Support Unicode
               ID Caractère et Page de Code
               Table de conversion (Archivage)
               Table de conversion (Importation)
               Longueur écriture sur PRTF M-Storage
               Nouveau nom de spool
               Cumul FDP, police et spool
               Adresse IP
               Port
               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#### Récupération des paramètres d'emails

   Détails à rajouter

Récupération des format Connect

   Détails à rajouter

Création des OUTQIN dans MAP400BIS 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.
   Le sous système de l'environnement MAP400BIS arrêté