createSIBDestination 명령
createSIBDestination 명령을 사용하여 서비스 통합 버스에 대한 새 버스 대상을 작성합니다.
명령을 실행하려면 wsadmin 스크립트 클라이언트의 AdminTask 오브젝트를 사용하십시오.
wsadmin 스크립트 클라이언트는 Qshell에서
실행됩니다. .
자세한 정보는 wsadmin 스크립트를 사용하여 WebSphere 스크립트를 실행하도록 Qshell 구성의 내용을 참조하십시오..
- Jython의 사용 가능한 서비스 통합 버스 명령 목록과 각 명령의 간단한 설명에 대해서는
wsadmin 프롬프트에 다음 명령을 입력하십시오.
print AdminTask.help('SIBAdminCommands')
- 제공된 명령에 대한 개요 도움말을 보려면 다음 명령을 wsadmin 프롬프트에 입력하십시오.
print AdminTask.help('command_name')
AdminConfig.save()
목적
createSIBDestination 명령은 서비스 통합 버스에 대한 새 버스 대상을 작성합니다. 이 명령으로 메시징 대상을 WebSphere® MQ 서버 버스 멤버로 현지화할 수 있습니다.
대상 오브젝트
서비스 통합 버스
필수 매개변수
- -bus
- 버스 대상을 작성할 서비스 통합 버스의 이름. 기존 버스 이름을 나열하려면 listSIBuses 명령을 사용합니다.
- -name
- 관리 목적을 위해 이 대상이 알려지는 ID
- -type
- 작성할 버스 대상 유형을 표시합니다.
- 별명
- 메시지를 보유하는 기본 대상 버스 목적지와 애플리케이션 사이의 추상 레벨을 제공하는 별명 대상. 애플리케이션이 별명 대상과 상호 작용하므로 애플리케이션을 변경하지 않아도 대상 버스 목적지를 변경할 수 있습니다.
- 외부
- 다른 버스의 대상을 식별하는 외부 대상으로, 이를 통해 한 버스의 애플리케이션이 다른 버스의 대상에 직접 액세스할 수 있습니다.
- 포트
- 외부에 호스트된 대상 웹 서비스와 통신하는 아웃바운드 서비스에 대한 특정 메시지 및 전송 바인딩을 표시합니다.
- 큐
- 지점간 메시징에 대한 큐.
- TopicSpace
- 공개/등록 메시징에 대한 토픽 영역.
- WebService
- 외부에 호스트된 대상 웹 서비스를 나타냅니다.
조건부 매개변수
없음.
선택적 매개변수
- -cluster
- 클러스터 버스 멤버에 버스 대상을 지정하려면 클러스터 이름을 지정합니다. -node, -server 또는 -wmqServer 매개변수는 지정하지 마십시오.
- -node
- 서버 버스 멤버에 버스 대상을 지정하려면 서버가 실행되는 노드 이름과 서버 이름을 지정합니다. -cluster 또는 -wmqServer 매개변수는 지정하지 마십시오.
- -server
- 서버 버스 멤버에 버스 대상을 지정하려면 서버가 실행되는 노드 이름과 서버 이름을 지정합니다. -cluster 또는 -wmqServer 매개변수는 지정하지 마십시오.
- -wmqServer
- IBM MQ 큐에 버스 대상을 지정하려면 대상이 지정된 WebSphere MQ 서버 버스 멤버 이름(이 매개변수) 및 대상에 보낸 메시지를 저장하는 데 사용되는 IBM MQ 큐 이름( -wmqQueueName 매개변수)을 지정합니다. -wmqServer 매개변수를 WebSphere MQ 서버를 작성할 때 지정한 이름으로 설정합니다. -wmqQueueName 매개변수를 IBM MQ 관리에서 IBM MQ 큐에 할당한 이름으로 설정합니다. -cluster, -node 또는 -server 매개변수는 지정하지 마십시오.
- -aliasBus
- 별명 대상을 작성하는 경우 별명 맵핑의 소스 버스 이름을 지정합니다.
- -targetBus
- 별명 대상을 작성하는 경우 별명 대상이 맵핑된 버스 이름을 지정합니다.
- -targetName
- 별명 대상을 작성하는 경우 별명 대상이 맵핑된 대상 이름을 지정합니다.
- -foreignBus
- 외부 대상을 작성하는 경우 외부 버스 이름을 지정합니다.
- -description
- 관리 목적을 위한 버스 대상의 설명을 지정합니다.
- -reliability
- 생성자 애플리케이션에 의해 명시적 신뢰성이 설정되지 않은 경우
이러한 대상에 생성된 메시지에 지정할 기본 신뢰성 레벨을 지정합니다. 서비스 통합에서는 다음 5개의 신뢰도 레벨(전달 옵션 또는 서비스 품질이라고도 함)을 지원합니다.
- BEST_EFFORT_NONPERSISTENT
- 메시징 엔진이 중지하거나 실패할 때 메시지가 버려집니다. 메시지 전송에 사용된 연결이 사용 불가능하게 되거나 시스템 자원이 제한될 경우에도 메시지는 버려질 수 있습니다.
- EXPRESS_NONPERSISTENT
- 메시징 엔진이 중지하거나 실패할 때 메시지가 버려집니다. 메시지 전송에 사용된 연결이 사용 불가능하게 될 경우에도 메시지는 버려질 수 있습니다.
- RELIABLE_NONPERSISTENT
- 메시징 엔진이 중지하거나 실패할 때 메시지가 버려집니다.
- RELIABLE_PERSISTENT
- 메시지는 메시징 엔진이 실패할 때 버려질 수 있습니다.
- ASSURED_PERSISTENT
- 메시지가 버려지지 않습니다.
참고: 신뢰도 레벨이 높으면 성능에 미치는 영향도 커집니다.서비스 통합 신뢰도 레벨에 대한 자세한 정보는 메시지 신뢰성 레벨 - JMS 전달 모드 및 서비스 통합 서비스 품질(QoS)의 내용을 참조하십시오.
- -maxReliability
- 생성자 애플리케이션에서 지정한 값으로 허용되는 최대 신뢰도 레벨을 지정합니다. 서비스 통합에서는 다음 5개의 신뢰도 레벨(전달 옵션 또는 서비스 품질이라고도 함)을 지원합니다.
- BEST_EFFORT_NONPERSISTENT
- EXPRESS_NONPERSISTENT
- RELIABLE_NONPERSISTENT
- RELIABLE_PERSISTENT
- ASSURED_PERSISTENT
서비스 통합 신뢰도 레벨에 대한 자세한 정보는 메시지 신뢰성 레벨 - JMS 전달 모드 및 서비스 통합 서비스 품질(QoS)의 내용을 참조하십시오.
- -nonPersistentReliability
IBM MQ 네트워크에서 서비스 통합이 수신하는 비지속적 IBM MQ 메시지와 함께 사용할 서비스 통합 QoS를 지정합니다. IBM MQ 네트워크에 있는 메시지에는 자체 서비스 품질 레벨이 있습니다. 이러한 레벨은 지속적 또는 비지속적입니다. 이러한 메시지가 서비스 통합 애플리케이션에서 수신되면 이 메시지에는 해당 IBM MQ 서비스 품질 레벨에 따라 다른 서비스 통합 서비스 품질 레벨이 지정됩니다.
비지속적 IBM MQ 메시지가 수신되면 기본 서비스 통합 QoS는 RELIABLE_NONPERSISTENT입니다. 이 기본값을 대체하려는 경우 기타 비지속적 서비스 통합 QoS BEST_EFFORT_NONPERSISTENT 또는 EXPRESS_NONPERSISTENT 중 하나를 선택할 수 있습니다. 그러나 다음 5개의 가능한 서비스 통합 서비스 품질 중에서 선택할 수도 있습니다.- BEST_EFFORT_NONPERSISTENT
- EXPRESS_NONPERSISTENT
- RELIABLE_NONPERSISTENT
- RELIABLE_PERSISTENT
- ASSURED_PERSISTENT
자세한 정보는 JMS 전달 옵션 및 메시지 신뢰성과 IBM MQ 지속성 값 사이의 맵핑의 내용을 참조하십시오.
- -persistentReliability
IBM MQ 네트워크에서 서비스 통합이 수신하는 지속적 IBM MQ 메시지와 함께 사용할 서비스 통합 QoS를 지정합니다. IBM MQ 네트워크에 있는 메시지에는 자체 서비스 품질 레벨이 있습니다. 이러한 레벨은 지속적 또는 비지속적입니다. 이러한 메시지가 서비스 통합 애플리케이션에서 수신되면 이 메시지에는 해당 IBM MQ 서비스 품질 레벨에 따라 다른 서비스 통합 서비스 품질 레벨이 지정됩니다.
지속적 IBM MQ 메시지가 수신되면 기본 서비스 통합 QoS는 ASSURED_PERSISTENT입니다. 이 기본값을 대체하려는 경우 기타 지속적 서비스 통합 QoS RELIABLE_PERSISTENT를 선택할 수 있습니다. 그러나 다음 5개의 가능한 서비스 통합 서비스 품질 중에서 선택할 수도 있습니다.- BEST_EFFORT_NONPERSISTENT
- EXPRESS_NONPERSISTENT
- RELIABLE_NONPERSISTENT
- RELIABLE_PERSISTENT
- ASSURED_PERSISTENT
자세한 정보는 JMS 전달 옵션 및 메시지 신뢰성과 IBM MQ 지속성 값 사이의 맵핑의 내용을 참조하십시오.
- -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
- 대상 목적지에서 권한 부여 검사를 수행하려는 경우 이 옵션을 포함합니다.
- -wmqQueueName
- IBM MQ 큐에 버스 대상을 지정하려면 대상이 지정된 WebSphere MQ 서버 버스 멤버 이름(-wmqServer 매개변수) 및 대상에 보낸 메시지를 저장하는 데 사용되는 IBM MQ 큐 이름(이 매개변수)을 지정합니다. -wmqServer 매개변수를 WebSphere MQ 서버를 작성할 때 지정한 이름으로 설정합니다. -wmqQueueName 매개변수를 IBM MQ 관리에서 IBM MQ 큐에 할당한 이름으로 설정합니다. -cluster, -node 또는 -server 매개변수는 지정하지 마십시오.
- -useRFH2 or -mqRfh2Allowed TRUE | FALSE
- 대상에 보낸 메시지가 MQRFH2 헤더에 있는지 여부를 판별합니다.
- 서비스 통합이 서비스 통합 형식에서 IBM MQ 형식으로 메시지를 변환하면, 기본적으로 IBM MQ 메시지에 MQRHF2 헤더를 포함합니다. 이 헤더는 IBM MQ 메시지 속성이 아닌 메시지 속성(예: JMS 메시지 속성)을 포함하기 때문에 IBM MQ 메시지 디스크립터(MQMD)에는 나타나지 않습니다. 일부 IBM MQ 애플리케이션은 MQRFH2 헤더를 포함하는 메시지를 처리할 수 없습니다. 이 대상으로 전송된 메시지가 MQRFH2를 허용할 수 없는 IBM MQ 애플리케이션에 의해 처리될 경우, 이 옵션을 선택 취소합니다(FALSE로 설정).
- WebSphere MQ 서버 버스 멤버에 큐 유형 대상을 지정하는 경우 -useRFH2 매개변수를 사용합니다. 별명 대상 또는 외부 별명을 작성하는 경우 -mqRfh2Allowed 매개변수를 사용합니다.
- -auditAllowed TRUE | FALSE
- 버스 및 애플리케이션 서버에서 감사를 사용하는 경우 버스에서 토픽 레벨 권한 부여 검사를 감사하지 않으려면 이 옵션을 선택 취소합니다(FALSE로 설정). 기본값은 TRUE입니다. 이 매개변수를 사용하려면 감사 관리자 권한이 필요합니다. 대상의 다른 유형 작성에 사용되는 경우 매개변수는 무시됩니다.
- -defaultForwardRoutingPath
- 메시지에 전방향 라우팅 경로가 없는 경우 메시지의 전방향 라우팅 경로에 설정할 값. 이는 대상 버스 목적지에 도달하기 위해 메시지가 전달해야 하는 매개체 버스 목적지의 순차 목록을 식별합니다. 필드 형식은 bus_name:destination_name으로 지정된 버스 대상의 목록입니다.
- -queuePoints
- 별명 대상의 사용자가 사용하는 큐 위치의 목록.
특정 큐 위치를 제공하지 않으면 모든 큐 위치를 사용할 수 있습니다. 대상 목적지는 별명 목적지 정의와 동일한 버스의 큐 대상이어야
합니다. 또한 대상 목적지는 큐 위치가 여러 개인 큐 대상이기도 합니다.
큐 위치는 다음 양식으로 지정됩니다. destination_name@messaging_engine_name
- -mediationPoints
- 별명 대상의 사용자가 사용하는 중개 위치의 목록.
특정 중개 위치를 제공하지 않으면 모든 중개 위치를 사용할 수 있습니다. 대상 목적지는 별명 목적지 정의와 동일한 버스의 중개된 큐 대상이어야
합니다. 또한 대상 목적지는 중개 위치가 여러 개인 큐 대상이기도 합니다.
중개 위치는 다음 양식으로 지정됩니다. destination_name@messaging_engine_name
- -persistRedeliveryCount TRUE | FALSE
- 메시지 저장소에 JMS 메시지의
실패한 전달 개수를 유지하려면 이 옵션을 선택합니다(TRUE로
설정). 옵션 값은
기본적으로 FALSE로 설정됩니다. 중요사항: 이 특성을 선택하더라도 WebSphere Application Server 버전 9.0 이상에서 sibDBUpgrade 명령을 사용하여 데이터베이스 테이블을 업그레이드할 때까지는 이 특성이 효력을 미치지 않습니다.
예제
- Jython 사용:
wsadmin>AdminTask.createSIBDestination("[-bus bus1 -name myqueue -type QUEUE -node node1 -server server1]") "(cells/9994GKCCell01/buses/bus1|sib-destinations.xml#SIBQueue_1098215169998)"
- Jacl 사용:
wsadmin>$AdminTask createSIBDestination {-bus bus1 -name myqueue -type QUEUE -node node1 -server server1} (cells/9994GKCCell01/buses/bus1|sib-destinations.xml#SIBQueue_1098215169998)
예: 두 개의 큐 위치를 사용할 수 있는 "MyAlias1"라고 하는 "MyDestination1"에 대한 대상 별명을 작성합니다.
- Jython 사용:
wsadmin>AdminTask.createSIBDestination("[-bus bus1 -type ALIAS -name MyAlias1 -aliasBus bus1 -targetName MyDestination1 -reliability INHERIT -maxReliability INHERIT -overrideOfQOSByProducerAllowed INHERIT -sendAllowed INHERIT -receiveAllowed INHERIT -queuePoints [[MyDestination1@cluster1.001-bus1] [MyDestination1@cluster1.002-bus1]]]")
- Jacl 사용:
wsadmin>$AdminTask createSIBDestination {-bus bus1 -type ALIAS -name MyAlias1 -aliasBus bus1 -targetName MyDestination1 -reliability INHERIT -maxReliability INHERIT -overrideOfQOSByProducerAllowed INHERIT -sendAllowed INHERIT -receiveAllowed INHERIT -queuePoints {{"MyDestination1@cluster1.001-bus1"} {"MyDestination1@cluster1.002-bus1"}}}