Exploitation > Migrations > Moniteur d'enchainement 

Cette fonction ne peut être utilisée que dans le dossier superviseur, et va permettre de définir et suivre l'exécution de l'ensemble des procédures de migration d'un dossier donné.

Pour ce faire, on va pouvoir ici créer un plan de migration identifié par un code. Le code à utiliser est libre, mais si on désire personnaliser les conditions de migration d'un dossier donné, on devra créer un plan de migration ayant le même code que celui du dossier à migrer, et le mettre en attente.

Si ceci n'est pas fait, lors du lancement de la migration d'un dossier donné (par la fonction de revalidation du dossier), un plan de migration nommé MIGmmdd##(mm et  dd étant les numéros du mois et du jour de lancement,## étant un numéro séquentiel) est automatiquement créé et lancé.

La création d'un plan de migration va dupliquer toutes les procédures définies dans la table des procédures dans une table d'ordonnancement dont les lignes sont présentées dans cet écran.

On pourra ensuite lancer et contrôler manuellement l'enchaînement des opérations, les interrompre ou les relancer, vérifier la trace obtenue. 

Gestion de l'écran

L'écran de la fonction présente un en-tête avec les informations globales liées au plan d'exécution courant, un premier onglet qui permet de voir le détail des opérations, et un second onglet qui permet de connaître la liste des autres plans de migration avec leur état global.

En-tête

Présentation

L'en-tête permet de définir les paramètres généraux qui définissent la façon dont le plan de migration doit s'exécuter, le statut courant lorsque la migration est en cours, et un ensemble de boutons de contrôle.

 

Champs

Les champs suivants sont présents dans cet onglet :

Identification

  • Code plan (champ PLAN)

Ce champ identifie le code du plan de migration (c'est le code du dossier par défaut).

  • Intitulé (champ INTIT)

Permet de définir un intitulé associé à chaque fiche.

  • Dossier (champ DOSSIER)

Indiquez le code du dossier de travail, tel que défini dans la table des dossiers.

  • Nb de lancements parallèles (champ NBPARL)

Cette valeur définit le nombre maximum de tâches de migration susceptibles d'être lancées en parallèle. Ce nombre ne peut pas dépasser le nombre de tâches batch autorisées. Il ne peut pas non plus, à un moment donné de la migration, dépasser le nombre de tâches de la phase courante de l'étape en cours.

  • Démarrage auto des phases (champ PHASEAUTO)

Lorsque cette case est cochée, il y a enchaînement automatique des phases : lorsque toutes les procédures d'une phase de migration sont terminées, la phase suivante est lancée automatiquement. Si cet indicateur n'est pas coché, l'utilisateur devra utiliser le bouton correspondant pour relancer l'exécution depuis le plan de travail des migrations.

Cette case est cochée par défaut si le plan est créé automatiquement par la validation de dossier.

  • Démarrage auto post-migration (champ POSTAUTO)

Lorsque cette case est cochée, les procédures de l'étape de post-migration sont automatiquement lancées une fois que les procédure des phases et étapes précédentes sont terminées (si ce n'est pas le cas, il faudra les lancer manuellement depuis le plan de travail).

Cette case est cochée par défaut si le plan est créé automatiquement par la validation de dossier.

Moniteur

  • Statut global (champ STATUT)

Cet indicateur donne l'état global du plan de migration, qui peut prendre les valeurs suivantes :

  • En attente : il est prêt à être lancé.
  • En cours : au moins une procédure de migration est toujours en cours.
  • Terminé: toutes les procédures du plan de migration sont terminées avec succès.
  • Terminé avec erreurs: au moins une des procédures de migration a échoué. Les procédures des phases suivantes n'ont donc pas pu se lancer. Il faudra veiller à remédier à l'erreur (souvent liée aux données traitées dans la procédure ayant échoué), puis relancer la procédure en question pour pouvoir continuer la migration.
  • Interrompu : l'utilisateur a lancé la migration, puis l'a interrompue : il faudra utiliser le bouton Reprendre pour que la migration reprenne son cours.
  • En attente interruption : l'utilisateur a demandé l'interruption de la migration, mais certaines procédures n'ont pas encore terminé le traitement du paquet de données en cours avant de s'interrompre.
  • En attente arrêt : l'utilisateur a demandé un arrêt, mais celui-ci n'est pas encore effectif.
  • Lancé : la migration est lancée, mais aucune tâche n'a encore démarré.
  • Date lancement (champ DATEL)

