使用“配置”屏幕

Agent Builder 完成资源类型的创建后，如果您在“创建”屏幕上单击“下一步”，将显示如下图所示的“配置”屏幕。必须先创建资源类型才能访问“配置”屏幕。

图 9–3 Agent Builder 的“配置”屏幕

“配置”屏幕上包含以下字段：

• “启动命令”。可以传送到任意 UNIX shell 以启动基本应用程序的完整命令行。必须指定启动命令。您可以在提供的字段中键入该命令，也可以使用“浏览”找到包含用来启动应用程序的命令的文件。

  完整的命令行中必须包含启动应用程序所需的所有内容，例如主机名、端口号、配置文件的路径。您还可以指定使用属性变量中介绍的属性变量。如果基于 Korn shell 的应用程序要求您在命令行上指定主机名，则可以使用 Agent Builder 定义的 $hostnames 变量。请参见使用 Agent Builder 基于 Korn Shell 的 $hostnames 变量。

  请不要将命令置于双引号 (””) 之间。

  ---

  注 –

  如果基本应用程序具有多个独立的进程树（每一个进程树都在进程监视工具 (PMF) 控制下以其各自的标记来启动），则不能只指定一个命令。您必须创建包含多个单独命令（启动每个进程树）的文本文件，并在“启动命令”文本字段中指定此文件的路径。请参见Agent Builder 使用前须知。本节列出了此文件正确运行需要的一些特性。

  ---

• “停止命令”。可以传送到任意 UNIX shell 以停止基本应用程序的完整命令行。您可以在提供的字段中键入该命令，也可以使用“浏览”找到包含用来停止应用程序的命令的文件。您还可以指定使用属性变量中介绍的属性变量。如果基于 Korn shell 的应用程序要求您在命令行上指定主机名，则可以使用 Agent Builder 定义的 $hostnames 变量。请参见使用 Agent Builder 基于 Korn Shell 的 $hostnames 变量。

  此命令是可选的。如果不指定停止命令，则生成的代码将按以下步骤使用信号（包含在 Stop 方法中）来停止应用程序：

  • Stop 方法发送 SIGTERM 来停止应用程序，等待应用程序退出的时间长度为超时值的 80%。

  • 如果 SIGTERM 信号未成功，则 Stop 方法将发送 SIGKILL 来停止应用程序，等待应用程序退出的时间长度为超时值的 15%。

  • 如果 SIGKILL 不成功，则退出 Stop 方法（不成功）。余下的 5% 的超时值被认为是系统开销。

  ---

  注意 –

  请确保该停止命令在应用程序完全停止之后返回。

  ---

• “探测命令”。此命令是一个可定期运行的命令，用来检查应用程序的运行状况并返回介于 0（成功）和 100（完全失败）之间的退出状态值。此命令是可选的。您可以键入该命令的完整路径，也可以使用“浏览”找到包含用来探测应用程序的命令的文件。

  通常，您需指定基本应用程序的简单客户机。如果不指定探测命令，则生成的代码将只是连接至资源使用的端口或与其断开连接。如果这样的连接和断开连接成功，则生成的代码将声明应用程序运行状况良好。您还可以指定使用属性变量中介绍的属性变量。如果基于 Korn shell 的应用程序要求您在命令行上的探测命令中指定主机名，则可以使用 Agent Builder 定义的 $hostnames 变量。请参见使用 Agent Builder 基于 Korn Shell 的 $hostnames 变量。

  请不要将命令置于双引号 (””) 之间。

• “超时”。每个命令的超时值（以秒为单位）。可以指定新值，或者接受 Agent Builder 提供的默认值。启动命令和停止命令的默认值为 300 秒，探测命令的默认值为 30 秒。