mqsicreateconfigmgr 명령

지원되는 플랫폼

  • Windows
  • LinuxUNIX 시스템
  • z/OS

목적

이 명령은 다음 조치를 완료합니다.
  • 이미 존재하지 않을 경우, WebSphere MQ 큐 관리자를 작성합니다.
    참고사항:
    1. WebSphere MQ 큐 관리자가 mqsicreateconfigmgr 명령을 사용한 결과로 작성되는 경우, WebSphere MQ가 제공하는 디폴트 DLQ(SYSTEM.DEAD.LETTER.QUEUE)가 자동으로 사용 가능해집니다. 보안 설정은 다른 브로커 특정 WebSphere MQ 큐의 보안 설정과 같습니다.

      큐 관리자를 개별적으로 작성하기로 선택하는 경우, 데드-레터 큐(DLQ)를 설정하십시오. DLQ는 메시지 플로우의 메시지 처리 오류가 발생할 때 WebSphere Message Broker에 의해 참조됩니다.

      사용자 정의 메시지 플로우 또는 Publish/Subscribe 모델의 메시지를 처리할 수 없는 경우, 마지막 방법으로 메시지가 이 DLQ로 라우트됩니다. 메시지를 입력 큐로 백아웃하여 문제가 해결될 때까지 메시지 플로우를 효과적으로 정지하려면, DLQ를 사용 불가능하게 하십시오.

      mqsideleteconfigmgr 명령은 이 큐를 삭제하지 않습니다(큐 관리자를 삭제하지 않는 경우).

    2. mqsicreateconfigmgr 명령과 독립적으로 작성된 WebSphere MQ 큐 관리자를 사용 중인 경우, 클러스터를 정의하기로 선택하면 이를 정의할 수 있습니다. 이 옵션은 구성을 단순화합니다.
  • 이미 실행 중이 아니면 변경 시작WebSphere MQ변경 끝 큐 관리자를 시작합니다.
  • 존재하지 않는 경우, 구성 관리자 특정 WebSphere MQ 큐 및 채널을 작성합니다.
  • 내부 저장소에서 구성 관리자에 대한 데이터베이스 테이블을 작성합니다. 이전 릴리스의 구성 저장소에서 데이터를 전송해야 하는 경우 db2DatabaseToMigrate, migrationDatabaseUserIdmigrationDatabasePassword 매개변수를 사용하십시오.
  • 변경 시작-n 매개변수를 사용하여 이 명령을 실행한 후 해당 명령에 -n 매개변수를 지정하지 않고 mqsideleteconfigmgr을 사용하여 구성 관리자를 삭제하면 구성 저장소가 포함된 새 데이터베이스가 삭제되지 않습니다.

    이 상황에서 이 명령을 다시 실행하고 -n 매개변수를 지정하면 새 데이터베이스가 아직 있기 때문에 매개변수가 무시됩니다.

    변경 끝
  • (Windows 전용) 구성 관리자를 실행할 Windows 서비스를 설치합니다.
  • 브로커 레지스트리에 구성요소 레코드를 작성합니다.

VisualAge for Java를 설치하고, 이 설치의 일부로 WebSphere MQ 커넥터를 선택한 경우, isualAge for Java에 대한 CLASSPATH 항목이 사용 중인 Windows 플랫폼(서버 또는 Java 클라이언트)의 WebSphere MQ에 대한 CLASSPATH 항목 에 표시되어야 합니다. 이 요구사항을 통해 구성 관리자mqsistart 명령에 의해 시작될 때 올바른 WebSphere MQ 클래스(VisualAge 클래스가 아닌)에 액세스할 수 있습니다. 구성 관리자가 이 영역에서 오류를 발견하면, Windows 시스템 이벤트 로그에 BIP1004 메시지를 기록합니다.

구문

Windows

LinuxUNIX 시스템

z/OS

매개변수

