DISPLAY APSTATUS (visualizar estado de aplicación) en Multiplatforms

Utilice el mandato MQSC DISPLAY APSTATUS para visualizar el estado de una o más aplicaciones e instancias de aplicación conectadas a un gestor de colas o a un clúster uniforme.

Utilización de mandatos MQSC

Para obtener información sobre cómo utilizar los mandatos MQSC, consulte Administración de IBM® MQ utilizando mandatos MQSC.

Diagrama de sintaxis
Notas de uso para DISPLAY APSTATUS
Descripciones de parámetros para DISPLAY APSTATUS
Estado de aplicación
Estado de gestor de colas
Estado local

Sinónimo: DIS APS

VISUALIZAR APSTATUS

Estado de aplicación

Estado de gestor de colas

Estado local

Notas de uso para DISPLAY APSTATUS

El parámetro de nombre de aplicación del mandato DISPLAY APSTATUS coincide con los nombres de aplicación establecidos por las aplicaciones. Consulte utilización del nombre de aplicación en lenguajes de programación soportados para obtener más información.

Descripciones de parámetros para DISPLAY APSTATUS

El mandato DISPLAY APSTATUS requiere un valor de serie de nombre de aplicación para determinar qué detalles de aplicación se deben devolver.

gestor_nombres_aplicación

La serie de nombre de aplicación puede tener uno de los valores siguientes:

Un valor de serie de nombre de aplicación específico. Por ejemplo, DIS APSTATUS('myapp') devuelve detalles sólo de la aplicación 'myapp'
Una serie que contiene uno o más caracteres comodín. Por ejemplo, DIS APSTATUS('*put*') devuelve todas las aplicaciones que tienen 'put' en sus nombres de aplicación.

Para devolver una lista de todas las aplicaciones de usuario, utilice DIS APSTATUS('*')

Para filtrar la lista de aplicaciones devueltas, utilice el parámetro WHERE. Por ejemplo,

DIS
APSTATUS('*put*') TYPE(APPL) WHERE(BALANCED eq NO)

devuelve información de aplicación sobre todas las aplicaciones no equilibradas con 'put' en su nombre.

WHERE

Especifica una condición de filtro para que coincida sólo con las aplicaciones o instancias de aplicación que cumplen el criterio de selección de la condición de filtro. La condición de filtro está en tres partes: palabra clave-filtro, operadory valor-filtro:

palabra clave de filtro

Cualquier parámetro que pueda utilizar con este mandato DISPLAY basándose en la opción TYPE .

operador

Determina si un valor de palabras clave satisface una condición en el valor de filtro especificado. Los operadores son:

LT: Menor que
GT: Mayor que
EQ: Igual que
NE: No es igual que
LE: Menor o igual que
GE: Mayor o igual que
LK: Coincide con una serie genérica que se proporciona como valor-filtro
NL: No coincide con una serie genérica que proporcione como valor-filtro
CT: Contiene un elemento especificado. Si la palabra clave-filtro es una lista, puede utilizar este filtro para visualizar objetos cuyos atributos contienen el elemento especificado.
EX: No contiene un elemento especificado. Si la palabra clave-filtro es una lista, puede utilizar este filtro para visualizar objetos cuyos atributos no contienen el elemento especificado.

valor-filtro

El valor con el que se debe comparar el valor del atributo utilizando el operador. En función de la palabra clave de filtro, este valor puede ser:

Un valor explícito que sea un valor válido para el atributo que se está comprobando.
Sólo se pueden utilizar los operadores LT, GT, EQ, NE, LE o GE. Sin embargo, si el valor de atributo es uno de un posible conjunto de valores en un parámetro, sólo puede utilizar EQ o NE.
Un valor genérico. Este valor es una serie de caracteres con un asterisco al final, por ejemplo ABC*. Si el operador es LK, se listan todos los elementos en los que el valor del atributo empiece por la serie (ABC, en el ejemplo). Si el operador es NL, se listan todos los elementos en los que el valor del atributo no empiece por la serie.
No puede utilizar un valor de filtro genérico para parámetros con valores numéricos o con uno de un conjunto de valores.

TODOS

Utilice este parámetro para visualizar todos los atributos.

Si especifica este parámetro, los atributos que solicite adicionalmente no tendrán ningún efecto; el mandato muestra todos los atributos.

Este valor es el valor predeterminado, si no especifica un nombre genérico, y no solicita ningún parámetro específico.

TIPO

Especifica el tipo de información de estado necesaria:

