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