WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Comando mqsireportproperties

Use o comando mqsireportproperties para exibir propriedades que se relacionam a um broker, um grupo de execução ou um serviço configurável.

Também é possível usar o WebSphere Message Broker Explorer para criar e visualizar serviços configuráveis. Consulte o Usando o WebSphere Message Broker Explorer para Trabalhar com Serviços Configuráveis para obter informações adicionais.

Plataformas Suportadas

Propósito

Utilize o comando mqsireportproperties para examinar os valores de propriedades ou recursos do broker que são configurados utilizando o comando mqsichangeproperties, ou criados utilizando o comando mqsicreateconfigurableservice.

Notas sobre a utilização

  • Antes de executar o comando mqsireportproperties, certifique-se de que o broker esteja em execução.
  • Se você usar o comando mqsichangeproperties para alterar qualquer valor, a alteração será aplicada apenas depois de se parar e reiniciar o broker ou o grupo de execução.
  • Se executar o comando mqsireportproperties após alterar propriedades, mas antes de reiniciar o broker ou o grupo de execução, o comando mostrará o valor alterado, embora esse valor ainda não esteja funcionando.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsireportproperties--BrokerName----------------------------->

>--+---------------------------+-- -o --ObjectName-------------->
   +- -b --ComponentName-------+                     
   +- -e --ExecutionGroupLabel-+                     
   '- -c --ConfigurableService-'                     

>--+- -n --PropertyName-+--+----------------+--+-----+---------><
   +- -a----------------+  '- -p --FileName-'  '- -f-'   
   '- -r----------------'                                

Parâmetros

BrokerName
(Requerido) O nome do broker.

-b ComponentName
(Opcional) O nome do componente selecionado. Os valores válidos são httplistener, securitycache, cachemanager, webadmin e servicefederation.

-c ConfigurableService
(Opcional) O tipo do serviço configurável. Especifique um valor de AllTypes para relatar todos os tipos de serviços configuráveis.

Para obter uma lista de serviços configuráveis fornecidos e suas propriedades e valores, consulte Propriedades de Serviços Configuráveis.

-e ExecutionGroupLabel
(Opcional) A etiqueta do grupo de execução para o qual um relatório é requerido.

-o ObjectName
(Obrigatório) O nome do objeto cujas propriedades você deseja ler.

Também é necessário especificar -b, -e ou -c after -o, exceto se você especificar o nome do objeto BrokerRegistry.

Configure ObjectName para corresponder a outros parâmetros:
  • Especifique BrokerRegistry para os parâmetros de registro do broker.
  • Especifique o nome de um serviço configurável (predefinido ou definido pelo usuário) de um tipo que você especificou com -c.
    Por Exemplo:
    • -c EISProviders com SAP, Siebel ou PeopleSoft para um serviço configurável predefinido do WebSphere Adapters.
    • -c JMSProviders com o nome de um serviço predefinido ou definido pelo usuário, por exemplo, WebSphere_MQ.
  • Especifique um objeto de comunicações para o componente httplistener especificado com -b; um de HTTPListener, HTTPConnector ou HTTPSConnector. Os valores são definidos para todos os nós HTTP e SOAP que foram implementados no broker.

    É possível configurar um parâmetro para desativar ou ativar o listener do broker inteiro para nós HTTP e SOAP; por padrão, esse listener está ativo e é usado paraa nós HTTP. Os nós SOAP usam o listener (integrado) do grupo de execução por padrão.

  • Especifique um objeto de comunicações para o grupo de execução especificado com -e; um de HTTPListener, HTTPConnector ou HTTPSConnector. Os valores são definidos para todos os nós HTTP e SOAP que foram implementados no grupo de execução especificado.

    É possível configurar o grupo de execução de modo que todos os nós HTTP usem o listener integrado em vez do listener do broker inteiro. Também é possível configurar o grupo de execução para que os nós SOAP usem o listener do broker inteiro. Para obter mais informações, consulte Listeners HTTP.

  • Especifique DynamicSubscriptionEngine para propriedades de comunicação inter-broker para o grupo de execução especificado com -e. Estas propriedades se aplicam aos brokers configurados em conjuntos, ou clonados.
  • Especifique SecurityCache para as propriedades para o componente securitycache especificado com -b.
  • Especifique um objeto para o componente servicefederation que você especificou com -b; um de scmp, HTTPConnector ou HTTPSConnector. As propriedades se aplicam à porta HTTP(S) do broker que processa pedidos Atom SCMP do Service Federation Management (SFM).
  • Especifique ServiceFederationManager para as propriedades envolvidas na criação de um proxy SFM para o grupo de execução que você especificou com -e.
  • Especifique ComIbmActivityLogManager para as propriedades de Log de Atividade do grupo de execução especificado com -e. Consulte o Visualizando e Configurando Propriedades de Tempo de Execução para Log de Atividades.
  • Especifique Connectors para todas as propriedades de conexão do grupo de execução que você especificou com -e. As informações de propriedade aninhadas podem ser exibidas especificando um / para cada nível necessário na estrutura.
    Exemplo:
    • -o Connectors/MQTT para exibir apenas as informações de propriedade relacionadas ao provedor de conexões MQTT.

