使用 wsadmin 脚本编制的管理命令交互方式环境
通过调用命令时在选项字符串中提供 -interactive 选项,可以交互方式运行管理命令。
即使在使用交互式选项时,您也仍然可以提供其他选项。指定的选项值将在命令数据显示前应用到命令。无论是否指定了其他选项,wsadmin 工具都将按步骤指导用户完成命令以收集命令信息。
- 为目标对象和参数收集用户输入
- 如果命令不包括步骤,将显示命令执行菜单以运行或取消该命令。
- 如果命令包含一个步骤,将显示选择该步骤的菜单。输入了所有必需的输入时,菜单将包括命令执行。
- 选择了某个步骤时,如果该步骤支持集合,将显示选择集合中对象的菜单,并且您可以退出该步骤。如果退出该步骤,请重复步骤 1-3。
- 为所选步骤或集合中的对象收集用户输入。
- 如果从集合步骤菜单操作,那么重复步骤 4 和 5
- 如果从步骤选择菜单操作,那么重复步骤 3-5
根据管理命令启用什么输入区域,您可以完成部分或所有交互式流顺序。如果以交互方式运行管理命令,将生成运行命令的语法(除了删除批处理方式中的集合对象),并且它将在交互式会话和 wsadmin 跟踪文件中记录为 WASX7278I 消息。
为目标对象和参数收集用户输入
以下交互式提示用于为“目标”对象和“参数”输入区域(特定于命令的帮助中显示的)收集输入:
Command title
Command Description
*target object title [current or default value]:
*param1 title (param1 name) [choice1, choice2, ...]: [current/default value]
param2 title (param2 name) [choice1, choice2, ...]: [current/default value]
...
显示命令执行菜单
如果管理命令不包含步骤,那么收集目标对象和参数的值后将向您显示以下菜单:
Command title
F (Finish)
C (Cancel)
Select [F, C]: F
“完成”选项运行命令,而“取消”选项取消命令。缺省选择是 F (Finish)。此菜单是为非步骤命令显示的最后一个菜单,以让它通过取消或运行命令退出交互方式。
显示命令步骤选择和执行菜单
如果管理命令包含步骤,那么收集目标对象和参数的值后将显示以下菜单:
Command title
Command description
-> *1. step1 title (step1 name)
2. step2 title (step2 name)
*3. step3 title (step3 name)
(4. step4 title (step4 name))
…
n. stepn title (stepn name)
S (Select)
N (Next)
P (Previous)
F (Finish)
C (Cancel)
H (Help)
Select [S, N, P, F, C, H]: S
菜单中显示的步骤数取决于管理命令。为信息显示步骤名,它是用于以批处理方式在此步骤中设置数据的名称。以下符号用来描述步骤:
- 步骤前的 “->” 表示当前的步骤位置。
- 步骤前的 “*” 指示必需步骤。
- 用 ( ) 括住了整个步骤表明该步骤是禁用的。您无法使用“下一步”或“上一步”选项浏览至此步骤。
使用菜单,您可以通过选择“上一步”或“下一步”来按顺序浏览所有步骤。“选择”选择当前步骤,“完成”运行命令,“取消”取消命令,而“帮助”提供命令的联机帮助。并非所有菜单选项都可用。如果当前步骤是第一步,那么“上一步”不可用。如果当前步骤是最后一步,那么“下一步”不可用。如果还有步骤缺少必需的输入,那么“完成”不可用。如果当前步骤是有效步骤且还有步骤缺少必需的输入,那么缺省选择是 S (Select)。如果对这些步骤提供了所有必需的输入,那么缺省选择是 F (Finish)。
对于具有步骤的命令,可以通过取消或运行命令来在此菜单上退出交互方式。
显示集合步骤菜单
步骤可能支持或不支持集合。集合指的是同一类型的对象。在管理命令中,集合包含具有相同参数集的对象。如果选择了支持集合的步骤,那么 wsadmin 工具将显示以下菜单以将对象添加到集合中,并选择该对象:
Step title (step name)
| key param1 title (key param1 name), key param2 title (key param2 name), ...
---------------------------------------------------------------------------
-> | object1 key param1 value, key param2 value, ...
*| object2 key param1 value, key param2 value, ...
...
key param1 title, key param2 title, ... must be provided to specify a row in batch row.
S (Select Row)
N (Next)
P (Previous)
A (Add Row or Add Row Before)
D (Delete Row)
F (Finish)
H (Help)
Select [S, N, P, A, D, F, H]: F
菜单中显示的对象数取决于命令步骤。关键字参数由步骤识别以用于唯一地识别集合中的一个对象。显示关键字参数值以识别要选择的对象。同命令步骤选择菜单相同,箭头 (->) 表示当前对象位置,星号 (*) 表示对象中缺少必填输入。
通过选择“上一步”或“下一步”以使用菜单按顺序浏览所有对象。“选择行”选择当前对象,“添加行”添加新的对象,“在前面添加行”将新对象添加到当前对象前,“删除行”删除当前对象,“完成”将控制返回到步骤选择和执行菜单,而“帮助”提供步骤的联机帮助。并非所有菜单选项都可用。如果集合中没有对象,或者当前对象是第一个对象,那么“上一步”不可用。如果集合中没有对象,或者当前对象是最后一个对象,那么“下一步”不可用。仅当存在当前对象时,“选择行”才可用。仅当集合中没有对象且步骤支持要添加的新对象时,才提供“添加行”。如果步骤支持要添加的新对象且集合中有现有对象,提供“在前面添加行”。仅当存在当前对象且步骤支持要删除的对象时,才提供“删除行”。如果还有对象缺少必需的输入,那么“完成”不可用。当集合中没有对象且步骤支持要添加的对象时,缺省选择是 A (Add Row)。如果存在当前对象且还有对象缺少必需的输入,那么缺省选择是 S (Select Row)。如果任何对象中都不缺少必需的输入,那么缺省选择是 F (Finish)。
为集合对象的参数收集用户输入
选择集合对象后,将按顺序提示每个参数的参数值,如以下示例所示:
*param1 title (param1 name) [choice1, choice2, ...]: [current/default value]
param2 title (param2 name) [choice1, choice2, ...]: [current/default value]
...
参数数取决于特定于命令步骤的帮助的“参数”区域中的参数数。星号 (*) 用来表示必需的参数。如果参数值限定为一组值,将显示有效选项。如果当前或缺省值可用,那么会显示它。对于每个可写参数,可以通过按 Enter 来接受现有值。要添加或更改现有值,请输入一个新的值,然后按 Enter。对于只读参数,将显示参数及其值。将不会提示您修改其值。在为所有这些参数都提供了值之后,wsadmin 工具会返回至集合步骤菜单。
为非集合步骤收集用户输入
此步骤有两个部分。第一部分为所选步骤显示当前或缺省参数值,如以下示例所示:
Step title (step name)
*param1 title (param1 name) [choice1, choice2, ...]: [current/default value]
param2 title (param2 name) [choice1, choice2, ...]: [current/default value]
...
Select [C (Cancel), E (Edit)]: [E]
此部分中不包括提示。相反,此部分更像是提供有关所选步骤的参数信息的帮助功能。参数的数目取决于特定于命令步骤的帮助的参数区域中的参数数。星号 (*) 符号表示必需的参数。如果参数值限定为一组值,将显示有效选项。如果当前或缺省值可用,那么会显示它。您可以选择取消步骤或继续下一部分以提供参数输入。缺省选择是编辑。因为您所看到的缺省值可能被指定给尚未在步骤中设置的一段新数据,所以可以接受缺省选择以继续下一部分。否则,如果所选步骤中不存在数据,那么选择“取消”将不会创建数据。
如果接受缺省值编辑选择,那么如“为集合对象的参数收集用户输入”一样为参数按顺序收集用户输入。
*param1 title (param1 name) [choice1, choice2, ...]: [current/default value]
param2 title (param2 name) [choice1, choice2, ...]: [current/default value]
...
对于每个可写参数,可以通过按 Enter 来接受现有值。要添加或更改现有值,请输入一个新的值,然后按 Enter。对于只读参数,将显示参数及其值。将不会对您提供修改参数值的提示。一旦按步骤执行完所有参数后,wsadmin 工具将带您回到命令步骤选择和执行菜单。