wsadmin 스크립트를 사용한 AdminControl 오브젝트에 대한 명령

AdminControl 오브젝트를 사용하여 Application Server에 대한 오브젝트를 관리하는 조작 명령을 호출하십시오.

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

문제점 방지 문제점 방지: 큰 토폴로지의 AdminControl 오브젝트에서 사용 가능한 명령을 사용할 때 process=dmgr 및 type=Cluster를 사용하여 조회하고 검색하십시오. 이 검색 방법은 좀 더 효율적이며 시간 소모가 적으며 노드 전체 검색을 피할 수 있습니다. gotcha

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 명령을 사용하여 제공한 이름에 대한 속성 값을 리턴하십시오.

애플리케이션의 상태를 판별하기 위해 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 사용:
    [AIX Solaris HP-UX Linux Windows]
    set threadpoolCID [$AdminControl getConfigId node=mynode,type=ThreadPool,*]  
    [z/OS]
    set serverConfigId [$AdminControl getConfigId node=SY1,type=Server,*]
  • Jython 사용:
    [AIX Solaris HP-UX Linux Windows]
    threadpoolCID = AdminControl.getConfigId('node=mynode,type=ThreadPool,*')
    [z/OS]
    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의 수를 리턴하십시오.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

없음.

샘플 출력

명령은 서버에 등록된 MBeans 수가 포함된 정수 값을 다음 예제와 같이 리턴합니다.
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.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 명령을 사용하여 입력 오브젝트 이름과 일치하는 오브젝트 인스턴스를 리턴하십시오.

대상 오브젝트

없음.

필수 매개변수

object name
원하는 오브젝트의 이름을 지정합니다. (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 명령을 사용하여 스크립트 연결에 사용되는 포트의 이름을 리턴하십시오.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

없음.

샘플 출력

명령은 시스템에서 스크립트 연결을 설정하는 데 사용하는 포트의 포트 번호를 다음 예제와 같이 리턴합니다.
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
도움말 정보를 리턴할 명령을 지정합니다. 명령어는 대소문자를 구분하지 않습니다.

샘플 출력

명령은 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 배치 관리자, 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
도움말 명령을 사용하여 특정 명령을 지정하는 경우 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

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)

선택적 매개변수

없음.

샘플 출력

명령은 원하는 오브젝트에 대한 부울 값을 리턴합니다. 서버에 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 명령을 사용하여 특정 오브젝트 이름을 등록할 것인지 여부를 판별합니다.

대상 오브젝트

없음.

필수 매개변수

object name
원하는 오브젝트 이름을 지정합니다(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 값의 결과는 존재할 수 없습니다. 제공한 문자열에 여분의 큰따옴표가 있는 경우 제거됩니다. 문자열이 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]
    다음 예제는 오브젝트 이름 및 조회 표현식을 지정합니다.
    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 오브젝트 목록을 조회하십시오.

대상 오브젝트

없음.

필수 매개변수

object name
원하는 오브젝트 이름을 지정합니다별표 문자(*)를 사용하여 오브젝트 이름 매개변수에 와일드 카드를 지정할 수 있습니다. (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)
query
사용할 조회 표현식을 지정합니다(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

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

startServer 명령을 사용하여 지정된 Application Server를 구성에서 찾아서 시작하십시오. 이 명령은 기본 대기 시간을 사용합니다. 다음 지침을 사용하여 사용할 매개변수를 판별하십시오.
  • 노드 에이전트 서버에 스크립트 프로세스가 첨부된 경우 서버 이름을 지정해야 합니다. 또한 선택적 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.

예제

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 명령을 사용하여 지정된 Application Server를 중지하십시오. stopServer 명령이 즉시 또는 종료 플래그 없이 실행되면 서버가 진행 중인 모든 작업을 종료하며 중지 프로세스가 시작되면 네트워크를 사용할 수 없습니다. 다음 옵션을 사용하여 사용할 매개변수를 판별하십시오.
  • server name 및 node name 매개변수를 사용하여 특정 노드의 서버를 중지하십시오.
  • server name 및 immediate flag 매개변수를 사용하여 서버를 즉시 중지하십시오. 이 매개변수가 지정되지 않는 경우, 시스템은 서버를 정상적으로 중지시킵니다.
  • server name, node name 및 immediate flag 매개변수를 사용하여 특정 노드의 서버를 즉시 중지하십시오.
문제점 방지 문제점 방지: 해당 서버를 중지하는 경우 서버 이름만 지정하면 오류 메시지가 발행됩니다. gotcha

대상 오브젝트

없음.

필수 매개변수

서버 이름
시작할 서버의 이름을 지정합니다.(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"'

예제

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 오브젝트 유형에 대응하는 구성 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')

주제 유형을 표시하는 아이콘 참조 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_admincontrol
파일 이름:rxml_admincontrol.html