Especifique um valor de AllReportableEntityNames para retornar uma lista de todos os nomes de objetos válidos.

-n PropertyName
(Opcional) Exibe apenas a propriedade nomeada.

Você deve selecionar somente uma opção de -n, -a e -r.

-a
(Opcional) Indica que todos os valores da propriedade do objeto são exibidos e não agem de forma recursiva nas propriedades que possuem valores-filho.

-r
(Opcional) Indica que todos os valores da propriedade do objeto são exibidos e, além disso, exibe os valores-filhos para todas as propriedades que possuem valores-filhos.

Observe que essa opção não mostra todos os valores possíveis para AllReportableEntityNames. Além disso, nem todas as entidades suportam esse parâmetro.

-p FileName
(Opcional) O local e nome do arquivo no qual o comando grava todas as propriedades selecionadas. Se você não especificar -n, os valores da propriedade, mas não os nomes da propriedade, serão gravados.

-f
(Opcional) Este parâmetro é válido apenas se você especificar um objeto de nível do grupo de execução.

Você só pode usar este parâmetro quando o grupo de execução estiver no estado pausado e também deve especificar -e e -o.

Se você especificar este parâmetro para outros serviços configuráveis ou componentes, um erro será gerado.

Para obter informações adicionais sobre objetos, propriedades e valores, e combinações válidas destes parâmetros, consulte Comando mqsichangeproperties.

Para o componente httplistener, o comando mqsireportproperties não relata as propriedades que não foram explicitamente configuradas com o comando mqsichangeproperties, mesmo que essas propriedades tenham uma configuração padrão.

Por exemplo, a porta HTTPSConnector padrão a ser utilizada (a menos que tenha sido alterada) é 7083. Entretanto, este valor não é relatado pelo comando mqsireportproperties, a menos que você o tenha alterado a partir deste padrão usando o comando mqsichangeproperties. Para ver os valores-padrão para todas as propriedades que o comando mqsireportproperties pode relatar, consulte a descrição do comando mqsichangeproperties.

Autorização

Para obter informações sobre autorizações específicas da plataforma, consulte os tópicos a seguir: Se você tiver ativado a segurança de administração do broker, também deverá configurar a autoridade detalhada em Tarefas e Autorizações para Segurança de Administração.

Respostas

As respostas estão no formato:
  • HTTPConnector
    • PortNumber = 7800
  • HTTPSConnector
    • PortNumber = 7843

Exemplos

Sempre digite o comando em uma única linha; em alguns exemplos, foi incluída uma quebra de linha para aprimorar a capacidade de leitura.

Exibindo Propriedades Associadas a Componentes do Broker

