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

AdminConfig 오브젝트를 사용하여 구성 명령을 호출하고 WebSphere® Application Server 구성의 요소를 작성하거나 변경합니다(예: 데이터 소스 작성).

로컬 조작만 사용하려는 경우 서버를 실행하지 않고 스크립트 클라이언트를 시작할 수 있습니다. 로컬 모드로 실행하려면 -conntype NONE 옵션을 사용하여 스크립트 클라이언트를 시작하십시오. 로컬 모드에서 실행 중임을 나타내는 메시지를 수신합니다. 서버가 실행 중인 경우 로컬 모드에서 AdminConfig 도구를 실행하지 마십시오. 로컬 모드에서 작성된 구성 변경사항은 실행 중인 서버 구성에 반영되지 않습니다. 충돌하는 구성을 저장하면 구성이 손상될 수 있습니다.

배치 관리자 환경에서 구성 업데이트는 스크립트 클라이언트가 배치 관리자에 연결되어 있는 경우에만 사용 가능합니다.

노드 에이전트 또는 관리 애플리케이션 서버에 연결되면, 이러한 서버 프로세스의 구성이 배치 관리자에 있는 마스터 구성의 사본이므로 구성을 업데이트할 수 없습니다. 사본은 배치 관리자와 노드 에이전트 사이에 구성 동기화가 발생할 때 노드 시스템에서 작성됩니다. 배치 관리자에 스크립트 클라이언트를 연결하여 서버 프로세스에 대한 구성 변경을 작성하십시오. 따락서 구성을 변경하려는 경우, 노드 시스템의 로컬 모드에서 스크립트 클라이언트를 실행하지 마십시오. 지원되는 구성이 아닙니다.

지원된 구성 지원된 구성: Jython 목록 또는 문자열 구문을 사용하여 매개변수를 wsadmin 명령으로 전달할 수 있습니다. 하지만 쉼표가 문자로 포함된 매개변수가 있는 경우에는, Jython 문자열 구문을 사용하여 매개변수를 전달해야 합니다.
예를 들어 작성 명령을 사용하기 위해 다음과 유사한 명령을 입력할 수 있습니다.
params='[[name name1] [nameInNameSpace nameSpace_Name] [string_to_bind "value, withComma"]]' 
AdminConfig.create(type, parent, params)
또한 수정 명령을 사용할 수도 있습니다.
AdminConfig.modify(type, params)
sptcfg

attributes

attributes 명령을 사용하여 제공된 유형의 최상위 레벨 속성 목록을 리턴하십시오.

대상 오브젝트

없음.

필수 매개변수

object type
XML 구성 파일을 기반으로 하는 오브젝트 유형의 이름을 지정합니다. 오브젝트 유형은 관리 콘솔이 표시하는 이름과 같을 필요가 없습니다.

선택적 매개변수

없음.

샘플 출력

"properties Property*" "serverSecurity ServerSecurity" 
"server Server@" "id Long" "stateManagement StateManageable" 
"name String" "moduleVisibility EEnumLiteral(MODULE, 
COMPATIBILITY, SERVER, APPLICATION)" "services Service*" 
"statisticsProvider StatisticsProvider" 

  • Jacl 사용:
    $AdminConfig attributes ApplicationServer
  • Jython 사용:
    print AdminConfig.attributes('ApplicationServer')

checkin

checkin 명령을 사용하여 문서 URI(Uniform Resource Identifier)로 설명된 구성 저장소에서 파일을 선택합니다. 이 메소드는 배치 관리자 구성에만 적용됩니다.

대상 오브젝트

없음.

필수 매개변수

URI
문서 URI는 구성 저장소의 루트와 관련됩니다. 예를 들어, 다음과 같습니다.
  • [AIX Solaris HP-UX Linux Windows]app_server_root\config
  • [IBM i]/WebSphere/AppServer/config
  • [z/OS]\WebSphere\AppServer\config
file name
체크인할 소스 파일의 이름을 지정합니다.
opaque object
이전 호출로 AdminConfig 오브젝트의 extract 명령이 리턴하는 오브젝트를 지정합니다.

선택적 매개변수

없음.

샘플 출력

"properties Property*" "serverSecurity ServerSecurity" 
"server Server@" "id Long" "stateManagement StateManageable" 
"name String" "moduleVisibility EEnumLiteral(MODULE, 
COMPATIBILITY, SERVER, APPLICATION)" "services Service*" 
"statisticsProvider StatisticsProvider" 

  • Jacl 사용:
    [AIX][HP-UX][IBM i][Linux][Solaris]
    $AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml /mydir/myfile $obj
    [Windows]
    $AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml c:\\mydir\myfile $obj
    [z/OS]
    $AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml \mydir\myfile $obj
  • Jython 사용:
    [AIX][HP-UX][IBM i][Linux][Solaris]
    print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', '/mydir/myfile',  obj)
    [Windows]
    print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', 'c:\mydir\myfile',  obj)
    [z/OS]
    print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', '\mydir\myfile',  obj)

convertToCluster

convertToCluster 명령을 사용하여 새 서버 클러스터의 첫 번째 멤버가 되도록 서버를 변환하십시오.

대상 오브젝트

없음.

필수 매개변수

server ID
주요 서버의 구성 ID
cluster name
원하는 클러스터의 이름을 지정합니다.

선택적 매개변수

없음.

샘플 출력

