modifySIBMQLink 명령

modifySIBMQLink 명령을 사용하여 WebSphere® 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()

목적

modifySIBMQLink 명령은 IBM MQ 링크의 특성을 수정합니다.

대상 오브젝트

IBM MQ 링크.

필수 매개변수

-bus
IBM MQ 링크를 작성한 서비스 통합 버스의 이름입니다. listSIBuses 명령을 사용하여 기존 버스의 이름을 나열할 수 있습니다.
-messagingEngine
IBM MQ 링크를 작성한 메시징 엔진의 이름입니다. listSIBEngines 명령을 사용하여 기존 메시징 엔진의 이름을 나열할 수 있습니다.
-name
IBM MQ 링크의 이름입니다.

조건부 매개변수

없음.

선택적 매개변수

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 네트워크와 통신할 수 있습니다.
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 네트워크와 통신할 수 있습니다.
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>

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



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