WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

SAPInput

Utilize o nó SAPInput para aceitar a entrada de um aplicativo SAP.

Este tópico contém as seguintes seções:

Propósito

Utilize o nó SAPInput para aceitar a entrada de aplicativos SAP. Por exemplo, o nó SAPInput pode monitorar um sistema SAP para novas ordens de compra. Quando uma nova ordem de compra é criada, o nó SAPInput gera a árvore de mensagens que representa o objeto de negócios com os detalhes da nova ordem de compra. A árvore de mensagens é propagada para o terminal Out para que o restante do fluxo de mensagens possa utilizar os dados para atualizar outros sistemas ou aditar as alterações.

O nó SAPInput está contido no repositório WebSphere Adapters da paleta do nó do fluxo de mensagens e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó SAPInput

Utilizando este nó em um fluxo de mensagens

O nó SAPInput precisa de um componente adaptador para funcionar corretamente. Você configura o componente utilizando a propriedade do nó Componente Adaptador e as definições de objeto de negócios, que são armazenadas no conjunto de mensagens que você referencia a partir do nó. Por isso, é necessário fornecer um conjunto de mensagens. Por padrão, a mensagem propagada do nó SAPInput está no domínio DataObject, portanto, a propriedade Domínio de Mensagem está configurada como DataObject. Você não pode especificar um domínio diferente. O tipo de mensagem é detectado automaticamente pelo nó.

O nó SAPInput preenche a lista de destino de rota para o rótulo com o nome da ligação do método. Se você incluir um nó RouteToLabel no fluxo de mensagens após o nó SAPInput, o nó RouteToLabel poderá utilizar o nome da ligação do método para rotear a mensagem para o caminho correto do fluxo de mensagens para processamento.

Você pode implementar apenas um nó de entrada que utiliza um componente adaptador específico para um grupo de execução, mas pode implementar muitos nós de entrada que utilizam diferentes componentes adaptadores para um grupo de execução.

É possível utilizar o comando mqsisetdbparms no seguinte formato para configurar um nome de conta com um nome de usuário e senha para o Adapter para SAP Software.
mqsisetdbparms broker name -n adapter name -u user name -p password
Por Exemplo:
mqsisetdbparms BRK1 -n eis::SAPCustomerInbound.inadapter -u
sapuid -p ********
O adaptador de entrada do SAP possui uma propriedade chamada Número de listeners, que configura o adaptador a ter um número particular de encadeamentos atendendo o ID do programa SAP RFC. Esses encadeamentos não são utilizados diretamente para processar mensagens em um fluxo de mensagens. Quando um listener de mensagem tiver um evento a fornecer ao fluxo de mensagens, ele solicita uma das instâncias do fluxo. Em geral, é sensato manter o número de listeners igual ao número de instâncias (sendo que instâncias é igual a 1 mais instâncias adicionais configuradas no fluxo ou nó). Por Exemplo:
  • Se o número de listeners for 1 e de instâncias adicionais for 0, você obtém um fluxo de mensagens de encadeamento único que processa uma mensagem por vez.
  • Se o número de listener for 2 e de instâncias adicionais for 1, você obtém dois encadeamentos que processam mensagens ao mesmo tempo.
  • Se o número de listeners for 2 e de instâncias adicionais for 0, você obtém dois encadeamentos que recebem dados do EIS, mas somente um encadeamento de fluxo de mensagens será executado.
Os listeners bloqueiam o processamento até uma instância do fluxo de mensagens estar disponível; os listeners não enfileiram diversos trabalhos. Se você deixar o número de listeners configurado para 1 (o valor padrão), o broker assegura que o número de listeners seja igual ao número de instâncias adicionais mais um. Encadeamentos adicionais podem aumentar o rendimento de um fluxo de mensagens, mas considere o efeito potencial no pedido da mensagem.

Utilizando serviços configuráveis para nós SAP

Os nós SAP podem conseguir detalhes da conexão SAP tanto do componente adaptador quanto de um serviço cofigurável. Usando um serviço configurável, é possível alterar os detalhes da conexão para um adaptador sem a necessidade de reimplementar o adaptador. Para obter detalhes adicionais sobre como criar, alterar, relatar e excluir os serviços configuráveis para o SAP, consulte Alterando os detalhes da conexão para adaptadores SAP.

Roteamento de IDoc Genérico

