createSIBMQLink 명령

createSIBMQLink 명령을 사용하여 지정된 서비스 통합 버스에 대한 새 IBM MQ 링크를 작성합니다.

명령을 실행하려면 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()

목적

createSIBMQLink 명령은 지정된 서비스 통합 버스에 대한 새 IBM MQ 링크를 작성합니다. IBM MQ 링크는 IBM MQ에 큐 관리자로 메시징 엔진을 연결합니다. 따라서 서비스 통합 버스와 IBM MQ 네트워크 사이에서 브릿지를 제공합니다.

대상 오브젝트

버스.

필수 매개변수

-bus
IBM MQ 링크를 작성하려는 서비스 통합 버스의 이름. listSIBuses 명령을 사용하여 기존 버스 이름을 나열할 수 있습니다.
-messagingEngine
IBM MQ 링크를 작성하려는 메시징 엔진의 이름. IBM MQ 링크는 IBM MQ에 큐 관리자로 메시징 엔진을 연결합니다. 따라서 서비스 통합 버스와 IBM MQ 네트워크 사이에서 브릿지를 제공합니다.
-name
IBM MQ 링크를 알릴 이름.
-foreignBusName
IBM MQ 링크에 대한 IBM MQ 네트워크를 정의하는 외부 버스의 이름입니다. listSIBForeignBuses 명령을 사용하여 기존 외부 버스의 이름을 나열할 수 있습니다.
-queueManagerName
메시징 엔진을 원격 IBM MQ 네트워크에 알리며, 메시징 엔진과 연관된 가상 큐 관리자의 이름.

큐 관리자 이름은 IBM MQ 이름 지정 규칙을 준수해야 합니다. 예를 들어 이름은 최대 48자여야 합니다.

-senderChannelTransportChain OutboundBasicMQLink | OutboundSecureMQLink
게이트웨이 큐 관리자로 메시지를 전송하는 송신자 채널 이름. 송신자 채널은 게이트웨이 큐 관리자의 IBM MQ 수신자 채널과 통신하며 서비스 통합 버스 메시지를 MQ 형식 메시지로 변환합니다.

조건부 매개변수

없음.

선택적 매개변수

IBM MQ 링크 구성 매개변수:
-description
관리 목적을 위한 버스에 대한 선택적 설명.
-exceptionDestination
IBM MQ 링크가 메시지를 해당 대상 버스 목적지 또는 해당 대상 목적지에 대해 구성되는 예외 목적지에 전달할 수 없거나 대상 목적지가 존재하지 않는 경우 인바운드 메시지의 목적지입니다.
시스템
IBM MQ 링크는 기본 예외 목적지를 사용합니다. 버스 대상에 전달할 수 없는 모든 메시지는 이 링크가 _SYSTEM.Exception.Destinationmessaging_engine_name으로 지정된 메시징 엔진의 시스템 기본 예외 대상으로 자동 라우팅됩니다.
없음
IBM MQ 링크에는 예외 목적지가 없습니다. 전달할 수 없는 메시지는 예외 목적지로 라우팅되지 않으며 해당 링크를 통해 동일한 버스에 전달되도록 대기하는 다른 메시지의 처리를 차단할 수 있습니다. 이 옵션은 메시지 순서를 보존하는 데 사용될 수 있습니다.
지정
IBM MQ 링크는 여기에 지정된 예외 목적지를 사용합니다. 불가능한 경우 시스템 예외 대상을 사용합니다.
-batchSize

일괄처리 크기는 이 링크의 송신자 및 수신자 채널이 메시지를 전송하는 방식에 영향을 주지 않습니다. 메시지는 항상 개별적으로 전송되지만, 일괄처리로 커미트되거나 되돌려집니다.

일괄처리 크기 선택에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 절에서 일괄처리 크기BATCHSZ) 특성에 대한 설명을 참조하십시오.

정보
기본값 50
범위 1 - 9999
-maxMsgSize

