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.

Observações de Uso

  • 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

Read syntax diagramSkip visual syntax diagram
>>-mqsireportproperties--BrokerName----------------------------->

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

>--+- -n --PropertyName-+--+----------------+------------------><
   +- -a----------------+  '- -p --FileName-'   
   '- -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 intermediário.
  • 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 Atividades do grupo de execução especificado com -e. Consulte o Visualizando e Configurando Propriedades de Tempo de Execução para log de Atividadess.
  • 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. Se você executar o comando mqsireportproperties na linha de comandos sem quaisquer propriedades, AllReportableEntityNames será usado.

-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.

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 do Broker.

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
  • Start of changeExibe as propriedades para o gerenciador de cache:
    mqsireportproperties MB8BROKER -b cachemanager -o CacheManager -r
    End of change
  • 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

O exemplo a seguir inclui 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.

  • Exiba todos os serviços configuráveis Aggregation:
    mqsireportproperties MB8BROKER -c Aggregation -o AllReportableEntityNames -r
  • Exiba todos os serviços configuráveis CICSConnection:
    mqsireportproperties MB8BROKER -c CICSConnection -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 todos os serviços configuráveis Collector:
    mqsireportproperties MB8BROKER -c Collector -o AllReportableEntityNames -r
  • Exiba todos os serviços configuráveis CORBA:
    mqsireportproperties MB8BROKER -c CORBA -o AllReportableEntityNames -r
  • Exiba todos os serviços configuráveis EmailServer aos quais os nós EmailInput ou fluxos de mensagens estão se referindo no tempo de execução:
    mqsireportproperties MB8BROKER -c EmailServer -o AllReportableEntityNames -r
  • 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
  • Exibe todos os serviços configuráveis IMSConnect:
    mqsireportproperties MB8BROKER -c IMSConnect -o AllReportableEntityNames -r
  • 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'
  • Exiba todos os serviços configuráveis PeopleSoftConnection:
    mqsireportproperties MB8BROKER -c PeopleSoftConnection -o AllReportableEntityNames -r
  • Exiba todos os conjuntos de política para o intermediário MB8BROKER:
    mqsireportproperties MB8BROKER -c PolicySets 
         -o AllReportableEntityNames -a
  • Exiba todas as ligações do conjunto de política para o intermediário MB8BROKER:
    mqsireportproperties MB8BROKER -c PolicySetBindings 
         -o AllReportableEntityNames -a
  • 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 broker 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 broker 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.
  • Exibe todos os serviços configuráveis Resequence:
    mqsireportproperties MB8BROKER -c Resequence -o AllReportableEntityNames -r
  • Relate as dependências para o WebSphere Adapter para SAP:
    mqsireportproperties MB8BROKER -c EISProviders -o SAP -r
  • Exibe todos os serviços configuráveis SAPConnection:
    mqsireportproperties MB8BROKER -c SAPConnection -o AllReportableEntityNames -r
  • 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 = ''
    		Mapping = 'NONE'
    		MappingConfig = ''
    		Authorization = 'NONE'
    		AuthorizationConfig = ''
    		Propagation = 'TRUE'
    		passwordValue = 'PLAIN'
  • 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'
    		Mapping = 'TFIM'
    		MappingConfig = 'http://tfimhost1:80'
    		Authorization = 'NONE'
    		AuthorizationConfig = ''
    		Propagation = 'TRUE'
    		passwordValue = 'PLAIN'
    		
  • Exiba todos os serviços configuráveis SiebelConnection:
    mqsireportproperties MB8BROKER -c SiebelConnection -o AllReportableEntityNames -r
  • Exibe todos os serviços configuráveis TCPIPclient:
    mqsireportproperties MB8BROKER -c TCPIPClient 
          -o AllReportableEntityNames -r
  • Exibe todos os serviços configuráveis TCPIPServer:
    mqsireportproperties MB8BROKER -c TCPIPServer 
          -o AllReportableEntityNames -r
  • Exiba todos os serviços configuráveis Timer:
    mqsireportproperties MB8BROKER -c Timer -o AllReportableEntityNames -r
  • Exiba todos os serviços JavaClassLoader:
    mqsireportproperties MB8BROKER -c JavaClassLoader 
          -o AllReportableEntityNames -r
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última atualização
        
        Última atualização : 2013-02-27 20:23:12


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