WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Mandato mqsireportproperties

Utilice el mandato mqsireportproperties para visualizar propiedades relacionadas con un intermediario, un grupo de ejecución o un servicio configurable.

También puede utilizar WebSphere Message Broker Explorer para crear y ver los servicios configurables. Consulte Uso de WebSphere Message Broker Explorer para trabajar con servicios configurables para obtener más información.

Plataformas soportadas

Finalidad

Utilice el mandato mqsireportproperties para examinar los valores de las propiedades o los recursos del intermediario que están establecidos utilizando el mandato mqsichangeproperties o se crean utilizando el mandato mqsicreateconfigurableservice.

Notas de uso

  • Antes de ejecutar el mandato mqsireportproperties, asegúrese de que el intermediario está en ejecución.
  • Si utiliza el mandato mqsichangeproperties para cambiar algún valor, el cambio sólo se aplica después de detener y reiniciar el intermediario o el grupo de ejecución.
  • Si ejecuta el mandato mqsireportproperties después de cambiar propiedades, pero antes de reiniciar el intermediario o el grupo de ejecución, el mandato muestra el valor modificado, aun cuando dicho valor todavía no sea efectivo.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsireportproperties--NombreIntermediario-------------------->

>--+------------------------------+-- -o --NombreObjeto--------->
   +- -b --NombreComponente-------+                       
   +- -e --EtiquetaGrupoEjecución-+                       
   '- -c --ServicioConfigurable---'                       

>--+- -n --NombrePropiedad-+--+---------------------+----------->
   +- -a-------------------+  '- -p --NombreArchivo-'   
   '- -r-------------------'                            

>--+-----+-----------------------------------------------------><
   '- -f-'   

Parámetros

NombreIntermediario
(Necesario) El nombre del intermediario.

-b NombreComponente
(Opcional) Nombre del componente seleccionado. Los valores válidos son httplistener, securitycache, cachemanager, webadmin y servicefederation.

-c ServicioConfigurable
(Opcional) Tipo del servicio configurable. Especifique un valor de AllTypes para informar sobre todos los tipos de servicios configurables.

Para obtener una lista de los servicios configurables suministrados y sus propiedades y valores, consulte el apartado Propiedades de servicios configurables.

-e EtiquetaGrupoEjecución
(Opcional) Etiqueta del grupo de ejecución para el que se necesita un informe.

-o NombreObjeto
(Necesario) Nombre del objeto cuyas propiedades desea leer.

También debe especificar-b, -e o -c después de -o, excepto si especifica el nombre de objeto BrokerRegistry.

