Vous pouvez ajouter des variables de saisie utilisateur à une action personnalisée exécutant une commande TSO. Une variable de saisie utilisateur invite les utilisateurs à spécifier ou à sélectionner une valeur de paramètre pour une commande TSO suite à la sélection d'une action personnalisée dans le menu contextuel.
Pourquoi et quand exécuter cette tâche
Pour ajouter des variables de saisie utilisateur à une commande TSO, procédez comme suit :
Procédure
- Dans l'assistant Gestionnaire de menu - Nouvelle action, cliquez sur le bouton Variables. La fenêtre Variables de substitution s'ouvre. Cette fenêtre contient deux options que vous pouvez utiliser pour créer une variable de saisie utilisateur utilisable dans une commande TSO :
- $input
- Recueille les données saisies par l'utilisateur qui a appelé l'action personnalisée. Lorsque vous ajoutez cette variable à une action personnalisée, l'action provoque l'affichage d'une boîte de dialogue invitant l'utilisateur à spécifier une information ou à sélectionner une information dans une liste déroulante.
- $list
- Permet d'inclure une liste de valeurs dans laquelle l'utilisateur peut choisir une valeur.
- Sélectionnez $input dans la fenêtre Variables de substitution et cliquez sur Insérer.
- Pour inclure une liste de valeurs possibles pouvant être choisies par l'utilisateur, sélectionnez $list dans la fenêtre Variables de substitution et cliquez sur Insérer. Cette variable est facultative. Elle permet de construire une liste déroulante contenant les valeurs possibles pouvant être saisies pour l'action.
- Pour utiliser cette variable dans une action personnalisée, vous devez la définir comme suit :
$input(PromptString, DefaultValue, $list{string1,string2,string3, . . .,stringn})
- PromptString
- Indiquez l'intitulé de la boîte de dialogue invitant l'utilisateur à saisir des informations.
Cette chaîne d'invite peut contenir des espaces mais pas de virgules (,) ni de symboles de dollar ($). La chaîne d'invite est obligatoire.
- DefaultValue
- Indiquez la valeur à utiliser par défaut si l'utilisateur ne saisit rien lorsqu'il y est invité. La valeur par défaut peut contenir des espaces mais pas de virgules (,) ni de symboles de dollar ($). La valeur par défaut est obligatoire.
- $list{string1,string2,string3, . . .,stringn
- Spécifiez une liste de chaînes dans laquelle l'utilisateur peut choisir une valeur.
Cette variable est facultative. Si vous l'incluez, la boîte de dialogue vous invite à sélectionner l'une de ces chaînes dans une liste déroulante. Si vous omettez cette variable, la boîte de dialogue invite l'utilisateur à saisir une valeur. Chacune des valeurs de la liste peut contenir des espaces mais pas de virgules (,) ni de symboles de dollar ($).
Résultats
Les exemples ci-dessous montrent les invites qui s'ouvrent lorsque vous créez des éléments de menu utilisant des variables de saisie utilisateur. Les exemples illustrent une boîte de dialogue contenant une zone de saisie et une autre contenant une liste déroulante.
Exemple
L'exemple ci-dessous affiche une boîte de dialogue contenant une liste déroulante intitulée
Paramètre, dans laquelle l'utilisateur peut choisir entre
SMSINFO et
DIRECTORY. La valeur par défaut est
SMSINFO.FEKFLDSI '$datasetname' $input(Paramètre,SMSINFO,$list{SMSINFO,DIRECTORY})
L'exemple ci-dessous affiche une boîte de dialogue contenant une zone de saisie intitulée Paramètre, dans laquelle l'utilisateur peut saisir des données. La valeur par défaut de la zone de texte est SMSINFO.
FEKFLDSI '$datasetname' $input(Paramètre,SMSINFO)
L'exemple suivant affiche une boîte de dialogue contenant une liste déroulante intitulée Nom du fichier, dans laquelle l'utilisateur peut choisir entre le nom HLQ.MON.FICHIER et le nom du fichier actuellement sélectionné. La valeur par défaut est le nom du fichier actuellement sélectionné.
FEKFLDSI '$input(Nom du fichier, $datasetname, $list{HLQ.MON.FICHIER,$datasetname})'