MODE OPERATOIRE GLOBAL GCC / CHANGE MAN

65469783.doc

page 1/46

16/11/2004

SOMMAIRE1. REMARQUES PRELIMINAIRES.............................................................................................................................................4 2. GUIDE DES BONNES PRATIQUES ET USAGES SOUS CMN...........................................................................................4 2.1. CHANGEMAN ET LES SESSIONS MULTIPLES........................................................................................................................................4 2.2. CHOIX DU MODE DE MISE EN PRODUCTION DU PACKAGE......................................................................................................................4 2.3. UTILISATION DES VERSIONS INTERMDIAIRES DANS UN PACKAGE..........................................................................................................5 2.4. PROMOTION DANS UN ENVIRONNEMENT DE TEST DE NIVEAU SUPRIEUR.................................................................................................5 2.5. AJOUT ET SUPPRESSION DE LISTES DAPPROBATION.............................................................................................................................5 3. GESTION DES PACKAGES (NORMAUX, HORS ASTREINTE)........................................................................................7 3.1. GNRALITS SUR LES PACKAGES ...................................................................................................................................................7 3.2. CRATION DE PACKAGES ...............................................................................................................................................................7 3.3. DCOUPER UN PACKAGE EN PLUSIEURS PACKAGES..............................................................................................................................7 3.4. REGROUPER N PACKAGES EN UN SEUL.............................................................................................................................................8 3.5. TRANSFORMER DES PACKAGES SIMPLES EN PARTICIPATING .......................................................................................................8 3.6. DESTRUCTION DUN PACKAGE.........................................................................................................................................................9 3.7. COMPRESSION DES BIBLIOTHQUES DE STAGING................................................................................................................................9 4. ASTREINTES RPARATION DE PLANTAGE LA NUIT OU EN JOURNE.............................................................10 4.1. GNRALITS SUR LES PACKAGES DE TYPE 'ASTREINTE'.............................................................................................................10 4.2. CYCLE DE VIE ASTREINTE ...............................................................................................................................................10 4.2.1. Remise immdiate en production de la version prcdente.....................................................................................10 4.2.2. Ralisation dune correction en Astreinte......................................................................................................................10 4.3. CE QUE VOUS DEVEZ TOUJOURS FAIRE LE LENDEMAIN DUNE ASTREINTE......................................................................................12 4.4. MODE DEMPLOI DE LA COMMANDE TSO CMNPASP..................................................................................................................12 4.4.1. Introduction....................................................................................................................................................................13 4.4.2. Utilisation.......................................................................................................................................................................13 5. LES DBUGGEURS .................................................................................................................................................................15 5.1. SMARTTEST.............................................................................................................................................................................15 5.2. ABEND-AID.............................................................................................................................................................................16 5.2.1. Principes gnraux dutilisation....................................................................................................................................16 5.2.2. Comment r-alimenter lAbend-Aid dun couloir aprs puration ?.............................................................................16 5.2.3. Comment alimenter lAbend-Aid de Production ?.........................................................................................................17 6. GESTION DES PROGRAMMES PRINCIPIA.......................................................................................................................19 6.1. LES GRANDS PRINCIPES................................................................................................................................................................19 6.2. QUELQUES DFINITIONS IMPORTANTES ...........................................................................................................................................19 6.3. COMMENT MODIFIER UN SOURCE PRINCIPIA..............................................................................................................................20 6.3.1. Remarques prliminaires................................................................................................................................................20 6.3.2. Modifications PRO uniquement.....................................................................................................................................20 6.3.3. Modifications SFD ncessaires......................................................................................................................................20 6.4. NOUVEAU PROCESSUS DE CRATION DANS PRINCIPIA .................................................................................................................21 6.4.1. Quelques rgles spcifiques aux composants PRINCIPIA pour bien grer les dveloppements parallles............21 7. GESTION DES PROGRAMMES NON PRINCIPIA.............................................................................................................25 7.1. CRATION DUN NOUVEAU PROGRAMME........................................................................................................................................25 7.2. MODIFICATION DUN PROGRAMME EXISTANT..................................................................................................................................25 8. GESTION DES PROGRAMMES CLONS OU DE TRAVAIL..........................................................................................26 8.1. CRATION DUN NOUVEAU PROGRAMME CLON...............................................................................................................................26 8.2. MODIFICATION DUN PROGRAMME CLON......................................................................................................................................26 9. GESTION DES COPY .............................................................................................................................................................27 9.1. CRATION DUN NOUVEAU COPY...............................................................................................................................................27 9.2. MODIFICATION DUN COPY EXISTANT.............................................................................................................................................27 10. GESTION DE L HISTO MODIFS ...................................................................................................................................28 11. GESTION DES TABLES SOURCES ET PROGRAMMES TABLE ASSEMBLEUR.....................................................29 11.1. MODIFICATION DU PROGRAMME DE GNRATION DE TABLE SOURCE................................................................................................2965469783.doc

page 2/46

16/11/2004

11.2. MODIFICATION DE TABLE SOURCE OU DE PROGRAMME TABLE ASSEMBLEUR....................................................................................29 11.3. CRATION OU MODIFICATION DES PARAMTRES DU PROGRAMME DE GNRATION...............................................................................29 12. GESTION DES MAPS SFD2...................................................................................................................................................30 12.1. MISE JOUR DE MAP SFD2...................................................................................................................................................30 12.2. CRATION DE MAP SFD2.......................................................................................................................................................30 13. GESTION DES MODIFICATIONS DB2..............................................................................................................................31 13.1. CRATION DUNE NOUVELLE TABLE............................................................................................................................................31 13.2. MODIFICATION DUNE TABLE EXISTANTE......................................................................................................................................31 13.3. CRATION ET MODIFICATION DE DCLGEN................................................................................................................................31 13.4. MODIFICATION DUNE SYSIN DE BIND...........................................................................................................................................31 14. RSOLUTION DES CONTRLES DAUDIT.....................................................................................................................32 15. PREPARATION DES LIVRAISONS (TOUT COULOIR SAUF PRODUCTION) .........................................................36 15.1. PREMIRE LIVRAISON DANS UN COULOIR ......................................................................................................................................36 15.2. MODIFICATION ET RE-LIVRAISON DANS LE MME COULOIR DUN COMPOSANT.....................................................................................37 15.3. SUPPRESSION DUN COMPOSANT ET IMPACT SUR LES COULOIRS.........................................................................................................37 15.4. UTILISATION DARMIDE DANS LES COULOIRS DE TEST ET RECETTE...............................................................................................38 15.4.1. Cration dune nouvelle Table.....................................................................................................................................38 15.4.2. Modification dune table existante...............................................................................................................................38 15.4.3. Cration et Modification de PTE.................................................................................................................................38 15.4.4. Avec quelle version on teste ?......................................................................................................................................38 15.4.5. Comment tester avec la version X ?.............................................................................................................................38 16. PREPARATION DES LIVRAISONS EN PROD !...............................................................................................................38 16.1. DERNIER AUDIT DU PACKAGE.....................................................................................................................................................38 16.2. FREEZE DU PACKAGE.................................................................................................................................................................38 17. APPROBATION.......................................................................................................................................................................39 17.1. RCEPTION ET ANALYSE DUN MESSAGE DAPPROBATION ...............................................................................................................39 17.2. ANALYSE RAPIDE DU PACKAGE ..................................................................................................................................................39 17.3. APPROUVER (OU REJETER) UN PACKAGE ......................................................................................................................................40 18. INSTALLATION EN PRODUCTION...................................................................................................................................40 18.1. PACKAGES NORMAUX (PLANNED)..........................................................................................................................................40 18.2. PACKAGES DASTREINTE (UNPLANNED)........................................................................................................................................41 19. COMMENT EFFECTUER UN BACKOUT (-1) EN PRODUCTION................................................................................41 19.1. BACKOUT PROGRAMME OU PACKAGE ?.......................................................................................................................................41 19.2. BACKOUT TP ET BATCH...........................................................................................................................................................41 20. DCLARATION DE TRANSACTION AVEC ENCH .......................................................................................................41 21. GESTION DES JCL(S) SOUS CHANGEMAN....................................................................................................................43 21.1. COMMENT UTILISER LES MODLES DE JCLS GNRS PAR CHANGEMAN ?.................................................................................43 21.1.1. Tester un programme avec le JCL existant..................................................................................................................43 21.1.2. Rgnration du JCL existant......................................................................................................................................43 21.1.3. Mise jour du JCL existant..........................................................................................................................................44 21.1.4. Cration du JCL dun nouveau programme.................................................................................................................44 21.1.5. Tester les modifications de JCL directement................................................................................................................44 21.1.6. Tester le JCL et le programme en Promotion..............................................................................................................44 21.1.7. Liste des variables de JCL disponibles........................................................................................................................44 21.2. COMMENT PARAMTRER VOS JCLS PERSONNELS POUR UN COULOIR DONN ?.....................................................................................45 22. RCAPITULATIF DES RACCOURCIS CHANGEMAN..................................................................................................46 22.1. GNRALITS...........................................................................................................................................................................46 22.2. LISTE DES COMMANDES DE LOPTION PACKAGE LIST......................................................................................................................46

65469783.doc

page 3/46

16/11/2004

1. REMARQUES PRELIMINAIRES Dans tout le document, lorsque lon fait rfrence une commande sur 2 caractres (ex : S2, C1, D1, etc) sans prciser le menu ou le panel, il sagit toujours des commandes raccourcis disponibles via loption 5 Package List du menu principal.

2. GUIDE DES BONNES PRATIQUES ET USAGES SOUS CMN2.1. ChangeMan et les sessions multiplesVous pouvez avoir plusieurs sessions TSO ouvertes simultanment (split), mais vous ne devez tre connect ChangeMan que sur UNE SEULE SESSION la fois : il est interdit de se connecter ChangeMan sur 2 ou plusieurs sessions TSO en mme temps ! N.B. : la Cellule Technique ne prendra pas en charge les problmes engendrs par ce type dutilisation de loutil ChangeMan.

