Propiedades de conexión de la aplicación

Las propiedades para las conexiones de aplicación se muestran en el diálogo de propiedades de conexión de la aplicación. No se pueden editar los valores de ninguna de estas propiedades.

En las tablas siguientes aparecen todas las propiedades de las conexiones de aplicaciones:

Para cada propiedad, hay una breve descripción de lo que significa. Las tablas también ofrecen el parámetro MQSC equivalente para el mandato DISPLAY CONN. Para obtener más información sobre los comandos MQSC, consulte Administración utilizando mandatos MQSC en IBM® Knowledge Center.

Página General

En la tabla siguiente aparecen las propiedades de la página General del diálogo de propiedades Conexión de la aplicación.

Propiedad Significado Parámetro MQSC
Nombre de la aplicación Una serie de caracteres que contiene el código de la aplicación conectada al gestor de colas. Es uno de los siguientes: un nombre de trabajo de proceso por lotes z/OS, un USERID de TSO, un APPLID de CICS, un nombre de región IMS, un nombre de trabajo de iniciador de canal, un nombre de trabajo de OS/400, un proceso de UNIX o un proceso de Windows. El nombre de la aplicación representa el nombre del proceso o el trabajo que se ha conectado al gestor de colas. En la instancia a la que está conectada este proceso o trabajo mediante un canal, el nombre de la aplicación representa el proceso o trabajo remoto en lugar del nombre del proceso o trabajo del canal local. APPLTAG
Tipo de aplicación Una serie de caracteres que indica el tipo de la aplicación que está conectada al gestor de colas. Lote indica una aplicación que utiliza una conexión de proceso por lotes; RRSBATCH indica una aplicación coordinada mediante RRS que utiliza una conexión de proceso por lotes; CICS indica una transacción CICS; IMS indica una transacción IMS; CHINIT indica un iniciador de canal; Sistema indica un gestor de colas; Usuario indica una aplicación de usuario. APPLTYPE
ID de proceso El identificador del proceso que abrió la cola. Esta propiedad no es válida en HP Integrity NonStop Server ni en z/OS. PID
ID de hebra El identificador de la hebra del proceso de aplicación que abrió la cola. Un asterisco indica que esa cola se ha abierto con una conexión compartida. Esta propiedad no es válida en HP Integrity NonStop Server ni en z/OS. TID
ID de usuario El identificador de usuario asociado al manejador. USERID
Opciones Son las opciones de conexión que utiliza actualmente esta conexión de aplicación. CONNOPTS
Nombre de canal El nombre del canal que posee el manejador. Si no hay ningún canal asociado al manejado, este valor estará vacío. Este valor sólo se muestra cuando el manejador pertenece al iniciador de canal. CHANNEL
Nombre de conexión El nombre de conexión asociado con el canal que posee el manejador. Si no hay ningún canal asociado al manejado, este valor estará vacío. Este valor sólo se muestra cuando el manejador pertenece al iniciador de canal. CONNAME
Nombre PSB Es el nombre de 8 caracteres del bloque de especificación de programa (PSB) asociado a la transacción IMS en ejecución. PSBNAME
ID de conexión Se trata del identificador de conexión exclusivo de 24 bytes que permite que IBM MQ identifique una aplicación de forma fiable. La primera vez que la aplicación se conecta al gestor de colas, éste establece el identificador de conexión. CONN y EXTCONN

Página Unidad de trabajo

En la tabla siguiente aparecen las propiedades de la página Unidad de trabajo del diálogo de propiedades Conexión de la aplicación. La página Unidad de trabajo muestra la información disponible acerca de la unidad de trabajo asociada a la conexión seleccionada.