Usando o nó do SAPInput no modo de passagem, o WebSphere Message Broker pode receber qualquer IDoc e roteá-lo de acordo com o tipo de IDoc. Para obter informações adicionais, consulte Roteamento de IDoc Genérico. É possível usar um padrão para processar IDocs de vários tipos com um único ID do programa RFC sem precisar reimplementar ou redescobrir conjuntos de mensagens e adaptadores existentes, mesmo ao incluir novos tipos de IDoc. Para obter informações adicionais, consulte o padrão: Distribuição de Dados SAP para o WebSphere MQ: unidirecional (para IDoc). É possível visualizar padrões no centro de informações usando os links somente quando você usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit, ou quando usar o centro de informações on-line.

Veja as amostras a seguir para consultar sobre como utilizar este nó:

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Terminais e Propriedades

Quando tiver colocado uma instância do nó SAPInput em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Se você clicar duas vezes em um nó SAPInput, abrirá o assistente de Conexão do Adaptador. Todas as propriedades obrigatórias para as quais é necessário inserir um valor (as propriedades que não têm um valor-padrão definido) são marcadas com um asterisco.

Os terminais do nó SAPInput são descritos na tabela a seguir.

Terminal Descrição
Out Os eventos do Objeto de Negócios do adaptador são enviados para o terminal Out.
Falha Se um erro ocorrer no nó SAPInput, a mensagem será propagada para o terminal de Falha. Informações sobre o erro e eventos do objeto de negócios também podem ser propagadas ao terminal de Falha.
Catch Os eventos do Objeto de Negócios são enviados para o terminal Catch se eles causarem uma exceção de não captura no fluxo de mensagens. Se o terminal Catch não estiver conectado, o processo de repetição será ativado para manipular o objeto de negócios.

As tabelas a seguir descrevem as propriedades do nó. As colunas com cabeçalho M indicam se a propriedade é obrigatória (marcada com um asterisco se você precisar inserir um valor quando nenhum padrão estiver definido); as colunas com cabeçalho C indicam se a propriedade é configurável (é possível alterar o valor quando você inclui o fluxo de mensagens no arquivo BAR para implementá-lo).

As propriedades Descrição do nó SAPInput são descritas na tabela a seguir.
Propriedade M P Default Descrição
Nome do Nó Não Não O tipo de nó, SAPInput O nome do nó.
Descrição Breve Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.
As propriedades Básicas do nó SAPInput são descritas na tabela a seguir.
Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Componente adaptador primário Sim Sim   O nome do componente adaptador que contém propriedades de configuração para o adaptador. Digite um nome de um arquivo do adaptador ou clique em Procurar para selecionar um arquivo do adaptador da lista de arquivos que estão disponíveis nos projetos do conjunto de mensagens referidos.

Quando o nó SAPInput recebe dados do sistema SAP, ele associa esses dados com um nome de método, dependendo do nome da operação de serviço que é designada para esse tipo de dados quando você executa o assistente Adapter Connection. O nó SAPInput tenta manipular os métodos que estão definidos no adaptador primário. Se o tipo de dados que é recebido não corresponder a nenhum dos métodos que estejam definidos no adaptador primário, o nó poderá manipular métodos que estejam definidos nos adaptadores secundários correspondentes que estejam implementados no mesmo grupo de execução.

adapterComponent
Modo do adaptador secundário Não Sim Nenhum Especifica se o nó pode manipular métodos que estejam definidos nos adaptadores secundários.

Se você definir a propriedade Modo do adaptador secundário como Nenhum, o nó manipula apenas métodos que estejam definidos no adaptador primário. Se o tipo de dados que é recebido não corresponder a nenhum dos métodos que estão definidos no adaptador primário, ocorrerá uma falha.

Se você configurar essa propriedade como Todos os adaptadores no aplicativo, o nó poderá manipular métodos definidos nos adaptadores de entrada SAP correspondentes que estejam implementados no mesmo aplicativo. Se o nó for implementado como recurso independente (ou seja, não está contido em um aplicativo), ele poderá chamar métodos definidos em qualquer adaptador de entrada SAP que também esteja implementado como recurso independente.

secondaryAdapterMode
As propriedades Avançadas do nó SAPInput são descritas na tabela a seguir.
Propriedade M P Default Descrição
Tempo máximo de espera do cliente (s) Não Sim 60 O tempo (em segundos) para o sistema SAP aguardar o retorno de uma resposta por um nó SAPReply. O valor-padrão é 60 segundos. Se uma resposta for enviada para um nó SAPReply após o tempo limite, o nó SAPReply emitirá uma exceção. Se o broker for interrompido enquanto o adaptador estiver aguardando um nó SAPReply para fornecer uma resposta, será retornada uma falha do sistema para o sistema SAP.

Se você configurar esta propriedade como zero (0), o sistema SAP aguardará indefinidamente o retorno de uma resposta por um nó SAPReply.

