Rational Developer for System z, Version 7.6

Intégration du menu à l'aide du gestionnaire de menus

La plupart des fonctions fournies par les commandes TSO doivent être intégrées dans l'acquis utilisateur pour Rational Developer for System z. Ce moyen est fourni le gestionnaire de menus. Ce dernier fournit un ensemble de panneaux dans lesquels vous pouvez définir les paires d'actions et de noms qui sont ajoutées à un menu déroulant accessible par un clic sur le bouton droit de la souris. Une fois les définitions établies, vous pouvez sélectionner un Nom (comme défini dans les préférences du gestionnaire de menus) et l'action (à laquelle il est associé) qui est effectuée. Ces préférences du gestionnaire de menus sont enregistrées dans un document XML qui peut être partagé ou centralisé (sur un hôte, par exemple) pour être importé par d'autres utilisateurs.

Guide d'initiation au gestionnaire de menus

Les éléments de menus sont configurés à l'aide de la page des préférences du gestionnaire de menus. Pour accéder à la page des préférences du gestionnaire de menus, sélectionnez Fenêtre -> Préférences -> Gestionnaire de menus. La page des préférences du gestionnaire de menus s'affiche.

Page des préférences

En règle générale, vous pouvez accepter les valeurs par défaut puis cliquer sur Actions et menus pour continuer.

La première fois que vous accédez au panneau Actions et menus, vous devez définir un nouveau fichier XML pour stocker les paramètres et les détails des actions que vous définissez. Ce fichier est créé à partir d'un nouveau fichier ou d'un fichier importé d'une autre source. Dans les deux cas, le fichier peut résider sur la machine locale, un serveur réseau ou le grand système dans des fichiers z/OS UNIX®. Si le fichier est marqué d'un astérisque sur la partie MVS du grand système, vous pouvez le télécharger dans le client Windows (avec RSE, par exemple) puis l'importer. Vous pouvez posséder plusieurs fichiers XML, mais un seul est actif à la fois.
Remarque : Si vous importez le fichier XML, que vous le modifiez puis importez une version mise à jour, vos modifications d'origine seront perdues.

Définition des interfaces utilisateur et de programmation

Pour créer une action, procédez comme suit :
  1. Cliquez sur le bouton Nouvelle action locale/distante.
  2. Sur la page Nouvelle action, indiquez un nom. Ce nom s'affichera dans le menu déroulant ; par conséquent, il doit être différent des autres actions déjà définies. Vous avez la possibilité d'ajouter un commentaire qui s'affichera dans la zone prévue à cet effet située dans la partie inférieure de l'écran lors de la sélection du nom dans le menu.
  3. Sélectionnez une action qui exécutera la commande que vous définissez.
    • com.ibm.ftt.ui.menumanager.tsoaction - Permet de créer un élément de menu qui sera associé à une commande TSO.
    • com.ibm.ftt.ui.menumanager.mfiaction - Permet de créer un élément de menu qui sera associé à une application Web HATS ou toute autre requête HTTP.
    • com.ibm.ftt.ui.menumanager.mfiaction - Permet de créer un élément de menu qui sera associé à une fenêtre de l'émulateur plein écran. Cette action ne devrait pas être obligatoire car l'accès à l'émulateur est intégré dans le projet z/OS et le menu RSE fait partie du produit Rational Developer for System z.

Définition d'une action de commande TSO

Le champ Commande est le champ le plus important de la fenêtre de la définition des caractéristiques de l'action. Il s'agit de la commande TSO qui est émise à l'appel de l'élément de menu. Vous pouvez utiliser des variables de substitution prédéfinies de forme $variable ou ${variable} comme partie intégrante de la commande. La valeur de la variable de substitution dépend de la sélection en cours. Tableau 1 présente une liste des variables reconnues. Le menu doit être associé à une ou plusieurs extensions de fichier. Vous pouvez définir des extensions de fichiers supplémentaires à l'aide du bouton Types de fichier.

Définition des caractéristiques d'une action de commande d'une application de client enrichi HATS

