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

IMSRequest

Utilize o nó IMSRequest para enviar u pedido de execução de transação em um sistema IMS local ou remoto, e espere pela resposta. O IMS Connect deve ser configurado e executado no sistema IMS.

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

Propósito

O exemplo a seguir ilustra a situação na qual você utilizaria um nó IMSRequest.

WebSphere® Message Brokerp ode ser utilizado para expor um destino existente de aplicativo financeiro IMS como um serviço da Web. Por exemplo, ao aplicativo IMS fornece transações que operam no banco de dados que contém as informações sobre as contas dos clientes do banco. Neste exemplo, o consumidor de serviço da Web envia uma mensagem SOAP através do HTTP para o WebSphere Message Broker e aguarda de forma sincronizada pela resposta. O fluxo de mensagens WebSphere Message Broker transforma a mensagem SOAP para o formato IMS (incluindo o LIZZ e campos de códigos de transação), e envia este fluxo de bits para o IMS. O fluxo de mensagens aguarda uma resposta. O IMS planeja o programa de destino e coloca em fila os dados do pedido para este programa. O programa de destino acessa o banco de dados de contas do consumidor, constrói a mensagem de resposta consistindo no demonstrativo da conta, e o retorna para o fluxo de mensagens WebSphere Message Broker . O fluxo de mensagens transforma o formato IMS para um formato SOAP e retorna a resposta SOAP através do HTTP para o consumidor de serviço da Web.

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

Esta Imagem Mostra o Ícone do Nó IMSRequest.

Utilizando o Nó IMSRequest em um Fluxo de Mensagens

O nó IMSRequest envia pedidos ao IMS usando o IMS Connect. O nó recebe o fluxo de bits da mensagem que chega e envia para o IMS. Ele recebe um fluxo de bits, o qual é transferido ao analisador de resposta. O fluxo de bits que é enviado para o IMS deve estar em conformidade com o formato que é mostrado no seguinte diagrama:
Este diagrama mostra o fluxo de bits e é descrito no texto circundante.
O fluxo de mensagens que contém o nó IMSRequest garante que a mensagem que é recebida pelo nó IMSRequest tenha essa estrutura, em que:
  • LLZZ é um campo com quatro bytes. Os dois primeiros bytes indicam o comprimento do fluxo de bits e os dois outros bytes estão reservados para serem utilizados pelo IMS.
  • Para segmentos de pedido, o código de transação deve seguir. O código da transação pode conter até oito caracteres; se contiver menos, deve ser delimitado por um espaço. Os segmentos de resposta não precisam ter o nome da transação, mas um programa IMS poderá incluí-lo.
  • O restante dos dados abrange tudo mais que o programa IMS necessita.
O programa IMS produz muitas mensagens. Você pode receber todas as mensagens em uma única transmissão de fluxo de bits, ou recebê-las separadamente. Cada mensagem contém múltiplos segmentos; todos os segmentos de cada mensagem são retornados ao mesmo tempo.
O nó IMSRequest possui dois modos de operação, que você especifica selecionando ou limpando a caixa de opção Usar propriedades de conexão definidas no nó. Ao selecionar a caixa de opções, todas as propriedades são retiradas do nó utilizando as seguintes propriedades na seção detalhes de conexão do nó :
  • Nome do Host
  • Número da porta
  • Nome do armazém de dados
Se você desmarcar a caixa de opções Utilizar as propriedades da conexão definida no nó todos os detalhes de conexão são retirados dos serviços configuráveis. Contudo, se a propriedadeIdentidade de Segurança estiver configurada, a identidade de segurança no serviço configurável é ignorada e o valor da propriedade do nó é utilizado.

O nó IMSRequest também pode usar uma identidade que está presente em uma mensagem de entrada e propagá-la para o IMS, usando a propriedade Propagar no perfil de segurança que é definido para o nó. Para obter informações adicionais, consulte Propagando credenciais de segurança para o IMS.

Visualize a seguinte amostra para ver como usar 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.

Usando serviços configuráveis para nós IMS

Você pode configurar os nós IMS para obter detalhes da conexão de um serviço configurável. Para obter detalhes sobre criar, alterar, relatar e excluir os serviços configuráveis, consulte Alterando Informações de Conexão para o Nó IMSRequest.

Terminais e Propriedades

Quando tiver colocado uma instância do nó IMSRequest 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. Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.

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

