wsadmin スクリプトを使用する AdminControl オブジェクトのコマンド
アプリケーション・サーバーのオブジェクトを管理する操作コマンドを呼び出す場合は、AdminControl オブジェクトを使用します。
多くの AdminControl コマンドには、複数のシグニチャーがあり、 Java Management Extensions (JMX) によって指定されるパラメーターを使用する、 またはパラメーターのストリングを使用することによって、raw モードで呼び出すことができます。 AdminControl オブジェクトは、操作コマンドに加え、トレース、サーバーとの再接続、 およびデータ型の変換のためのユーティリティー・コマンドをいくつかサポートしています。

- completeObjectName
- getAttribute
- getAttribute_jmx
- getAttributes
- getAttributes_jmx
- getCell
- getConfigId
- getDefaultDomain
- getDomainName
- getHost
- getMBeanCount
- getMBeanInfo_jmx
- getNode
- getObjectInstance
- getPort
- getPropertiesForDataSource (Deprecated)
- getType
- help
- invoke
- invoke_jmx
- isRegistered
- isRegistered_jmx
- makeObjectName
- queryMBeans
- queryNames
- queryNames_jmx
- reconnect
- setAttribute
- setAttribute_jmx
- setAttributes
- setAttributes_jmx
- startServer
- stopServer
- testConnection
- trace
completeObjectName
completeObjectName コマンドを使用して、フラグメントに基づく完全な ObjectName 値のストリング表記を作成します。 このコマンドは、一致する ObjectName 値を検出するためにサーバーと通信することはありません。このコマンドは、フラグメントと一致する MBean がシステムで複数検出された場合、最初の MBean を戻します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 入力するオブジェクトの名前を指定します。 (ObjectName)
- template
- 使用するテンプレートの名前を指定します。 テンプレート名として、例えば、type=Server,* と入力します。(java.lang.String)
オプション・パラメーター
なし。出力例
このコマンドは出力を返しません。
例
- Jacl を使用:
set serverON [$AdminControl completeObjectName node=mynode,type=Server,*]
- Jython の使用:
serverON = AdminControl.completeObjectName('node=mynode,type=Server,*')
getAttribute
getAttribute コマンドは、指定する名前の属性値を戻す場合に使用します。
- 0 - アプリケーションが開始中であることを示します
- 1 - アプリケーションが開始済みであることを示します
- 2 - アプリケーションが停止中であることを示します
- 3 - アプリケーションが停止済みであることを示します
- 4 - アプリケーションの開始が失敗したことを示します
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象の MBean のオブジェクト名を指定します。 (ObjectName)
- attribute
- 照会する属性の名前を指定します。 (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 コマンドは、指定する名前の属性値を戻す場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象の MBean のオブジェクト名を指定します。 (ObjectName)
- attribute
- 照会する属性の名前を指定します。 (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 コマンドは、指定する名前の属性値を戻す場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象の MBean のオブジェクト名を指定します。 (ObjectName)
- attribute
- 照会する属性の名前を指定します。 (java.lang.String[] or 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 コマンドは、指定する名前の属性値を戻す場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象の MBean のオブジェクト名を指定します。 (ObjectName)
- attribute
- 照会する属性の名前を指定します。 (java.lang.String[] or 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 フラグメントから構成 ID を作成する場合に使用します。 各 MBean に対応する構成オブジェクトはありません。 ObjectName フラグメントに対応する MBean が複数ある場合、 警告が出され、システムが検出した最初の MBean の構成 ID が形成されます。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象のオブジェクトの名前を指定します。 オブジェクト名のストリングは、アスタリスク文字 (*) で指定したワイルドカードであっても構いません。
オプション・パラメーター
なし。出力例
このコマンドは、対象の構成 ID を含むストリングを戻します。
例
- 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 の数を戻す場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
なし。オプション・パラメーター
なし。出力例
151
例
- Jacl を使用:
$AdminControl getMBeanCount
- Jython の使用:
print AdminControl.getMBeanCount()
getMBeanInfo_jmx
getMBeanInfo_jmx コマンドは、ObjectName 値に対応する Java Management Extension の MBeanInfo 構造を戻す場合に使用します。 このコマンド用のストリング・シグニチャーはありません。 これは、getMBeanInfo コマンドから使用可能な情報のほとんどを、Help オブジェクトが表示するためです。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象の MBean のオブジェクト名を指定します。 (ObjectName)
オプション・パラメーター
なし。出力例
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 コマンドは、入力オブジェクト名と一致するオブジェクト・インスタンスを戻す場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象のオブジェクトの名前を指定します。 (ObjectName)
オプション・パラメーター
なし。出力例
javax.management.modelmbean.RequiredModelMBean
例
- Jacl を使用:
getObjectInstance コマンドの戻り値を操作する場合は、 次の例を使用します。set server [$AdminControl completeObjectName type=Server,*] set serverOI [$AdminControl getObjectInstance $server]
puts [$serverOI getClassName]
- Jython の使用:
getObjectInstance コマンドの戻り値を操作する場合は、 次の例を使用します。server = AdminControl.completeObjectName('type=Server,*') serverOI = AdminControl.getObjectInstance(server)
print serverOI.getClassName()
getPort
getPort コマンドは、スクリプト接続で使用されるポートの名前を戻す場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
なし。オプション・パラメーター
なし。出力例
8877
例
- Jacl を使用:
$AdminControl getPort
- Jython の使用:
print AdminControl.getPort()
getPropertiesForDataSource (Deprecated)
getPropertiesForDataSource コマンドは非推奨となっていますが、これに置き換わるコマンドはありません。 このコマンドを使用すると、接続モードで稼働中に、構成サービスの可用性が誤って推定されます。
ターゲット・オブジェクト
なし。必須パラメーター
なし。オプション・パラメーター
なし。出力例
WASX7389E: サポートされていないオペレーション。
getPropertiesForDataSource コマンドはサポートされていません。
例
- 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
help コマンドは、AdminControl オブジェクトについての一般ヘルプ・テキストを戻す場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
なし。オプション・パラメーター
- コマンド
- コマンドを指定して、ヘルプ情報を戻します。 コマンド名には、大/小文字の区別はありません。
出力例
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
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
invoke コマンドは、 特定の MBean 操作を、その操作が必要とするパラメーターの数 に基づいて呼び出す場合に使用します。この制約では固有の操作を選択するのに十分でない場合は、 invoke_jmx を使用してください。操作が呼び出される前に、指定されたパラメーターは、選択された操作のシグニチャーが必要とする オブジェクト・タイプに変換されます。戻り値は、ストリング表記に 変換されます。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象の MBean のオブジェクト名を指定します。
- operation
- 呼び出すオペレーションを指定します。
オプション・パラメーター
- arguments
- オペレーションに必要な引数を指定します。
対象のオペレーションに引数が必要ない場合は、引数パラメーターを省いてもかまいません。
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"}
トラブルの回避 (Avoid trouble): 前述のコマンドを発行する前に、mbean 変数 $mbean が定義されている ことを確認してください。gotcha
- 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 コマンドは、パラメーター・リストをシグニチャーに適合させて、オブジェクト・オペレーションを呼び出す場合に使用します。 このコマンドは、呼び出しの結果を表示します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象の MBean のオブジェクト名を指定します。 (ObjectName)
- operation
- 呼び出すオペレーションを指定します。 (java.lang.String)
オプション・パラメーター
- arguments
- オペレーションに必要な引数を指定します。 対象のオペレーションに引数が必要ない場合は、引数パラメーターを省いてもかまいません。 (java.lang.String[] or 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 コマンドは、特定のオブジェクト名が登録済みであるかどうかを確認する場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象のオブジェクト名を指定します。 (java.lang.String)
オプション・パラメーター
なし。出力例
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 コマンドは、特定のオブジェクト名が登録済みであるかどうかを確認する場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象のオブジェクト名を指定します。 (java.lang.String)
オプション・パラメーター
なし。出力例
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 Management Extensions (JMX) ドメインで開始しない場合、 あるいはストリングの後にコロンが続く場合は、「WebSphere® Application Server」というストリングが名前の前に付加されます。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象のオブジェクト名を指定します。 (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 コマンドは、ユーザーの指定するオブジェクト名と一致するオブジェクト・インスタンスのリストを照会する場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象のオブジェクト名を指定します。 (ObjectName)
オプション・パラメーター
- query
- 照会式を指定します。 (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]
以下の例では、オブジェクト名および照会式を指定しています。
queryMBeans コマンドの戻り値を操作する場合は、 次の例を使用します。set apps [$AdminControl queryMBeans type=Application,* [java::null]]
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()
以下の例では、オブジェクト名および照会式を指定しています。
queryMBeans コマンドの戻り値を操作する場合は、 次の例を使用します。apps = AdminControl.queryMBeans('type=Application,*',None)
appArray = apps.toArray() app1 = appArray[0] print app1.getObjectName().toString()
queryNames
queryNames コマンドは、名前テンプレートに基づいて、各 ObjectName のリストを照会する場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象のオブジェクト名を指定します。 object name パラメーターには、アスタリスク文字 (*) でワイルドカードを指定することができます。 (java.lang.String)
オプション・パラメーター
なし。出力例
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
- 対象のオブジェクト名を指定します。 object name パラメーターには、アスタリスク文字 (*) でワイルドカードを指定することができます。 (ObjectName)
- query
- 使用する照会式を指定します。 (javax.management.QueryExp)
オプション・パラメーター
なし。出力例
[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
reconnect コマンドは、サーバーに再接続してローカル・キャッシュから情報をクリアする場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
なし。オプション・パラメーター
なし。出力例
WASX7074I: Reconnect of SOAP connector to host myhost completed.
例
- Jacl を使用:
$AdminControl reconnect
- Jython の使用:
print AdminControl.reconnect()
setAttribute
setAttribute コマンドは、ユーザーの指定する名前の属性値を設定する場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象の MBean のオブジェクト名を指定します。 (java.lang.String)
- attribute name
- 設定する属性の名前を指定します。 (java.lang.String)
- attribute value
- 対象の属性の値を指定します。(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 コマンドは、ユーザーの指定する名前の属性値を設定する場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象の MBean のオブジェクト名を指定します。 (ObjectName)
- attribute
- 設定する属性の名前を指定します。 (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 コマンドは、ユーザーの指定するオブジェクト名の属性値を設定する場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象の MBean のオブジェクト名を指定します。 (ストリング)
- attributes
- 設定する属性の名前を指定します。 (java.lang.String[] or 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 コマンドは、ユーザーの指定するオブジェクト名の属性値を設定する場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- object name
- 対象の MBean のオブジェクト名を指定します。 (ストリング)
- attributes
- 設定する属性の名前を指定します。 (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
- スクリプト・プロセスがノード・エージェント・サーバーに接続されている場合は、server name を指定してください。 オプションで wait time および node name パラメーターを指定することもできます。
- スクリプト・プロセスがデプロイメント・マネージャー・プロセスに接続されている場合は、server name と node name を指定してください。 オプションで wait time パラメーターを指定することもできます。
ターゲット・オブジェクト
なし。必須パラメーター
- サーバー名
- 始動するサーバーの名前を指定します。 (java.lang.String)
オプション・パラメーター
- node name
- 対象のノードの名前を指定します。 (java.lang.String)
- wait time
- サーバーが始動するまでに、始動プロセスが待機する時間 (秒数) を指定します。 待機時間のデフォルト値は 1200 秒です。(java.lang.String)
出力例
Server launched. 初期化状況を待ちます。 Server server1 open for e-business; process id is 1932.
例
- 以下の例では、始動するサーバーの名前のみを指定しています。
$AdminControl startServer server1
- 以下の例では、始動するサーバーの名前と待機時間を指定しています。
$AdminControl startServer server1 100
- 以下の例では、始動するサーバーの名前とノードの名前を指定しています。
$AdminControl startServer server1 myNode
- 以下の例では、サーバーの名前、ノードの名前、および待機時間を指定します。
$AdminControl startServer server1 myNode 100
- 以下の例では、始動するサーバーの名前のみを指定しています。
AdminControl.startServer('server1')
- 以下の例では、始動するサーバーの名前と待機時間を指定しています。
AdminControl.startServer('server1', 100)
- 以下の例では、始動するサーバーの名前とノードの名前を指定しています。
AdminControl.startServer('server1', 'myNode')
- 以下の例では、サーバーの名前、ノードの名前、および待機時間を指定します。
AdminControl.startServer('server1', 'myNode', 100)
stopServer
- サーバーを特定のノードで停止するには、server name および node name パラメーターを使用します。
- サーバーを即時停止するには、server name および immediate flag パラメーターを使用します。 このパラメーターを指定しない場合、システムはサーバーを正常に停止します。
- 特定の指定したノードのサーバーを停止するには、server name、node name、および immediate flag パラメーターを使用します。

ターゲット・オブジェクト
なし。必須パラメーター
- サーバー名
- 始動するサーバーの名前を指定します。 (java.lang.String)
オプション・パラメーター
- node name
- 対象のノードの名前を指定します。 (java.lang.String)
- immediate flag
- 値が immediate に設定されている場合は、サーバーの即時停止を指定します。 immediate flag を指定すると、サーバーは進行中の処理の終了や新規処理の受け入れを行わずに、サーバー・プロセスを終了します。(java.lang.String)
- terminate flag
- オペレーティング・システムがサーバー・プロセスを強制終了することを指定します。 (ストリング)
出力例
WASX7337I: Invoked stop for server "server1" Waiting for stop completion.
'WASX7264I: Stop completed for server "server1" on node "myNode"'
例
- 以下の例では、停止するサーバーの名前のみを指定しています。
$AdminControl stopServer server1
- 以下の例では、停止するサーバーの名前を指定し、サーバーを即時に停止することを指示しています。
$AdminControl stopServer server1 immediate
- 以下の例では、停止するサーバーの名前とノードの名前を指定しています。
$AdminControl stopServer server1 myNode
- 以下の例では、サーバーの名前とノードの名前を指定し、サーバーを即時に停止することを指示しています。
$AdminControl stopServer server1 myNode immediate
- 以下の例では、停止するサーバーの名前を指定し、サーバーを即時に停止することを指示しています。
AdminControl.stopServer('server1','immediate')
- 以下の例では、停止するサーバーの名前とノードの名前を指定しています。
AdminControl.stopServer('server1','myNode')
- 以下の例では、サーバーの名前とノードの名前を指定し、サーバーを即時に停止することを指示しています。
AdminControl.stopServer('server1','myNode','immediate')
testConnection
testConnection コマンドは、データ・ソース接続をテストする場合に使用します。 このコマンドは、構成リポジトリー内にあるデータ・ソースを処理します。 検査するデータ・ソースが、リポジトリーへの更新を保持する一時ワークスペース内にある場合、このコマンドを実行する前に、構成リポジトリーへの更新を保存する必要があります。 このコマンドは、データ・ソースおよび WAS40DataSource オブジェクト・タイプに対応する構成 ID と一緒に使用してください。
ターゲット・オブジェクト
なし。必須パラメーター
- configuration ID
- 対象のデータ・ソース・オブジェクトの構成 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
trace コマンドは、スクリプト・プロセスのトレース仕様を、ユーザーの指定する値に設定する場合に使用します。
ターゲット・オブジェクト
なし。必須パラメーター
- trace specification
- トレースがスクリプト・プロセスで使用可能になるように指定します。 (java.lang.String)
オプション・パラメーター
なし。出力例
このコマンドは出力を返しません。
例
- Jacl を使用:
$AdminControl trace com.ibm.ws.scripting.*=all=enabled
- Jython を使用:
print AdminControl.trace('com.ibm.ws.scripting.*=all=enabled')