Propiedades de IBM MQ

Las propiedades de IBM® MQ se aplican a toda la instalación de IBM MQ.

Las siguientes tablas listan las propiedades que se pueden establecer para IBM MQ:

Para cada propiedad, hay una breve descripción de los casos en los que posiblemente tenga que configurar la propiedad. Las propiedades del diálogo de propiedades de IBM MQ se relacionan con las secciones de los archivos de configuración.

Página General

En la tabla siguiente se listan las propiedades que puede establecer en la página General del diálogo Propiedades de IBM MQ.

Propiedad Descripción Clave de stanza
Prefijo predeterminado Para cambiar la ubicación del directorio que almacena todos los datos del gestor de colas, escriba la vía de acceso completa para el nuevo directorio. DefaultPrefix
Nombre de gestor de colas predeterminado Para especificar un nombre predeterminado para los gestores de colas nuevos, escriba el nombre en este campo. Nombre

Página Ampliadas

En la tabla siguiente se listan las propiedades que puede establecer en la página Ampliadas del diálogo Propiedades de IBM MQ.

Propiedad Descripción Clave de stanza
[V9.2.0, julio de 2020]Prefijo efímero predeterminado Para cambiar la ubicación del directorio que almacena todos los datos efímeros del gestor de colas, escriba la ruta completa del nuevo directorio. DefaultEphemeralPrefix
Convertir línea nueva EBCDIC Las páginas de códigos EBCDIC contienen un carácter de nueva línea (NL) para el que las páginas de códigos ASCII no tienen soporte (aunque algunas variantes ISO de ASCII contienen un equivalente). Si se envían mensajes desde un sistema que utiliza páginas de código EBCDIC (por ejemplo, un sistema z/OS) a un sistema que utiliza ASCII, se puede controlar la conversión del carácter de línea nueva EBCDIC al formato ASCII. El valor predeterminado es NL_TO_LF, lo que significa que el carácter EBCDIC NL (X'15') se convierte en el carácter ASCII de salto de línea LF (X'0A') en todas las conversiones de EBCDIC a ASCII. Para convertir el carácter EBCDIC NL de acuerdo con las tablas de conversión de su sistema operativo, pulse TABLE. Recuerde que los resultados de una conversión TABLE pueden variar de una plataforma a otra y de un idioma a otro; incluso en una misma plataforma, los resultados pueden variar si utiliza diferentes identificadores del juego de caracteres codificado (CCSID). Para convertir los CCSID de ISO con el método TABLE y utilizar el método NL_TO_LF para los demás CCSID, pulse ISO. ConvEBCDICNewline
Modo de carga de trabajo de clúster La salida de la carga de trabajo del clúster (CLWL) permite especificar la cola del clúster que debe abrirse en respuesta a una llamada MQI (por ejemplo MQOPEN o MQPUT). El valor predeterminado es SAFE, lo que significa que la salida CLWL se ejecuta en un proceso diferente al del gestor de colas, de modo que si surge algún problema, se mantiene la integridad del gestor de colas. Sin embargo, si ejecuta la salida CLWL como un proceso independiente, puede tener un efecto adverso en el rendimiento. Para mejorar el rendimiento ejecutando la salida en el mismo proceso que el gestor de colas, pulse FAST. Utilice la modalidad FAST sólo si está seguro de que no hay ningún problema con la salida CLWL, puesto que si surge un problema en la modalidad FAST, el gestor de colas no se ejecutará correctamente y se pondrá en peligro su integridad. Este valor se puede alterar temporalmente para gestores de colas individuales utilizando la propiedad de modalidad de carga de trabajo de clúster. Si desea ver más información, consulte Propiedades de gestor de colas. CLWLMode

Página Salidas

En la tabla siguiente se listan las propiedades que puede establecer en la página Salidas del diálogo Propiedades de IBM MQ. Para configurar las salidas comunes a todos los gestores de colas de este sistema, edite las propiedades de la página Salidas.

