Compréhension des termes clés

Cette rubrique définit les termes clés associés au Package CrossPlatformSCM. Vous devez les connaître avant d'utiliser le package.

Enregistrements de configuration
Deux types d'enregistrement de configuration distincts sont fournis avec le Package CrossPlatformSCM :
Enregistrement SCLMBuildConfig
Un enregistrement SCLMBuildConfig est un enregistrement de configuration sans état et réutilisable qui définit les paramètres du système hôte SCLM tels que le nom d'hôte, le projet et les options de compilation et de promotion nécessaires pour exécuter et promouvoir une compilation d'objets SCLM. Un enregistrement SCLMBuildConfig est utilisé conjointement à un enregistrement SCLMBuild.
Remarque : Les champs Configuration Name et Description mis à part, les champs modifiables de cet enregistrement n'admettent que les caractères ASCII, quel que soit le jeu de caractères utilisé. Cette limitation tient à une restriction liée au composant serveur de l'intégration SCLM qui s'exécute sous z/OS.
Enregistrement CCBuildConfig
Un enregistrement CCBuildConfig est un enregistrement de configuration Rational ClearCase sans état et réutilisable qui définit les paramètres Rational ClearCase suivants : les vues et les commandes des opérations de compilation et de promotion nécessaires pour générer et promouvoir des artefacts Rational ClearCase et les mots clés utilisables pour indiquer si une opération de compilation ou de promotion a réussi ou non. Un enregistrement CCBuildConfig est utilisé conjointement à un enregistrement CCBuild.
Enregistrements de compilation
Trois types d'enregistrement de compilation sont fournis avec le Package CrossPlatformSCM :
Enregistrement CrossPlatformBuild
Un enregistrement CrossPlatformBuild est un enregistrement parent avec état non réutilisable qui exécute une opération coordonnée de compilation et de promotion dans des projets SCLM et des vues Rational ClearCase indiqués par des enregistrements enfant SCLMBuild et CCBuild. Au moins un enregistrement enfant SCLMBuild ou CCBuild doit être associé à un enregistrement CrossPlatformBuild, mais il peut avoir plusieurs enregistrements enfant des deux types.
Enregistrement SCLMBuild
Un enregistrement SCLMBuild est un enregistrement avec état non réutilisable utilisé pour générer et promouvoir un projet SCLM unique sur un hôte donné. Un tel enregistrement peut être créé pour une exécution par lots ou en ligne. Un enregistrement SCLMBuild est utilisé conjointement à un enregistrement SCLMBuildConfig.
Remarque : Les champs Headline et Description mis à part, les champs modifiables de cet enregistrement n'admettent que les caractères ASCII, quel que soit le jeu de caractères utilisé. Cette limitation tient à une restriction liée au composant serveur de l'intégration SCLM qui s'exécute sous z/OS.
Enregistrement CCBuild
Un enregistrement CCBuild est un enregistrement avec état non réutilisable utilisé pour générer et promouvoir une vue Rational ClearCase unique. Un enregistrement CCBuild est utilisé conjointement à un enregistrement CCBuildConfig.
Etats des enregistrements de compilation
Les enregistrements de compilation peuvent passer par sept états différents pendant la procédure de compilation et de promotion. La liste suivante définit les états que peuvent avoir les enregistrements de compilation dans le Package CrossPlatformSCM et indique l'ordre selon lequel ils évoluent du début à la fin.

Ces états changent lors du fonctionnement normal mais peuvent également être changés manuellement par les utilisateurs qui appartiennent au groupe d'utilisateurs Rational ClearQuest restreint. Pour plus d'informations sur ce groupe, voir Création d'un groupe d'utilisateurs Rational ClearQuest "restreint" (facultatif).

