使用 wsadmin 脚本编制的 AdminControl 对象的命令

使用 AdminControl 对象来调用可操作命令，这些命令用于管理应用程序服务器的对象。

许多 AdminControl 命令有多个特征符，以便它们可以按使用 Java 管理扩展 (JMX) 指定的参数或使用参数的字符串的 raw 方式调用。除可操作命令外，AdminControl 对象还支持一些用于跟踪、重新连接服务器和转换数据类型的实用程序命令。

避免麻烦: 在大型拓扑中使用 AdminControl 对象中提供的命令时，使用 process=dmgr 和 type = Cluster 进行查询和搜索。此搜索方法非常有效，耗时更短，并且不必搜索所有节点。

下列命令可用于 AdminControl 对象：

completeObjectName
getAttribute
getAttribute_jmx
getAttributes
getAttributes_jmx
getCell
getConfigId
getDefaultDomain
getDomainName
getHost
getMBeanCount
getMBeanInfo_jmx
getNode
getObjectInstance
getPort
getPropertiesForDataSource（不推荐使用）
getType
help
调用
invoke_jmx
isRegistered
isRegistered_jmx
makeObjectName
queryMBeans
queryNames
queryNames_jmx
重新连接
setAttribute
setAttribute_jmx
setAttributes
setAttributes_jmx
startServer
stopServer
testConnection
trace

completeObjectName

使用 completeObjectName 命令来创建基于片段的完整 ObjectName 值的字符串表示。此命令不通过与服务器进行通信来查找相匹配的 ObjectName 值。如果系统找到多个与此片段相匹配的 MBean，那么此命令将返回第一个 MBean。

目标对象

无。

必需参数

对象名: 指定要完成的对象的名称。 (ObjectName)
模板: 指定要使用的模板的名称。例如，模板可能是type=Server,*. (java.lang.String)

可选参数

无。

样本输出

此命令不会返回输出。

示例

使用 Jacl：

set serverON [$AdminControl completeObjectName node=mynode,type=Server,*]

使用 Jython：

serverON = AdminControl.completeObjectName('node=mynode,type=Server,*')

getAttribute

使用 getAttribute 命令来返回所提供名称的属性值。

如果使用 getAttribute 命令来确定应用程序的状态，那么将返回下列其中一个值：

0 - 指示应用程序正在启动
1 - 指示应用程序已启动
2 - 指定应用程序正在停止
3 - 指示应用程序已停止
4 - 指示应用程序未能启动

目标对象

无。

必需参数

对象名: 指定相关 MBean 的对象名。 (ObjectName)
指标: 指定要查询的属性的名称。 (java.lang.String)

可选参数

无。

样本输出

此命令将返回一个包含您查询的属性值的字符串，如以下示例所示：

'DeploymentManager'

示例

使用 Jacl：

set objNameString [$AdminControl completeObjectName WebSphere:type=Server,*] 
$AdminControl getAttribute $objNameString processType

使用 Jython：

objNameString = AdminControl.completeObjectName('WebSphere:type=Server,*') 
print AdminControl.getAttribute(objNameString, 'processType')

getAttribute_jmx

使用 getAttribute_jmx 命令来返回所提供名称的属性值。

目标对象

无。

必需参数

对象名: 指定相关 MBean 的对象名。 (ObjectName)
指标: 指定要查询的属性的名称。 (java.lang.String)

可选参数

无。

样本输出

此命令将返回一个包含您查询的属性值的字符串，如以下示例所示：

'DeploymentManager'

示例

使用 Jacl：

set objNameString [$AdminControl completeObjectName WebSphere:type=Server,*] 
set objName [java::new javax.management.ObjectName $objNameString]
$AdminControl getAttribute_jmx $objName processType

使用 Jython：

objNameString = AdminControl.completeObjectName('WebSphere:=type=Server,*') 
import  javax.management  as  mgmt 
objName =  mgmt.ObjectName(objNameString) 
print AdminControl.getAttribute_jmx(objName, 'processType')

getAttributes

使用 getAttributes 命令来返回您所提供的名称的属性值。

目标对象

无。

必需参数

对象名: 指定相关 MBean 的对象名。 (ObjectName)
指标: 指定要查询的属性的名称。（java.lang.String[] 或 java.lang.Object[]）

可选参数

无。

样本输出

此命令将返回一个包含您查询的属性值的字符串，如以下示例所示：

'[ [cellName myCell01] [nodeName myCellManager01] ]'

示例

使用 Jacl：

