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 IBM® Integration Explorer para criar e visualizar serviços configuráveis. Consulte o Usando o IBM Integration 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-'  '- -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 .

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

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

Somente será possível usar esse parâmetro quando o grupo de execução estiver no estado pausado e será preciso também 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 IB9NODE -b httplistener -o HTTPListener -n startListener
  • Exibe as propriedades para o gerenciador de cache:
    mqsireportproperties IB9NODE -b cachemanager -o CacheManager -r
  • Exibe todas as configurações HTTPListener atuais associadas aos nós HTTP e SOAP (definidos no componente httplistener):
    mqsireportproperties IB9NODE -b httplistener -o HTTPListener -a
  • Exibe a configuração da porta HTTPSConnector para os nós HTTP (definidos no componente httplistener):
    mqsireportproperties IB9NODE -b httplistener -o HTTPSConnector -n port

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 IB9NODE -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 IB9NODE -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 IB9NODE -c FtpServer -o TEST1 -r
  • Exiba a configuração da propriedade protocol do serviço configurável FtpServer chamado TEST1:
    mqsireportproperties IB9NODE -c FtpServer -o TEST1 -n protocol
  • Relate as propriedades do serviço configurável JDBCProvider Oracle:
    mqsireportproperties IB9NODE -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 IB9NODE -c JMSProviders 
         -o AllReportableEntityNames -r
  • Exibe as propriedades para todos os recursos do provedor JMS do WebSphere MQ.
    mqsireportproperties IB9NODE -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 IB9NODE -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 IB9NODE para o arquivo policyset.xml:
    mqsireportproperties IB9NODE -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 IB9NODE -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 IB9NODE 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 IB9NODE -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 IB9NODE -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 | Downloads | Biblioteca | Suporte | Feedback

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

        
        Última atualização:
        
        Última atualização: 2013-07-16 02:06:57


Tópico de ReferênciaTópico de Referência | IBM Integration Bus Versão 9.0.0.0 | an09150_