myCluster(cells/mycell/clusters/myCluster|cluster.xml#ClusterMember_2)

  • Jacl 사용:
    set serverid [$AdminConfig getid /Server:myServer/]
    $AdminConfig convertToCluster $serverid myCluster
  • Jython 사용:
    serverid = AdminConfig.getid('/Server:myServer/')
    print AdminConfig.convertToCluster(serverid, 'myCluster')

작성

create 명령을 사용하여 구성 오브젝트를 작성하십시오.

대상 오브젝트

없음.

필수 매개변수

유형
XML 구성 파일을 기반으로 하는 오브젝트 유형의 이름을 지정합니다. 이 매개변수는 관리 콘솔이 표시하는 이름과 같을 필요가 없습니다.
parent ID
상위 오브젝트의 구성 ID를 지정합니다.
attributes
구성 ID에 추가할 속성을 지정합니다.

선택적 매개변수

없음.

샘플 출력

이 명령은 이 샘플 출력에 표시된 것처럼 구성 오브젝트 이름의 문자열을 리턴합니다.
ds1(cells/mycell/nodes/DefaultNode/servers/server1|resources.xml#DataSource_6)

  • Jacl 사용:
    set jdbc1 [$AdminConfig getid /JDBCProvider:jdbc1/]
    $AdminConfig create DataSource $jdbc1 {{name ds1}}
  • Jython 문자열 속성 사용:
    jdbc1 = AdminConfig.getid('/JDBCProvider:jdbc1/')
    print AdminConfig.create('DataSource', jdbc1, '[[name ds1]]')
  • 오브젝트 속성으로 Jython 사용:
    jdbc1 = AdminConfig.getid('/JDBCProvider:jdbc1/')
    print AdminConfig.create('DataSource', jdbc1, [['name', 'ds1']])
  • 다음 예제를 사용하여 포트를 작성하십시오.
    #replace server1 with your server name                                       
    serverName = 'server1'                                                       
                                                                                 
    #replace smtitant24Node03 with your node name                                
    node = AdminConfig.getid('/Node:smtitan24Node03')                            
    #print node                                                                  
    serverEntries = AdminConfig.list('ServerEntry',                              
    node).split(java.lang.System.getProperty('line.separator'))                  
                                                                                 
    for serverEntry in serverEntries:                                            
      sName = AdminConfig.showAttribute(serverEntry, "serverName")               
      if sName == serverName:                                                    
        #print serverEntry                                                       
        #replace OVERLAY_TEST with the value you want for your endPointName      
        id = AdminConfig.create('NamedEndPoint', serverEntry,                    
    '[[endPointName "OVERLAY_TEST"]]')                                           
        #print id                                                                
        start = id.find('#')                                                     
        #print start                                                             
        end = id.find(')',start)                                                 
        #print end                                                               
        str = id[start:end]                                                      
        server = id[0:start]                                                     
        #print server                                                            
        #print str                                                               
        #replace 8888 with the value you want for your port                      
        AdminConfig.create('EndPoint', server+str+')', '[[port "8888"] [host     
    "*"]]')                                                                      
        AdminConfig.save()    #AdminConfig.reset() 

createClusterMember

createClusterMember 명령을 사용하여 node id 매개변수가 지정하는 노드에 새 서버 오브젝트를 작성하십시오. 이 서버는 cluster id 매개변수에서 지정한 기존 클러스터의 새로운 멤버로 작성되며 member attributes 매개변수에 지정된 속성을 포함합니다. 서버는 템플리트 ID 속성에서 지정한 서버 템플리트를 사용하여 작성되며, memberName 속성에서 지정한 이름을 포함합니다. memberName 속성은 필수입니다. 템플리트 옵션은 첫 번째 클러스터 멤버 작성 시에만 사용 가능합니다. 첫 번째 멤버 이후에 작성한 모든 클러스터 멤버는 동일합니다.

대상 오브젝트

없음.

필수 매개변수

cluster ID
원하는 클러스터의 구성 ID를 지정합니다.
node ID
원하는 노드의 구성 ID를 지정합니다.
template ID
서버를 작성하는 데 사용할 템플리트 ID를 지정합니다.
member attributes
클러스터 멤버에 추가할 속성을 지정합니다. memberName 속성은 필수이며 이는 작성할 클러스터 멤버의 이름을 정의합니다.

선택적 매개변수

없음.

샘플 출력

명령은 새로 작성된 클러스터 멤버의 구성 ID를 리턴합니다.
myCluster(cells/mycell/clusters/myCluster|cluster.xml#ClusterMember_2)

  • Jacl 사용:
    set clid [$AdminConfig getid /ServerCluster:myCluster/]
    set nodeid [$AdminConfig getid /Node:mynode/]
    $AdminConfig createClusterMember $clid $nodeid {{memberName newMem1} {weight 5}}
  • Jython 문자열 속성 사용:
    clid = AdminConfig.getid('/ServerCluster:myCluster/') 
    nodeid = AdminConfig.getid('/Node:mynode/') 
    print AdminConfig.createClusterMember(clid, nodeid, '[[memberName newMem1] [weight 5]]')
  • 오브젝트 속성으로 Jython 사용:
    clid = AdminConfig.getid('/ServerCluster:myCluster/') 
    nodeid = AdminConfig.getid('/Node:mynode/') 
    print AdminConfig.createClusterMember(clid, nodeid, [['memberName', 'newMem1'], ['weight', 5]])

createDocument

createDocument 명령을 사용하여 구성 저장소에서 새 문서를 작성하십시오.

대상 오브젝트

없음.

필수 매개변수

document URI
저장소에 작성할 문서의 이름을 지정합니다.
file name
작성할 문서의 유효한 로컬 파일 이름을 지정합니다.

선택적 매개변수

없음.

  • Jacl 사용:
    [AIX][HP-UX][IBM i][Linux][Solaris]
    $AdminConfig createDocument cells/mycell/myfile.xml /mydir/myfile
    [Windows]
    $AdminConfig createDocument cells/mycell/myfile.xml c:/mydir/myfile
    [z/OS]
    $AdminConfig createDocument cells/mycell/myfile.xml /mydir/myfile
  • 문자열 속성으로 Jython 사용:
    [AIX Solaris HP-UX Linux Windows]
    AdminConfig.createDocument('cells/mycell/myfile.xml', 'c:/mydir/myfile')
    [IBM i]
    AdminConfig.createDocument('cells/mycell/myfile.xml', '/mydir/myfile')
    [z/OS]
    AdminConfig.createDocument('cells/mycell/myfile.xml', '/mydir/myfile')

createUsingTemplate

createUsingTemplate 명령을 사용하면 템플리트를 사용하여 상위가 지정된 오브젝트 유형을 작성할 수 있습니다. APPLICATION_SERVER 유형의 서버를 작성하는 경우에만 이 명령을 사용할 수 있습니다. APPLICATION_SERVER 유형이 아닌 서버를 작성하려면 createGenericServer 또는 createWebServer 명령을 사용하십시오.

대상 오브젝트

없음.

필수 매개변수

유형
작성할 오브젝트의 유형을 지정합니다.
parent
상위의 구성 ID를 지정합니다.
template
기존 오브젝트의 구성 ID를 지정합니다. 이 오브젝트는 listTemplates 명령을 통해 리턴된 템플리트 오브젝트 또는 올바른 유형의 기존의 기타 오브젝트일 수 있습니다.

선택적 매개변수

attributes
오브젝트의 속성 값을 지정합니다. 이 매개변수를 사용하여 지정하는 속성은 템플리트 설정을 대체합니다.

샘플 출력

명령은 새 오브젝트의 구성 ID를 다음 예제와 같이 리턴합니다.
myCluster(cells/mycell/clusters/myCluster|cluster.xml#ClusterMember_2)

  • Jacl 사용:
    set node [$AdminConfig getid /Node:mynode/]
    set templ [$AdminConfig listTemplates JDBCProvider "DB2 JDBC Provider (XA)"]
    $AdminConfig createUsingTemplate JDBCProvider $node {{name newdriver}} $templ 
  • 문자열 속성으로 Jython 사용:
    node = AdminConfig.getid('/Node:mynode/')
    templ = AdminConfig.listTemplates('JDBCProvider', "DB2 JDBC Provider (XA)")
    print AdminConfig.createUsingTemplate('JDBCProvider', node, '[[name newdriver]]', templ)
  • 오브젝트 속성으로 Jython 사용:
    node = AdminConfig.getid('/Node:mynode/')
    templ = AdminConfig.listTemplates('JDBCProvider', "DB2 JDBC Provider (XA)")
    print AdminConfig.createUsingTemplate('JDBCProvider', node, [['name', 'newdriver']], templ)

defaults

defaults 명령을 사용하여 제공된 유형의 속성에 대한 기본값을 표시하십시오. 이 메소드는 특정 유형의 오브젝트에서 포함하는 가능한 모든 속성을 표시합니다. 속성에 기본값이 있을 경우, 이 메소드는 각 속성의 유형과 기본값도 표시합니다.

대상 오브젝트

없음.

필수 매개변수

유형
리턴할 오브젝트의 유형을 지정합니다. 사용자가 지정하는 오브젝트 유형의 일름은 XML 구성 파일을 기반으로 합니다. 이 이름은 관리 콘솔이 표시하는 이름과 같을 필요가 없습니다.

선택적 매개변수

없음.

샘플 출력

명령은 해당 유형 및 값이 있는 속성 목록이 포함된 문자열을 다음 예제와 같이 리턴합니다.
Attribute               Type   	 Default

usingMultiRowSchema             Boolean                         false
maxInMemorySessionCount         Integer                         1000
allowOverflow                   Boolean                         true
scheduleInvalidation            Boolean                         false
writeFrequency                  ENUM
writeInterval                   Integer                         120
writeContents                   ENUM
invalidationTimeout             Integer                         30
invalidationSchedule            InvalidationSchedule

  • Jacl 사용:
    $AdminConfig defaults TuningParams
  • Jython 사용:
    print AdminConfig.defaults('TuningParams')

deleteDocument

deleteDocument 명령을 사용하여 구성 저장소에서 문서를 삭제하십시오.

대상 오브젝트

없음.

필수 매개변수

documentURI
저장소에서 삭제할 문서를 지정합니다.

선택적 매개변수

없음.

  • Jacl 사용:
    $AdminConfig deleteDocument cells/mycell/myfile.xml
  • Jython 사용:
    AdminConfig.deleteDocument('cells/mycell/myfile.xml')

existsDocument

existsDocument 명령을 사용하여 구성 저장소에 문서가 있는지 테스트하십시오.

대상 오브젝트

없음.

필수 매개변수

documentURI
저장소에서 테스트할 문서를 지정합니다.

선택적 매개변수

없음.

샘플 출력

명령은 문서가 있는 경우 다음 예제와 같이 true 값을 리턴합니다.
1

  • Jacl 사용:
    $AdminConfig existsDocument cells/mycell/myfile.xml
  • Jython 사용:
    print AdminConfig.existsDocument('cells/mycell/myfile.xml')

extract

extract 명령을 사용하여 문서 URI가 설명하는 구성 저장소 파일을 추출하고 filename으로 이름이 지정된 파일에 배치하십시오. 이 메소드는 배치 관리자 구성에만 적용됩니다.

대상 오브젝트

없음.

필수 매개변수

documentURI
구성 저장소에서 추출할 문서를 지정합니다. 문서 URI는 저장소에 존재해야 합니다. 문서 URI는 구성 저장소의 루트와 관련됩니다. 예를 들어, 다음과 같습니다.
  • [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]/WebSphere/AppServer/config
  • [Windows]app_server_root\config
filename
문서를 추출할 파일 이름을 지정합니다. 파일 이름은 문서의 내용이 작성된 유효한 로컬 파일 이름이어야 합니다. filename 매개변수에 의해 지정된 파일이 존재하는 경우 이 파일을 추출된 파일로 바꿉니다.

선택적 매개변수

없음.

샘플 출력

명령은 checkin 명령 사용 시 파일을 다시 확인하는 데 사용해야 하는 오파크 "다이제스트" 오브젝트를 리턴합니다.

  • Jacl 사용:
    [AIX][HP-UX][IBM i][Linux][Solaris]
    set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml /mydir/myfile] 
    [Windows]
    set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml c:\\mydir\myfile] 
    [z/OS]
    set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml \mydir\myfile] 
  • Jython 사용:
    [AIX][HP-UX][IBM i][Linux][Solaris]
    obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','/mydir/myfile')
    [Windows]
    obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','c:\mydir\myfile')
    [z/OS]
    obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','\mydir\myfile')

