Propriedades de Tópicos de Cluster

É possível configurar propriedades para tópicos de cluster. No entanto, é possível alterar algumas propriedades apenas enquanto você está criando um novo tópico de cluster. Não é possível alterar essas propriedades uma vez que o tópico de cluster foi criado.

Para configurar um cluster padrão de gerenciadores de filas para sistemas de mensagens de publicação/assinatura, você define um ou mais objetos de tópico administrado em um gerenciador de filas no cluster. Para tornar o tópico um tópico de cluster, configure a propriedade Nome do Cluster. Ao fazer isso, qualquer tópico usado por um publicador ou assinante, a partir do ponto na árvore de tópicos, é compartilhado entre todos os gerenciadores de filas no cluster. As mensagens publicadas para uma ramificação em cluster da árvore de tópicos são automaticamente roteadas para assinaturas em outros gerenciadores de filas no cluster.

As tabelas a seguir listam todas as propriedades para tópicos de cluster do IBM® MQ. Algumas das propriedades listadas nessas tabelas só podem ser alteradas durante a criação de um novo tópico e não podem ser modificadas uma vez que o tópico de cluster do IBM MQ foi criado.

Para cada propriedade, há uma breve descrição de quando pode ser necessário configurá-la. As tabelas também fornecem o parâmetro MQSC equivalente para uso com (por exemplo) o comando DISPLAY TCLUSTER. Para obter mais informações sobre os comandos MQSC, consulte Administração usando comandos do MQSC na IBM Knowledge Center.

Gerais

A tabela a seguir lista as propriedades na página Geral do diálogo de Propriedades do tópico de cluster.
Propriedade Significado Parâmetro do MQSC
Nomes do Tópico Esse valor não pode ser alterado após a criação do tópico. Esse parâmetro é necessário e não pode conter uma cadeia vazia.

O identificador exclusivo da definição de tópico administrativo a ser criada. São permitidos no máximo 48 caracteres.

Nome não deve ser igual a nenhuma outra definição de tópico definida no gerenciador de filas selecionado.

TOPNAME
Tipo de tópico Esse valor é de leitura e exibe se o tópico é local, Local, ou de um cluster, Cluster. N/A
Sequência de Tópicos Esse valor não pode ser alterado após a criação do tópico. Esse parâmetro é necessário e não pode conter uma cadeia vazia.

O caractere / nesta sequência possui um significado especial. Ele delimita os elementos na árvore de tópicos. Uma sequência de tópicos pode começar com o caractere /, mas isso não é necessário. Uma sequência que começa com o caractere / não é igual à sequência que começa sem o caractere /.

A Sequência de Tópicos não deve ser igual a nenhuma outra sequência de tópicos já representada por uma outra definição de objeto de tópico. O comprimento máximo de uma sequência de tópicos é 10.240 caracteres.

TOPICSTR
Descrição Esse valor é uma cadeia digitada pelo administrador. Ela contém informações descritivas sobre o tópico. Além disso, deve conter apenas caracteres que possam ser exibidos. No máximo 64 caracteres.

Se forem utilizados caracteres que não estejam no CCSID (Coded Character Set Identifier) para o gerenciador de filas selecionado, eles poderão ser convertidos incorretamente se as informações forem enviadas para um outro gerenciador de filas.

DESC
Publicar Essa propriedade controla se as mensagens podem ser publicadas para o tópico. O valor padrão é Como Pai. As 2 outras opções disponíveis são:

Permitido, que significa que as mensagens podem ser publicadas para o tópico por um aplicativo autorizado.

Inibido, que significa que as mensagens não podem ser publicadas para o tópico.

PUB
Assinar Essa propriedade controla se as mensagens podem assinar para o tópico. O valor padrão é Como Pai. As 2 outras opções disponíveis são:

Permitido, que significa que as assinaturas podem ser feitas para o tópico por um aplicativo autorizado.

Inibido, que significa que os aplicativos não podem assinar para o tópico.

SUB
Assinaturas Duráveis Essa propriedade controla se o tópico permite que assinaturas duráveis sejam feitas. O valor padrão é Como Pai. As 2 outras opções disponíveis são:

Permitido, que significa que as assinaturas duráveis podem ser feitas para o tópico por um aplicativo.

Inibido, que significa que as assinaturas duráveis não podem ser feitas para o tópico por um aplicativo.

DURSUB
Prioridade padrão A prioridade padrão de mensagens publicadas para o tópico. O valor padrão é Como Pai.

A prioridade padrão pode ser configurada de 0 (a prioridade mais baixa) a 9 (a prioridade mais alta)

DEFPRTY
Persistência Padrão A persistência padrão de um novo tópico é Como Pai. Selecione Persistente para especificar que as mensagens criadas por aplicativos que utilizam MQPER_PERSISTENCE_AS_Q_DEF tornem-se persistentes. Selecione Não Persistente para especificar que as mensagens criadas por aplicativos que utilizam MQPER_PERSISTENCE_AS_Q_DEF tornem-se não persistentes. DEFPSIST
Tipo de Resposta de Envio Padrão O tipo de resposta padrão para envios de mensagens. O valor padrão é Como Pai. As 2 outras opções disponíveis são:

