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.
A propos de 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.
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.