Ce champ affiché permet de connaître la date à laquelle la migration a été lancée.

  • Heure lancement (champ HEUL)

Ce champ permet d'afficher l'heure à laquelle la migration a été lancée.

  • Temps global (HHH:mm) (champ ELAPSEDG)

Ce champ indique le temps total passé depuis le début de la migration. Ce temps correspond à la différence entre :

  • la date et heure de fin si l'exécution du plan est terminée,
  • la date et heure courante si l'exécution du plan n'est pas terminée

et la date et heure de départ.

Autrement dit, il ne s'agit pas d'un temps de migration cumulé tenant compte des temps d'exécution réels.

  • En attente (champ NBM1)

Ce champ indique le nombre de tâches de migration en attente.

  • Lancé (champ NBM8)

Ce champ indique le nombre de tâches de migration lancées.

  • En cours (champ NBM2)

Ce champ indique le nombre de tâches de migration en cours.

  • Terminé (champ NBM3)

Ce champ indique le nombre de tâches de migration terminées sans erreurs.

  • Terminé avec erreurs (champ NBM4)

Ce champ indique le nombre de tâches de migration terminées avec des erreurs.

  • Débrayé (champ NBM11)

Ce champ indique le nombre de tâches de migration débrayées.

  • En attente interruption (champ NBM6)

Ce champ indique le nombre de tâches de migration en attente d'interruption.

  • En attente d'arrêt (champ NBM7)

Ce champ indique le nombre de tâches de migration en attente d'arrêt.

  • Interrompu (champ NBM5)

Ce champ indique le nombre de tâches de migration interrompues.

  • Bloqué (champ NBM10)

Ce champ indique le nombre de tâches de migration bloquées.

Contrôle

  • Lancer/Reprendre (champ ACTIV)

Ce bouton permet de lancer la migration, ou de la reprendre si elle avait été interrompue au préalable.

  • Interrompre (champ INTERR)