getCrossDocumentValidationEnabled

getCrossDocumentValidationEnabled 명령을 사용하여 현재 교차 문서 사용 가능 설정을 가진 메시지를 리턴하십시오. 이 메소드는 교차 문서 유효성 검증이 사용 가능한 경우 true를 리턴합니다.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

없음.

샘플 출력

명령은 교차 문서 유효성 검증 설정이 있는 메시지가 포함된 문자열을 다음 예제와 같이 리턴합니다.
WASX7188I: Cross-document validation enablement set to true

  • Jacl 사용:
    $AdminConfig getCrossDocumentValidationEnabled
  • Jython 사용:
    print AdminConfig.getCrossDocumentValidationEnabled()

getid

getid 명령을 사용하여 오브젝트의 구성 ID를 리턴하십시오.

대상 오브젝트

없음.

필수 매개변수

containment path
원하는 포함 경로를 지정합니다.

선택적 매개변수

없음.

샘플 출력

명령은 포함 경로로 설명되는 오브젝트의 구성 ID를 다음 예제와 같이 리턴합니다.
Db2JdbcDriver(cells/testcell/nodes/testnode|resources.xml#JDBCProvider_1)

  • Jacl 사용:
    $AdminConfig getid /Cell:testcell/Node:testNode/JDBCProvider:Db2JdbcDriver/
  • Jython 사용:
    print AdminConfig.getid('/Cell:testcell/Node:testNode/JDBCProvider:Db2JdbcDriver/')

getObjectName

getObjectName 명령을 사용하여 해당하는 실행 중인 MBean에 대한 오브젝트 이름의 문자열 버전을 리턴하십시오. 이 메소드는 실행 중인 해당 MBean이 없을 경우 빈 문자열을 리턴합니다.

대상 오브젝트

없음.

필수 매개변수

configuration ID
리턴할 오브젝트 이름의 구성 ID를 지정합니다.

선택적 매개변수

없음.

샘플 출력

명령은 오브젝트 이름이 포함된 문자열을 다음 예제와 같이 리턴합니다.
WebSphere:cell=mycell,name=server1,mbeanIdentifier=cells/mycell/nodes/mynode/servers/server1/
server.xml#Server_1,type=Server,node=mynode,process=server1,processType=UnManagedProcess

  • Jacl 사용:
    set server [$AdminConfig getid /Node:mynode/Server:server1/]
    $AdminConfig getObjectName $server
  • Jython 사용:
    server = AdminConfig.getid('/Node:mynode/Server:server1/')
    print AdminConfig.getObjectName(server)

getObjectType

getObjectType 명령을 사용하여 원하는 오브젝트 구성 ID의 오브젝트 유형을 표시할 수 있습니다.

대상 오브젝트

없음.

필수 매개변수

configuration ID
리턴할 오브젝트 이름의 구성 ID를 지정합니다.

선택적 매개변수

없음.

  • Jacl 사용:
    set server [$AdminConfig getid /Node:mynode/Server:server1/]
    $AdminConfig getObjectType $server
  • Jython 사용:
    server = AdminConfig.getid('/Node:mynode/Server:server1/')
    print AdminConfig.getObjectType(server)

getSaveMode

getSaveMode 명령을 사용하여 save 명령을 호출할 때 사용되는 모드를 리턴하십시오. 명령은 다음 가능한 값 중 하나를 리턴합니다.
  • overwriteOnConflict - 다른 구성 변경사항과 충돌할 경우에도 변경사항을 저장합니다.
  • rollbackOnConflict - 변경사항이 다른 구성 변경사항과 충돌할 경우 저장 조작에 실패합니다. 이 값이 기본값입니다.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

없음.

샘플 출력

명령은 현재 저장 모드 설정이 포함된 문자열을 다음 예제와 같이 리턴합니다.
rollbackOnConflict

  • Jacl 사용:
    $AdminConfig getSaveMode
  • Jython 사용:
    print AdminConfig.getSaveMode()

getValidationLevel

저장소에서 파일을 추출할 때 사용할 유효성 검증을 리턴하려면 getValidationLevel 명령을 사용하십시오.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

없음.

샘플 출력

명령은 유효성 검증 레벨이 포함된 문자열을 다음 예제와 같이 리턴합니다.
WASX7189I: 유효성 검증 레벨이 HIGH로 설정되었음

  • Jacl 사용:
    $AdminConfig getValidationLevel
  • Jython 사용:
    print AdminConfig.getValidationLevel()

getValidationSeverityResult

getValidationSeverityResult 명령을 사용하여 최근 유효성 검증으로부터 제공된 심각도를 갖는 유효성 검증 메시지의 수를 리턴하십시오.

대상 오브젝트

없음.

필수 매개변수

심각도
유효성 검증 메시지의수를 리턴할 심각도 레벨을 지정합니다. 0 - 9 이내의 정수값을 지정하십시오.

선택적 매개변수

없음.

샘플 출력

명령은 제공된 심각도의 유효성 검증 메시지 수를 나타내는 문자열을 다음 예제와 같이 리턴합니다.
16

  • Jacl 사용:
    $AdminConfig getValidationSeverityResult 1
  • Jython 사용:
    print AdminConfig.getValidationSeverityResult(1)

hasChanges

hasChanges 명령을 사용하여 저장되지 않은 구성 변경사항이 있는지를 판별하십시오.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

없음.

샘플 출력

명령은 저장되지 않은 구성 변경이 있는 경우 1을 리턴하고 저장되지 않는 구성이 없는 경우 다음 예제와 같이 0을 리턴합니다.
1

  • Jacl 사용:
    $AdminConfig hasChanges
  • Jython 사용:
    print AdminConfig.hasChanges()

도움말

help 명령을 사용하여 AdminConfig 오브젝트에 대한 정적 도움말 정보를 표시하십시오.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

없음.

샘플 출력

명령은 도움말 명령에 대한 옵션 목록을 다음 예제와 같이 리턴합니다.
WASX7053I: The AdminConfig object communicates with the configuration service in a product to manipulate 
configuration data for an Application Server installation.  The AdminConfig object has commands to list, 
create, remove, display, and modify configuration data, as well as commands to display information about configuration data types.

Most of the commands supported by the AdminConfig object operate in two modes: the default mode is one in which 
the AdminConfig object communicates with the Application Server to accomplish its tasks. A local mode is also
possible, in which no server communication takes place.  The local mode of operation is invoked by bringing up 
the scripting client without a server connected using the command line "-conntype NONE" option or setting the 
"com.ibm.ws.scripting.connectionType=NONE" property in the wsadmin.properties file.

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

attributes      Shows the attributes for a given type
checkin         Checks a file into the configuration repository.
convertToCluster									Converts a server to be the first member of a new server cluster
create          									Creates a configuration object, given a type, a parent, and a list of attributes, and 
																																optionally an attribute name for the new object
createClusterMember 							Creates a new server that is a member of an existing cluster.
createDocument  Creates a new document in the configuration repository.
installResourceAdapter							Installs a J2C resource adapter with the given RAR file name and an option string in the node.
createUsingTemplate 							Creates an object using a particular template type.
defaults        Displays the default values for the attributes of a given type.
deleteDocument  Deletes a document from the configuration repository.
existsDocument  Tests for the existence of a document in the configuration repository.
extract         Extracts a file from the configuration repository.
getCrossDocumentValidationEnabled		Returns true if cross-document validation is enabled.
getid           									Show the configuration ID of an object, given a string version of its containment
getObjectName   Given a configuration ID, returns a string version of the ObjectName
																for the corresponding running MBean, if any.
getSaveMode     Returns the mode used when "save" is invoked
getValidationLevel								Returns the validation that is used when files are extracted from the repository.
getValidationSeverityResult				Returns the number of messages of a given severity from the most recent validation.
hasChanges      Returns true if unsaved configuration changes exist
help            Shows help information
list            Lists all the configuration objects of a given type
listTemplates   									Lists all the available configuration templates of a given type.
modify          Changes the specified attributes of a given configuration object
parents         Shows the objects which contain a given type
queryChanges    Returns a list of unsaved files
remove Removes the specified configuration object 
required        Displays the required attributes of a given type.
reset           Discards the unsaved configuration changes
save            Commits the unsaved changes to the configuration repository
setCrossDocumentValidationEnabled		Sets the cross-document validation enabled mode.
setSaveMode     Changes the mode used when "save" is invoked
setValidationLevel								Sets the validation used when files are extracted from the repository.
show            Shows the attributes of a given configuration object
showall         Recursively shows the attributes of a given configuration
                									object, and all the objects that are contained within each attribute.
showAttribute   Displays only the value for the single attribute that is specified.
types           Shows the possible types for configuration
validate        Invokes validation

  • Jacl 사용:
    $AdminConfig help
  • Jython 사용:
    print AdminConfig.help()

installResourceAdapter

installResourceAdapter 명령을 사용하여 노드의 제공된 자원 어댑터 아카이브(RAR) 파일 이름 및 옵션 문자열을 가진 J2C(Java 2 Connector) 자원 어댑터를 설치하십시오. 임베디드 RAR을 사용하여 설치된 애플리케이션을 편집하는 경우, 기존 J2C 연결 팩토리, J2C 활성화 스펙, J2C 관리 오브젝트만 편집합니다. 새 J2C 오브젝트는 작성되지 않습니다.

대상 오브젝트

없음.

필수 매개변수

node
원하는 노드를 지정합니다.
RAR file name
사용자가 지정한 노드에 상주하는 RAR 파일의 완전한 파일 이름을 지정합니다.

선택적 매개변수

options
자원 어댑터 설치를 위한 추가 옵션을 지정합니다. 유효한 옵션은 다음과 같습니다.
  • rar.name
  • rar.desc
  • rar.archivePath
  • rar.classpath
  • rar.nativePath
  • rar.threadPoolAlias
  • rar.propertiesSet
rar.name 옵션은 J2C 자원 어댑터의 이름입니다. 이 옵션을 지정하지 않을 경우, RAR 배치 디스크립터의 표시 이름이 사용됩니다. 해당 이름이 지정되지 않은 경우, RAR 파일 이름이 사용됩니다. rar.desc 옵션은 J2CResourceAdapter의 설명입니다.

rar.archivePath는 파일을 추출하는 경로의 이름입니다. 이 옵션을 지정하지 않을 경우, 아카이브는 $\{CONNECTOR_INSTALL_ROOT\} 디렉토리에 추출됩니다. rar.classpath 옵션은 추가 클래스 경로입니다.

rar.propertiesSet의 구성은 다음과 같습니다.
name         String
value String
type String
*desc String
*required true/false
* means the item is optional
특성의 각 속성은 {} 세트에 지정됩니다. 특성은 {} 세트에 지정됩니다. {}에 복수 특성을 지정할 수 있습니다.

샘플 출력

명령은 새 J2CResourceAdapter 오브젝트의 구성 ID를 리턴합니다.
myResourceAdapter(cells/mycell/nodes/mynode|resources.xml#J2CResourceAdapter_1)

  • Jacl 사용:
    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    $AdminConfig installResourceAdapter /rar/mine.rar mynode{-rar.name myResourceAdapter 
    -rar.desc "My rar file"} 
    [Windows]
    $AdminConfig installResourceAdapter c:/rar/mine.rar mynode {-rar.name myResourceAdapter 
    -rar.desc "My rar file"}
  • Jython 사용:
    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    print AdminConfig.installResourceAdapter('/rar/mine.rar', 'mynode', '[-rar.name myResourceAdapter 
    -rar.desc "My rar file"]')
    [Windows]
    print AdminConfig.installResourceAdapter('c:/rar/mine.rar', 'mynode', '[-rar.name myResourceAdapter 
    -rar.desc "My rar file"]') 
문자열을
resourceProperties (name=myName,value=myVal)
자원 어댑터 구성으로 추가하려면 다음 명령을 실행하십시오.
  1. pSet = [['propertySet',[['resourceProperties',[[['name','myName'], ['type', 'String'], ['value','myVal']]]]]]]
  2. [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    myRA =AdminConfig.installResourceAdapter('/query.rar','mynodeCellManager05',
    ['-rar.desc','mydesc'])
    [Windows]
    myRA =AdminConfig.installResourceAdapter('c:\query.rar','mynodeCellManager05',
    ['-rar.desc','mydesc'])
  3. AdminConfig.modify(myRA,pSet)

list

list 명령을 사용하여 지정된 유형의 오브젝트 목록을 리턴하거나, 검색 조회를 사용자 정의하기 위해 유형 및 범위가 지정된 상위를 제공하거나 명령 구문에서 유형과 와일드카드 문자(*) 또는 Java 정규식(.*)을 제공하여 검색 조회를 좁힐 수 있습니다.

대상 오브젝트

없음.

필수 매개변수

object type
오브젝트 유형의 이름을 지정합니다. 오브젝트 유형의 이름은 XML 구성 파일을 기반으로 하며 관리 콘솔에 표시되는 이름과 같을 필요가 없습니다.

선택적 매개변수

범위
범위가 지정된 상위를 사용하여 추가 검색 조회 정보를 지정합니다.
pattern
와일드카드 문자(*) 또는 Java 정규식 패턴(.*)을 사용하여 추가 검색 조회 정보를 지정합니다.

샘플 출력

명령은 오브젝트 목록을 리턴합니다.
Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xml#JDBCProvider_1) 
Db2JdbcDriver(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#JDBCProvider_1) 
Db2JdbcDriver(cells/mycell/nodes/DefaultNode/servers/nodeAgent|resources.xml#JDBCProvider_1) 

다음 예제에서는 각 JDBC 제공자 구성 오브젝트를 나열합니다.
  • Jacl 사용:
    $AdminConfig list JDBCProvider
  • Jython 사용:
    print AdminConfig.list('JDBCProvider')
    참고: 작은 따옴표 또는 큰 따옴표를 사용하십시오.
다음 예제는 Derby 문자열로 시작하는 오브젝트 유형과 와일드카드 패턴을 지정하여 각 JDBC 제공자 구성 오브젝트를 나열합니다.
  • Jacl 사용:
    $AdminConfig list JDBCProvider derby*
  • Jython 사용:
    print AdminConfig.list('JDBCProvider', 'derby*')

Java 정규식 패턴과 와일드카드 패턴을 사용하여 $AdminConfig 목록, 유형 및 listTemplates 기능의 명령 이름을 지정할 수 있습니다.

다음 예제는 server1 문자열로 시작하는 Java 표현식 패턴과 오브젝트 유형을 제공하여 서버 구성 오브젝트를 나열합니다.
  • Jacl 사용:
    $AdminConfig list Server server1.*
  • Jython 사용:
    print AdminConfig.list("Server", "server1.*")

다음 예제는 오브젝트 유형과 상위 범위 구성 ID를 제공하여 서버 구성 오브젝트를 나열합니다.

  • Jacl 사용:
    $AdminConfig list Server myNode(cells/myCell/nodes/myNode|node.xml#Node_1)
  • Jython 사용:
    print AdminConfig.list("Server", "myNode(cells/myCell/nodes/myNode|node.xml#Node_1)")
다음 예제는 SSLConfig부터 시작하여 각 찾기 구성 오브젝트를 나열합니다.
  • Jacl 및 일반 Java 표현식 패턴 사용:
    $AdminConfig types SSLConfig.*
  • Jacl 및 와일드카드 패턴 사용:
    $AdminConfig types SSLConfig*
  • Jython 및 일반 Java 표현식 패턴 사용:
    print AdminConfig.types("SSLConfig.*")
  • Jython 및 와일드카드 패턴 사용:
    print AdminConfig.types("SSLConfig*")

listTemplates

listTemplates 명령을 사용하여 템플리트 오브젝트 ID 목록을 표시하십시오.명령 구문에서 와일드카드 문자(*) 또는 Java 일반 표현식(.*)을 사용하여 검색 조회를 사용자 정의할 수 있습니다.

대상 오브젝트

없음.

필수 매개변수

object type
오브젝트 유형의 이름을 지정합니다. 오브젝트 유형의 이름은 XML 구성 파일을 기반으로 하며 관리 콘솔에 표시되는 이름과 같을 필요가 없습니다.
pattern
와일드카드 문자 또는 Java 정규식을 사용하여 계속 검색 조회 정보를 지정합니다.

선택적 매개변수

없음.

샘플 출력

예제는 시스템에서 사용 가능한 모든 JDBCProvider 템플리트 목록을 표시합니다.
"Derby JDBC Provider (XA)(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#builtin_jdbcprovider)"
"Derby JDBC Provider (XA)(templates/servertypes/APPLICATION_SERVER/servers/defaultZOS|resources.xml#builtin_jdbcprovider)"
"Derby JDBC Provider (XA)(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jdbcprovider)"
"Derby JDBC Provider (XA)(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)"
"Derby JDBC Provider 40 (XA)(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_2)"
"Derby JDBC Provider 40 Only (XA)(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_2)"
"Derby JDBC Provider 40 Only(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_1)"
"Derby JDBC Provider 40(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_1)"
"Derby JDBC Provider Only (XA)(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_4)"
"Derby JDBC Provider Only(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_3)"
"Derby JDBC Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#JDBCProvider_1124467079638)"
"Derby JDBC Provider(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_derby_3)" 

다음 예제는 각 JDBC 제공자 템플리트를 리턴합니다.
  • Jacl 사용:
    $AdminConfig listTemplates JDBCProvider
  • Jython 사용:
    print AdminConfig.listTemplates('JDBCProvider')
다음 예제는 sybase 문자열로 시작하는 각 JDBC 제공자 템플리트를 리턴합니다.
  • Jacl 사용:
    $AdminConfig listTemplates JDBCProvider sybase*
  • Jython 사용:
    print AdminConfig.listTemplates('JDBCProvider', 'sybase*')

modify

modify 명령을 사용하여 오브젝트 속성의 수정을 지원하십시오.

대상 오브젝트

없음.

필수 매개변수

configuration ID
수정할 오브젝트의 구성 ID를 지정합니다.
attributes
원하는 구성 ID를 수정하려면 속성을 지정합니다.

선택적 매개변수

없음.

  • Jacl 사용:
    $AdminConfig modify ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#
    GenericJMSConnectionFactory_1) {{userID newID} {password newPW}}
  • 문자열 속성으로 Jython 사용:
    AdminConfig.modify('ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#
    GenericJMSConnectionFactory_1)', '[[userID newID] [password newPW]]')
  • 오브젝트 속성으로 Jython 사용:
    AdminConfig.modify('ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#
    GenericJMSConnectionFactory_1)', [['userID', 'newID'], ['password', 'newPW']])

parents

parents 명령을 사용하여 오브젝트 유형에 대한 정보를 얻으십시오.

대상 오브젝트

없음.

필수 매개변수

object type
원하는 오브젝트 유형을 지정합니다. 오브젝트 유형의 이름은 XML 구성 파일을 기반으로 하며 관리 콘솔에 표시되는 이름과 같을 필요가 없습니다.

선택적 매개변수

없음.

샘플 출력

예제는 오브젝트 유형의 목록을 표시합니다.
셀
노드서버

  • Jacl 사용:
    $AdminConfig parents JDBCProvider
  • Jython 사용:
    print AdminConfig.parents('JDBCProvider')

queryChanges

queryChanges 명령을 사용하여 저장되지 않은 구성 파일 목록을 리턴하십시오.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

없음.

샘플 출력

예제는 저장되지 않은 변경사항을 가진 파일 목록을 포함하는 문자열을 표시합니다.
WASX7146I: The following configuration files contain unsaved changes:
cells/mycell/nodes/mynode/servers/server1|resources.xml

  • Jacl 사용:
    $AdminConfig queryChanges
  • Jython 사용:
    print AdminConfig.queryChanges()

remove

remove 명령을 사용하여 구성 오브젝트를 제거하십시오.

대상 오브젝트

없음.

필수 매개변수

configuration ID
원하는 구성 오브젝트를 지정합니다.

선택적 매개변수

없음.

  • Jacl 사용:
    set ds [$AdminConfig list DataSource "Default Datasource*"]
    $AdminConfig remove $ds
  • Jython 사용:
    ds = AdminConfig.list('DataSource', 'Default Datasource*')
    AdminConfig.remove(ds)

필수

required 명령을 사용하여 특정 유형의 오브젝트에서 포함하는 필수 속성을 표시하십시오.

대상 오브젝트

없음.

필수 매개변수

유형
필수 속성을 표시할 오브젝트 유형을 지정합니다. 오브젝트 유형의 이름은 XML 구성 파일을 기반으로 합니다. 관리 콘솔이 표시하는 이름과 같을 필요가 없습니다.

선택적 매개변수

없음.

샘플 출력

예제는 유형을 가진 필수 속성 목록을 포함하는 문자열을 표시합니다.
Attribute      	Type
streamHandlerClassName   String
protocol                        String

  • Jacl 사용:
    $AdminConfig required URLProvider
  • Jython 사용:
    print AdminConfig.required('URLProvider')

reset

reset 명령을 사용하여 구성에 대한 업데이트를 보유하는 임시 작업공간을 재설정하십시오.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

없음.

  • Jacl 사용:
    $AdminConfig reset
  • Jython 사용:
    AdminConfig.reset()

resetAttributes

resetAttributes 명령을 사용하여 원하는 구성 오브젝트의 특정 속성을 재설정합니다.

대상 오브젝트

없음.

필수 매개변수

configuration ID
원하는 구성 오브젝트의 구성 ID를 지정합니다.
attributes
재설정할 속성 및 속성을 재설정할 값을 지정합니다.

선택적 매개변수

없음.

  • Jacl 사용:
    set ds [$AdminConfig list DataSource "Default Datasource*"]
    $AdminConfig resetAttributes $ds {{"description" "A new description for the data source"}}
  • Jython 사용:
    ds = AdminConfig.list('DataSource', 'Default Datasource*')
    AdminConfig.resetAttributes(ds, [["description", "A new description for the data source"]])

save

save 명령을 사용하여 구성 저장소에 대한 변경사항을 저장하십시오.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

없음.

샘플 출력

save 명령은 출력을 리턴하지 않습니다.

  • Jacl 사용:
    $AdminConfig save
  • Jython 사용:
    AdminConfig.save()

setCrossDocumentValidationEnabled

setCrossDocumentValidationEnabled 명령을 사용하여 교차 문서 유효성 검증 사용 가능 모드를 설정하십시오. 값은 true 또는 false입니다.

대상 오브젝트

없음.

필수 매개변수

flag
교차 문서 유효성 검증이 사용 가능한지 또는 사용 불가능한지 여부를 지정합니다. 교차 문서 유효성 검증이 사용 가능한 경우 true로 지정하고 사용 불가능한 경우 false로 지정합니다.

선택적 매개변수

없음.

샘플 출력

명령은 교차 문서 유효성 검증에 대한 상태 명령문을 리턴합니다.
WASX7188I: 교차 문서 유효성 검증 사용 가능 값이 true로 설정되었음

  • Jacl 사용:
    $AdminConfig setCrossDocumentValidationEnabled true
  • Jython 사용:
    print AdminConfig.setCrossDocumentValidationEnabled('true')

setSaveMode

setSaveMode 명령을 사용하여 save 명령의 작동을 수정하십시오.

대상 오브젝트

없음.

필수 매개변수

save mode
사용할 저장 모드를 지정합니다. 기본값은 rollbackOnConflict입니다. 저장 시 시스템이 충돌을 발견하면, 저장되지 않은 변경사항은 확약되지 않습니다. 대체 값은 overwriteOnConflict이며, 충돌이 발생할 경우에도 구성 저장소에 변경사항을 저장합니다.이 명령의 값으로 overwriteOnConflict를 사용하려면, 구성 겹쳐쓰기를 위해 배치 관리자를 사용 가능해야 합니다.

선택적 매개변수

없음.

샘플 출력

setSaveMode 명령은 출력을 리턴하지 않습니다.

  • Jacl 사용:
    $AdminConfig setSaveMode overwriteOnConflict
  • Jython 사용:
    AdminConfig.setSaveMode('overwriteOnConflict')

setValidationLevel

setValidationLevel 명령을 사용하여 저장소에서 파일을 추출할 때 사용되는 유효성 검증을 설정하십시오.

대상 오브젝트

없음.

필수 매개변수

level
사용할 유효성 검증을 지정합니다. 다음과 같은 다섯 가지 유효성 검증 레벨이 있습니다. none, low, medium, high 또는 highest.

선택적 매개변수

없음.

샘플 출력

명령은 유효성 검증 레벨 설정이 포함된 문자열을 다음 예제와 같이 리턴합니다.
WASX7189I: 유효성 검증 레벨이 HIGH로 설정되었음

  • Jacl 사용:
    $AdminConfig setValidationLevel high
  • Jython 사용:
    print AdminConfig.setValidationLevel('high')

show

show 명령을 사용하여 제공된 오브젝트의 최상위 레벨 속성을 리턴하십시오.

대상 오브젝트

없음.

필수 매개변수

configuration ID
관심있는 오브젝트의 구성 ID를 지정합니다.

선택적 매개변수

없음.

샘플 출력

명령은 속성 값이 포함된 문자열을 다음 예제와 같이 리턴합니다.
[name "Sample Datasource"] [description "Data source for the Sample entity beans"]

  • Jacl 사용:
    $AdminConfig show Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xmlJDBCProvider_1)
  • Jython 사용:
    print AdminConfig.show('Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xmlJDBCProvider_1)')

showall

showall 명령을 사용하여 제공된 구성 오브젝트의 속성을 순환식으로 표시하십시오.

대상 오브젝트

없음.

필수 매개변수

configuration ID
관심있는 오브젝트의 구성 ID를 지정합니다.

선택적 매개변수

없음.

샘플 출력

명령은 속성 값이 포함된 문자열을 다음 예제와 같이 리턴합니다.

Jacl 사용:
tcpNoDelay: null
SoTimeout: 0
bytesRead: 6669
{authMechanismPreference BASIC_PASSWORD}
{connectionPool {{agedTimeout 0}
{connectionTimeout 180}
{freePoolDistributionTableSize 0}
{maxConnections 10}
{minConnections 1}
{numberOfFreePoolPartitions 0}
{numberOfSharedPoolPartitions 0}
{numberOfUnsharedPoolPartitions 0}
{properties {}}
{purgePolicy EntirePool}
{reapTime 180}
{stuckThreshold 0}
{stuckTime 0}
{stuckTimerTime 0}
{surgeCreationInterval 0}
{surgeThreshold -1}
{testConnection false}
{testConnectionInterval 0}
{unusedTimeout 1800}}}
{datasourceHelperClassname com.ibm.websphere.rsadapter.DerbyDataStoreHelper}
{description "Datasource for the WebSphere Default Application"}
{diagnoseConnectionUsage false}
{jndiName DefaultDatasource}
{logMissingTransactionContext true}
{manageCachedHandles false}
{name "Default Datasource"}
{properties {}}
{propertySet {{resourceProperties {{{name databaseName}
{required false}
{type java.lang.String}
{value ${APP_INSTALL_ROOT}/${CELL}/DefaultApplication.ear/DefaultDB}} {{name shu
tdownDatabase}
{required false}
{type java.lang.String}
{value {}}} {{name dataSourceName}
{required false}
{type java.lang.String}
{value {}}} {{name description}
{required false}
{type java.lang.String}
{value {}}} {{name connectionAttributes}
{required false}
{type java.lang.String}
{value upgrade=true}} {{name createDatabase}
{required false}
{type java.lang.String}
{value {}}}}}}}
{provider "Derby JDBC Provider(cells/isthmusCell04/nodes/isthmusNode14/servers/s
erver1|resources.xml#JDBCProvider_1183122153343)"}
{providerType "Derby JDBC Provider"}
{relationalResourceAdapter "WebSphere Relational Resource Adapter(cells/isthmusC
ell04/nodes/isthmusNode14/servers/server1|resources.xml#builtin_rra)"}
{statementCacheSize 10}
Jython 사용:
[datasourceHelperClassname com.ibm.websphere.rsadapter.DerbyDataStoreHelper]
[description "Datasource for the WebSphere Default Application"]
[jndiName DefaultDatasource]
[name "Default Datasource"]
[propertySet [[resourceProperties [[[description "Location of Apache Derby default database."]
[name databaseName]
[type string]
[value ${WAS_INSTALL_ROOT}/bin/DefaultDB]] [[name remoteDataSourceProtocol]
[type string]
[value []]] [[name shutdownDatabase]
[type string]
[value []]] [[name dataSourceName]
[type string]
[value []]] [[name description]
[type string]
[value []]] [[name connectionAttributes]
[type string]
[value []]] [[name createDatabase]
[type string]
[value []]]]]]]
[provider "Apache Derby JDBC Driver(cells/pongo/nodes/pongo/servers/server1|resources.xml#JDBCProvider_1)"]
[relationalResourceAdapter "WebSphere Relational Resource Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
[statementCacheSize 0]
추가로 처리하기 위해서는 Jython 출력을 문자열에서 목록으로 변환해야 할 수도 있습니다.

  • Jacl 사용:
    $AdminConfig showall "Default Datasource(cells/mycell/nodes/DefaultNode/servers/server1:resources.xml#DataSource_1)"
  • Jython 사용:
    print AdminConfig.showall
      ("Default Datasource(cells/mycell/nodes/DefaultNode/servers/server1:resources.xml#DataSource_1)")

showAttribute

showAttribute 명령을 사용하여 사용자가 지정한 단일 속성에 대한 값만을 표시하십시오.

대상 오브젝트

없음.

필수 매개변수

configuration ID
관심있는 오브젝트의 구성 ID를 지정합니다.
attribute
조회할 속성을 지정합니다.

선택적 매개변수

없음.

샘플 출력

이 명령의 출력은 단일 속성을 지정할 경우 show 명령의 출력과 다릅니다. showAttribute 명령은 속성 이름 및 값을 포함하는 목록을 표시하지 않으며, 다음 예에서 표시하는 것처럼 속성 값만 표시합니다.
mynode

  • Jacl 사용:
    set ns [$AdminConfig getid /Node:mynode/]
    $AdminConfig showAttribute $ns hostName
  • Jython 사용:
    ns = AdminConfig.getid('/Node:mynode/')
    print AdminConfig.showAttribute(ns, 'hostName')
    버전 7.0.0.5 이전에는 Jython 스크립팅 언어가 특수 문자를 인식하지 못했습니다. 또한 속성 매개변수 사이에 쉼표와 단일 공백 문자가 있으면, 이러한 문자는 분리문자로 처리되고 속성값을 저장할 때 무시되었습니다. 예를 들어, 다음 Jython 명령 세트를 보유할 수 있습니다.
    value='{"param1","param2"}'
    serverId=AdminConfig.getid('/Cell:cell_name/Node:node_name/Server:server_name')
    nameSpace=AdminConfig.create('StringNameSpaceBinding',serverId,[['name','TestName'],
    ['nameInSpace','TestNameSpace'],['stringToBind',value] ])
    다음 명령을 사용하여 값을 인쇄할 수 있습니다.
    print AdminConfig.showAttribute(nameSpace, 'stringToBind')
    결과적으로 다음이 출력됩니다.
    {"param1" "param2"}
    버전 7.0.0.5 이후에서는 Jython 스크립트 언어는 앞에 백슬래시 문자(\)가 있으면 쉼표를 인식합니다. 예를 들어, Jython 명령의 원래 예제 세트에서 첫 번째 행을 다음 명령으로 변경하십시오.
    value='{"param1"\,"param2"}'
    값을 인쇄하면 다음 출력이 리턴됩니다.
    {"param1","param2"}

유형

명령 구문에 추가로 와일드카드 문자(*) 또는 Java 정규식(.*) 패턴을 제공하여 검색 조회를 조작 또는 사용자 정의할 수 있는 구성 오브젝트 유형 목록을 리턴하려면 types 명령을 사용하십시오.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

pattern
와일드카드 문자(*) 또는 Java 정규식 패턴(.*)을 사용하여 추가 검색 조회 정보를 지정합니다.

샘플 출력

명령은 오브젝트 유형의 목록을 다음 예제와 같이 리턴합니다.
AdminService
Agent
ApplicationConfig
ApplicationDeployment
ApplicationServer
AuthMechanism
AuthenticationTarget
AuthorizationConfig
AuthorizationProvider
AuthorizationTableImpl
BackupCluster
CMPConnectionFactory
CORBAObjectNameSpaceBinding
셀
CellManager
Classloader
ClusterMember
ClusteredTarget
CommonSecureInteropComponent

다음 예제는 구성에 각 오브젝트 유형을 리턴합니다.
  • Jacl 사용:
    $AdminConfig types
  • Jython 사용:
    print AdminConfig.types()
다음 예제는 구성에서 추가 security 문자열 패턴이 있는 각 오브젝트 유형을 리턴합니다.
  • Jacl 사용:
    $AdminConfig types *security*
  • Jython 사용:
    print AdminConfig.types('*security*')

uninstallResourceAdapter

uninstallResourceAdapter 명령을 사용하여 제공된 J2C 자원 어댑터 구성 ID 및 옵션 목록의 J2C(Java 2 Connector) 자원 어댑터를 설치 제거하십시오. 구성 저장소에서 J2CResourceAdapter 오브젝트를 제거하면, 동기화할 때 설치된 디렉토리가 제거됩니다. 중지 요청이 제거된 J2CResourceAdapter MBean으로 전송됩니다.

대상 오브젝트

없음.

필수 매개변수

configuration ID
제거할 자원 어댑터의 구성 ID를 지정합니다.

선택적 매개변수

options list
명령에 대한 설치 제거 옵션을 지정합니다. 유효한 옵션은 force입니다. 이 옵션은 애플리케이션이 자원 어댑터를 사용 중인지 여부를 확인하지 않고 자원 어댑터의 설치 제거에 초점을 둡니다. 이를 사용 중인 애플리케이션은 설치 제거되지 않습니다. force 옵션을 지정하지 않고 지정된 자원 어댑터는 계속 사용 중이면 자원 어댑터가 설치 제거되지 않습니다.

샘플 출력

명령은 제거된 J2C 자원 어댑터의 구성 ID를 다음 예제와 같이 리턴합니다.
WASX7397I: The following J2CResourceAdapter objects are removed: 
MyJ2CRA(cells/juniarti/nodes/juniarti|resources.xml#J2CResourceAdapter_1069433028609)

  • Jacl 사용:
    set j2cra [$AdminConfig getid /J2CResourceAdapter:MyJ2CRA/]
    $AdminConfig uninstallResourceAdapter $j2cra {-force}
  • Jython 사용:
    j2cra = AdminConfig.getid('/J2CResourceAdapter:MyJ2CRA/')
    print AdminConfig.uninstallResourceAdapter(j2cra, '[-force]')

unsetAttributes

unsetAttributes 명령을 사용하여 구성 오브젝트의 특정 속성을 기본값으로 재설정합니다.

대상 오브젝트

없음.

필수 매개변수

configuration ID
원하는 구성 오브젝트의 구성 ID를 지정합니다.
attributes
기본값으로 재설정할 속성을 지정합니다.

선택적 매개변수

없음.

  • Jacl 사용:
    set cluster [$AdminConfig getid /ServerCluster:myCluster]
    $AdminConfig unsetAttributes $cluster {"enableHA", "preferLocal"}
  • Jython 사용:
    cluster = AdminConfig.getid("/ServerCluster:myCluster")
    AdminConfig.unsetAttributes(cluster, ["enableHA", "preferLocal"])

validate

validate 명령을 사용하여 작업공간의 파일, 교차 문서 유효성 검증 사용 가능 플래그 값 및 유효성 검증 레벨 설정에 따라 구성 유효성 검증 결과를 요청하십시오. 선택적으로 범위를 설정하기 위해 구성 ID를 지정할 수 있습니다. 구성 ID를 지정하는 경우, 이 요청의 범위는 configuration ID 매개변수에 의해 이름 지정된 오브젝트입니다.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

configuration ID
관심있는 오브젝트의 구성 ID를 지정합니다.

샘플 출력

명령은 유효성 검증의 결과가 포함된 문자열을 다음 예제와 같이 리턴합니다.
WASX7193I: Validation results are logged in c:\WebSphere5\AppServer\logs\wsadmin.valout: Total number of messages: 16
WASX7194I: Number of messages of severity 1: 16

  • Jacl 사용:
    $AdminConfig validate
  • Jython 사용:
    print AdminConfig.validate()

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



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