Rational Developer for System z

Définition de critères pour la comparaison CARMA

CARMA a la possibilité de comparer des ressources (associées) dans l'espace de travail Rational Developer (par exemple, des projets locaux ou distants) avec des ressources d'un gestionnaire RAM CARMA. Cette fonction est utile pour déterminer les modifications apportées aux fichiers de l'espace de travail avant de restituer ces modifications dans CARMA.

Pourquoi et quand exécuter cette tâche

CARMA stocke les valeurs des critères en cours lorsqu'il télécharge une ressource dans l'espace de travail. En fonction des changements de valeur de critère et d'espace de travail, CARMA peut déterminer les modifications apportées à la version dans le gestionnaire RAM et indiquer dans quelle direction les modifications doivent être appliquées. Par exemple, CARMA peut déterminer si un fichier d'espace de travail a été mis à jour en local, dans le gestionnaire RAM ou les deux. En fonction des informations de modification, CARMA peut indiquer les portions du fichier qui ont été modifiées, et où ces changements doivent être téléchargés dans le gestionnaire RAM, copiées depuis le gestionnaire RAM, ou si une fusion doit être effectuée car des modifications ont été effectuées dans l'espace de travail et dans le gestionnaire RAM.

Afin d'effectuer la comparaison de façon flexible, CARMA fournit un fichier de configuration de critères de comparaison, syncConfig.xml. Ce fichier syncConfig est placé dans le répertoire de configuration RSE* et automatiquement remonté par CARMA au démarrage de l'Explorateur de systèmes distants (RSE)**.

Le fichier de configuration de comparaison permet au développeur de logiciel RAM de spécifier différents critères pour la comparaison sur une base RAM par RAM. Exemple de fichier de configuration de comparaison :
<?xml version="1.0" encoding="UTF-8"?>
<CARMACompare xmlns="http://www.ibm.com/CARMA/SyncConfig">
      <RAMCompare ramId="00">

            <memberinfo key="Last Modified Date" type="date" format="MM/DD/YY"/>
            <memberinfo key="Last Modified Time" type="date" format="HH:MM"/>
            <memberinfo key="Last Modified Seconds" type="int" />
      </RAMCompare>
      <RAMCompare ramId="01">
            <content />
      </RAMCompare>
</CARMACompare>

Le document XML doit commencer par un élément CARMACompare. L'élément CARMACompare peut comporter un ou plusieurs éléments RAMCompare. Chaque élément RAMCompare spécifie les critères de comparaison d'un gestionnaire RAM unique. Le gestionnaire RAM auquel s'appliquent les critères est annoncé par l'attribut ramId. La valeur ramId doit correspondre à l'ID RAM de la configuration VSAM CARMA. Il s'agit d'un nombre à deux chiffres. Un zéro doit être ajouté au début de la valeur de l'ID si celui-ci comporte un seul chiffre.

Remarque : Vous pouvez identifier un gestionnaire RAM en utilisant ramId ou uniqueId. Si vous connaissez l'ID spécifique du gestionnaire RAM, utilisez l'élément ramId. Si vous connaissez le gestionnaire RAM mais ne connaissez pas l'ID RAM associé, utilisez l'élément uniqueId.
L'exemple ci-dessus définit des critères de comparaison pour deux gestionnaires RAM, 01 et 02. Chaque élément RAMCompare contient les critères du gestionnaire RAM. Actuellement, les critères disponibles pour la vérification incluent les éléments suivants :
  • Infos membre
  • Contenu membre

Infos membre

La configuration peut définir un ou plusieurs éléments memberinfo pour chaque RAMCompare. Les éléments d'infos membre sont concaténés pour former une comparaison. L'élément d'infos membre contient des attributs key, type, et éventuellement format. Actuellement, les attributs type et format sont ignorés, mais une explication d'utilisation est incluse. Les clés sont actuellement comparées directement pour l'équivalence de chaîne.
Attribut key
L'attribut key référence un élément d'infos membre trouvé dans les propriétés d'une ressource. L'attribut key doit correspondre à la clé renvoyée par le gestionnaire RAM pour la ressource.
Attribut type
L'attribut type spécifie la façon dont la valeur de clé doit être traitée. L'attribut type peut être défini sur l'une des valeurs suivantes :
  • ent
  • chaîne
  • variable flottante
  • date
Le type définit la façon dont les infos membre doivent être comparées. Dans l'exemple d'utilisation des critères suivants
<memberinfo key="Last Modified Seconds" type="int" />
Une valeur d'infos membre de 0001 doit être égale à 1.
Attribut format
L'attribut format est requis uniquement pour les éléments qui spécifient un type de “date”. L'attribut format autorise les critères permettant de définir comment la valeur de date doit être analysée et comparée. Par exemple, dans l'utilisation des critères suivants :
<memberinfo key="Last Modified Time" type="date" format="HH:MM"/>
Une valeur d'infos membre de 1:10 PM doit être équivalent à 13:10.

Contenu membre

La configuration peut définir un élément de contenu pour chaque RAMCompare. L'élément de contenu indique que CARMA doit rechercher des modifications dans le contenu des octets.
Remarque : Ceci nécessite que la totalité du fichier soit téléchargée dans l'espace de travail pour l'exécution de la comparaison.
Le contenu du fichier est téléchargé dans l'espace de travail et un hachage de fichier (MD5) est effectué sur le contenu. Si le hachage du contenu du fichier diffère de celui de l'espace de travail, une différence est indiquée.

Critères de comparaison par défaut

Si un élément RAMCompare n'est pas défini pour un gestionnaire RAM géré par CARMA, un jeu de critères de comparaison par défaut est utilisé. Le jeu par défaut recherche d'abord si une clé d'infos membre carma.version est définie pour la ressource faisant l'objet de la comparaison. Si la clé carma.version est disponible, la valeur de clé unique est utilisée comme critère de comparaison. Si aucune clé carma.version n'est disponible, la comparaison est effectuée en fonction du contenu membre.

Remarque : * Voir le manuel Rational Developer for System z Host Configuration Guide (SC23-7658-00) pour plus d'informations sur le répertoire de configuration RSE.
Remarque : ** Le fichier de configuration de comparaison est uniquement remonté au démarrage de l'Explorateur de systèmes distants (RSE). Pour que les modifications soient détectées, déconnectez puis reconnectez l'Explorateur de systèmes distants.

Conditions d'utilisation | Commentaires en retour

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)