Propriedades de Assinatura do IBM MQ

É possível configurar atributos para todos os tipos de assinaturas. Alguns dos atributos não se aplicam a todos os tipos de assinaturas, alguns atributos são específicos a assinaturas do z/OS.

As tabelas a seguir listam todos os atributos que podem ser configurados:

Para cada atributo, existe uma breve descrição de quando você pode precisar configurar o atributo. As tabelas também fornecem os parâmetros MQSC equivalentes. Para obter mais informações sobre comandos MQSC, veja Comandos do Script (MQSC) na documentação on-line do produto IBM® MQ.

Página Geral

A tabela a seguir lista os atributos que podem ser configurados na página Geral do diálogo Propriedades da Assinatura.

Atributo Significado Parâmetro do MQSC
Nome da assinatura Somente leitura. Você não pode alterar o nome da assinatura depois que ela for criada. SUBNAME
Nome do Tópico O nome do objeto de tópico utilizado pela assinatura. O nome do tópico fornece uma raiz de tópico adicional. São permitidos no máximo 48 caracteres. TOPICOBJ
Sequência de Tópicos Especifica um nome completo de tópico ou um conjunto de tópicos curinga para a assinatura.

O caractere barra (/) nessa sequência possui significado especial. Ele delimita os elementos na árvore de tópicos. Uma sequência de tópicos pode iniciar com um caractere barra (/), mas isso não é necessário. Uma sequência que inicia com o caractere barra (/) não é igual à sequência que inicia sem esse caractere.

TOPICSTR
Uso do curinga O esquema é utilizado para interpretar quaisquer caracteres curingas contidos na Sequência de Tópicos. Os dois valores são:

TÓPICO: Os caracteres curinga representam partes da hierarquia de tópicos.

CARACTERE: Os caracteres curinga representam partes de cadeias.

WSCHEMA
Escopo O escopo determina se esta assinatura será encaminhada para outros gerenciadores de filas, para que o assinante receba mensagens publicadas nesses outros gerenciadores de filas. Os dois valores são:
ALL
A assinatura é encaminhada para todos os gerenciadores de filas diretamente conectados por meio de um conjunto ou hierarquia de publicação/assinatura.
QMGR
A assinatura encaminhará mensagens publicadas no tópico somente neste gerenciador de filas.
Nota: Assinantes individuais podem somente restringir SUBSCOPE. Se o parâmetro estiver configurado como ALL no nível de tópico, um assinante individual poderá restringi-lo para QMGR para essa assinatura. No entanto, se o parâmetro estiver configurado como QMGR no nível de tópico, a configuração de um assinante individual como ALL não terá efeito.
SUBSCOPE
Classe de Destino A Classe de Destino especifica se o destino utilizado pela assinatura é um destino gerenciado. Os dois valores são:

MANAGED: O destino é gerenciado.

PROVIDED: O destino é uma fila. Esse é o valor padrão.

DESTCLAS
Gerenciador de filas de destino O gerenciador de filas de destino para mensagens publicadas na assinatura. DESTQMGR
Nome do destino Especifica o nome do alias, local, remoto ou fila de clusters na qual as mensagens para essa assinatura são colocadas. DEST
Identificador de correlação O valor de ID de Correlação será colocado no descritor de mensagens de todas as mensagens enviadas para a assinatura. Se nenhum ID de Correlação for especificado, as mensagens serão colocadas no destino com um CorrelId de MQCI_NONE.

Um valor em branco (padrão) resulta no uso de um identificador de correlação gerado pelo sistema.

Se estiver configurado como '000000000000000000000000000000000000000000000000' (48 zeros), o CorrelId configurado pelo aplicativo de publicação, será mantido na cópia da mensagem fornecida para a assinatura, a menos que as mensagens sejam propagadas por uma hierarquia publicar/assinar.

DESTCORL
Durável Uma assinatura durável não é excluída quando o aplicativo de criação fecha seu identificador de assinatura. O parâmetro Durável da assinatura pode ser Sim ou Não. Quando Durável é configurado como Sim, as assinaturas não são excluídas quando o aplicativo de criação fecha seu identificador de assinatura. DURABLE
Tipo O Tipo de assinatura indica como a assinatura foi criada. Os tipos de assinatura são:

API: Assinatura criada por meio de uma solicitação API MQSUB.

ADMIN: Assinatura criada por meio de um comando DEF SUB MQSC ou PCF. ADMIN também é usado para indicar que uma assinatura foi modificada por meio de um comando administrativo.

PROXY: Assinatura criada internamente para rotear publicações por meio de uma rede do gerenciador de filas.

[V9.0.2 Mar 2017][V9.0.0.1 May 2017]Assinaturas do tipo PROXY não são modificadas para ADMIN quando alterações são tentadas.

O Tipo não pode ser modificado.

SUBTYPE
Propriedades Propriedades determina como as propriedades de mensagem relacionadas à publicação/assinatura são incluídas nas mensagens enviadas à assinatura. As opções disponíveis são:

Compatibilidade: As propriedades de publicação/assinatura são incluídas na mensagem para manter a compatibilidade com o IBM WebSphere MQ Versão 6.0 Publish/Subscribe.