set objNameString [$AdminControl completeObjectName WebSphere:type=Server,*] 
$AdminControl getAttributes $objNameString "cellName nodeName"

使用带有字符串属性的 Jython：

objNameString = AdminControl.completeObjectname('WebSphere:type=Server,*)
print AdminControl.getAttributes(objNameString, '[cellName nodeName]')

使用带有对象属性的 Jython：

objNameString = AdminControl.completeObjectname('WebSphere:type=Server,*)
print AdminControl.getAttributes(objNameString, ['cellName', 'nodeName'])

getAttributes_jmx

使用 getAttributes_jmx 命令来返回您所提供的名称的属性值。

目标对象

无。

必需参数

对象名: 指定相关 MBean 的对象名。 (ObjectName)
指标: 指定要查询的属性的名称。（java.lang.String[] 或 java.lang.Object[]）

可选参数

无。

样本输出

此命令将返回属性列表。

示例

使用 Jacl：

set objectNameString [$AdminControl completeObjectName WebSphere:type=Server,*]
set objName [$AdminControl makeObjectName $objectNameString]
set attrs [java::new {String[]} 2 {cellName nodeName}] 
$AdminControl getAttributes_jmx $objName $attrs

使用 Jython：

objectNameString = AdminControl.completeObjectName('type=Server,*')
objName = AdminControl.makeObjectName(objectNameString)
attrs = ['cellName', 'nodeName']
print AdminControl.getAttributes_jmx(objName, attrs)

getCell

使用 getCell 命令来返回已收集的单元的名称。

目标对象

无。

必需参数

无。

可选参数

无。

样本输出

此命令将返回您查询的单元名，如以下示例所示：

Mycell

示例

使用 Jacl：
```
$AdminControl getCell
```
使用 Jython：
```
print AdminControl.getCell()
```

getConfigId

使用 getConfigId 命令从 ObjectName 或 ObjectName 片段创建配置标识。每个 MBean 都没有相应的配置对象。如果有多个 MBean 对应于一个 ObjectName 片段，那么将发出警告，并且将为系统找到的第一个 MBean 构建配置标识。

目标对象

无。

必需参数

对象名: 指定相关对象的名称。对象名字符串可以是一个用星号字符 (*) 指定的通配符。

可选参数

无。

样本输出

此命令将返回一个包含相关配置标识的字符串。

示例

使用 Jacl：

set threadpoolCID [$AdminControl getConfigId node=mynode,type=ThreadPool,*]

set serverConfigId [$AdminControl getConfigId node=SY1,type=Server,*]

使用 Jython：

threadpoolCID = AdminControl.getConfigId('node=mynode,type=ThreadPool,*')

serverConfigId = AdminControl.getConfigId('node=SY1,type=Server,*')

getDefaultDomain

使用 getDefaultDomain 命令实现从服务器中返回缺省域名。

目标对象

无。

必需参数

无。

可选参数

无。

样本输出

此命令将返回一个包含相关缺省域名的字符串，如以下示例所示：

WebSphere

示例

使用 Jacl：
```
$AdminControl getDefaultDomain 
```
使用 Jython：
```
print AdminControl.getDefaultDomain()
```

getDomainName

使用 getDomainName 命令实现从服务器中返回域名。

目标对象

无。

必需参数

无。

可选参数

无。

样本输出

此命令将返回一个包含相关域名的字符串，如以下示例所示：

WebSphere

示例

使用 Jacl：
```
$AdminControl getDomainName
```
使用 Jython：
```
print AdminControl.getDomainName()
```

getHost

使用 getHost 命令来返回您的主机名。

目标对象

无。

必需参数

无。

可选参数

无。

样本输出

此命令将返回一个包含相关主机名的字符串，如以下示例所示：

myHost

示例

使用 Jacl：
```
$AdminControl getHost
```
使用 Jython：
```
print AdminControl.getHost()
```

getMBeanCount

使用 getMBeanCount 命令来返回服务器中已注册的 Mbean 的数目。

目标对象

无。

必需参数

无。

可选参数

无。

样本输出

此命令将返回一个整数值，它包含已在服务器中注册的 MBean 数目，如以下示例所示：

示例

使用 Jacl：
```
$AdminControl getMBeanCount 
```
使用 Jython：
```
print AdminControl.getMBeanCount()
```

getMBeanInfo_jmx

使用 getMBeanInfo_jmx 命令来返回与 ObjectName 值相对应的 Java 管理扩展 MBeanInfo 结构。此命令没有字符串特征符，因为 Help 对象显示可从 getMBeanInfo_jmx 命令中获取的大多数信息。

目标对象

无。

必需参数

对象名: 指定相关 MBean 的对象名。 (ObjectName)

可选参数

无。

样本输出

此命令将返回 javax.management.MBeanInfo 对象，如以下示例所示：

javax.management.modelmbean.ModelMBeanInfoSupport@10dd5f35

示例

使用 Jacl：

set objectNameString [$AdminControl completeObjectName type=Server,*] 
set objName [$AdminControl makeObjectName $objectNameString]
$AdminControl getMBeanInfo_jmx $objName

使用 Jython：

objectNameString = AdminControl.completeObjectName('type=Server,*') 
objName = AdminControl.makeObjectName(objectNameString)
print AdminControl.getMBeanInfo_jmx(objName)

getNode

使用 getNode 命令来返回已连接节点的名称。

目标对象

无。

必需参数

无。

可选参数

无。

样本输出

此命令将返回一个包含节点的名称的字符串，如以下示例所示：

myNode01

示例

使用 Jacl：
```
$AdminControl getNode
```
使用 Jython：
```
print AdminControl.getNode()
```

getObjectInstance

使用 getObjectInstance 命令来返回与输入对象名相匹配的对象实例。

目标对象

无。

必需参数

对象名: 指定相关对象的名称。 (ObjectName)

可选参数

无。

样本输出

此命令将返回与输入对象名相匹配的对象实例，如以下示例所示：

javax.management.modelmbean.RequiredModelMBean

示例

使用 Jacl：

set server [$AdminControl completeObjectName type=Server,*]
set serverOI [$AdminControl getObjectInstance $server]

请使用以下示例来处理 getObjectInstance 命令的返回值：

puts [$serverOI getClassName]

使用 Jython：

server = AdminControl.completeObjectName('type=Server,*')
serverOI = AdminControl.getObjectInstance(server)

请使用以下示例来处理 getObjectInstance 命令的返回值：

print serverOI.getClassName()

getPort

使用 getPort 命令来返回用于脚本编制连接的端口的名称。

目标对象

无。

必需参数

无。

可选参数

无。

样本输出

此命令将返回系统用来建立脚本编制连接的端口的端口号，如以下示例所示：

示例

使用 Jacl：
```
$AdminControl getPort
```
使用 Jython：
```
print AdminControl.getPort()
```

getPropertiesForDataSource（不推荐使用）

不推荐使用 getPropertiesForDataSource 命令，目前还没有替代命令。当您在已连接方式下运行此命令时，它不正确地假设配置服务的可用性。

目标对象

无。

必需参数

无。

可选参数

无。

样本输出

此命令将返回以下消息：

WASX7389E: Operation not supported - getPropertiesForDataSource command is not supported.

示例

使用 Jacl：

set ds [lindex [$AdminConfig list DataSource] 0] 
$AdminControl getPropertiesForDataSource $ds

使用 Jython：

ds = AdminConfig.list('DataSource')

# get line separator 
import  java.lang.System  as  sys
lineSeparator = sys.getProperty('line.separator')

dsArray = ds.split(lineSeparator)
print AdminControl.getPropertiesForDataSource(dsArray[0])

getType

使用 getType 命令来返回用于脚本编制连接的连接类型。

目标对象

无。

必需参数

无。

可选参数

无。

样本输出

此命令将返回一个包含脚本编制连接的连接类型的字符串，如以下示例所示：

SOAP

示例

使用 Jacl：
```
$AdminControl getType
```
使用 Jython：
```
print AdminControl.getType()
```

帮助

使用 help 命令来返回 AdminControl 对象的一般帮助文本。

目标对象

无。

必需参数

无。

可选参数

命令: 指定要对其返回帮助信息的命令。命令名不区分大小写。

样本输出

此命令将返回一个详细说明了 help 命令的特定选项的字符串，如以下示例所示：

WASX7027I: The AdminControl object enables the manipulation of MBeans that run in a 
WebSphere Application Server process. The number and type of MBeans 
that are available to the scripting client depend on the server to which the client is connected.  
If the client is connected to a deployment manager, then all the MBeans running in the Deployment Manager 
are visible, as are all the MBeans running in the node agentsthat are connected to this deployment manager,
 and all the MBeans that run in the application servers on those nodes.

The following commands are supported by the AdminControl object; more detailed information about each of these 
commands is available by using the "help" command of the AdminControl object and supplying the name 
of the command as an argument.

Many of these commands support two different sets of signatures: one that accepts and returns strings, and one 
low-level set that works with JMX objects like ObjectName and AttributeList. In most situations, the string 
signatures are likely to be more useful, but JMX-object signature versions are supplied as well.  Each of these
JMX-object signature commands has "_jmx" appended to the command name, so an "invoke" command, as well as a 
"invoke_jmx" command are supported.

completeObjectName		Return a String version of an object name given atemplate name
getAttribute_jmx			Given ObjectName and name of attribute, returns value ofattribute
getAttribute    			Given String version of ObjectName and name of attribute, returns value of attribute
getAttributes_jmx			Given ObjectName and array of attribute names, returns AttributeList
getAttributes   			Given String version of ObjectName and attribute names, returns String of name value pairs
getCell         			returns the cell name of the connected server
getConfigId     			Given String version of ObjectName, return a config id for the corresponding configuration 
										object, if any.
getDefaultDomain			returns "WebSphere"
getDomainName   			returns "WebSphere"
getHost         			returns String representation of connected host
getMBeanCount   			returns number of registered beans
getMBeanInfo_jmx			Given ObjectName, returns MBeanInfo structure for MBean
getNode         			returns the node name of the connected server
getPort         			returns String representation of port in use
getType         			returns String representation of connection type in use help  help					Show help information
invoke_jmx      			Given ObjectName, name of command, array of parameters andsignature, invoke command on 
										MBean specified
invoke          			Invoke a command on the specified MBean
isRegistered_jmx			true if supplied ObjectName is registered
isRegistered    			true if supplied String version of ObjectName is registered
makeObjectName  			Return an ObjectName built with the given string
queryNames_jmx  			Given ObjectName and QueryExp, retrieves set of ObjectNames that match.
queryNames      			Given String version of ObjectName, retrieves String of ObjectNames that match.
reconnect       			reconnects with serversetAttribute_jmx Given ObjectName and Attribute object, 
										set attribute for MBean specified
setAttribute    			Given String version of ObjectName, attribute name andattribute value, set attribute for 
										MBean specified
setAttributes_jmx			Given ObjectName and AttributeList object, set attributes for the MBean specified
startServer     			Given the name of a server, start that server.
stopServer      			Given the name of a server, stop that server.
testConnection  			Test the connection to a DataSource object 
trace           			Set the wsadmin trace specification

如果您随 help 命令一起指定特定命令，那么 wsadmin 工具将返回有关此命令的详细信息，如以下示例所示：

WASX7043I: command: getAttribute
Arguments: object name, attribute
Description: Returns value of "attribute" for the MBean described by "object name."

示例

使用 Jacl：

$AdminControl help

$AdminControl help getAttribute

使用 Jython：

print AdminControl.help()

print AdminControl.help('getAttribute')

调用

使用 invoke 命令可以根据操作所需的参数数目来调用特定 MBean 操作。如果此约束不足以选择唯一的操作，请使用 invoke_jmx。在调用操作之前，提供的参数将转换为所选操作的特征符所需的对象类型。返回的任何值都将转换为相应的字符串表示。

目标对象

无。

必需参数

对象名: 指定相关 MBean 的对象名。
操作: 指定要调用的操作。

可选参数

自变量: 指定操作所需要的参数。如果相关操作不需要任何参数，那么可以省略 arguments 参数。
自变量参数是单一字符串。此字符串中的每个单独的参数可包含空格。

样本输出

此命令将返回一个显示调用结果的字符串。

示例

使用 Jacl：

set objNameString [$AdminControl completeObjectName WebSphere:type=Server,*] 
$AdminControl invoke $objNameString stop

set objNameString [$AdminControl completeObjectName WebSphere:type=DynaCache,*] 
$AdminControl invoke $mbean getCacheStatistics {"DiskCacheSizeInMB ObjectsReadFromDisk4000K
 RemoteObjectMisses"}

避免麻烦: 在发出上述命令之前，请确保定义了 mbean 变量 $mbean

使用 Jython：

objNameString = AdminControl.completeObjectName('WebSphere:type=Server,*') 
print AdminControl.invoke(objNameString, 'stop')

objNameString = AdminControl.completeObjectName("WebSpheretype=DynaCache,*") 
	AdminControl.invoke(dc, "getCacheStatistics", '["DiskCacheSizeInMB ObjectReadFromDisk4000K
 RemoteObjectMisses"]')

使用 Jython 列表：

objNameString = AdminControl.completeObjectName("WebSphere:type=DynaCache,*") 
AdminControl.invoke(dc, "getCacheStatistics", [["DiskCacheSizeInMB", "ObjectReadFromDisk4000K", 
"RemoteObjectMisses"]])

invoke_jmx

使用 invoke_jmx 命令并通过使参数列表符合特征符来调用对象操作。此命令将返回调用结果。

目标对象

无。

必需参数

对象名: 指定相关 MBean 的对象名。 (ObjectName)
操作: 指定要调用的操作。 (java.lang.String)

可选参数

自变量: 指定操作所需要的参数。如果相关操作不需要任何参数，那么可以省略 arguments 参数。（java.lang.String[] 或 java.lang.Object[]）

样本输出

此命令将返回一个显示调用结果的字符串。

示例

使用 Jacl：

set objNameString [$AdminControl completeObjectName WebSphere:type=TraceService,*] 
set objName [java::new javax.management.ObjectName $objNameString] 
set parms [java::new {java.lang.Object[]} 1 com.ibm.ejs.sm.*=all=disabled] 
set signature [java::new {java.lang.String[]} 1 java.lang.String] 
$AdminControl invoke_jmx $objName $parms $signature

使用 Jython：

objNameString = AdminControl.completeObjectName('WebSphere:type=TraceService,*') 
import  javax.management  as  mgmt 
objName =  mgmt.ObjectName(objNameString) 
parms = ['com.ibm.ejs.sm.*=all=disabled'] 
signature = ['java.lang.String'] 
print AdminControl.invoke_jmx(objName, parms, signature)

isRegistered

使用 isRegistered 命令来确定是否已注册特定对象名。

目标对象

无。

必需参数

对象名: 指定相关对象名。 (java.lang.String)

可选参数

无。

样本输出

此命令将返回相关对象的布尔值。如果在服务器中注册了 ObjectName 值，那么该值为1，如以下示例所示:

wsadmin>s = AdminControl.queryNames( 'type=Server,*' ).splitlines()[ 0 ]
wsadmin>AdminControl.isRegistered( s )
1
wsadmin>

如果未在服务器中注册 ObjectName 值，那么该值为0.

示例

使用 Jacl：

set objNameString [$AdminControl completeObjectName WebSphere:type=Server,*] 
$AdminControl isRegistered $objNameString

使用 Jython：

objNameString = AdminControl.completeObjectName('WebSphere:type=Server,*') 
print AdminControl.isRegistered(objNameString)

isRegistered_jmx

使用 isRegistered_jmx 命令来确定是否已注册特定对象名。

目标对象

无。

必需参数

对象名: 指定相关对象名。 (java.lang.String)

可选参数

无。

样本输出

此命令将返回相关对象的布尔值。如果在服务器中注册了 ObjectName 值，那么该值为true，如以下示例所示:

true

示例

使用 Jacl：

set objectNameString [$AdminControl completeObjectName type=Server,*]
set objName [$AdminControl makeObjectName $objNameString]
$AdminControl isRegistered_jmx $objName

使用 Jython：

objectNameString = AdminControl.completeObjectName('type=Server,*')
objName = AdminControl.makeObjectName(objectNameString)
print AdminControl.isRegistered_jmx(objName)

makeObjectName

使用 makeObjectName 命令并根据字符串输入来创建 ObjectName 值。此命令不与服务器通信，因此可能不存在产生的 ObjectName 值。如果您提供的字符串包含一组多余的双引号，那么移除它们。如果该字符串未以 Java 管理扩展 (JMX) 域或后跟冒号的字符串开头，那么 WebSphere® Application Server 字符串将追加到名称中。

目标对象

无。

必需参数

对象名: 指定相关对象名。 (java.lang.String)

可选参数

无。

样本输出

此命令将返回根据对象名字符串构造的 Objectname 对象。

示例

使用 Jacl：

set objectNameString [$AdminControl completeObjectName type=Server,node=mynode,*]
set objName [$AdminControl makeObjectName $objNameString]

使用 Jython：

objectNameString = AdminControl.completeObjectName('type=Server,node=mynode,*')
objName = AdminControl.makeObjectName(objectNameString)

queryMBeans

使用 queryMBeans 命令来查询与您提供的对象名相匹配的对象实例的列表。

目标对象

无。

必需参数

对象名: 指定相关对象名。 (ObjectName)

可选参数

查询: 指定查询表达式。 (QueryExp)

样本输出

此命令将返回所指定的对象名的对象实例的列表，如以下示例所示：

WebSphere:name=PlantsByWebSphere,process=server1,platform=dynamicproxy,node=Goodog,
J2EEName=PlantsByWebSphere,Server=server1,version=6.1.0.0,type=Application,
mbeanIdentifier=cells/GooddogNode02Cell/applications/PlantsByWebSphere.ear/
deployments/PlantsByWebSphere/deployment.xml#ApplicationDeployment_1126623343902,
cell=GooddogNode02Cell

示例

使用 Jacl：

set apps [$AdminControl queryMBeans type=Application,*]

请使用以下示例来处理 queryMBeans 命令的返回值：

set appArray [$apps toArray]
set app1 [java::cast javax.management.ObjectInstance [$appArray get 0]]
puts [[$app1 getObjectName] toString]

以下示例指定对象名和查询表达式：

set apps [$AdminControl queryMBeans type=Application,* [java::null]]

请使用以下示例来处理 queryMBeans 命令的返回值：

set appArray [$apps toArray]
set app1 [java::cast javax.management.ObjectInstance [$appArray get 0]]
puts [[$app1 getObjectName] toString]

使用 Jython：

apps = AdminControl.queryMBeans('type=Application,*')

请使用以下示例来处理 queryMBeans 命令的返回值：

appArray = apps.toArray()
app1 = appArray[0]
print app1.getObjectName().toString()

以下示例指定对象名和查询表达式：

apps = AdminControl.queryMBeans('type=Application,*',None)

请使用以下示例来处理 queryMBeans 命令的返回值：

appArray = apps.toArray()
app1 = appArray[0]
print app1.getObjectName().toString()

queryNames

使用 queryNames 命令并根据名称模板来查询每个 ObjectName 对象的列表。

目标对象

无。

必需参数

对象名: 指定相关对象名。可以使用星号字符 (*) 为对象名参数指定通配符。 (java.lang.String)

可选参数

无。

样本输出

此命令将返回一个包含与输入对象名相匹配的 ObjectNames 的字符串，如以下示例所示：

WebSphere:cell=BaseApplicationServerCell,
name=server1,mbeanIdentifier=server1,
type=Server,node=mynode,process=server1

示例

使用 Jacl：

$AdminControl queryNames WebSphere:type=Server,*

使用 Jython：

print AdminControl.queryNames('WebSphere:type=Server,*')

queryNames_jmx

使用 queryNames_jmx 命令并根据名称模板和您指定的查询条件来查询每个 ObjectName 对象的列表。

目标对象

无。

必需参数

对象名: 指定相关对象名。可以对 object name 参数指定带有星号字符 (*) 的通配符。 (ObjectName)
查询: 指定要使用的查询表达式。 (javax.management.QueryExp)

可选参数

无。

样本输出

此命令将返回一个包含与输入对象名相匹配的 ObjectNames 的字符串，如以下示例所示：

[WebSphere:cell=BaseApplicationServerCell,name=server1,mbeanIdentifier=
server1,type=Server,node=mynode,process=server1]

示例

使用 Jacl：

set objectNameString [$AdminControl completeObjectName type=Server,*]
set objName [$AdminControl makeObjectName $objNameString]
set null [java::null]
$AdminControl queryNames_jmx $objName $null

使用 Jython：

objectNameString = AdminControl.completeObjectName('type=Server,*')
objName = AdminControl.makeObjectName(objectNameString)
print AdminControl.queryNames_jmx(objName, None)

重新连接

使用 reconnect 命令来重新连接至服务器，并将信息从本地高速缓存中清除。

目标对象

无。

必需参数

无。

可选参数

无。

样本输出

此命令将返回一条显示操作状态的消息，如以下示例所示：

WASX7074I: Reconnect of SOAP connector to host myhost completed.

示例

使用 Jacl：
```
$AdminControl reconnect 
```
使用 Jython：
```
print AdminControl.reconnect()
```

setAttribute

使用 setAttribute 命令来设置所提供名称的属性值。

目标对象

无。

必需参数

对象名: 指定相关 MBean 的对象名。 (java.lang.String)
属性名称: 指定要设置的属性的名称。 (java.lang.String)
属性值: 指定相关属性的值。 (java.lang.String)

可选参数

无。

样本输出

此命令不会返回输出。

示例

使用 Jacl：

set objNameString [$AdminControl completeObjectName WebSphere:type=TraceService,*] 
$AdminControl setAttribute $objNameString traceSpecification com.ibm.*=all=disabled

使用 Jython：

objNameString = AdminControl.completeObjectName('WebSphere:type=TraceService,*') 
print AdminControl.setAttribute(objNameString, 'traceSpecification',  'com.ibm.*=all=disabled')

setAttribute_jmx

使用 setAttribute_jmx 命令来设置所提供名称的属性值。

目标对象

无。

必需参数

对象名: 指定相关 MBean 的对象名。 (ObjectName)
指标: 指定要设置的属性的名称。 (Attribute)

可选参数

无。

样本输出

此命令不会返回输出。

示例

使用 Jacl：

set objectNameString [$AdminControl completeObjectName WebSphere:type=TraceService,*] 
set objName [$AdminControl makeObjectName $objectNameString]
set attr [java::new javax.management.Attribute traceSpecification com.ibm.*=all=disabled] 
$AdminControl setAttribute_jmx $objName $attr

使用 Jython：

objectNameString = AdminControl.completeObjectName('WebSphere:type=TraceService,*')
import  javax.management  as  mgmt
objName = AdminControl.makeObjectName(objectNameString)
attr = mgmt.Attribute('traceSpecification', 'com.ibm.*=all=disabled')
print AdminControl.setAttribute_jmx(objName, attr)

setAttributes

使用 setAttributes 命令来设置您提供的对象名的属性值。

目标对象

无。

必需参数

对象名: 指定相关 MBean 的对象名。 (字符串)
属性: 指定要设置的属性的名称。（java.lang.String[] 或 java.lang.Object[]）

可选参数

无。

样本输出

此命令将返回通过调用命令而成功设置的对象名的列表，如以下示例所示：

'[traceSpecification com.ibm.ws.*=all=enabled]'

示例

使用 Jacl：

set objNameString [$AdminControl completeObjectName WebSphere:type=TraceService,*] 
$AdminControl setAttributes $objNameString {{traceSpecification com.ibm.ws.*=all=enabled}}

使用带有字符串属性的 Jython：

objNameString = AdminControl.completeObjectName('WebSphere:type=TraceService,*') 
AdminControl.setAttributes(objNameString, '[[traceSpecification "com.ibm.ws.*=all=enabled"]]')

使用带有对象属性的 Jython：

objNameString = AdminControl.completeObjectName('WebSphere:type=TraceService,*') 
print AdminControl.setAttributes(objNameString, [['traceSpecification', 'com.ibm.ws.*=all=enabled']])

setAttributes_jmx

使用 setAttributes_jmx 命令来设置您提供的对象名的属性值。

目标对象

无。

必需参数

对象名: 指定相关 MBean 的对象名。 (字符串)
属性: 指定要设置的属性的名称。 (javax.management.AttributeList)

可选参数

无。

样本输出

此命令将返回通过调用命令而成功设置的对象名的属性列表，如以下示例所示：

'[traceSpecification com.ibm.ws.*=all=enabled]'

示例

使用 Jacl：

set objectNameString [$AdminControl completeObjectName WebSphere:type=TraceService,*] 
set objName [$AdminControl makeObjectName $objectNameString] 
set attr [java::new javax.management.Attribute traceSpecification com.ibm.ws.*=all=enabled] 
set alist [java::new javax.management.AttributeList] 
$alist add $attr 
$AdminControl setAttributes_jmx $objName $alist

使用 Jython：

objectNameString = AdminControl.completeObjectName('WebSphere:type=TraceService,*')
import  javax.management  as  mgmt 
objName = AdminControl.makeObjectName(objectNameString) 
attr = mgmt.Attribute('traceSpecification', 'com.ibm.ws.*=all=enabled') 
alist = mgmt.AttributeList() 
alist.add(attr)
print AdminControl.setAttributes_jmx(objName, alist)

startServer

通过在配置中找到指定的应用程序服务器并使用 startServer 命令来启动该应用程序服务器。此命令使用缺省等待时间。按照下列准则来确定要使用哪些参数：

如果脚本编制进程与节点代理程序服务器相连，那么必须指定服务器名称。还可以指定 wait time 和 node name 这两个可选参数。
如果脚本编制进程与 Deployment Manager 进程相连，那么必须指定服务器名称和节点名。还可以指定 wait time 这一可选参数。

目标对象

无。

必需参数

服务器名称: 指定要启动的服务器的名称。 (java.lang.String)

可选参数

节点名: 指定相关节点的名称。 (java.lang.String)
等待时间: 指定启动进程等待服务器启动所花的秒数。缺省等待时间为 1200 秒。 (java.lang.String)

样本输出

Server launched. Waiting for initialization status. Server server1 open for e-business; process id is 1932.

示例

使用 Jacl：

以下示例仅指定要启动的服务器的名称：
```
$AdminControl startServer server1
```
以下示例指定要启动的服务器的名称以及等待时间：
```
$AdminControl startServer server1 100
```
以下示例指定要启动的服务器的名称以及节点的名称：
```
$AdminControl startServer server1 myNode
```
以下示例指定服务器的名称、节点的名称以及等待时间：
```
$AdminControl startServer server1 myNode 100
```

使用 Jython：

以下示例仅指定要启动的服务器的名称：
```
AdminControl.startServer('server1')
```
以下示例指定要启动的服务器的名称以及等待时间：
```
AdminControl.startServer('server1', 100)
```
以下示例指定要启动的服务器的名称以及节点的名称：
```
AdminControl.startServer('server1', 'myNode')
```
以下示例指定服务器的名称、节点的名称以及等待时间：
```
AdminControl.startServer('server1', 'myNode', 100)
```

stopServer

使用 stopServer 命令来停止指定的应用程序服务器。在不带 immediate flag 或 terminate flag 的情况下运行 stopServer 命令时，服务器将完成正在执行的任何工作，但是一旦服务器开始执行停止进程，它就不再接受任何新工作。使用以下选项来确定要使用的参数:

使用服务器名称和节点名参数来停止特定节点中的服务器。
使用 server name 和 immediate flag 参数来立即停止服务器。如果未指定此参数，那么系统将正常停止服务器。
使用 server name、node name 和 immediate flag 参数来立即停止特定节点中的服务器。

避免麻烦: 如果尝试停止服务器时仅指定服务器名称，那么将发出错误消息。

目标对象

无。

必需参数

服务器名称: 指定要启动的服务器的名称。 (java.lang.String)

可选参数

节点名: 指定相关节点的名称。 (java.lang.String)
immediate flag: 指定在值设置为immediate。如果指定立即标志，那么服务器不会完成处理正在进行的任何工作，不接受任何新工作，并结束服务器进程。 (java.lang.String)
terminate flag: 指定操作系统是否应终止服务器进程。 (字符串)

样本输出

此命令将返回一条消息以指示是否成功停止了服务器，如以下示例所示：

WASX7337I: Invoked stop for server "server1" Waiting for stop completion.
'WASX7264I: Stop completed for server "server1" on node "myNode"'

示例

使用 Jacl：

以下示例仅指定要停止的服务器的名称：
```
$AdminControl stopServer server1
```
以下示例指定要停止的服务器的名称并指示应立即停止服务器：
```
$AdminControl stopServer server1 immediate
```
以下示例指定要停止的服务器的名称以及节点的名称：
```
$AdminControl stopServer server1 myNode
```
以下示例指定服务器的名称、节点的名称并指示应立即停止服务器：
```
$AdminControl stopServer server1 myNode immediate
```

使用 Jython：

以下示例指定要停止的服务器的名称并指示应立即停止服务器：
```
AdminControl.stopServer('server1','immediate')
```
以下示例指定要停止的服务器的名称以及节点的名称：
```
AdminControl.stopServer('server1','myNode')
```
以下示例指定服务器的名称、节点的名称并指示应立即停止服务器：
```
AdminControl.stopServer('server1','myNode','immediate')
```

testConnection

使用 testConnection 命令来测试数据源连接。此命令将处理存放在配置库中的数据源。如果要测试的数据源在用于存放存储库更新的临时工作空间中，那么必须保存配置库更新之后才运行此命令。将与数据源和 WAS40DataSource 对象类型相对应的配置标识和此命令一起使用。

目标对象

无。

必需参数

configuration ID: 指定相关数据源对象的配置标识。 (java.lang.String)

可选参数

无。

样本输出

此命令将返回一条消息，以指示成功建立了连接或者虽然建立了连接但是发出了警告。如果连接失败，从服务器创建指出发生的错误的异常。例如：

WASX7217I: Connection to provided datasource was successful.

示例

使用 Jacl：

set ds [lindex [$AdminConfig list DataSource] 0] 
$AdminControl testConnection $ds

使用 Jython：

# get line separator 
import java.lang.System as sys
lineSeparator = sys.getProperty('line.separator')
ds = AdminConfig.list('DataSource').split(lineSeparator)[0]
print AdminControl.testConnection(ds)

跟踪

使用 trace 命令将脚本编制进程的跟踪规范设置为您指定的值。

目标对象

无。

必需参数

跟踪规范: 指定要对脚本编制进程启用的跟踪。 (java.lang.String)

可选参数

无。

样本输出

此命令不会返回输出。

示例

使用 Jacl：

$AdminControl trace com.ibm.ws.scripting.*=all=enabled

使用 Jython：

print AdminControl.trace('com.ibm.ws.scripting.*=all=enabled')