Síncrono, que significa que a resposta é enviada de modo síncrono.

Assíncrono, que significa que a resposta é enviada de modo assíncrono.

DEFPRESP
Entrega de Mensagem Não Persistente O método de entrega de mensagens não persistentes publicadas para esse tópico. As quatro opções são:

Como Pai O mecanismo de entrega utilizado baseia-se na configuração do primeiro nó administrativo pai localizado na árvore de tópicos com relação a esse tópico. Esse é o padrão fornecido com o IBM MQ, mas ele pode ter sido alterado por sua instalação.

Para Todos os Assinantes Disponíveis As mensagens não persistentes são entregues a todos os assinantes que podem aceitar a mensagem. A falha na entrega da mensagem a qualquer assinante não impede que outros assinantes a recebam.

Para Todos os Assinantes Duráveis As mensagens não persistentes devem ser entregues a todos os assinantes duráveis. A falha ao entregar uma mensagem não persistente a qualquer assinante não durável não retorna um erro para a chamada MQPUT. Se ocorrer uma falha na entrega a um assinante durável, nenhum outro assinante receberá a mensagem e a chamada MQPUT falhará.

Para Todos os Assinantes As mensagens não persistentes devem ser entregues a todos os assinantes, independentemente da durabilidade da chamada MQPUT para relatar sucesso. Se ocorrer uma falha na entrega para qualquer assinante, nenhum outro assinante receberá a mensagem e a chamada MQPUT falhará.

NPMSGDLV
Entrega de Mensagem Persistente O método de entrega de mensagens persistentes publicadas para esse tópico. As quatro opções são:

Como Pai O mecanismo de entrega utilizado baseia-se na configuração do primeiro nó administrativo pai localizado na árvore de tópicos com relação a esse tópico. Esse é o padrão fornecido com o IBM MQ, mas ele pode ter sido alterado por sua instalação.

Para Todos os Assinantes Disponíveis As mensagens persistentes são entregues a todos os assinantes que podem aceitar a mensagem. A falha na entrega da mensagem a qualquer assinante não impede que outros assinantes a recebam.

Para Todos os Assinantes Duráveis As mensagens persistentes devem ser entregues a todos os assinantes duráveis. A falha ao entregar uma mensagem persistente a qualquer assinante não durável não retorna um erro para a chamada MQPUT. Se ocorrer uma falha na entrega a um assinante durável, nenhum outro assinante receberá a mensagem e a chamada MQPUT falhará.

Para Todos os Assinantes As mensagens persistentes devem ser entregues a todos os assinantes, independentemente da durabilidade da chamada MQPUT para relatar sucesso. Se ocorrer uma falha na entrega para qualquer assinante, nenhum outro assinante receberá a mensagem e a chamada MQPUT falhará.

PMSGDLV
Operação de Curinga Esse valor controla o comportamento de assinaturas de curingas com relação ao tópico. Os dois valores são:

Bloquear. Assinaturas feitas para um tópico curinga menos específico do que a sequência de tópicos para esse objeto do tópico não receberão publicações feitas para esse tópico ou para sequências de tópicos mais específicas que esse tópico.

Passar. As assinaturas feitas em um tópico curinga, menos específico que a sequência de tópicos para esse objeto de tópico, receberão publicações feitas para esse tópico e para sequências de tópicos mais específicas que esse tópico. Esse é o valor padrão.
CURINGA

Publicação/Assinatura Distribuídas

A tabela a seguir lista as propriedades na página Publicação/Assinatura distribuídas do diálogo de Propriedades do tópico de cluster.
Propriedade Significado Parâmetro do MQSC
Comportamento de Assinaturas de Proxy As assinaturas de proxy são associadas ao nome do gerenciador de filas que as criou. As publicações apenas serão redirecionadas para gerenciadores de filas diretamente conectados se existir uma assinatura de proxy que inclua o tópico de publicação. As duas opções para esse valor são:

Forçar. Isso força o envio de uma assinatura de proxy curinga para a sequência de tópicos associada a este objeto do tópico, de cada gerenciador de filas no cluster para cada outro gerenciador de filas na topologia de publicação/assinatura, independentemente de terem sido feitas assinaturas locais. Após a propagação dessa assinatura de proxy forçada para toda a topologia, todas as novas assinaturas receberão imediatamente quaisquer publicações do outro gerenciador de filas conectado sem sofrer latência, embora todas as publicações sejam propagadas para todos os outros gerenciadores de filas no cluster, independentemente de terem ou não sido solicitadas por uma assinatura.

Configurando esse valor em um determinado nível na árvore de tópicos também evita que assinaturas de proxy sejam geradas para sequências de tópicos individuais em níveis subsequentes na árvore de tópicos, reduzindo a sobrecarga de assinatura de proxy.

