createSIBJMSQueue 명령
createSIBJMSQueue 명령을 사용하여 특정 범위에서 기본 메시징 제공자의 새 JMS 큐를 작성할 수 있습니다.
명령을 실행하려면 wsadmin 스크립트 클라이언트의 AdminTask 오브젝트를 사용하십시오.
wsadmin 스크립트 클라이언트는 Qshell에서
실행됩니다. .
자세한 정보는 wsadmin 스크립트를 사용하여 WebSphere 스크립트를 실행하도록 Qshell 구성의 내용을 참조하십시오..
- Jython의 사용 가능한 서비스 통합 버스 JMS 명령 목록과 각 명령의 간단한 설명에 대해서는
wsadmin 프롬프트에 다음 명령을 입력하십시오.
print AdminTask.help('SIBJMSAdminCommands')
- 제공된 명령에 대한 개요 도움말을 보려면 다음 명령을 wsadmin 프롬프트에 입력하십시오.
print AdminTask.help('command_name')
AdminConfig.save()
목적
createSIBJMSQueue 명령은 특정 범위에서 기본 메시징 제공자의 JMS 큐를 작성합니다.
대상 오브젝트
JMS 큐가 작성되는 기본 메시징 제공자의 범위입니다.
필수 매개변수
- -name
- 관리를 위해 이 JMS 큐를 식별하는 ID입니다.
- -jndiName
- 큐를 애플리케이션 서버 네임스페이스에 바인드하는 데 사용되는 JNDI 이름입니다.
- -queueName
- JMS 큐가 맵핑되는 서비스 통합 버스 대상의 이름입니다.
선택적 매개변수
- -description
- 관리를 위한 버스의 선택적 설명입니다.
- -deliveryMode Application | NonPersistent | Persistent
- 메시지를 이 큐에 전송하기 위해 MessageProducers가 사용하는 전달 모드입니다.
- -timeToLive
- 메시지가 이 큐에 전송된 디스패치 시간부터의 기본 시간 길이는 시스템에서 유지되어야 하고 여기서 0은 TTL(Time to Live) 값이 만료되지 않음을 나타냅니다. TTL(Time to Live) 매개변수가 제공되지 않으면 생성자의 값이 사용됩니다.
- -priority
- 이 큐에 전송되는 메시지의 우선순위입니다. 완료되지 않은 경우 생성자의 값이 사용됩니다. 범위는 0에서 9까지이며 여기서 0은 가장 낮은 우선순위이고 9는 가장 높은 우선순위입니다.
- -readAhead AsConnection | AlwaysOn | AlwaysOff
- 메시지 전달 중 미리 읽기(read-ahead) 최적화를 제어하는 데 사용됩니다. 기본값은 AsConnection입니다.
- -busName
- queueName으로 식별되는 서비스 통합 버스 대상이 구성되는 서비스 통합 버스의 이름입니다. 이 매개변수를 설정하지 않으면 애플리케이션이 연결되는 버스가 사용됩니다.
- -scopeToLocalQP TRUE | FALSE
- 이 JMS 큐를 사용하여 처리할 때 기본 서비스 통합 버스 큐 대상의 범위가
로컬 큐 위치로 지정되는지 여부를 표시합니다. 로컬 큐 위치는 JMS 애플리케이션이 연결되는 메시징 엔진에서
구성되는 큐 위치입니다.
이 옵션은 이 JMS 큐를 사용하여 메시지를 전송하고 수신할 때와
요청 메시지에서 응답 큐를 설정할 때 적용됩니다. 요청 메시지에서 응답 큐가 설정될 때
로컬 큐 위치는 응답 큐를 사용하는 애플리케이션이 응답 메시지를 보내는 메시징 엔진이 아니라
응답 큐를 설정하는 애플리케이션이 연결되는 메시징 엔진에 있습니다. 연결된 메시징 엔진에 대상에 대한 큐 위치가 없는 경우 이 옵션은 무시됩니다. 기본값은 FALSE입니다.
이 옵션의 기본 설정 변경은 WebSphere® Application Server 버전 7.0 이상 서버 또는 클라이언트에서 실행되며 WebSphere Application Server 버전 7.0 이상 서버에서 실행 중인 메시징 엔진에 연결되어 있는 JMS 애플리케이션에 의해 사용될 때만 지원됩니다. 이전 버전의 WebSphere Application Server에서 사용하면 애플리케이션에 예외가 발생합니다.
- -producerBind TRUE | FALSE
- JMS 생성자가 클러스터된 큐의 큐 위치를 바인드하는 방법을 표시합니다. 기본값은 FALSE입니다.
이 옵션의 기본 설정 변경은 WebSphere Application Server 버전 7.0 이상 서버 또는 클라이언트에서 실행되며 WebSphere Application Server 버전 7.0 이상 서버에서 실행 중인 메시징 엔진에 연결되어 있는 JMS 애플리케이션에 의해 사용될 때만 지원됩니다. 이전 버전의 WebSphere Application Server에서 사용하면 애플리케이션에 예외가 발생합니다.
- TRUE
- 메시징 시스템이 세션이 열릴 때 큐 위치를 선택합니다. 세션에서 생성되는 모든 메시지는 선택한 큐 위치로 전송됩니다. 메시징 시스템은 큐 위치를 선택할 때 producerPreferLocal 설정을 사용합니다.
- FALSE
- 메시징 시스템은 메시지가 전송될 때마다 큐 위치를 선택하며 이는 모든 사용 가능한 큐 위치에 대한 메시지의 워크로드 밸런싱이 될 수 있습니다. 메시징 시스템은 큐 위치를 선택할 때 producerPreferLocal 설정을 사용합니다.
- -producerPreferLocal TRUE | FALSE
- 메시징 시스템이 메시지를 생성할 큐 위치를 선택할 때 생성자에 로컬인 큐 위치가
다른 사용 가능한 큐 위치에 비해 선호되는지 여부를 표시합니다. 로컬 큐 위치는 JMS 애플리케이션이 연결되는 메시징 엔진에서
구성되는 큐 위치입니다. 기본값은 TRUE입니다.
이 옵션의 기본 설정 변경은 WebSphere Application Server 버전 7.0 이상 서버 또는 클라이언트에서 실행되며 WebSphere Application Server 버전 7.0 이상 서버에서 실행 중인 메시징 엔진에 연결되어 있는 JMS 애플리케이션에 의해 사용될 때만 지원됩니다. 이전 버전의 WebSphere Application Server에서 사용하면 애플리케이션에 예외가 발생합니다.
- -consumerGatherMessages TRUE | FALSE
- JMS 이용자 또는 브라우저는 메시징 시스템에 의해 서비스 통합 버스 대상의 단일 큐 위치에 접속됩니다.
이 매개변수는 JMS 이용자 또는 브라우저가 서비스 통합 버스 대상의 사용 가능한 임의의 큐 위치에서
메시지를 가져오는지(TRUE) 또는 접속되는 단일 큐 위치에서
메시지를 가져오는지(FALSE)를 표시합니다. 기본값은 FALSE입니다.
다중 큐 위치에서 메시지를 수집하면 성능 비용이 증가하게 되고 메시지 순서를 유지할 수 없습니다.
이 옵션의 기본 설정 변경은 WebSphere Application Server 버전 7.0 이상 서버 또는 클라이언트에서 실행되며 WebSphere Application Server 버전 7.0 이상 서버에서 실행 중인 메시징 엔진에 연결되어 있는 JMS 애플리케이션에 의해 사용될 때만 지원됩니다. 이전 버전의 WebSphere Application Server에서 사용하면 애플리케이션에 예외가 발생합니다.
예제
- Jython 사용:
wsadmin>AdminConfig.getid("/Node:9994GKCNode01" )
'9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)'
wsadmin>AdminTask.createSIBJMSQueue("WASINSTALL2Node01(cells/WASINSTALL2Cell01/ nodes/WASINSTALL2Node01|node.xml#Node_1)", ["-name", "jmsq2", "-jndiName", "jms/jnmsq2", "-queueName", "busq4jmsq2"])
'jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml #J2CAdminObject_1098737234986)'
wsadmin>AdminTask.listSIBJMSQueues("WASINSTALL2Node01(cells/WASINSTALL2Cell01 /nodes/WASINSTALL2Node01|node.xml#Node_1)")
'queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098711838691) jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098737234986)'
- Jacl 사용:
wsadmin>$AdminConfig getid /Node:9994GKCNode01
9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) {-name jmsq2 -jndiName jms/jnmsq2 -queueName busq4jmsq2}
jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098737234986)
wsadmin>$AdminTask listSIBJMSQueues 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098711838691) jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098737234986)
- Jython 사용:
wsadmin>AdminTask.createSIBJMSQueue("9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "MyJMSQueue", "-jndiName", "MyJMSQueue", "-busName bus1", "-queueName", "MyExistingQueue", "-deliveryMode", "Application", "-readAhead", "AsConnection", "-producerBind", "TRUE"])
- Jacl 사용:
wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1 {-name MyJMSQueue -jndiName MyJMSQueue -busName bus1 -queueName MyExistingQueue -deliveryMode Application -readAhead AsConnection -producerBind TRUE }
- Jython 사용:
wsadmin>AdminTask.createSIBJMSQueue("9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "MyJMSQueue", "-jndiName", "MyJMSQueue", "-busName bus1", "-queueName", "MyExistingQueue", "-deliveryMode", "Application", "-readAhead", "AsConnection", "-producerBind", "FALSE", "-producerPreferLocal", "FALSE", "-gatherMessages", "TRUE"])
- Jacl 사용:
wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1 {-name MyJMSQueue -jndiName MyJMSQueue -busName bus1 -queueName MyExistingQueue -deliveryMode Application -readAhead AsConnection -producerBind FALSE -producerPreferLocal FALSE -gatherMessages TRUE}
- Jython 사용:
wsadmin>AdminTask.createSIBJMSQueue("9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "MyJMSQueue", "-jndiName", "MyJMSQueue", "-busName bus1", "-queueName", "MyExistingQueue", "-deliveryMode", "Application", "-readAhead", "AsConnection", "-scopeToLocalQP", "TRUE"])
- Jacl 사용:
wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1 {-name MyJMSQueue -jndiName MyJMSQueue -busName bus1 -queueName MyExistingQueue -deliveryMode Application -readAhead AsConnection -scopeToLocalQP TRUE}