createSIBDestinations 명령

createSIBDestinations 명령을 사용하여 서비스 통합 버스에 대한 새 버스 대상을 작성합니다.

명령을 실행하려면 wsadmin 스크립트 클라이언트AdminTask 오브젝트를 사용하십시오.

[IBM i][IBM i]wsadmin 스크립트 클라이언트는 Qshell에서 실행됩니다. . [IBM i]자세한 정보는 wsadmin 스크립트를 사용하여 WebSphere 스크립트를 실행하도록 Qshell 구성의 내용을 참조하십시오..

서비스 통합 버스에 대해 명령행 도움말이 제공됩니다.
  • Jython의 사용 가능한 서비스 통합 버스 명령 목록과 각 명령의 간단한 설명에 대해서는 wsadmin 프롬프트에 다음 명령을 입력하십시오.

    print AdminTask.help('SIBAdminCommands')

  • 제공된 명령에 대한 개요 도움말을 보려면 다음 명령을 wsadmin 프롬프트에 입력하십시오.

    print AdminTask.help('command_name')

명령을 사용한 후에는 다음 명령을 사용하여 변경사항을 마스터 구성에 저장하십시오.

AdminConfig.save()

목적

createSIBDestinations 명령은 특성이 모두 동일한 서비스 통합 버스에 대한 여러 새 버스 대상을 작성합니다. 작성된 대상이 별명 대상이면 모두 동일한 대상을 지정합니다. 이 명령으로 새 버스 대상이 WebSphere® MQ 서버 버스 멤버로 현지화될 수 있습니다.

대상 오브젝트

서비스 통합 버스

필수 매개변수

-bus
버스 대상을 작성할 서비스 통합 버스의 이름. 기존 버스 이름을 나열하려면 listSIBuses 명령을 사용합니다.
-nameList
관리 목적을 위해 이 대상을 알리는 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 명령을 사용하여 데이터베이스 테이블을 업그레이드할 때까지는 이 특성이 효력을 미치지 않습니다.

예제 1

  • Jython 사용:
    wsadmin>AdminTask.createSIBDestinations("[-bus bus1 -type QUEUE
    -cluster cluster1 -nameList [[-identifier myqueue1][-identifier myqueue2]]]")
    "(cells/9994GKCCell01/buses/bus1|sib-destinations.xml#SIBQueue_1098215169998)"
  • Jacl 사용:
    wsadmin>$AdminTask createSIBDestinations {-bus bus1 -type QUEUE 
    -cluster cluster1 -nameList {{myqueue1} {myqueue2}}}
    (cells/9994GKCCell01/buses/bus1|sib-destinations.xml#SIBQueue_1098215169998)

예제 2:

"MyAlias1""MyAlias2"와 같은 "MyDestination1"의 별명을 작성합니다. 이 별명 대상은 대상 목적지의 단일 큐 위치에 대한 액세스를 제공합니다.
  • Jython 사용:
    wsadmin>AdminTask.createSIBDestinations("[-bus bus1 -type ALIAS 
    -nameList [[MyAlias1][MyAlias2]] -aliasBus bus1 
    -targetName MyDestination1 -reliability INHERIT -maxReliability INHERIT 
    -overrideOfOQSByProducerAllowed INHERIT -sendAllowed INHERIT 
    -receiveAllowed INHERIT -queuePoints [[MyDestination1@cluster1.001-bus1]
    [MyDestination1@cluster1.002-bus1]]]")
  • Jacl 사용:
    wsadmin>set cluster [ lindex [ $AdminConfig list ServerCluster ] 1 ] 
    wsadmin>$AdminTask createSIBDestinations {-bus bus1 -type ALIAS 
    -nameList {{MyAlias1} {MyAlias2}} -aliasBus bus1 
    -targetName MyDestination1 -reliability INHERIT -maxReliability INHERIT 
    -overrideOfOQSByProducerAllowed INHERIT -sendAllowed INHERIT 
    -receiveAllowed INHERIT -queuePoints {{"MyDestination1@cluster1.001-bus1"} 
    {"MyDestination1@cluster1.002-bus1}}}

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



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