적절한 크기 선택에 대한 정보는 IBM MQ Information Center의 상호 통신 절에서 최대 메시지 길이(MAXMSGL) 특성에 대한 설명을 참조하십시오.

정보
기본값 4194304바이트(4MB)
범위 0 - 104857600

대상 큐 관리자가 허용할 가장 큰 값을 사용하려면 0을 지정합니다.

-heartBeat

하트비트로 수신 중인 채널에서 채널 연결 작업을 중지할 수 있습니다.

이 특성 값 선택에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 절을 참조하십시오.

정보
기본값 300
범위 0 - 999999
-sequenceWrap
예를 들어 1000 값을 지정하면 메시지 순서 번호가 1001에 도달할 때 1부터 다시 시작됩니다.

이 특성 값 선택에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 절에서 순서 번호 랩(SEQWRAP) 특성에 대한 설명을 참조하십시오.

정보
기본값 999999999
범위 1 - 999999999
-nonPersistentMessageSpeed Fast | Normal
정보
기본값 빠름
범위
빠름
전송 장애가 있거나 메시지 전송 중 채널이 중지할 경우 비지속적 메시지가 유실될 수 있습니다.
보통
전송 장애가 있거나 메시지 전송 중 채널이 중지할 경우에도 비지속적 메시지는 유실되지 않습니다.
-adoptable True | False
IBM MQ 링크 수신자 채널(이 IBM MQ 링크와 연관됨)을 채택해야 하는지 여부를 보여주는 IBM MQ 링크의 특성입니다. 통신 실패가 발생하면 IBM MQ 링크 수신자 채널의 실행 인스턴스가 메시지를 대기할 수 있습니다. 통신이 다시 설정되고 파트너 IBM MQ 전송자 채널이 다음에 IBM MQ 링크 수신자 채널과의 세션을 설정하려고 시도하면 파트너 IBM MQ 전송자 채널과의 세션에 있다고 인식하는 IBM MQ 링크 수신자 채널의 실행 중인 인스턴스가 이미 있기 때문에 요청이 실패합니다. IBM MQ 링크 수신자 채널의 이미 실행 중인 인스턴스를 중지하고 새 인스턴스를 시작하는 이 옵션을 선택해서 이 문제를 해결할 수 있습니다.

이 옵션을 True로 설정하면 통신 실패가 발생하고 링크가 아직 실패 상태를 발견하지 못한 경우에 IBM MQ 전송자 채널이 이 IBM MQ 링크에 대한 연결을 다시 설정할 수 있습니다.

정보
기본값 True
-initialState Started | Stopped
호스팅 메시징 엔진이 처음 시작될 때 링크가 시작되는지 또는 중지되는지를 표시하는 IBM MQ 링크의 상태입니다. 이 링크가 시작될 때까지 IBM MQ 링크를 사용할 수 없습니다.
정보
기본값 시작됨
범위
중지됨
연관된 메시징 엔진이 시작될 때 WebSphere® MQ 링크가 중지됨 상태이고 IBM MQ 네트워크와 통신할 수 없습니다.
시작됨
연관된 메시징 엔진이 시작될 때 IBM MQ 링크가 자동으로 시작되고 IBM MQ 네트워크와 통신할 수 있습니다.
IBM MQ 링크 전송자 채널 매개변수:
-senderChannelName

이 이름은 IBM MQ의 수신자 채널 이름과 동일해야 합니다.

채널 이름 선택에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 절에서 채널 이름(CHANNEL) 특성에 대한 설명을 참조하십시오.

-hostName
IBM MQ 네트워크에 연결하는 데 사용되는 게이트웨이 큐 관리자의 호스트 이름 또는 TCP/IP 주소입니다.

게이트웨이 큐 관리자가 실행되는 호스트의 호스트 이름 또는 IP 주소를 입력합니다.

이 필드가 공백이면 게이트웨이 큐 관리자가 IBM MQ 링크가 정의되는 메시징 엔진과 같은 호스트에서 실행되는 것으로 가정됩니다.

