Ejecución del programa de verificación de la instalación básica

Después de instalar y personalizar IBM® MQ, puede utilizar el programa de verificación de instalación proporcionado, CSQ4IVP1, para confirmar que IBM MQ está operativo.

El programa básico de verificación de la instalación es un IVP ensamblador por lotes que verifica la base IBM MQ sin utilizar las muestras C, COBOL, o CICS® .

SMP/E para z/OS realiza la edición de enlaces para el procedimiento de verificación de instalación del ensamblador por lotes y los módulos de carga se incluyen en la biblioteca thlqual.SCSQLOAD.

Después de haber completado el paso APPLY de SMP/E para z/OS y los pasos de personalización, ejecute el procedimiento de verificación de instalación del ensamblador por lotes.

Consulte estas secciones para obtener más detalles:

Visión general de la aplicación CSQ4IVP1

CSQ4IVP1 es una aplicación por lotes que se conecta al subsistema IBM MQ y realiza estas funciones básicas:

Emite llamadas de IBM MQ
Se comunica con el servidor de mandatos
Verifica que el mecanismo de activación está activo
Genera y suprime una cola dinámica
Verifica el proceso de caducidad de los mensajes
Verifica el proceso de conformación de los mensajes

Preparación para ejecutar CSQ4IVP1

Antes de ejecutar CSQ4IVP1:

Compruebe que las entradas de IVP están en la concatenación del conjunto de datos CSQINP2 en el programa de inicio del gestor de colas. Las entradas de IVP se proporcionan en el miembro thlqual.SCSQPROC(CSQ4IVPQ). Si las entradas no están presentes en la concatenación, añada las definiciones proporcionadas en thlqual.SCSQPROC(CSQ4IVPQ) a la concatenación CSQINP2. Si el gestor de colas está en ejecución actualmente, es necesario reiniciarlo para que estas definiciones entren en vigor.
El JCL de ejemplo, CSQ4IVPR, necesario para ejecutar el programa de verificación de la instalación reside en la biblioteca thlqual.SCSQPROC.
Personalice el JCL CSQ4IVPR con el calificador de alto nivel para las bibliotecas IBM MQ , el idioma nacional que desea utilizar, el nombre del gestor de colas IBM MQ de cuatro caracteres y el destino de la salida del trabajo.

Actualice RACF® para permitir que CSQ4IVP1 acceda a sus recursos si la seguridad de IBM MQ está activa.

Para ejecutar CSQ4IVP1 cuando la seguridad de IBM MQ está habilitada, necesita un ID de usuario de RACF con autorización para acceder a los objetos. Para obtener detalles sobre la definición de recursos en RACF, consulte Configuración de la seguridad en z/OS® . El ID de usuario utilizado para ejecutar el procedimiento de verificación de la instalación debe tener la autorización de acceso siguiente:

Autorización	Perfil	Clase
READ	ssid.DISPLAY.PROCESS	MQCMDS
UPDATE	ssid.SYSTEM.COMMAND.INPUT	MQQUEUE
UPDATE	ssid.SYSTEM.COMMAND.REPLY.MODEL	MQQUEUE
UPDATE	ssid.CSQ4IVP1.**	MQQUEUE
READ	ssid.BATCH	MQCONN

Estos requisitos presuponen que toda la seguridad de IBM MQ está activa. Los mandatos RACF para activar la seguridad de IBM MQ se muestran en la Figura 1. En este ejemplo se presupone que el nombre del gestor de colas es CSQ1 y que el ID de usuario de la persona que ejecuta el CSQ4IVP1 de ejemplo es TS101.

Figura 1. Mandatos RACF para CSQ4IVP1

RDEFINE MQCMDS CSQ1.DISPLAY.PROCESS
PERMIT CSQ1.DISPLAY.PROCESS CLASS(MQCMDS) ID(TS101) ACCESS(READ)

RDEFINE MQQUEUE CSQ1.SYSTEM.COMMAND.INPUT
PERMIT CSQ1.SYSTEM.COMMAND.INPUT CLASS(MQQUEUE) ID(TS101) ACCESS(UPDATE)

RDEFINE MQQUEUE CSQ1.SYSTEM.COMMAND.REPLY.MODEL
PERMIT CSQ1.SYSTEM.COMMAND.REPLY.MODEL CLASS(MQQUEUE) ID(TS101) ACCESS(UPDATE)

