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.
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.
En règle générale, vous pouvez accepter les valeurs par défaut puis cliquer sur Actions et menus pour continuer.
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.
HATSRCP=HCmvs211Parms hatsgv_id-utilisateur hatsgv_mot-de-passe hatsgv_var1=valeur1 hatsgv_var2=valeur2 hatsgv_var3=valeur3Dans 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.
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.
http://hostURL/myapp?tabs1=structures hatsgv_id-utilisateur hatsgv_mot-de-passe var1=valeur1 var2=valeur2 var3=valeur3Dans 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.
http://hostURL/myapp?tabs1=structures&hatsgv_userid=id-utilisateur&hatsgv_password=mot-de-passe&var1=valeur1&var2=valeur2&var3=valeur3En 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=valeur3L'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
Tableau 1 présente la liste des variables de substitution définies permettant de construire une commande.
| 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.
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.