Propiedad Descripción Clave de stanza
Vía de acceso predeterminada de las salidas Para cambiar la ubicación de las salidas de canal para clientes y las salidas de canal y las salidas de conversión de datos para servidores, escriba la vía de acceso del nuevo directorio. ExitsDefaultPath
Salidas de API comunes Para configurar una nueva salida de API común para IBM MQ, pulse Añadir y, a continuación, en el diálogo Propiedades, escriba los detalles de la salida. Para editar una salida de API común que se muestra en la tabla, pulse Editar; para eliminar una salida de API de la tabla, pulse Eliminar. ApiExitCommon
Salidas de API de plantilla Para configurar una nueva salida de API de plantilla para IBM MQ, pulse Añadir y, a continuación, en el diálogo Propiedades, escriba los detalles de la salida. Para editar una salida de API de plantilla que se muestra ya en la tabla, pulse Editar; para eliminar una salida de API de la tabla, pulse Eliminar. ApiExitTemplate
Nombre Especifica el nombre descriptivo de la salida de API que se pasará a la salida de API en el campo ExitInfoName de la estructura MQAXP. Este nombre ha de ser único, está limitado a una longitud de 48 caracteres y sólo debe contener caracteres válidos para el nombre de los objetos IBM MQ, como los nombres de cola. Nombre
Tipo Especifique el tipo de salida: común o plantilla. (No una clave de stanza separada.)
Secuencia Esta propiedad es un valor numérico sin signo que define la secuencia con la que se llamará a esta salida de API en comparación con otras salidas de API. Una salida de API con un número de secuencia bajo se llamará antes que una salida de API con un número de secuencia superior. El orden en que se llama a las diferentes salidas de API con el mismo número de secuencia es indefinido. Es absolutamente correcto que haya lagunas en los números de secuencia de las salidas de API definidas para un gestor de colas. Secuencia
Módulo Especifica el módulo que contiene el código para la salida de API. Si este campo contiene la vía de acceso completa del módulo, se utiliza tal cual. Si este campo contiene únicamente el nombre del módulo, dicho módulo se localiza utilizando el mismo método que las salidas de canal; es decir, utilizando el valor en el campo Vía de acceso predeterminada de las salidas en la página Salidas del diálogo de propiedades del gestor de colas. Módulo
Función Especifica el nombre del punto de entrada de la función en el módulo que contiene el código para la salida de API. Este punto de entrada es la función MQ_INIT_EXIT. La longitud de este campo está limitada a MQ_EXIT_NAME_LENGTH. Función
Datos Si se especifica esta propiedad, los blancos de cabecera y de cola se eliminan, el resto de la serie de caracteres se trunca a 32 caracteres y el resultado se pasa a la salida del campo ExitData de la estructura MQAXP. Si esta propiedad no se especifica, se pasa el valor predeterminado de 32 blancos a la salida en el campo ExitData de la estructura MQAXP. Datos

Valores predeterminados del registro

En la tabla siguiente se listan las propiedades que puede establecer en la página Valores predeterminados del registro del diálogo Propiedades de IBM MQ. Para cambiar los valores de registro predeterminados, edite las propiedades de la página Valores predeterminados del registro. Estos valores se aplican por omisión a todos los gestores de colas nuevos.

Propiedad Descripción Clave de stanza
Tipo de anotaciones Para permitir que el gestor de colas se recupere cuando se reinicia, pulse Circular. Si el gestor de colas utiliza las anotaciones cronológicas circulares, cuando el archivo de anotaciones está lleno, el archivo se sobrescribe desde el principio. Para permitir que el gestor de colas se recupere cuando se reinicia y permitir que la recuperación desde soporte magnético o por repetición de actualizaciones, pulse Lineal. Si el gestor de colas utiliza anotaciones cronológicas lineales, cuando el archivo de anotaciones está lleno, se empieza un nuevo archivo de anotaciones. LogType
Vía de acceso de anotaciones Para cambiar la ubicación por omisión de los archivos de anotaciones, escriba aquí la vía de acceso completa. Si no especifica aquí la vía de acceso, el valor predeterminado es un subdirectorio denominado Log en DefaultPrefix, en el que DefaultPrefix es el directorio especificado en la propiedad Prefijo predeterminado de la página General del diálogo Propiedades de IBM MQ. LogPath
Páginas de archivo de anotaciones Escriba el número, de 32 - 4095, de página de 4 KB en el archivo de registro. Por ejemplo, si escribe 256, el tamaño del archivo será 1 MB. LogFilePages
Archivos de anotaciones primarios