Propriedades da Mensagem: As propriedades de publicação/assinatura são incluídas como propriedades da mensagem.

Nenhum: As propriedades de publicação/assinatura não são incluídas na mensagem.

RFH2: As propriedades de publicação/assinatura são incluídas na mensagem com um cabeçalho RFH Versão 2.

PSPROP
Dados do usuário O valor de Dados do Usuário pode ser transmitido opcionalmente como uma propriedade de mensagem em uma mensagem enviada para a assinatura. USERDATA
Seletor O Seletor é uma cadeia SQL92 aplicada a mensagens publicadas no tópico nomeado para selecionar se elas são elegíveis à assinatura. SELECTOR
Tipo de seletor O tipo de SelectionString que foi especificado. Esse atributo de exibição é calculado e não está associado a um objeto. O tipo de seletor será filtrável (por exemplo, com uma cláusula WHERE) para permitir que um administrador exiba apenas seletores internos ou externos. SELTYPE

Página Estendido

A tabela a seguir lista os atributos que podem ser configurados na página Estendido do diálogo Propriedades da Assinatura.

Atributo Significado Parâmetro do MQSC
ID do usuário de variável Especifica se usuários que não são o criador da assinatura podem se conectar a ela e assumir sua propriedade. Os dois valores são:

ANY: Outros usuários podem se conectar à assinatura se o outro usuário tiver as verificações corretas de autoridade de tópico e de autoridade de destino. Esse é o valor padrão.

FIXED: Outros usuários não podem se conectar à assinatura.

VARUSER
Usuário Especifica o perfil do usuário que possui essa assinatura. SUBUSER
Dados de identidade de aplicativo O valor de Dados de identidade do aplicativo será usado para mensagens enviadas para a assinatura. Se Dados de identidade do aplicativo não forem especificados, um valor padrão vazio será usado. PUBAPPID
Token de Contabilidade O valor de Token de Contabilidade será utilizado para mensagens enviadas à assinatura. Se Token de Contabilidade não for especificado, o valor padrão MQACT_NONE será utilizado. PUBACCT
Prioridade de Publicação A Prioridade de Publicação determina como as propriedades de mensagem relacionadas à publicação/assinatura são incluídas nas mensagens enviadas à assinatura. As opções disponíveis são:

Conforme Publicado, que significa que a prioridade da mensagem enviada para essa assinatura é obtida deste fornecimento na mensagem publicada.

Conforme Fila Definida, que significa que a prioridade da mensagem enviada para essa assinatura é obtida da prioridade padrão da fila definida como o destino.

Valor da prioridade que permite especificar uma prioridade no intervalo de 0 a 9.

PUBPRTY
ID da Assinatura O valor do ID de Assinatura é designado pelo gerenciador de filas como um identificador totalmente exclusivo para a assinatura. Esse identificador poderá ser usado como uma alternativa para SUBNAME como o destino para os comandos MQSC DISPLAY, ALTER e DELETE, quando não for possível fornecer o SUBNAME em razão de seu formato ou se nenhum SUBNAME tiver sido fornecido para uma assinatura criada pelo aplicativo. SUBID
Expiração O tempo de existência da assinatura a partir da data e hora de criação. Expiração é medido em décimos de um segundo. Os dois valores são:

Ilimitado, que significa que a assinatura nunca expirará ou o usuário pode digitar seu próprio valor que é medido em décimos de segundo. Zero é o valor padrão.

EXPIRY
Apenas Pedido Apenas Pedido indica se o assinante sondará atualizações por meio da API MQSUBPRQ. Os dois valores são:

Todos, que significa que todas as publicações são entregues à assinatura. Esse é o valor padrão.

A Pedido, que significa que as publicações são entregues à assinatura apenas em resposta à API MQSUBPRQ.

REQONLY
Nível da assinatura Esse é o nível associado à assinatura. As publicações serão entregues para essa assinatura apenas se ela estiver no conjunto de assinaturas com o valor de SubLevel mais alto e menor ou igual ao PubLevel usado no momento da publicação. O valor deve estar no intervalo de 0 a 9. Zero é o nível mais baixo. SUBLEVEL

Página Estatísticas

A tabela a seguir lista os atributos na página Estatísticas do diálogo Propriedades da Assinatura. A página Estatísticas exibe informações sobre o histórico da assinatura. As informações exibidas na página Estatísticas são de leitura e não podem ser alteradas pelo usuário.

Atributo Significado Parâmetro do MQSC
Data de Criação Somente leitura. Essa é a data em que a assinatura foi criada. CRDATE
Hora da Criação Somente leitura. Essa é a hora em que a assinatura foi criada. CRTIME
Data de Mudança Somente leitura. Essa é a data em que os atributos da assinatura foram alterados pela última vez. ALTDATE
Hora da Mudança Somente leitura. Essa é a hora em que os atributos da assinatura foram alterados pela última vez. ALTTIME

Referência Referência

Feedback

Ícone de registro de data e hora Última atualização: Wednesday, 14 February 2018
http://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm.mq.explorer.doc/com.ibm.mq.explorer.doc/e_properties_subs.htm