Primeiro Uso. Como as diversas topologias dos gerenciadores de filas de publicação/assinatura possuem uma natureza interconectada, pode haver um pequeno atraso na propagação da assinatura de proxy dependendo da complexidade da topologia. Isso significa que assim que uma assinatura for feita, as publicações remotas não serão necessariamente recebidas de imediato.

PROXYSUB
Escopo da publicação
O escopo de publicações pode ser controlado administrativamente utilizando o atributo de tópico PUBSCOPE. O atributo pode ser configurado como um dos três valores a seguir:
  • Como pai. Esse é o valor padrão. O escopo da publicação é definido com o mesmo valor do gerenciador de filas pai.
  • Gerenciador de filas. A publicação é entregue apenas aos assinantes locais.
  • Tudo. A publicação é entregue aos assinantes locais e remotos por meio de gerenciadores de filas conectados diretamente.
PUBSCOPE
Escopo da assinatura
O escopo de assinaturas pode ser controlado administrativamente utilizando o atributo de tópico SUBSCOPE. O atributo pode ser configurado como um dos três valores a seguir:
  • Como pai. Esse é o valor padrão. O escopo da assinatura é definido com o mesmo valor do gerenciador de filas pai.
  • Gerenciador de filas. A assinatura recebe apenas publicações locais e as assinaturas de proxy não são propagadas para gerenciadores de filas remotas.
  • Tudo. Uma assinatura de proxy é propagada para gerenciadores de filas remotas e o assinante recebe publicações locais e remotas.
SUBSCOPE

Cluster

A tabela a seguir lista as propriedades na página Cluster do diálogo de Propriedades do tópico de cluster.
Propriedade Significado Parâmetro do MQSC
Nome do Cluster Para fazer um tópico um tópico de cluster, você configura esta propriedade. Ao fazer isso, qualquer tópico usado por um publicador ou assinante naquele ponto ou na árvore de tópicos é compartilhado entre todos os gerenciadores de filas no cluster e as mensagens publicadas em uma ramificação em cluster da árvore de tópicos são automaticamente roteadas para assinaturas em outros gerenciadores de filas no cluster. CLUSTER
Estado do objeto do cluster
O estado atual deste objeto do tópico neste cluster. Os valores podem ser os seguintes:
ACTIVE
O tópico de cluster está configurado corretamente e está sendo cumprido por esse gerenciador de filas.
PENDING
Visto somente por um gerenciador de filas de hosting, esse estado é relatado quando o tópico tiver sido criado, mas o repositório completo ainda não o tiver propagado para o cluster. Isso pode ser porque o gerenciador de filas do host não está conectado a um repositório completo, ou porque o repositório completo foi considerado o tópico a ser inválido.
INVALID
Esta definição de tópico de cluster entra em conflito com uma definição anterior no cluster e, portanto, não está ativa atualmente.
ERROR
Ocorreu um erro com relação a este objeto do tópico.
Este parâmetro é normalmente usado para ajudar no diagnóstico quando várias definições do mesmo tópico de cluster estão definidas em gerenciadores de filas diferentes, e as definições não são idênticas.
CLSTATE
Gerenciador de filas do cluster Esse é o nome do gerenciador de filas no cluster proprietário do tópico em cluster. N/A
Rota do cluster
O comportamento de roteamento a usar para tópicos no cluster definido pelo parâmetro CLUSTER. Existem dois valores possíveis:
DIRECT
Ao configurar um tópico de cluster roteado diretamente em um gerenciador de filas, todos os gerenciadores de filas no cluster ficam cientes de todos os outros gerenciadores de filas no cluster. Ao executar operações de publicação e assinatura, cada gerenciador de filas se conecta diretamente a todos os outros.
TOPICHOST
Ao usar roteamento de host de tópico, todos os gerenciadores de filas no cluster ficam cientes dos gerenciadores de filas do cluster que hospedam as definições de tópico roteadas. Ao executar operações de publicação e assinatura, os gerenciadores de filas no cluster se conectam apenas a estes gerenciadores de filas do host de tópico, e não diretamente uns aos outros. Os gerenciadores de filas do host de tópico são responsáveis pelas publicações de roteamento a partir de gerenciadores de filas em que as publicações são publicadas para gerenciadores de filas com assinaturas correspondentes.
CLROUTE
QMID O nome exclusivo gerado internamente do gerenciador de filas do cluster. Para evitar qualquer ambiguidade, é preferível usar o QMID (Queue Manager Identifier) em vez de QMNAME. QMID

Estatísticas

A tabela a seguir lista as propriedades na página Estatísticas do diálogo de Propriedades do tópico de cluster.
Propriedade Significado Parâmetro do MQSC
Data da mudança Esse valor não pode ser alterado, ele é fornecido apenas com propósitos informativos.

Essa é a data na qual as propriedades do tópico foram alteradas pela última vez.

MQCA_ALTERATION_DATE
Hora da mudança Esse valor não pode ser alterado, ele é fornecido apenas com propósitos informativos.

Esse é o horário no qual as propriedades do tópico foram alteradas pela última vez.

MQCA_ALTERATION_TIME