Os exemplos a seguir incluem o parâmetro -b para especificar o componente a ser visualizado.

  • Verifique se o listener do broker inteiro está ativo para os nós HTTP e SOAP implementados em um ou mais grupos de execução:
    mqsireportproperties MB8BROKER -b httplistener -o HTTPListener -n startListener
  • Exibe as propriedades para o gerenciador de cache:
    mqsireportproperties MB8BROKER -b cachemanager -o CacheManager -r
  • Exibe todas as configurações HTTPListener atuais associadas aos nós HTTP e SOAP (definidos no componente httplistener):
    mqsireportproperties MB8BROKER -b httplistener -o HTTPListener -a
  • Exibe a configuração da porta HTTPSConnector para os nós HTTP (definidos no componente httplistener):
    mqsireportproperties MB8BROKER -b httplistener -o HTTPSConnector -n port
  • Exibir todas as propriedades de objeto Federação de Serviço e seus valores:
    mqsichangeproperties MB8BROKER -b servicefederation -o AllReportableEntityNames -r

Exibindo Propriedades Associadas a Grupos de Execução

Os exemplos a seguir incluem o parâmetro -e para especificar o grupo de execução a ser visualizado.

  • Exiba o nome do agente FTE para o grupo de execução FTESAMPLE no broker MB8BROKER:
    mqsireportproperties MB8BROKER -e FTESAMPLE -o FTEAgent -n agentName
    Se o agente tiver sido criado, o comando retornará o nome do agente. Se o agente não tiver sido criado, o comando retornará uma cadeia vazia.
  • Verifique se os nós HTTP implementados estão usando o listener integrado do grupo de execução:
    mqsireportproperties MB8BROKER -e exgroup1 -o ExecutionGroup -n httpNodesUseEmbeddedListener
  • Verifique se os nós SOAP implementados estão usando o listener (integrado) do grupo de execução:
    mqsireportproperties MB8BROKER -e exgroup1 -o ExecutionGroup -n soapNodesUseEmbeddedListener
  • Exibir as propriedades que controlam a criação de um proxy SFM para um grupo de execução que deve ser usado como um Provedor de Conectividade SFM:
    mqsireportproperties MB8BROKER  -e exgroup1 -o
    ServiceFederationManager -a
    O resultado deste comando possui o seguinte formato:
    ServiceFederationManager
      uuid='ServiceFederationManager'
      userTraceLevel='none'
      traceLevel='none'
      userTraceFilter='none'
      traceFilter='none'
      port='8811'
      securePort='8844'
      maxWaitTime='180'
      proxyURLHostName=' mbhost.ibm.com '
      proxyPathPrefix='proxy'
      proxyPathPrefixesEnabled='TRUE'
      creationTime='2009-09-11 15:37:52.639219'
      nextProxyPathPrefixCount='8'
      ownedProxyGroupCount='2'

Exibindo Propriedades Associadas a Serviços Configuráveis