Submitted
Etat d'un enregistrement de compilation venant d'être créé.
BuildPending
Etat que prend un enregistrement de compilation au démarrage d'une compilation.
BuildFailed
La signification de cet état n'est pas la même pour les enregistrements de compilation Rational ClearCase et SCLM :
  • Un enregistrement CCBuild prend cet état si des mots clés indiquant un incident apparaissent à la section Build de l'enregistrement CCBuildConfig associé, si aucun mot clé relatif à la réussite ou à l'échec de l'opération indiqué par l'enregistrement CCBuildConfig n'est détecté, si des mots clés relatifs à la réussite et à l'échec sont détectés ou si la commande de compilation ne peut être exécutée (si, par exemple, le fichier ou répertoire spécifié n'existe pas).
  • Un enregistrement SCLMBuild est associé à cet état uniquement lorsque la compilation des objets sur l'hôte échoue. Consultez les messages d'erreur dans <rational_root>\ClearQuest\cpscm.log. Pour toute information complémentaire sur les communications SCLM, voir <rational_root>\ClearQuest\cpscm_communications.log
  • Un enregistrement CrossPlatformBuild prend cet état lorsqu'au moins l'un des enregistrements enfant CCBuild et SCLMBuild associés le prend.
BuildCompleted
La signification de cet état n'est pas la même pour les enregistrements de compilation Rational ClearCase et SCLM :
  • Un enregistrement CCBuild prend cet état lorsque la commande de compilation indiquée dans l'enregistrement CCBuildConfig associé réussit et qu'aucun mot clé indiquant la réussite n'apparaît dans la sortie de compilation. Pour vérifier qu'une compilation a réussi lorsqu'aucun mot clé ne le signale, consultez le fichier journal <racine_rational>\ClearQuest\cpscm.log ou vérifiez que les fichiers sont générés conformément à la commande exécutée.
  • Un enregistrement SCLMBuild est associé à cet état uniquement lorsque la compilation des objets sur l'hôte réussit.
  • Un enregistrement CrossPlatformBuild prend cet état lorsque tous les enregistrements enfant CCBuild et SCLMBuild associés le prennent.
PromotePending
Etat que prend un enregistrement de compilation au démarrage d'une promotion.
PromoteFailed
La signification de cet état n'est pas la même pour les enregistrements de compilation Rational ClearCase et SCLM :
  • Un enregistrement CCBuild prend cet état si des mots clés indiquant un incident apparaissent à la section Promote de l'enregistrement CCBuildConfig associé, si aucun mot clé relatif à la réussite ou à l'échec de l'opération indiqué par l'enregistrement CCBuildConfig n'est détecté, si des mots clés relatifs à la réussite et à l'échec sont détectés ou si la commande de promotion ne peut être exécutée (si, par exemple, le fichier ou répertoire spécifié n'existe pas).
  • Un enregistrement SCLMBuild est associé à cet état uniquement lorsque la promotion des objets sur l'hôte échoue. Consultez les messages d'erreur dans <rational_root>\ClearQuest\cpscm.log. Pour toute information complémentaire sur les communications SCLM, voir <rational_root>\ClearQuest\cpscm_communications.log
  • Un enregistrement CrossPlatformBuild parent prend cet état lorsqu'au moins l'un des enregistrements enfant CCBuild et SCLMBuild associés le prend.
PromoteCompleted
La signification de cet état n'est pas la même pour les enregistrements de compilation Rational ClearCase et SCLM.
  • Un enregistrement CCBuild prend cet état lorsque la commande de promotion indiquée dans l'enregistrement CCBuildConfig associé réussit et qu'aucun mot clé indiquant la réussite n'apparaît dans la sortie de promotion. Pour vérifier qu'une promotion a réussi lorsqu'aucun mot clé ne le signale, consultez le fichier journal <racine_rational>\ClearQuest\cpscm.log ou vérifiez que les fichiers sont promus en fonction de la commande exécutée.
  • Un enregistrement SCLMBuild est associé à cet état uniquement lorsque la promotion des objets sur l'hôte réussit.
  • Un enregistrement CrossPlatformBuild parent prend cet état lorsque tous les enregistrements enfant CCBuild et SCLMBuild associés le prennent également.
Package
Le terme package n'a pas le même sens dans les environnements SCLM et Rational ClearQuest :
  • Dans l'environnement SCLM, le terme package fait référence à la définition d'une architecture qui décrit la configuration sous SCLM et comment elle doit être construite et intégrée. C'est le cas, par exemple, d'une unité logique, d'un lien ou d'une unité compilée. Les définitions d'architecture sont créées et mises à jour par des développeurs et décrivent l'architecture d'une application.
  • Dans Rational ClearQuest, le terme package fait référence à un ensemble de types d'enregistrements et d'actions pouvant être appliqués à un schéma existant afin d'offrir une fonctionnalité ou une fonction complexe. La nouvelle fonctionnalité ou fonction devient ensuite un élément permanent du schéma. Un package Rational ClearQuest peut ajouter une fonction jugée utile par de nombreux clients Rational ClearQuest, telle que la possibilité d'envoyer des notifications par courrier électronique lorsque des incidents sont soumis ou la possibilité d'associer des pièces jointes aux enregistrements.
Promouvoir
Le terme promote n'a pas le même sens dans les environnements SCLM et Rational ClearCase :
  • Dans SCLM, le terme promouvoir fait référence au déplacement d'un package SCLM dont la compilation a réussi d'un groupe de projets vers un autre, en fonction de l'architecture du projet et des définitions associées. Une promotion SCLM peut également être considérée comme la procédure consistant à déplacer des membres modifiés d'une application ou de ses composants au sein d'un package d'un niveau de la hiérarchie du projet au suivant. Vous pouvez effectuer plusieurs promotions sur la même compilation si c'est nécessaire pour la faire monter dans la hiérarchie du groupe.
    Remarque : Les enregistrements CCBuild ne prennent pas en charge plusieurs niveaux de promotion. Les enregistrements CCBuild ignorent les opérations de promotion qui suivent la première.
  • Dans Rational ClearCase, le terme promouvoir fait référence à l'exécution de la commande Rational ClearCase indiquée dans le champ Promote Command de l'enregistrement CCBuildConfig. Cette commande agit sur la vue Rational ClearCase indiquée au champ View de cet enregistrement. Voici quelques exemples de commandes de promotion possibles dans Rational ClearCase : findmerge, deliver et scripts perl personnalisés.
    Remarque : Les enregistrements CCBuild ne prennent pas en charge plusieurs niveaux de promotion. Les enregistrements CCBuild ignorent les opérations de promotion qui suivent la première.


Retour d'informations