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

Nodo SAPInput

Utilice el nodo SAPInput para aceptar entrada de una aplicación SAP.

Este tema contiene las siguientes secciones:

Finalidad

Utilice el nodo SAPInput para aceptar entrada de aplicaciones SAP. Por ejemplo, el nodo SAPInput puede supervisar un sistema SAP para nuevos pedidos de compra. Cuando se produce un nuevo pedido de compra, el nodo SAPInput genera un árbol de mensaje que representa el objeto de empresa con los nuevos detalles del pedido de compra. El árbol de mensaje se propaga al terminal de salida para que el resto del flujo de mensajes pueda utilizar los datos para actualizar otros sistemas o para auditar los cambios.

El nodo SAPInput se representa en la bandeja WebSphere Adapters de la paleta de nodos de flujos de mensajes, y se representa en el WebSphere Message Broker Toolkit con el siguiente icono:

Icono de nodo SAPInput

Utilización de este nodo en un flujo de mensajes

El nodo SAPInput necesita un componente de adaptador para funcionar correctamente. El componente se establece utilizando la propiedad de nodo Componente de adaptador y definiciones de objeto de empresa, que están almacenadas en el conjunto de mensajes al que hace referencia desde el nodo. Por esta razón, debe proporcionar un conjunto de mensajes. De forma predeterminada, el mensaje que se propaga desde el nodo SAPInput está en el dominio de DataObject, por lo tanto la propiedad Dominio de mensajes se establece en DataObject. No puede especificar un dominio distinto. El nodo detecta automáticamente el tipo de mensaje.

El nodo SAPInput rellena la lista de destinos de Route-to-label con el nombre del enlace de método. Si añade un nodo RouteToLabel al flujo de mensajes después del nodo SAPInput, el nodo RouteToLabel puede utilizar el nombre del enlace de método para direccionar el mensaje a la parte correcta del flujo de mensajes para su proceso.

Puede desplegar sólo un nodo de entrada que utiliza un componente de adaptador concreto para un grupo de ejecución, aunque puede desplegar varios nodos de entrada que utilizan componentes de adaptador distintos para un grupo de ejecución.

Puede utilizar el mandato mqsisetdbparms en el siguiente formato para configurar un nombre de cuenta con un nombre de usuario y una contraseña para el Adaptador para Software SAP.
mqsisetdbparms nombre de intermediario -n nombre de adaptador -u nombre de usuario -p contraseña
Por ejemplo:
mqsisetdbparms BRK1 -n eis::SAPCustomerInbound.inadapter -u sapuid -p ********
El adaptador de entrada SAP RFC tiene una propiedad llamada Número de escuchas, que configura el adaptador de forma que tenga un número concreto de hebras a la escucha en el ID del programa SAP. Estas hebras no se utilizan directamente para procesar mensajes en un flujo de mensajes. Cuando un escucha de mensajes tiene un suceso para entregar al flujo de mensajes, solicita una de las instancias del flujo. En general, es susceptible a mantener el número de escuchas igual al número de instancias (donde instancias es igual a 1 más instancias adicionales establecidas en el flujo o nodo). Por ejemplo:
  • Si el número de escuchas es 1, y las instancias adicionales es 0, obtiene un flujo de mensajes de una sola hebra que procesa un mensaje a la vez.
  • Si el número de escuchas es 2 y las instancias adicionales es 1, obtiene dos hebras que procesan mensajes a la vez.
  • Si el número de escuchas es 2, y las instancias adicionales es 0, obtiene dos hebras que reciben datos del EIS, pero sólo se ejecutará una hebra del flujo de mensajes.
El bloque de escuchas se procesa hasta que haya disponible una instancia de flujo de mensajes; los escuchas no ponen en la cola varias partes de un trabajo. Si deja el número de escuchas establecido en 1 (el valor predeterminado), el intermediario se asegura de que el número de escuchas sea igual al número de instancias adicionales más uno. Las hebras adicionales pueden aumentar la productividad de un flujo de mensajes, pero debe tenerse en cuenta el posible efecto en el orden de los mensajes.

Utilización de servicios configurables para nodos SAP

Los nodos SAP pueden obtener detalles de conexiones SAP del componente adaptador o de un servicio configurable. Utilizando un servicio configurable, puede cambiar los detalles de conexión de un adaptador sin tener que volver a desplegar el adaptador. Para obtener más información sobre la creación, el cambio, la notificación y la supresión de servicios configurables para SAP, consulte Cambiar detalles de conexión para adaptadores SAP.

Direccionamiento IDoc genérico