Terminal Descrição
Entrada O terminal de entrada que recebe a mensagem que aciona o nó.
Out O terminal de saída para o qual o nó envia uma mensagem após esta ter sido recebida do recurso externo. A mensagem é enviada ao terminal inalterada, exceto por algumas informações de status incluídas.
Falha Se ocorrer um erro no nó IMSRequest, a mensagem é enviada so terminal Failure.
Timeout O terminal de saída para o qual a mensagem é enviada se o tempo limite se esgotar. A mensagem de entrada é propagada a este terminal com uma lista de exceções que descreve o tempo limite. Se o terminal Tempo Limite não estiver conectado e uma falha de tempo limite ocorrer, a mensagem é roteada ao terminal Failure. Uma falha de tempo limite pode ocorrer nas seguintes situações:
  • O programa IMS não respondeu ante de o tempo limite de execução expirar. O tempo limite de execução é configurado utilizando a propriedade Tempo Limite de espera por uma transação a ser executada no nó IMSRequest.
  • O WebSphere Message Broker não recebeu a resposta pela rede TCP/IP antes de o tempo limite do soquete expirar. Você pode configurar o tempo limite do soquete no serviço configurável.

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 no painel se você desejar 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ê incluir o fluxo de mensagens no arquivo BAR para implementá-lo).

As propriedades Descrição do nó IMSRequest são descritas na tabela a seguir.
Propriedade M P Default Descrição
Nome do Nó Não Não O tipo de nó, IMSRequest O nome do nó.
Descrição curta 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ó IMSRequest são descritas na tabela a seguir.
Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Utilizar as propriedades de conexão definidas no nó Não Sim Selecionados Se você selecionar esta caixa de opções, as propriedades de conexão definidas no nó serão utilizadas em vez do serviço configurável e identidade de segurança definidos no broker.

Se desmarcar esta caixa de opções, é necessário configurar as propriedades Serviço Configurável e Identidade de Segurança.

 
Nome do Host Sim Sim   O endereço IP ou nome do host do computador executando o sistema de destino IMS Connect. Esta propriedade é obrigatória se a caixa de opções Utilizar as propriedades da conexão definida no nó for selecionada e poderá ser configurada apenas se Utilizar as propriedades da conexão definida no nó for selecionada. hostname
Número da porta Sim Sim 0 O nome da porta pela qual o IMS Connect está percebendo conexões TCP/IP. Você pode obter o número da porta do log de tarefas do IMS Connect no sistema IMS. Esta propriedade é obrigatória apenas se Utilize as propriedades da conexão definida no nó a caixa de opção é selecionada e poderá ser configurada apenas se Utilize as propriedades da conexão definida no nó a caixa de opção é selecionada. portNumber
Nome de armazém de dado Sim Sim   O nome do armazém de dados que o IMS Connect está utilizando. Este valor deve ser compatível com o parâmetro ID da instrução do Armazém de Dados especificado no membro da configuração do IMS Connect. Este nome também funciona como nome de membro XCF para o IMS durante as comunicações XCF internas entre o IMS Connect e o IMS OTMA. Você pode obter o nome do armazenamento de dados do log de tarefas do IMS Connect no sistema IMS. Esta propriedade é obrigatória apenas se Utilize as propriedades da conexão definida no nó a caixa de opção é selecionada e poderá ser configurada apenas se Utilize as propriedades da conexão definida no nó a caixa de opção é selecionada. dataStoreName
Tempo limite de espera por uma execução de transação Não Não 60 O tempo (em segundos) que um nó aguarda o IMS processar uma transação. Se o IMS falha ao processar uma transação neste tempo, o nó emite um exceção, mas a conexão não é encerrada.

Você pode configurar esta propriedade apenas se a caixa de opções Utilizar as propriedades da conexão definida no nó for selecionada. Se a caixa de opções estiver desmarcada, a propriedade ExecutionTimeoutSec no serviço configurável é utilizada.

 
Serviço configurável Sim Sim   O serviço configurável do qual se obtém detalhes da conexão. Todos os detalhes da conexão são obtidos d serviço configurável, exceto por informações de segurança, que são obtidas da propriedade Identificação de Segurança.

Esta propriedade é obrigatória se a caixa de opções Utilizar as propriedades da conexão definida no nó estiver desmarcada, e apenas pode ser configurada se Utilizar as propriedades da conexão definida no nó estiver desmarcada.

