Utilisation de l'écran Configurer

L'écran Configurer, représenté sur la capture suivante, apparaît une fois que Agent Builder a terminé de créer le type de ressource et que vous avez cliqué sur Suivant sur l'écran Créer. Vous ne pouvez pas accéder à l'écran Configurer avant d'avoir créé le type de ressources.

Figure 9–3 Écran Configurer de Agent Builder

L'écran Configurer contient les champs suivants :

• Commande de démarrage : ligne de commande complète qui peut être transmise à tout shell UNIX pour lancer l'application de base. Vous devez indiquer une commande de démarrage. Vous pouvez taper la commande dans le champ prévu à cet effet, ou utiliser Parcourir pour rechercher un fichier qui contienne la commande permettant de démarrer l'application.

  La ligne de commande complète doit inclure tous les éléments nécessaires pour lancer l'application, tels que les noms d'hôte, les numéros de port et un chemin d'accès aux fichiers de configuration. Vous pouvez également spécifier des variables de propriété, qui sont décrites dans Utilisation des variables de propriété. Si l'application korn shell requiert la définition d'un nom d'hôte dans la ligne de commande, vous pouvez utiliser la variable $hostnames définie par Agent Builder. Voir Utilisation de la variable $hostnames basée sur le korn shell de Agent Builder.

  Ne placez pas la commande entre guillemets (””).

  ---

  Remarque –

  si l'application de base comprend plusieurs arborescences de processus indépendantes et que chaque processus est exécuté à partir de sa propre balise sous la fonction PMF (Process Monitor Facility ), vous ne pouvez indiquer aucune commande. À la place, vous devez créer un fichier texte qui contienne les commandes individuelles permettant de lancer chaque arborescence de processus, puis spécifier le chemin d'accès à ce fichier dans le champ Commande de démarrage. Voir Avant d'utiliser Agent Builder. Cette section énumère certains caractères spéciaux dont ce fichier a besoin pour fonctionner correctement.

  ---

• Commande d'arrêt : ligne de commande complète qui peut être transmise à tout shell UNIX pour arrêter l'application de base. Vous pouvez saisir la commande dans le champ prévu à cet effet, ou utiliser la fonction Parcourir pour rechercher un fichier qui contienne la commande permettant d'arrêter l'application. Vous pouvez également spécifier des variables de propriété, qui sont décrites dans Utilisation des variables de propriété. Si l'application korn shell requiert la définition d'un nom d'hôte dans la ligne de commande, vous pouvez utiliser la variable $hostnames définie par Agent Builder. Voir Utilisation de la variable $hostnames basée sur le korn shell de Agent Builder.

  Cette commande est facultative. Si vous n'indiquez pas de commande d'arrêt, le code généré utilise les signaux (de la méthode Stop) pour arrêter l'application, comme suit :

  • La méthode Stop envoie le signal SIGTERM pour arrêter l'application et laisse s'écouler 80% du délai d'attente pour que l'application se ferme.

  • Si le signal SIGTERM échoue, la méthode Stop envoie le signal SIGKILL pour arrêter l'application et laisse s'écouler 15% du délai d'attente pour que l'application se ferme.

  • Si le signal SIGKILL ne fonctionne pas, la méthode Stop ne permet pas de quitter l'application. Les 5 % restants du délai d'attente sont considérés comme temps système.

  ---

  Attention –

  veillez à ce que la commande d'arrêt ne soit pas renvoyée avant l'arrêt complet de l'application.

  ---

• Commande d'analyse : Commande qui peut être exécutée périodiquement pour vérifier l'état de l'application et renvoyer un état de sortie compris entre 0 (réussite) et 100 (échec total). Cette commande est facultative. Vous pouvez saisir le chemin d'accès complet à la commande, ou utiliser l'option Parcourir pour rechercher un fichier qui contienne les commandes permettant de sonder l'application.

  En règle générale, vous indiquez un client unique de l'application de base. Si vous ne spécifiez aucune commande de sonde, le code généré se connecte et se déconnecte simplement du port utilisé par la ressource. Si la connexion et la déconnexion fonctionnent, le code généré signale que l'application fonctionne parfaitement. Vous pouvez également spécifier des variables de propriété, qui sont décrites dans Utilisation des variables de propriété. Si l'application korn shell requiert la définition d'un nom d'hôte dans la ligne de commande, vous pouvez utiliser la variable $hostnames définie par Agent Builder. Voir Utilisation de la variable $hostnames basée sur le korn shell de Agent Builder.

  Ne placez pas la commande entre guillemets (””).

• Délai d'attente : valeur de délai d'attente, en secondes, pour chaque commande. Vous pouvez spécifier une nouvelle valeur, ou accepter la valeur par défaut fournie par Agent Builder. La valeur par défaut est de 300 secondes pour le démarrage et l'arrêt et de 30 secondes pour la commande de la sonde.