Rational Developer for System z


Création d'une nouvelle action de menu avec des valeurs de remplacement par défaut pour les paramètres identifiés

Cette leçon décrit comment utiliser le Gestionnaire de menu pour créer une nouvelle action de menu afin de fournir des valeurs pour les paramètres identifiés dans le JCL.

Créez de nouvelles actions et spécifiez des valeurs de remplacement par défaut pour les paramètres à l'aide du Gestionnaire de menu. Pour créer une nouvelle action et spécifier des valeurs de paramètre de remplacement, procédez comme suit :

  1. Cliquez sur Fenêtre > Préférences, développez la liste sous Gestionnaire de menu et cliquez sur Actions et menus.
  2. Cliquez sur Nouveau pour créer un nouveau fichier d'action. La fenêtre Nouveau fichier s'ouvre.
  3. Cliquez sur Fichier pour indiquer que les actions du nouveau fichier seront exécutées sur les fichiers. L'option Projet/Sous-projet vous permet de créer des actions qui seront exécutées sur les projets et sous-projets.
  4. Entrez le nom du chemin d'accès du nouveau fichier d'action ou cliquez sur Parcourir pour accéder à l'emplacement dans lequel vous souhaitez conserver le fichier d'action et spécifiez un nom de fichier. Les fichiers d'action sont stockés au format XML, spécifiez donc un nom de fichier avec une extension .xml, tel que c:\worklocation\myActions.xml (Windows) ou /root/worklocation/myActions.xml (Linux). Vous devez spécifier un chemin de répertoire existant.
  5. Cliquez sur Suivant. La page Créer un contenu de fichier s'ouvre.
  6. Cliquez sur Créer une nouvelle action locale/distante et cliquez sur Terminer. L'assistant Gestionnaire de menu - Nouvelle action s'ouvre.
  7. Entrez Définir le programme dans CICS dans le champ Nom et entrez éventuellement un commentaire décrivant la nouvelle action puis cliquez sur Suivant. Le nom que vous spécifiez est le nom qui apparaît dans le menu contextuel lorsque vous sélectionnez le programme ou le fichier et que vous cliquez du bouton droit pour exécuter l'action. La page Associations de fichiers s'ouvre.
  8. Sélectionnez un ou plusieurs types de fichier que vous souhaitez associer à cette action et cliquez sur Ajouter. Les types de fichier sont ajoutés dans la liste Types de fichier sélectionnés.
  9. Cliquez sur Suivant. La page Exécuter les options s'ouvre.
  10. Entrez la commande et les paramètres des actions, en les séparant par des virgules. Vous devez entrer la commande sur une ligne. Utilisez l'un des formats suivants selon que la boîte de dialogue requiert ou non une invite de substitution des paramètres par défaut. Si vous spécifiez PROMPT, une boîte de dialogue s'affiche et vous permet de remplacer certaines valeurs avant la soumission du langage JCL. Si vous avez spécifié toutes les valeurs nécessaires et que vous n'avez pas besoin d'invite, spécifiez NOPROMPT. Pour les tâches répétitives, dans lesquelles les tâches sont identiques ou fournies dans les variables, vous pouvez utiliser NOPROMPT. Pour les tâches dans lesquelles vous devez indiquer une valeur, utilisez de préférence PROMPT.
    • <Action>,<Program>,PROMPT,<Columns>,<Column headers="">,<Button text="">,<Title>,<Column Values="">
    • <Action>,<Program>,NOPROMPT,<Columns>,<Column Values=""></Column></Columns></Program></Action></Column></Title></Button></Column></Columns></Program></Action>
    La commande suivante invite les utilisateurs à saisir une valeur.
    Submit,ELISEE.TEST.JCL(PROGRDO),PROMPT,2,Variable,Value,Submit,Define program to CICS using batch RDO definition,PROGRAM,$name,USERID,$userid,GROUP,MYGROUP,LANGUAGE,COBOL
    La commande suivante n'envoie aucune invite de saisie de valeur aux utilisateurs :
    Submit,ELISEE.TEST.JCL(PROGRDO),NOPROMPT,2, PROGRAM,$name,USERID,$userid,GROUP,MYGROUP,LANGUAGE,COBOL
  11. Cliquez sur Afficher dans le menu générique.
  12. Cliquez sur Utiliser une action existante puis sur Sélectionner. La fenêtre Sélection de l'action s'ouvre.
  13. Développez com.ibm.etools.varsubstitution, sélectionnez com.ibm.ftt.ui.menumanager.mfivarsubsaction et cliquez sur OK.
  14. Pour enregistrer l'action, procédez comme suit :
    • Cliquez sur Terminer pour enregistrer l'action que vous avez créée.
    • Cliquez sur OK pour enregistrer l'action dans le fichier de menu.

Remarques à prendre en considération lors de la création d'actions

Les remarques suivantes s'appliquent lorsque vous spécifiez des valeurs de remplacement de paramètres :
  • Si vous ne spécifiez pas de valeur pour le paramètre PROGRAM, lorsque vous sélectionnerez la ressource, la ressource agissant en tant que langage JCL sera exécutée. Par exemple, vous aurez peut-être besoin de soumettre le langage JCL d'initialisation de CICS possédant certaines options sans modifier le JCL lui-même. Divers utilisateurs peuvent soumettre le même langage JCL mais avec des valeurs de paramètre différentes.
  • Si vous spécifiez une valeur pour le paramètre PROGRAM, le langage JCL s'exécutera à l'exécution de l'action. La ressource sélectionnée à l'aide d'un clic droit est alors associée au langage JCL à soumettre.
  • Si vous spécifiez un paramètre dans le langage JCL sans spécifier de valeur de remplacement, la valeur de paramètre sera remplacée par une chaîne vide. Considérons par exemple l'entrée suivante dans un langage JCL :
    MEMBER=!PROG!,PARM='1920'
    Si vous ne spécifiez pas de valeur de remplacement pour l'entrée !PROG!, l'entrée sera remplacée par :
    MEMBER=,PARM='1920'
Les valeurs de variables suivantes sont utiles. Pour voir toutes les valeurs de variables disponibles, cliquez sur Variables dans la page Exécuter les options de l'assistant Gestionnaire de menu - Nouvelle action.
$nom
Renvoie le nom de la ressource actuellement sélectionnée lorsque l'option de menu contextuel s'affiche. Elle renvoie le nom du membre.
$nom-complet
Renvoie le nom de la ressource actuellement sélectionnée lorsque l'option de menu contextuel s'affiche. Elle renvoie le nom du fichier et le nom du membre au format DATASET(MEMBER).
$nom-fichier
Renvoie le nom du fichier qui contient la ressource membre sélectionnée lorsque l'utilisateur clique du bouton droit de la souris dessus.

Conditions d'utilisation | Commentaires



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