RDEFINE MQQUEUE CSQ1.CSQ4IVP1.**
PERMIT CSQ1.CSQ4IVP1.** CLASS(MQQUEUE) ID(TS101) ACCESS(UPDATE)

RDEFINE MQCONN CSQ1.BATCH
PERMIT CSQ1.BATCH CLASS(MQCONN) ID(TS101) ACCESS(READ)

Ejecución de CSQ4IVP1

Cuando haya completado estos pasos, inicie el gestor de colas. Si el gestor de colas ya está en ejecución y ha cambiado CSQINP2, debe detener el gestor de colas y reiniciarlo.

El IVP se ejecuta como un trabajo por lotes. Personalice la tarjeta de trabajo para cumplir los requisitos de presentación de la instalación.

Comprobación de los resultados de CSQ4IVP1

El procedimiento de verificación de la instalación está dividido en 10 etapas. Cada etapa se debe completar y devolver un código de terminación cero antes de ejecutar la etapa siguiente. El procedimiento de verificación de la instalación genera un informe que incluye:

El nombre del gestor de colas con el que se establece conexión.
Un mensaje de una sola línea que muestra el código de terminación y el código de razón devuelto en cada etapa.
Un mensaje informativo de una sola línea cuando sea apropiado.

Se proporciona un informe de ejemplo en la Figura 2

[z/OS] Para obtener una explicación de los códigos de finalización y motivo, consulte IBM MQ for z/OS mensajes, finalización y códigos de motivo.

Algunas etapas tienen más de una llamada IBM MQ y, en caso de anomalía, se emite un mensaje que indica la llamada IBM MQ específica que ha devuelto la anomalía. Además, para algunas etapas, el procedimiento de verificación de la instalación coloca información explicativa y de diagnóstico en un campo de comentarios.

El trabajo del procedimiento de verificación de la instalación solicita el control exclusivo de determinados objetos del gestor de colas, y por tanto debe tener una sola hebra en el sistema. Pero no existe ningún límite respecto al número de veces que el procedimiento de verificación de la instalación se puede ejecutar para el gestor de colas.

Las funciones realizadas por cada etapa son:

Etapa 1

Conectar con el gestor de colas emitiendo la llamada a la API MQCONN.

Etapa 2

Determinar el nombre de la cola de entrada de mandatos del sistema utilizada por el servidor de mandatos para recuperar mensajes de solicitud. Esta cola recibe solicitudes de visualización procedentes de la Etapa 5.

Para ello, la secuencia de llamadas es:

Emite una llamada MQOPEN, especificando el nombre del gestor de colas, para abrir el objeto de gestor de colas.
Emite una llamada MQINQ para averiguar el nombre de la cola de entrada de mandatos del sistema.
Emite una llamada MQINQ para obtener información sobre diversos conmutadores de sucesos del gestor de colas.
Emite una llamada MQCLOSE para cerrar el objeto de gestor de colas.

Cuando esta etapa finaliza satisfactoriamente, el nombre de la cola de entrada de mandatos del sistema se visualiza en el campo de comentarios.

Etapa 3

Abrir una cola de inicio mediante una llamada MQOPEN.

Esta cola se abre en esta etapa en previsión de un mensaje desencadenante, que llega como resultado del servidor de mandatos que responde a la solicitud de la etapa 5. La cola debe abrirse para que la entrada cumpla los criterios desencadenantes.

Etapa 4

Crear una cola dinámica permanente utilizando la cola CSQ4IVP1.MODEL como modelo. La cola dinámica tiene los mismos atributos que el modelo a partir del cual se ha creado. Por tanto, cuando las respuestas del servidor de mandatos a la solicitud de la Etapa 5 se escriben en esta cola, se escribe un mensaje desencadenante en la cola de inicio abierta en la Etapa 3.

Cuando esta etapa finaliza satisfactoriamente, el nombre de la cola dinámica permanente se visualiza en el campo de comentarios.

Etapa 5

Emitir una solicitud MQPUT1 a la cola de mandatos del servidor de mandatos.

