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