Comando mqsicreatebroker - z/OS

Use o comando mqsicreatebroker para criar um broker em um sistema z/OS.

Sintaxe

Comando z/OS - BIPCRBK

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>---mqsicreatebroker----BrokerName-- -q--QueueManagerName------>

>--+------+--+------+--+------------------+--------------------->
   '- -1 -'  '- -2 -'  '- -l--UserLilPath-'   

>--+-----------------------+------------------------------------>
   '- -P--HTTPListenerPort-'   

>--+---------------------------------+-------------------------->
   '- -g--ConfigurationChangeTimeout-'   

>--+-----------------------------------+------------------------>
   '- -k--InternalConfigurationTimeout-'   

>--+------------------------------+----------------------------->
   '- -v--StatisticsMajorInterval-'   

>--+------------------------------------------+----------------->
   '- -y--LdapPrincipal-- -z--LdapCredentials-'   

>--+------------------------+--+--------------------+----------->
   '- -c --ICUConverterPath-'  '- -x --UserExitPath-'   

>--+--------------------+--------------------------------------><
   '- -s --+-active---+-'   
           '-inactive-'     

Parâmetros

BrokerName
(Necessário) O nome do broker que você está criando. Esse parâmetro deve ser o primeiro parâmetro. Se você criar um broker com um nome em maiúsculas, também deverá especificar o nome em maiúsculas no WebSphere Message Broker Toolkit.

Para restrições do conjunto de caracteres que você pode utilizar, consulte Caracteres Permitidos em Comandos.

-q QueueManagerName
(Necessário) O nome do gerenciador de filas, (ou do gerenciador de filas de diversas instâncias se estiver criando um broker com diversas instâncias) que está associado a essa instância do broker. Utilize o mesmo nome para seu broker e o gerenciador de filas para simplificar a organização e a administração de sua rede. Nomes de gerenciadores de filas são limitados a 48 caracteres e fazem distinção entre maiúsculas e minúsculas.

O comportamento padrão é criar um gerenciador de filas que usando o caminho mqm padrão, se o gerenciador de filas ainda não existir no mesmo servidor.

Ao criar um broker multi-instância em que o gerenciador de filas não existe no servidor, um gerenciador de filas multi-instância será criado abaixo do caminho de trabalho compartilhado do broker multi-instância usando o comando WebSphere MQ crtmqm conforme a seguir:
  crtmqm –md /<broker sharedWorkPath>/mqm/qmdata
         -ld //<broker sharedWorkPath>/mqm/qmlog queueManagerName

Se esse caminho do gerenciador de filas compartilhado não for adequado, crie o gerenciador de filas de várias instâncias no servidor antes de executar esse comando.

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

Para restrições do conjunto de caracteres que você pode utilizar, consulte Caracteres Permitidos em Comandos.

-l UserLilPath
(Opcional) Uma lista de caminhos (diretórios) a partir dos quais o broker carrega bibliotecas de implementação carregáveis (arquivos LIL) para nós de processamento de mensagens definidas pelo usuário.

Esse nome faz distinção entre maiúsculas e minúsculas; coloque os nomes entre aspas simples se forem compostos por letras maiúsculas e minúsculas.

Não inclua variáveis de ambiente nesse caminho; elas são ignoradas pelo WebSphere Message Broker.

Você deve criar seu próprio diretório para armazenar seus arquivos .lil ou .jar. Não salve estes arquivos no diretório de instalação do WebSphere Message Broker.
-P HTTPListenerPort
(Opcional) Digite o número da porta na qual o suporte a serviços da Web está atendendo.

O broker inicia este listener quando um fluxo de mensagens que inclui nós HTTP ou o suporte a serviços da Web é iniciado; o padrão é 7080.

Verifique se a porta especificada não foi especificada para nenhuma outra finalidade.

-g ConfigurationChangeTimeout
(Opcional) O tempo máximo (em segundos) permitido para que um pedido de configuração de usuário seja processado. Ele define o período de tempo gasto no broker para aplicar a um grupo de execução uma alteração na configuração iniciada. Por exemplo, se você implementar uma configuração a partir do WebSphere Message Broker Toolkit, o broker deverá responder ao Configuration Manager dentro deste período.

Um fluxo de mensagens não pode responder a uma alteração na configuração enquanto está processando uma mensagem do aplicativo. Um grupo de execução retornará uma resposta negativa para a mensagem de configuração implementada se algum de seus fluxos de mensagens não concluir o processamento de uma mensagem do aplicativo e aplicar a alteração na configuração dentro deste tempo limite.

Especifique o valor em segundos, no intervalo de 10 - 3600. O padrão é 300.