APPL: El mandato muestra información de estado relacionada con cada nombre de aplicación exclusivo, que es el valor predeterminado si no proporciona un parámetro TYPE . Representa un resumen de los detalles del gestor de colas local y de cualquier gestor de colas del mismo clúster uniforme.
QMGR: El mandato muestra información de estado relacionada con las aplicaciones a nivel de gestor de colas, incluido el gestor de colas local y cualquier gestor de colas del mismo clúster uniforme.
LOCAL: El mandato muestra información de estado para las aplicaciones, para cada instancia de aplicación conectada al gestor de colas local.

Estado de la solicitud

Los parámetros de estado de aplicación definen los datos que muestra el mandato. Puede especificar estos parámetros en cualquier orden, pero no debe especificar el mismo parámetro más de una vez:

BALANCED

Si el gestor de colas local es miembro de un clúster uniforme, este campo proporciona una indicación de si el número de instancias de aplicación del clúster está equilibrado actualmente, basándose en la última información recibida de los otros gestores de colas del clúster.

Si el gestor de colas no es miembro de un clúster uniforme, este campo muestra NOTAPPLIC.

El valor puede ser cualquiera de los valores siguientes:

NO: Esta aplicación no se considera equilibrada en el clúster uniforme.
SÍ: Esta aplicación se considera equilibrada en el clúster uniforme.
NOTAPLIC: Esta aplicación no se comparte entre un clúster uniforme.
DESCONOCIDO: Se trata de un estado temporal, que representa una aplicación que todavía no se ha sometido a una exploración para calcular si está equilibrada o no, en al menos un gestor de colas, en el clúster uniforme.

CLÚSTER

Si los detalles de la aplicación se envían alrededor de un clúster uniforme, este campo muestra el nombre del clúster uniforme; de lo contrario, muestra un espacio en blanco.

CONTAR

Esto muestra la suma del número de instancias de aplicación para esta aplicación del gestor de colas local y todos los gestores de colas del clúster uniforme que han compartido sus recuentos de instancias de aplicación.

Un gestor de colas que no está en un clúster uniforme muestra el recuento de instancias de aplicación local.

RECUENTO

Muestra la suma del número de instancias de aplicación movibles para esta aplicación desde el gestor de colas local y todos los gestores de colas del clúster uniforme que han compartido sus recuentos de instancias de aplicación.

Un gestor de colas que no está en un clúster uniforme muestra el recuento de instancias de aplicación local que se podrían mover si se colocaran en un clúster uniforme.

Estado del gestor de colas

Los parámetros de estado del gestor de colas definen los datos que muestra el mandato. Puede especificar estos parámetros en cualquier orden, pero no debe especificar el mismo parámetro más de una vez.

ACTIVE

Se muestra si el gestor de colas se considera activo al equilibrar aplicaciones, lo que indica si la información de ese gestor de colas se ha recibido recientemente.

SÍ: El gestor de colas se está comunicando con el clúster uniforme. El gestor de colas local siempre muestra ACTIVE(YES).
NO: No se ha recibido recientemente ningún estado de este gestor de colas. Esto podría indicar un problema de comunicación o que el gestor de colas se ha suspendido del clúster uniforme.

ESTADO DE EQUILIBRIO

Indica el estado de las instancias de aplicación en este gestor de colas, en comparación con los otros gestores de colas de un clúster uniforme. El valor puede ser:

HIGH: Hay un excedente de instancias de aplicación.
Correcto: Hay un número equilibrado de instancias de aplicación.
LOW: No hay suficientes instancias de aplicación.
NOTAPLIC: El gestor de colas no está en un clúster uniforme.
DESCONOCIDO: Este es un estado temporal que representa una aplicación que es nueva en el clúster uniforme y que todavía no se ha sometido a una exploración para calcular si está equilibrada o no.

CONTAR

Representa el recuento de instancias de aplicación para esta aplicación en el gestor de colas.

LMSGDATE

La fecha local en la que el gestor de colas local ha recibido por última vez un mensaje publicado de este gestor de colas, que contiene los detalles de la instancia de aplicación.

LMSGTIME

Hora local en la que el gestor de colas local ha recibido por última vez un mensaje publicado de este gestor de colas, que contiene los detalles de la instancia de aplicación.

RECUENTO

Representa el recuento de instancias de aplicación movibles para esta aplicación en el gestor de colas. Sólo se tendrán en cuenta las instancias de aplicación que sean móviles para el reequilibrio en un clúster uniforme.

QMID

El identificador de gestor de colas del gestor de colas desde el que se ha originado esta información.

QMNAME

El nombre del gestor de colas desde el que se originó esta información. Habrá una entrada para el gestor de colas local y una para cada gestor de colas que haya distribuido información sobre esta aplicación en un clúster uniforme.

Estado local

Los parámetros de estado local definen los datos que muestra el mandato. Puede especificar estos parámetros en cualquier orden, pero no debe especificar el mismo parámetro más de una vez.