configmgrName
(선택사항 - Windows. 필수 - Linux, UNIX 시스템z/OS) 작성하려는 구성 관리자의 이름.

Linux, UNIX 시스템z/OS에서 첫 번째 지정된 매개변수여야 합니다. Linux, UNIX 시스템z/OS에서 대소문자를 구분합니다.

이 매개변수가 지정되지 않은 경우 Windows의 디폴트 이름은 'ConfigMgr'입니다.

-i ServiceUserID
(필수) 서비스가 실행하는 사용자 ID.

이 매개변수는 플랫폼에 대한 올바른 사용자 이름 구문으로 지정될 수 있습니다.

지정한 ServiceUserIDmqbrkrs 로컬 그룹의 구성원(직접 또는 간접)이어야 하고, 홈 디렉토리(WebSphere Message Broker가 설치된 위치) 및 작업 디렉토리(-w 플래그로 지정한 경우)에 대한 액세스 권한도 부여되어야 합니다. 또한, 이 사용자 ID는 해당하는 mqm 로컬 그룹 또는 로컬 Windows Administrators 그룹의 구성원(직접 또는 간접)이어야 합니다.

ServiceUserID에 대한 보안 요구사항은 Windows의 경우 Windows 플랫폼의 보안 요구사항에서 자세히 설명되고, UNIX 플랫폼의 경우 Linux 및 UNIX 플랫폼의 보안 요구사항에서 설명됩니다.

이 사용자 ID에 대해 규정되지 않은 형식(username)을 사용하면, 운영 체제가 로컬 시스템부터 시작하여 도메인 전체에서 사용자 ID를 검색합니다. 검색을 완료하는 데 어느 정도의 시간이 걸릴 수 있습니다.

-a ServicePassword
(필수) ServiceUserID의 암호.

기존 시스템과의 호환성의 경우 <password>를 지정할 수 있습니다. 그러나 명령을 실행할 때 이 매개변수로 암호를 지정하지 않는 경우 호출 중 암호를 입력하고 올바르게 입력했는지 확인하기 위해 두 번째로 암호를 입력하도록 프롬프트가 표시됩니다.

-q QueueManagerName
(필수) 구성 관리자와 연관된 큐 관리자의 이름.

큐 관리자가 아직 없으면, 이 명령에 의해 작성됩니다. 디폴트 큐 관리자로 작성되지는 않습니다. 이 큐 관리자를 시스템에서 디폴트 큐 관리자로 사용하려면, 이 명령을 발행하기 전에 큐 관리자를 작성하십시오.

큐 관리자 속성 MAXMSGL(큐에 넣을 수 있는 메시지의 최대 길이)이 100MB로 갱신됩니다. 이 갱신은 이 명령에 의한 큐 관리자 작성 여부에 상관없이 수행됩니다.

-n db2DatabaseToMigrate
(선택사항) 구성 저장소 테이블을 보유하기 위해 이전 릴리스에서 작성한 데이터베이스의 이름.

이 데이터베이스가 이미 존재해야 합니다. JDBC에 의해 액세스가 제공되므로 이 데이터베이스에 대한 ODBC 연결을 작성할 필요가 없습니다.

-u migrationDataBaseUserID
(선택사항) 구성 저장소 데이터베이스(이전 릴리스에서 작성됨)에 액세스할 때 사용할 사용자 ID.
-p migrationDataBasePassword
(선택사항) 구성 저장소 데이터베이스(이전 릴리스에서 작성됨)에 액세스할 때 사용할 사용자 ID의 암호. 지정하지 않으면, 이 매개변수의 디폴트로 -a로 지정된 ServicePassword가 사용됩니다.

기존 시스템과의 호환성의 경우 <password>를 지정할 수 있습니다. 그러나 명령을 실행할 때 이 매개변수로 암호를 지정하지 않는 경우 호출 중 암호를 입력하고 올바르게 입력했는지 확인하기 위해 두 번째로 암호를 입력하도록 프롬프트가 표시됩니다.

