Modification d'un fichier de configuration Atom

L'éditeur de configuration Atom de CICS Explorer permet de modifier des données existantes ou d'ajouter des données aux fichiers de configuration Atom. Vous pouvez ajouter ou mettre à jour des informations dans l'éditeur, enregistrer les modifications, et mettre à jour le code XML du fichier de configuration Atom.

Avant de commencer

Vous devez disposer du fichier de configuration Atom d'un projet de regroupement dans la vue Explorateur de projets de CICS Explorer.

Pourquoi et quand exécuter cette tâche

L'éditeur de configuration Atom constitue l'éditeur par défaut pour la modification des fichiers de configuration Atom. Son utilisation permet de n'indiquer que les valeurs des attributs car il crée automatiquement le code XML. Vous pouvez également utiliser un éditeur de texte pour modifier le code XML directement. Réalisez la procédure suivante pour modifier un fichier de configuration Atom à l'aide de l'éditeur de configuration Atom.

Procédure

  1. Assurez-vous que le fichier de configuration Atom est ouvert dans l'éditeur de configuration Atom. Dans le cas contraire, cliquez deux fois sur le fichier pour l'ouvrir.
  2. Entrez les valeurs pour les attributs supplémentaires répertoriés dans l'éditeur. Vous pouvez également modifier les zones préalablement renseignées par l'assistant de configuration Atom. Le tableau suivant présente les zones supplémentaires de l'éditeur de configuration Atom.
    Option Description
    Root XML element (Elément XML racine) Nom de la structure de données supérieure de la liaison XML. Cet attribut doit être défini si la liaison XML compte plus d'un ensemble de conversions.
    Feed - Link URI (Flux - URI de liaison) Chemin d'accès complet que les clients Web peuvent utiliser pour extraire les flux Atom. Le chemin doit commencer avec le chemin partiel spécifié dans la définition de ressource URIMAP pour le flux Atom. Vous pouvez omettre le schéma et l'hôte de l'URI, et ne spécifier que le composant chemin. CICS ajoute ces composants à l'URI lors du renvoi du flux Atom au client, afin de respecter la spécification de format Atom.
    Window Size (Taille de la fenêtre) Nombre d'entrées par défaut renvoyées par CICS dans le flux Atom. Si vous laissez cette zone vide, le système utilise la taille de fenêtre par défaut 8. La taille de la fenêtre n'est appliquée que lorsqu'un client Web établit une requête à l'aide de l'URI de liaison du flux ou de l'URI de navigation d'une liste partielle d'entrées Atom.
    Entry - Link URI (Entrée - URI de liaison) Chemin d'URI standard pouvant être étendu afin d'être appliqué à n'importe quel document d'entrées Atom, et permettant aux clients Atom d'extraire ces documents individuellement. Le chemin doit commencer avec la chemin partiel spécifié dans la définition de ressource URIMAP pour le flux Atom. Le reste de ce chemin standard doit être différent du chemin d'accès complet spécifié dans l'URI de liaison du flux. Vous pouvez omettre le schéma et l'hôte de l'URI, et ne spécifier que le composant chemin. CICS ajoute ces composants à l'URI lors du renvoi du flux Atom au client, afin de respecter la spécification de format Atom.
    URI Chemin d'accès partiel commun du flux Atom. L'assistant renseigne cette zone à l'aide de la valeur spécifiée dans la zone Default URI (URI par défaut), à laquelle il ajoute ensuite les caractères /*. Si vous utilisez la valeur fournie par l'assistant ou que vous indiquez un URI différent, CICS crée la définition de ressource URIMAP de manière dynamique. Si vous réinitialisez cette zone, la région CICS doit déjà comporter une définition de ressource URIMAP.
    Transaction ID (ID de transaction) Nom d'une transaction d'alias pour le flux Atom. Si vous ne spécifiez aucun ID de transaction, le système utilise l'ID de transaction d'alias par défaut pour les flux Atom, CW2A.
    ID utilisateur ID utilisateur sous lequel la transaction d'alias est associée. L'ID spécifié dans cette zone est remplacé par l'ID utilisateur authentifié obtenu à partir du client Web. Si aucun ID utilisateur n'est spécifié, de quelque manière que ce soit, le système utilise l'ID utilisateur CICS par défaut.
  3. Cliquez ensuite sur l'icône Sauvegarder pour enregistrer les modifications.

Résultats

Le fichier de configuration Atom est mis à jour avec les modifications apportées à l'aide de l'éditeur.

Que faire ensuite

Pour ajouter des attributs n'apparaissant pas dans l'éditeur de configuration Atom, utilisez un éditeur XML ou un éditeur de texte. L'éditeur de configuration Atom est un outil de base pour débutants ; il ne prend donc pas en charge tous les attributs possibles pour un fichier de configuration Atom. Pour plus d'informations sur les attributs supplémentaires pouvant être ajoutés aux fichiers de configuration Atom, reportez-vous à la rubrique Création d'un fichier de configuration Atom. Une fois toutes les modifications nécessaires apportées, vous pouvez exporter le projet de regroupement sous forme de fichier .zip vers le système de fichiers local en vue de le déployer sur un système CICS, ou l'exporter directement sous z/OS UNIX. Pour plus d'informations, voir Déploiement d'un regroupement CICS ou les liens connexes suivants.