Propriedades de Conexão de Aplicativo
Os atributos para conexões de aplicativos são exibidos no diálogo de propriedades Conexão do aplicativo. Você não pode editar os valores de quaisquer desses atributos.
As tabelas a seguir listam todos os atributos das conexões de aplicativos:
Para cada atributo, há uma breve descrição do que ele significa. As tabelas também fornecem o parâmetro MQSC equivalente para o comando DISPLAY CONN. 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 na página Geral do diálogo Propriedades da Conexão de Aplicativos.
Atributo | 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. Esse atributo não é válido 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. Esse atributo não é válido no HP Integrity NonStop Server e no z/OS. | TID |
ID de 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 os atributos na página Unidade de Trabalho do diálogo Propriedades da Conexão de Aplicativos. A página Unidade de Trabalho exibe informações disponíveis sobre a unidade de trabalho associada à conexão selecionada.
Atributo | 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 | Identifica o originador do encadeamento, exceto no caso em que o atributo Tipo de Aplicativo está configurado como RRSBATCH, quando ele é omitido. | 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 do atributo Tipo UOW. | 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. 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. |
ASTATE |
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 os atributos na página Identificador do diálogo Propriedades da Conexão de Aplicativos. A página Manuseio exibe informações sobre o objeto que o aplicativo selecionado abriu.
Atributo | 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. Ligar como definição de fila significa que o aplicativo abriu a fila para obter mensagens utilizando padrão definido pela fila; Entrada compartilhada significa que o aplicativo abriu a fila para obter mensagens com acesso compartilhado; Entrada exclusiva significa que o aplicativo abriu a fila para obter mensagens com acesso exclusivo; Procurar significa que o aplicativo abriu a fila para procurar as mensagens na fila; Saída significa que o aplicativo abriu a fila para colocar mensagens na fila; Consultar significa que o aplicativo abriu o objeto para obter uma lista dos atributos do objeto; Definir significa que o aplicativo abriu a fila para definir os atributos da fila. Ligação ao abrir significa que o gerenciador de filas local ligou o manuseio de fila a uma determinada instância da fila de destino quando a fila foi aberta, para que todas as mensagens colocadas utilizando esse manuseio sejam enviadas para a mesma instância da fila de destino e pela mesma rota; Ligação não fixa significa que o gerenciador de filas local não ligou o manuseio de fila a uma determinada instância da fila de destino, de forma que as chamadas MQPUT sucessivas utilizando esse manuseio poderão resultar no envio das mensagens para instâncias diferentes da fila de destino ou para a mesma instância mas por rotas deferentes; Ligação como padrão de fila significa que o gerenciador de filas local ligou o manuseio de fila da forma definida pelo atributo de tipo de ligação Padrão da fila. Salvar todo o contexto significa que as informações de contexto de qualquer mensagem recuperada utilizando esse manuseio são associadas a esse manuseio; Transmitir contexto de identidade significa que as informações de contexto de identidade de uma mensagem podem ser transmitidas à mensagem processada quando ela é colocada na fila; Transmitir todo o contexto significa que as informações de identidade e contexto de origem de uma mensagem podem ser transmitidas à mensagem processada quando ela é colocada na fila; Definir contexto de identidade significa que o aplicativo pode definir as informações de contexto de identidade associadas a uma mensagem quando ela é colocada na fila; Definir todo o contexto significa que o aplicativo pode definir as informações de identidade e contexto de origem associadas a uma mensagem quando ela é colocada na fila. Para obter mais informações sobre contexto da mensagem, veja Contexto da Mensagem na documentação on-line do produto IBM MQ. Alternar autoridade de usuário significa que a chamada MQOPEN foi validada em relação ao ID de usuário especificado na chamada; Falha em caso de quiescing significa que a chamada MQOPEN teria falhado se o gerenciador de filas estivesse no estado quiescing. |
OPENOPTS |
Disposição de QSG | Somente leitura. A disposição do grupo de filas compartilhadas do objeto. Gerenciador de filas significa que a definição de objeto só está disponível para o gerenciador de filas que a hospeda; Grupo significa que a definição de objeto está armazenada no repositório compartilhado e cada gerenciador de filas no grupo de filas compartilhadas tem uma cópia da definição; Cópia significa que a definição de objeto é a cópia de uma definição do gerenciador de filas, no repositório compartilhado; Compartilhado significa que a definição de objeto está armazenada no recurso de acoplamento do grupo de filas compartilhadas e está disponível a todos os gerenciadores de filas no grupo de filas compartilhadas. | 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 remotas, esse parâmetro conterá o nome do gerenciador de filas remotas. | 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. 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. |
ASTATE |
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 |