mqsicreateusernameserver 명령

지원되는 플랫폼

목적

Windows 플랫폼, LinuxUNIX 시스템에서 이 명령을 수행하십시오.
  • 이미 존재하지 않을 경우, WebSphere MQ 큐 관리자를 작성합니다.
    주:
    1. (z/OS가 아님) WebSphere MQ 큐 관리자가 mqsicreateusernameserver 명령을 사용한 결과로 작성되는 경우, WebSphere MQ에서 제공하는 디폴트 DLQ(SYSTEM.DEAD.LETTER.QUEUE)가 자동으로 사용됩니다. 보안 설정은 다른 브로커 특정 WebSphere MQ 큐의 보안 설정과 같습니다.

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

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

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

    2. mqsicreateusernameserver 명령과 독립적으로 작성된 WebSphere MQ 큐 관리자를 사용 중인 경우, 클러스터를 정의할 수 있습니다. 클러스터 정의는 구성을 단순화합니다.

  • (z/OS이 아님) WebSphere MQ 큐 관리자는 실행되지 않는 경우에 시작됩니다.

    큐 관리자를 이 명령으로 작성하면, Windows 서비스로 시작되지 않습니다. 로그오프하는 경우에는 정지합니다. 이러한 상황을 피하려면, 로그온 상태를 유지하거나 큐 관리자 서비스의 시작 상태를 변경하십시오. (워크스테이션을 잠그면 WebSphere MQ 큐 관리자가 정지되지 않습니다.)

  • 존재하지 않는 경우, 사용자 이름 서버 특정 WebSphere MQ 큐를 작성합니다.
  • Windows에서 사용자 이름 서버를 실행하는 서비스를 설치합니다.
  • 브로커 레지스트리에 구성요소 레코드를 작성합니다.

구문

Windows 플랫폼, Linux 및 UNIX 시스템

z/OS 콘솔 명령

매개변수

-i ServiceUserID
(필수 - Windows 플랫폼, LinuxUNIX 시스템) 브로커를 실행하는 사용자 ID.
사용자 ID는 올바른 username 구문으로 지정할 수 있습니다. Windows 플랫폼에서는 다음과 같습니다.
  • domain\username
  • \\server\username
  • .\username
  • username
LinuxUNIX 시스템에서는 최종 형식인 username만 유효합니다.

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

지정한 ServiceUserIDmqbrkrs 로컬 그룹의 구성원이어야 합니다. Windows 플랫폼에서는 그룹의 간접 또는 직접 구성원이 될 수 있습니다. ServiceUserID에는 홈 디렉토리(WebSphere Message Broker가 설치된 위치)에 대한 액세스 권한도 부여해야 합니다.

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

-a ServicePassword
(필수 - Windows 플랫폼, LinuxUNIX 시스템) ServiceUserID의 암호.

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

-q QueueManagerName
(필수) 사용자 이름 서버와 연관된 큐 관리자의 이름

Windows 플랫폼, LinuxUNIX 시스템에서 큐 관리자가 존재하지 않으면, 이 명령으로 작성됩니다. 디폴트 큐 관리자로 작성되지는 않습니다. 이 큐 관리자를 시스템에서 디폴트 큐 관리자로 사용하려면, 이 명령을 발행하기 전에 큐 관리자를 작성해야 합니다.

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

-d SecurityDomainName
(선택사항 - Windows 플랫폼) Windows 시스템 보안 도메인의 이름. 이 이름을 지정하지 않으면 디폴트로 시스템의 로컬 Windows 시스템 보안 도메인으로 지정됩니다. WebSphere Message Broker에서 보안 구현에 대한 자세한 내용은 브로커 도메인 보안 설정을 참조하십시오.
-r RefreshInterval
(선택사항) 사용자 이름 서버가 보안 시스템에 사용자 또는 그룹 속성에 대한 변경사항에 대해 질문하는 간격(초 단위). 지정하지 않으면, 사용자 이름 서버의 디폴트 간격인 60초가 사용됩니다.
-w Workpath
(선택사항 - Windows 플랫폼, LinuxUNIX 시스템) 사용자 이름 서버의 작업 파일이 저장되는 디렉토리. 지정하지 않으면, 제품 설치 시 지정한 디폴트 디렉토리가 사용됩니다.
-g AuthProtocolDataSource
(선택사항 - Windows 플랫폼, LinuxUNIX 시스템) 이 매개변수를 사용하여 프로토콜 관련 정보의 소스로 사용할 암호 파일의 이름 및 위치를 지정합니다. 기본적으로, 이 파일은 홈 디렉토리에서 찾을 수 있습니다. 파일을 다른 위치에 저장하는 경우, 파일 이름이 있는 전체 경로 위치를 지정하십시오.

두 개의 샘플 password.datpwgroup.dat은 제품 홈 디렉토리 아래에 있는 examples/auth 디렉토리에 제공됩니다.

-j
(선택사항 - Windows 플랫폼, LinuxUNIX 시스템) 그룹 및 그룹 멤버쉽이 운영 체제에서 도출되지 않고 인증 프로토콜의 데이터 소스에 지정되어 있음을 표시합니다.
1
(선택사항 - z/OS 전용) 사용자 이름 서버 레지스트리만 작성하는 레지스트리 패스.
2
(선택사항 - z/OS 전용) 사용자 이름 서버 WebSphere MQ 큐만 작성하는 WebSphere MQ 패스.

작성된 WebSphere MQ

  • SYSTEM.BROKER.SECURITY.QUEUE
  • SYSTEM.BROKER.MODEL.QUEUE

WebSphere Message Broker 그룹 mqbrkrs에 이러한 모든 큐에 대한 액세스 권한이 부여됩니다.

응답

이 명령은 다음 응답을 리턴합니다.
  • BIP8011 구성요소 구성 데이터를 작성할 수 없습니다.
  • BIP8012 시스템 구성요소에 연결할 수 없습니다.
  • BIP8014 구성요소를 작성할 수 없습니다.
  • BIP8022 올바르지 않은 사용자 ID/암호가 제공되었습니다.
  • BIP8030 사용자 ID 권한을 수정할 수 없습니다.
  • BIP8048 큐 관리자를 시작할 수 없습니다.
  • BIP8050 큐 관리자를 작성할 수 없습니다.
  • BIP8051 큐를 작성할 수 없습니다.
  • BIP8053 큐 관리자의 보안 속성을 설정할 수 없습니다.
  • BIP8054 큐의 보안 속성을 설정할 수 없습니다.
  • BIP8056 큐 관리자가 존재하지 않습니다.
  • BIP8068 정수 인수가 필요합니다.
  • BIP8084 디렉토리를 작성할 수 없습니다.
  • BIP8087 구성요소가 이미 존재합니다.
  • BIP8093 큐 관리자를 작성 중입니다.
  • BIP8094 큐 관리자를 정지 중입니다.

mqsicreateusernameserver -i wbrkuid -a wbrkpw
      -q WBRK_QM -r 1000
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
an07200_