BALONCESTO

Las opciones de equilibrio en vigor para esta instancia de aplicación. Los valores posibles son:

MQBNO_OPCIONES_NINGUNA: No se han establecido opciones.
MQBNO_OPTIONS_IGNORE_TRANS: Esta opción permite que las aplicaciones se reequilibren aunque estén en medio de una transacción.

BALTMOUT

El valor de tiempo de espera en vigor para esta instancia de aplicación. Los valores posibles son:

NEVER: No se produce ningún tiempo de espera.
INMEDIATO: El tiempo de espera se produce inmediatamente
Establecer valor: El valor de tiempo de espera en segundos, hasta un máximo de 999999999 segundos.

TIPO DE BALDE

El tipo de aplicación en vigor para esta instancia de aplicación. Los valores posibles son:

MQBNO_TIPO_SALDO_SIMPLE: No se deben aplicar reglas específicas más allá de los valores predeterminados descritos en Configuración del comportamiento de equilibrio.
MQBNO_TIPO_SALDO_SOLICITUD_DE_REP: Después de cada llamada MQPUT, se espera una llamada MQGET coincidente para un mensaje de respuesta. El equilibrio se retrasa hasta que se recibe un mensaje de este tipo o se ha excedido el mensaje de solicitud EXPIRY.
MQBNO_TIPO_BALANCE_GESTIONADO_POR_RAMAN: Las solicitudes de reequilibrado siempre se asignan inmediatamente al cliente, que se reequilibra en un punto que el cliente considera adecuado.

Tenga en cuenta que diferentes instancias de la misma aplicación pueden proporcionar diferentes opciones de equilibrio sin causar ningún error.

CONNS

Número de conexiones (HCONNS) que tiene actualmente la instancia de aplicación.

CONNTAG

El código de conexión de esta instancia de aplicación.

IMMCOUNT

El número de veces que se ha solicitado a esta instancia de aplicación que se vuelva a conectar, pero ha permanecido conectada. Cualquier valor superior a uno indica que la aplicación no se está moviendo cuando se solicita.

INMEDIATO

Si la instancia de aplicación es inamovible durante un periodo fijo, indica la fecha en la que la instancia será elegible para volver a moverse. Si tiene un valor, el campo IMMREASN debe indicar por qué la conexión es inamovible temporalmente. Si la conexión no es inamovible temporalmente, el valor está en blanco.

IMMREASN

Si la instancia de aplicación es inamovible, esto indica una razón de por qué. Si la instancia de aplicación es movible, el valor está en blanco. Solo se visualiza un IMMREASN aunque se puedan aplicar varios; tenga en cuenta que los estados permanentes (como NOTRECONN, NOTCLIENT) se muestran en preferencia a los valores temporales (como MOVING, INTRANS).

El valor puede ser cualquiera de los valores siguientes:

APPNAMECHG: Esta instancia de aplicación no se puede mover porque está compartiendo un socket con una conexión de una instancia de aplicación que tiene un nombre de aplicación diferente.
INTRANS: La instancia de aplicación ha realizado correctamente al menos una operación MQI dentro del punto de sincronización, y no se ha alcanzado el tiempo de espera especificado para reequilibrar de forma forzada una instancia.
Mover: Esta instancia de aplicación no se puede mover porque se ha solicitado recientemente que se mueva y todavía no se ha desconectado.; Este estado debe ser temporal. IMMDATE y IMMTIME indican cuándo esta instancia de aplicación se considera apta para moverse de nuevo si este estado persiste de forma inesperada.
Ninguna: Esta instancia de aplicación se considera actualmente movible.
NOREDIRECTO: La aplicación cliente ha indicado que no puede procesar sugerencias de redirección del gestor de colas. Esto puede deberse a que la aplicación no está utilizando una CCDT para conectarse al gestor de colas.
NOCLIENTE: Esta instancia de aplicación no se puede mover porque no es una conexión de cliente.
NOTRECONN: Esta instancia de aplicación no se puede mover porque no es una conexión de cliente reconectable.
REPLY: La instancia de aplicación es de tipo REQREP y ha enviado al menos un mensaje de solicitud para el que no se ha recibido una respuesta correspondiente. No se ha alcanzado el tiempo de espera especificado para reequilibrar de forma forzada una instancia.

IMMTIME

Si la instancia de aplicación es inamovible durante un periodo fijo, esto indica la hora en la que la instancia será elegible para volver a moverse. Si tiene un valor, el campo IMMREASN debe indicar por qué la conexión es inamovible temporalmente. Si la conexión no es inamovible temporalmente, el valor está en blanco.

Móvil

Esto indica si esta instancia de aplicación se considera movible o no.