modifySIBLink 명령
서비스 통합 버스 링크의 특성을 수정하려면 modifySIBLink 명령을 사용하십시오.
명령을 실행하려면 wsadmin 스크립트 클라이언트의 AdminTask 오브젝트를 사용하십시오.
wsadmin 스크립트 클라이언트는 Qshell에서
실행됩니다. .
자세한 정보는 wsadmin 스크립트를 사용하여 WebSphere 스크립트를 실행하도록 Qshell 구성의 내용을 참조하십시오..
- Jython의 사용 가능한 서비스 통합 버스 명령 목록과 각 명령의 간단한 설명에 대해서는
wsadmin 프롬프트에 다음 명령을 입력하십시오.
print AdminTask.help('SIBAdminCommands')
- 제공된 명령에 대한 개요 도움말을 보려면 다음 명령을 wsadmin 프롬프트에 입력하십시오.
print AdminTask.help('command_name')
AdminConfig.save()
목적
modifySIBLink 명령은 서비스 통합 버스 링크의 특성을 수정합니다.
대상 오브젝트
없음.
필수 매개변수
- -bus
- 서비스 통합 버스 링크를 수정하려는 서비스 통합 버스의 이름입니다. listSIBuses 명령을 사용하여 기존 버스의 이름을 나열할 수 있습니다.
- -messagingEngine
- 서비스 통합 버스 링크를 수정하려는 메시징 엔진의 이름입니다. 서비스 통합 버스 링크는 메시징 엔진을 다른 서비스 통합 버스의 다른 메시징 엔진에 연결하므로 두 서비스 통합 버스 간의 브릿지를 제공합니다.
- -name
- 서비스 통합 버스 링크가 알려지기 원하는 이름입니다.
- -foreignBusName
- 서비스 통합 버스 링크에 대한 원격 서비스 통합 버스를 정의하는 외부 버스의 이름입니다. listSIBForeignBuses 명령을 사용하여 기존 외부 버스의 이름을 나열할 수 있습니다.
조건부 매개변수
없음.
선택적 매개변수
- -bootstrapEndpoints
- 이 특성은 JMS 연결 팩토리 설정의 제공자
엔드포인트 특성과 같은 방식으로 설정됩니다. 자세한 정보는 기본값이 아닌 부트스트랩 서버에 대한 연결 구성의 부트스트랩 엔드포인트 설정과 관련된 단계를 참조하십시오.
부트스트랩 엔드포인트에 대한 포트는 외부 버스의 대상 애플리케이션 서버에 구성되는 SIB 엔드포인트 주소에 정의되는 포트입니다.
- -remoteMessagingEngineName
- -description
- 관리를 위한 버스의 선택적 설명입니다.
- -protocolName
전송 체인 이름은 대상 메시징 엔진이 호스팅되는 서버에 정의된 전송 체인 이름이어야 합니다.
- -authAlias
J2C 인증 별명은 미리 정의해야 합니다.
- -exceptionDestination
- 서비스 통합 버스 링크가 목표 대상이나
해당 목표 대상에 구성되는 예외 대상으로 메시지를
전달할 수 없을 때 또는 목표 대상이 존재하지 않을 때
인바운드 메시지에 대한 대상입니다.
- 시스템
- 서비스 통합 버스 링크는 기본 예외 대상을 사용합니다. 버스 대상으로 전달될 수 없는 모든 메시지는 이 링크가 지정되는 메시징 엔진에 대한 시스템 기본 예외 대상인 _SYSTEM.Exception.Destination.messaging_engine_name으로 자동으로 경로 재지정됩니다.
- 없음
- 서비스 통합 버스 링크에 예외 대상이 없습니다. 전달할 수 없는 메시지가 예외 대상으로 경로 재지정되지 않고 동일한 대상으로의 전달을 기다리는 기타 메시지의 처리를 차단할 수 있습니다. 이 옵션을 사용하여 메시지 순서 지정을 유지할 수 있습니다.
- 지정
- 서비스 통합 버스 링크가 여기에 지정된 예외 대상을 사용합니다. 이것이 가능하지 않으면 시스템 예외 대상을 사용합니다.
- -initialState Started | Stopped
- 메시징 엔진이 시작될 때 링크가 자동으로 시작되는지
여부를 표시하는 게이트웨이 링크의 상태입니다.
Information 값 Default 시작됨 범위 - 중지됨
- 연관된 메시징 엔진이 시작되면 게이트웨이 링크가 중지됨 상태가 되어 연결에 대한 새 요청을 처리할 수 없습니다.
- 시작됨
- 연관된 메시징 엔진이 시작되면 게이트웨이 링크가 시작됨 상태가 되어 연결에 대한 새 요청을 처리할 수 있습니다.
- -preferLocal TRUE | FALSE
- 링크가 사용 가능한 경우 링크와 동일한 메시징
엔진에 위치하는 목표 대상의 큐 위치로 수신 메시지를
전송하길 원하는지 여부를 표시합니다. 링크는 WebSphere® Application
Server 버전 7.0 이상 서버에서 실행 중인
메시징 엔진의 소유여야 합니다.
이 옵션은 WebSphere Application Server버전 7.0 이상 서버 또는 클라이언트에서 실행되는 JMS 애플리케이션에서 사용되거나 WebSphere Application Server버전 7.0 이상 서버에서 실행 중인 메시징 엔진에 연결될 때만 지원됩니다. 이전 버전의 WebSphere Application Server에서 사용하면 애플리케이션에 예외가 발생합니다.
Information 값 Default TRUE 범위 - TRUE
- 사용 가능한 경우 링크와 동일한 메시징 엔진에 위치하는 목표 대상의 큐 위치로 수신 메시지를 전송합니다.
- FALSE
- 목표 대상의 임의의 큐 위치로 수신 메시지를 전송합니다.
예제
wsadmin>AdminTask.showSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1 -sibLink
mySIBLink]')
'{bootstrapEndpoints=host1:1111:chain1, protocolName=null, authAlias=null,
preferLocalQueuePoints=true, name=mySIBLink, uuid=34647E59163B253D,
remoteMessagingEngineName=node02.server2-bus2, description=null,
targetUuid=BAD49BA75CD36D740E366978, initialState=STARTED,
exceptionDestination=$DEFAULT_EXCEPTION_DESTINATION}'
wsadmin>AdminTask.modifySIBLink('[-bus bus1 -messagingEngine node01.server1-bus1
-name MySIBLink -foreignBusName -bus2
-bootstrapEndpoints anotherhost:2222:BootstrapBasicMessaging]')
wsadmin>AdminTask.showSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1 -sibLink
mySIBLink]')
'{bootstrapEndpoints=anotherhost:2222:BootstrapBasicMessaging, protocolName=null,
authAlias=null, preferLocalQueuePoints=true, name=mySIBLink, uuid=34647E59163B253D,
remoteMessagingEngineName=node02.server2-bus2, description=null,
targetUuid=BAD49BA75CD36D740E366978, initialState=STARTED,
exceptionDestination=$DEFAULT_EXCEPTION_DESTINATION}'
사용할 큐 위치에 대한 환경 설정이 없도록 서비스 통합 버스 링크를 수정하십시오.
AdminTask.modifySIBLink('[-bus bus1 -messagingEngine cluster1.000-bus1 -name MyLink
-foreignBusName -FB1 bootstrapEndpoints host1:1111:chain1 -remoteMessagingEngineName
-cluster2.000-FB1 -preferLocal FALSE]')