configurableService
Identidade de Segurança Não Sim Uma cadeia vazia A identidade de segurança a ser observada no broker para obter nome de usuário e senha a ser utilizados. É possível utilizar o comando mqsisetdbparms para configurar a identidade de segurança no broker. O valor padrão para essa propriedade é uma sequência vazia, o que significa que o ID do usuário e a senha não são transmitidos ao IMS Connect. securityIdentity
As propriedades Avançadas do nó IMSRequest são descritas na tabela a seguir.
Propriedade M P Default Descrição
Modo Comprometer Sim Não 1: SEND_THEN_COMMIT O modo comprometer a ser utilizado ao processar transações IMS. Os valores disponíveis são:
  • 1: SEND_THEN_COMMIT: (o valor padrão) A transação é processada utilizando o modo comprometimento 1 no IMS. A transação de pedido é executada e os dados enviados de volta ao nó. Após o nó reconhecer que recebeu a resposta, a transação é comprometida. Não é possível processar a resposta antes que esteja comprometida. O nó envia a resposta após o reconhecimento ser enviado ao IMS.
  • 0: COMMIT_THEN_SEND: A transação é processada utilizando o modo comprometer 0 no IMS. A transação de pedido é executada e comprometida antes de os dados serem enviados de volta ao nó. O nó aguarda todas as mensagens de respostas serem retornadas antes de continuar com o processamento.
Nível de sincronização Sim Não 1: CONFIRM O nível de sincronização a ser utilizado ao processar transações IMS. Se o Modo Comprometer é configurado para 0, o Nível de sincronização é automaticamente configurado para 1: CONFIRM. Se oModo comprometer é configurado para 1, a propriedade Nível de sincronização pode ter os seguintes valores:
  • 1: CONFIRM: (o valor padrão) O nó envia um reconhecimento ao IMS depois que receber as respostas. O nó envia então a resposta após o reconhecimento é enviado ao IMS. Se você configurar o Nível sync como 1: CONFIRM, o programa IMS ficará bloqueado até que o nó IMSRequest reconheça a saída da transação, que pode afetar o desempenho.
  • 0: NONE: O nó não envia nenhum reconhecimento. Este valor é aplicável apenas quando o Modo comprometer está configurado para 1.

Geralmente, Nível de Sincronização pode ser configurado como 0: NONE para tipos de interações somente leitura, tais como consultas, que não precisam de um reconhecimento. Contudo, para transações críticas envolvendo atualizações e exclusões, é importante poder reconhecer a saída do IMS. Se o reconhecimento não for recebido (por exemplo, por causa de uma falha de conexão entre o WebSphere Message Broker e o IMS Connect), a transação será restaurada, evitando a necessidade de uma transação de compensação.

As propriedades Pedido do nó IMSRequest são descritas na tabela a seguir.
Propriedade M P Default Descrição
Local dos Dados Sim Não $Body O local da árvore de mensagens de entrada de onde os dados são recuperados para formar o pedido enviado pelo nó IMSRequest para o IMS. O valor padrão $Body representa o corpo da mensagem que chega. É possível inserir qualquer expressão XPath ou ESQL que define o local da árvore de mensagens para serializar e enviar ao IMS.
As propriedades Resultado do nó IMSRequest são descritas na tabela a seguir.
Propriedade M P Default Descrição
Local de dados de saída Não Não $OutputRoot O local da árvore de mensagens para o qual o nó IMSRequest copia a árvore de mensagens de resposta na montagem de mensagem de saída. O valor padrão $OutputRoot substitui a mensagem que chega com a resposta.

Consulte o Combinando uma Mensagem de Resultado com uma Mensagem Recebida.

Copiar ambiente local Não Não Selecionados Esta propriedade controla se o ambiente local de entrada é copiado ou propagado. Por padrão, esta caixa de opções está selecionada, o que significa que o ambiente de local é copiado para que o ambiente local de entrada seja preservado. As inclusões ao ambiente local são visíveis apenas aos nós de recebimento de dados deste nó. Se esta caixa de resposta estiver selecionada, o ambiente local de entrada é utilizado para as mensagens de saída. Quaisquer alterações feitas no ambiente local por este nó são visíveis em ambos fluxos de envio e recebimento de dados após este nó ter sido concluído.
As propriedades Análise de Mensagem de Resposta do nó IMSRequest são descritas na tabela a seguir.
Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Domínio de mensagem Não Não   O domínio a ser utilizado para analisar mensagens do fluxo de bits fornecido do recurso externo.  
Conjunto de Mensagens Não Não Configurar automaticamente O nome do conjunto de mensagens no qual a mensagem que chega é definida.