Ce bouton permet d'interrompre l'ensemble des procédures de migration en cours d'exécution. L'interruption d'une tâche n'est pas forcément immédiat. En effet, une tâche traite les lignes dans la base de données par groupes (le nombre de lignes traitées apparaît dans l'écran). Lorque ce bouton est utilisé, un ordre d'interruption est envoyé à la tâche, et celle-ci termine le groupe de lignes en cours avant de s'arrêter.

Il sera ainsi possible de reprendre l'exécution au groupe de données suivant.

  • Arrêter les lancements (champ ARRET)

Ce bouton permet d'arrêter les lancements de procédures de migration. Ceci signifie que les tâches batch déjà lancées vont se terminer, mais qu'aucune nouvelle tâche liée à une procédure de migration du plan ne sera lancée.

  • Rafraichir (champ RAFR)

Ce bouton permet de rafraîchir le tableau qui donne l'indication des procédures en cours, de leur état, et du nombre de lignes traitées.

  • Tout bloquer (champ BLOQUER)

Ce bouton permet de bloquer toutes les procédures en cours. Une procédure bloquée ne sera pas lancée, même si elle pourrait l'être parce que les conditions (terminaison des étapes et phases antérieures) le permettraient. Une procédure bloquée peut être débloquée individuellement par clic droit sur la ligne.

  • Tout débloquer (champ DEBLOQUER)

Ce bouton permet de débloquer toutes les procédures bloquées. Un déblocage individuel d'une tâche est aussi possible par clic droit sur la ligne.

 

Onglet Moniteur

Cet onglet affiche l'état des procédures de migration. On trouvera une ligne par procédure dans le tableau.

 

Champs

Les champs suivants sont présents dans cet onglet :

Tableau

  • Code (champ CODE)

Ce code identifie de façon unique la procédure de migration courante.

  • Statut (champ STATUTM)

Cet indicateur donne l'état de la procédure définie par la ligne, qui peut prendre les valeurs suivantes :

  • En attente : la procédure est prête à être lancée.
  • En cours : la procédure de migration est toujours en cours.
  • Terminé: la procédure du plan de migration s'est terminée avec succès.
  • Terminé avec erreurs: la procédure de migration a échoué. Les procédures des phases suivantes n'ont donc pas pu se lancer. Il faudra veiller à remédier à l'erreur (souvent liée aux données traitées dans la procédure aya,t échoué), puis relancer la procédure en question pour pouvoir continuer la migration.
  • Interrompu : l'utilisateur a lancé la migration, puis l'a interrompu : il faudra utiliser le bouton Reprendre pour que la migration reprenne son cours.
  • En attente interruption : l'utilisateur a demandé l'interruption de la migration, mais la procédure n'a pas encore terminé le traitement du paquet de données en cours avant de s'interrompre.
  • En attente arrêt : l'utilisateur a demandé un arrêt, mais celui-ci n'est pas encore effectif.
  • Lancé : la procédure est lancée, mais n'a pas encore démarré.
  • Arrêté: la procédure est arrêtée.
  • Bloqué : la procédure est dans l'état Bloqué. Il faudra la débloquer pour qu'elle puisse reprendre.
  • Débrayé : la procédure est terminée avec des erreurs, mais l'utilisateur l'a débrayée manuellement (sous sa responsabilité) en considérant que les erreurs constatées dans cette procédure n'empêchent pas la suite de l'exécution du plan de migration.
  • Intitulé (champ INTITM)

Permet de définir un intitulé associé à chaque fiche.

  • Etape (champ RANGMOD)

Indique le numéro d'étape de la procédure.

  • Module (champ MODULE)

Sélectionnez un module pour le paramétrage.

Ce champ vous permet de renseigner si l'écran doit être créé dans la base de données du dossier. Il l'est si le module auquel l'écran est rattaché est actif pour le dossier.

  • Indice (champ INDICEM)

 

  • Phase (champ PHASE)

La phase est un numéro susceptible de varier de 1 à 9, qui permet d'ordonnancer de façon stricte les procédures de migration. Tant que toutes les procédures d'une phase ne sont pas terminées, les phases suivantes ne pourront pas être lancées.
La phase ne peut pas être modifiée pour une procédure standard.

  • Rang (champ RANG)

Le rang est un numéro susceptible de varier de 1 à 99, qui permet de donner un ordre préférentiel de lancement d'une procédure de migration dans une phase et pour un module donné. Ce rang peut être changé pour les procédures standard.

  • Nb traités (champ NBENREGT)

Indique le nombre de lignes déjà traitées lors de la procédure de migration.

  • Nb à traiter (champ NBENREG)

Indique le nombre de lignes à traiter lors de la procédure de migration.

  • Temps passé (champ ELAPSED)

Cette valeur indique le temps (en heures et minutes) passé sur cette procédure.

Ce champ indique le temps total passé depuis le début de la procédure. Ce temps correspond à la différence entre :

  • la date et heure de fin si la procédure est terminée,
  • la date et heure courante si la procédure n'est pas terminée

et la date et heure de départ.

Autrement dit, il ne s'agit pas d'un temps d'exécution cumulé sur cette procédure tenant compte des temps d'exécution réels.

  • Date lancement (champ DATELM)

Ce champ donne la date de lancement de la procédure.

  • Heure lancement (champ HEULM)

Ce champ donne l'heure de lancement de la procédure.

  • Date mise à jour (champ DATEMAJ)

Ce champ donne la date de dernière mise à jour du statut de la procédure.

  • Heure mise à jour (champ HEUMAJ)

Ce champ donne l'heure de dernière mise à jour du statut de la procédure.

 

Icône Actions

Reprendre

Permet de reprendre l'exécution d'une procédure préalablement arrêtée. La reprise se fait à partir de la première donnée non encore traitée par la procédure.

Interrompre

Permet d'interrompre l'exécution d'une procédure de migration.

Trace

Permet de visualiser la trace d'exécution d'une procédure.

Relancer

Permet de relancer l'exécution d'une procédure (i.e. d'en reprendre l'exécution depuis le début, en repartant d'une table destination vide et en reprenant l'ensemble des données à transcoder).

Bloquer

Permet de bloquer une procédure de migration qui n'aurait pas encore été lancée, c'est-à-dire d'en interdire l'exécution, même si les conditions de séquencement permettraient son lancement. Ceci a pour conséquence de ne pas permettre l'exécution des procédures se trouvant dans des étapes ou phases ultérieures, puisque la tâche bloquée devra avoir été débloquée, puis exécutée, pour que les conditions d'enchaînement permettent de continuer.

Débloquer

Permet de débloquer une procédure de migration préalablement bloquée.

Débrayer

Permet, lorsqu'une procédure s'est terminée avec des erreurs, d'enchaîner quand même les procédures de phase ou étapes supérieures.

Attention ! Il est recommandé de ne pas utiliser ce débrayage dans une migration réelle sans avoir bien mesuré les risques encourus. En effet, débrayer une procédure peut créer des effets de bord sur les procédures suivantes, et au final conduire à un dossier mal migré .

Relancer avec nouveau filtre

 

 

Onglet Options

Présentation

Cet onglet permet de spécifier les tablespaces (dans le cas oracle) ou les fichiers de données (dans le cas de SQL server) utilisés pour les données et index pour les tables temporaires (commençant par U) utilisées lors de la migration. Cet onglet doit être rempli lors de la création d'un plan de migration. En l'absence de saisie, les tablespaces et fichiers de données par défaut du dossier seront utilisés.

 

Champs

Les champs suivants sont présents dans cet onglet :

  • champ INTITFIL

 

  • Données (champ DAAFIL)

Fichier ou tablespace utilisé pour les données des tables de migration commençant par U.

  • Index (champ IDXFIL)

Fichier ou tablespace utilisé pour les index des tables de migration commençant par U.

 

Onglet Liste des plans

Présentation

Cet onglet permet de lister les plans de migration présents et d'en connaître l'état.

 

Champs

Les champs suivants sont présents dans cet onglet :

Tableau

  • Code plan (champ MPLAN)

Ce champ identifie le code du plan de migration (c'est le code du dossier par défaut).

  • Dossier (champ MDOSSIER)

Indiquez le code du dossier de travail, tel que défini dans la table des dossiers.

  • Statut (champ MSTATUT)

Cet indicateur donne l'état global du plan de migration, qui peut prendre les valeurs suivantes :

  • En attente : il est prêt à être lancé.
  • En cours : au moins une procédure de migration est toujours en cours.
  • Terminé: toutes les procédures du plan de migration sont terminées avec succès.
  • Terminé avec erreurs: au moins une des procédures de migration a échoué. Les procédures des phases suivantes n'ont donc pas pu se lancer. Il faudra veiller à remédier à l'erreur (souvent liée aux données traitées dans la procédure ayant échoué), puis relancer la procédure en question pour pouvoir continuer la migration.
  • Interrompu : l'utilisateur a lancé la migration, puis l'a interrompue : il faudra utiliser le bouton Reprendre pour que la migration reprenne son cours.
  • En attente interruption : l'utilisateur a demandé l'interruption de la migration, mais certaines procédures n'ont pas encore terminé le traitement du paquet de données en cours avant de s'interrompre.
  • En attente arrêt : l'utilisateur a demandé un arrêt, mais celui-ci n'est pas encore effectif.
  • Lancé : la migration est lancée, mais aucune tâche n'a encore démarré.
  • Intitulé (champ MINTIT)

Permet de définir un intitulé associé à chaque fiche.

  • Date lancement (champ MDATEL)

Ce champ affiché permet de connaître la date à laquelle la migration a été lancée.

  • Heure lancement (champ MHEUL)

Ce champ permet d'afficher l'heure à laquelle la migration a été lancée.

  • Date mise à jour (champ MDATEEC)

Ce champ affiché permet de connaître la dernière date à laquelle la migration a été mise à jour.

  • Heure mise à jour (champ MHEUEC)

Ce champ permet d'afficher l'heure à laquelle la migration a été mise à jour.

  • Temps passé (champ MELAPSED)

Ce champ indique le temps total passé depuis le début de la migration. Ce temps correspond à la différence entre :

  • la date et heure de fin si l'exécution du plan est terminée,
  • la date et heure courante si l'exécution du plan n'est pas terminée

et la date et heure de départ.

Autrement dit, il ne s'agit pas d'un temps de migration cumulé tenant compte des temps d'exécution réels.

  • Démar. auto phases (champ PHASEAUTO)

Lorsque cette case est cochée, il y a enchaînement automatique des phases : lorsque toutes les procédures d'une phase de migration sont terminées, la phase suivante est lancée automatiquement. Si cet indicateur n'est pas coché, l'utilisateur devra utiliser le bouton correspondant pour relancer l'exécution depuis le plan de travail des migrations.

Cette case est cochée par défaut si le plan est créé automatiquement par la validation de dossier.

  • Démar. auto post-mig (champ POSTAUTO)

Lorsque cette case est cochée, les procédures de l'étape de post-migration sont automatiquement lancées une fois que les procédure des phases et étapes précédentes sont terminées (si ce n'est pas le cas, il faudra les lancer manuellement depuis le plan de travail).

Cette case est cochée par défaut si le plan est créé automatiquement par la validation de dossier.

 

Icône Actions

Suppression

Permet de supprimer un plan.

Trace

Permet de consulter la trace d'exécution du plan.

 

 

Boutons spécifiques

Permet de visualiser la trace globale par agrégation de toutes les procédures de migration. Cette trace est uniquement visible si la migration a été lancée en batch (normalement par la validation de dossier).

Cette trace globale est mise à jour à la fin de chaque procdure de migration, en y cumulant les lignes de trace de la procédure correspondante. Ainsi, les procédures apparaissent dans l'ordre de terminaison. Si une procédure est relancée plusieurs fois (à la suite d'une prise de contrôle manuelle du plan), la trace présentera plusieurs fois le détail de la procédure, mais avec une ligne indiquant "lancement initial" lors du premier lancement, et "relance N" dans le cas d'une Nième relance.