Para obter informações sobre como configurar o valor para este tempo limite, consulte Configurando Valores de Tempo Limite de Configuração.

-k InternalConfigurationTimeout
(Opcional) O tempo máximo (em segundos) permitido para que uma alteração na configuração interna seja processada. Por exemplo, ele define o período de tempo gasto no broker para iniciar um grupo de execução.

O tempo de resposta de cada grupo de execução se difere, de acordo com o carregamento do sistema e do carregamento de seus próprios processos. O valor deve refletir o tempo de resposta mais longo gasto por qualquer grupo de execução para responder. Se o valor for muito baixo, o broker retornará uma resposta negativa e poderá emitir mensagens de erro no log de erros local.

Especifique o valor em segundos, no intervalo de 10 - 3600. O padrão é 60.

Para obter informações sobre como configurar o valor para este tempo limite, consulte Configurando Valores de Tempo Limite de Configuração.

-v StatisticsMajorInterval
(Opcional) Especifique o intervalo (em minutos) em que as estatísticas e registros de archive de contabilidade devem ser gravados. O intervalo válido é de 1 a 43200 minutos; o valor padrão é 60.

Um intervalo de zero minutos indica que o sistema operacional possui um método externo de notificação (o cronômetro ENF) e não está usando um cronômetro interno no WebSphere Message Broker.

-1
(Opcional) A transmissão do registro, que cria apenas o registro do intermediário.

Você deve executar o comando com a opção 1 antes de executar o comando com a opção 2, caso contrário o comando falhará.

-2
(Opcional - A transmissão do WebSphere MQ, que cria apenas as filas WebSphere MQ do intermediário.
-y LdapPrincipal
(Opcional, mas mandatório quando ldapCredentials for fornecido.) O usuário proprietário para acesso a um diretório LDAP opcional que contém o Contexto Inicial administrado pela JNDI para o provedor JMS.
-z LdapCredentials
(Opcional, mas mandatório quando ldapPrincipal for fornecido.) A senha do usuário para acesso ao LDAP.
-c ICUConverterPath
(Opcional) Um conjunto delimitado de diretórios para procurar conversores de páginas de códigos adicionais.
O conversor de página de códigos deve estar no formato codepagename.cnv ou em um pacote de dados ICU chamado icudt38.dat. Os conversores de página de códigos devem estar localizados em um subdiretório denominado icudt38_<platform_suffix> do diretório especificado no qual <platform_suffix> é um dos valores a seguir:
  • l para plataformas ASCII little-endian
  • b para plataformas ASCII big-endian
  • e para plataformas EBCDIC
Não utilize esse parâmetro para configurar o caminho do conversor se você estiver utilizando um conversor que corresponda a um dos conversores internos fornecidos com a Versão 6.0 e esse conversor for a página de códigos local para o intermediário. Utilize a variável de ambiente ICU_DATA no lugar.
-x UserExitPath
(Opcional) O caminho que contém o local de todas as saídas de usuário a serem carregadas para grupos de execução nesse broker. Esse caminho é incluído ao caminho de procura da biblioteca do sistema (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) apenas para processo do grupo de execução.
-s
(Opcional) Especifique o status de segurança administrativa para o broker.

Se você especificar -s active, a segurança administrativa será ativada. Apenas os IDs do usuário que você autorizar terão permissão para concluir ações no broker. As autoridades read, write e execute são sempre concedidas na fila de segurança SYSTEM.BROKER.AUTH a todos os IDs do usuário que pertencem ao grupo de segurança mqbrkrs. Quando o broker tiver sido criado, será possível incluir autorizações de ID do usuário adicionais nesta fila.

Ao criar um grupo de execução em um broker para o qual a segurança administrativa está ativada, a fila SYSTEM.BROKER,AUTH.egroup_name é criada. Preencha a fila com a autorização do usuário apropriada.

Se você especificar -s inactive, ou omitir este parâmetro, a segurança do broker não será ativada. Todos os usuários podem concluir todas as ações no broker e em todos os grupos de execução.

Para obter informações adicionais sobre como usar esta segurança, consulte Segurança de administração do broker e Concedendo e Revogando Autoridade para Segurança de Administração do Broker.

Exemplos

Crie um broker no z/OS usando um único comando:
mqsicreatebroker CSQ1BRK -q CSQ1 -u BRKUSER 
Crie um broker com segurança administrativa ativada:
mqsicreatebrokerMB8BROKER
-q MB8QMGR -s active
Avisos | Marcas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última atualização
        
        Última atualização : 2012-01-20 11:59:23


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.0 | an28120_