Utilize o nó MQHeader para incluir, modificar ou excluir cabeçalhos MQMD (MQ Message Descriptor) e MQDLH (MQ Dead Letter Header).
Este tópico contém as seguintes seções:
O nó MQHeader está contido no repositório da paleta do WebSphere MQ e é representado no WebSphere® Message Broker Toolkit pelo seguinte ícone:
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.
Os terminais do nó MQHeader são descritos na tabela a seguir:
Terminal | Descrição |
---|---|
In | O terminal de entrada que aceita a mensagem para processamento pelo nó. |
Failure | O terminal de saída para o qual a mensagem de entrada é roteada se for detectada uma falha. |
Saída | O terminal de saída para o qual a mensagem transformada será roteada se a mensagem de entrada for processada com êxito. |
As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).
Propriedade | M | P | Padrão | Descrição |
---|---|---|---|---|
Nome do Nó | Não | Não | MQHeader | O nome do nó. |
Short description | 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 | Padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Opções de Cabeçalho MQMD | Não | Não | Transferir cabeçalho | Opções para controlar o MQMD como um todo. Selecione Transportar Cabeçalho para transportar valores que estão presentes em uma mensagem que chega. Selecione Incluir Cabeçalho para incluir um novo cabeçalho utilizando os valores da propriedade especificados. Se já existir um cabeçalho, ele será modificado utilizando os valores da propriedade especificados. Se Herdar do Cabeçalho for especificado como um valor da propriedade e o cabeçalho não existir, será utilizado o valor padrão para a propriedade. Selecione Modificar Cabeçalho para alterar um cabeçalho existente utilizando os valores da propriedade especificados. Se um cabeçalho não existir, um novo cabeçalho será incluído primeiro. Se Herdar do Cabeçalho for especificado como um valor da propriedade e o cabeçalho não existir, será utilizado o valor padrão para a propriedade. Selecione Excluir Cabeçalho para excluir o cabeçalho, se ele existir. Note: As opções Incluir
Cabeçalho e Modificar Cabeçalho incluem um cabeçalho,
se ele não existir, e altera um cabeçalho, se ele existir.
No entanto, os valores padrão
oferecidos por cada opção se diferem, portanto, utilize a opção apropriada.
|
|
Identificador do Conjunto de Caracteres Codificados | Não | Não | MQCCSI_Q_MGR | O identificador do conjunto de caracteres de dados de caractere na mensagem. Um conjunto de amostra de literais customizados para EBCIDIC e outros valores Unicode
comuns é fornecido a seguir: MQCCSI_INTL_EBCIDIC : 500 |
|
Format | Não | Não | MQFMT_NONE | Um nome que o remetente da mensagem pode utilizar para indicar ao receptor a natureza dos dados na mensagem. | |
Número da Versão | Não | Não | MQMD_VERSION_1 | O ID da versão da mensagem MQMD. | |
Tipo de Mensagem | Não | Não | MQMT_DATAGRAM | O tipo de mensagem. | |
Expiração da Mensagem | Não | Não | MQEI_UNLIMITED | Um período de tempo expresso em décimos de segundo, configurado pelo aplicativo que coloca a mensagem. A mensagem se torna elegível para ser descartada, se não tiver sido removida da fila de destino antes de decorrer este período de tempo. | |
Feedback ou Código de Razão | Não | Não | MQFB_NONE | Utilizada com uma mensagem de tipo MQMT_REPORT para indicar a natureza do relatório, e significativa apenas com esse tipo de mensagem. | |
Prioridade de Mensagem | Não | Não | MQPRI_PRIORITY_AS_Q_DEF | Prioridade de mensagem. 0 é o menor valor e 9 é o maior. Os literais de exibição customizados são os seguintes: MQPRI_PRIORITY_HIGH : 9 |
|
Persistência de Mensagem | Não | Não | MQPER_PERSISTENCE_AS_Q_DEF | Indica se a mensagem permanece após falhas do sistema e reinícios do gerenciador de filas. | |
Identificador de Mensagens | Não | Não | MQMI_NONE | Uma cadeia utilizada para distinguir uma mensagem de outra. | |
Identificador de Correlação | Não | Não | MQCI_NONE | Uma cadeia que o aplicativo pode utilizar para relacionar uma mensagem a outra, ou para relacionar uma mensagem a outro trabalho que o aplicativo está desempenhando. | |
Responder para a Fila | Não | Sim | <Nenhum Valor Padrão> | A fila de mensagens para a qual o aplicativo que emitiu o pedido de obtenção para a mensagem deve enviar mensagens de Resposta e Relatório. | mqmdReplyToQ |
Responder para o Gerenciador de Filas | Não | Sim | <Nenhum Valor Padrão> | O gerenciador de filas para o qual a mensagem de resposta ou de relatório deve ser enviada. | mqmdReplyToQMgr |
Propriedade | M | P | Padrão | Descrição |
---|---|---|---|---|
Herdar do Cabeçalho | Não | Não | Selecionado | Esta propriedade é ativada apenas quando a opção Modificar Cabeçalho é selecionada. Selecione este campo para herdar qualquer valor da propriedade de relatório MQMD que esteja presente em uma mensagem que chega. |
Exceção | Não | Não | Nenhum valor padrão | Um tipo de mensagem de relatório do MQ. É gerada uma mensagem de relatório de exceção. |
Expiração | Não | Não | Nenhum valor padrão | Um tipo de mensagem de relatório do MQ. É gerada uma mensagem de relatório de expiração. |
Confirmar chegada | Não | Não | Nenhum valor padrão | Um tipo de mensagem de relatório do MQ. É gerada uma mensagem de relatório confirmar chegada. |
Confirmar entrega | Não | Não | Nenhum valor padrão | Um tipo de mensagem de relatório do MQ. É gerada uma mensagem de relatório confirmar entrega. |
Notificação | Não | Não | Nenhum valor padrão | Um tipo de Mensagem de relatório do MQ. É gerada uma mensagem de relatório de notificação de ação. |
Propriedade | M | P | Padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Opções de Cabeçalho MQDLH | Não | Não | Transportar o cabeçalho | Opções para controlar o MQMD como um todo. Selecione Transportar Cabeçalho para transportar valores que estão presentes em uma mensagem que chega. Selecione Incluir Cabeçalho para incluir um novo cabeçalho utilizando os valores da propriedade especificados. Se já existir um cabeçalho, ele será modificado utilizando os valores da propriedade especificados. Se Herdar do Cabeçalho for especificado como um valor da propriedade e o cabeçalho não existir, será utilizado o valor padrão para a propriedade. Selecione Modificar Cabeçalho para alterar um cabeçalho existente utilizando os valores da propriedade especificados. Se um cabeçalho não existir, um novo cabeçalho será incluído primeiro. Se Herdar do Cabeçalho for especificado como um valor da propriedade e o cabeçalho não existir, será utilizado o valor padrão para a propriedade. Selecione Excluir Cabeçalho para excluir o cabeçalho, se ele existir. Note: As opções Incluir
Cabeçalho e Modificar Cabeçalho incluem um cabeçalho,
se ele não existir, e altera um cabeçalho, se ele existir. No entanto, os valores padrão
oferecidos por cada opção se diferem, portanto, utilize a opção apropriada.
|
|
Identificador do Conjunto de Caracteres Codificados | Não | Não | MQCCSI_UNDEFINED | O identificador do conjunto de caracteres de dados de caractere na mensagem. | |
Format | Não | Não | MQFMT_NONE | Um nome que o remetente da mensagem pode utilizar para indicar ao receptor a natureza dos dados na mensagem. | |
Razão | Não | Não | MQRC_NONE | Um código que indica por que a mensagem foi enviada para a DLQ (Fila de Devoluções). | |
Nome da Fila de Destino | Não | Sim | Nenhum valor padrão | O nome da fila de destino. | mqdlhDestQName |
Nome do Gerenciador de Filas de Destino | Não | Sim | Nenhum valor padrão | O nome do gerenciador de filas de destino. | mqdlhDestQMgrName |
Salvar Fila de Devoluções | Não | Não | Selecionado | Se selecionado, o nome da fila de devoluções será armazenado no ambiente local. | |
Salvar Fila de Origem | Não | Não | Selecionado | Se selecionado, o nome da fila de origem original será armazenado no ambiente local. |
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. |