Esta propriedade é aplicável apenas no modo de retorno de chamada síncrono; ela não se aplica a BAPIs ou IDOCs assíncronos. Se você configurar esta propriedade para um nó SAPInput que esteja configurado com um adaptador que não seja para retorno de chamada síncrono, será emitido um aviso.

As propriedades Roteamento do nó SAPInput são descritas na tabela a seguir.
Propriedade M P Default Descrição
Configurar lista de destino Não Não Selecionados Especifica se deve incluir o nome de ligação do método para a lista de destino de rota para o rótulo. Se você selecionar esta caixa de opção, o nome da ligação do método será incluído para que seja possível utilizar um nó RouteToLabel no fluxo de mensagens após o nó SAPInput.
Prefixo do rótulo Não Não   O prefixo a incluir no nome do método ao rotear para um rótulo. Inclua um prefixo do rótulo para evitar um conflito de nós do rótulo correspondentes quando incluir vários nós de entrada do WebSphere Adapters no mesmo fluxo de mensagens. Por padrão, não existe nenhum prefixo de rótulo, portanto, o nome do método e o nome do rótulo são idênticos.
As propriedades Análise de Mensagem de Entrada do nó SAPInput são descritas na tabela a seguir.
Propriedade M P Default Descrição
Domínio de mensagem Não Não DataObject O domínio utilizado para analisar a mensagem que chega. Por padrão, a mensagem propagada do nó SAPInput está no domínio DataObject. Você não pode especificar um domínio diferente.
Conjunto de Mensagens Sim Não Configurar automaticamente O nome do conjunto de mensagens no qual a mensagem que chega é definida. Este campo é configurado automaticamente na propriedade Componente do Adaptador.

Se você configurar esta propriedade e, posteriormente, atualizar as dependências do projeto para remover esta referência do conjunto de mensagens, será emitido um aviso. Atualize a propriedade Conjunto de Mensagens ou restaure a referência para este projeto de conjunto de mensagens.

Tipo de mensagem Não Não   O nome da mensagem que chega. O nó detecta o tipo de mensagem automaticamente. Você não pode configurar esta propriedade.
Formato de Mensagem Não Não   O nome do formato físico da mensagem que chega. Você não pode configurar esta propriedade.
As propriedades Transacionalidade do nó SAPInput são descritas na tabela a seguir.
Propriedade M P Default Descrição
Modo de Transação Não Não Sim O modo de transação neste nó de entrada determina se o restante dos nós no fluxo de mensagens são executados no ponto de sincronização.
As propriedades Instâncias do nó SAPInput são descritas na tabela a seguir. Para obter uma descrição completa destas propriedades, consulte Propriedades Configuráveis do Fluxo de Mensagens. Para obter informações adicionais sobre como ajustar o adaptador SAP, consulte Ajustando o Adaptador SAP para Escalabilidade e Desempenho.
Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Conjunto de instâncias adicionais Não Sim Utilizar Conjunto Associado ao Fluxo de Mensagens O conjunto do qual as instâncias adicionais são obtidas.
  • Se você selecionar Utilizar Conjunto Associado ao Fluxo de Mensagens, as instâncias adicionais serão obtidas do valor do fluxo de mensagens.
  • Se você selecionar Usar Conjunto Associado ao Nó, instâncias adicionais serão alocadas a partir das instâncias adicionais do nó com base no número especificado na propriedade Instâncias Adicionais.
componentLevel
Instâncias Adicionais Não Sim 0 O número de instâncias adicionais que o nó pode iniciar se a propriedade do Conjunto de Instâncias Adicionais estiver configurada como Utilizar Conjunto Associado ao Nó. Por padrão, não são concedidas instâncias adicionais ao nó. additionalInstances
As propriedades Repetição do nó SAPInput são descritas na tabela a seguir.
Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Tentar mecanismo novamente Não Não Failure Especifica como o processamento de nova tentativa é manipulado quando uma falha é recuperada para o nó SAPInput.
  • Se você selecionar Falha, o processamento de repetição não será desempenhado, portanto, não será possível configurar as propriedades restantes.
  • Se você selecionar Repetições Rápidas e Longas, o processamento repetição será desempenhado primeiro no intervalo especificado pela propriedade Intervalo de Repetições Rápidas e, se for malsucedido, será desempenhado no intervalo especificado pela propriedade Intervalo de Repetições Longas.
 
Tentar limite novamente Não Sim 0 O número máximo de vezes que o processamento de repetição é desempenhado para repetição rápida. retryThreshold
Intervalo de repetições curtas Não Sim 0 O intervalo entre tentativas de repetições rápidas. shortRetryInterval
Intervalo de repetições longas Não Sim 0 O intervalo entre tentativas de repetições longas. longRetryInterval
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:37


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac37290_