Formatos de mensagem

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

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

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

No entanto, aplicativos clientes que precisem comunicar-se entre si utilizando o Publicação/Assinatura poderão fazê-lo, não importa qual seja o formato de mensagens utilizado. WebSphere Business Integration Event 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 Business Integration Event 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 MQSeries 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

Deregister Subscriber

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

Register Subscriber

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

Notes:
  1. Esta opção é suportada por motivos de migração.
  2. MQPS é MQSeries 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 MQSeries 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 Business Integration Event Broker.