Propiedad Significado Parámetro MQSC
Tipo de unidad de trabajo El tipo de unidad de recuperación vista por el gestor de colas. Es uno de los siguientes: CICS (sólo z/OS); XA; RRS (sólo z/OS); IMS (sólo z/OS); Gestor de colas. URTYPE
Fecha de inicio de la unidad de trabajo Es la fecha en la que se inició la transacción asociada a la conexión. UOWSTDA
Hora de inicio de la unidad de trabajo Es la hora en la que se inició la transacción asociada a la conexión. UOWSTTI
ID de unidad de trabajo de origen El identificador de la unidad de recuperación, asignada por el emisor. Es un valor de 8 bytes. NID
Nombre de origen Identifica al emisor de la hebra, excepto cuando la propiedad Tipo de aplicación está establecido en RRSBATCH, en cuyo caso se omite. NID
Nombre de extensión de registro Es el nombre de archivo de la extensión de registro en la cual se grabó por primera vez la transacción asociada a esta conexión. UOWLOG
Fecha del primer acceso al registro Es la fecha en la que la transacción asociada con la conexión grabó por primera vez en el registro. UOWLOGDA
Hora del primer acceso al registro Es la hora en la que la transacción asociada con la conexión grabó por primera vez en el registro. UOWLOGTI
Estado de la unidad de trabajo El estado de la unidad de trabajo Ninguno significa que no hay unidad de trabajo; Activo significa que la unidad de trabajo es activa; Preparado significa que la unidad de trabajo está en proceso de confirmación; No resuelto significa que la unidad de trabajo está en la segunda fase de una operación de confirmación en dos fases, IBM MQ mantiene los recursos en su nombre y se requiere intervención externa para resolverla. Puede ser tan sencillo como iniciar el coordinación de recuperación (como CICS, IMS o RRS) o podría implicar una operación más compleja, como la utilización del mandato RESOLVE INDOUBT. El valor No resuelto sólo se puede producir en z/OS. UOWSTATE
ID de la unidad de trabajo del gestor de colas La unidad de recuperación asignada por el gestor de colas. En z/OS, se trata de un RBA de registro de 8 bytes, mientras que en otras plataformas, es un identificador de transacción de 8 bytes, que se muestra en 16 caracteres hexadecimales. QMURID
ID de unidad de trabajo externo El identificador de la unidad de recuperación externa asociado a la conexión. Es el identificador de recuperación conocido en el coordinador del punto de sincronismo externo. Su formato está determinado por el valor de la propiedad Tipo UOW. EXTURID
Estado asíncrono El estado del consumidor asíncrono en este manejador de objetos. Hay cinco valores posibles:

Activo: Una llamada MQCB ha configurado una función para realizar una nueva devolución de llamada para procesar mensajes de forma asíncrona y el descriptor de conexión se ha iniciado para que se puedan seguir consumiendo mensajes asíncronos.

Inactivo: Una llamada MQCB ha configurado una función para realizar una nueva devolución de llamada para procesar mensajes de forma asíncrona pero el descriptor de conexión todavía no se ha iniciado o se ha iniciado y se ha suspendido, de modo que no se pueden seguir consumiendo mensajes asíncronos.

Suspendido: La devolución de llamada asíncrona se ha suspendido de modo que no se pueden seguir consumiendo mensajes asíncronos en este manejador de objetos. Esto puede deberse a que la aplicación ha emitido una llamada MQCB con la opción de operación MQOP_SUSPEND en este manejador de objetos o porque la haya suspendido el sistema. Si la ha suspendido el sistema, como parte del proceso de suspensión del consumo de mensajes asíncronos, la función de devolución de llamada se invocará con el código de razón que describe el problema causante de la suspensión. Se informa de ello en el campo Razón de la estructura MQCBC que pasa a la función de devolución de llamada. Para poder seguir consumiendo mensajes asíncronos, la aplicación debe emitir una llamada MQCB con el parámetro de operación establecido en MQOP_RESUME.

ASTATE
  Suspendido temporalmente: La devolución de llamada de consumo asíncrono se ha suspendido temporalmente por parte del sistema de modo que no se pueden seguir consumiendo mensajes asíncronos en este manejador de objetos. Como parte del proceso de suspensión de consumo de mensajes asíncronos, la función de devolución de llamada se invocará con el código de razón que describe el problema causante de la suspensión. Se informa de ello en el campo Razón de la estructura MQCBC que se pasa a la función de devolución de llamada. La función de devolución de llamada se volverá a invocar cuando el sistema reanude el consumo de mensajes asíncronos, en el momento en que se haya resuelto la condición temporal.

Ninguno: No se ha emitido ninguna llamada MQCB en este manejador, de modo que no se ha configurado el consumo de mensajes asíncronos en este manejador. Éste es el valor predeterminado.

 
Unidades de disposición de recuperación (Solamente z/OS) Este parámetro se utiliza para filtrar la lista de conexiones devueltas. Hay 3 opciones para elegir:
  • Todas significa que se devuelven todas las conexiones. Éste es el valor predeterminado.
  • Grupo significa que las conexiones devueltas serán solamente las del grupo del cual es destino el mandato.
  • Gestor de colas significa que las conexiones devueltas serán solamente las del gestor de colas del cual es destino el mandato.
URDISP

