Comando mqsicreateusernameserver

Plataformas Suportadas

  • Plataformas Windows 2000, Windows XP
  • UNIX
  • z/OS

Finalidade

Em plataformas Windows e UNIX, este comando:
  • Cria um gerenciador de filas do WebSphere MQ, se ainda não existir um.
    Nota:
    1. Se um gerenciador de filas do WebSphere MQ for criado como resultado do uso do comando mqsicreateusernameserver, a DLQ padrão fornecida pela WebSphere MQ (SYSTEM.DEAD.LETTER.QUEUE) será automaticamente ativada. As definições de segurança são iguais às de outras filas do WebSphere MQ específicas do intermediário.

      Se você optar por criar o gerenciador de filas separadamente, configure uma DLQ (Dead Letter Queue). A DLQ é referida pelo WebSphere Business Integration Event Broker quando ocorrem erros no processamento de mensagens nos fluxos de mensagens.

      Se uma mensagem em um fluxo de mensagens definido pelo usuário ou no modelo de publicação/assinatura não puder ser processada, ela será roteada para essa DLQ como último recurso. Se você preferir que a mensagem seja recuperada para a fila de entrada, descontinuando efetivamente o fluxo de mensagens até que o problema seja resolvido, desative a DLQ.

      O comando mqsideleteusernameserver não exclui essa fila (a menos que o gerenciador de filas seja excluído).

    2. Se estiver utilizando um gerenciador de filas do WebSphere MQ que foi criado independentemente do comando mqsicreateusernameserver, será possível definir clusters. Isso simplifica a configuração.

  • Inicia o gerenciador de filas do WebSphere MQ, se ele ainda não estiver em execução.

    Se o gerenciador de filas for criado por esse comando, ele não será iniciado como um serviço do Windows, e portanto, parará se você efetuar logoff. Para evitar que isto ocorra, permaneça conectado ou altere o status de inicialização do serviço do gerenciador de filas. (Se você travar sua estação de trabalho, o gerenciador de filas do WebSphere MQ não será parado).

  • Cria filas do WebSphere MQ específicas do Servidor de Nomes do Usuário, se ainda não existirem.
  • No Windows, instala um serviço sob o qual o Servidor de Nomes do Usuário é executado.
  • Cria um registro para o componente no registro do intermediário.

No z/OS, a funcionalidade desse comando não é igual à das plataformas Windows ou UNIX porque não são executadas definições relacionadas ao WebSphere MQ.

No z/OS, esse comando deve ser executado em um código de idioma do C. Todas as mensagens produzidas estão em inglês, independentemente do código de idioma do usuário atual.

Sintaxe

Plataformas Windows e plataformas UNIX

z/OS

Parâmetros

-i ServiceUserID
(Obrigatório - Plataformas Windows e UNIX) O ID do usuário sob o qual o intermediário é executado.
Pode ser especificado em qualquer sintaxe válida do username. Em plataformas Windows, eles são:
  • domain\username
  • \\server\username
  • .\username
  • username
Em sistemas UNIX, apenas o último formato, username, é válido.

Se você utilizar o formato não qualificado para este ID do usuário (username) em plataformas Windows, o sistema operacional pesquisa o ID do usuário em todo o seu domínio, começando com o sistema local. Essa pesquisa pode levar algum tempo para concluir.

O ServiceUserID especificado deve ser um membro do grupo local mqbrkrs. Em plataformas Windows, ele pode ser um membro indireto ou direto do grupo. O ServiceUserID também deve ter autorização para acessar o diretório pessoal (no qual o WebSphere Business Integration Event Broker foi instalado).

Os requisitos de segurança do ServiceUserID estão detalhados no Requisitos de Segurança para Plataformas Windows para plataformas Windows e no Requisitos de Segurança para Plataformas UNIX para plataformas UNIX.