2.2. Choix du mode de mise en production du packageAvant de crer votre package, il faut dterminer le type de package que vous allez utiliser, car cette caractristique ne peut plus tre modifie par la suite. CAS GENERAL (autoris tous) : pour toutes les volutions courantes, projets court, moyen ou long terme : choisissez le type PLANNED : votre package devra respecter les contrles de qualit et daudit, et il sera actif en Production ds le soir du jour o vous laurez approuv et install Cas exceptionnels (ncessitant lhabilitation Astreinte ) : 1. Uniquement pour les dveloppements activer immdiatement en Production, en pleine journe, sans attendre le soir : choisissez le type PLANNED approuvez votre package au plus vite attendez quil soit install et mis en baseline (statut BAS ) ensuite, demandez un responsable/analyste ayant les droits dAstreinte dexcuter la commande TSO CMNPASP (voir plus loin le chapitre Mode demploi de la commande TSO CMNPASP ), en prcisant le n de votre package, pour forcer lactivation immdiate de votre package dans les bibliothques batch et/ou TP de Production (sur Alpha/Beta), sans attendre le soir. ATTENTION : lutilisation de cette commande est exclusivement rserve aux personnes ayant les droits dastreinte ! 2. Uniquement pour les cas de debugging urgent en Production lors des astreintes : choisissez le type UNPLANNED : votre package passera outre les contrles de qualit et daudit, et il sera actif en Production immdiatement, ds que vous laurez approuv et install en revanche, votre changement ne restera que 5 jours maximum en production, et vos composants ne seront pas visibles dans le rfrentiel de baseline pour que votre changement persiste en Production, vous serez oblig, ds le jour ouvr suivant, de le remettre en production de manire propre , via un package de type PLANNED qui devra respecter toutes les normes et contrles.

65469783.doc

page 4/46

16/11/2004

2.3. Utilisation des versions intermdiaires dans un packageIl est possible de faire sauvegarder par ChangeMan, pour chaque composant dun package, des versions de travail intermdiaires qui permettent, si ncessaire, de revenir en arrire dans le package lorsquun dveloppement commence se fourvoyer. ChangeMan propose, chaque fois quun composant va tre altr (checkout, stage/edit), de sauvegarder au pralable la version prsente dans le package Par dfaut, afin de ne pas encombrer et ralentir le systme par abus de versions intermdiaires, la zone Save Version (panel Save Previous Version ) est alimente NO il est demand de ne la passer YES que lorsque vous voulez sauvegarder une version intermdiaire majeure de votre dveloppement. Pensez faire rgulirement le mnage de vos versions intermdiaires devenues inutiles (suite lenregistrement dautres versions intermdiaires plus avances et plus stables) : si vous ne le faites pas vous-mme, un des traitements batch du housekeeping (nettoyage) ChangeMan sen chargera, mais sur la base dun quota de nombre maxi. autoris par tranche danciennet !

2.4. Promotion dans un environnement de test de niveau suprieurLorsquon veut faire avancer son package dun environnement de tests donn (ex : Tests Unitaires) vers un environnement de tests de niveau suprieur (ex : Recette), il faut imprativement retirer le package du niveau infrieur (Tests Unitaires) afin de librer ce niveau pour dautres dveloppements, et dviter ainsi de provoquer des messages inutiles de risque dcrasement avec dautres dveloppeurs.

2.5. Ajout et suppression de listes dapprobation La dfinition et la modification (ajout ou suppression) des listes dapprobation dun package seffectuent : o A la cration du package, sur le panel CREATE: Package ECRD Users Variables o A tout moment ensuite, tant que le package nest pas gel, par la commande UE (panel UPDATE: Package ECRDnnnnnn Users Variables ) Lorsquun package est cr, une liste appele Approbation par defaut est automatiquement associe au package (pour des raisons de contraintes techniques), et ChangeMan approuvera automatiquement le package avec cette liste, ds la fin du Freeze N.B. : si pour une raison quelconque, cette liste ntait pas approuve automatiquement par ChangeMan, vous pouvez vous-mme lapprouver (approbation autorise pour toutes les Etudes). Outre cette liste obligatoire, vous devez dfinir, pour votre package, au moins 1 liste dapprobation supplmentaire, de niveau Etudes : ces listes sont reconnaissables par leur nom qui commence par EGS Si votre package bnficie dune phase de Recette, vous devrez dfinir au moins 1 liste dapprobation supplmentaire de niveau Coordination / Recette : ces listes sont reconnaissables par leur nom qui commence par CI Attention : cette fonctionnalit ne sera pas disponible dans limmdiat Si un package est cheval sur plusieurs quipes (de dveloppement, de recette), il est possible de rajouter dautres listes de niveau CI et/ou EGS (jusqu 3 listes par type) Il est galement possible dajouter des listes spciales de type cellule technique ou systme Pour ajouter une nouvelle liste dapprobateurs :65469783.doc

page 5/46

16/11/2004

o o

Commande UE Dans la zone correspondante (EGS, CI ou Other), taper le nom du groupe dapprobateurs ajouter OU le slectionner dans une liste (voir ci-aprs Cration de Packages )

Pour supprimer une liste dapprobateurs dclare : o Commande UE o Dans la zone correspondante (EGS, CI ou Other), effacer le nom de la liste

65469783.doc

page 6/46

16/11/2004

3. GESTION DES PACKAGES (Normaux, hors Astreinte)3.1. Gnralits sur les packages Se rfrer la Charte de cration de package, en en omettant tout ce qui concerne la sparation batch/TP, devenue obsolte.

3.2. Cration de packages Prciser le titre du package : les titres doivent tre diffrents pour pouvoir distinguer les packages. Mettre le numro de tche Gemini dans la zone Work Request ID Indiquer limpact de votre modification Instructions dInstallation : ce panel est inutile (cest la MEP qui fait foi !) renseigner les 2 zones de texte obligatoires avec le commentaire sans objet ou N/A (Non Applicable) Dans le panel Users Variables , prciser : Le couloir de test unitaire : TFRB, TFRC, TS2B, Taper ENTER pour gnrer la commande TSO XC$LCONF en ligne commande Taper ENTER nouveau pour excuter la commande et obtenir la liste des couloirs Slectionner votre couloir de test en tapant S devant, puis PF3 Saisir une * dans la zone souhaite pour coller votre slection. Au minimum 1 approbateur EGS : Taper ENTER pour gnrer la commande TSO XCMNAPRV (avec = EGS ou CI ) en ligne commande Taper ENTER nouveau pour excuter la commande et obtenir la liste des approbateurs, Slectionner votre groupe dapprobateurs en tapant S devant, puis PF3 Puis saisir une * dans la zone o vous voulez coller votre slection. Liste des sites slectionner pour linstallation : ATTENTION bien conserver tous les sites qui apparaissent ! Alimenter les date/heures dinstallation et les correspondants Etudes, de manire identique pour tous les sites.

3.3. Dcouper un package en plusieurs packagesVous pourrez avoir besoin de dcouper un package en plusieurs packages, par exemple pour une livraison partielle avance dun lot restreint de dveloppement. On va considrer que lon veut dcouper un package (package 1) en 2 packages (packages 1 et 2) : le cas 1 package n packages tant parfaitement similaire. Procder comme suit : Le package 1 doit tre au statut DEV : sinon faire le(s) Demote et Revert ncessaire(s) pour ramener le package en dveloppement Crer le package 2 Faire le Checkout (commande C1), dans le package 2, de la version Baseline-0 de tous les composants quil faut sortir du package 1 Faire le stage from dev (commande S1), toujours dans le package 2, de ces mmes composants, partir des bibliothques de travail du package 1, i.e. : DFRAAPP.DFRD..STAG.., o est lapplication (ECRD ou EPAR) est le numro du package 1 est le trigramme correspondant au type du composant Cette opration vous permet dcraser la version de Baseline-0 par celle prsente dans le package 1. Faire le Stage/Delete (commande S2, puis D) de ces mmes composants, dans le package 1page 7/46 16/11/2004

65469783.doc

Eventuellement, si vos 2 packages ont des copys (ou des sous-programmes statiques) en commun, regroupez les dans le package 1 et transformez vos 2 packages en packages participating vous reporter au chapitre Transformer des packages simples en participating un peu plus loin

Ensuite, vous pouvez poursuivre le cycle de vie habituel pour les 2 packages.

3.4. Regrouper n Packages en un seulOn va considrer que lon veut regrouper 2 packages (package 1 et package 2) en 1 seul (package 1) : le cas n packages 1 package tant parfaitement similaire. Procder comme suit : Les packages 1 et 2 doivent tre au statut DEV : sinon faire le(s) Demote et Revert ncessaire(s) pour les ramener en dveloppement. Faire le Checkout (commande C1), dans le package 1, de la version Baseline-0 de tous les composants quil faut ramener du package 2 Faire le stage from dev (commande S1), toujours dans le package 1, de ces mmes composants, partir des bibliothques de travail du package 2, i.e. : DFRAAPP.DFRD..STAG.., o est lapplication (ECRD ou EPAR) est le numro du package 2 est le trigramme correspondant au type du composant Cette opration vous permet dcraser la version de Baseline-0 par celle prsente dans le package 2. Faire le Stage/Delete (commande S2, puis D) de ces mmes composants, dans le package 2 (i.e. de tous les composants) Procder la Suppression logique (commande D1) du package 2 Eventuellement, si vos 2 (ou n) packages sont participating , et quil ny a pas dautre package participating associ au mme package complex , vous allez transformer le package 1 de participating en simple : en Update/Control Information (commande U1), renseigner la valeur 1 dans la zone Level Procder la Suppression logique (commande D1) du package complex

Ensuite, vous pouvez poursuivre le cycle de vie habituel pour le package 1.

3.5. Transformer des packages simples en participating Vous pouvez avoir besoin de mettre en visibilit un package par rapport un autre, et donc de les passer de simple participating , par exemple dans les cas suivants : Ncessit de mettre en visibilit les dveloppements (copys, ) dun projet 1 (ex : AN2000) par rapport ceux dun projet 2 (ex : Euro), avant mme que le projet 1 ne soit mis en production Ncessit de livrer un projet en 2 ou plusieurs lots (packages) ayant des dates dinstallation diffrentes, certains packages ncessitant des copys ou sous-progs statiques se trouvant dans le package dun lot antrieur Etc. On va considrer que lon veut transformer 2 packages simples (package 1 et package 2) en packages participating, le package 2 devant voir un ou plusieurs composants du package 1 : le cas transformer n packages simples en participating tant parfaitement similaire Procder comme suit : Les packages 1 et 2 doivent tre au statut DEV : sinon faire le(s) Demote et Revert ncessaire(s) pour les ramener en dveloppement. en Update/Control Information (commande U1) sur le package 1, renseigner la valeur 4 (= participating) dans la zone Level page 8/46 16/11/2004

