createWMQQueue 명령
createWMQQueue 명령을 사용하여 특정 범위에서 WebSphere® MQ 메시징 제공자에 대한 큐 유형 대상을 작성하십시오.
이 명령을 실행하려면 wsadmin 스크립트 클라이언트의 AdminTask 오브젝트를 사용하십시오.
wsadmin 스크립트 클라이언트는
Qshell에서 실행됩니다. 자세한 정보는 "Qshell을 구성하여
WebSphere Application Server 스크립트 실행" 주제를 참조하십시오.
이 명령은 WebSphere Application Server 버전 7 이상 애플리케이션 서버에서 사용될 때만 유효합니다. 이전 버전에서는 사용하지 마십시오.
print AdminTask.help('WMQAdminCommands')
print AdminTask.help('command_name')
AdminConfig.save()
목적
createWMQQueue 명령을 사용하여 특정 범위에서 WebSphere MQ 메시징 제공자 큐 유형 대상을 작성하십시오.
- WebSphere MQ 메시징 제공자 큐 유형 대상이 동일한 범위에 동일한 이름으로 이미 존재합니다.
- JNDI 이름이 WebSphere Application Server JNDI의 다른 항목과 충돌됩니다.
대상 오브젝트
WebSphere MQ 메시징 제공자 큐 유형 대상이 작성되는 WebSphere MQ 메시징 제공자의 범위입니다.
필수 매개변수
- -name
- 이 WebSphere MQ 메시징 제공자 큐 유형 대상에 지정된 관리 이름입니다.
- -jndiName
- 이 오브젝트를 WebSphere Application Server JNDI에 바인드하는 데 사용되는 이름입니다.
- -queueName
- WebSphere MQ 메시징 제공자 큐 유형 대상 정의를 위한 메시지를 저장하는데 사용하는 WebSphere MQ 큐의 이름입니다.
선택적 매개변수
- -description
- 큐 유형 대상에 지정되는 관리 설명입니다.
- -qmgr
- WebSphere MQ 큐를 호스트하는 큐 관리자입니다.
- -persistence
- 이 매개변수는 이 대상으로 전송된 메시지를 저장하는 데 사용되는
지속성 레벨입니다. 다음 대소문자 구분 값 중 하나를 입력하십시오.
- APP
- QDEF
- PERS
- NON
- HIGH
기본값은 APP입니다.
- -priority
- 이 대상으로 전송된 메시지에 지정할 우선순위 레벨입니다. 다음 값 중 하나를 입력하십시오.
- APP참고: (APP는 대소문자를 구분함)
- QDEF참고: (QDEF는 대소문자를 구분함)
- <0 - 9 범위의 양의 정수(포함)>
기본값은 APP입니다.
- APP
- -expiry
- 이 대상으로 전송되는 메시지가 만료되고 해당 처리 옵션에 따라 처리되기까지
걸리는 시간입니다. 다음 값 중 하나를 입력하십시오.
- APP참고: (APP는 대소문자를 구분함)
- UNLIM참고: (UNLIM은 대소문자를 구분함)
- <모든 양의 정수>
기본값은 APP입니다.
- APP
- -ccsid
- CCSID(Coded Character Set Identifier)입니다.
이 매개변수의 값은 양의 정수이거나 비어 있어야 합니다. 자세한 내용은 IBM MQ 메시징 제공자 큐 및 토픽 고급 특성 설정의 내용을 참조하십시오.
기본값은 1208입니다.
이 필드를 비워둘 경우 기본값을 사용해야 함을 나타냅니다.
- -useNativeEncoding
- 이 매개변수는 기본 인코딩의 사용 여부를 지정합니다.
true 또는 false 값을 사용할 수 있습니다.
true로 설정된 경우 -integerEncoding, -decimalEncoding 및 -floatingPointEncoding 속성의 값을 무시합니다.
false로 설정된 경우 인코딩은 -integerEncoding, -decimalEncoding 및 -floatingPointEncoding 속성에 지정됩니다.
- -integerEncoding
- 이 큐의 정수 인코딩 설정입니다.
대소문자 구분 값 Normal 또는 Reversed 중 하나를 입력하십시오.
기본값은 Normal입니다.
- -decimalEncoding
- 이 큐의 10진 인코딩 설정입니다.
대소문자 구분 값 Normal 또는 Reversed 중 하나를 입력하십시오.
기본값은 Normal입니다.
- -floatingPointEncoding
- 이 큐의 부동 소수점 인코딩 설정입니다.
대소문자 구분 값 IEEENormal, IEEEReversed 또는 z/OS 중 하나를 입력하십시오.
기본값은 IEEENormal입니다.
- -useRFH2
- 이 매개변수는 이 대상(targetClient라고도 함)에 전송되는 메시지에 RFH 버전 2 헤더가 추가되는지 여부를
결정합니다.
다음 대소문자 구분 값 중 하나를 입력하십시오. true 또는 false (JMS 또는 MQ targetClient 각각에 해당됨).
기본값은 true (JMS targetClient)입니다.
- -sendAsync
- 이 매개변수는 도착했다는 큐 관리자 수신확인을 사용하지 않고
이 대상으로 메시지를 전송할 수 있는지 여부를 결정합니다.
대소문자 구분 값 YES, NO 또는 QDEF 중 하나를 입력하십시오.
기본값은 QDEF입니다.
- -readAhead
- 이 매개변수는 비지속적 이용자의 메시지를 미리 읽고 캐시할 수
있는지 여부를 결정합니다.
대소문자 구분 값 YES, NO 또는 QDEF 중 하나를 입력하십시오.
기본값은 QDEF입니다.
- -readAheadClose
- 이 매개변수는 메시지 이용자를 위한 미리 읽기 닫기 메소드를
지정합니다.
대소문자 구분 값 DELIVERALL 또는 DELIVERCURRENT 중 하나를 입력하십시오.
기본값은 DELIVERALL입니다.
- -customProperties
- 이 매개변수는
WebSphere
MQ 메시징 제공자 큐 유형 대상 구현에 전달될 사용자 정의 특성을 지정합니다. 일반적으로 사용자 정의
특성은
WebSphere
관리 인터페이스를 통해 직접 지원되지 않는 큐 유형 대상의 속성을 설정하는 데 사용됩니다. 사용자 정의 특성은 이름 및 값 테이블 단계 매개변수를 사용하여 지정합니다. 테이블 단계이기 때문에 2개의 매개변수 순서가 고정되어 있습니다. 따라서 항상 이름을 먼저 지정하고 값을 두 번째에 지정해야 합니다.
- Jython: [name value]
- Jacl: {name value}
다음 예는 WebSphere MQ 메시징 제공자 큐 유형 대상을 작성합니다.
- Jython 사용:
wsadmin>AdminTask.createWMQQueue("9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1)", ["-name queue1 -jndiName jms/queues/Q1 -queueName APP1.QUEUE1"])
queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQQueue_1098737234986)
- Jacl 사용:
wsadmin>$AdminTask createWMQQueue 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) {-name queue1 -jndiName jms/queues/Q1 -queueName APP1.QUEUE1}
queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQQueue_1098737234986)