modifySIBEngine 명령
modifySIBEngine 명령을 사용하여 서비스 통합 버스 멤버에 대한 메시징 엔진의 특성을 수정할 수 있습니다.
명령을 실행하려면 wsadmin 스크립트 클라이언트의 AdminTask 오브젝트를 사용하십시오.
wsadmin 스크립트 클라이언트는 Qshell에서
실행됩니다. .
자세한 정보는 wsadmin 스크립트를 사용하여 WebSphere 스크립트를 실행하도록 Qshell 구성의 내용을 참조하십시오..
서비스 통합 버스에 대해 명령행 도움말이 제공됩니다.
- Jython의 사용 가능한 서비스 통합 버스 명령 목록과 각 명령의 간단한 설명에 대해서는
wsadmin 프롬프트에 다음 명령을 입력하십시오.
print AdminTask.help('SIBAdminCommands')
- 제공된 명령에 대한 개요 도움말을 보려면 다음 명령을 wsadmin 프롬프트에 입력하십시오.
print AdminTask.help('command_name')
명령을 사용한 후에는 다음 명령을 사용하여 변경사항을
마스터 구성에 저장하십시오.
AdminConfig.save()
목적
이 명령은 메시징 엔진의 특성을 수정합니다.
대상 오브젝트
메시징 엔진.
필수 매개변수
- -bus busname
- 버스 멤버가 구성되는 서비스 통합 버스의 이름입니다. listSIBuses 명령을 사용하여 기존 버스의 이름을 나열할 수 있습니다.
조건부 매개변수
- -node nodename -server servername
- 버스 멤버로 애플리케이션 서버에 대한 메시징 엔진의 특성을 변경하려면 서버가 실행되는 노드의 이름과 서버의 이름을 둘 다 지정하십시오.
- -cluster cluster
- 버스 멤버로 서버 클러스터에 대한 메시징 엔진의 특성을 변경하려면 클러스터의 이름을 지정하십시오.
- -engine enginename
- 버스 멤버가 단 하나의 메시징 엔진을 가지고 있는 경우, 엔진 이름을 지정하지 않아도 됩니다. 버스 멤버에 여러 메시징 엔진이 있는 경우 특성을 변경할 엔진의 이름을 지정해야 합니다.
선택적 매개변수
- -description text
- 관리 목적을 위한 메시징 엔진의 선택적 설명입니다.
- -initialState STARTED | STOPPED
- 초기 상태는 서버가 또는
서버 클러스터가 시작될 때 자동으로 시작되는지 여부를 판별합니다.
- 중지됨
- 연관된 애플리케이션 서버가 시작될 때 메시징 엔진이 중지되고 메시지를 처리할 수 없습니다.
- 시작됨
- 연관된 애플리케이션 서버가 시작될 때 메시징 엔진이 시작되고 메시지를 처리할 수 있습니다.
- -highMessageThreshold number
- 메시징 엔진이 해당 메시지 위치에 배치할 수 있는 메시지의
최대 총 수입니다.
메시징 엔진이 작성되면 버스의 메시지 최고 임계값을 사용하여 이 특성의 기본값을 설정합니다. 이 메시징 엔진에서 메시지 위치가 작성될 때, 이 특성의 값을 사용하여 메시지 위치에 대한 기본 값으로 높은 메시지 임계값을 설정합니다.
- -restrictLongDBLock TRUE | FALSE
- 활성 메시징 엔진이 데이터베이스의 SIBOWNER 테이블에 장기
실행 잠금을 유지해야 하는지 여부를 지정하는 매개변수입니다.
이 옵션을 선택하면 메시징 엔진이 짧은 기간에 대해서만 데이터베이스에 대해 잠금을 설정합니다. 데이터베이스에 반응하지 않는
활성 메시징 엔진의 이벤트에서, 활성 메시징 엔진은 짧은
지속 기간 잠금만 보유하기 때문에 대기 메시징 엔진이
데이터베이스의 소유권을 가질 수 있습니다. 이 매개변수는 다음 두 가지 값을 가집니다.
- TRUE
- 데이터베이스에 대한 장기 실행 잠금을 제한합니다.
- FALSE
- 데이터베이스에 대한 장기 실행 잠금을 제한하지 않습니다.
-dataStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
중요사항: 특성이 선택되는 경우에도 특성은 데이터베이스 테이블이 WebSphere® Application Server 버전 9.0 이상에 대한 sibDBUpgrade 명령을 사용하여 업그레이드될 때까지 적용되지 않습니다.
예제
wsadmin>AdminTask.showSIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 ]')
'{initialState=STARTED, targetGroups=[], name=node01.server1-bus1,
highMessageThreshold=50000, messageStoreType=FILESTORE, uuid=56F8FE11AB84188D,
busName=bus1, busUuid=6DF19B02BC879BD1}'
wsadmin>AdminTask.modifySIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 -initialState STOPPED ]')
wsadmin>AdminTask.showSIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 ]')
'{initialState=STOPPED, targetGroups=[], name=node01.server1-bus1,
highMessageThreshold=50000, messageStoreType=FILESTORE, uuid=56F8FE11AB84188D,
busName=bus1, busUuid=6DF19B02BC879BD1}'