Pour définir une action qui appelle une application de client enrichi HATS spécifique, le format de la commande est déterminé par votre application de client enrichi HATS, à savoir si elle est conçue pour exécuter une seule ouverture de session ou non :
  • Si votre application n'effectue pas de connexion automatique, le format de la commande correspond uniquement à l'adresse URL de l'application HATS. Par exemple : HATSRCP=nomappnomapp correspond au nom de l'application de client enrichi HATS. Si l'application contient des paramètres, la commande peut être identique à la commande ci-dessous si vous devez indiquer des paramètres : HATSPCP=nomapp hatsgv_id-utilisateur hatsgv_mot-de-passe
  • Si votre application effectue une connexion automatique, Rational Developer for System z va remplacer vos ID utilisateur et mot de passe, à condition d'avoir indiqué le nom des variables pour l'ID utilisateur et le mot de passe qui doivent être ajoutés à la commande HATS. Pour HATS, les variables globales sont indiquées au format suivant dans la commande HATS : HATSPCP=nomapp hatsgv_id-utilisateur hatsgv_mot-de-passe
    En plus de l'ID utilisateur et du mot de passe, vous pouvez également spécifier d'autres paramètres à transmettre à HATS. Par exemple :
    HATSRCP=HCmvs211Parms hatsgv_id-utilisateur hatsgv_mot-de-passe hatsgv_var1=valeur1 hatsgv_var2=valeur2 hatsgv_var3=valeur3
    Dans l'exemple ci-dessus, l'application Web HATS est appelée et l'ID utilisateur et le mot de passe sont transmis. De plus, 3 paramètres supplémentaires (hatsgv_var1, hatsgv_var2 et hatsgv_var3), ainsi que leurs valeurs correspondantes, sont transmis. Plus de 3 paramètres peuvent être transmis.
  • Si votre application effectue une connexion automatique, Rational Developer for System z remplace vos ID utilisateur et mot de passe, à condition d'avoir indiqué le nom des variables pour l'ID utilisateur et le mot de passe qui doivent être ajoutés à la commande HATS. Pour HATS, les variables globales sont indiquées au format suivant dans la commande HATS :
    http://nom_hôte/nom_appli/?paramètre1=un
    hatsgv_id-utilisateur hatsgv_mot-de-passe 

    L'espace est obligatoire entre HATSRCP=nomapp et hatsgv_id-utilisateur et entre hatsgv_id-utilisateur et hatsgv_mot-de-passe. Les principes de substitution utilisés par Rational Developer for System z sont présentés dans Substitution de variable. Le nom des variables globales pour l'ID utilisateur et le mot de passe n'est pas primordial (excepté si HATS a besoin du préfixe hatsgv_ pour savoir qu'un paramètre spécifique est une variable globale). Par contre, il est important que hastgv_id-utilisateur soit interprété comme l'ID utilisateur et que hatsgv_mot-de-passe soit interprété comme le mot de passe.

    En plus de l'ID utilisateur et du mot de passe, vous pouvez également spécifier d'autres paramètres à transmettre à HATS. Par exemple :
    http://hostURL/myapp?tabs1=structures hatsgv_id-utilisateur hatsgv_mot-de-passe var1=valeur1 var2=valeur2 var3=valeur3
    Dans l'exemple ci-dessus, l'application Web HATS est appelée et l'ID utilisateur et le mot de passe sont transmis. De plus, 3 paramètres supplémentaires (hatsgv_var1, hatsgv_var2 et hatsgv_var3), ainsi que leurs valeurs correspondantes, sont transmis. Plus de 3 paramètres peuvent être transmis.
    L'URL résultante au moment de l'appel est la suivante :
    http://hostURL/myapp?tabs1=structures&hatsgv_userid=id-utilisateur&hatsgv_password=mot-de-passe&var1=valeur1&var2=valeur2&var3=valeur3
    En ce qui l'interface Web, l'URL spécifiée dans la commande peut elle-même contenir ou non les paramètres. La connexion hôte détecte automatiquement ce qu'il en est et s'adapte en conséquence. Par exemple, l'URL dépourvue de paramètre est la suivante :
    http://hostURL/myapp hatsgv_id-utilisateur hatsgv_mot-de-passe var1=valeur1 var2=valeur2 var3=valeur3
    L'URL contenant des paramètres est la suivante :
    http://hostURL/myapp?tabs1=structures&oneparm=good  hatsgv_id-utilisateur hatsgv_mot-de-passe var1=valeur1 var2=valeur2 var3=valeur3

Substitution de variable

Tableau 1 présente la liste des variables de substitution définies permettant de construire une commande.

Tableau 1. Substitution de variable
Variable Description
$adresse-client  
$id-utilisateur ID de l'utilisateur connecté au système associé à la ressource sélectionnée
$nom-hôte-système Nom d'hôte ou adresse IP du système associé à la ressource sélectionnée
$nom-système Nom de la connexion associée à la ressource sélectionnée (nom "court" du système)
$nom-fichier Nom du fichier contenant la ressource sélectionnée
$nom-hôte-système Nom d'hôte de l'adresse IP du système associé à la ressource sélectionnée
$nom-complet Nom qualifié complet de la ressource sélectionnée au format DATATSETNAME(MEMBERNAME)
$nom Nom de la ressource sélectionnée
$nom-projet Nom du projet associé à la ressource sélectionnée

Pour afficher l'élément de menu dans le menu contextuel, sélectionnez Afficher dans le menu générique lorsque vous définissez l'élément de menu.

Sélectionnez les types de fichier à associer à cette commande. Pour sélectionner l'ensemble des types, cliquez sur le bouton Sélectionner tout ; sinon, vous pouvez sélectionner des types de fichier individuels en cochant la case située en regard du type de fichier approprié. Vous pouvez ajouter un type de fichier à l'aide du bouton Types de fichier.

L'élément de menu doit être ajouté à un menu. Les menus sont définis, ainsi que les éléments de menu (actions) associés, dans la page Menus au niveau de la page des préférences des actions et des menus. Pour accéder à la page des préférences Actions et Menus, sélectionnez Fenêtre -> Préférences -> Gestionnaire de menus ->Actions et menus.

Une fois les éléments de menu ajoutés, le menu doit être sélectionné comme le fichier de base, le fichier par défaut ou les deux. Cette opération est effectuée à l'aide de la page de préférences de sélection de menu. Pour accéder à cette page, sélectionnez Fenêtre -> Préférences -> Gestionnaire de menus -> Sélection de menu

Les éléments de menu qui sont définis à l'aide de l'option Afficher dans le menu générique ou qui ont été ajoutés à un menu qui est actif dans la vue en cours vont s'afficher dans le menu contextuel. Cliquez à l'aide du bouton droit de la souris sur l'objet approprié dans la vue des projets z/OS pour afficher le menu contextuel.

Si un résultat existe, il s'affiche dans la console TPF Toolkit. Il est cohérent avec le résultat des actions locales.

Modification d'une définition d'action

Pour modifier une définition d'action, sélectionnez l'action souhaitée, cliquez avec le bouton droit de la souris puis sélectionnez Modifier.

Dans la fenêtre de modification des informations relatives à une action, vous pouvez modifier les propriétés associées à la commande, y compris les types de fichier associés.


Conditions d'utilisation | Commentaires

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