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

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 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.
    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 que foram implementados no broker.

    É possível configurar um parâmetro para desativar ou ativar o listener do broker inteiro para nós HTTP; por padrão, este listener está ativo.

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

Não será necessária nenhuma autoridade específica para executar este comando.

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 nós HTTP em um ou mais grupos de execução:
    mqsireportproperties MB7BROKER -b httplistener -o HTTPListener -n startListener
  • Exiba todas as configurações de HTTPListener associadas a nós HTTP (definidas no componente httplistener):
    mqsireportproperties MB7BROKER -b httplistener -o HTTPListener -a
  • Exibe a configuração da porta HTTPSConnector para os nós HTTP (definidos no componente httplistener):
    mqsireportproperties MB7BROKER -b httplistener -o HTTPSConnector -n port
  • Exibir todas as propriedades de objeto Federação de Serviço e seus valores:
    mqsichangeproperties MB7BROKER -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 MB7BROKER:
    mqsireportproperties MB7BROKER -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 MB7BROKER -e exgroup1 -o ExecutionGroup -n httpNodesUseEmbeddedListener
  • 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 MB7BROKER  -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 MB7BROKER -c Aggregation -o AllReportableEntityNames -r
  • Exiba todos os serviços configuráveis CICSConnection:
    mqsireportproperties MB7BROKER -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 MB7BROKER -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 MB7BROKER -c Collector -o AllReportableEntityNames -r
  • Exiba todos os serviços configuráveis CORBA:
    mqsireportproperties MB7BROKER -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 MB7BROKER -c EmailServer -o AllReportableEntityNames -r
  • Exiba todas as propriedades do serviço configurável FtpServer chamado TEST1:
    mqsireportproperties MB7BROKER -c FtpServer -o TEST1 -r
  • Exiba a configuração da propriedade protocol do serviço configurável FtpServer chamado TEST1:
    mqsireportproperties MB7BROKER -c FtpServer -o TEST1 -n protocol
  • Exibe todos os serviços configuráveis IMSConnect:
    mqsireportproperties MB7BROKER -c IMSConnect -o AllReportableEntityNames -r
  • Relate as propriedades do serviço configurável JDBCProvider Oracle:
    mqsireportproperties MB7BROKER -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 MB7BROKER -c JMSProviders 
         -o AllReportableEntityNames -r
  • Exibe as propriedades para todos os recursos do provedor JMS do WebSphere MQ.
    mqsireportproperties MB7BROKER -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 MB7BROKER -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 MB7BROKER -c PeopleSoftConnection -o AllReportableEntityNames -r
  • Exiba todos os conjuntos de política para o intermediário MB7BROKER:
    mqsireportproperties MB7BROKER -c PolicySets 
         -o AllReportableEntityNames -a
  • Exiba todas as ligações do conjunto de política para o intermediário MB7BROKER:
    mqsireportproperties MB7BROKER -c PolicySetBindings 
         -o AllReportableEntityNames -a
  • Exporte o conjunto de política Policy_2 no intermediário MB7BROKER para o arquivo policyset.xml:
    mqsireportproperties MB7BROKER -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 MB7BROKER -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 MB7BROKER 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 MB7BROKER -c Resequence -o AllReportableEntityNames -r
  • Relate as dependências para o WebSphere Adapter para SAP:
    mqsireportproperties MB7BROKER -c EISProviders -o SAP -r
  • Exibe todos os serviços configuráveis SAPConnection:
    mqsireportproperties MB7BROKER -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 MB7BROKER -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 MB7BROKER -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 MB7BROKER -c SiebelConnection -o AllReportableEntityNames -r
  • Exibe todos os serviços configuráveis TCPIPclient:
    mqsireportproperties MB7BROKER -c TCPIPClient 
          -o AllReportableEntityNames -r
  • Exibe todos os serviços configuráveis TCPIPServer:
    mqsireportproperties MB7BROKER -c TCPIPServer 
          -o AllReportableEntityNames -r
  • Exiba todos os serviços configuráveis Timer:
    mqsireportproperties MB7BROKER -c Timer -o AllReportableEntityNames -r
  • Exiba todos os serviços JavaClassLoader:
    mqsireportproperties MB7BROKER -c JavaClassLoader 
          -o AllReportableEntityNames -r
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-08-02 07:48:50


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