Formatos de mensagem

Aplicativos cliente desenvolvidos para WebSphere Message Broker devem utilizar o cabeçalho de mensagens MQRFH2. Esses aplicativos então poderão utilizar todas as funções fornecidas por WebSphere Message Broker.

Aplicativos existentes do WebSphere MQ Publicação/Assinatura que utilizam o cabeçalho de mensagens MQRFH também são suportados pelo WebSphere Message Broker, mas a função está limitada àquela fornecida pelo WebSphere MQ Publicação/Assinatura.

O WebSphere MQ Publicação/Assinatura não suporta o formato MQRFH2. Cliente que estão conectados aos intermediários do WebSphere MQ Publicação/Assinatura devem utilizar o formato MQRFH.

Entretanto, os aplicativos clientes que precisam comunicar-se entre si utilizando Publicação/Assinatura podem fazer isso independentemente do formato da mensagem utilizado. O WebSphere Message Broker fornece conversão automática para assegurar que um assinante receba mensagens no formato correto.

A tabela a seguir mostra o mapeamento entre campos equivalentes nos cabeçalhos de mensagem MQRFH e MQRFH2:

Nome do Campo MQRFH Nome do Campo MQRFH2
MQPSCommand Command
MQPSDelOpts DelOpt
MQPSPubOpts PubOpt
MQPSPubTime PubTime
MQPSQMgrName QMgrName
MQPSQName QName
MQPSRegOpts RegOpt
MQPSSeqNum SeqNum
MQPSTopic Tópico

Todos os campos MQRFH2 que são mostrados na tabela estão contidos em uma pasta <psc>.

Nomes de campos que não são mostrados na tabela não têm um significado comum, ou são válidos somente em um dos dois formatos de cabeçalho. Nomes de campos que não são reconhecidos ou não são adequados para outro formato não são copiados. Por exemplo, a seguinte área de nome-valor de um MQRFH:
MQPSCommand Publish
MQPSPubOpts RetainPub
MQPSStreamName SAMPLE.BROKER.RESULTS.STREAM
MQPSTopic "Sport/Soccer/State/LatestScore/Team1 Team2"
é convertida para esta pasta MQRFH2:
<psc>
<Command>Publish</Command>
<PubOpt>RetainPub</PubOpt>
<Topic>Sport/Soccer/State/LatestScore/Team1 Team2</Topic>
</psc>

Utilizando essas regras de mapeamento, o WebSphere Message Broker assegura que as publicações do MQRFH2 ainda possam ser recebidas por assinantes do MQRFH, e que publicações do MQRFH possam ser recebidas por assinantes do MQRFH2.

Filtros de conteúdo podem ser especificados por assinantes do MQRFH2 mesmo se o tópico que estão assinando está sendo publicado no formato MQRFH por um cliente WebSphere MQ Publicação/Assinatura, embora exista uma certa limitação quanto à compatibilidade. Essas limitações são descritas posteriormente neste tópico.

A tabela a seguir resume as opções válidas para clientes que utilizam os diferentes formatos de mensagem.

Mensagem

Nome da Opção

Valor da Opção

Suporte

Todos os pedidos
(cliente para intermediário)

MQPSCommand

DeletePub
DeregPub
DeregSub
PublishRegPub
RegSub
ReqUpdate

yesyes1
yesyesyes1
yesyes

MQMD.Format

MQFMT_PCF
MQFMT_RF_HEADER

não
yes

MQMD.Report

MQRO_PAN
MQRO_NAN

yesyes

MQMD.MsgType

MQMT_REQUEST
MQMT_DATAGRAM

yesyes

MQMD.MsgId

 

yes

MQMD.CorrelId

 

yes4

MQMD.ReplyToQ

 

yes

MQMD.ReplyToQMgr

 

yes

MQPSStreamName

 

colocado como prefixo em topic3

MQPSTopic

 

yes

Todos os pedidos exceto
Delete Publication

MQPSQMgrName

 

yes

MQPSQName

 

yes

MQPSRegOpts

CorrelAsId

yes

Delete Publication

MQPSDelOpts

Local

yes5

Deregister Publisher1

MQPSRegOpts

DeregAll

yes

Cancelar Registro de Assinante

MQPSRegOpts

DeregAll

yes

Publish

Campos do MQMD

Conforme especificado pelo MQPS2

yes

MQPSRegOpts

Anon

yes7

Local

yes5

DirectReq

yes1

MQPSPubOpts

NoReg

yes1

RetainPub

yes (set by publisher)

IsRetainedPub

yes (set by broker)

OtherSubsOnly

yes

MQPSPubTime

 

yes

MQPSSeqNum

 

yes

MQPSStringData1

 

yes

MQPSIntData1

 

yes

Register Publisher1

MQPSRegOpts

Anon

yes7

Local

yes5

DirectReq

yes1

Registrar Assinante

MQPSRegOpts

Anon

yes7

Local

yes5

NewPubsOnly

yes

PubOnReqOnly

yes

InclStreamName

no3

InformIfRet

yes

Todas as respostas
(intermediário para cliente)

MQPSCompCode

 

novos valores adicionados6

MQPSReason

 

novos valores adicionados6

MQPSReasonText

 

novos valores adicionados6

MQPSCommand

 

comando para qual isto é uma
resposta

Notas:
  1. Esta opção é suportada por motivos de migração.
  2. MQPS é WebSphere MQ Publicação/Assinatura.
  3. O parâmetro de nome de fluxo é efetivamente pré-fixado no tópico. O nome do fluxo pode ser deduzido do nome da fila se a propriedade implicitStreamNaming do nó de Publicação estiver definida.
  4. A identidade do cliente é determinada como a concatenação do nome do gerenciador de fila, o nome da fila e, opcionalmente, o id de correlação (quando o ID de correlação for definido como identidade de opção). O identificador do aplicativo é deste modo "MQPSQMgrName:MQPSQName[:correlId]". Os valores padrão especificados por WebSphere MQ Publicação/Assinatura são utilizados caso esses valores não estejam presentes em uma mensagem.
  5. O comportamento desta opção difere.
  6. Novos valores foram incluídos
  7. Ignorado por WebSphere Message Broker.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
aq19780_