Comando mqsicreateusernameserver

Plataformas Suportadas

  • Plataformas 2000, XP
  • z/OS

Finalidade

Em plataformas e , este comando:
  • Cria um gerenciador de filas do , se ainda não existir um.
    Nota:
    1. Se um gerenciador de filas do for criado como resultado do uso do comando , a DLQ padrão fornecida pela (SYSTEM.DEAD.LETTER.QUEUE) será automaticamente ativada. As definições de segurança são iguais às de outras filas do 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 quando ocorrem erros no processamento de mensagens nos .

      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 que foi criado independentemente do comando , será possível definir clusters. Isso simplifica a configuração.

  • Inicia o gerenciador de filas do , 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 , 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 não será parado).

  • Cria filas do específicas do Servidor de Nomes do Usuário, se ainda não existirem.
  • No , 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 ou porque não são executadas definições relacionadas ao .

No , 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 e ) O ID do usuário sob o qual o intermediário é executado.
Pode ser especificado em qualquer sintaxe válida do username. Em plataformas , eles são:
  • domain\username
  • \\server\username
  • .\username
  • username
Em sistemas , apenas o último formato, username, é válido.

Se você utilizar o formato não qualificado para este ID do usuário (username) em plataformas , 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 , 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 foi instalado).

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

-a ServicePassword
(Obrigatório - Plataformas e ) 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 .

Em plataformas e , 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 e ) O nome do domínio de segurança do sistema . Se ele não estiver especificado, será assumido como padrão o domínio de segurança do sistema local do sistema. Para obter detalhes adicionais sobre a implementação de segurança no , consulte Configurando a Segurança no Domínio do Intermediário.
-r RefreshInterval
(Opcional) O intervalo, especificado em segundos, no qual o 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 .
-w Workpath
(Opcional - Plataformas e ) Diretório no qual os arquivos de trabalho para o são armazenados. Se não for especificado, será utilizado o valor especificado durante a instalação do produto.
-g AuthProtocolDataSource
(Opcional - plataformas e ) 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 e ) 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 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


 -i  -a 
   -q  -r 1000

Conceitos relacionados

Tarefas relacionadas
Criando um

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