Environnement du mode interactif de commande d'administration avec les scripts wsadmin
Une commande d'administration peut être exécutée en mode interactif en fournissant l'option interactive dans la chaîne d'options lors de l'appel de la commande.
Vous pouvez néanmoins fournir d'autres options, même lors de l'utilisation de l'option interactive. Les valeurs d'option spécifiées sont appliquées à la commande avant que les données de commande ne soient affichées. Que d'autres options soient ou non spécifiées, l'outil wsadmin dirige l'utilisateur vers la commande de façon à collecter les informations de commande.
- Collectez les entrées utilisateur pour les paramètres et l'objet cible.
- Si la commande n'inclut pas une étape, le menu d'exécution de commande s'affiche pour exécuter ou annuler la commande.
- Si la commande inclut une étape, le menu de sélection d'étape s'affiche. Lorsque toutes les entrées requises sont spécifiées, le menu inclut l'exécution de la commande.
- Lorsqu'une étape est sélectionnée, si celle-ci prend en charge la collection, le menu de sélection d'un objet dans la collection s'affiche et vous pouvez quitter l'étape. Si vous quittez l'étape, effectuez de nouveau les étapes 1-3.
- Collectez les entrées utilisateur pour l'étape sélectionnée ou pour un objet de la collection.
- Répétez les étapes 4 et 5 si vous utilisez le menu d'étapes de collection.
- Répétez les étapes 3 à 5 si vous utilisez le menu de sélection d'étapes.
En fonction de la zone d'entrée activée par une commande d'administration, vous pouvez parcourir une partie ou l'ensemble de la séquence de flux interactif. Si une commande d'administration est exécutée en mode interactif, la syntaxe d'exécution de la commande (à l'exception de la suppression de l'objet de collection en mode de traitement par lots) est générée et consignée sous forme de message WASX7278I dans la session interactive et dans le fichier de trace wsadmin.
Collectez les entrées utilisateur pour les paramètres et l'objet cible.
L'invite interactive suivante permet de collecter les entrées pour l'objet cible et les zones d'entrée d'arguments affichées dans l'aide spécifique aux commandes :
Titre de commande
Description de commande
*titre d'objet cible [valeur actuelle ou par défaut] :
*titre param1 (nom param1) [choix1, choix2, ...]: [valeur actuelle/par défaut]
*titre param2 (nom param2) [choix1, choix2, ...]: [valeur actuelle/par défaut]
...
Affichez le menu d'exécution des commandes.
Si une commande d'administration ne contient pas d'étape, le menu suivant s'affiche une fois que les valeurs ont été collectées pour les paramètres et l'objet cible :
Command title
F (Finish) [Terminer]
C (Cancel) [Annuler]
Sélectionnez [F, C] : F
L'option Finish exécute la commande et l'option Cancel annule la commande. La sélection par défaut est F (Finish). Ce menu est le dernier menu qui s'affiche pour qu'une commande sans étape quitte le mode interactif, soit en annulant, soit en exécutant la commande.
Affichez la sélection d'étape de commande et le menu d'exécution.
Si une commande d'administration contient une étape, le menu suivant s'affiche une fois que les valeurs ont été collectées pour les paramètres et l'objet cible :
Command title
Description de commande
-> *1. titre étape1 (nom étape1)
-> *2. titre étape2 (nom étape2)
*3. titre étape3 (nom étape3)
(4. titre étape4 (nom étape4))
…
n. titre étapen (nom étapen)
S (Select) [Sélectionner]
N (Next) [Suivant}
P (Previous) [Précédent]
F (Finish) [Terminer]
C (Cancel) [Annuler]
H (Help) {Aide]
Sélectionnez [S, N, P, F, C, H] : S
Le nombre d'étapes affichées dans le menu dépend de la commande d'administration. Le nom de l'étape apparaît pour information ; il s'agit du nom utilisé pour définir les données de cette étape en mode de traitement par lots. Les notations suivantes sont utilisées pour décrire une étape :
- A “->” before the step indicates the current step position.
- A “*” before the step indicates a required step.
- Les parenthèses ( ) qui encadrent toute l'étape indiquent qu'il s'agit d'une étape désactivée. Vous ne pouvez pas parcourir cette étape en utilisant les options Next (Suivant) ou Previous (Précédent).
A l'aide de ce menu, vous pouvez parcourir les étapes de façon séquentielle en sélectionnant Previous ou Next. Select permet de sélectionner l'étape en cours, Finish exécute la commande, Cancel annule la commande et Help affiche l'aide relative à la commande. Toutes les options de menu ne sont pas disponibles. Previous est indisponible si l'étape en cours est la première étape. Next est indisponible si l'étape en cours est la dernière étape. Finish est indisponible si des étapes requièrent encore des entrées. La sélection par défaut est S (Select) si l'étape en cours est une étape valide et que des étapes requièrent encore des entrées. La sélection par défaut est F (Finish) si toutes les entrées requises ont été spécifiées dans les différentes étapes.
Pour les commandes avec étapes, vous pouvez quitter le mode interactif de ce menu en annulant ou exécutant la commande.
Affichez le menu des étapes de collection.
Une étape peut prendre ou ne pas prendre en charge la collection. Une collection regroupe des objets de même type. Dans une commande d'administration, une collection contient des objets ayant le même jeu de paramètres. Si une étape qui prend en charge la collection est sélectionnée, l'outil wsadmin affiche le menu suivant pour ajouter et sélectionner un objet dans la collection :
Titre étape (nom étape)
| titre param1 clé (nom param1 clé), titre param2 clé (nom param2 clé), ...
---------------------------------------------------------------------------
-> | valeur param1 clé objet1, valeur param2 clé, ...
*| valeur param1 clé objet2, valeur param2 clé, ...
...
titre param1 clé, titre param2 clé, ... doit être fourni pour spécifier une ligne dans une ligne par lots.
S (Select Row) [Sélectionner ligne]
N (Next) [Suivant}
P (Previous) [Précédent]
A (Add Row or Add Row Before) [Ajouter ligne ou Ajouter ligne avant]
D (Delete Row) [Supprimer ligne]
F (Finish) [Terminer]
H (Help) {Aide]
Sélectionnez [S, N, P, A, D, F, H] : F
Le nombre d'objets affichés dans le menu dépend de l'étape de commande. Les paramètres clés sont identifiés par l'étape à utiliser pour identifier de façon unique un objet dans une collection. Les valeurs de paramètre clés s'affichent pour identifier un objet à sélectionner. Comme avec le menu de sélection d'étapes de commande, une flèche ((->) indique la position de l'objet en cours et un astérisque (*) indique qu'une entrée est manquante dans l'objet.
Utilisez le menu pour parcourir les objets de façon séquentielle en sélectionnant Previous ou Next. Select Row permet de sélectionner l'objet actuel, Add Row ajoute un nouvel objet, Add Row Before ajoute un nouvel objet avant l'objet actuel, Delete Row supprime l'objet actuel, Finish renvoie la commande à la sélection d'étapes et au menu d'exécution et Help affiche l'aide en ligne relative à l'étape. Toutes les options de menu ne sont pas disponibles. Previous est indisponible si la collection ne contient pas d'objet ou si le premier objet est l'objet actuel. Next est indisponible si la collection ne contient pas d'objet ou si le dernier objet est l'objet actuel. Select Row est uniquement disponible si un objet est présent (actuel). Add Row est uniquement disponible si la collection ne contient pas d'objet et que l'étape prend en charge le nouvel objet à ajouter. Add Row Before est disponible si l'étape prend en charge le nouvel objet à ajouter et que la collection contient déjà des objets. Delete Row est uniquement disponible s'il existe déjà un objet et que l'étape prend en charge un objet à supprimer. Finish est indisponible si des objets requièrent encore des entrées. La sélection par défaut est A (Add Row) si la collection ne contient pas d'objet et que l'étape prend en charge les objets à ajouter. La sélection par défaut est S (Select Row) s'il existe déjà un objet et que des objets requièrent encore des entrées. La sélection par défaut est F (Finish) si toutes les entrées requises ont été spécifiées dans les différents objets.
Collectez les entrées utilisateur pour les paramètres d'un objet de collection.
Une fois qu'un objet de collection a été sélectionné, la valeur de chaque paramètre est affichée de façon séquentielle, comme indiqué dans l'exemple suivant :
*titre param1 (nom param1) [choix1, choix2, ...]: [valeur actuelle/par défaut]
*titre param2 (nom param2) [choix1, choix2, ...]: [valeur actuelle/par défaut]
...
Le nombre de paramètres dépend du nombre d'arguments présents dans la zone d'arguments de l'aide spécifique à l'étape de commande. Le même astérisque (*) est utilisé pour signaler un paramètre requis. Si une valeur de paramètre est restreinte à un ensemble de valeurs, alors les choix valides s'affichent. Si la valeur actuelle ou par défaut est disponible, elle s'affiche. Pour chaque paramètre inscriptible, vous pouvez accepter la valeur existante en appuyant sur Entrée. Pour ajouter ou modifier une valeur existante, saisissez une nouvelle valeur puis appuyez sur Entrée. Pour un paramètre en lecture seule, le paramètre et sa valeur s'affichent. Aucun message ne vous invitera à modifier sa valeur. Une fois que vous avez parcouru tous les paramètres, l'outil wsadmin revient au menu d'étapes de collection.
Collectez les entrées utilisateur pour l'étape de non collection.
Cette étape comprend deux parties. La première affiche les valeurs de paramètre actuelles ou par défaut pour l'étape sélectionnée, comme indiqué dans l'exemple suivant :
Titre étape (nom étape)
*titre param1 (nom param1) [choix1, choix2, ...]: [valeur actuelle/par défaut]
*titre param2 (nom param2) [choix1, choix2, ...]: [valeur actuelle/par défaut]
...
Sélectionnez [C (Cancel), E (Edit)] : [E]
Aucune invite n'est incluse dans cette partie. Cette partie est davantage une fonction d'aide fournissant des informations de paramètres sur l'étape sélectionnée. Le nombre de paramètres dépend du nombre d'arguments présents dans la zone d'arguments de l'aide spécifique à l'étape de commande. L'astérisque (*) est utilisé pour signaler un paramètre requis. Si une valeur de paramètre est restreinte à un ensemble de valeurs, alors les choix valides s'affichent. Si la valeur actuelle ou par défaut est disponible, elle s'affiche. Vous pouvez choisir d'annuler l'étape ou de continuer par la partie suivante, afin de spécifier les paramètres. La sélection par défaut est Editer. Etant donné qu'il est possible d'avoir des valeurs par défaut assignées à de nouvelles données qui ne sont pas encore définies dans l'étape, vous pouvez accepter la sélection par défaut pour passer à la partie suivante. Sinon, si l'étape sélectionnée ne contient pas de données, le fait de choisir Cancel ne permet pas de créer des données.
Si vous accepter la sélection Edit par défaut, collectez les entrées utilisateur pour les paramètres de façon séquentielle comme vous les collectez pour les paramètres d'un objet de collection.
*param1 title (param1 name) [choice1, choice2, ...]: [current/default value]
*titre param2 (nom param2) [choix1, choix2, ...]: [valeur actuelle/par défaut]
...
Pour chaque paramètre inscriptible, vous pouvez accepter la valeur existante en appuyant sur Entrée. Pour ajouter ou modifier une valeur existante, saisissez une nouvelle valeur puis appuyez sur Entrée. Pour un paramètre en lecture seule, le paramètre et sa valeur s'affichent. Aucun message ne vous invitera à modifier la valeur du paramètre. Dès que vous avez parcouru tous les paramètres, l'outil wsadmin revient à la sélection des étapes de commande et au menu d'exécution.