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:
  • Todos significa que todas as conexões são retornadas. Esse é o valor-padrão.
  • Grupo significa que as conexões retornadas consistirão apenas naquelas do grupo para o qual o comando foi destinado.
  • Gerenciador de filas significa que as conexões retornadas consistirão apenas naquelas do gerenciador de filas para o qual o comando foi destinado.
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.

Bind as queue definition significa que o aplicativo abriu a fila para obter mensagens usando o padrão definido pela fila; Input shared significa que o aplicativo abriu a fila para obter mensagens com acesso compartilhado; Input exclusive significa que o aplicativo abriu a fila para obter mensagens com acesso exclusivo; Browse significa que o aplicativo abriu a fila para navegar as mensagens na fila; Output significa que o aplicativo abriu a fila para colocar mensagens na fila; Inquire significa que o aplicativo abriu o objeto para obter uma lista das propriedades do objeto; Set significa que o aplicativo abriu a fila para configurar as propriedades da fila.

Bind on open significa que o aplicativo gerenciador de filas local ligou o identificador da fila para uma instância específica da fila de destino quando a fila foi aberta, de modo que todas as mensagens colocadas usando esse identificador são enviadas para a mesma instância da fila de destino e pela mesma rota; Bind not fixed significa que o gerenciador de filas local não ligou o identificador de fila para uma determinada instância da fila de destino, portanto chamadas MQPUT sucessivas usando este identificador podem resultar em mensagens sendo enviadas para outras instâncias da fila de destino ou sendo enviadas para a mesma instância mas por rotas diferentes; Bind as queue default significa que o gerenciador de filas local ligou o identificador de fila na forma definida pela propriedade do tipo de ligação Padrão da fila.

OPENOPTS
 

Save all context significa que informações de contexto de qualquer mensagem recuperada usando este identificador são associados a esse identificador; Pass identity context significa que as informações de contexto de identidade de uma mensagem podem ser transmitidos para a mensagem processada quando ela é colocada na fila; Pass all context significa que as informações de contexto de identidade e origem de uma mensagem podem ser transmitidas para a mensagem processada quando ela é colocada na fila; Set identity context significa que o aplicativo pode configurar as informações de contexto de identidade associadas a uma mensagem quando ela é colocada na fila; Set all context significa que o aplicativo pode configurar as informações de contexto de identidade e origem associadas a uma mensagem quando ele for colocada na fila. Para obter mais informações sobre contexto de mensagem, consulte contexto de mensagem em IBM Documentação.

Alternate user authority significa que a chamada MQOPEN foi validada junto ao ID do usuário especificado na chamada; Fail if quiescing significa que a chamada MQOPEN teria falhado se o gerenciador de filas estivesse em estado quiesce.

 
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