Al utilizar el nodo SAPInput en modalidad passthrough, WebSphere Message Broker puede recibir ningún IDoc y ruta de acuerdo con el tipo de IDoc. Para obtener más información, consulte Direccionamiento IDoc genérico. Puede utilizar un patrón para procesar IDoc de varios tipos con un solo ID de programa RFC sin tener que volver a desplegar ni volver a descubrir los conjuntos de mensajes y adaptadores existentes, incluso cuando añada nuevos tipos de IDoc. Para obtener más información, consulte el patrón: Distribución de datos SAP a WebSphere MQ: unidireccional (para IDoc). Puede ver patrones en el Information Center mediante los enlaces sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit, o cuando utilice el Information Center en línea.

Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.

Terminales y propiedades

Cuando haya colocado una instancia del nodo SAPInput en un flujo de mensajes, podrá configurarlo; consulte el tema Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Si efectúa una doble pulsación en un nodo SAPInput, abra el asistente Conexión de adaptador. Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.

Los terminales de nodo SAPInput se describen en la siguiente tabla.

Terminal Descripción
Out (de salida) Los sucesos de Objeto de empresa del adaptador se envían al terminal de salida.
Failure (de anomalías) Si se produce un error en el nodo SAPInput, el mensaje se propaga al terminal Failure (de anomalías). La información sobre el error y sucesos de objeto de empresa también se puede propagar al terminal Failure (de anomalías).
Catch (de captación) Los sucesos de Objeto de empresa se envían al terminal Catch (de captación) si provocan una excepción sin detectar en el flujo de mensajes. Si el terminal Catch (de captación) no está conectado, el proceso de reintento se activa para manejar el objeto de empresa.

Las tablas siguientes describen las propiedades del nodo. Las columnas con la cabecera O indican si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); las columnas con la cabecera C indican si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo BAR para desplegarlo).

Las propiedades de descripción del nodo SAPInput se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo, SAPInput El nombre del nodo.
Descripción corta No No   Una descripción breve del nodo.
Descripción larga No No   Texto que describe la finalidad del nodo en el flujo de mensajes.
Las propiedades básicas del nodo SAPInput se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Componente de adaptador primario   Nombre del componente de adaptador que contiene propiedades de configuración para el adaptador. Especifique un nombre de un archivo de adaptador o pulse Examinar para seleccionar un archivo de adaptador en la lista de archivos que están disponibles en proyectos de conjuntos de mensajes referenciados.

Cuando el nodo SAPInput recibe datos del sistema SAP, asocia los datos a un nombre de método, dependiendo del nombre de la operación de servicio que se haya asignado a este tipo de datos cuando se ha ejecutado el asistente Conexión de adaptador. El nodo SAPInput intenta gestionar métodos que se han definido en el adaptador primario. Si el tipo de datos que se reciben no corresponde a ninguno de los métodos que se han definido en el adaptador primario, el nodo puede gestionar los métodos que se han definido en los adaptadores secundarios coincidentes que se despliegan en el mismo grupo de ejecución.

adapterComponent
Modalidad de adaptador secundario No Ninguna Especifica si el nodo puede gestionar métodos que se hayan en adaptadores secundarios.

Si ha establecido la propiedad Modalidad de adaptador secundario en Ninguna, el nodo gestiona solamente los métodos definidos en el adaptador primario. Si el tipo de datos que se reciben no corresponden a ninguno de los métodos que se han definido en el adaptador primario, se produce una anomalía.

Si establece esta propiedad en Todos los adaptadores de la aplicación, el nodo puede manejar métodos que esté definidos en los adaptadores de entrada SAP coincidentes que se hayan desplegado en la misma aplicación. Si el nodo se despliega como recurso independiente (es decir, no se incluye en una aplicación), el nodo puede llamar a métodos que se definen en el adaptador de entrada SAP que también se despliega como recurso independiente.

secondaryAdapterMode
Las propiedades Avanzadas del nodo SAPInput están descritas en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Tiempo máximo de espera de cliente (seg) No 60 El tiempo (en segundos) que debe esperar el sistema SAP una respuesta que debe devolver un nodo SAPReply. El valor predeterminado es de 60 segundos. Si se envía una respuesta a un nodo SAPReply después del tiempo de espera, el nodo SAPReply emite una excepción. Si el intermediario está detenido mientras el adaptador está esperando que un nodo SAPReply proporcione una respuesta, se vuelve a enviar al sistema SAP una anomalía del sistema.

Si establece esta propiedad en cero (0), el sistema SAP espera indefinidamente una respuesta que debe devolver un nodo SAPReply.