-port
정보
기본값 1414
범위 0 - 65535
-connameList
IBM MQ 네트워크에 연결하는 데 사용되는 게이트웨이 큐 관리자의 연결 이름 목록. 연결에 성공할 때까지 연결 이름 목록에 지정된 순서로 연결이 시도됩니다. 연결이 실패할 경우 채널에서 재시도 처리를 시작합니다.

연결 이름은 다음 형식의 쉼표로 분리된 목록으로 제공되어야 합니다.

Dnsname1(portnumber1) , Dnsname2(portnumber2)

게이트웨이 큐 관리자가 실행되는 호스트의 DNS 이름 또는 IP 주소를 입력합니다. 0 - 65535 범위의 포트 번호를 입력하십시오.

연결 이름 목록 매개변수를 지정하지 않으면 게이트웨이 큐 관리자는 IBM MQ 링크가 정의된 메시징 엔진과 동일한 호스트에서 실행된다고 가정합니다.

연결 이름 목록 매개변수를 지정하는 경우 송신자 채널 이름 매개변수에 대한 값을 이미 지정했어야 합니다. 그렇지 않으면 연결 이름 목록 매개변수에 지정한 값이 무시됩니다.

호스트 이름 및 포트 매개변수와 함께 연결 이름 목록 매개변수를 지정한 경우 런타임에서 연결 이름 목록이 우선되며 호스트 이름과 포트 값은 무시됩니다.

-discInterval

기본값은 적당한 간격입니다. 이 값은 성능에 대한 영향을 이해하고 채널을 따라 이동하는 통신량의 요구사항으로 인해 다른 값이 필요할 경우에만 변경하십시오.

성능은 연결 끊기 간격에 지정된 값의 영향을 받습니다. 값이 아주 낮으면(몇 초) 채널을 빈번하게 시작할 때 허용 불가능한 처리량이 초래될 수 있습니다. 값이 너무 크면(1시간 초과) 시스템 자원이 불필요하게 보유됩니다.

채널에 대해 전송할 메시지가 있을 경우에만 채널이 활성화되도록 하려면 연결 끊기 간격을 적절히 낮은 값으로 설정해야 합니다. 기본 설정은 꽤 높으므로 이러한 제어 레벨이 필요한 채널에 대해 권장되지 않습니다. 수신 채널을 인터럽트하는 것은 어려우므로 가장 경제적인 옵션은 채널이 자동으로 연결을 끊고 워크로드 요구에 따라 재연결하는 것입니다. 대부분의 채널은 발견적 방법에 따라 적절한 연결 끊기 간격이 설정됩니다.

정보
기본값 900
범위 0 - 999999

0(영) 값은 연결이 끊어지지 않음을 의미합니다. 즉, 채널은 메시지를 무한정 기다립니다.

-shortRetryCount

IBM MQ에서의 재시도 메커니즘 사용에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 절을 참조하십시오.

정보
기본값 10
범위 0 - 999999999
-shortRetryInterval

IBM MQ에서의 재시도 메커니즘 사용에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 절을 참조하십시오.

정보
기본값 60
범위 0 - 999999
-longRetryCount

IBM MQ에서의 재시도 메커니즘 사용에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 절을 참조하십시오.

정보
기본값 999999999
범위 0 - 999999999
-longRetryInterval

IBM MQ에서의 재시도 메커니즘 사용에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 절을 참조하십시오.

정보
기본값 1200
범위 0 - 999999
-senderChannelInitialState Started | Stopped
연관된 IBM MQ 링크가 처음 시작될 때 전송자 채널이 시작되는지 또는 중지되는지를 표시하는 IBM MQ 링크의 상태입니다. 이 링크가 시작될 때까지 채널을 사용할 수 없습니다.
정보
기본값 시작됨
범위
중지됨
연관된 메시징 엔진이 시작될 때 IBM MQ 링크가 중지됨 상태이고 IBM MQ 네트워크와 통신할 수 없습니다.
시작됨
연관된 메시징 엔진이 시작될 때 IBM MQ 링크가 자동으로 시작되고 IBM MQ 네트워크와 통신할 수 있습니다.
IBM MQ 링크 수신자 채널 매개변수:
-receiverChannelName

