manageWMQ 명령
manageWMQ 명령을 사용하여 특정 범위에서 설치된 IBM MQ 자원 어댑터의 설정을 관리합니다.
이 명령을 실행하려면 wsadmin 스크립트 클라이언트의 AdminTask 오브젝트를 사용하십시오.
wsadmin 스크립트 클라이언트는
Qshell에서 실행됩니다. 자세한 정보는 "Qshell을 구성하여
WebSphere® Application Server 스크립트 실행" 주제를 참조하십시오.
이 명령은 WebSphere Application Server 버전 7 이상 애플리케이션 서버에서 사용될 때만 유효합니다. 이전 버전에서는 사용하지 마십시오.
print AdminTask.help('WMQAdminCommands')
print AdminTask.help('command_name')
AdminConfig.save()
목적
manageWMQ 명령을 사용하여 특정 범위에서 설치된 IBM MQ 자원 어댑터와 연관된 설정을 관리합니다.
manageWMQ 명령을 사용하여 기본 라이브러리 경로를 관리하고 지정된 IBM MQ 자원 어댑터의 메타데이터를 조회할 수 있습니다.
대상 오브젝트
IBM MQ 자원 어댑터.
필수 매개변수
없음.
선택적 매개변수
- -nativePath
- 이 매개변수는 IBM MQ 자원 어댑터가 큐 관리자에 바인딩 모드를 연결할 때 사용되는 IBM MQ 메시징 제공자 기본 라이브러리의 경로를 지정합니다. 이 매개변수는 모든 범위의 IBM MQ 어댑터에 지정할 수 있습니다.
- -query
- 이 매개변수는 IBM MQ 메시징 제공자에 사용되는 IBM MQ 자원 어댑터의 레벨에 대한 정보를 제공합니다. 이 매개변수는 모든 범위의 IBM MQ 자원 어댑터에 지정할 수 있습니다.
-enableInbound
이 매개변수를 통해 인바운드 JCA(Java™ EE(Java Platform, Enterprise Edition) Connector Architecture) 메시지를 z/OS® 플랫폼의 IBM MQ 자원 어댑터 활성화 스펙에 전달할 수 있습니다. 이 값은 IBM MQ 자원 어댑터가 서버 범위에 있는 경우에만 지정할 수 있습니다. 이러한 변경사항을 적용하려면 애플리케이션 서버를 다시 시작해야 합니다.
이 매개변수의 값은 true 또는 false여야 합니다.
기본값은 false입니다.
- -disableWMQ
- 이 매개변수는 지정된 자원 어댑터의 범위 및 이 자원 어댑터 다음의 모든 범위에서 IBM MQ 기능을 사용 안함으로 설정할지 여부를 지정합니다.
이 매개변수의 값은 true 또는 false여야 합니다.
기본값은 false입니다.
단일 서버 환경에서, 이 매개변수는 서버 범위에서만 유효합니다. 네트워크 배치 환경에서 이 매개변수는 모든 범위에서 유효합니다. 이 매개변수를 true로 설정하여 발생하는 결과는 사용자가 선택하는 범위에 따라 다릅니다.
- 셀 범위 IBM MQ 자원 어댑터의 경우, 셀의 모든 애플리케이션 서버에 있는 모든 IBM MQ 기능은 사용 불가능합니다.
- 노드 범위 IBM MQ 자원 어댑터의 경우, 노드의 파트인 모든 애플리케이션 서버에 있는 모든 IBM MQ 기능은 사용 불가능합니다.
- 클러스터 범위 IBM MQ 자원 어댑터의 경우, 해당 클러스터의 모든 애플리케이션 서버에 있는 모든 IBM MQ 기능은 사용 불가능합니다.
- 서버 범위 IBM MQ 자원 어댑터의 경우, 해당 특정 애플리케이션 서버의 모든 IBM MQ 기능은 사용 불가능합니다.
모든 경우에 변경사항을 적용하려면 영향을 받는 모든 프로세스를 다시 시작해야 합니다.
상위 범위에 있는 이 매개변수의 값은 하위 범위에 있는 값보다 우선순위가 높습니다. 예를 들어, 서버 범위에서 매개변수를 false로 설정하지만 더 높은 범위(예: 셀 범위)의 IBM MQ 메시징 제공자가 매개변수를 true로 설정하는 경우에는 셀 범위의 값이 우선하므로 서버 범위에서 매개변수 값에 상관없이 셀의 모든 애플리케이션 서버에서 IBM MQ 기능이 사용 불가능합니다.
- -maxConnections
- 이 매개변수는 IBM MQ 큐 관리자에 대한 최대 연결 수를
지정합니다.
기본값은 10입니다.
자세한 정보는 IBM MQ Information Center의 ResourceAdapter 오브젝트의 구성을 참조하십시오.
- -connectionConcurrency
- 이 매개변수는 각 연결에서 제공할 수 있는 최대 메시지 구동 Bean 수를 지정합니다.
기본값은 1입니다.
이 특성을 설정하면 WebSphere Application Server 7 노드에만 영향을 미칩니다. 이 특성은 WebSphere Application Server 버전 8 이상 노드에는 영향을 주지 않습니다.
자세한 정보는 IBM MQ Information Center의 ResourceAdapter 오브젝트의 구성을 참조하십시오.
- -reconnectionRetryCount
- 이 매개변수는
IBM MQ 메시징
제공자 활성화 스펙이 IBM MQ 큐 관리자에
연결하는 데 실패할 경우 다시 연결하는 최대 횟수를 지정합니다.
기본값은 5입니다.
자세한 정보는 IBM MQ Information Center의 ResourceAdapter 오브젝트의 구성을 참조하십시오.
- -reconnectionRetryInterval
- 이 매개변수는 IBM MQ 메시징 제공자 활성화 스펙이 IBM MQ 큐 관리자에 다시 연결하려고 시도하기 전에 대기하는 시간(밀리초)을 지정합니다.
기본값은 300000입니다.
자세한 정보는 IBM MQ Information Center의 ResourceAdapter 오브젝트의 구성을 참조하십시오.
- -customProperties
- 이 매개변수는 IBM MQ 자원 어댑터에 전달할 사용자 정의 특성을 지정합니다. 일반적으로,
사용자 정의 특성은 WebSphere Application Server 관리 인터페이스를 통해 직접 지원되지 않는 IBM MQ 자원 어댑터의 속성을 설정하는 데 사용됩니다. 사용자 정의 특성은 이름 및 값 테이블 단계 매개변수를 사용하여 지정합니다. 테이블 단계이기 때문에 2개의 매개변수 순서가 고정되어 있습니다. 따라서 항상 이름을 먼저 지정하고 값을 두 번째에 지정해야 합니다.
- Jython: [name value]
- Jacl: {name value}
새 이름/값 쌍은 다음 규칙을 사용하여 기존 사용자 정의 특성 세트에 추가됩니다.- 기존 특성 세트에 제공된 특성과 동일한 이름의 특성이 없을 경우, 사용자 정의 특성에 값이 지정되지 않아 무시되는 경우를 제외하고 제공된 특성은 사용자 정의 특성 세트에 추가됩니다.
- 기존 특성 세트에 수정 명령의 일부로 제공된 특성과 동일한 이름의 특성이 있고 수정 명령도 특성 값을 지정하는 경우, 기존 값이 제공된 값으로 대체됩니다.
- 기존 특성 세트에 수정 명령의 일부로 제공된 특성과 동일한 이름의 특성이 있지만 수정 명령이 특성 값을 지정하지 않는 경우, 동일한 이름의 특성이 기존의 사용자 정의 특성 세트에서 삭제됩니다.
예
다음 예제에서는 z/OS 플랫폼에서 인바운드 JCA 메시지 전달을 사용 가능하게 하는 방법을 보여줍니다.- Jython 사용:
wsadmin>AdminTask.manageWMQ("IBM MQ Resource Adapter (cells/L3A3316Node04Cell/nodes/L3A3316Node05/servers/server1|resources.xml# J2CResourceAdapter_1201601803796)", ["-enableInbound true"])
- Jacl 사용:
wsadmin>$AdminTask manageWMQ "IBM MQ Resource Adapter (cells/L3A3316Node04Cell/nodes/L3A3316Node05/servers/server1|resources.xml# J2CResourceAdapter_1201601803796)" {-enableInbound true}
- Jython 사용:
AdminTask.manageWMQ("IBM MQ Resource Adapter( cells/L3A3316Node01Cell|resources.xml#J2CResourceAdapter_1284547647859)", ["-maxConnections 100 -customProperties [[name1 value1]]"])
- Jacl 사용:
wsadmin>$AdminTask manageWMQ "IBM MQ Resource Adapter( cells/L3A3316Node01Cell|resources.xml#J2CResourceAdapter_1284547647859)" {-maxConnections 100 -customProperties {{name1 value1}}}