Se escribe un mensaje de tipo MQMT-REQUEST en la cola de entrada de mandatos del sistema para solicitar una visualización del proceso CSQ4IVP1. El descriptor del mensaje especifica la cola dinámica permanente creada en la Etapa 4 como cola de respuesta para la respuesta del servidor de mandatos.

Etapa 6

Emitir una solicitud MQGET desde la cola de inicio. En esta etapa, se emite GET WAIT con un intervalo de 1 minuto en la cola de inicio abierta en la etapa 3. Se espera que el mensaje devuelto sea el mensaje desencadenante generado por los mensajes de respuesta del servidor de mandatos que se escriben en la cola de respuesta.

Etapa 7

Suprima la cola dinámica permanente creada en la etapa 4. Como la cola todavía tiene mensajes en ella, se utiliza la opción MQCO_PURGE_DELETE.

Etapa 8

Abrir una cola dinámica.
Emitir MQPUT para un mensaje especificando un intervalo de caducidad definido.
Esperar a que el mensaje caduque.
Emitir MQGET para el mensaje caducado.
Emitir MQCLOSE para la cola.

Etapa 9

Abrir una cola dinámica.
Emitir MQPUT para un mensaje.
Emitir MQCMIT para confirmar la unidad de trabajo actual.
Emitir MQGET para el mensaje.
Emitir MQBACK para restituir el mensaje.
Emitir MQGET para el mismo mensaje y asegurarse de que el contador de restituciones esté establecido en 1.
Emitir MQCLOSE para cerrar la cola.

Etapa 10

Desconectarse del gestor de colas utilizando MQDISC.

Después de ejecutar el procedimiento de verificación de la instalación, puede suprimir los objetos que ya no necesite.

Si el procedimiento de verificación de la instalación no se ejecuta satisfactoriamente, ejecute cada paso manualmente para averiguar qué función está fallando.

Figura 2. Informe de ejemplo de CSQ4IVP1

DATE : 2005.035                 IBM MQ for z/OS - V6            PAGE : 0001
INSTALLATION VERIFICATION PROGRAM
PARAMETERS ACCEPTED. PROGRAM WILL CONNECT TO : CSQ1
,OBJECT QUALIFER : CSQ4IVP1
INSTALLATION VERIFICATION BEGINS :
STAGE 01 COMPLETE. COMPCODE : 0000 REASON CODE : 0000
STAGE 02 INFO: QMGR EVENT SWITCH IS OFF FOR BRIDGE EVENTS
STAGE 02 INFO: QMGR EVENT SWITCH IS EXCP FOR CHANNEL EVENTS
STAGE 02 INFO: QMGR EVENT SWITCH IS OFF FOR SSL EVENTS
STAGE 02 INFO: QMGR EVENT SWITCH IS OFF FOR INHIBITED EVENTS
STAGE 02 INFO: QMGR EVENT SWITCH IS OFF FOR LOCAL EVENTS
STAGE 02 INFO: QMGR EVENT SWITCH IS OFF FOR PERFORMENCE EVENTS
STAGE 02 INFO: QMGR EVENT SWITCH IS OFF FOR REMOTE EVENTS
STAGE 02 INFO: QMGR EVENT SWITCH IS OFF FOR START/STOP EVENTS
STAGE 02 COMPLETE. COMPCODE : 0000 REASON CODE : 0000 SYSTEM.COMMAND.INPUT
STAGE 03 COMPLETE. COMPCODE : 0000 REASON CODE : 0000
STAGE 04 COMPLETE. COMPCODE : 0000 REASON CODE : 0000 CSQ4IVP1.BAB9810EFEAC8980
STAGE 05 COMPLETE. COMPCODE : 0000 REASON CODE : 0000
STAGE 06 COMPLETE. COMPCODE : 0000 REASON CODE : 0000
STAGE 07 COMPLETE. COMPCODE : 0000 REASON CODE : 0000
STAGE 08 COMPLETE. COMPCODE : 0000 REASON CODE : 0000 CSQ4IVP1.BAB9810F0070E645
STAGE 09 COMPLETE. COMPCODE : 0000 REASON CODE : 0000 CSQ4IVP1.BAB9812BA8706803
STAGE 10 COMPLETE. COMPCODE : 0000 REASON CODE : 0000>>>>>>>>>>   END OF REPORT   <<<<<<<<<<