이 이름은 IBM MQ의 송신자 채널 이름과 동일해야 합니다.

-inboundNonPersistentReliability Best effort | Reliable

이 신뢰도 전달 옵션은 이 수신자 채널을 통해 이동하는 모든 IBM MQ 비지속적 메시지에 지정됩니다.

정보
기본값 신뢰 가능한
범위
최상의 노력
메시징 엔진이 중지하거나 실패할 때 메시지가 버려집니다. 메시지 전송에 사용된 연결이 사용 불가능하게 되거나 시스템 자원이 제한될 경우에도 메시지는 버려질 수 있습니다.
Express
메시징 엔진이 중지하거나 실패할 때 메시지가 버려집니다. 메시지 전송에 사용된 연결이 사용 불가능하게 될 경우에도 메시지는 버려질 수 있습니다.
신뢰 가능한
메시징 엔진이 중지하거나 실패할 때 메시지가 버려집니다.
-inboundPersistentReliability Reliable | Assured
정보
기본값 보증
범위
신뢰 가능한
메시지는 메시징 엔진이 실패할 때 버려질 수 있습니다.
보증
메시지가 버려지지 않습니다.
-receiverChannelInitialState Started | Stopped
연관된 IBM MQ 링크가 처음 시작될 때 수신자 채널이 시작되는지 또는 중지되는지를 표시하는 IBM MQ 링크의 상태입니다. 이 링크가 시작될 때까지 채널을 사용할 수 없습니다.
정보
기본값 시작됨
범위
중지됨
연관된 메시징 엔진이 시작될 때 IBM MQ 링크가 중지됨 상태이고 IBM MQ 네트워크와 통신할 수 없습니다.
시작됨
연관된 메시징 엔진이 시작될 때 IBM MQ 링크가 자동으로 시작되고 IBM MQ 네트워크와 통신할 수 있습니다.
-preferLocal TRUE | FALSE
이 옵션은 사용 가능한 경우 링크가 링크와 동일한 메시징 엔진에 있는 대상 목적지의 큐 위치로 수신 메시지를 보냄을 표시합니다. 링크는 WebSphere Application Server 버전 7.0 이상 서버에서 실행 중인 메시징 엔진에서 소유해야 합니다.

이 옵션은 WebSphere Application Server 버전 7.0 이상 서버 또는 클라이언트에서 실행되는 JMS 애플리케이션에서 사용되거나 WebSphere Application Server 버전 7.0 이상 서버에서 실행 중인 메시징 엔진에 연결될 때만 지원됩니다. 이전 버전의 WebSphere Application Server를 사용하면 애플리케이션에 예외가 발생합니다.

정보
기본값 TRUE
범위
TRUE
사용 가능한 경우 링크와 동일한 메시징 엔진에 있는 대상 목적지의 큐 위치로 각 수신 메시지를 전송합니다.
FALSE
대상 목적지의 큐 위치로 수신 메시지를 전송합니다.

AdminTask.createSIBMQLink('[-bus bus1 -messagingEngine cluster1.000-bus1 
-name myMQLink2 -foreignBusName MQNetwork2 -queueManagerName MQMgrIPL 
-senderChannelTransportChain OutboundBasicMQLink]')
'myMQLink2(cells/cell01/nodes/node01/servers/server1|sib-engines.xml#
SIBMQLink_1132607756126)'

가능한 경우 대상 목적지와 동일한 메시징 엔진의 큐 위치를 사용하는 SIBMQLink를 작성합니다.

AdminTask.createSIBMQLink('[-bus bus1 -messagingEngine cluster1.000-bus1 
-name MyMQLink -foreignBusName -MQQMgr1 -queueManagerName bus1 
-senderChannelTransportChain OutboundBasicMQLink  -preferLocal TRUE]')

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



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