물리적 대상 만들기

물리적 대상을 만들려면 imqcmd create 하위 명령을 사용합니다. 다음은 create 하위 명령 구문입니다.

create dst -t destType -n 
destName [-o property=value
] [-o property=value1]
…

예를 들어, 대기열 대상을 만들려면 다음과 같이 명령을 입력합니다.

imqcmd create dst -n myQueue -t q -o "maxNumActiveConsumers=5"

주제 대상을 만들려면 다음과 같이 명령을 입력합니다.

imqcmd create dst -n myTopic -t t -o "maxBytesPerMsg=5000"

물리적 대상을 만들 때 다음을 지정해야 합니다.

• 물리적 대상 유형, t(주제) 또는 q(대기열).

• 물리적 대상 이름. 이름 지정 규칙은 다음과 같습니다.

  • 이름은 영숫자만 포함할 수 있으며공백을 포함할 수 없습니다.

  • 이름은 영문자, 밑줄 문자(_) 또는 달러 기호($)로 시작할 수 있습니다. mq 문자열로는 시작할 수 없습니다.

  기본값이 아닌 모든 물리적 대상 등록 정보 값

물리적 대상을 업데이트할 때 등록 정보도 설정할 수 있습니다.

많은 물리적 대상 등록 정보가 브로커 메모리 자원과 메시지 흐름에 영향을 미칩니다. 예를 들어, 물리적 대상에 보낼 수 있는 생성자 수, 생성자가 보낼 수 있는 메시지 수와 크기, 물리적 대상 제한에 도달할 때 브로커가 수행해야 하는 응답 등을 지정할 수 있습니다. 이러한 제한은 브로커 구성 등록 정보를 통해 제어되는 브로커 전체 제한과 비슷합니다.

다음 등록 정보는 대기열 대상과 주제 대상 모두에 사용됩니다.

• maxNumMsgs. 물리적 대상에 허용되는 사용되지 않은 최대 메시지 수를 지정합니다.

• maxTotalMsgBytes. 물리적 대상의 사용되지 않은 메시지에 허용되는 최대 메모리 합계(바이트)를 지정합니다.

• limitBehavior. 메모리 제한 임계값에 도달할 경우에 브로커가 응답하는 방법을 지정합니다.

• maxBytesPerMsg. 물리적 대상에 허용되는 단일 메시지의 최대 크기(바이트)를 지정합니다.

• maxNumProducers. 물리적 대상의 최대 생성자 수를 지정합니다.

• consumerFlowLimit. 일괄적으로 사용자에게 전달되는 최대 메시지 수를 지정합니다.

• isLocalOnly. 브로커 클러스터에만 적용됩니다. 물리적 대상이 다른 브로커에 복제되지 않도록 지정합니다. 따라서, 메시지 전달이 로컬 사용자(물리적 대상이 생성되는 브로커에 연결된 사용자)에게만 제한됩니다.

• useDMQ. 물리적 대상의 사용 불능 메시지를 제거할지, 사용 불능 메시지 대기열에 넣을지를 지정합니다.

다음은 대기열 대상에만 사용되는 등록 정보입니다.

• maxNumActiveConsumers. 대기열 대상으로부터의 로드 균형 조정 전달에서 활성 상태가 될 수 있는 최대 사용자 수를 지정합니다.

• maxNumBackupConsumers. 대기열 대상으로부터의 로드 균형 조정 전달 중에 오류가 발생할 경우 활성 사용자를 대신할 수 있는 백업 사용자의 최대 수를 지정합니다.

• localDeliveryPreferred. 브로커 클러스터의 로드 균형 조정된 대기열 전달에만 적용됩니다. 로컬 브로커에 사용자가 없는 경우에만 원격 사용자에게 메시지를 전달하도록 지정합니다.

물리적 대상 등록 정보에 대한 자세한 내용은 15 장, 물리적 대상 등록 정보 참조을 참조하십시오.

자동 생성 대상의 경우 브로커의 인스턴스 구성 파일에 기본 등록 정보 값을 설정합니다. 자동 생성 등록 정보에 대한 자세한 내용은 표 14–3을 참조하십시오.