En Windows, escriba el número, de 2 a 254, de archivos de anotaciones. El valor predeterminado es 3. El número total de archivos de anotaciones primarios y secundarios no debe ser superior a 255 ni inferior a 3.

En UNIX y Linux®, escriba el número, de 2 a 510, de archivos de anotaciones. El valor predeterminado es 3. El número total de archivos de anotaciones primarios y secundarios no debe ser superior a 511 ni inferior a 3.

LogPrimaryFiles
Archivos de anotaciones secundarios

En Windows, escriba el número, de 1 a 253, de archivos de anotaciones secundarios. El valor predeterminado es 3. El número total de archivos de anotaciones primarios y secundarios no debe ser superior a 255 ni inferior a 3.

En UNIX y Linux, escriba el número, de 1 a 509, de archivos de anotaciones secundarios. El valor predeterminado es 3. El número total de archivos de anotaciones primarios y secundarios no debe ser superior a 511 ni inferior a 3.

LogSecondaryFiles
Páginas de almacenamiento intermedio de anotaciones Escriba el número, de 0 a 512, de páginas de almacenamiento intermedio de 4 KB para la escritura. Si especifica 0, el gestor de colas seleccionará el número.

Si escribe un número entre 1 y 17, se utilizará el mínimo de 18. Si escribe un número entre 18 y 512, se utilizará ese número de páginas. Si modifica el valor de esta propiedad, reinicie el gestor de colas para detectar el cambio.

LogBufferPages
Integridad de grabación de anotaciones El método que utiliza el registrador de anotaciones para grabar los registros de anotaciones de forma segura.

El valor predeterminado es TripleWrite. Observe que puede seleccionar DoubleWrite, pero si lo hace, el sistema los interpreta como TripleWrite.

Debe utilizar SingleWrite solamente si el sistema de archivos o el dispositivo que aloja el registro de recuperación de IBM MQ garantiza explícitamente la atomicidad de las escrituras de 4KB.

Es decir, cuando una escritura de una página de 4KB falla por algún motivo, los dos únicos estados posibles son la imagen anterior o la imagen posterior. No debería ser posible ningún estado intermedio.

LogWriteIntegrity
Gestión de registros El método utilizado para gestionar los registros. LogManagement se aplica solo cuando LogType es LINEAR.

Si cambia el valor de LogManagement, el cambio no entrará en vigor hasta que no se reinicie el gestor de colas.

Hay tres opciones.

Manual, donde puede gestionar las extensiones de registro manualmente. Si se especifica esta opción significa que el gestor de colas no reutilizará ni suprimirá las extensiones de registro, incluso si ya no son necesarias para la recuperación.

Automático, donde el gestor de colas gestiona automáticamente las extensiones de registro. Si se especifica esta opción significa que el gestor de colas puede reutilizar o suprimir las extensiones de registro en cuanto ya no sean necesarias para la recuperación. No se ha definido límite para el archivado.

Archivo, donde el gestor de colas gestiona las extensiones de registro, pero debe notificar al gestor de colas el momento en que el archivado de todas las extensiones de registro está completo.

Especificar esta opción significa que el gestor de colas puede reutilizar o suprimir una extensión de registro, siempre que se haya notificado al gestor de colas que se ha archivado una extensión que ya no es necesaria para la recuperación.

El valor predeterminado es Manual.

LogManagement

Página ACPI