Esta propiedad es aplicable sólo a la modalidad de devolución de llamada síncrona; no se aplica a las BAPI o IDOC asíncronas. Si establece esta propiedad para un nodo SAPInput que se ha configurado con un adaptador que no es para devoluciones de llamada síncronas, se emitirá un aviso.

Las propiedades de direccionamiento del nodo SAPInput se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Establecer lista de destinos No No Seleccionado Especifica si se tiene que añadir el nombre de enlace de método a la lista de destinos Route-to-label. Si selecciona este recuadro, se añade el nombre de enlace de método para que pueda utilizar un nodo RouteToLabel en el flujo de mensajes después del nodo SAPInput.
Prefijo de etiqueta No No   El prefijo se añade al nombre de etiqueta al direccionar a una etiqueta. Añada un prefijo de etiqueta para evitar un conflicto de los nodos de etiqueta correspondientes cuando se incluyen varios nodos de entrada de Adaptadores de WebSphere en el mismo flujo de mensajes. De forma predeterminada, no hay ningún prefijo de etiqueta, por lo que el nombre de método y el nombre de etiqueta son idénticos.
En la tabla siguiente se describen las propiedades de Análisis de mensajes de entrada del nodo SAPInput.
Propiedad O C Valor predeterminado Descripción
Dominio de mensajes No No DataObject Dominio que se utiliza para analizar el mensaje de entrada. De forma predeterminada, el mensaje que se propaga desde el nodo SAPInput está en el dominio de DataObject. No puede especificar un dominio distinto.
Conjunto de mensajes No Se establece automáticamente Nombre del conjunto de mensajes en el que se define el mensaje de entrada. Este campo se establece automáticamente en la propiedad Componente de adaptador.

Si establece esta propiedad y, a continuación, actualiza las dependencias del proyecto para eliminar esta referencia de conjunto de mensajes, se emite un aviso. Actualice la propiedad Conjunto de mensajes o restaure la referencia a este proyecto de conjunto de mensajes.

Tipo de mensaje No No   Nombre del mensaje de entrada. El nodo detecta automáticamente el tipo de mensaje. Esta propiedad no se puede establecer.
Formato del mensaje No No   Nombre del formato físico del mensaje de entrada. Esta propiedad no se puede establecer.
Las propiedades de transaccionalidad del nodo SAPInput se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Modalidad de transacción No No La modalidad de transacción de este nodo de entrada determina si el resto de los nodos del flujo de mensajes se ejecutan bajo el punto de sincronismo.
En la tabla siguiente se describen las propiedades de instancias del nodo SAPInput. Para obtener una descripción detallada de estas propiedades, consulte Propiedades configurables del flujo de mensajes. Para obtener más información sobre cómo ajustar el adaptador SAP, consulte Ajuste del adaptador SAP a efectos de escalabilidad y rendimiento.
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Agrupación de instancias adicionales No Utilizar agrupación asociada al flujo de mensajes La agrupación de la que se obtienen instancias adicionales.
  • Si selecciona Utilizar agrupación asociada al flujo de mensajes, se obtienen instancias adicionales del valor del flujo de mensajes.
  • Si selecciona Utilizar agrupación asociada al nodo, se asignan instancias adicionales desde las instancias adicionales del nodo basándose en el número especificado en la propiedad Instancias adicionales.
componentLevel
Instancias adicionales No 0 El número de instancias adicionales que el nodo puede iniciar si la propiedad Agrupación de instancias adicionales se establece en Utilizar agrupación asociada al nodo. De forma predeterminada, no se otorga ninguna instancia adicional al nodo. additionalInstances
Las propiedades de reintento del nodo SAPInput se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Mecanismo de reintento No No Anomalía Especifica cómo se maneja el proceso de reintento cuando se retrotrae una anomalía al nodo SAPInput.
  • Si selecciona Anomalía, el proceso no se lleva a cabo y no se podrán establecer las propiedades restantes.
  • Si selecciona Reintento corto y largo, se lleva a cabo el proceso de reintento primero en el intervalo especificado por la propiedad Intervalo de reintento corto y, si no es satisfactorio, se lleva a cabo en el intervalo especificado por la propiedad Intervalo de reintento largo.
 
Umbral de reintentos No 0 El número máximo de veces que se lleva a cabo el proceso de reintento para el reintento corto. retryThreshold
Intervalo de reintento corto No 0 El intervalo entre reintentos cortos. shortRetryInterval
Intervalo de reintento largo No 0 El intervalo entre reintentos largos. longRetryInterval
Las propiedades de supervisión del nodo se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Sucesos No No Ninguno Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles.

Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado.

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 16:58:39


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