-s UserNameServerQueueManagerName
(선택사항) 사용자 이름 서버와 연관된 WebSphere MQ 큐 관리자의 이름. 이 매개변수를 지정하지 않으면, 구성 관리자사용자 이름 서버가 정의되지 않은 것으로 간주하여 이와 통신하려고 시도하지 않습니다.
-w Workpath
(선택사항) 구성 관리자의 작업 파일이 저장되는 디렉토리. 지정하지 않으면, 제품 설치시 지정한 디폴트 디렉토리가 사용됩니다.
1
(선택사항- z/OS 전용) 구성 관리자 레지스트리만 삭제하는 레지스트리 전달
2
(선택사항 - z/OS 전용) 구성 관리자 WebSphere MQ 큐만 작성하는 WebSphere MQ 전달
주: 이 조치는 구성 관리자 레지스트리가 존재하는 경우에만 수행할 수 있습니다.

권한 부여

이 명령은 ServiceUserID의 보안 권한을 변경합니다. 이 명령을 호출하는 데 사용되는 사용자 ID는 이 로컬 시스템에서 Windows 관리자 그룹의 구성원이어야 합니다.

작성되는 Websphere MQ 큐

  • SYSTEM.BROKER.CONFIG.QUEUE
  • SYSTEM.BROKER.CONFIG.REPLY
  • SYSTEM.BROKER.ADMIN.REPLY
  • SYSTEM.BROKER.SECURITY.REPLY
  • SYSTEM.BROKER.MODEL.QUEUE

WebSphere Message Broker 그룹 mqbrkrs에 이러한 모든 큐에 대한 액세스 권한이 부여됩니다. DLQ가 사용 가능하면, 이 큐도 같은 권한을 갖습니다.

작성되는 Websphere MQ 채널

  • SYSTEM.BKR.CONFIG

작성되는 데이터베이스 테이블

이 명령이 작성되는 데이터베이스 테이블은 구성 관리자에 의해 관리됩니다.

응답

이 명령은 다음 응답을 리턴합니다.
  • BIP8011 구성요소 구성 데이터를 작성할 수 없습니다.
  • BIP8012 시스템 구성요소에 연결할 수 없습니다.
  • BIP8014 구성요소를 작성할 수 없습니다.
  • BIP8022 올바르지 않은 사용자 ID/암호가 제공되었습니다.
  • BIP8030 사용자 ID 권한을 수정할 수 없습니다.
  • BIP8048 큐 관리자를 시작할 수 없습니다.
  • BIP8050 큐 관리자를 작성할 수 없습니다.
  • BIP8051 큐를 작성할 수 없습니다.
  • BIP8053 큐 관리자의 보안 속성을 설정할 수 없습니다.
  • BIP8054 큐의 보안 속성을 설정할 수 없습니다.
  • BIP8055 Java 클래스를 로드할 수 없습니다.
  • BIP8056 큐 관리자가 존재하지 않습니다.
  • BIP8074 JVM을 작성할 수 없습니다.
  • BIP8075 Java 예외가 포착되었습니다.
  • BIP8076 현재 작업 디렉토리를 설정할 수 없습니다.
  • BIP8077 구성 데이터 초기화 오류입니다.
  • BIP8078 구성 데이터 초기화 오류입니다.
  • BIP8084 디렉토리를 작성할 수 없습니다.
  • BIP8087 구성요소가 이미 존재합니다.
  • BIP8093 큐 관리자를 작성 중입니다.
  • BIP8094 큐 관리자를 정지 중입니다.
  • BIP8097 Java 오브젝트를 작성할 수 없습니다.

mqsicreateconfigmgr CMGR01 -i wbrkuid -a wbrkpw -q WBRK_CONFIG_QM
관련 개념
구성 관리자
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 5월 12, 2006
an23000_