En la tabla siguiente se listan las propiedades que puede establecer en la página ACPI del diálogo Propiedades de IBM MQ. ACPI (Advanced Configuration and Power Interface) es una característica del sistema operativo que permite al sistema detectar determinados estados de actividad y, por lo tanto, hacerle hibernar, es decir, pasar él mismo a una modalidad de bajo consumo en el que no se ejecutan programas y que permite un "despertar" rápido.

Cuando ACPI desea dejar el sistema en hibernación, primero envía una petición de suspensión a todas las aplicaciones. Para controlar la respuesta de IBM MQ a esta petición, establezca la propiedad Efectuar diálogo en la página ACPI.

Propiedad Descripción Clave de stanza
Efectuar diálogo El valor predeterminado es , lo que significa que IBM MQ muestra un mensaje que consulta al usuario si desea suspender los gestores de colas en ejecución. Para suspender IBM MQ sin mostrar este mensaje, pulse No. DoDialog
Denegar la suspensión Si no se ha establecido la propiedad Efectuar diálogo, o si se ha establecido pero no se puede visualizar el diálogo (por ejemplo, si un portátil tiene la tapa cerrada), Denegar la suspensión controla la respuesta. El valor predeterminado es No, lo que significa que IBM MQ se suspende, aunque no se pueda visualizar el diálogo. Para evitar que IBM MQ se suspenda cuando no se pueda visualizar el diálogo, pulse . Esta propiedad puede ser invalidada por la propiedad Comprobar los canales que están ejecutándose. DenySuspend
Comprobar los canales que están ejecutándose El valor predeterminado es No, lo que significa que IBM MQ no comprueba si hay canales en ejecución y responde siguiendo las indicaciones de las propiedades Efectuar diálogo y Denegar la suspensión. Para comprobar si hay canales ejecutándose, pulse . Si no hay canales en ejecución, IBM MQ ignora las propiedades Efectuar diálogo y Denegar la suspensión. Si hay canales en ejecución, IBM MQ responde siguiendo las indicaciones de las propiedades Efectuar diálogo y Denegar la suspensión. CheckChannelsRunning
[Windows]

Página Supervisor de alertas

El supervisor de alertas sólo está disponible en Windows.

En la tabla siguiente se listan las propiedades que puede establecer en la página Supervisor de alertas del diálogo Propiedades de IBM MQ. El supervisor de alertas es útil para la determinación de problemas. Las alertas las generan los servicios técnicos cuando algo falla; por ejemplo, si un servicio iniciador de canal no puede arrancar porque se ha suprimido una cola necesaria. Para configurar el supervisor de alertas, edite las propiedades de la página Supervisor de alertas.

Propiedad Descripción Clave de stanza
El supervisor de alertas notifica al usuario El valor predeterminado es No, lo que significa que IBM MQ no envía alertas al usuario cuando hay un problema. Para configurar IBM MQ para que envíe alertas cuando haya un problema, pulse . Enable
Usuario del supervisor de alertas Escriba el nombre del sistema o del usuario al que IBM MQ debe enviar las alertas. Recipient
Icono del supervisor de alertas añadido a la barra de tareas El valor predeterminado es No, lo que significa que el icono del supervisor de alertas no se muestra en la bandeja del sistema Windows. Para mostrar el icono del supervisor de alertas en la bandeja del sistema Windows, pulse . TaskBar

Página Información de configuración

En la tabla siguiente se listan las propiedades que se muestran en la Información de configuración del diálogo Propiedades de IBM MQ. Las propiedades de la página Información de configuración son de sólo lectura.

Propiedad Descripción
Tipo de instalación Sólo lectura. Esta propiedad indica si se ha instalado la versión del cliente o del servidor de IBM MQ en este sistema.
mqjbnd05 cargado Sólo lectura. Es la biblioteca necesaria para conectarse a los gestores de colas locales.
MQ Versión Sólo lectura. Esta es la versión de IBM MQ instalada en este sistema.
Nivel de build Sólo lectura. Es el número de build del producto IBM MQ instalado en este sistema.
Tipo de build Sólo lectura. Es el tipo de build del producto IBM MQ instalado en este sistema.