Verwenden des Bildschirms "Configure"

Der Bildschirm "Configure", in der folgenden Abbildung dargestellt, wird angezeigt, nachdem Agent Builder die Erstellung des Ressourcentyps beendet hat und Sie im Bildschirm "Create" auf "Next" klicken. Auf den Bildschirm "Configure" kann erst dann zugegriffen werden, wenn der Ressourcentyp erstellt worden ist.

Abbildung 9–3 Bildschirm "Configure" für Agent Builder

Der Bildschirm "Configure" enthält folgende Felder:

• Start Command. Die vollständige Befehlszeile, die an eine beliebige UNIX-Shell übergeben werden kann, um die Basisanwendung zu starten. Sie müssen einen Startbefehl angeben. Sie können den Befehl in das dafür vorgesehene Feld eingeben oder die Schaltfläche "Browse" verwenden, um die Datei zu suchen, die den Start-Befehl für die Anwendung enthält.

  Die vollständige Befehlszeile muss alle erforderlichen Parameter zum Starten der Anwendung enthalten, wie Hostnamen, Port-Nummern, einen Pfad zu den Konfigurationsdateien usw. Sie können auch Eigenschaftsvariablen angeben, die unter Verwenden von Eigenschaftsvariablen beschrieben werden. Wenn Ihre Korn-Shell-basierte Anwendung die Angabe eines Hostnamens in der Befehlszeile erfordert, können Sie die Variable $hostnames verwenden, die von Agent Builder definiert wird. Siehe Verwenden der Korn Shell-basierten $hostnames-Variable von Agent Builder.

  Der Befehl darf nicht in doppelten Anführungszeichen stehen (””).

  ---

  Hinweis –

  Wenn die Basisanwendung über mehrere unabhängige Prozessbaumstrukturen verfügt, von denen jede unter einer eigenen Markierung unter PMF-Steuerung (Process Monitor Facility) gestartet wird, kann kein einzelner Befehl angegeben werden. Stattdessen müssen Sie eine Textdatei erstellen, die einzelne Befehle zum Starten der einzelnen Prozessbäume enthält, sowie den Pfad dieser Datei im Textfeld "Start Command" angeben. Siehe Vor der Verwendung von Agent Builder. Dieser Abschnitt enthält eine Liste der besonderen Eigenschaften, die diese Datei für die ordnungsgemäße Ausführung benötigt.

  ---

• Stop Command. Die vollständige Befehlszeile, die an eine beliebige UNIX-Shell übergeben werden kann, um die Basisanwendung zu stoppen. Sie können den Befehl in das dafür vorgesehene Feld eingeben oder die Schaltfläche "Browse" verwenden, um die Datei zu suchen, die den Stopp-Befehl für die Anwendung enthält. Sie können auch Eigenschaftsvariablen angeben, die unter Verwenden von Eigenschaftsvariablen beschrieben werden. Wenn Ihre Korn-Shell-basierte Anwendung die Angabe eines Hostnamens in der Befehlszeile erfordert, können Sie die Variable $hostnames verwenden, die von Agent Builder definiert wird. Siehe Verwenden der Korn Shell-basierten $hostnames-Variable von Agent Builder.

  Dieser Befehl ist optional. Wenn Sie keinen Stopp-Befehl angeben, verwendet der generierte Code die folgenden Signale (in der Stopp-Methode), um die Anwendung zu stoppen.

  • Die Stop-Methode sendet SIGTERM , um die Anwendung zu stoppen, und wartet 80% des Zeitüberschreitungswertes darauf, dass die Anwendung beendet wird.

  • Wenn das SIGTERM-Signal nicht erfolgreich ist, sendet die Stop-Methode SIGKILL, um die Anwendung zu stoppen, und wartet während 15% des Zeitüberschreitungswertes darauf, dass die Anwendung beendet wird.

  • Wenn SIGKILL nicht erfolgreich ist, bricht die Stop-Methode ohne Erfolg ab. Die restlichen 5% des Zeitüberschreitungswertes gelten als Überlastung.

  ---

  Achtung –

  Stellen Sie sicher, dass der Stopp-Befehl keine Antwort zurückgibt, bevor die Anwendung vollständig gestoppt wurde.

  ---

• Probe Command. Ein Befehl, der in regelmäßigen Abständen ausgeführt werden kann, um die Anwendung auf Fehler zu überprüfen und einen entsprechenden Beendigungsstatus zwischen 0 (Erfolg) und 100 (Totalfehlschlag) zurückzugeben. Dieser Befehl ist optional. Sie können den gesamten Pfad zum Befehl eingeben oder mit der Schaltfläche "Browse" die Datei suchen, die den Befehl für das Testen der Anwendung enthält.

  In der Regel wird ein einfacher Client der Basisanwendung angegeben. Wenn Sie keinen Befehl zum Testen angeben, stellt der generierte Code einfach eine Verbindung zu dem Anschluss her, der von der Ressource verwendet wird, und hebt den Anschluss auch wieder auf. Wenn das Herstellen und das Auflösen der Verbindung erfolgreich sind, erklärt der generierte Code die Anwendung für "gesund". Sie können auch Eigenschaftsvariablen angeben, die unter Verwenden von Eigenschaftsvariablen beschrieben sind. Wenn Ihre Korn-Shell-basierte Anwendung die Angabe eines Hostnamens in der Probe-Befehlszeile erfordert, können Sie die Variable $hostnames verwenden, die von Agent Builder definiert wird. Siehe Verwenden der Korn Shell-basierten $hostnames-Variable von Agent Builder.

  Der Befehl darf nicht in doppelten Anführungszeichen stehen (””).

• Timeout. Ein Zeitüberschreitungswert, in Sekunden, für jeden Befehl. Sie können einen neuen Wert angeben oder den Standardwert übernehmen, der von Agent Builder vorgeschlagen wird. Der Standardwert lautet 300 Sekunden für das Starten und Stoppen und 30 Sekunden für das Testsignal.