-a ServicePassword
(Obrigatório - Plataformas Windows e UNIX) A senha para o ServiceUserID.
-c <ComponentDirectory>
(Obrigatório - z/OS) O diretório raiz do Servidor de Nomes de Usuários criado. Por exemplo, /wmqiv50/MQP1UNS.
-q QueueManagerName
(Obrigatório) O nome do gerenciador de filas associado ao Servidor de Nome de Usuário.

Em plataformas Windows e UNIX, se o gerenciador de filas ainda não existir, ele será criado por este comando. Ele não é criado como o gerenciador de filas padrão: se você desejar que ele seja o padrão neste sistema, deverá criá-lo antes de emitir esse comando.

O atributo do gerenciador de filas MAXMSGL (comprimento máximo de mensagens que podem ser colocadas em filas) é atualizado para 100 MB. Isto é feito independentemente de o gerenciador de filas ter sido criado por este comando.

-d SecurityDomainName
(Optional - Plataformas Windows e UNIX) O nome do domínio de segurança do sistema Windows. Se ele não estiver especificado, será assumido como padrão o domínio de segurança do sistema Windowslocal do sistema. Para obter detalhes adicionais sobre a implementação de segurança no WebSphere Business Integration Event Broker, consulte Configurando a Segurança no Domínio do Intermediário.
-r RefreshInterval
(Opcional) O intervalo, especificado em segundos, no qual o Servidor de Nome de Usuário interroga o subsistema de segurança por alterações nos atributos do usuário ou do grupo. Se ele não for especificado, será utilizado o intervalo padrão de 60 segundos do Servidor de Nome de Usuário.
-w Workpath
(Opcional - Plataformas Windows e UNIX) Diretório no qual os arquivos de trabalho para o Servidor de Nome de Usuário são armazenados. Se não for especificado, será utilizado o valor especificado durante a instalação do produto.
-g AuthProtocolDataSource
(Opcional - plataformas Windows e UNIX) Utilize esse parâmetro para especificar o nome e o local do arquivo de senhas utilizado para originar quaisquer informações relacionadas ao protocolo. Por padrão, espera-se que o arquivo esteja localizado no diretório home. Se você armazenar o arquivo em um local diferente, especifique o local do caminho completo com o nome do arquivo.

Duas amostras, password.dat e pwgroup.dat, são fornecidas no diretório examples/auth sob o diretório home do produto.

-j
(Opcional - Plataformas Windows e UNIX) Indica que grupos e membros do grupo serão definidos na origem de dados para o protocolo de autenticação em vez de extraídos do sistema operacional.

Filas Criadas do Websphere MQ

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

A autoridade de acesso é concedida para o grupo WebSphere Business Integration Event Broker grupo mqbrkrs a todas estas filas.

Respostas

Esse comando retorna as seguintes respostas:
  • BIP8011 Impossível criar dados de configuração
  • BIP8012 Impossível conectar aos componentes do sistema
  • BIP8014 O componente não pode ser criado
  • BIP8022 ID do usuário/senha inválidos
  • BIP8030 Incapaz de modificar os privilégios do ID do usuário
  • BIP8048 Incapaz de iniciar o gerenciador de filas
  • BIP8050 Impossível criar o gerenciador de filas
  • BIP8051 Impossível criar fila
  • BIP8053 Impossível definir segurança para o gerenciador de filas
  • BIP8054 Impossível definir segurança para a fila
  • BIP8056 Gerenciador de filas desconhecido
  • BIP8068 Argumento inteiro requerido
  • BIP8084 Impossível criar diretório
  • BIP8087 O componente já existe
  • BIP8093 Gerenciador de filas sendo criado
  • BIP8094 Gerenciador de filas parando

Exemplos


mqsicreateusernameserver -i wbrkuid -a wbrkpw
   -q WBRK_QM -r 1000

Conceitos relacionados
Servidor de Nome de Usuário

Tarefas relacionadas
Criando um Servidor de Nome de Usuário

Referências relacionadas
Preferência de Sintaxe
Comando mqsichangeusernameserver
Comando mqsideleteusernameserver