Establezca NombreObjeto para que coincida con otros parámetros:
  • Especifique BrokerRegistry para parámetros de registro de intermediario.
  • Especifique el nombre de un servicio configurable (predefinido o definido por el usuario) de un tipo que haya especificado con -c.
    Por ejemplo:
    • -c EISProviders con SAP, Siebel p PeopleSoft para un servicio configurable de WebSphere Adapters.
    • -c JMSProviders con el nombre de un servicio predefinido o definido por el usuario, por ejemplo WebSphere_MQ.
  • Especifique un objeto de comunicaciones para el componente httplistener que ha especificado con -b; uno de HTTPListener, HTTPConnector o HTTPSConnector. Los valores se definen para todos los nodos HTTP y SOAP que ha desplegado en el intermediario.

    Puede establecer un parámetro para inhabilitar o habilitar el escucha del intermediario para nodos HTTP y SOAP; de forma predeterminada, este escucha está activo y se utiliza para los nodos HTTP. Los nodos SOAP utilizan el escucha de grupo de ejecución (incorporado) de forma predeterminada.

  • Especifique un objeto de comunicaciones para el grupo de ejecución que haya especificado con -e; uno de HTTPListener, HTTPConnector o HTTPSConnector. Se definen valores para todos los nodos HTTP y SOAP que ha desplegado en el grupo de ejecución especificado.

    Puede configurar el grupo de ejecución de modo que todos los nodos HTTP utilicen el escucha incorporado en lugar del escucha del intermediario. También puede configurar el grupo de ejecución de manera que los nodos SOAP utilicen el escucha de intermediario. Para obtener más información, consulte Escuchas HTTP.

  • Especifique DynamicSubscriptionEngine para propiedades de comunicaciones entre intermediarios para el grupo de ejecución que ha especificado con -e. Estas propiedades se aplican a intermediarios que ha configurado en colectivos o clonados.
  • Especifique SecurityCache para propiedades del componente securitycache que ha especificado con -b.
  • Especifique un objeto para el componente servicefederation que ha especificado con -b: scmp, HTTPConnector o HTTPSConnector. Las propiedades se aplican al puerto HTTP(S) del intermediario que procesa las solicitudes SCMP Atom de la Gestión de federación de servicios (SFM).
  • Especifique ServiceFederationManager para propiedades relacionadas con la creación de un proxy SFM para el grupo de ejecución que ha especificado con -e.
  • Especifique ComIbmActivityLogManager para propiedades de Registro de actividad para el grupo de ejecución que ha especificado con -e. Consulte el apartado Ver y establecer propiedades de tiempo de ejecución para registros de actividades.
  • Especifique Conectores para todas las propiedades de conexión para el grupo de ejecución que ha especificado con -e. Se puede visualizar información de propiedades anidadas especificando una / para cada nivel necesario en la estructura.
    Por ejemplo:
    • -o Connectors/MQTT para visualizar sólo la información de propiedad relacionada con el proveedor de conexiones MQTT.

Especifique un valor de AllReportableEntityNames para devolver una lista de todos los nombres de objeto válidos.

-n NombrePropiedad
(Opcional) Muestra sólo la propiedad con nombre.

Debe seleccionar sólo una opción entre -n, -a y -r.

-a
(Opcional) Indica que se muestran todos los valores de propiedades del objeto y no actúa de manera recurrente sobre las propiedades que tienen valores hijo.

-r
(Opcional) Indica que se muestran todos los valores de propiedades del objeto y, además, muestra los valores hijo de todas las propiedades que los tienen.

Observe que esta opción no muestra todos los valores posibles de AllReportableEntityNames. Además, no todas las entidades dan soporte a este parámetro.

-p NombreArchivo
(Opcional) La ubicación y el nombre del archivo en el que el mandato graba todas las propiedades seleccionadas. Si no especifica -n, se escriben los valores de propiedad, pero no los nombres de propiedad.

-f
(Opcional) Este parámetro es solo válido si especifica un objeto de nivel de grupo de ejecución.

Puede utilizar este parámetro solo cuando el grupo de ejecución está en el estado de parada y también debe especificar -e y -o.

Si especifica este parámetro para otros servicios o componentes configurables, se genera un error.

Para obtener más información sobre objetos, propiedades y valores, así como combinaciones válidas de estos parámetros, consulte Mandato mqsichangeproperties.

Para el componente httplistener, el mandato mqsireportproperties no informa de las propiedades que no se han establecido explícitamente con mqsichangeproperties, aunque estas propiedades tengan un valor predeterminado.

Por ejemplo, el puerto HTTPSConnector predeterminado que se utiliza (a menos que se haya cambiado) es 7083. No obstante, no se informa de este valor mediante el mandato mqsireportproperties, a menos que se haya cambiado su valor predeterminado utilizando el mandato mqsichangeproperties. Para ver los valores predeterminados para todas las propiedades que puede notificar el mandato mqsireportproperties, consulte la descripción del mandato mqsichangeproperties.

Autorización

Para obtener información sobre las autorizaciones específicas de cada plataforma, consulte los temas siguientes: Si ha habilitado la seguridad de administración del intermediario, también debe establecer la autorización que se detalla en Tareas y autorizaciones para la seguridad de administración.

Respuestas

Las respuestas tienen el formato:
  • HTTPConnector
    • PortNumber = 7800
  • HTTPSConnector
    • PortNumber = 7843

Ejemplos

