Propriedades de Assinatura do IBM MQ

É possível configurar propriedades para todos os tipos de assinaturas. Algumas das propriedades não se aplicam a todos os tipos de assinaturas, algumas propriedades são específicas para assinaturas do z/OS .

As tabelas a seguir listam todas as propriedades que podem ser configuradas:

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 SUB. Para obter mais informações sobre os comandos MQSC, consulte Administração usando comandos do MQSC na IBM® Knowledge Center.

Página Geral

A tabela a seguir lista as propriedades que podem ser configuradas na página Geral do diálogo de Propriedades da assinatura.

Propriedade 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
Nomes 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: Os assinantes individuais podem apenas 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
Nota: Não é possível configurar a propriedade DESTCORL programaticamente com o JMS.
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.

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 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. Essa propriedade de exibição é calculada e não está associada 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 as propriedades que podem ser configuradas na página Estendido do diálogo de Propriedades da assinatura.

Propriedade 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 as propriedades na página Estatísticas do diálogo de 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.

Propriedade 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 as propriedades da assinatura foram alteradas pela última vez. ALTDATE
Hora da Mudança Somente leitura. Esse é o horário em que as propriedades da assinatura foram alteradas pela última vez. ALTTIME