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 |
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 |
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:
|
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:
|
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:
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:
|
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:
|
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:
|
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:
|
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:
|
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 |