65469783.doc

Faire la mme opration sur le package 2 Crer un nouveau package (package 3), de niveau 2 (= Complex) Rattacher les packages 1 et 2 au package 3 : en Update / Complex/Super (commande U6) sur le package 3, renseigner, dans lordre, le package ID du package 1 puis celui du package 2 Dans le package 2, refaire : le Stage/Compilation (commande S2, puis S) de tous les programmes qui utilisent un des composants prsents dans le package 1 le Recompile (commande RC) de tous les programmes recompils de la Baseline, qui utilisent un des composants prsents dans le package 1

Ensuite, vous pouvez poursuivre le cycle de vie habituel pour les packages 1 et 2.

3.6. Destruction dun package Le package doit tre au statut DEV, avec une date dinstallation suprieure la date du jour. Supprimer tous les composants du package. Effectuer la destruction du package (commande D1) : le package passera au statut DEL. La commande D2 permet de faire marche arrire sur la destruction : le statut du package repassera DEV. La destruction physique ne sera ralise quaprs le passage des traitements priodiques de Housekeeping .

3.7. Compression des bibliothques de Staging Utiliser la commande ZP pour compresser les bibliothques de Staging du package. Cette action est utiliser rgulirement pour viter que les bibliothques de Staging ne prennent trop de place sur les Disques.

Cette consigne sapplique particulirement ; aux packages volumineux, aux packages participating . aux packages ayant une trs forte activit aux packages manipulant de trs composants

gros

65469783.doc

page 9/46

16/11/2004

4. ASTREINTES Rparation de plantage la nuit ou en journe4.1. Gnralits sur les packages de type 'ASTREINTE'Un package de nature astreinte correspond, dans ChangeMan, un package de type UNPLANNED . Ses caractristiques sont les suivantes : Ce package sera temporaire Ce package ne mettra jamais jour la Baseline. Ce package pourra droger aux normes de qualit, cohrence, compltude habituellement obligatoires : on pourra passer outre lanalyse DBIQ, et un audit avec anomalies ne bloquera ni le Freeze, ni lapprobation, ni linstallation en Production. Les composants seront installs IMMEDIATEMENT dans des bibliothques de production se trouvant en tte de concatnation des moniteurs TP et des steplib des JCLs. Les modifications apportes par ce package seront donc IMMEDIATEMENT actives. Vous devrez re-livrer, ds le 1er jour ouvr suivant, tous les composants de ce package via un package planned classique, afin que vos modifications soient prises en compte dans la Baseline. Pour cette raison, la dure de vie du package dastreinte en Production sera limite 5 jours maximum (pour tenir compte des cas o le jour ouvr suivant est aprs un week-end, voire un pont ) : cest dire que le package dastreinte sera AUTOMATIQUEMENT dsinstall en fin de vie. Le scheduleur utilis sera CMN : date et heure de dbut dinstallation seront donc prises en compte. Pour supprimer un correctif apport par ce package, sans attendre son expiration, il suffira : Soit (recommand) dutiliser la commande TSO CMNPASP en choisissant loption Suppression dans les Bibs de Prod. Emergency et en spcifiant votre Package ID : cela aura pour effet de supprimer par anticipation des bibliothques de prod. temporaires les composants de votre package Soit de re-livrer la version de Baseline-0 des mmes composants, mais par un autre package dastreinte (UNPLANNED). Cela aura pour effet dcraser les bibliothques de prod. temporaires avec la version prsente dans les bibliothques de Prod. permanentes.

4.2. Cycle de vie ASTREINTE Une astreinte va consister en lun des 2 cas suivants.

4.2.1.

Remise immdiate en production de la version prcdente

Si la correction urgente dun plantage peut tre ralise simplement en remettant immdiatement en production la version prcdente dun ou plusieurs composants, vous navez pas besoin de crer un package dastreinte, ni de suivre les actions expliques ci-aprs ( Ralisation dune correction en Astreinte ) : vous pouvez utiliser la fonction BACKOUT de la commande TSO CMNPASP. voir plus bas le mode demploi de cette commande ATTENTION : vous devrez nanmoins ABSOLUMENT procder, ds le jour ouvr suivant, la re-livraison de votre astreinte via un package normal voir plus loin, le point 2 du chapitre 4.3 : Ce que vous devez TOUJOURS faire le lendemain dune Astreinte

4.2.2.65469783.doc

Ralisation dune correction en Astreinte

Cration dun package dastreintepage 10/46 16/11/2004

Pour crer un package dAstreinte, renseigner, en plus des champs standards, les champs spcifiques suivants : Sur le panel primaire (CMNCRT01) : Indiquer UNPLANNED dans Package Type ; le champ TIME SPAN sera valoris automatiquement ( TEMPORARY). Indiquer 001 dans le champ UNPLANNED REASON CODE Prciser la dure de vie de ce package dans TEMPORARY CHANGE DURATION : renseigner le nombre de jours qui sparent linstallation en Prod du jour ouvr suivant (dans la limite de 5 jours maxi.).===> ===> ===> ===> ===> UNPLANNED TEMP 001 1 (Planned or Unplanned) (Permanent or Temporary) (Optional package name) (* for list) (In days)

PACKAGE TYPE PACKAGE TIME SPAN PACKAGE TO COPY FORWARD UNPLANNED REASON CODE TEMPORARY CHANGE DURATION

Sur le panel SITE INFORMATION (CMNCRT07), sur lequel on slectionne les sites destinataires, indiquez correctement la date et les heures dinstallation souhaites, ainsi que le(s) site(s) de Production concern(s) (CMPFRA et/ou CMPS2P). Tant que le package nest pas gel, il sera possible de modifier ces informations. ATTENTION : lheure FROM servira non seulement empcher le package de sinstaller avant cette heure-l, mais aussi et SURTOUT elle correspondra lheure laquelle ChangeMan retirera automatiquement le package J+n

--------------------------- CREATE: SITE INFORMATION --------- Row 1 to 7 of 7 COMMAND ===> SCROLL ===> CSR Press ENTER or END to create the package or type CANCEL to exit. Enter * in line command field for site selection list. INSTALL DATE/TIME YYYYMMDD FROM TO 20040408 0100 0400

