Mensagem Delete Publication

A mensagem de comando Delete Publication é enviada a um intermediário de um publicador, ou de outro intermediário, para dizer ao intermediário para excluir quaisquer publicações retidas para os tópicos especificados.

Essa mensagem é enviada à fila de entrada de um fluxo de mensagens que contém um nó Publication. É necessário possuir autoridade para colocar uma mensagem nesta fila e para publicar sobre o tópico ou tópicos especificados na mensagem.

A fila de entrada deve ser a fila para a qual a publicação original foi enviada.

Se possuir autoridade para alguns, mas não para todos os tópicos que são especificados na mensagem de comando Delete Publication, somente aqueles tópicos serão excluídos. Uma mensagem Broker Response indica quais tópicos não foram excluídos.

De forma semelhante, se um comando Publish contiver mais de um tópico, um comando Delete Publication que corresponda a alguns desses tópicos, mas não a todos eles, excluirá somente as publicações para os tópicos que são especificados no comando Delete Publication.

Consulte Definições de MQMD em Mensagens de Comando para o Intermediário para obter detalhes sobre os parâmetros do descritor de mensagem (MQMD) que são necessários ao enviar uma mensagem de comando ao intermediário.

Propriedades

<Comando> (MQPSC_COMMAND)
O valor é DeletePub(MQPSC_DELETE_PUBLICATION).

Essa propriedade precisa ser especificada.

<Tópico> (MQPSC_TOPIC)
O valor é uma cadeia que contém um tópico para o qual as publicações retidas devem ser excluídas. Caracteres curinga podem ser incluídos na cadeia para excluir publicações em mais de um tópico.

Essa propriedade precisa ser especificada; ela pode ser repetida para tantos tópicos quanto necessário.

<DelOpt> (MQPSC_DELETE_OPTION)
A propriedade delete options pode ter um dos seguintes valores:
Local (MQPSC_LOCAL)  

Todas as publicações retidas para os tópicos especificados são excluídas no intermediário local (ou seja, aquele ao qual essa mensagem é enviada), tenham elas sido ou não publicadas com a opção Local.

As publicações em outros intermediários não são afetadas.

Nenhum (MQPSC_NONE)  

Todas as opções assumem seus valores padrão. Isso tem o mesmo efeito que omitir a propriedade DelOpt. Se outras opções forem especificadas ao mesmo tempo, Nenhuma será ignorada.

O padrão se esta propriedade for omitida é que todas as publicações retidas para os tópicos especificados são excluídas em todos os intermediários na rede, independente de elas terem sido publicadas com a opção Local.

Exemplo

Exemplo de NameValueData para uma mensagem de comando Delete Publication. É utilizada pelo aplicativo de amostra para excluir, no intermediário local, a publicação retida que contém o último placar no jogo entre Team1 e Team2.
 <psc>
    <Command>DeletePub</Command>
  <Topic>Sport/Soccer/State/LatestScore/Team1 Team2</Topic>
    <DelOpt>Local</DelOpt>
 </psc>
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
aq06960_