wsadmin 스크립트를 사용한 AdminControl 오브젝트에 대한 명령
AdminControl 오브젝트를 사용하여 Application Server에 대한 오브젝트를 관리하는 조작 명령을 호출하십시오.
많은 AdminControl 명령은 JMX(Java Management Extensions)에 의해 지정된 매개변수를 사용하거나 매개변수에 대한 문자열을 사용하여 원시 모드에서 호출할 수 있도록 다중 서명을 가집니다. 조작 명령 외에도, AdminControl 오브젝트는 추적, 서버와 다시 연결 및 데이터 유형 변환을 위한 유틸리티 명령을 지원합니다.

- completeObjectName
- getAttribute
- getAttribute_jmx
- getAttributes
- getAttributes_jmx
- getCell
- getConfigId
- getDefaultDomain
- getDomainName
- getHost
- getMBeanCount
- getMBeanInfo_jmx
- getNode
- getObjectInstance
- getPort
- getPropertiesForDataSource(더 이상 사용되지 않음)
- getType
- 도움말
- invoke
- invoke_jmx
- isRegistered
- isRegistered_jmx
- makeObjectName
- queryMBeans
- queryNames
- queryNames_jmx
- reconnect
- setAttribute
- setAttribute_jmx
- setAttributes
- setAttributes_jmx
- startServer
- stopServer
- testConnection
- 추적
completeObjectName
completeObjectName 명령을 사용하여 단편을 기반으로 하는 전체 ObjectName 값의 문자열 표시를 작성하십시오. 이 명령은 일치하는 ObjectName 값을 찾기 위해 서버와 통신하지 않습니다. 시스템에서 단편과 일치하는 몇 가지 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[] 또는 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[] 또는 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 구조를 리턴하십시오. Help 브젝트가 getMBeanInfo_jmx 명령에서 사용 가능한 대부분의 정보를 표시하므로 이 명령에 대한 문자열 서명은 없습니다.
대상 오브젝트
없음.필수 매개변수
- 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(더 이상 사용되지 않음)
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 명령을 사용하여 AdminControl 오브젝트에 대한 일반 도움말 텍스트를 리턴하십시오.
대상 오브젝트
없음.필수 매개변수
없음.선택적 매개변수
- command
- 도움말 정보를 리턴할 명령을 지정합니다. 명령어는 대소문자를 구분하지 않습니다.
샘플 출력
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 배치 관리자, then all the MBeans running in the 배치 관리자
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
- 조작에 필요한 인수를 지정합니다. 원하는 조작에 인수가 필요하지 않은 경우 인수 매개변수를 생략할 수 있습니다.
인수 매개변수는 단일 문자열입니다. 문자열의 각 개별 인수는 공백을 포함할 수 있습니다.
샘플 출력
명령은 호출의 결과를 표시하는 문자열을 리턴합니다.
예제
- 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이 정의되었는지 확인하십시오. 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[] 또는 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 값의 결과는 존재할 수 없습니다. 제공한 문자열에 여분의 큰따옴표가 있는 경우 제거됩니다. 문자열이 JMX(Java Management Extensions) 도메인이나 콜론이 뒤따라 나오는 문자열로 시작하지 않으면, 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
- 원하는 오브젝트 이름을 지정합니다별표 문자(*)를 사용하여 오브젝트 이름 매개변수에 와일드 카드를 지정할 수 있습니다. (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
- 원하는 오브젝트 이름을 지정합니다별표 문자(*)를 사용하여 오브젝트 이름 매개변수에 와일드 카드를 지정할 수 있습니다. (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:
myhost 호스트에 대한 SOAP 커넥터의 재연결이 완료되었습니다.
예제
- Jacl 사용:
$AdminControl reconnect
- Jython 사용:
print AdminControl.reconnect()
setAttribute
setAttribute 명령을 사용하여 제공한 이름에 대한 속성 값을 표시하십시오.
대상 오브젝트
없음.필수 매개변수
- object name
- 원하는 MBean의 오브젝트 이름을 지정합니다. (java.lang.String)
- 속성 이름
- 설정할 속성의 이름을 지정합니다(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[] 또는 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
- 노드 에이전트 서버에 스크립트 프로세스가 첨부된 경우 서버 이름을 지정해야 합니다. 또한 선택적 wait time 및 node name 매개변수를 지정할 수도 있습니다.
- 배치 관리자에 스크립트 프로세스가 첨부된 경우 서버 이름 및 노드 이름을 지정해야 합니다. 또한 선택적 wait time 매개변수를 지정할 수도 있습니다.
대상 오브젝트
없음.필수 매개변수
- 서버 이름
- 시작할 서버의 이름을 지정합니다.(java.lang.String)
선택적 매개변수
- 노드 이름
- 원하는 노드 이름을 지정합니다. (java.lang.String)
- wait time
- 시작 프로세스가 서버가 시작될 때까지 기다리는 시간(초)을 지정합니다. 기본 대기 시간은 1200 초입니다.(java.lang.String)
샘플 출력
Server launched. Waiting for initialization status. 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)
선택적 매개변수
- 노드 이름
- 원하는 노드 이름을 지정합니다. (java.lang.String)
- 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 specification
- 스크립트 프로세스를 사용 가능하도록 추적을 지정합니다.(java.lang.String)
선택적 매개변수
없음.샘플 출력
명령은 출력을 리턴하지 않습니다.
예제
- Jacl 사용:
$AdminControl trace com.ibm.ws.scripting.*=all=enabled
- Jython 사용:
print AdminControl.trace('com.ibm.ws.scripting.*=all=enabled')