Entre siempre el mandato en una sola línea; en algunos ejemplos, se ha añadido un salto de línea para facilitar la lectura.

Visualización de las propiedades asociadas a componentes de intermediario

Los ejemplos siguientes incluyen el parámetro -b para especificar el componente que hay que ver.

  • Comprobar si el escucha del intermediario está activo para nodos HTTP y SOAP desplegados en uno o varios grupos de ejecución:
    mqsireportproperties
    MB8BROKER -b httplistener -o
    HTTPListener -n startListener
  • Mostrar las propiedades para el gestor de memoria caché:
    mqsireportproperties MB8BROKER -b cachemanager -o CacheManager -r
  • Visualizar todos los valores HTTPListener actuales asociados con nodos HTTP y SOAP (definidos en el componente httplistener):
    mqsireportproperties MB8BROKER -b escuchaHttp -o HTTPListener -a
  • Visualizar el valor del puerto HTTPSConnector para los nodos HTTP (definidos en el componente httplistener):
    mqsireportproperties MB8BROKER -b escuchaHttp -o HTTPSConnector -n puerto
  • Mostrar todas las propiedades de los objetos de federación de servicios y sus valores:
    mqsichangeproperties MB8BROKER -b servicefederation -o AllReportableEntityNames -r

Visualización de las propiedades asociadas a grupos de ejecución

Los ejemplos siguientes incluyen el parámetro -e para especificar el grupo de ejecución que hay que ver.

  • Para visualizar el nombre del agente FTE para el grupo de ejecución FTESAMPLE en el intermediario MB8BROKER:
    mqsireportproperties MB8BROKER -e FTESAMPLE -o FTEAgent -n agentName
    Si el agente se ha creado, el mandato devuelve el nombre del agente. Si el agente no se ha creado, el mandato devuelve una serie vacía.
  • Comprobar si los nodos HTTP desplegados utilizan el escucha incluido del grupo de ejecución:
    mqsireportproperties MB8BROKER -e exgroup1 -o ExecutionGroup -n httpNodesUseEmbeddedListener
  • Compruebe si los nodos SOAP desplegados están utilizando el escucha (incorporado) de grupo de ejecución:
    mqsireportproperties MB8BROKER -e exgroup1 -o ExecutionGroup -n soapNodesUseEmbeddedListener
  • Mostrar las propiedades que controlan la creación de un proxy SFM para un grupo de ejecución que se tiene que utilizar como proveedor de conectividad SFM:
    mqsireportproperties MB8BROKER -e exgroup1 -o ServiceFederationManager -a
    El resultado de este mandato tiene el formato siguiente:
    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'

Visualización de las propiedades asociadas a servicios configurables