Os exemplos a seguir incluem o parâmetro -c para especificar o serviço configurável a ser visualizado. Para obter uma lista de serviços configuráveis fornecidos e suas propriedades e valores, consulte Propriedades de Serviços Configuráveis.

  • Exiba todos os serviços configuráveis Aggregation:
    mqsireportproperties MB8BROKER -c Aggregation -o AllReportableEntityNames -r
  • Exiba os serviços configuráveis para Servidor Connect:Direct (que você definiu para este broker com o comando mqsicreateconfigurableservice)
    mqsireportproperties MB8BROKER -c CDServer -o AllReportableEntityNames -r
    O resultado deste comando possui o seguinte formato:
    CDServer
      Padrão
        hostname='localhost'
        port='1363'
        brokerPathToStagingDir=''
        cdPathToStagingDir=''
        brokerPathToInputDir=''
        cdPathToInputDir=''
        queuePrefix= ''
        securityIdentity=”Default”
  • Exiba todas as propriedades do serviço configurável FtpServer chamado TEST1:
    mqsireportproperties MB8BROKER -c FtpServer -o TEST1 -r
  • Exiba a configuração da propriedade protocol do serviço configurável FtpServer chamado TEST1:
    mqsireportproperties MB8BROKER -c FtpServer -o TEST1 -n protocol
  • Relate as propriedades do serviço configurável JDBCProvider Oracle:
    mqsireportproperties MB8BROKER -c JDBCProviders -o Oracle -r
  • Exibe as propriedades para todos os recursos do provedor JMS do broker (recursos do provedor JMS padrão e os serviços configuráveis definidos utilizando o comando mqsicreateconfigurableservice):
    mqsireportproperties MB8BROKER -c JMSProviders 
         -o AllReportableEntityNames -r
  • Exibe as propriedades para todos os recursos do provedor JMS do WebSphere MQ.
    mqsireportproperties MB8BROKER -c JMSProviders 
         -o WebSphere_MQ -r
  • Exiba as propriedades para todos os recursos do provedor JMS (recursos do provedor JMS padrão e os serviços configuráveis que você definiu para este broker com o comando mqsicreateconfigurableservice):
    mqsireportproperties MB8BROKER -c JMSProviders 
         -o BEA_WebLogic –r
    O resultado deste comando possui o seguinte formato:
    ReportableEntityName=''
    JMSProviders
      BEA_Weblogic=''
        jarsURL='default_Path'
        nativeLibs='default_Path'
        proprietaryAPIAttr1='weblogic.jndi.WLInitialContextFactory'
        proprietaryAPIAttr2='t3://9.20.94.16:7001'
        proprietaryAPIAttr3='BEAServerName'
        proprietaryAPIAttr4='default_none'
        proprietaryAPIAttr5='default_none'proprietaryAPIHandler='BEAWebLogicAPIHandler.jar'
  • Exporte o conjunto de política Policy_2 no intermediário MB8BROKER para o arquivo policyset.xml:
    mqsireportproperties MB8BROKER -c PolicySets 
         -o Policy_2 -n ws-security -p policyset.xml
    Você pode utilizar o arquivo de saída para mover conjuntos de política entre intermediários e para backup.
  • Exporte as ligações do conjunto de política de um intermediário para um arquivo:
    mqsireportproperties MB8BROKER -c PolicySetBindings 
         -o Bindings_2 -n ws-security -p bindings.xml
    Este comando grava o arquivo de Ligações do Conjunto de Política Bindings_2 no intermediário MB8BROKER para o arquivo bindings.xml. Você pode utilizar este arquivo para mover as ligações do conjunto de política entre intermediários e para backup.
  • Exiba as propriedades para todos os perfis de segurança (perfis de segurança padrão e qualquer um que você definiu neste broker usando o comando mqsicreateconfigurableservice):
    mqsireportproperties MB8BROKER -c SecurityProfiles 
         -o AllReportableEntityNames -r
    O resultado deste comando possui o seguinte formato:
    ReportableEntityName=''
    SecurityProfiles
    
    	Default_Propagation=''
    		authentication = 'NONE'
    		authenticationConfig = ''
    		authorization = 'NONE'
    		authorizationConfig = ''
    		idToPropagateToTransport = 'Message ID'
    		keyStore = 'Reserved for future use'
    		mapping = 'NONE'
    		mappingConfig = ''
    		passwordValue = 'PLAIN'
    		propagation = 'TRUE'
    		rejectBlankpassword = 'FALSE'
    		transportPropagationConfig = ''
    		trustStore = 'Reserved for future use'
  • Exibem as propriedades para o perfil de segurança chamado MyFirstSecurityProfile:
    mqsireportproperties MB8BROKER -c SecurityProfiles 
         -o MyFirstSecurityProfile -r
    O resultado deste comando possui o seguinte formato:
    ReportableEntityName=''
    SecurityProfiles
    	MyFirstSecurityProfile=''
    		authentication = 'LDAP'
    		authenticationConfig = 'ldap://localhost:389/ou=users,o=ibm'
    		authorization = 'NONE'
    		authorizationConfig = ''
    		idToPropagateToTransport = 'Message ID'
    		keyStore = 'Reserved for future use'
    		mapping = 'TFIM'
    		mappingConfig = 'http://tfimhost1:80'
    		passwordValue = 'PLAIN'
    		propagation = 'TRUE'
    		rejectBlankpassword = 'FALSE'
    		transportPropagationConfig = ''
    		trustStore = 'Reserved for future use'
    		
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:06


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | an09150_