modifySIBMQLink 명령
modifySIBMQLink 명령을 사용하여 WebSphere® MQ 링크의 특성을 수정합니다.
명령을 실행하려면 wsadmin 스크립트 클라이언트의 AdminTask 오브젝트를 사용하십시오.
wsadmin 스크립트 클라이언트는 Qshell에서
실행됩니다. .
자세한 정보는 wsadmin 스크립트를 사용하여 WebSphere 스크립트를 실행하도록 Qshell 구성의 내용을 참조하십시오..
- Jython의 사용 가능한 서비스 통합 버스 명령 목록과 각 명령의 간단한 설명에 대해서는
wsadmin 프롬프트에 다음 명령을 입력하십시오.
print AdminTask.help('SIBAdminCommands')
- 제공된 명령에 대한 개요 도움말을 보려면 다음 명령을 wsadmin 프롬프트에 입력하십시오.
print AdminTask.help('command_name')
AdminConfig.save()
목적
modifySIBMQLink 명령은 IBM MQ 링크의 특성을 수정합니다.
대상 오브젝트
IBM MQ 링크.
필수 매개변수
- -bus
- IBM MQ 링크를 작성한 서비스 통합 버스의 이름입니다. listSIBuses 명령을 사용하여 기존 버스의 이름을 나열할 수 있습니다.
- -messagingEngine
- IBM MQ 링크를 작성한 메시징 엔진의 이름입니다. listSIBEngines 명령을 사용하여 기존 메시징 엔진의 이름을 나열할 수 있습니다.
- -name
- IBM MQ 링크의 이름입니다.
조건부 매개변수
없음.
선택적 매개변수
- -queueManagerName
- 메시징 엔진이 원격 IBM MQ 네트워크에 알려지며 메시징 엔진과
연관된 가상 큐 관리자의 이름입니다.
큐 관리자 이름은 IBM MQ 이름 지정 규칙을 준수해야 합니다. 예를 들어 이름은 최대 48자여야 합니다.
- -description
- 관리를 위한 버스의 선택적 설명입니다.
- -exceptionDestination
- IBM MQ 링크가 목표 버스 대상이나
해당 목표 대상에 구성되는 예외 대상으로 메시지를
전달할 수 없을 때 또는 목표 대상이 존재하지 않을 때
인바운드 메시지에 대한 대상입니다.
- 시스템
- IBM MQ 링크는 기본 예외 대상을 사용합니다. 버스 대상으로 전달될 수 없는 모든 메시지는 이 링크가 지정되는 메시징 엔진에 대한 시스템 기본 예외 대상인 _SYSTEM.Exception.Destinationmessaging_engine_name으로 자동으로 경로 재지정됩니다.
- 없음
- IBM MQ 링크에 예외 대상이 없습니다. 전달할 수 없는 메시지가 예외 대상으로 경로 재지정되지 않고 동일한 버스에 대한 링크를 통한 전달을 기다리는 기타 메시지의 처리를 차단할 수 있습니다. 이 옵션은 메시지 순서를 보존하는 데 사용될 수 있습니다.
- 지정
- IBM MQ 링크가 여기에 지정된 예외 대상을 사용합니다. 이것이 가능하지 않으면 시스템 예외 대상을 사용합니다.
- -batchSize
일괄처리 크기가 이 링크에 대한 전송자 및 수신자 채널이 메시지를 전송하는 방법에 영향을 주지 않습니다. 메시지는 항상 개별적으로 전송되지만 일괄처리로서 커미트 또는 백아웃됩니다.
일괄처리 크기 선택에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 섹션에 있는 일괄처리 크기(BATCHSZ) 특성의 설명을 참조하십시오.
Information 값 Default 50 범위 1 - 9999 - -maxMsgSize
적절한 숫자를 선택하는 방법에 대한 정보는 IBM MQ Information Center의 상호 통신 섹션에 있는 최대 메시지 길이(MAXMSGL) 특성의 설명을 참조하십시오.
Information 값 Default 4194304바이트(4MB) 범위 0 - 104857600 대상 큐 관리자가 부여하는 가장 큰 값을 사용하려면 0을 지정하십시오.
- -heartBeat
하트비트는 수신 채널에 채널 연결을 quiesce할 기회를 제공합니다.
이 특성의 값 선택에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 섹션을 참조하십시오.
Information 값 Default 300초 범위 0 - 999999 - -sequenceWrap
- 예를 들어,
1000의 값을 지정하면 메시지 순서 번호가 1001에
도달할 때 1에서 다시 시작합니다.
이 특성의 값 선택에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 섹션에 있는 순서 번호 랩(SEQWRAP) 특성의 설명을 참조하십시오.
Information 값 Default 999999999 범위 100 - 999999999 - -nonPersistentMessageSpeed Fast | Normal
Information 값 Default 빠름 범위 - 빠름
- 전송 장애가 있거나 메시지 전송 중 채널이 중지할 경우 비지속적 메시지가 유실될 수 있습니다.
- 보통
- 전송 장애가 있거나 메시지 전송 중 채널이 중지할 경우에도 비지속적 메시지는 유실되지 않습니다.
- -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 링크에 대한 연결을 재설정할 수 있습니다.
Information 값 Default True - -initialState Started | Stopped
- IBM MQ 링크의 상태로,
호스팅하는 메시징 엔진이 처음 시작될 때 링크가 시작 또는 중지되는지
여부를 표시합니다. 엔진이 시작될 때까지 IBM MQ 링크는 사용 불가능합니다.
Information 값 Default 시작됨 범위 - 중지됨
- 연관된 메시징 엔진이 시작될 때 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
Information 값 Default 1414 범위 0 - 65535 - -connameList
- IBM MQ 네트워크에 연결하는 데 사용되는 게이트웨이
큐 관리자에 대한 연결 이름 목록입니다.
연결은 연결이 성공적으로 구축될 때까지 연결 이름
목록에서 지정되는 순서에 따라 시도됩니다.
연결이 실패할 경우 채널에서 재시도 처리를 시작합니다.
연결 이름은 다음 형식의 쉼표로 구분된 목록으로 제공되어야 합니다.
Dnsname1(portnumber1) , Dnsname2(portnumber2)
게이트웨이 큐 관리자가 실행 중인 호스트의 DNS 이름이나 IP 주소를 입력하십시오. 0 - 65535 범위에 있는 포트 번호를 입력하십시오.
연결 이름 목록 매개변수를 지정하지 않는 경우, 게이트웨이 큐 관리자는 IBM MQ 링크가 정의되는 메시징 엔진과 동일한 호스트에서 실행 중인 것으로 간주됩니다.
연결 목록 매개변수를 지정하는 경우 이미 전송자 채널 매개변수에 대한 값을 지정했어야 합니다. 그렇지 않으면 사용자가 연결 이름 목록 매개변수에 대해 지정하는 값은 무시됩니다.
연결 이름 목록 매개변수뿐 아니라 호스트 이름과 포트 매개변수를 지정하는 경우, 런타임 시에 연결 이름 목록이 우선권을 갖고 호스트 이름과 포트 값은 무시됩니다.
- -discInterval
기본값은 적당한 간격입니다. 이 값은 성능에 대한 영향을 이해하고 채널을 따라 이동하는 트래픽의 요구사항으로 인해 다른 값이 필요할 경우에만 변경하십시오.
성능은 연결 끊기 간격에 지정된 값의 영향을 받습니다. 아주 낮은 값(몇 초)을 지정하면 끊임없이 채널이 시작되어 처리량을 감당할 수 없게 됩니다. 매우 큰 값(한 시간 이상)은 시스템 자원이 불필요하게 보유됨을 의미할 수 있습니다.
채널이 전송할 메시지가 있을 경우에만 채널이 활성화되도록 하려면 연결 끊기 간격을 적절히 낮은 값으로 설정해야 합니다. 기본 설정은 꽤 높으므로 이러한 제어 레벨이 필요한 채널에 대해 권장되지 않습니다. 수신 채널을 인터럽트하는 것은 어려우므로 가장 경제적인 옵션은 채널이 자동으로 연결을 끊고 워크로드 요구에 따라 재연결하는 것입니다. 대부분의 채널에 대해 연결 끊기 간격의 발견적 방식으로 적절한 연결 끊기 간격 설정을 확립할 수 있습니다.
Information 값 Default 900초 범위 0 - 999999 값 0(영)은 절대 연결이 끊어지지 않음을 의미합니다. 채널은 무한정 메시지를 기다립니다.
- -shortRetryCount
Information 값 Default 10 범위 0 - 999999999 - -shortRetryInterval
IBM MQ 에서 재시도 메커니즘 사용에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 섹션을 참조하십시오.
Information 값 Default 60초 범위 0 - 999999 - -longRetryCount
IBM MQ 에서 재시도 메커니즘 사용에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 섹션을 참조하십시오.
Information 값 Default 999999999 범위 0 - 999999999 - -longRetryInterval
IBM MQ 에서 재시도 메커니즘 사용에 대한 자세한 정보는 IBM MQ Information Center의 상호 통신 섹션을 참조하십시오.
Information 값 Default 1200초 범위 0 - 999999 - -senderChannelInitialState Started | Stopped
- IBM MQ 링크의 상태로,
연관된 IBM MQ 링크가 처음 시작될 때
송신자 채널이 시작 또는 중지되는지 여부를
표시합니다. 채널은 시작될 때까지는 사용 불가능합니다.
Information 값 Default 시작됨 범위 - 중지됨
- 연관된 메시징 엔진이 시작될 때 IBM MQ 링크가 중지됨 상태이고 IBM MQ 네트워크와 통신할 수 없습니다.
- 시작됨
- 연관된 메시징 엔진이 시작될 때 IBM MQ 링크가 자동으로 시작되고 IBM MQ 네트워크와 통신할 수 있습니다.
- -receiverChannelName
이 이름은 IBM MQ의 송신자 채널 이름과 같아야 합니다.
- -inboundNonPersistentReliability Best effort | Reliable
이 신뢰성 전달 옵션은 이 수신자 채널을 통해 플로우되는 모든 IBM MQ 비지속적 메시지에 지정됩니다.
Information 값 Default 신뢰 가능한 범위 - 최상의 노력
- 메시징 엔진이 중지하거나 실패할 때 메시지가 버려집니다. 메시지 전송에 사용된 연결이 사용 불가능하게 되거나 시스템 자원이 제한될 경우에도 메시지는 버려질 수 있습니다.
- Express
- 신뢰 가능한
- 메시징 엔진이 중지하거나 실패할 때 메시지가 버려집니다.
- -inboundPersistentReliability Reliable | Assured
Information 값 Default 보증 범위 - 신뢰 가능한
- 메시지는 메시징 엔진이 실패할 때 버려질 수 있습니다.
- 보증
- 메시지가 버려지지 않습니다.
- -receiverChannelInitialState Started | Stopped
- IBM MQ 링크의 상태로,
연관된 IBM MQ 링크가 처음 시작될 때 수신자 채널이
시작 또는 중지되는지 여부를 표시합니다. 채널은
시작될 때까지는 사용 불가능합니다.
Information 값 Default 시작됨 범위 - 중지됨
- 연관된 메시징 엔진이 시작될 때 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에서 사용하면 애플리케이션에 예외가 발생합니다.
Information 값 Default TRUE 범위 - TRUE
- 사용 가능한 경우 링크와 동일한 메시징 엔진에 위치하는 목표 대상의 큐 위치로 수신 메시지를 전송합니다.
- FALSE
- 목표 대상의 임의의 큐 위치로 수신 메시지를 전송합니다.
예제
IBM MQ 링크의 특성을 표시하고 링크를 수정하여 일괄처리 크기를 변경한 후 링크의 특성을 다시 표시합니다.
wsadmin>AdminTask.showSIBMQLink('[-bus myBus -messagingEngine myHostNode01.server1-myBus
-mqLink myMQLink]')
'{nonPersistentMessageSpeed=FAST, qmName=myBus, adoptable=false, sequenceWrap=999999999,
name=myMQLink, targetUuid=738AE126B908E5451A3D4691, initialState=STARTED,
senderChannel=null, brokerProfile=[], receiverChannel=null, preferLocalQueuePoints=true,
batchSize=50, uuid=6B89C4F08AB072C5, heartBeat=300, description=null, maxMsgSize=4194304,
exceptionDestination=_SYSTEM.Exception.Destination.myHostNode01.server1-myBus}'
wsadmin>
wsadmin>AdminTask.modifySIBMQLink('[-bus myBus -messagingEngine myHostNode01.server1-myBus
-name myMQLink -batchSize 100]')
'myMQLink(cells/cell01/nodes/node01/servers/server1|sib-engines.xml#SIBMQLink_1132608724468)'
wsadmin>AdminTask.showSIBMQLink('[-bus myBus -messagingEngine myHostNode01.server1-myBus
-mqLink myMQLink]')
'{nonPersistentMessageSpeed=FAST, qmName=myBus, adoptable=false, sequenceWrap=999999999,
name=myMQLink, targetUuid=738AE126B908E5451A3D4691, initialState=STARTED,
senderChannel=null, brokerProfile=[], receiverChannel=null, preferLocalQueuePoints=true,
batchSize=100, uuid=6B89C4F08AB072C5, heartBeat=300, description=null, maxMsgSize=4194304,
exceptionDestination=_SYSTEM.Exception.Destination.myHostNode01.server1-myBus}'
wsadmin>
사용할 큐 위치에 대한 링크의 환경 설정이 없도록 IBM MQ 링크를 수정합니다.
wsadmin>AdminTask.modifySIBMQLink('[-bus Bus1 -messagingEngine
node1.node1server1-Bus1 -name MQLink -queueManagerName QM2 -preferLocal FALSE]')
wsadmin>