Propriedades de Conexão de Aplicativo
As propriedades para conexões de aplicativos são exibidas no diálogo de propriedades de Conexão de aplicativo. Não é possível editar os valores de nenhuma dessas propriedades.
As tabelas a seguir listam todas as propriedades para conexões de aplicativos:
Para cada propriedade, há uma breve descrição de seu significado. As tabelas também fornecem o parâmetro MQSC equivalente para o comando DISPLAY CONN. Para obter mais informações sobre os comandos MQSC, consulte Administração usando comandos MQSC em IBM® Documentação.
Página Geral
A tabela a seguir lista as propriedades na página Geral do diálogo de propriedades de Conexão de aplicativo.
Propriedade | Significado | Parâmetro do MQSC |
---|---|---|
Nome do aplicativo | Uma cadeia contendo a tag do aplicativo conectado ao gerenciador de filas. É um dos seguintes: um nome de job batch z/OS® , um TSO USERID, um CICS ® APPLID, um nome de região IMS , um nome de job inicializador de canal, um nome de job OS/400® , um processo Linux® ou AIX® , um processo Windows . O nome do aplicativo representa o nome do processo ou da tarefa que foi conectada ao gerenciador de filas. Se esse processo ou tarefa estiver conectado via canal, o nome do aplicativo representa o processo ou a tarefa remota, em vez do nome do processo ou tarefa de canal local. | APPLTAG |
Tipo de aplicativo | Uma cadeia indicando o tipo do aplicativo que está conectado ao gerenciador de filas. Batch significa um aplicativo utilizando uma
conexão em lote; RRSBATCH significa um aplicativo coordenado pelo RRS
utilizando uma conexão em lote; CICS significa uma transação do CICS;
IMS significa uma transação do IMS; CHINIT significa um iniciador de canal; System significa um gerenciador de filas;
User significa um aplicativo do usuário. |
APPLTYPE |
ID do processo | O identificador do processo que abriu a fila. Esta propriedade não é válida no z/OS. | PID |
ID do Encadeamento | O identificador do encadeamento no processo aplicativo que abriu a fila. Um asterisco indica que esta fila foi aberta com uma conexão compartilhada. Esta propriedade não é válida no z/OS. | TID |
ID do usuário | O identificador do usuário associado ao identificador. | USERID |
Opções | São as opções de conexão que são utilizadas atualmente por essa conexão de aplicativo. | CONNOPTS |
Nome do canal | O nome do canal que possui o identificador. Se não houver canais associados ao identificador, esse valor é vazio. Esse valor é mostrado apenas quando o identificador pertence ao inicializador de canais. | CHANNEL |
Nome da Conexão | O nome da conexão associada ao canal que possui o identificador. Se não houver canais associados ao identificador, esse valor é vazio. Esse valor é mostrado apenas quando o identificador pertence ao inicializador de canais. | CONNAME |
Nome de PSB | Este é o nome de 8 caracteres do PSB (Program Specification Block) associado à transação IMS em execução. | PSBNAME |
ID de conexão | Este é o identificador de conexão exclusivo de 24-byte bits que permite que IBM MQ identifique de forma confiável um aplicativo. Quando o aplicativo é conectado pela primeira vez ao gerenciador de filas, o gerenciador de filas configura o identificador de conexão. | CONN e EXTCONN |
Página Unidade de Trabalho
A tabela a seguir lista as propriedades na página Unidade de trabalho do diálogo de propriedades de Conexão de aplicativo. A página Unidade de Trabalho exibe informações disponíveis sobre a unidade de trabalho associada à conexão selecionada.
Propriedade | Significado | Parâmetro do MQSC |
---|---|---|
Tipo de unidade de trabalho | O tipo de unidade de recuperação conforme visto pelo gerenciador de filas. É um dos seguintes: CICS (z/OS apenas); XA ; RRS (apenasz/OS ); IMS (apenasz/OS ); Queue manager . |
URTYPE |
Data de início da unidade de trabalho | Essa é a data em que a transmissão associada à conexão foi iniciada. | UOWSTDA |
Hora de início da unidade de trabalho | Essa é a hora em que a transmissão associada à conexão foi iniciada. | UOWSTTI |
ID da unidade de trabalho de origem | O identificador da unidade de recuperação, que foi designado pelo originador. É um valor de 8 bytes. | NID |
Nome de origem | Isso identifica o originador do encadeamento, exceto no caso em que a propriedade Application type é configurada como RRSBATCH, em que é omitida. | NID |
Nome de extensão de log | Esse é o nome do arquivo da extensão de log no qual a transação associada a essa conexão foi gravada pela primeira vez. | UOWLOG |
Primeira data de acesso ao log | Essa é a data em que a transação associada à conexão foi gravada pela primeira vez no log. | UOWLOGDA |
Primeira hora de acesso ao log | Essa é a hora em que a transação associada à conexão foi gravada pela primeira vez no log. | UOWLOGTI |
Estado da unidade de trabalho | O estado da unidade de trabalho. None significa que não há unidade de trabalho; Active significa que a unidade de trabalho está ativa; Prepared significa que a unidade de trabalho está em processo de ser cometida; Unresolved significa que a unidade de trabalho encontra-se na segunda fase de uma operação de consolidação de duas fases, IBM MQ mantém-se recursos em seu nome e a intervenção externa é necessária para resolvem-lo. Isso poderá
ser tão simples quanto iniciar o coordenador de recuperação (como CICS, IMS ou RRS) ou
poderá envolver uma operação mais complexa, como utilizar o comando RESOLVE INDOUBT. O
valor Unresolved pode ocorrer apenas no z/OS. |
UOWSTATE |
ID da unidade de trabalho do gerenciador de filas | A unidade de recuperação designada pelo gerenciador de filas. No z/OS, esse é um RBA de log de 8 bytes, enquanto em outras plataformas, é um identificador de transação de 8 bytes, exibido como 16 caracteres hexadecimais. | QMURID |
ID da unidade de trabalho externa | O identificador de unidade de recuperação externa associado à conexão. É o identificador de recuperação conhecido no coordenador de ponto de sincronização externo. Seu formato é determinado pelo valor da propriedade UOW
type . |
EXTURID |
Estado assíncrono | O estado do consumidor assíncrono neste identificador de objetos. Há cinco valores possíveis: Ativo: uma chamada de MQCB configurou uma função como retorno de chamada para processar mensagens de maneira assíncrona e o identificador de conexões foi iniciado, para que o consumo de mensagem assíncrona seja processado. Inativo: Uma chamada de MQCB configurou uma função como retorno de chamada para processar mensagens de maneira assíncrona, mas o identificador de conexão não foi iniciado ainda ou foi parado ou suspenso, para que o consumo de mensagem assíncrona não seja processado atualmente.Suspenso: O retorno de chamada de consumo assíncrono foi suspenso, para que o consumo de mensagem assíncrono não seja processado atualmente nesta manipulação de objetos. Isto pode ser porque uma chamada de MQCB com o Operation MQOP_SUSPEND foi emitida com relação a esse identificador de objetos pelo aplicativo ou porque foi suspensa pelo sistema. Se ela foi suspensa pelo sistema como parte do processo de suspensão do consumo de mensagem assíncrona, a função de retorno de chamada será chamada com o código de razão que descreve o problema que resulta na suspensão. Isto será relatado no campo Razão na estrutura do MQCBC que é transmitida para a função de retorno de chamada. Para que o consumo de mensagem assíncrona continue, o aplicativo deverá emitir uma chamada de MQCB com o parâmetro Operation configurado como MQOP_RESUME. |
ASTATE |
Susptemp: O retorno de chamada de consumo assíncrono foi suspenso temporariamente pelo sistema, para que o consumo de mensagem assíncrona não seja processado atualmente neste identificador de objetos. Como parte do processo de suspensão do consumo de mensagem assíncrona, a função de retorno de chamada será chamada com o código de razão que descreve o problema que resulta em suspensão. Isto será relatado no campo Razão na estrutura do MQCBC transmitida para a função de retorno de chamada. A função de retorno de chamada será chamada novamente quando o consumo de mensagem assíncrona for continuado pelo sistema, quando a condição temporária tiver sido resolvida. Nenhum: Uma chamada de MQCB não foi emitida com relação a este identificador, portanto, nenhum consumo de mensagem assíncrona está configurado neste identificador. Esse é o valor-padrão. |
||
Unidades de disposição de recuperação | (apenas z/OS) Este parâmetro é usado para filtrar a lista de conexões retornadas. Há três opções a serem escolhidas:
|
URDISP |
Página Identificador
A tabela a seguir lista as propriedades na página Manipular do diálogo de propriedades de Conexão de aplicativo. A página Manuseio exibe informações sobre o objeto que o aplicativo selecionado abriu.
Propriedade | Significado | Parâmetro do MQSC |
---|---|---|
ID de conexão | Este é o identificador de conexão exclusivo de 24-byte bits que permite que IBM MQ identifique de forma confiável um aplicativo. Quando o aplicativo é conectado pela primeira vez ao gerenciador de filas, o gerenciador de filas configura o identificador de conexão. | CONN e EXTCONN |
Nome do objeto | Esse é o nome do objeto que a conexão abriu. | OBJNAME |
Tipo de objeto | Este é o tipo do objeto que a conexão abriu; por exemplo, Queue , Channel , Storage
Class . |
OBJTYPE |
Opções de abertura | Essas são as opções utilizadas pela conexão para abrir o objeto.
|
OPENOPTS |
|
||
Disposição QSG | Somente leitura. A disposição do grupo de filas compartilhadas do objeto. Queue
manager significa que a definição de objeto está disponível apenas para o gerenciador de filas que o hospeda; Group significa que a definição do objeto é armazenada no repositório compartilhado e cada gerenciador de filas no grupo de compartilhamento de filas tem uma cópia da definição; Copy significa que a definição do objeto é a cópia do gerenciador de filas de uma definição no repositório compartilhado; Shared significa que a definição do objeto é armazenada no recurso de acoplamento do grupo de compartilhamento de filas e está disponível para todos os gerenciadores de filas no grupo de compartilhamento de filas. |
QSGDISP |
Manipular estado | O estado atual do identificador. Ativo significa que uma chamada de API dessa conexão está atualmente em progresso para este objeto. Se o objeto for uma fila, esta condição poderá ocorrer quando uma chamada MQGET WAIT estiver em progresso. Se houver um sinal MQGET pendente, isso não significa, por si mesmo, que o identificador está ativo. Inativo significa que nenhuma chamada de API dessa conexão está atualmente em progresso para este objeto. Se o objeto for uma fila, esta condição poderá ocorrer quando nenhuma chamada MQGET WAIT estiver em progresso. | HSTATE |
Cadeia do tópico | A sequência de tópicos resolvidos. Esse parâmetro é relevante para identificadores com OBJTYPE(TOPIC). Para qualquer outro tipo de objeto, esse parâmetro está em branco. | TOPICSTR |
Nome da assinatura | O nome da assinatura exclusiva do aplicativo que está associado à manipulação. Esse parâmetro é relevante apenas para identificadores de assinaturas para tópicos. Nem todas as assinaturas terão um nome de assinatura. | SUBNAME |
ID da assinatura | O identificador interno e exclusivo o tempo todo da assinatura. Esse parâmetro é relevante apenas para identificadores de assinaturas para tópicos. Nem todas as assinaturas aparecem em DISPLAY CONN. Apenas aquelas que têm identificadores atuais abertos para que a assinatura apareça. É possível usar o comando DISPLAY SUB para ver todas as assinaturas. | SUBID |
Gerenciador de Filas de destino | O gerenciador de filas de destino para mensagens que estão publicadas nesta assinatura. Esse parâmetro é relevante apenas para identificadores de assinaturas para tópicos. Se DEST for uma fila que está hospedada no gerenciador de filas local, esse parâmetro conterá o nome do gerenciador de filas local. Se DEST for uma fila que está hospedada em um gerenciador de filas remoto, esse parâmetro conterá o nome do gerenciador de filas remoto. | DESTQMGR |
Nome do destino | A fila de mensagens de destino que estão publicadas nesta assinatura. Esse parâmetro é relevante apenas para identificadores de assinaturas para tópicos. | DEST |
Estado assíncrono | O estado do consumidor assíncrono neste identificador de objetos. Há cinco valores possíveis: Ativo: uma chamada de MQCB configurou uma função como retorno de chamada para processar mensagens de maneira assíncrona e o identificador de conexões foi iniciado, para que o consumo de mensagem assíncrona seja processado. Inativo: Uma chamada de MQCB configurou uma função como retorno de chamada para processar mensagens de maneira assíncrona, mas o identificador de conexão não foi iniciado ainda ou foi parado ou suspenso, para que o consumo de mensagem assíncrona não seja processado atualmente.Suspenso: O retorno de chamada de consumo assíncrono foi suspenso, para que o consumo de mensagem assíncrono não seja processado atualmente nesta manipulação de objetos. Isto pode ser porque uma chamada de MQCB com o Operation MQOP_SUSPEND foi emitida com relação a esse identificador de objetos pelo aplicativo ou porque foi suspensa pelo sistema. Se ela foi suspensa pelo sistema como parte do processo de suspensão do consumo de mensagem assíncrona, a função de retorno de chamada será chamada com o código de razão que descreve o problema que resulta na suspensão. Isto será relatado no campo Razão na estrutura do MQCBC que é transmitida para a função de retorno de chamada. Para que o consumo de mensagem assíncrona continue, o aplicativo deverá emitir uma chamada de MQCB com o parâmetro Operation configurado como MQOP_RESUME. |
ASTATE |
Susptemp: O retorno de chamada de consumo assíncrono foi suspenso temporariamente pelo sistema, para que o consumo de mensagem assíncrona não seja processado atualmente neste identificador de objetos. Como parte do processo de suspensão do consumo de mensagem assíncrona, a função de retorno de chamada será chamada com o código de razão que descreve o problema que resulta em suspensão. Isto será relatado no campo Razão na estrutura do MQCBC transmitida para a função de retorno de chamada. A função de retorno de chamada será chamada novamente quando o consumo de mensagem assíncrona for continuado pelo sistema, quando a condição temporária tiver sido resolvida. Nenhum: Uma chamada de MQCB não foi emitida com relação a este identificador, portanto, nenhum consumo de mensagem assíncrona está configurado neste identificador. Esse é o valor-padrão. |
||
Ler antes | O status de conexão de leitura antecipada. Há quatro valores possíveis: Não: A leitura antecipada de mensagens não persistentes não é permitida para este objeto. Esse é o valor-padrão. Sim: A leitura antecipada de mensagem não persistente é permitida para este objeto e está sendo usada eficientemente.Lista Não Processada: A leitura antecipada de mensagens não persistentes é permitida para este objeto. A leitura antecipada não está sendo usada eficientemente porque foi enviado ao cliente um grande número de mensagens que não estão sendo consumidas. Inibido: A leitura antecipada foi pedida pelo aplicativo, mas foi inibida por causa das opções incompatíveis especificadas na primeira chamada de MQGET. |
READA |