Los ejemplos siguientes incluyen el parámetro -c para especificar el servicio configurable que hay que ver. Para obtener una lista de los servicios configurables suministrados y sus propiedades y valores, consulte Propiedades de servicios configurables.

  • Visualizar todos los servicios configurables de Aggregation:
    mqsireportproperties
    MB8BROKER -c Aggregation -o
    AllReportableEntityNames -r
  • Mostrar todos los servicios configurables para el Servidor de Connect:Direct (que ha definido para este intermediario con el mandato mqsicreateconfigurableservice):
    mqsireportproperties MB8BROKER -c CDServer -o AllReportableEntityNames -r
    El resultado de este mandato tiene el formato siguiente:
    CDServer
      Default
        hostname='localhost'
        port='1363'
        brokerPathToStagingDir=''
        cdPathToStagingDir=''
        brokerPathToInputDir=''
        cdPathToInputDir=''
        queuePrefix= ''
        securityIdentity=”Default”
  • Visualizar todas las propiedades del servicio configurable FtpServer denominado TEST1:
    mqsireportproperties
    MB8BROKER -c FtpServer -o TEST1
    -r
  • Visualizar la propiedad protocol del servicio configurable FtpServer denominado TEST1:
    mqsireportproperties
    MB8BROKER -c FtpServer -o TEST1
    -n protocol
  • Informar de las propiedades del servicio configurable JDBCProvider de Oracle:
    mqsireportproperties MB8BROKER -c JDBCProviders -o Oracle -r
  • Visualizar las propiedades de todos los recursos de proveedor JMS del intermediario (los recursos de proveedor JMS predeterminados y los servicios configurables que se han definido utilizando el mandato mqsicreateconfigurableservice):
    mqsireportproperties MB8BROKER -c JMSProviders 
         -o AllReportableEntityNames -r
  • Visualizar las propiedades de todos los recursos de proveedor JMS de WebSphere MQ.
    mqsireportproperties MB8BROKER -c JMSProviders 
         -o WebSphere_MQ -r
  • Mostrar las propiedades para todos los recursos de proveedor de JMS (los recursos de proveedor de JMS predeterminados y los servicios configurables que ha definido para este intermediario con el mandato mqsicreateconfigurableservice):
    mqsireportproperties MB8BROKER -c JMSProviders 
         -o BEA_WebLogic –r
    El resultado de este mandato tiene el formato siguiente:
    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'
  • Exportar el conjunto de políticas Policy_2 en el intermediario MB8BROKER al archivo policyset.xml:
    mqsireportproperties MB8BROKER -c PolicySets 
         -o Policy_2 -n ws-security -p policyset.xml
    Puede utilizar el archivo de salida para mover conjuntos de políticas entre intermediarios y para la copia de seguridad.
  • Exportar enlaces de conjuntos de políticas de un intermediario a un archivo:
    mqsireportproperties MB8BROKER -c PolicySetBindings 
         -o Bindings_2 -n ws-security -p bindings.xml
    Este mandato graba el archivo de enlaces de conjunto de políticas Bindings_2 del intermediario MB8BROKER al archivo bindings.xml. Puede utilizar este archivo para mover enlaces de conjuntos de políticas entre intermediarios y para la copia de seguridad.
  • Mostrar las propiedades para todos los perfiles de seguridad del intermediario (perfiles de seguridad predeterminados y los que haya definido en este intermediario utilizando el mandato mqsicreateconfigurableservice):
    mqsireportproperties MB8BROKER -c SecurityProfiles 
         -o AllReportableEntityNames -r
    El resultado de este mandato tiene el formato siguiente:
    ReportableEntityName=''
    SecurityProfiles
    
    	Default_Propagation=''
    		authentication = 'NONE'
    		authenticationConfig = ''
    		authorization = 'NONE'
    		authorizationConfig = ''
    		idToPropagateToTransport = 'ID de mensaje'
    		keyStore = 'Reservado para utilizarlo en el futuro'
    		mapping = 'NONE'
    		mappingConfig = ''
    		passwordValue = 'PLAIN'
    		propagation = 'TRUE'
    		rejectBlankpassword = 'FALSE'
    		transportPropagationConfig = ''
    		trustStore = 'Reservado para utilizarlo en el futuro'
  • Visualizar las propiedades para el perfil de seguridad denominado MyFirstSecurityProfile:
    mqsireportproperties MB8BROKER -c SecurityProfiles 
         -o MyFirstSecurityProfile -r
    El resultado de este mandato tiene el formato siguiente:
    ReportableEntityName=''
    SecurityProfiles
    	MyFirstSecurityProfile=''
    		authentication = 'LDAP'
    		authenticationConfig = 'ldap://localhost:389/ou=users,o=ibm'
    		authorization = 'NONE'
    		authorizationConfig = ''
    		idToPropagateToTransport = 'ID de mensaje'
    		keyStore = 'Reservado para utilizarlo en el futuro'
    		mapping = 'TFIM'
    		mappingConfig = 'http://tfimhost1:80'
    		passwordValue = 'PLAIN'
    		propagation = 'TRUE'
    		rejectBlankpassword = 'FALSE'
    		transportPropagationConfig = ''
    		trustStore = 'Reservado para utilizarlo en el futuro'
    		
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

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

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:07


Tema de referenciaTema de referencia | Versión 8.0.0.5 | an09150_