Página del manejador

En la tabla siguiente aparecen las propiedades de la página Manejador del diálogo de propiedades Conexión de la aplicación. La página Manejador muestra información acerca del objeto que ha abierto la aplicación seleccionada.

Propiedad Significado Parámetro MQSC
ID de conexión Se trata del identificador de conexión exclusivo de 24 bytes que permite que IBM MQ identifique una aplicación de forma fiable. La primera vez que la aplicación se conecta al gestor de colas, éste establece el identificador de conexión. CONN y EXTCONN
Nombre del objeto Es el nombre del objeto que ha abierto la conexión. OBJNAME
Tipo de objeto Es el tipo de objeto que ha abierto la conexión; por ejemplo, Cola, Canal, Clase de almacenamiento. OBJTYPE
Opciones de apertura

Son las opciones utilizadas por la conexión para abrir el objeto.

Enlazar como definición de cola significa que la aplicación abrió la cola para obtener mensajes utilizando el valor predeterminado definido por la cola; Entrada compartida significa que la aplicación abrió la cola para obtener mensajes con acceso compartido; Entrada exclusiva significa que la aplicación abrió la cola para obtener mensajes con acceso exclusivo; Examinar significa que la aplicación abrió la cola para examinar los mensajes de la cola; Salida significa que la aplicación abrió la cola para transferir mensajes a ella; Consultar significa que la aplicación abrió el objeto para obtener una lista de propiedades del objeto; Establecer significa que la aplicación abrió la cola para establecer las propiedades de cola.

Enlazar al abrir significa que la aplicación del gestor de colas local enlazó el manejador de cola a una instancia particular de la cola de destino cuando se abrió la cola, por lo que todos los mensajes que se colocaron por medio de este manejador se envían a la misma instancia de la cola de destino, y por la misma ruta; Enlace no fijo significa que el gestor de colas local no enlazó el manejador de cola con una instancia particular de la cola de destino, por lo que las llamadas MQPUT sucesivas que utilizan este manejador podrían hacer que los mensajes se enviasen a diferentes instancias de la cola de destino, o que se enviasen a la misma instancia, pero por rutas diferentes; Enlazar como valor predeterminado de cola significa que el gestor de colas local enlazó el manejador de cola del modo definido por la propiedad Tipo de enlace predeterminado de la cola.

OPENOPTS
 

Guardar todo el contexto significa que la información del contexto de cualquier mensaje recuperado por medio de este manejador está asociado a este manejador; Pasar contexto de identidad significa que la información del contexto de identidad de un mensaje se puede pasar al mensaje procesado cuando se coloca en la cola; Pasar todo el contexto significa que la información del contexto de origen e identidad de un mensaje se puede pasar al mensaje procesado cuando se coloca en la cola; Establecer contexto de la identidad significa que la aplicación puede establecer la información del contexto de identidad asociada a un mensaje cuando se coloca en la cola; Establecer todo el contexto significa que la aplicación puede establecer la información del contexto de origen e identidad asociada a un mensaje cuando se coloca en la cola. Para obtener más información sobre el contexto de un mensaje, consulte Contexto de mensaje en IBM Knowledge Center.

