mqsicreateconfigmgr 명령

지원되는 플랫폼

목적

이 명령은 다음 조치를 완료했습니다.
  • 이미 존재하지 않을 경우, 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 플래그로 지정한 경우)에 대한 액세스 권한도 부여되어야 합니다.

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

변경 시작Windows 에서변경 끝 서비스 사용자 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 Administrators 그룹의 구성원이어야 합니다.

변경 시작UNIX 시스템에서 이 명령을 호출하는 데 사용되는 사용자 ID는 mqbrkrs 그룹의 구성원이어야 합니다. 변경 끝

변경 시작z/OS 시스템에서 이 명령을 호출하는 데 사용되는 사용자 ID는 구성요소 디렉토리에 대한 읽기 및 쓰기 액세스가 있는 그룹의 구성원이어야 합니다.변경 끝

작성되는 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 마지막 갱신 날짜: 2006/08/21
an23000_