Permet de zoomer sur la gestion des requêtes batch.

Permet de créer la fiche plan.

Permet d'enregistrer des modifications faites dans la fiche plan.

Messages d'erreur et d'information

Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :

Programme déjà en cours

On tente de lancer une procédure de migration déjà en cours d'exécution

Voulez vous remettre en attente les procédures interrompues et en cours les procédures en attente d'interruption ?

Ce message est affiché sous la forme d'une demande de confirmation lorsqu'on réactive un plan.

Lancement impossible

Ce message est affiché lorsqu'on essaie de lancer un plan sans que les conditions d'exécution en soient remplies.

Voulez vous lancer le plan xxx ?

Ce message est affiché pour demander une confirmation lors du lancement d'un plan.

Voulez vous reprendre l'exécution du plan xxx ?

Ce message est affiché pour demander une confirmation lors de la reprise d'exécution d'un plan.

Voulez vous arrêter le plan en cours  (les procédures en cours seront terminées) ?

Ce message est affiché pour demander une confirmation lors de l'arrêt d'un plan.

Voulez vous interrompre le plan en cours  (les procédures en cours seront interrompues) ?

Ce message est affiché pour demander une confirmation lors de l'interruption d'un plan.

Le plan n'existe pas

Ce message est affiché lorsqu'on saisit un code plan inexistant sans être en cours de création de plan.

