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 do MQSC na IBM® Knowledge Center.
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 da tarefa em lote do z/OS , um TSO USERID, CICS APPLID, um nome de região do IMS, um nome de tarefa do inicializador de canal, um nome de tarefa do OS/400, um processo do UNIX, um processo do 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.
Lote significa um aplicativo usando uma
conexão em lotes; RRSBATCH significa um aplicativo coordenado pelo RRS
usando uma conexão em lotes; CICS significa uma transação do CICS;
IMS significa uma transação do IMS; CHINIT significa um
iniciador de canal; Sistema significa um gerenciador de filas;
Usuário significa um aplicativo do usuário. |
APPLTYPE |
ID do processo | O identificador do processo que abriu a fila. Essa propriedade não é válida no HP Integrity NonStop Server e 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. Essa propriedade não é válida no HP Integrity NonStop Server e 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 bloco de especificação de programas (PSB) que está associado à execução da transação do IMS. | PSBNAME |
ID de conexão | Este é o ID de conexão exclusivo de 24 bytes que permite que o IBM MQ identifique um aplicativo de forma confiável. 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 seguinte: CICS (apenas z/OS ); XA ; RRS (apenas z/OS ); IMS (apenas z/OS ); Gerenciador de Filas . |
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. Nenhum significa
que não há nenhuma unidade de trabalho; Ativo significa que
a unidade de trabalho está ativa; Preparado significa que a unidade de trabalho
está no processo de ser confirmada; Não Resolvido significa que a unidade de trabalho
está na segunda fase de uma operação two-phase
commit, o IBM MQ mantém recursos em seu nome e é
necessária uma intervenção externa para resolvê-lo. Isso poderá ser tão simples quanto iniciar o coordenador de recuperação (como o CICS, IMS ou RRS) ou poderá envolver uma operação mais complexa como usar 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 , é 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 | (Somente 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 ID de conexão exclusivo de 24 bytes que permite que o IBM MQ identifique um aplicativo de forma confiável. 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 | Esse é o tipo do objeto que a conexão abriu; por exemplo,
Fila , Canal , Classe de Armazenamento . |
OBJTYPE |
Opções de abertura | Essas são as opções utilizadas pela conexão para abrir o objeto.
|
OPENOPTS |
|
||
Disposição de 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 somente para o gerenciador de filas que a hospeda, Group significa que a definição de objeto é armazenada no repositório compartilhado e cada gerenciador de filas no grupo de filas compartilhadas possui uma cópia da definição, Copy significa que a definição de objeto é a cópia do gerenciador de filas de uma definição no repositório compartilhado e Shared significa que a definição do objeto está armazenada no recurso de acoplamento do grupo de filas compartilhadas e está disponível para todos os gerenciadores de filas no grupo. |
QSGDISP |
Estado do Identificador | 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 |
Sequência de Tópicos | 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 |