Autorización de usuario alternativo significa que la llamada MQOPEN estaba validada con el ID de usuario especificado en la llamada; Error si está en fase de inmovilización significa que la llamada MQOPEN habría sido errónea si el gestor de colas estuviese inmovilizado.

 
Disposición QSG Sólo lectura. La disposición del grupo de compartición de colas del objeto. Gestor de colas significa que la definición de objeto solo está disponible para el gestor de colas que la alberga; Grupo significa que la definición de objeto se almacena en el depósito compartido y cada gestor de colas del grupo de compartición de colas tiene una copia de la definición; Copia significa que la definición de objeto es la copia del gestor de colas de una definición del depósito compartido; Compartida significa que la definición de objeto está almacenada en el recurso de acoplamiento del grupo de compartición de colas y está disponible para todos los gestores de colas del grupo de compartición de colas. QSGDISP
Estado del manejador Estado actual del manejador. Activo significa que hay una llamada de API en proceso desde esta conexión para este objeto. Si el objeto es una cola, esta condición puede surgir cuando una llamada MQGET WAIT está en proceso. Si hay una señal MQGET destacada, esto no significa, por sí mismo, que el manejador esté activo. Inactivo significa que no hay ninguna llamada de API en proceso desde esta conexión para este objeto. Si el objeto es una cola, esta condición puede surgir cuando no hay ninguna llamada MQGET WAIT en proceso. HSTATE
Serie de tema La serie de tema resuelto. Este parámetro es importante para manejadores con OBJTYPE(TOPIC). Para otros tipos de objeto, este parámetro estará vacío. TOPICSTR
Nombre de suscripción El nombre de suscripción exclusivo de la aplicación que está asociado al descriptor de contexto. Este parámetro es importante solamente para manejadores de suscripciones a temas. No todas las suscripciones tendrás un nombre de suscripción. SUBNAME
ID de suscripción El identificador interno y exclusivo habitual de la suscripción. Este parámetro es importante solamente para manejadores de suscripciones a temas. No todas las descripciones aparecen en DISPLAY CONN; únicamente se muestran las que tengan manejadores actuales abiertos para la suscripción. Puede utilizar el mandato DISPLAY SUB para ver todas las suscripciones. SUBID
Gestor de la cola de destino El gestor de la cola de destino para mensajes que se publican para esta suscripción. Este parámetro es importante solamente para manejadores de suscripciones a temas. Si DEST es una cola alojada en el gestor de colas local, este parámetro contendrá el nombre del gestor de colas local. Si DEST es una cola alojada en el gestor de gestor de colas remoto, este parámetro contendrá el nombre del gestor de colas remoto. DESTQMGR
Nombre de destino La cola de destino para mensajes que se publican para esta suscripción. Este parámetro sólo es pertinente para manejadores de suscripciones a temas. DEST
Estado asíncrono El estado del consumidor asíncrono en este manejador de objetos. Hay cinco valores posibles:

Activo: Una llamada MQCB ha configurado una función para realizar una nueva devolución de llamada para procesar mensajes de forma asíncrona y el descriptor de conexión se ha iniciado para que se puedan seguir consumiendo mensajes asíncronos.

Inactivo: Una llamada MQCB ha configurado una función para realizar una nueva devolución de llamada para procesar mensajes de forma asíncrona pero el descriptor de conexión todavía no se ha iniciado o se ha iniciado y se ha suspendido, de modo que no se pueden seguir consumiendo mensajes asíncronos.

Suspendido: La devolución de llamada asíncrona se ha suspendido de modo que no se pueden seguir consumiendo mensajes asíncronos en este manejador de objetos. Esto puede deberse a que la aplicación ha emitido una llamada MQCB con la opción de operación MQOP_SUSPEND en este manejador de objetos o porque la haya suspendido el sistema. Si la ha suspendido el sistema, como parte del proceso de suspensión del consumo de mensajes asíncronos, la función de devolución de llamada se invocará con el código de razón que describe el problema causante de la suspensión. Se informa de ello en el campo Razón de la estructura MQCBC que pasa a la función de devolución de llamada. Para poder seguir consumiendo mensajes asíncronos, la aplicación debe emitir una llamada MQCB con el parámetro de operación establecido en MQOP_RESUME.

ASTATE
  Suspendido temporalmente: La devolución de llamada de consumo asíncrono se ha suspendido temporalmente por parte del sistema de modo que no se pueden seguir consumiendo mensajes asíncronos en este manejador de objetos. Como parte del proceso de suspensión de consumo de mensajes asíncronos, la función de devolución de llamada se invocará con el código de razón que describe el problema causante de la suspensión. Se informa de ello en el campo Razón de la estructura MQCBC que se pasa a la función de devolución de llamada. La función de devolución de llamada se volverá a invocar cuando el sistema reanude el consumo de mensajes asíncronos, en el momento en que se haya resuelto la condición temporal.

Ninguno: No se ha emitido ninguna llamada MQCB en este manejador, de modo que no se ha configurado el consumo de mensajes asíncronos en este manejador. Éste es el valor predeterminado.

 
Lectura anticipada El estado de la conexión de lectura anticipada. Hay cuatro valores posibles:

No: La lectura anticipada de mensajes no persistentes no está habilitada para este objeto. Éste es el valor predeterminado.

: La lectura anticipada de mensajes no persistentes está habilitada para este objeto y se está utilizando eficazmente.

Reserva: La lectura anticipada de mensajes no persistentes está habilitada para este objeto. La lectura anticipada no se está utilizando eficazmente debido a que se ha enviado al cliente un gran número de mensajes que no se están consumiendo.

Inhibida: La aplicación ha solicitado la lectura anticipada, pero ésta se ha inhibido porque se han especificado opciones incompatibles en la primera llamada MQGET.
READA