Propriedades do Tópico

Um tópico IBM® MQ é um objeto IBM MQ que identifica o que é uma publicação. É possível configurar propriedades para tópicos. Algumas propriedades de tópico são específicas para z/OS® tópicos. Há algumas propriedades que podem ser alteradas somente quando você estiver criando um tópico. Não é possível modificar essas propriedades depois que o tópico IBM MQ tiver sido criado.

As tabelas a seguir listam todas as propriedades para IBM MQ Topics.

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 comandos MQSC, consulte Administrando IBM MQ usando comandos MQSC em IBM Documentation.

Geral

A tabela a seguir lista as propriedades na página Geral do diálogo IBM MQ Propriedades do tópico.
Propriedade Significado Parâmetro do MQSC
Nome 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 Este valor define se o tópico é local; Local, ou em um cluster; Cluster. N/D
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 durável de modelos

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 não-durável de modelos 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 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 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. Este é o padrão fornecido com IBM MQ, mas sua instalação pode tê-lo alterado.

Para Todos os Assinantes Disponíveis As mensagens não persistentes são entregues a todos os assinantes que podem aceitar a mensagem. O fato de a mensagem não ser entregue a um 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 na entrega de 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 para um assinante durável, nenhum outro assinante receberá a mensagem e as chamadas MQPUT falharão.

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 persistente de mensagens

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. Este é o padrão fornecido com IBM MQ, mas sua instalação pode tê-lo alterado.

Para Todos os Assinantes Disponíveis As mensagens persistentes são entregues a todos os assinantes que podem aceitar a mensagem. O fato de a mensagem não ser entregue a um 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 na entrega de 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 para um assinante durável, nenhum outro assinante receberá a mensagem e as chamadas MQPUT falharão.

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 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 à sua correta fila de assinantes são tratadas como uma falha para colocar a mensagem, e o utilitário da requisida para um tópico falha de acordo com as configurações de Entrega de mensagem não persistente e Entrega de mensagem persistente.
  • Sim significa que se a propriedade gerenciador de filas Dead-letter fila fornece o nome de uma Fila de Letras Mortas, então ela é 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. Este é o padrão fornecido com IBM MQ mas sua instalação pode tê-lo alterado.
USEDLQ
Customizado O parâmetro Custom é incluído para o uso IBM apenas, 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
[MQ 9.4.0 Jun 2024]Cap caducidade O tempo máximo, expresso em décimos de segundo, até que uma mensagem publicada a um tópico que herda propriedades deste objeto, permaneça no sistema até que se torne elegível para o processamento de caducidade.
Para obter mais informações sobre o processamento de expiração de mensagens, consulte CAPEXPRY: Limitar o tempo de expiração da mensagem em IBM Documentation.
Número inteiro
O valor deve estar na faixa um até 999999999.
NOLIMIT
Não há limite no tempo de validade das mensagens colocadas neste tópico.
ASPARENT
O tempo máximo de validade da mensagem é baseado na configuração do objeto do tópico administrativo pai mais próximo na árvore de tópicos. Esse é o valor-padrão.
CAPEXPRY

Publicação/Assinatura Distribuídas

A tabela a seguir lista as propriedades na página Publicação/assinatura distribuída do diálogo IBM MQ Propriedades do tópico.
Propriedade Significado Parâmetro do MQSC
Comportamento da assinatura do 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.
  • Todos. 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 fila remotos.
  • Todos. Uma assinatura de proxy é propagada para gerenciadores de fila remotos, 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ó.

Somente. 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 relaciona as propriedades na página Cluster do diálogo IBM MQ Propriedades do Tópico.
Propriedade Significado Parâmetro do MQSC
Nome do cluster Para fazer de 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:
Ativo
O tópico de cluster está configurado corretamente e está sendo cumprido por esse gerenciador de filas.
Pendente
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.
INVÁLIDO
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:
Direto
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 relaciona as propriedades na página Estatísticas do diálogo IBM MQ Propriedades do Tópico.
Propriedade Significado Parâmetro do MQSC
Data da alteração 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 alteração 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