Vous ne pouvez reprendre qu'une procédure stoppée ou en erreur

Ce message est affiché lorsqu'on tente de reprendre une migration sur un plan qui n'est pas dans l'état stoppé ou en erreur.

Voulez vous reprendre après le dernier point d'arrêt la procédure xxx ?

Ce message est une demande de confirmation lorsqu'on désire reprendre une procédure unitaire.

Voulez vous relancer depuis le début la procédure xxx ?

Ce message est une demande de confirmation lorsqu'on désire relancer une procédure unitaire.

Voulez vous également reprendre toutes les procédures de phase ou étape supérieure qui sont terminées ou interrompues ?

Ce message est affiché lorsqu'une procédure est relancée depuis le début, alors que des phase ou étapes supérieures ont déjà été exécutées. Il est alors possible de relancer en même temps toutes les procédures des phases ou étapes suivantes, terminées (avec ou sans erreur) ou interrompues, en répondant Oui à la question.

Vous ne pouvez bloquer qu'une procédure en attente

Ce message est affiché lorsqu'on tente de bloquer une procédure qui n'est pas en attente.

Souhaitez vous bloquer toute la phase ?

Ce message est affiché lorsqu'on bloque une procédure dans une phase. Si on répond positivement, toutes les procédures de l'étape courante et de la phase concernée seront bloquées.

Vous ne pouvez débloquer qu'une procédure bloquée

Ce message d'erreur est affiché lorsqu'on tente de débloquer une procédure qui n'est pas dans l'état bloqué.

Souhaitez vous débloquer toute la phase ?

Ce message est affiché lorsqu'on débloque une procédure dans une phase. Si on répond positivement, toutes les procédures de l'étape courante et de la phase concernée seront débloquées.

Confirmez vous la suppresssion du plan xxx ?

Ce message permet de confirmer la suppression d'un plan lorsqu'elle est demandée.

Attention, votre licence est limitée à ### tâches batch

Ce message d'erreur est affiché lorsqu'on tente de paramétrer un nombre de tâches simultanées supérieur à ce qu'autorise la licence.

Attention, votre paramétrage ne vous permet de lancer en parallèle que ### tâches batch

Ce message d'erreur est affiché lorsqu'on tente de paramétrer un nombre de tâches simultanées supérieur au nombre de tâches batch simultanées définies dans le paramétrage du serveur batch.

Etes-vous sûr de vouloir débrayer cette procédure et de débloquer ainsi l'exécution des phases suivantes

Ce message d'erreur est affiché lorsqu'on tente de débrayer une procédure dont l'exécution a conduit à des erreurs.

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre