Antes de Iniciar
Procedimento
Para enviar uma solicitação para um serviço Java MQ:
- Clique em Abrir o Cliente de Serviço Genérico (
) e selecione a
página Solicitações. - Clique em Incluir (
) ou em
Biblioteca de Solicitação, clique com o botão direito em EndPoints e selecione um tipo de solicitação
a ser enviado. - Na janela Configurar Protocolo, selecione WebSphere Java MQ e especifique a configuração de transporte. Se necessário, crie a configuração de transporte para a chamada clicando em Nova (veja Criando uma configuração de transporte do WebSphere Java MQ).
- Conclua as informações a seguir na guia Geral:
- Fila
- Nome da fila, conforme definido no Servidor do WebSphere MQ.
- Tipo de mensagem
- Os tipos de mensagens são estes:
- Datagrama significa que a mensagem não requer uma resposta.
- Solicitação significa que a mensagem requer uma resposta.
- Resposta significa que a mensagem é uma resposta para uma mensagem anterior de solicitação.
- Relatório significa que a mensagem está sendo relatada em alguma ocorrência esperada ou inesperada, geralmente relatada para alguma outra mensagem. Um exemplo é uma mensagem de solicitação que continha dados inválidos.
- Persistência de Mensagem
Este valor indica se a mensagem é persistente ou não. Se a mensagem for persistente, ela sobreviverá às falhas do sistema e à reinicializações do gerenciador de filas. Se a mensagem não for persistente, ela sobreviverá a uma reinicialização, se estiver presente em uma fila que tiver o atributo NPMCLASS(HIGH). No entanto, mesmo com o atributo NPMCLASS(HIGH), a mensagem não sobreviverá a uma classe QMGR. Mensagens não persistentes em filas que tiverem o atributo NPMCLASS (NORMAL) serão descartadas na reinicialização do gerenciador de filas, mesmo se a mensagem for encontrada no armazenamento auxiliar durante o procedimento de reinicialização.
- Resposta Dinâmica
- Marque esta caixa de seleção para o Servidor do WebSphere MQ, para criar dinamicamente uma fila provisória como uma resposta. Se essa caixa de seleção não estiver selecionada, a mensagem na Fila de Resposta será usada.
- Fila de Resposta
Este é o nome da fila de mensagens à qual o aplicativo que emitiu a solicitação get para a mensagem deve enviar a resposta e relatar mensagens.
- Gerenciador de Resposta
Este é o nome do gerenciador de filas no qual a fila de resposta é definida.
- Propriedades Adicionais
- Especifique as propriedades adicionais para as filas.
- Opcional: Se necessário, conclua as informações a seguir na guia Config:
- Prioridade da Mensagem
Esta é a prioridade da mensagem. A prioridade mais baixa é 0.
- Codificação
Esta é a codificação numérica de dados numéricos na mensagem. Este valor não se aplica a dados numéricos na própria estrutura MQMD.
- Intervalo de Validação
Este é o período de tempo, em décimos de segundo, após o qual a mensagem torna-se elegível para ser descartada, se ela ainda não tiver sido removida da fila de destino. O intervalo de validação é configurado pelo aplicativo que colocou a mensagem.
- Conjunto de caracteres
Este é o identificador de conjunto de caracteres dos dados de caractere nos dados de mensagem do aplicativo.
- Opcional: Na guia Relatório, selecione as mensagens de relatório a serem recebidas.
- Opcional: Se necessário, conclua as informações a seguir na guia Contexto:
- Dados de Identificação de Aplicativo
Estas informações são definidas pelo conjunto de aplicativos. Use-as para fornecer informações sobre a mensagem ou o seu originador.
- Dados de Origem de Aplicativo
Estas informações são definidas pelo conjunto de aplicativos. Use-as para fornecer informações adicionais sobre a origem da mensagem.
- Token de Conta
Estas informações são necessárias para o aplicativo, para cobrar adequadamente pelo trabalho que é feito como um resultado da mensagem.
- ID do Usuário
Este é o identificador do usuário do aplicativo que originou a mensagem.
- Opcional: Na guia Identificadores, para as mensagens que requerem entrada binária, especifique o ID no formato de sequência na segunda coluna. A primeira coluna é preenchida automaticamente no formato hexadecimal.
- Opcional: Na guia Segmentação, selecione o segmento da mensagem e clique em Avançar.
- Essa etapa não é aplicável para uma Solicitação de texto. Na página Selecionar Elemento-Raiz, se o serviço usar uma XML Schema Definition (XSD) específica, selecione uma a partir da lista. Se o elemento XSD não estiver listado, clique em Procurar para importar o arquivo XSD e selecione o elemento-raiz para a solicitação. Se nenhum XSD estiver disponível para o serviço, selecione Nenhum Esquema.
- Clique em Concluir. A solicitação é incluída na seção Endpoints da Biblioteca de Solicitações.
- Na Biblioteca de Solicitação, selecione o elemento da solicitação. O cliente de serviço genérico mostra três etapas: Editar Dados, Chamar e Visualizar Resposta. Os detalhes para a solicitação são exibidos na etapa Editar Dados.
- Com base na solicitação selecionada na Etapa 2, na página Mensagem, use as visualizações Formulário, Árvore ou Origem para editar os conteúdos da solicitação. Cada visualização mostra um formato diferente dos mesmos dados. Para incluir ou remover os elementos XML na visualização Formulário ou Árvore, clique em Esquema > Validar e Assistir para compilar com um XSD especificado no catálogo do esquema.
- Na página Transporte, se necessário, altere a configuração de transporte a ser usada para a solicitação. Para criar e editar configurações de transporte e de segurança, use a guia Transporte.
- Se você selecionou a solicitação de XML de SOAP na etapa 2, na página Pilha de Solicitações,
especifique se deseja substituir os algoritmos de segurança ou de processamento que são aplicados à
solicitação realizada para o arquivo WSDL. Para incluir uma página Pilha de Respostas para editar os algoritmos de segurança ou
processamento para respostas recebidas, clique e Mostrar Pilha de Respostas.
Nota: Estas configurações se aplicam apenas à solicitação atual. Para editar a pilha de solicitações e respostas para todas as solicitações que usam o arquivo WSDL atual, clique em Editar Segurança WSDL para abrir o Editor de Segurança WSDL.
- Quando você estiver pronto, clique em Chamar para enviar a solicitação de serviço. O cliente de serviço genérico envia o pedido e exibe o retorno de mensagem na etapa Visualizar Resposta.
O que Fazer Depois
).