Configurar salidas de API
Una salida de API es un módulo de código, un archivo .dll, que se proporciona a sí mismo y que se ejecuta inmediatamente antes o después de las llamadas MQI.
Acerca de esta tarea
Cuando IBM® MQ recibe una llamada de un programa a uno de sus puntos de entrada de API, IBM MQ llama a la salida de API. La salida de API se ejecuta antes o después de ejecutar la MQI, dependiendo de cómo se haya configurado la salida.
Puede configurar que se llame a varias, a una o a ninguna salida y puede configurar la secuencia en que se llama a múltiples salidas. En las plataformas Windows y Linux® (x86 y x86-64 ), puede configurar las salidas de API utilizando IBM MQ Explorer. Los detalles de configuración se almacenan en archivos .ini.
- Configure una salida de API en IBM MQ Explorer.
- Alterar temporalmente una salida de API común con una salida de API local.
Existen tres tipos de definiciones de rutinas de salida de API:
- Común (ApiExitCommon)
- Un conjunto de definiciones por sistema. Cuando se inicia el gestor de colas, las salidas de API que se han definido, si las hay, se leen y se aplican al gestor de colas. Configure salidas de API comunes en el diálogo de propiedades de IBM MQ . Las salidas comunes se muestran en la tabla Salidas de API locales del diálogo de propiedades de cada gestor de colas local.
- Plantilla (ApiExitTemplate)
- Un conjunto de definiciones por sistema. Cuando se crea un gestor de colas, las salidas de API definidas, si las hay, se copian en el gestor de colas que se acaba de crear como salidas locales. Configure salidas de API de plantilla en el diálogo de propiedades de IBM MQ .
- Local (ApiExitLocal)
- Un conjunto de definiciones por gestor de colas. Cuando el gestor de colas se inicia, las salidas de API definidas alteran temporalmente las salidas si los atributos Nombre son los mismos y si se ha especificado la alteración temporal. Cuando se altera temporalmente una salida de API común, ninguno de los campos de la definición común se guarda, incluso si el atributo opcional Datos tiene un valor asignado. Configure salidas de API locales en el diálogo de propiedades del gestor de colas.
Cuando configura salidas de API en los diálogos de propiedades de IBM MQ y de gestor de colas, los valores de atributo se añaden a las stanzas ApiExitCommon, ApiExitTemplatey ApiExitLocal en los archivos de configuración o en el registro de Windows.
Atributo | Significado | Clave de stanza |
---|---|---|
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 debe ser exclusivo y está limitado a una longitud de 48 caracteres, y debe contener sólo los caracteres que son válidos para el nombre de objetos IBM MQ , como los nombres de cola. | Nombre |
Tipo | Especifica el tipo de salida: common , template , local o override . |
(No una clave de stanza separada.) |
Secuencia | Este atributo 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 el nombre de vía de acceso completo del módulo, se utilizará tal y como está. 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 este atributo, 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 este atributo no se especifica, se pasa el valor predeterminado de 32 blancos a la salida en el campo ExitData de la estructura MQAXP. | Datos |