Se você configurar esta propriedade, então, subseqüentemente atualizar as dependências do projeto para remover esta referência do conjunto de mensagens, um aviso será emitido. 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 de resposta.  
Formato de Mensagem Não Não   O nome do formato físico da mensagem de resposta.  
ID do conjunto de caracteres codificados de mensagens Sim Não EBCDIC (500) O ID do conjunto de caracteres codificado que é usado para interpretar bytes dos dados que estão sendo lidos. Os valores válidos são EBCDIC (500) e Padrão do Sistema Broker. messageCodedCharSetIdProperty
Codificação de mensagens Sim Não Big Endian, com S390 Floating Point (785) O esquema de codificação para números e caracteres grandes que é usado para interpretar bytes dos dados que estão sendo lidos. Os valores válidos são:
  • Little Endian, com IEEE Floating Point (546)
  • Big Endian, com IEEE Floating Point (273)
  • Big Endian, com S390 Floating Point (785)
  • Determinado pelo Sistema Broker
Para obter informações adicionais sobre codificação, consulte Conversão de Dados.
messageEncodingProperty

As propriedades Opções do Analisador do nó IMSRequest são descritas na tabela a seguir.

Propriedade M P Default Descrição
Cronometragem de análise (Parse timing) Sim Não On Demand Essa propriedade controla quando uma mensagem de resposta é analisada. Os valores válidos são On Demand, Imediato e Completo.

Para obter uma descrição completa desta propriedade, consulte Analisando On Demand.

Construir árvore utilizando tipos de dados de esquema XML Sim Não Desmarcada Esta propriedade controla se o analisador XMLNSC cria elementos de sintaxe na árvore de mensagens com tipos de dados retirados do Esquema XML. Você pode selecionar esta propriedades apenas se configurar a propriedade Validar na guia Validação ou Conteúdo ou Conteúdo e Valor.
Utilizar analisador compacto XMLNSC para domínio XMLNS Sim Não Desmarcada Essa propriedade controla se o Analisador Compacto XMLNSC (XMLNSC Compact Parser) é utilizado para mensagens no Domínio XMLNS (XMLNS Domain). Se você definir essa propriedade, os dados da mensagem de resposta serão exibidos em XMLNSC nos nós que estão conectados ao terminal de saída, quando o cabeçalho MQRFH2 de entrada ou o domínio das propriedades Análise de Mensagem de Resposta for XMLNS.
Reter conteúdo misto (Retain mixed content) Sim Não Desmarcada Essa propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de resposta. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se você desmarcar a caixa de opções, texto misto será ignorado e nenhum elemento será criado.
Reter comentários (Retain comments) Sim Não Desmarcada Essa propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar comentários em uma mensagem de resposta. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se você desmarcar a caixa de opções, comentários serão ignorados e nenhum elemento será criado.
Reter instruções de processamento (Retain processing instructions) Sim Não Desmarcada Essa propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento em uma mensagem de resposta. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se você desmarcar a caixa de opções, instruções de processamento serão ignoradas e nenhum elemento será criado.
Elementos opacos Não Não Branco Essa propriedade é utilizada para especificar uma lista de elementos na mensagem de resposta que devem ser analisados em segundo plano pelo analisador XMLNSC. A análise de ignorados será desempenhada apenas se a validação não estiver ativada (ou seja, se Validar for Nenhum); as entradas especificadas em Elementos Ignorados serão ignoradas se a validação estiver ativada.

As propriedades Validação do nó IMSRequest são descritas na tabela a seguir.

Para obter uma descrição completa dessas propriedades, consulte Propriedades de Validação.
Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Validar Sim Sim Nenhum(a) Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Valor, Conteúdo e Herdar. validateMaster
Ação de falha Sim Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. Você pode configurar essa propriedade somente se configurar Validar como Conteúdo ou Conteúdo e Valor. Os valores válidos são Rastreio do Usuário, Registro de Erros Local, Exceção e Lista de Exceções.  
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:52


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