modifySIBDestination 명령
modifySIBDestination 명령을 사용하여 서비스 통합 버스의 버스 대상 특성을 변경할 수 있습니다.
명령을 실행하려면 wsadmin 스크립트 클라이언트의 AdminTask 오브젝트를 사용하십시오.
wsadmin 스크립트 클라이언트는 Qshell에서
실행됩니다. .
자세한 정보는 wsadmin 스크립트를 사용하여 WebSphere 스크립트를 실행하도록 Qshell 구성의 내용을 참조하십시오..
서비스 통합 버스에 대해 명령행 도움말이 제공됩니다.
- Jython의 사용 가능한 서비스 통합 버스 명령 목록과 각 명령의 간단한 설명에 대해서는
wsadmin 프롬프트에 다음 명령을 입력하십시오.
print AdminTask.help('SIBAdminCommands')
- 제공된 명령에 대한 개요 도움말을 보려면 다음 명령을 wsadmin 프롬프트에 입력하십시오.
print AdminTask.help('command_name')
명령을 사용한 후에는 다음 명령을 사용하여 변경사항을
마스터 구성에 저장하십시오.
AdminConfig.save()
목적
modifySIBDestination은 서비스 통합 버스의 버스 대상 특성을 변경합니다.
대상 오브젝트
버스 대상입니다.
필수 매개변수
- -bus
- 버스 대상이 구성되는 서비스 통합 버스의 이름입니다. listSIBuses 명령을 사용하여 기존 버스의 이름을 나열할 수 있습니다.
- -name
- 관리를 위해 이 대상을 식별하는 ID입니다.
조건부 매개변수
없음.
선택적 매개변수
- -description
- 관리를 위해 버스 대상에 대한 설명을 지정합니다.
- -reliability
- 생성자 애플리케이션에서 명시적 신뢰도가 설정되지 않은 경우에 이 대상에 대해 생성된 메시지에 지정할 기본 신뢰도 레벨을 지정합니다. 서비스 통합에서는 다음 5개의 신뢰도 레벨(전달 옵션 또는 서비스 품질이라고도 함)을 지원합니다.
- BEST_EFFORT_NONPERSISTENT
- 메시징 엔진이 중지하거나 실패할 때 메시지가 버려집니다. 메시지 전송에 사용된 연결이 사용 불가능하게 되거나 시스템 자원이 제한될 경우에도 메시지는 버려질 수 있습니다.
- EXPRESS_NONPERSISTENT
- 메시징 엔진이 중지하거나 실패할 때 메시지가 버려집니다. 메시지 전송에 사용된 연결이 사용 불가능하게 될 경우에도 메시지는 버려질 수 있습니다.
- RELIABLE_NONPERSISTENT
- 메시징 엔진이 중지하거나 실패할 때 메시지가 버려집니다.
- RELIABLE_PERSISTENT
- 메시지는 메시징 엔진이 실패할 때 버려질 수 있습니다.
- ASSURED_PERSISTENT
- 메시지가 버려지지 않습니다.
참고: 신뢰도 레벨이 높으면 성능에 미치는 영향도 커집니다.서비스 통합 신뢰도 레벨에 대한 자세한 정보는 메시지 신뢰성 레벨 - JMS 전달 모드 및 서비스 통합 서비스 품질(QoS)의 내용을 참조하십시오.
- -overrideOfQOSByProducerAllowed TRUE | FALSE
- 생성자와 대상 간의 메시지 플로우에 대한 서비스 품질을 제어합니다. 대상에 정의된 품질 대신 생성자가 지정한 서비스 품질을 사용하려면 이 옵션을 선택하십시오.
- -defaultPriority number
- -maxFailedDeliveries number
- 0 - 2147483647 범위의 값을 지정하십시오. 값 0(영)은 첫 번째 시도에서 메시지를 전달할 수 없는 경우 -exceptionDestination 매개변수가 정의한 대로 이 메시지를 예외 대상에 전달하거나 버립니다.
- -exceptionDestination value
- 기본적으로, 이 대상에 전달할 수 없는 메시지는 모두 이 대상이 지정된 메시징 엔진의
시스템 기본 예외 대상으로 다시 라우트됩니다(_SYSTEM.Exception.Destination.messaging_engine_name). 이 매개변수를 사용하여 기본값을 대체하십시오. 이 대상에 특정한 예외 대상을 설정하거나, 빈 문자열("")을 입력하여 전달할 수 없는 메시지가 예외 대상으로 라우트되지 않도록 지정할 수 있습니다. 이 경우, 실패한 최대 전달 수는 영향을 미치지 않습니다. 참고: 전달할 수 없는 메시지는 동일한 대상으로의 전달을 대기하는 다른 메시지의 처리를 막을 수 있습니다.
- 이 옵션을 사용하면서 예외 대상을 지정하지 않고 메시지 순서를 보존할 수 있습니다.
- -sendAllowed TRUE | FALSE
- 생성자가 이 대상에 메시지를 전송하지 못하도록 하려면 이 옵션을 선택 취소하십시오(FALSE로 설정).
- 비중개 대상의 큐 위치 또는 중개 대상의 중개 위치에서 이 옵션을 선택 취소하면 새 메시지가(접속한 생성자의 메시지 또는 다른 대상에서 전달된 메시지) 임의의 사용 가능한 메시지 위치로 경로 재지정됩니다. 사용 가능한 메시지 위치가 없는 경우 버스에 이미 허용된 메시지 및 접속한 생성자의 새 메시지는 메시지 위치가 사용 가능해질 때까지 버스에서 유지됩니다. 이에 대한 유일한 예외는 생성자가 같은 메시징 엔진에 접속하는 한 개의 메시지 위치(대상이 중개인지 또는 비중개인지에 따라 큐 위치 또는 중개 위치임)만 있는 대상의 경우입니다. 이 경우 각 전송 호출 시 예외 메시지가 생성됩니다. 예외 메시지는 전송에 대해 현존하는 로컬화만 사용 안함으로 설정되었음을 나타냅니다. 생성자는 평소와 같이 열린 상태로 유지되고 로컬화의 전송 허용 특성이 다시 선택되는 경우에(TRUE로 재설정됨) 추가 전송 호출에 성공합니다.
- 중개 대상의 큐 위치에 대해서 이 옵션을 선택 취소하면 중개 인스턴스로부터의 메시지가 임의의 사용 가능한 메시지 위치로 경로 재지정됩니다. 사용 가능한 메시지 위치가 없는 경우 메시지 위치가 사용 가능해질 때까지 메시지는 버스에 의해 유지됩니다. 중개 인스턴스(즉, 중개 위치가 있는 모든 서버에서)에 대해서는 같은 서버가 큐 위치를 호스팅하고 해당 큐 위치가 대상의 유일한 큐 위치인 경우 중개가 "오류 시 중지됨" 상태로 변경됩니다.
- -receiveAllowed TRUE | FALSE
- 메시지 위치에 대해서는 이 옵션을 선택 취소하면 열린 이용자가 상태를 변경하고 이용자가 메시지를 요청하는 경우 예외가 생성됩니다. 메시지는 계속해서 전송되어 메시지 위치에 누적될 수 있습니다.
- -receiveExclusive TRUE | FALSE
- 한 명의 이용자만 대상에 접속을 허용하려면 이 옵션을 선택하십시오(true로 설정). 이 옵션을 선택하는 경우 단일 이용자만 임의의 시간에 큐 대상의 각 큐 위치에 접속할 수 있습니다. 이용자가 이미 접속한 큐 위치에 후속으로 접속을 시도하는 이용자는 거부됩니다.
- -maintainStrictMessageOrder TRUE | FALSE
- 생성자가 대상에 메시지를 전송하는 순서를 유지하려면 이 옵션을 선택하십시오(TRUE로 설정).
- 런타임 시 이 특성은 다른 구성 특성 값에 대해 우선순위를 가집니다. 런타임 시 대체되는 구성 특성에 대한 정보는 버스 대상의 엄격한 메시지 순서의 내용을 참조하십시오. 참고: 기존 주제 대상에서 엄격한 메시지 순서 지정이 사용으로 설정되는 경우에 연관된 메시지와 함께 기존 지속 가능한 등록은 올바르지 않은 상태가 됩니다. 엄격한 메시지 순서 지정을 사용하고 환경이 다시 시작되면 기존 지속 가능한 등록이 삭제된 후 재작성됩니다. 지속 가능한 등록과 연관된 메시지도 삭제됩니다.
- -topicAccessCheckRequired
- 주제에 대한 액세스에 대해 권한 확인 이 필요한 경우 이 옵션을 포함시키십시오.
- -replyDestination
- 이 특성은 응답 메시지에 대한 중개에 사용하기 위한 특성입니다. 이 특성의 사용에 대한 자세한 정보는 대상 역방향 라우팅 경로 구성의 내용을 참조하십시오.
- -replyDestinationBus
- 응답 대상이 구성되는 버스의 이름입니다. 이 특성은 응답 메시지에 대한 중개에 사용하기 위한 특성입니다. 이 특성의 사용에 대한 자세한 정보는 대상 역방향 라우팅 경로 구성의 내용을 참조하십시오.
- -delegateAuthorizationCheckToTarget
- 목표 대상에 대한 권한 확인이 수행되도록 하려는 경우 이 옵션을 포함시키십시오.
- -auditAllowed TRUE | FALSE
- 버스 및 애플리케이션 서버에서 감사가 사용으로 설정된 경우 버스가 주제 레벨 권한 확인에 대한 감사를 하지 못하도록 하려면 이 옵션을 선택 취소하십시오(FALSE로 설정). 기본값은 TRUE입니다. 이 매개변수를 사용하려면 감사 관리자 권한이 있어야 합니다. 다른 유형의 대상을 작성하는 데 사용되는 경우 이 매개변수는 무시됩니다.
- -defaultForwardRoutingPath
- 메시지에 전달 라우팅 경로가 없는 경우 메시지 전달 라우팅 경로가 설정되는 값입니다. 이 매개변수는 메시지가 목표 버스 대상에 도달하기 위해 통과해야 하는 중간 버스 대상의 순차적 목록을 식별합니다. 이 필드의 형식은 bus_name:destination_name으로 지정되는 버스 대상 목록입니다.
- -queuePoints
- 별명 대상의 사용자가 사용하는 큐 위치의 목록입니다.
특정 큐 위치가 제공되지 않는 경우 모든 큐 위치를 사용할 수 있습니다. 목표 대상은
별명 대상 정의와 같은 버스에 있는 큐 대상이어야 합니다. 목표 대상은 또한
다중 큐 위치를 포함하는 큐 대상이어야 합니다.
큐 위치는 다음과 같은 양식으로 지정됩니다. destination_name@messaging_engine_name
- -useAllQueuePoints TRUE | FALSE
- 이 옵션을 TRUE로 설정하면 사용 가능한 모든 큐 위치가 사용되는 반면 이 옵션을 FALSE로 설정하면 -queuePoints 옵션에서 지정된 목록에 있는 큐 위치만 사용됩니다.
- -mediationPoints
- 별명 대상의 사용자가 사용하는 중개 위치의 목록입니다.
특정 중개 위치가 제공되지 않는 경우 모든 중개 위치를 사용할 수 있습니다. 목표 대상은
별명 대상 정의와 같은 버스에 있는 중개 큐 대상이어야 합니다. 목표 대상은 또한
다중 중개 위치를 포함하는 큐 대상이어야 합니다.
중개 위치는 다음과 같은 양식으로 지정됩니다. destination_name@messaging_engine_name
- -useAllMediationPoints TRUE | FALSE
- 이 옵션을 TRUE로 설정하면 사용 가능한 모든 큐 위치가 사용되는 반면 이 옵션을 FALSE로 설정하면 -mediationPoints 옵션에서 지정된 목록에 있는 큐 위치만 사용됩니다.
- -persistRedeliveryCount TRUE | FALSE
- 메시지 저장소에서 JMS 메시지의 실패한 전달 계수를 계속하려면 이 옵션을 선택하십시오(TRUE로 설정). 이 옵션의 값은
기본적으로 FALSE로 설정됩니다. 중요사항: 이 특성을 선택했더라도 이 특성은 데이터베이스 테이블이 WebSphere® Application Server 버전 9.0 이상에 대해 sibDBUpgrade 명령을 사용하여 업그레이드될 때까지 적용되지 않습니다.
예제
- Jython 사용:
wsadmin>AdminTask.showSIBDestination(["-bus", "abus", "-name", "myqueue"]) "{receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=true, identifier=myqueue}" wsadmin>AdminTask.modifySIBDestination(["-bus", "abus", "-name", "myqueue", "-receiveAllowed", "FALSE"]) wsadmin>AdminTask.showSIBDestination(["-bus", "abus", "-name", "myqueue"]) "{receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=false, identifier=myqueue}"
- Jacl 사용:
wsadmin>$AdminTask showSIBDestination {-bus abus -name myqueue} {receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=true, identifier=myqueue} wsadmin>$AdminTask modifySIBDestination {-bus abus -name myqueue -receiveAllowed FALSE} (cells/9994GKCCell01/buses/abus|sib-destinations.xml#SIBQueue_1098215169998) wsadmin>$AdminTask showSIBDestination {-bus abus -name myqueue} {receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=false, identifier=myqueue}
예제: 사용 가능한 큐 위치 및 중개 위치의 서브세트를 사용하기 위해 대상 별명 "MyAlias2"를 수정합니다.
- Jython 사용:
cluster=AdminConfig.list("ServerCluster").splitlines()[0] Qp1=AdminConfig.list("SIBQueueLocalizationPoint" , cluster).splitlines()[0] Mp1=AdminConfig.list("SIBMediationLocalizationPoint").splitlines()[0] AdminTask.modifySIBDestination(["-bus" , "bus1" , "-name" , "MyAlias2", "-queuePoints", [[Qp1]], "-mediationPoints" , [[Mp1]]])
- Jacl 사용:
set cluster [ lindex [ $AdminConfig list ServerCluster ] 1 ] set Qp1 [ lindex [ $AdminConfig list SIBQueueLocalizationPoint $cluster ] 0 ] set Mp1 [ lindex [ $AdminConfig list SIBMediationLocalizationPoint ] 0 ] $AdminTask modifySIBDestination {-bus bus1 -name MyAlias2 -queuePoints [[$Qp1]]-mediationPoints [[$Mp1]]}
예제: 사용되는 큐 위치에 대한 제한사항을 제거하기 위해 대상 별명을 수정합니다.
- Jython 사용:
AdminTask.modifySIBDestination(["-bus" , "bus1" , "-name" , "MyAlias2", "-queuePoints", [[]]])
- Jacl 사용:
$AdminTask modifySIBDestination {-bus bus1 -name MyAlias2 -useAllQueuePoints=true -useAllMediationPoints=true}