Propriedades do Tópico

Um tópico do IBM® MQ é um objeto do IBM MQ que identifica o assunto tratado por uma publicação. É possível configurar propriedades para tópicos. Algumas propriedades do tópico são específicas para tópicos do z/OS . Além disso, há algumas propriedades que podem ser alteradas apenas enquanto você está criando um tópico. Não é possível modificar essas propriedades após a criação do tópico do IBM MQ.

As tabelas a seguir listam todas as propriedades para os tópicos do IBM MQ.

Para cada propriedade, há uma descrição resumida de quando pode ser necessário configurá-la. As tabelas também fornecem os parâmetros MQSC equivalentes para os comandos DEFINE, ALTER e DISPLAY TOPIC. 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 Tópicos de propriedades do IBM MQ.
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 do Tópico 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 Esse valor define se o tópico é local; Local, ou em 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 pelos aplicativos que usam MQPER_PERSISTENCE_AS_Q_DEF se tornem não persistentes. DEFPSIST
Fila Modelo Durável

Esse valor é uma cadeia digitada pelo administrador. Ele contém o nome da fila modelo usada para assinaturas duráveis que solicitam que o gerenciador de filas gerencie o destino das suas publicações.

São permitidos no máximo 48 caracteres para o nome.

Se esse campo ficar em branco, ele será considerado Como Pai

Se estiver especificando uma fila modelo para um tópico de cluster, você deve assegurar que a fila é definida em cada gerenciador de filas no cluster no qual possa ser feita uma assinatura durável usando este tópico.

A fila dinâmica criada a partir deste modelo tem um prefixo de SYSTEM.MANAGED.DURABLE

MDURMDL
Fila Modelo Não Durável Esse valor é uma cadeia digitada pelo administrador. Ele contém o nome da fila modelo usada para assinaturas não duráveis que solicitam que o gerenciador de filas gerencie o destino das suas publicações.

São permitidos no máximo 48 caracteres para o nome.

Se esse campo ficar em branco, ele será considerado Como Pai

Se estiver especificando uma fila modelo para um tópico de cluster, você deve assegurar que a fila é definida em cada gerenciador de filas no cluster no qual possa ser feita uma assinatura não durável usando este tópico.

A fila dinâmica criada a partir deste modelo tem um prefixo de SYSTEM.MANAGED.NDURABLE

MNDURMDL
Disposição de QSG A disposição do grupo de filas compartilhadas do tópico. É possível configurar a disposição do grupo de filas compartilhadas para um de três valores:
  • Gerenciador de Filas significa que a definição de objeto está disponível apenas para o gerenciador de filas que o hospeda.
  • Grupo significa que a definição de objeto é armazenada no repositório compartilhado e cada gerenciador de filas no grupo de filas compartilhadas possui uma cópia da definição.
  • Cópia significa que a definição de objeto é a cópia do gerenciador de filas de uma definição no repositório compartilhado.
O campo é exibido como somente leitura durante a exibição das propriedades de um tópico.
QSGDISP
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. As assinaturas feitas em um tópico curinga, menos específico que a sequência de tópicos para esse objeto de tópico, não recebem 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, recebem 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
Usar fila de devoluções Especifica se a fila de devoluções é usada quando as mensagens de publicação não podem ser entregues para sua fila de assinantes correta. Existem três valores possíveis:
  • Não significa que as mensagens de publicação que não podem ser entregues para sua fila de assinantes correta são tratadas como uma falha para colocar a mensagem e que o MQPUT do aplicativo para um tópico falha de acordo com a configuração de Entrega de mensagem não persistente e Entrega de mensagem persistente.
  • Sim significa que, se a propriedade Dead-letter queue do gerenciador de filas fornecer o nome de uma Fila de mensagens não entregues, ela será usada. Caso contrário, o comportamento será o mesmo de Não.
  • Como pai significa que a decisão para usar a Fila de Devoluções é baseada na configuração do objeto do tópico administrativo mais próximo na árvore de tópicos. Esse é o padrão fornecido com o IBM MQ, mas ele pode ter sido alterado por sua instalação.
USEDLQ
Customizada O parâmetro Custom é incluído apenas para o uso do IBM, reservado para a configuração de novos recursos antes de propriedades separadas terem sido introduzidas. Os valores possíveis são uma lista de zero ou mais pares de valor de propriedades, em sintaxe de estilo do MQSC, separados por pelo menos um espaço.
Os nomes e os valores da propriedade fazem distinção entre maiúsculas e minúsculas e devem ser especificados em maiúsculas. Os valores podem conter espaços, parênteses e aspas simples (que devem ser escapadas com outras aspas simples). Outros caracteres, incluindo parênteses aninhados (), podem ser incluídos envolvendo-os em duas aspas simples em qualquer lado. Exemplos de sintaxe válida são:
  • CUSTOM(' ')
  • CUSTOM('A(B)')
  • CUSTOM('C(D) E(F)')
  • CUSTOM('G(5000) H(''9.20.4.6(1415)'')')

O gerenciador de filas analisará o valor, mas se a sequência não puder ser analisada de acordo com essas regras ou se contiver propriedades ou valores não reconhecidos, o gerenciador de filas ignorará os erros.

CUSTOM

Publicação/Assinatura Distribuídas

A tabela a seguir lista as propriedades na página Publicação/assinaturas distribuídas do diálogo Tópico de propriedades do IBM MQ.
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. Para cada sequência de tópicos exclusiva em ou abaixo desse objeto de tópico, uma assinatura de proxy é enviada assincronamente para todos os gerenciadores de filas vizinhos nos seguintes cenários:
  • Quando uma assinatura local é criada.
  • Quando uma assinatura de proxy que deve ser propagada é recebida para gerenciadores de filas conectados mais diretamente.
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
Multicast Essa propriedade controla se o tópico é considerado como transmissível com multicast ou não. Há quatro valores possíveis:

Como pai. A propriedade multicast do tópico é herdada do pai.

Desativado. Nenhum tráfego de multicast é permitido nesse nó.

Ativado. O tráfego de multicast é permitido nesse nó.

Apenas. Apenas assinaturas de um cliente apto a multicast são permitidas.

MCAST
Informações de comunicação O nome do objeto de informações de comunicação. Como há mais de um tópico na árvore que requer as mesmas propriedades de transmissão multicast, considere ter essas propriedades em um objeto separado que possa ser referenciado. COMMINFO

Cluster

A tabela a seguir lista as propriedades na página Cluster do diálogo Tópico de propriedades do IBM MQ.
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
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

Estatísticas

A tabela a seguir lista as propriedades na página Estatísticas do diálogo Tópico de propriedades do IBM MQ.
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.

ALTDATE
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.

ALTTIME