Comando mqsicreateusernameserver

Plataformas Suportadas

Finalidade

Em plataformas Windows e sistemas Linux e UNIX, esse comando:
  • Cria um gerenciador de filas do WebSphere MQ, se ainda não existir um.
    Nota:
    1. (Não z/OS) Se um gerenciador de filas do WebSphere MQ for criado como resultado da utilização do comando mqsicreateusernameserver, o DLQ padrão fornecido pelo WebSphere MQ (SYSTEM.DEAD.LETTER.QUEUE) será ativado automaticamente. 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 Message 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.

  • (Não z/OS) Inicia o gerenciador de filas do WebSphere MQ, se 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.

Sintaxe

Plataformas Windows e Sistemas Linux e UNIX

Comando do Console do z/OS

Parâmetros

-i ServiceUserID
(Obrigatório - Plataformas Windows e sistemas Linux 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 Linux e 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 Message Broker foi instalado).

Os requisitos de segurança para o ServiceUserID são detalhados em Requisitos de Segurança para Plataformas Windows para plataformas Windows e em Requisitos de Segurança para Plataformas Linux e UNIX para sistemas Linux e UNIX.

-a ServicePassword
(Obrigatório - Plataformas Windows e sistemas Linux e UNIX) A senha para o ServiceUserID.

Para compatibilidade com os sistemas existentes, você ainda pode especificar <password>. Entretanto, se não especificar uma senha com este parâmetro ao executar o comando, será solicitado que você digite uma senha durante sua chamada e digite a senha uma segunda vez para verificar se ela foi digitada corretamente.

-q QueueManagerName
(Obrigatório) O nome do gerenciador de filas associado ao Servidor de Nome de Usuário.

Em plataformas Windows e sistemas Linux e UNIX, se o gerenciador de filas ainda não existir, ele será criado por esse 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
(Opcional - Plataformas Windows) 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 Message 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 sistemas Linux e UNIX) O diretório no qual os arquivos de trabalho do 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 sistemas Linux e UNIX) Utilize esse parâmetro para especificar o nome e o local do arquivo de senha utilizado para especificar a origem de 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 sistemas Linux e UNIX) Indica que grupos e associações do grupo são definidos na origem de dados para o protocolo de autenticação, em vez de extraídos do sistema operacional.
1
(Opcional - Apenas z/OS) O registro é transmitido, o que cria apenas o registro Servidor de Nome de Usuário.
2
(Opcional - Apenas z/OS) WebSphere MQ é transmitido, o que cria apenas as filas Servidor de Nome de Usuário WebSphere MQ.

Filas do WebSphere MQ Criadas

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

A autoridade de acesso é concedida para o grupo WebSphere Message 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
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an07200_