SITE '''' CMPFRA__

PRIMARY/BACKUP CONTACTS JFR______________________ Second backup____________

PHONE NUMBERS 33000__________ 33001__________

Dans cet exemple, le package ne sinstallera pas avant 1h00 du matin (mme sil est approuv avant), et il faudra lavoir approuv avant 4h00 du matin (sinon il tombera en limbo ). Il sera donc install sur la Prod Alpha le 8/4/2004 avant 4h00, et il sera automatiquement retir de Production le 9/4/2004 1h00 La suite du cycle de vie Astreinte est similaire celle des packages Planned normaux : Checkout des composants (commande C1) Stage/edit des composants (commande S2, puis E) Stage/compilation des programmes (commande S2, puis S) : en Astreinte, on pourra dsactiver le contrle de normes DBIQ, en renseignant NO dans le champ DBIQ Pre-compile du 2me panel doptions de compilation (PCT$USRB). Eventuellement, Recompile (commande RC) de programmes dans le package, depuis la baseline-0 Audit (commande AP) : laudit est obligatoire mais, en Astreinte, il ne sera jamais bloquant Eventuellement, Promotion (commande PR) sur le site CMDFRA (ou CMDS2P pour S2P), pour tester dans un couloir de tests unitaires (ex : TFRB, TS2B) Eventuellement, Promotion (commande PR) sur le site CMPFRA (ou CMPS2P pour S2P), niveau 1 (PFRA ou PS2P) pour tester directement en Production. ATTENTION : il est impratif, une fois les tests termins, de procder au freeze et lapprobation complte du package ! Freeze (commande F1) du packagepage 11/46 16/11/2004

65469783.doc

Approbation (commande A1) du package

la Distribution du package seffectue automatiquement dans la foule de lapprobation (le package passe au statut DIS ). lInstallation en Production (Alpha et/ou Bta) du package seffectue partir de lheure de dbut spcifie (le package passe au statut INS ) : les composants du package sont alors immdiatement oprationnels, aussi bien en TP quen Batch. le Retrait du package des bibliothques de Production temporaires (Alpha et/ou Bta) seffectue J+n et partir de lheure de dbut spcifie (le package passe au statut TCC ) : les composants du package sont alors immdiatement supprims, aussi bien en TP quen Batch. Remarque : le processus dAstreinte dcrit ici ne concerne que les Productions Alpha et Beta. Pour les ventuelles astreintes sur les Recettes Gamma et Delta, il faudra utiliser le cycle de vie normal (package PLANNED) et corriger en recette en utilisant la fonction de Promotion sur CMRFRA/CMRS2P. Une fois votre package dastreinte install en production, si vous ne faites rien, il sera automatiquement retir dans les 5 jours et la production se retrouvera ensuite dans ltat o elle tait avant votre astreinte.

4.3. Ce que vous devez TOUJOURS faire le lendemain dune AstreinteLe 1er jour ouvr suivant votre astreinte, il faut analyser froid les raisons du plantage et les solutions prennes de rparation : 1. Si le problme est li des donnes corrompues : modifiez les donnes (mise jour directe ou reprise), puis dsactivez votre package dastreinte sans attendre voir plus haut, le dernier point du chapitre 4.1 2. Si le problme est li au code Cobol, vous DEVEZ re-livrer votre astreinte par un vrai package normal (planned). Pour cela, vous allez : Crer un nouveau package : de type PLANNED, clon partir du package dastreinte (utiliser la zone Package to copy forward en y renseignant lidentifiant du package dastreinte), avec une date dinstallation gale celle du jour ouvr suivant. Puis, dans ce package : Faire le checkout (commande C2) du(des) composants prsents dans le package (et hrits du package dastreinte) : vous rcuprez alors les versions (Baseline-0) qui taient actives en production avant linstallation de votre astreinte. Faire le stage from dev (commande S1) de ce(s) mme(s) composant(s), partir des bibliothques de travail du package dastreinte, i.e. : DFRAAPP.DFRD..STAG.., o est lapplication (ECRD ou EPAR) est le numro du package dastreinte est le trigramme correspondant au type du composant Cette opration vous permet dcraser la version de Baseline-0 par celle de votre astreinte. Poursuivre le cycle de vie comme pour les packages normaux (planned), en noubliant pas dapprouver votre package avant la fin du jour ouvr suivant lastreinte.

4.4. Mode demploi de la commande TSO CMNPASP

65469783.doc

page 12/46

16/11/2004

4.4.1.

Introduction

Au cours de linstallation dun package normal , ChangeMan va copier les composants de ce dernier dans les bibliothques de types INSTALL. Ces bibliothques seront copies, par CA7, tous les jours dans les bibliothques de types PRODUCTION (en ligne dans les CICS, et dans les jobs applicatifs). Par consquent, ChangeMan ne livre pas en immdiat en Production. Afin de garder la possibilit de le faire, un outil est la disposition des personnes dastreinte, et de la cellule technique, pour livrer des programmes (dj installs sous ChangeMan) dans les bibliothques de Production. Cette clist permet aussi : de faire des retours arrire de nettoyer les bibliothques de Production temporaires On pourra choisir dagir : sur un composant donn sur tous les composants dun package sur tous les composants TP dun package mixte TP/Batch sur tous les composants Batch dun package mixte TP/Batch

4.4.2.4.4.2.1.

UtilisationPrsentation

Pour excuter la clist, il vous suffit de tapez TSO CMNPASP. (Disponible sur Alpha et Dzta). Dans lexemple ci-dessous, nous allons copier les composants du package ECRD000003 dans les bibliothques de Production.------------MONITEUR DE MISE EN PRODUCTION ET RETOUR ARRIERE -------------------------------------IMMEDIAT CHANGEMAN ---------------------------Date: 05/11/04 Vous etes sur PFR0 Slectionner votre mise en production : s . . Install CMN vers les Bibs de Productions BackOut CMN vers les Bibs de Prod. Emergency Suppression dans les Bibs de Prod. Emergency

Nom du Package CMN : ECRD000003 ou Nom du Programme : ........ Type de composants Site Destination

de l'Application : ....

: ALL.. (BATCH, TP, ALL) : PFRA (PFRA, PS2P)

Submit ===>

S

B Browse du Jcl;

S Soumission du Jcl PF1 pour HELP

Entrer la commande END pour abandon

4.4.2.2.

Mode de fonctionnement

Le panel de cet outil peut tre spar en3 zones : 1) Linstallation en immdiat, le Backout immdiat, ou la Suppression en immdiat des bibliothques de Prod. temporaires 2) Le nom du package ou le nom du programme et lapplication. 3) Le type de composant et le site dinstallation. Dans la premire zone, il suffit de saisir un S sur la bonne option (Install / Backout / Suppression).65469783.doc

page 13/46

16/11/2004

Dans la seconde zone, il faut saisir : - soit le nom du package ChangeMan (ATTENTION : ne fonctionne que si le package est install depuis au maximum 1 semaine). soit le nom du programme, et son application

La troisime zone contient deux champs saisir obligatoirement : - le type des composants copier/supprimer (Batch, Tp, ou les deux), - le site destination : o Pour lapplication CREDIT : PFRA ou PS2P o Pour lapplication EPARGNE : PS2P

4.4.2.3.

Traitement

Une fois votre saisie effectue, un JCL est gnr, prsent et soumis : le traitement consiste tout simplement en la copie (ou la suppression) des composants dune bibliothque Source vers une bibliothque Cible : Pour linstallation en immdiat : Source : Bibliothques dInstallation ChangeMan Cible : Bibliothques de Production Pour le Backout : Source : Bibliothques de Backout ChangeMan Cible : Bibliothques Emergency Pour la Suppression : Cible : Bibliothques Emergency ATTENTION : une fois le JCL soumis et termin, vous devez vrifier le compte-rendu dexcution pour vrifier que les actions demandes ont bien t effectues (car dans la plupart des cas, il ny a pas de vrification dexistence des composants ou du package, dans les bibliothques de prod. temporaires)

65469783.doc

page 14/46

16/11/2004

5. Les dbuggeursLes dbuggeurs sont choisis lors de la compilation des programmes. Vous pouvez utiliser loption de compilation Smart-Test et promouvoir votre package (ou, slectivement, vos composants) en Tests Unitaires voire en Recette. ATTENTION : Avant livraison en Production, les modules DOIVENT tre compils avec AbendAid (souplesse pour les astreintes et le dbug en Prod). Si ce nest pas le cas, un message danomalie apparatra au moment du Freeze. Au cours de la compilation, des composants spcifiques lalimentation du dbuggeur choisi sont intgrs au package. Ceux-ci doivent tre promus dans lenvironnement cible pour en disposer dans le dbuggeur : Ils sont automatiquement promus quand vous faites une promotion full Si vous procdez par promotion slective , vous devez veiller les slectionner en mme temps que les autres binaires (load, DBRM, ) associs au programme.

5.1.

SmartTest

Les types de composants ChangeMan spcifiques lalimentation du Smart-Test cible (donc transfrer lors dune promotion), sont : SMB pour le Batch SMT pour le TP. Les fichiers cibles rfrencer dans le Smart-Test de lenvironnement souhait peuvent tre obtenus par la commande QP ( Query Package ), rubrique Promotion Libraries , dans la zone Library 1 correspondant au type SMx du couloir souhait. Le processus de connexion loutil SmartTest est inchang, seuls les fichiers de rfrence sont positionner. Le menu File option 6 permet de mettre jour le fichier AKR utiliser (selon quon est en batch ou en TP, et selon le couloir) :

65469783.doc

page 15/46

16/11/2004

Les fichiers AKR de Smartest sur Dzta sont : TFRBSMT.BATCH.AKR pour le batch et TFRBSMT.CICS.AKR pour le cics, o TFRB est le couloir

5.2.

Abend-Aid 5.2.1. Principes gnraux dutilisation

Les types de composants ChangeMan spcifiques lalimentation de lAbend-Aid cible (donc transfrer lors dune promotion), sont : ABN pour le Batch AFX pour le TP. Ces fichiers dalimentation du listing Abend-Aid sont automatiquement transfrs et chargs dans le listing lAbend-Aid du couloir cible lorsque vous faites une Promotion FULL (ou que vous les selectionnez lors dun Promotion SELECTIVE ). ATTENTION : lors de linstallation en Production de votre package, le listing de lAbend-Aid de production nest pas aliment (pour des raisons de volumtrie). Les fichiers cibles rfrencer dans lAbend-Aid de lenvironnement souhait peuvent tre obtenus par la commande QP ( Query Package ), rubrique Promotion Libraries , dans la zone Library 1 correspondant au type ABN ou AFX du couloir souhait. Le processus de connexion loutil Abend-Aid est inchang, seuls les fichiers de rfrence sont positionner : En Batch, le menu View de loutil permet dindiquer les fichiers REPORT et LISTING correspondant au besoin. En TP, aprs avoir choisi le CICS utiliser avec le choix M , slectionner le choix SRCDIR pour obtenir lcran de saisie du fichier LISTING utiliser. Voici la codification des fichiers LISTING et REPORT : BATCH : xxxxABA.BATCH.LISTING.SHRDIR xxxxABA.BATCH.REPORT.SHRDIR CICS : xxxxAFX.CICS.LISTING.SHRDIR xxxxAFX.CICS.REPORT.SHRDIR avec xxxx = couloir (ex : TFRB)

5.2.2. Comment r-alimenter lAbend-Aid dun couloir aprs puration ?Le fichier listing dAbend-Aid fonctionne en mode FIFO (First In First Out) : lorsquil atteint sa taille maximum et que lon tente dy charger un fichier dalimentation du listing pour un programme nouvellement compil, Abend-Aid pure le(s) listing(s) le(s) plus ancien(s) pour librer la place ncessaire. Lorsque vous tes en test dans un couloir, il est donc possible quau bout dun certain temps, le listing Abend-Aid correspondant votre programme ait disparu : dans ce cas, si vous en avez besoin, vous serez oblig de r-alimenter lAbend-Aid du couloir. Pour cela, vous utiliserez la commande : TSO CMNABAID, dont voici le fonctionnement. Dans lexemple ci-dessous, nous sommes en cours de dveloppement du composant PRFCMN05, dans le package ECRD000066. Etant donn que le composant est au statut ACTIVE , et quil t compil sous Abend-Aid (Paramtre Debugging Process = A dans le deuxime panel de compilation), le fichier dalimentation du listing Abend-Aid sera alors disponible dans les bibliothques de Staging du package.65469783.doc

page 16/46

16/11/2004

Le fichier dalimentation du listing Abend-Aid doit tre disponible dans la bibliothque DFRAAPP.DFRD..STAG.. o =AFX si TP ou ABN si BATCH.

------------------------- STAGE: ECRD000066 COMPONENTS ------- Row 1 to 2 of 2 COMMAND ===> tso cmnabaid SCROLL ===> CSR NAME TYPE STATUS CHANGED PROCNAME ID REQUEST __ PRFCMN05 DOC ACTIVE 20041019 105503 GAUDRY2 __ PRFCMN05 SRT ACTIVE 20041019 105609 CMNCOB GAUDRY2 ******************************* Bottom of data ********************************

Nous allons lenvoyer en Recette RFRA afin deffectuer le chargement du fichier dalimentation du listing dans le listing Abend-Aid de Gamma.------------------TRANSFERT DES FICHIERS ABEND-AID CHANGEMAN --------------------------------------IMMEDIAT CHANGEMAN ---------------------------Date: 19/10/04 Vous etes sur DFR0

Nom composant Type du composant Application CMN Numero du package

: : : :

prfcmn05 tp... ECRD 66.... rfra

(BATCH, TP) (ECRD, EPAR) (0 pour Baseline) (PFRA, PS2P, RFRA, RS2P)

Environnement Dest :

Submit ===>

S

JCL soumis S

JCL gnr

E PF1 pour HELP

Entrer la commande END ou RETURN pour abandon

Un JCL sera automatiquement cr et soumis, si le paramtre S est spcifi dans le champ Submit.

5.2.3.

Comment alimenter lAbend-Aid de Production ?

Cette action est particulirement utile pour dbugger en Astreinte. Votre package est dj install : le fichier dalimentation du listing Abend-Aid est donc en Baseline (comme tous les composants du package). Le fichier dalimentation du listing Abend-Aid sera alors disponible dans la bibliothque REFFRA.DFRD..BASE. o =AFX si TP ou ABN si BATCH.

65469783.doc

page 17/46

16/11/2004

------------------TRANSFERT DES FICHIERS ABEND-AID CHANGEMAN --------------------------------------IMMEDIAT CHANGEMAN ---------------------------Date: 19/10/04 Vous etes sur DFR0

Nom composant Type du composant Application CMN Numero du package

: : : :

prfcmn05 tp... ECRD 0..... PFRA

(BATCH, TP) (ECRD, EPAR) (0 pour Baseline) (PFRA, PS2P, RFRA, RS2P)

Environnement Dest :

Submit ===>

S

JCL soumis S

JCL gnr

E PF1 pour HELP

Entrer la commande END ou RETURN pour abandon

Il suffit de mettre 0 la place du numro de package. Un JCL sera automatiquement cr et soumis, si le paramtre S est spcifi dans le champ Submit.

65469783.doc

page 18/46

16/11/2004

6. Gestion des programmes PRINCIPIA6.1. Les grands principes.Le CHECKOUT des composants PRINCIPIA doit toujours se faire en prenant la version 0 de Baseline. Si vous avez besoin, pour une raison quelconque, de prendre en charge dans votre package une version -1, -2, etc de la baseline, vous devez en faire la demande la Cellule Technique(1). Une FONCTION ( un OBJET ) PRINCIPIA stock dans CHANGEMAN cest plusieurs composants: o o o o Un FNx : le passe-plat entre CHANGEMAN et PRINCIPIA : Source(s) COBOL, MAP(s), descriptions spcifiques PRINCIPIA Un ou plusieurs SPx : source tendu COBOL Un ou plusieurs FON ( un pour chaque SPx ) : contient des informations ncessaires ldition du source tendu. Un composant DOC ( un pour chaque SPx ): qui correspond Histo Modifs

-

Avec x = T,B,S ( pour TP,BATCH et SUBROUTINES ) PRINCIPIA sera dornavant un diteur spcialis dans la modification SFD de ses fonctions et programmes : o o o o On EXPORTe les composants qui dcrivent les programmes PRINCIPIA de CHANGEMAN vers PRINCIPIA, On effectue les dveloppements dans PRINCIPIA, On IMPORTe les composants modifis dans CHANGEMAN, La Rfrence est CHANGEMAN, la FONCTION ( lobjet et tous ses composants associs) nexiste plus dans PRINCIPIA.

Les espaces PRINCIPIA contiendront uniquement les FONCTIONS et PROGRAMMES en cours de modification : ces espaces sont donc maintenant parfaitement interchangeables , cest la fin du monopole de NAPP Plus de compilation des sources(2)

-

, des maps ( PC, PC ) dans PRINCIPIA,

Remarque : vous pouvez travailler simultanment avec PRINCIPIA et CHANGEMAN, et suivre larrive de vos fonctions dans vos espaces individuels, et leurs suppressions compltes de lespace PRINCIPIA. Il faut nanmoins attendre la fin des traitements BATCH.

6.2. Quelques dfinitions importantes Modifications PRO : cest comme dans PRINCIPIA, mais cest dans CHANGEMAN via un panel ddition des composants PRINCIPIA LIKE ( commande ligne E sur composant SPx ). Et cest obligatoirement avec CHANGEMAN quil faut faire ces modifications! Stage du FNx : cest le rafrachissement du passe-plat et la compilation des MAPSET si des diffrences sont dtectes entre la version en BASELINE et la version dans le package.

-

1()

En effet, les versions de baseline -n des diffrents composants Principia associs (le passe-plat FNx, les sources tendus SPx, les FON) ne sont, en gnral, pas compatibles entre elles. Seule la Cellule Technique est capable de vous restituer une version -n cohrente pour chacun des composants associs. 2() Ne pas confondre la commande CL,CL , qui existe toujours, avec la compilation.65469783.doc

page 19/46

16/11/2004

-

Build for PRINCIPIA du FNx : Cest lEXPORT vers PRINCIPIA du passe-plat FNx Bring back from PRINCIPIA du FNx : Cest lIMPORT dans CHANGEMAN des modifications effectues dans PRINCIPIA via le passe-plat FNx

6.3. Comment modifier un source PRINCIPIA 6.3.1.-

Remarques prliminaires

Comme pour tous les autres sources il faut faire le CHECKOUT dans un PACKAGE, et effectuer le cycle normal de dveloppement, test, recette et installation en production Mais pour les modifications de source PRINCIPIA TP il est fortement recommand de faire une analyse prliminaire avec une logique dveloppement PRINCIPIA pour dterminer si : o o des modifications PRO sont suffisantes. des modifications SFD sont ncessaires.

6.3.2.

Modifications PRO uniquement

Pas de cycle dEXPORT / IMPORT dans ces cas. ( Pas de PRINCIPIA ) o Fonctions BATCH , Objet Subroutine et Fonctions TP un seul source. Faire le CHECKOUT du SPx . CHANGEMAN vous complte automatiquement votre package avec les composants FNx, FON et DOC. o Fonctions TP plusieurs sources Si tous les sources sont impacts : Faire le CHECKOUT du passe-plat FNT , tous les sources SPT sont dans votre package. (plus tous les FON et DOC associs) Sinon faire le CHECKOUT du (des) source(s) modifier. le passe-plat FNT est dans votre package. ( plus tous les FON et DOC ). Car cela vitera CHANGEMAN de signaler des dveloppements concurrents superflus. o Et dans tous les cas : Aprs vos modifications PRO, il faut faire le stage du FNx afin de: - faire prendre en compte les modifications - Effectuer la compilation des MAPS modifies dans PRINCIPIA.

6.3.3. 1. 2. 3. 4. 5.

Modifications SFD ncessaires

Premire partie : CHANGEMAN

CHECKOUT de FNx Stage du FNx : pour le passer au statut ACTIVE EXPORT Build for PRINCIPIA du FNx ( Commande ligne B sur FNx ) Choix de lEspace de destination(3) Choix de loption E = EXPORT, puis CFN en ligne Commande

3

La fonction ne doit pas exister dans cette espace Si plusieurs fonctions doivent tre modifies et que ces fonctions interagissent entre-elles ( par exemple dbranchement fonction, modifications des rsultats en sortie ), il est fortement conseill de grouper ces fonctions dans un mme espace.65469783.doc

()

page 20/46

16/11/2004

6. Un job Batch est excut. Un message SUCCESSFUL EXPORT_PRINCIPIA indique la bonne fin du traitement. Deuxime partie : PRINCIPIA

7. La fonction est automatiquement prise en charge dans lespace individuel du USER qui fait la demande dEXPORT. 8. Faire les modifications SFD, 9. Puis rafrachir les composants STANDARD Et GENERES NON MODIFIABLES dans PRINCIPIA en effectuant les prises en charges, les GEN,GEN , les CL,CL et validation niveau PRO(4),. 10. Puis Valider votre fonction en SFD Troisime partie : CHANGEMAN

11. IMPORT Bring back from PRINCIPIA du FNx (Commande ligne B ) 12. Choix de lEspace source(5), 13. Choix de loption I = IMPORT, puis CFN en ligne Commande 14. Les composants sont rafrachis dans votre package, 15. Automatiquement TOUS les composants sont supprims de lespace Collectif PRINCIPA 16. Vrifier que vos modifications apparaissent bien dans le(s) SPx 17. Faire les modifications PRO , 18. Faire le stage (compile) du (des) SPx, 19. Poursuivre le cycle classique CHANGEMAN.

6.4. Nouveau processus de cration dans PRINCIPIA Pour crer une nouvelle FONCTION, ou ajouter un nouveau programme TP dans une fonction existante : il faudra dornavant prvenir la CELLULE TECHNIQUE qui vous assistera pour ces oprations.

6.4.1. Quelques rgles spcifiques aux composants PRINCIPIA pour bien grer les dveloppements paralllesLes rgles spcifiques PRINCIPIA ne remplacent pas les contraintes habituelles dues aux dveloppements parallles, elles sajoutent. Hypothse : * DEV1 effectuera TOUJOURS ses livraisons en production AVANT DEV2 * Si on effectue une modification SFD la rconciliation se fera toujours lorsque la version de DEV2 est installe en Baseline. DEV2 a un dveloppement Type PRO faire sur un source. o Cas 1 : DEV1 dveloppe dj Type PRO le mme source tendu :

DEV2 utilisera la commande SAVE sur le Panel ddition PRINCIPIA LIKE. Le source tendu sera sauvegard dans un fichier USER.LIBCMN.SAVE.Nom du source . Puis on reprend le processus de report de modification : - Checkout de la version 0 de Baseline - Report des modifications sauvegardes, en utilisant Merge & Reconcile ou la main . Et noubliez pas deffectuer ce report de maintenance galement sur le composant .DOC ! - Et poursuite du cycle CHANGEMAN o Cas 2 : DEV1 dveloppe dj Type PRO un autre source tendu ( uniquement pour une fonction TP ):

DEV2 na pas de modification faire dans ce source:4 5 () ()

Rappel : plus de modifications PRO dans PRINCIPIA ni de compilation La fonction et ses objets ne doivent pas tre pris en charge dans lespace source.65469783.doc

page 21/46

16/11/2004

- Refaire le Stage du FNT aprs larrive en Baseline de la version de DEV1. Cela permettra de reprendre la version de Baseline du(es) source(s) tendus non prsent(s) dans le package de DEV2. DEV2 constate quil a des modifications faire dans ce source : - On se retrouve dans le Cas 1 pour ce source. o Cas 3 : DEV1 dveloppe dj Type SFD sur la fonction.

DEV2 devra imprativement reprendre la version DEV1 et intgrer ses modifications Type PRO cette version. Le mode opratoire est le suivant : - Sauvegarde du(es) source(s) dans USER.LIBCMN.SAVE.Nom du source ( Idem Cas 1 ). Sauvegardez galement le(s) composant(s) .DOC . - SUPPRIMER tous les composants de cette fonction ( FON, DOC, FNx et SPx ) prsents dans votre package. - Refaire le Checkout ( de la version de DEV1en Baseline ) du ou des source(s) que vous voulez modifier. - Faire le Report de modifications, puis poursuivre le cycle CHANGEMAN. DEV2 a un dveloppement Type SFD effectuer sur une fonction. o Cas 4 : DEV1 dveloppe dj Type PRO sur un ou plusieurs programmes :

DEV2 dj termin ses modifications dans PRINCIPIA. ( plus dimport / export ) - Sauvegarde du(es) source(s) dans USER.LIBCMN.SAVE.Nom du source ( Idem Cas 1 ). Sauvegardez galement le(s) composant(s) .DOC - Supprimer le(s) composant(s) SPx prsents dans votre package originel, - Faire le checkout du(es) composants SPx de la version de DEV1, - Faire le Report de modifications de la version sauvegarde dans la version du package, - Stage du FNx pour reprendre les nouvelles versions des sources tendus, - puis poursuivre le cycle CHANGEMAN. DEV2 na pas fini ses modifications dans PRINCIPIA - finir les modifications dans PRINCIPIA, - Import bring back du FNx. - puis appliquer le mode opratoire prcdent. o Cas 5 : DEV1 dveloppe dj Type SFD sur la fonction.

Le dveloppement en parallle de deux versions SFD est viter si possible , car la rconciliation dans ce cas est un processus relativement long et compliqu (risque derreurs). DEV2 devra intgrer les modifications : - Type SFD la conciliation devra imprativement tre effectue dans PRINCIPIA - Type PRO la conciliation sera ralise dans CHANGEMAN - Pr-requis indispensable : La fonction dveloppe par DEV2 doit se trouver en dveloppement (i.e. Prise en charge) dans un espace PRINCIPIA : o Cest naturellement le cas si DEV2 est encore en dition SFD dans Principia o Sinon, cest que DEV2 a dj termin ses modifs SFD , quil est revenu dans ChangeMan, et quil a ventuellement dj ralis des modifs PRO dans ChangeMan : dans ce cas, DEV2 doit : Faire le stage du FNx (pour le rafrachir avec les toutes dernires modifs PRO) Faire le build for PRINCIPIA (lexport) de la fonction FNx vers un espace PRINCIPIApage 22/46 16/11/2004

65469783.doc

Le mode opratoire SFD: - DEV2 doit procder toutes les sauvegardes ncessaires : sauvegarde de son(ses) source(s) dans USER.LIBCMN.SAVE.SPx.Nom du source sauvegarde de son(ses) DOC dans USER.LIBCMN.SAVE.DOC.Nom du source . - Cration dun autre package transitoire CHANGEMAN - Checkout de la version Baseline-0 de la FONCTION concerne dans ce nouveau package : vous aurez donc lensemble des composants de la version de DEV1. - Faire le stage du FNx de DEV1 pour le passer au statut active - Faire le build for PRINCIPIA ( lexport ) de la fonction de DEV1vers un autre espace PRINCIPIA - Faire la conciliation SFD dans PRINCIPIA : Les deux versions sont disponibles dans PRINCIPIA ( par exemple la version de DEV1 qui est dj en production - dans NAPP et la version de DEV2 dans ESP1). - Il faut intgrer les modifications SFD de la version de DEV1 dans le SFD de DEV2 ( Et l cest rien de le dire ) - Puis pour le(s) objet(s) PRO de la fonction de DEV2, il faut faire les prises en charge PRO , les GEN,GEN et CL,CL ncessaires. - Valider la fonction DEV2 . - Puis slectionner loption SFD-FON dans lautre espace (i.e. NAPP) pour abandonner la fonction DEV1. - Dans CHANGEMAN, supprimer la fonction FNx du package originel de DEV2, ainsi que tous ses composants associs (SPx, FON, DOC). - Dans le mme package (DEV2), refaire le checkout de la fonction FNx en version 0 de baseline. Cette opration est ncessaire pour que CHANGEMAN puisse enregistrer le fait que la version de base a bien t prise en compte, et cela supprimera le SYNCH10 lors du contrle de laudit. - Puis faire le bring back ( limport ) dans ce mme package (DEV2) depuis lespace de Principia de DEV2 (i.e. ESP1). Le mode opratoire PRO: - Les composants dont vous venez de faire le checkout, ont maintenant t remplacs par ceux gnrs aprs la rconciliation SFD. - Faire le Report de modifications entre la (les) version(s) de Baseline et la(es) version(s) prsente(s) dans votre package. Voir le User Hand-Book de Merge & Reconcile si besoin. - Puis poursuivre le cycle CHANGEMAN. Nettoyer CHANGEMAN et PRINCIPIA de tous les composants transitoires. Le nettoyage : - Slectionnez lautre package transitoire - Supprimer la version DEV1 de la fonction dans lespace Principia o elle avait t mise (i.e. NAPP) : pour cela, aller en stage sur le package transitoire, taper B devant la fonction FNx et choisir D (Delete). - Supprimer tous les composants du package transitoire. - Supprimer le package transitoire. - Supprimer les sauvegardes de DEV2, aprs stre assur que toutes les oprations prcdentes ont t ralises correctement, et aprs avoir termin les tests de la(des) version(s) rconcilie(s)

65469783.doc

page 23/46

16/11/2004

CHANGEMANCHECKOUT dun FNx dans un package pour modificationModifications PRO Uniquement

Modifications SFD effectuer

EXPORT

La fonction ne doit pas exister dans lespaceCommande ligne B Principia Flow ==> E

PRINCIPIALa fonction est prise en charge dans PRINCIPIA Modifications SFDPRO Prise en charge des objets impacts. GEN,GEN CL ;CL Validation(s) PRO

Modifications des composants SPx via CHANGEMAN INTERDITES pendant cette phase

IMPORT

Commande ligne B Principia Flow ==> I

Validation SFD

A la fin de limport lespace PRINCIPIA est nettoy.

Modifications des sources tendus, comme dans PRINCIPIA PRO Par Edition du ou des SPx

Si une erreur a t commise durant le phase de dfinition SFD retour lEXPORT

Suite du cycle CHANGEMAN habituel: Stage, Promote, tests,

Dans tous les cas noubliez pas de faire le stage du FNx pour prendre en compte les modifications des sources.

65469783.doc

page 24/46

16/11/2004

7. Gestion des programmes non Principia7.1. Cration dun nouveau Programme1. Cration du package ChangeMan 2. Si le programme a dj t cr dans une bibliothque externe ChangeMan : Faire le Stage from Dev (commande S1) du programme dans le package, partir de la bibliothque externe. 3. Sinon, 2 solutions possibles : a) Par clonage dun composant existant dans la Baseline : Faire le Stage from Dev (commande S1) du programme modle dans le package, partir de la bibliothque de Baseline, en spcifiant dans la zone Stage Name , le nom du nouveau programme. Remarque : On peut aisment obtenir le nom du PDS de Baseline par la commande QP ( Query Package ), rubrique Baseline Libraries , dans la zone Baseline Library Name correspondant au type du programme modle. b) Par cration ex nihilo du programme : En stage (commande S2) sur le package, il suffit dutiliser la commande EDIT (en ligne de commande) de la faon suivante : EDIT . ATTENTION : La commande EDIT ne peut se faire que si le package contient dj au moins 1 composant. Remarque : pour sinspirer du contenu dun composant existant, vous pouvez : Aller en Browse Baseline (commande BB), puis commande E (browse en mode Edit) sur ce composant modle Utiliser la commande CUT sur tout ou partie du source Crer le nouveau programme : EDIT . Utiliser la commande PASTE (en tapant A devant la dernire ligne) 4. Lors de la premire compilation, ChangeMan peut crer automatiquement certains composants qui seront attachs au nouveau programme : Une sysin de Bind (pour les programmes DB2), Un jcl (pour les programmes Batch), Un DBRM Un fichier dalimentation des dbuggeurs (Smartest, Abend-Aid) Un listing de compilation Etc. 5. Crer lhisto-modifs associ : en stage (commande S2) sur le package, commande EDIT .DOC , et le renseigner comme habituellement.

7.2. Modification dun Programme existant1. 2. Cration du package ChangeMan Checkout du programme dans le nouveau package. Le ckeckout ramnera aussi le DOC associ. 3. Vous pouvez modifier le programme. Ne pas oublier de modifier le DOC.

65469783.doc

page 25/46

16/11/2004

8. Gestion des programmes clons ou de travailLes programmes clons sont destins faciliter le dveloppement en parallle de quelques programmes. Ils ne sont pas livrables en Production et ne sont pas pris en compte dans le processus dAudit aprs administration sous ChangeMan. Le package qui contient ce type de programme a le mme cycle de vie quhabituellement, donc, il nest pas ncessaire de crer un package spcial. Les Load-modules se trouvent grs par les types LDB=Batch et LDT=TP.

8.1. Cration dun nouveau Programme clon1. Envoyer un Mail la Cellule Technique pour administrer ce type de programme. => Dclaration de lobjet dans les Designated Procedures avec les options de compilation prvues, ainsi que le type SRB, SPS ou SPT => Dclaration de lobjet dans lAUDIT via CMNEX022 (Copy ddi CMNEX22C) 2. Crer le programme comme habituellement. 3. Attendre la confirmation de ladministration de la Cellule Technique avant de compiler. 4. Procder comme habituellement pour les promotions, lAudit, le Freeze et linstallation du Package CMN.

8.2. Modification dun Programme clonN.B. : le programme clon doit auparavant avoir t dclar comme programme clon auprs de la Cellule Technique (cf. paragraphe prcdent). 1. Modifier le programme comme habituellement. 2. Procder comme habituellement pour les promotions, lAudit, le Freeze et linstallation du Package CMN.

65469783.doc

page 26/46

16/11/2004

9. Gestion des COPYLes types disponibles sont : ARM, CPB, CPT, CPY, DCL, DCB, IN2, MPC, OBL, SDC ou UNI. Consulter la liste des types affiche par CMN en Browse Baseline .

9.1. Cration dun nouveau COPY1. Si le copy a dj t cr dans une bibliothque externe ChangeMan : Faire le Stage from Dev (commande S1) dans le package, partir de la bibliothque externe. 2. Sinon, 2 solutions possibles : a) Par clonage dun copy existant dans la Baseline : Faire le Stage from Dev (commande S1) du copy modle dans le package, partir de la bibliothque de Baseline, en spcifiant dans la zone Stage Name , le nom du nouveau programme. Remarque : On peut aisment obtenir le nom du PDS de Baseline par la commande QP ( Query Package ), rubrique Baseline Libraries , dans la zone Baseline Library Name correspondant au type du copy modle. b) Par cration ex nihilo du copy : En stage (commande S2) sur le package, il suffit dutiliser la commande EDIT (en ligne de commande) de la faon suivante : EDIT . ATTENTION : La commande EDIT ne peut se faire que si le package contient dj au moins 1 composant. Remarque : pour sinspirer du contenu dun copy existant, vous pouvez : Aller en Browse Baseline (commande BB), puis commande E (browse en mode Edit) sur ce copy modle Utiliser la commande CUT sur tout ou partie du copy Crer le nouveau programme : EDIT . Utiliser la commande PASTE (en tapant A devant la dernire ligne) 3. Crer lhisto-modifs associ : en stage (commande S2) sur le package, commande EDIT .DOC , et le renseigner comme habituellement.

9.2. Modification dun copy existant1. Faire le Checkout du copy partir de la Baseline. Le ckeckout ramnera aussi le DOC associ. 2. Faire un E pour Editer le copy et le modifier manuellement. Remarque : vous ne pouvez pas modifier les types rservs la Cellule Technique (DCL, DCB, MPC, SDC, IN2) 3. Mettre jour lhisto-modifs (.DOC) 4. Procder la recompilation des programmes appelants : a. Soit en : i. Faisant une analyse dimpact (menu Query/Impact) pour chaque type de source (SRB, SRT, SPB, SPT, etc.) afin didentifier les programmes appelants ii. Puis en effectuant le Recompile (commande RC) dans le package de chaque programme identifi b. Soit en dclenchant un Audit (commande AP) avec loption AUTORESOLVE YES RAPPEL : la recompilation et la livraison en Production de lensemble des programmes utilisant un copy a t rendu obligatoire et incontournable.

65469783.doc

page 27/46

16/11/2004

10.

Gestion de l Histo Modifs

Dans ChangeMan, lhisto-modifs est une fonctionnalit prise en charge par le type de composant DOC Chaque composant de type copy ou source a son composant DOC associ : ce composant DOC porte le mme nom que la copy ou le source associ Lorsque vous dmarrez un dveloppement sur un composant, vous devez dcrire cela et lalimenter dans le composant DOC associ, comme vous le faisiez avant dans lhisto-modifs Mais une nouvelle contrainte apparat, du fait que vous pouvez dvelopper un composant de manire concurrente : lorsque vous tes en maintenance parallle sur un mme composant mais dans 2 (ou plusieurs) packages diffrents, celui qui passe en production en dernier doit non seulement faire les reports de maintenance, mais galement fusionner les lignes des 2 histo-modifs pour prendre en compte celles ajoutes par celui qui est pass en production en premier ACTION(s) : Soit 1) Sauvegarder vos propres modifications : commande S2, puis E sur le DOC, puis CCCC devant la 1re et la dernire ligne de vos modifications, puis CUT en ligne de commande refaire le checkout du DOC (pour rcuprer les modifications du collgue) rinsrer vos propres modifications en queue : commande S2, puis E sur le DOC, puis A devant la dernire ligne, puis PASTE en ligne de commande Soit 2) utiliser loutil Merge & Reconcile intgr dans CMN, pour obtenir une fusion automatique des 2 histo-modifs voir mode opratoire M+R

65469783.doc

page 28/46

16/11/2004

11. Gestion des Tables Sources et Programmes Table AssembleurLes Tables Sources et les Programmes Table Assembleur sont traites via le type STB. Ces composants sont compiler laide du langage TABGEN et de la procdure SCT$TBGN. Les programmes de gnration utiliss pour convertir les Tables Sources sont stocks avec les programmes Batch standards (type SRB).

11.1. Modification du programme de gnration de Table Source1. 2. 3. 4. Faire le Checkout du membre (type SRB). Modifier selon le besoin Compiler en utilisant le langage COBOL Le Load-module batch rsultant est charg dans le type LOB et est trait en promotion comme habituellement

11.2. Modification de Table Source ou de Programme Table Assembleur1. Faire le Checkout du membre (type STB). 2. Modifier selon le besoin 3. Compiler en utilisant le langage TABGEN (aprs la modification et la compilation du programme de gnration, si ncessaire) 4. Les Load-modules Tables rsultant de la compilation (Batch et TP) sont chargs dans les types LTB et LTT et sont traits en promotion comme habituellement 5. Ajouter la bibliothque LTB (LNKTB) dans la STEPLIB des programmes utilisant cette table, si ce nest dj fait.

11.3. Cration ou Modification des paramtres du programme de gnrationMaintenance identique lancien PASPTABL 1. Faire un Mail la Cellule technique en y prcisant : => quil sagit de modifier,dans CMNTOOL, la table de rfrence Table des Options de compilation des Tables Sources => le composant concern et les informations crer/modifier. Exemple :A/I Mode Prog Gen Table1 Table2 Table3 Table4 Table5 Tri Date Impr Table6 Table7 Table8 Table9 Table10 *----------------------------------------------------------------------------* _ CCTABCC_ A A NETABCC_ TABCCI__ TABCCD__ ________ ________ ________ N O O ________ ________ ________ ________ ________ Nom

Mode : A, B, C, D, E, R, S ou Z (Voir codification PASPTABL actuelle) Prog Gen : Nom du programme de gnration associ Table1 10 : Nom des Tables rsultant de la gnration Tri : Option de tri standard pralable (O/N) Date : Option de date CWA ajouter (O/N) Impr : Option de fichier dimpression ajouter (O/N) 2. Attendre la confirmation de ladministration de la Cellule Technique avant de compiler.

65469783.doc

page 29/46

16/11/2004

12.

Gestion des Maps SFD2

Les composants SDF2 ne sont plus stocks dans SDF2 lui-mme, mais en rfrence dans CMN. SDF2 est utilis comme simple Editeur de Mapsets et Maps. Les types utiliss sont : SDG pour les mapsets, SDP pour les maps, SDC pour les copys mapset gnrs, SDM pour les objets BMS gnrs, SDL pour les Load-modules rsultat de la compilation du mapset de type SDG, uniquement. Consulter la liste des types affiche par CMN en Browse Baseline .

12.1. Mise jour de MAP SFD21. 2. 3. 4. Faire le Checkout des Maps (type SDP). Uniquement les Maps ncessaires. Faire le Checkout du Mapset (type SDG) pour la compilation suivre. Taper E pour Editer les maps et le mapset sous SDF2. Modifier le mapset et les maps, comme dhabitude, dans SDF2. En quittant SDF2, CMN reprend, sous sa responsabilit, le composant modifi par lditeur. (Le composant na plus aucune valeur dans SDF2) 5. Compiler uniquement le mapset (SDG) pour obtenir la nouvelle version de copy (type SDC) et le Load-module (type SDL). 6. La promotion et linstallation se chargent de faire le NEW du Load-module dans les CICS.

12.2. Cration de MAP SFD21. Faire le Stage from Dev partir de Maps similaires de la Baseline dans le type SDP avec le nouveau nom de composant. Ne pas procder par EDIT nom.SDP et CUT & PASTE pour obtenir une copie, car SDF2 refuse de lexcuter. 2. Faire le Stage from Dev dun Mapset similaire de la Baseline dans le type SDG avec le nouveau nom de composant pour la compilation suivre. Pour connatre le nom du fichier, faire un Browse Baseline . 3. Taper E pour Editer le mapset et les maps sous SDF2. 4. Modifier dans SDF2 en reprenant tous les crans SDF2 et en modifiant toutes les rfrences aux valeurs copies par les nouvelles valeurs. En quittant, CMN reprend le composant modifi par lditeur SDF2 sous sa responsabilit (le composant na plus aucune valeur dans SDF2. 5. Les modifications du Mapset se font en 2 fois pour mettre jour les paramtres : 1 fois pour les crans 1 et 2 et changer les titres et les Maps associes 1 fois pour l'cran 4 pour prendre en compte les informations de la ou les maps du package C'est seulement aprs cette action que le Mapset est correct. 6. Compiler uniquement le mapset (SDG) pour obtenir le nouveau Load-module (du type SDL), en choisissant le langage MAPSDF (pour S2P) ou MAPSDF2 (pour CTLM). 7. La promotion et linstallation se chargent de faire le NEW du Load-module dans les CICS.

65469783.doc

page 30/46

16/11/2004

13.

Gestion des modifications DB2

13.1. Cration dune nouvelle TableSoumettre la demande lquipe ADD qui la traite et la transmet la Cellule Technique. Ne pas oublier de prciser le couloir o vous allez tester votre package (i.e. celui o il faut appliquer la demande).

13.2. Modification dune table existanteSoumettre la demande lquipe ADD qui la traite et la transmet la Cellule Technique. Ne pas oublier de prciser le couloir o vous allez tester votre package (i.e. celui o il faut appliquer la demande).

13.3. Cration et Modification de DCLGENCes actions sont rserves la Cellule Technique, qui les ralise suite vos demandes de modification(s) des structures de donnes DB2.

13.4. Modification dune sysin de bindLes SYSIN de BIND PACKAGE sont intgres dans ChangeMan sous le type PKG. La dfinition est modlise et est compatible pour tous les environnements. La modification seffectue par un CheckOut du composant depuis la Baseline (comme pour tout composant) et un Edit pour appliquer les modifications. Lors de la promotion et de linstallation, les modifications entranent systmatiquement un BIND dans les environnements et les DB2 concerns avec les paramtres correspondants ceux-ci et appliqus par ChangeMan. En cas de cration de programme DB2, il suffit de positionner loption CREATION DE SYSIN DE BIND PACKAGE = YES au moment de la compilation du programme pour obtenir, dans le package ChangeMan, la cration du composant PKG correspondant au programme. On peut aussi procder par cration manuelle. Remarque : pour S2P (Epargne) il faut ensuite adapter celui-ci si les informations par dfaut sont insuffisantes (ajouter ou modifier des collections, etc.).

65469783.doc

page 31/46

16/11/2004

14.

Rsolution des contrles dAUDIT

Remarque pour ce chapitre : Lorsquil sera propos plusieurs solutions dont lune est lutilisation de lAUTO-RESOLVE, on recommandera toujours dutiliser la solution sans Auto-resolve (car lauto-resolve peut tre dangereux, voire impossible utiliser dans la plupart des cas de packages participating). DUPLIC! Le contenu physique du composant dans le package est strictement identique au contenu physique de la version de baseline ACTION(s) : il est inutile davoir mis ce composant dans le package, et il faut donc soit le supprimer, soit y insrer une modification. Sil sagit dun source que lon a pris en charge et recompil, sans le modifier, pour prendre en compte des copys et/ou sous-progs statiques qui ont boug, il faut supprimer ce source du package, et utiliser loption 8-Recompile du menu Build pour recompiler le source directement partir de la baseline et pour ne rcuprer dans le package que les binaires gnrs (load module, DBRM, ) !COPY! Un composant de type copy contient des copys ou des include imbriqus ACTION(s) : aucune action ncessaire : il sagit simplement dun message dinformation SYNCH0! Un composant (copy ou sous-programme statique), appel par un autre composant, est introuvable dans les baselines de ChangeMan. N.B. : ChangeMan a quand mme russi le trouver dans des bibliothques externes, et fabriquer lappelant. ACTION(s) : aucune action ncessaire : le seul moyen de retirer ce message aurait t que les administrateurs ChangeMan chargent le composant incrimin dans ChangeMan SYNCH1! Le composant na pas de statistiques ISPF, ce qui peut poser problme pour certains autres contrles de laudit. ACTION(s) : contacter un administrateur ChangeMan, pour faire crer ou rafrachir les statistiques ISPF du composant (ou de son PDS) SYNCH2! Un composant de type source na pas t compil/link-edit avec les options dfinies comme obligatoires par les administrateurs ChangeMan pour ce composant ou pour ce type de composants. N.B. : Cette anomalie ne peut bien videmment se produire que si les administrateurs ChangeMan ont fix pour certains composants certaines options comme tant obligatoires pour passer laudit/freeze. ACTION(s) : contacter un administrateur ChangeMan pour obtenir la liste des options prconises, puis refaire le stage/compil. du composant incrimin (commande S2, puis S devant le composant), avec les bonnes options. SYNCH3! Un composant de type load est physiquement corrompu et son bloc dinformations IDRDATA ne peut tre analys par ChangeMan, ce qui peut poser problme pour certains autres contrles de laudit, voire rendre ce load module inxcutable. ACTION(s) : 1. contacter un administrateur ChangeMan pour lui remonter cet incident 2. refaire le stage/compil. du composant source correspondant (commande S2, puis S devant le composant)

65469783.doc

page 32/46

16/11/2004

SYNCH4!

Le package contient un composant de type source et un composant de type copy qui est incluse (directement ou rcursivement) dans le composant source. Le SYNCH4 dtect entre ces 2 composants signifie que la copy a t (re-)modifie aprs la dernire compilation du source. ACTION(s) : Soit 1) refaire le stage/compil. du composant source (commande S2, puis S devant le composant) Soit 2) refaire laudit en activant la fonction dauto-resolve

SYNCH5!

Le package contient un composant de type copy , qui est inclus (directement ou rcursivement) dans un(des) composant(s) source(s) absent(s) du package mais prsent(s) en baseline. Le SYNCH5 dtect entre ces composants signifie que lanalyse dimpact est incomplte et quil faut recompiler/relink-editer le(s) composant(s) source(s) de baseline. ACTION(s) : Soit 1) utiliser loption 8-Recompile du menu Build pour recompiler le(s) source(s) directement partir de la baseline et pour ne rcuprer dans le package que les binaires gnrs (load module, DBRM, ) Soit 2) refaire laudit en activant la fonction dauto-resolve

SYNCH6!

Un composant ncessitant la maintenance simultane dun histo-modif (cest-dire dun composant fichier dactivit de type DOC, en terminologie ChangeMan) a t trouv dans le package, mais sans son histo-modif correspondant. Cela signifie que soit son histo-modif a t supprim manuellement par erreur, soit il y a eu un problme lors du checkout, normalement simultan, des 2 composants. ACTION(s) : 1. procder au checkout cibl du seul composant histo-modif (commande C1, et choix du type DOC) 2. le mettre jour pour y dcrire les modifications apportes son composant associ (commande S2, puis E devant le composant .DOC)

SYNCH7!

2 programmes sont presents dans le package, et lun des 2 contient un appel statique au 2me programme. Le SYNCH7 dtect entre ces 2 composants signifie que le sous-programme a t recompil/relink-edit aprs la dernire compilation/link-edit du programme appelant. ACTION(s) : Soit 1) refaire le stage/compil. du composant source appelant (commande S2, puis S devant le composant) Soit 2) refaire laudit en activant la fonction dauto-resolve

SYNCH8!

Le package contient un composant de type load , qui est appel statiquement par un(des) composant(s) source(s) absent(s) du package mais prsent(s) en baseline. Le SYNCH8 dtect entre ces composants signifie que lanalyse dimpact est incomplte et quil faut recompiler/relink-editer le(s) composant(s) source(s) de baseline. ACTION(s) : Soit 1) utiliser loption 8-Recompile du menu Build pour recompiler le(s) source(s) directement partir de la baseline et pour ne rcuprer dans le package que les binaires gnrs (load module, DBRM, )

65469783.doc

page 33/46

16/11/2004

SYNCH9!

Soit 2) refaire laudit en activant la fonction dauto-resolve

Le package contient un composant de type load qui ne correspond plus son composant source associ. Cela peut signifier que quelquun a copi, hors du contrle de ChangeMan, un load module dans les staging libraries. ACTION(s) : 1. contacter un administrateur ChangeMan pour lui remonter cet incident 2. puis lune des options suivantes : Soit refaire le stage/compil. du composant source correspondant (commande S2, puis S devant le composant) Soit refaire laudit en activant la fonction dauto-resolve

SYNCH10! Le package contient un composant qui a boug en baseline depuis que le checkout a t fait. Cela signifie que : Soit quelquun a relivr en production/baseline une nouvelle version de ce composant, depuis quon en a fait le checkout Soit quelquun a retir de production/baseline (i.e. backout + reverse baseline ripple) un package contenant ce composant, depuis quon en a fait le checkout. De toute faon, il y a un risque de rgression en production, si lon ne fait pas les reports de maintenance ncessaires ACTION(s) : Soit manuellement : 1. sauvegarder le composant du package dans une bibliothque personnelle (EDIT / CUT, ou 3.3 depuis les staging libs) 2. refaire le checkout de la nouvelle version de baseline (commande C1) dans le package 3. rinsrer les modifications dans la nouvelle version prsente dans le package (CUT en Edit depuis la bibl. personnelle, PASTE en Stage (S2) / Edit dans le package) Soit utiliser Merge & Reconcile (option C du menu principal de ChangeMan) : voir le Hand Book Merge & Reconcile SYNCH11! Un composant du package a t modifi hors du contrle de ChangeMan. ACTION(s) : 1. contacter un administrateur ChangeMan pour lui remonter cet incident 2. refaire le stage du composant (commande S2, puis E ou S devant le composant) SYNCH12! Un composant prsent dans les staging librairies nest pas dclar comme officiellement attach au package dans ChangeMan. Cette anomalie peut avoir 2 causes : 1. Quelquun ayant les autorisations dcriture sur les staging libraries y a copi le composant en dehors du contrle de ChangeMan : peu probable car les staging librairies sont fortement scurises 2. Le composant incrimin a t gnr par le stage (compil/link-edit) dun composant source , mais le job de stage a plant avant davoir pu raliser le rattachement logique du composant au package ACTION(s) : 1. contacter un administrateur ChangeMan pour lui remonter cet incident : il supprimera si ncessaire le composant des staging libs

65469783.doc

page 34/46

16/11/2004

2. Sil sagit dun composant gnr par stage (ex : type LOD, DBR, ABN, etc), alors il faut refaire le stage du composant source (commande S2, puis S devant le source) SYNCH13! Le package contient un composant qui a, au niveau de ses statistiques ISPF, une date de modification antrieure celle de la version en baseline. Cas 1 : COMPOSANTS DE TYPE TEXTE : ce cas ne devrait pas se produire car il serait pralablement intercept par le SYNCH10 . ACTION(s) : 1. contacter un administrateur ChangeMan pour lui remonter cet incident 2. appliquer la mme rsolution que pour le SYNCH10 Cas 2 : COMPOSANTS DE TYPE LOAD : il est probable quun tel load module ait t cr dans le package par recompilation de la baseline. ACTION(s) : dans ce cas, recompiler nouveau le source de baseline (qui a d, lui, bouger) pour rafrachir la version du load. SYNCH14! Un composant du package nest pas au statut ACTIVE. ACTION(s) : faire ou refaire le stage de ce composant. SYNCH15! Cas 1 : Le package contient un composant de type source qui inclut un composant de type copy . Cette copy a pu tre trouve dans le package (ou les autres package participating) ou bien en baseline. Le SYNCH15 dtect entre ces 2 composants signifie que la copy a boug (modifie dans le package, ou relivre en baseline) depuis la dernire compilation du source. Cas 2 : (trs peu probable) Le package contient un composant de type source et un composant de type LCT (cartes sysin de link-edit) associ. Le composant LCT a t activ aprs la date dactivation du source. ACTION(s) : dans les 2 cas : Soit 1) refaire le stage/compil. du composant source (commande S2, puis S devant le composant) Soit 2) refaire laudit en activant la fonction dauto-resolve SYNCH16! Le package contient un composant source recompil , i.e. mis dans le package par la fonction RECOMPILE (option 8 du menu Build). Remarques : dans le package, on distingue un composant recompil par sa procname = *RECOMP* sur le panel de Stage (commande S2) le composant source , bien quaffich, nest pas physiquement prsent dans le package : seuls ses binaires gnrs (load, DBRM, etc) y sont. Or ce composant source inclut une copy qui nest pas dans le package (donc qui a t trouve en baseline), et la date de dernire modification (ou activation) de cette copy est postrieure la date de recompile du source dans le package. En dautres termes, quelquun a relivr la copy en production, depuis que le recompile du source a t ralis ! ACTION(s) : Soit 1) refaire le recompile . du composant source (commande RC) Soit 2) refaire laudit en activant la fonction dauto-resolve SYNCH17! Une copy a t supprime du package, sans que cette suppression soit rpercute sur les autres composants du package (ou dautres packages participating).65469783.doc

page 35/46

16/11/2004

Cas 1 : une nouvelle copy (inconnue de la baseline CMN) a t charge dans le package, et est incluse dans un source du package. La copy a ensuite t supprime, sans que son inclusion dans le source soit galement supprime. ACTION(s) : supprimer les rfrences cette copy dans le source, puis refaire le stage du source. Cas 2 : une copy existante a t prise en charge (checkout) dans le package, et est incluse dans un source du package. La copy a ensuite t modifie, le source appelant a t assembl, puis la copy a t supprime, sans que lon r-assemble le source a