2. Historial del documento
Fecha Revisión Descripción Autor
2011-07-26 1.0 Documento final Oscar Vásquez Flores
Administración de WebSphere MQ for z/OS v7.0
3. Información utilizada
• Curso: WM300 - IBM WebSphere MQ V7 System Administration for
z/OS.
• WebSphere MQ v7 Infocenter:
http://www-01.ibm.com/software/integration/wmq/library/
• IBM Redbooks: ABCs of z/OS System Programming. Volume 6
“Security on z/OS, RACF, and LDAP”
• IBM Redbooks: WebSphere MQ V7.0 Features and Enhancements
Administración de WebSphere MQ for z/OS v7.0
4. Objetivo
Una guía rápida para aprender como administrar
WebSphere MQ(WMQ) for z/OS v7.0
Administración de WebSphere MQ for z/OS v7.0
5. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
6. Conocimientos para la Administración de WMQ for z/OS
• Nivel medio de WebSphere MQ 7.0 (Queues,
channels, cluster ,etc.)
• Nivel medio de operaciones en zOS (TSO, ISPF, JCL,
JOBs, CICS, etc.)
Administración de WebSphere MQ for z/OS v7.0
8. Acerca de z/OS – Z Systems
* Sistema Operativo zOS
- Versión 1.13, 1.12 …
LPAR1
* Hardware zOS
- Versión z196, z10 …
LPAR2
* Un LPAR es una partición
independiente del equipo.
* Una Imagen z/OS es un
LPARn LPAR
1 Cylinder = 15 Tracks
1 Track = 192KB Z Systems
1 Track = 6 Block
Evolución del S.O: … MVS > OS/390 > z/OS
Administración de WebSphere MQ for z/OS v7.0
9. Acerca de z/OS - Componentes
LPAR1
zOS
USS
Región
Data Set CICS
p.e. A123CICS
WMQ DB2
Etc.
* Un Data Set es un archivo. p.e. DESA.DATA
* Un Data Set puede contener a otros Data Sets, en este caso se
denomina Partition Data Set(PDS) o Library. p.e. U17756.JCLLIB(*)
Emulador 3270,
* Un Data Set que pertenece a un Library se denomina Member. p.e. Extra
* El Unix System Service(USS) también se denomina OMVS.
USS es un sub sistema del z/OS.
Administración de WebSphere MQ for z/OS v7.0
10. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
11. 1. Mensajería entre aplicaciones y WMQ - Componentes
Librerias del producto
Page Sets(PS)
Guarda mensajes de las colas
Batch
CICS Transacciones CICS
Logs y BSDSs
Para las operaciones IMS Programas Stubs
y recuperación
Para usar WMQ segun el contexto
Administración de WebSphere MQ for z/OS v7.0
12. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
13. 2. Instalación y configuración de WMQ en el z/OS
• Requisitos obligatorios
• z/OS v1.9 o superior, incluido SMP/E, JES2 o JES3, TSO/E,
ISPF
• Communication Server
• Requisitos según la funcionalidad a utilizar
• CICS TS v2.3 o superior, para Trigger Monitor, Bridges ,etc.
• IMS v8.1 o superior, para Trigger Monitor, Bridges ,etc.
• DB2 UDB v8.1 o superior, para Shared Queues
• IBM Java SDK for z/OS v1.4.2 o superior, para USS
• RACF v1.9 o superior, para autorización
Administración de WebSphere MQ for z/OS v7.0
14. Proceso de instalación
SMP/E
Jobs de instalación
CSQ8GZON
CSQ8TZON
Instalación inicial Job CSQ8SYSJ CSQ8ALOE
Editar
* FMIDs CSQ8DDDF
* High level qualifiers(hlq o hqual) CSQ8RECV
* Volsers CSQ8APLY
* SMP/E zone and data set names
* Detalles del JOB card CSQ8ACPT
Librerías de WMQ for z/OS
dhqual.ASCQ*
thqual.SCSQ*
Product tape
Información detallada en el documento:
“i1305291- IBM WebShere MQ for z/OS Program Directory”
Administración de WebSphere MQ for z/OS v7.0
15. Librerías de WMQ for z/OS
Distribution Lib Target Lib Descripción
(dhqual) (thqual)
SCSQMVR1 Programas para la interface TCP/IP
SCSQCICS Programas para funciones CICS
SCSQAUTH Componentes principales de un QMGR
ACSQINTS SCSQINTS Jobs de instalación
ACSQPROC SCSQPROC JCLs de ejemplos para definición de objetos
ACSQCOBS SCSQCOBS Fuentes de programas COBOL de ejemplo
ACSQCOBC SCSQCOBC COBOL Copybooks
ACSQPLNA SCSQPLNA Paneles de ISPF para formatear el dump
ACSQPLNE SCSQPLNE Paneles de ISPF de WMQ
ACSQEXEC SCSQEXEC Map Sets para CICS
... ... ...
Ejemplo de dhqual = MQS.V600.DLIB
Ejemplo de thqual = MQS.V600.TLIB
Administración de WebSphere MQ for z/OS v7.0
16. Personalizar las librerías – thqual
• Sacar una copia a thqual para trabajar sobre este. Por ejemplo a MQS.MQ
• Se debe personalizar según corresponda cada miembro de SCSQPROC, para indicar los
datos según el ambiente de instalación.
• Por cada Qmgr a crear se debe sacar una copia a varios miembros donde se indique el
nombre del nuevo Qmgr.
• Un miembro importante es el CSQ4MSTR, el se cual usa para iniciar el QMGR la copia de
este se puede colocar en SYS1.PROCLIB. Por ejemplo Q252MSTR.
Administración de WebSphere MQ for z/OS v7.0
17. Contenido de CSQ4MSTR
// PROC
//PROCSTEP EXEC PGM=CSQYASCP,REGION=0M
//******************************************************************
//* STEPLIB
//STEPLIB DD DSN=++THLQUAL++.SCSQANL++LANGLETTER++,DISP=SHR
// DD DSN=++THLQUAL++.SCSQAUTH,DISP=SHR
// DD DSN=++LEQUAL++.SCEERUN,DISP=SHR
// DD DSN=++DB2QUAL++.SDSNLOAD,DISP=SHR
//******************************************************************
//* BOOTSTRAP DATA SETS(BS)
1 //BSDS1 DD DSN=++HLQ++.BSDS01,DISP=SHR
//BSDS2 DD DSN=++HLQ++.BSDS02,DISP=SHR
Creación de BS con job CSQ4BSDS
//******************************************************************
//* SYSTEM INITIALIZATION INPUT FILES
2 //CSQINP1 DD DSN=++THLQUAL++.SCSQPROC(CSQ4INP1),DISP=SHR
//CSQINP2 DD DSN=++THLQUAL++.SCSQPROC(CSQ4INSG),DISP=SHR
...
// DD DSN=++THLQUAL++.SCSQPROC(CSQ4DISP),DISP=SHR
3 //CSQOUT1 DD SYSOUT=++OUTCLASS++
//CSQOUT2 DD SYSOUT=++OUTCLASS++
//******************************************************************
//* PAGE SET DATA SETS(PS)
4 //CSQP0000 DD DSN=++HLQ++.PSID00,DISP=SHR
Creación PS con job CSQ4PAGE
...
//CSQP0004 DD DSN=++HLQ++.PSID04,DISP=SHR
//******************************************************************
//* USER EXIT LIBRARY
//CSQXLIB DD DSN=++EXITLIB++,DISP=SHR
//******************************************************************
//* USER EXIT DATA SETS
...
Administración de WebSphere MQ for z/OS v7.0
18. (1)CSQ4BSDS – Creación del Bootstrap y Log
DEFINE CLUSTER -
//CSQ4BSDS JOB
(NAME (++HLQ++.LOGCOPY1.DS01) -
//*
LINEAR -
//* ALLOCATE DATA SETS
VOLUMES(++VOLLOG1A++) -
//*
SHAREOPTIONS(2 3) -
//ALLOC EXEC PGM=IDCAMS,REGION=4M
RECORDS(180000) ) -
//SYSPRINT DD SYSOUT=*
DATA -
//SYSIN DD *
(NAME(++HLQ++.LOGCOPY1.DS01.DATA) )
DELETE (++HLQ++.BSDS01) ERASE CLUSTER
...
... LOG: Archivo VSAM secuencial.
/*
SET MAXCC = 0
//******************************************************************
DEFINE CLUSTER -
//* DEFINE ACTIVE LOGS
(NAME(++HLQ++.BSDS01) -
//LOGDEF EXEC PGM=CSQJU003,COND=(0,NE)
VOLUMES(++VOLBSDS1++) -
//STEPLIB DD
SHAREOPTIONS(2 3) ) -
DSN=++THLQUAL++.SCSQANL++LANGLETTER++,DISP=SHR
DATA -
// DD DSN=++THLQUAL++.SCSQAUTH,DISP=SHR
(NAME(++HLQ++.BSDS01.DATA) -
//SYSUT1 DD DISP=OLD,DSN=++HLQ++.BSDS01
RECORDS(60 60) -
//SYSUT2 DD DISP=OLD,DSN=++HLQ++.BSDS02
RECORDSIZE(4089 4089) -
//SYSPRINT DD SYSOUT=*,DCB=BLKSIZE=629
CONTROLINTERVALSIZE(4096) -
//SYSIN DD *
FREESPACE(0 20) -
NEWLOG DSNAME=++HLQ++.LOGCOPY1.DS01,COPY1
KEYS(4 0) ) -
/*
INDEX -
//******************************************************************
(NAME(++HLQ++.BSDS01.INDEX) -
//* FORMAT ACTIVE LOGS
//* Active log data set 1:
RECORDS(5 5) -
//* Copy 1
CONTROLINTERVALSIZE(1024) )
//LOG1FMT1 EXEC PGM=CSQJUFMT,REGION=0M
...
//STEPLIB DD DSN=++THLQUAL++.SCSQAUTH,DISP=SHR
BSDS: Archivo VSAM con índice. // DD
DSN=++THLQUAL++.SCSQANL++LANGLETTER++,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSUT1 DD DSN=++HLQ++.LOGCOPY1.DS01,DISP=OLD
...
Administración de WebSphere MQ for z/OS v7.0
19. (2)DD CSQ4INP1
******************************************************************
* BUFFER POOL DEFINITIONS
Máximo 16 por QMGR, el tamaño(BUFFERS)
DEFINE BUFFPOOL( 0 ) BUFFERS( 50000 ) esta expresado en 4K.
DEFINE BUFFPOOL( 1 ) BUFFERS( 20000 )
DEFINE BUFFPOOL( 2 ) BUFFERS( 50000 )
DEFINE BUFFPOOL( 3 ) BUFFERS( 20000 )
******************************************************************
* PAGE SET DEFINITIONS Máximo 99 por QMGR, el tamaño máximo de
DEFINE PSID( 00 ) BUFFPOOL( 0 ) EXPAND ( USER ) un Page set es 64GB.
PSID(00) es para los objetos del sistema.
DEFINE PSID( 01 ) BUFFPOOL( 0 ) EXPAND ( USER )
DEFINE PSID( 02 ) BUFFPOOL( 1 ) EXPAND ( USER )
DEFINE PSID( 03 ) BUFFPOOL( 2 ) EXPAND ( USER )
DEFINE PSID( 04 ) BUFFPOOL( 3 ) EXPAND ( USER )
******************************************************************
* OTHER DEFINITIONS
* SECURITY definition.
ALTER SECURITY TIMEOUT( 54 ) INTERVAL( 12 )
Administración de WebSphere MQ for z/OS v7.0
20. (3)DD CSQ4INP2 – Definición de objetos WMQ
• Hace referencia a los siguientes DSN
• CSQ4INSG
Objetos del sistema de uso general.
• CSQ4INSX
Objetos del sistema para clúster e intercomunicación.
• CSQ4INSS
Objetos del sistema para queue-sharing group.
• CSQ4INSJ
Objetos del sistema para publish/subscribe usando JMS
• CSQ4INYS
Objetos Storage Class
• CSQ4INYG
Objetos personalizados de uso general.
• CSQ4INYC
Objetos personalizados para clúster.
• CSQ4INYD
Objetos personalizados para intercomunicación.
• CSQ4DISP
Display de todos los objetos definidos.
Administración de WebSphere MQ for z/OS v7.0
21. (3)DD CSQ4INP2 – Ejemplo CSQ4INSG
Administración de WebSphere MQ for z/OS v7.0
22. (4)CSQ4PAGE – Creación de los PS
//CSQ4PAGE JOB
//DEFINE EXEC PGM=IDCAMS,REGION=4M
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DELETE '++HLQ++.PSID00' ERASE CLUSTER
...
DELETE '++HLQ++.PSID04' ERASE CLUSTER
SET MAXCC=0
Archivo VSAM Secuencial
DEFINE CLUSTER -
(NAME(++HLQ++.PSID00) -
RECORDS(1000 500) -
LINEAR -
VOLUMES(++VOL0++) -
SHAREOPTIONS(2 3) ) -
DATA -
(NAME(++HLQ++.PSID00.DATA) )
...
/*
//******************************************************************
//* Format the page sets
//FORM EXEC PGM=CSQUTIL,COND=(0,NE)
//STEPLIB DD DSN=++THLQUAL++.SCSQANL++LANGLETTER++,DISP=SHR
// DD DSN=++THLQUAL++.SCSQAUTH,DISP=SHR
//CSQP0000 DD DISP=OLD,DSN=++HLQ++.PSID00
...
//CSQP0004 DD DISP=OLD,DSN=++HLQ++.PSID04
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
FORMAT
/*
//
Administración de WebSphere MQ for z/OS v7.0
23. Integración del WMQ como subsistema del z/OS
• Usando el comando SETSSI(Recomendada) o dentro del SYS1.PARMLIB(IEFSSNxx) se
puede definir a WMQ como un subsistema de z/OS
• Por ejemplo para el QMGR Q252 con SETSSI:
• SETSSI ADD, S= Q252, I=CSQ3INI,P=‘CSQ3EPX,+Q252,M’
• En el archivo IEFSSNxx:
• SUBSYS SUBNAME(Q252) INITRTN(CSQ3INI)
INITPARM(‘CSQ3EPX,+Q252,M’)
• +Q252 : Se llama Command prefix string(cpf)
• Q252 : Se llama Subsystem ID(ssid), debe ser igual al nombre del QMGR.
• CSQ3INI y CSQ3EPX: Son nombres de módulos de WMQ
• M: Es el ámbito del subsistema.
• Start y Stop del QMGR: SDSF -> Command
• /+Q252 START QMGR
• /+Q252 STOP QMGR
cpf -> ssid ->ssidMSTR(Es obligatorio tener ese estándar)
Administración de WebSphere MQ for z/OS v7.0
25. Manejo del espacio para un Qmgr en z/OS
Queue1 Queue1 Queue X
Messages Messages Messages
STGCLASS 1 STGCLASS 2 ... STGCLASS Y
PSID 1 PSID 2 PSID N
BUFFPOOL 1 BUFFPOOL 2 BUFFPOOL Z
Administración de WebSphere MQ for z/OS v7.0
26. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
27. 3. Administración de WebSphere MQ
• Se puede administrar con las mismas herramientas usadas en la
versión de WMQ para plataforma distribuida , p.e. WebSphere
MQ Explorer, MQ MOM, etc.
• Adicionalmente se puede administrar por las pantallas en ISPF
de WMQ.
• Si la opción de WMQ no es parte del menú de ISPF, se puede
iniciar con el comando CSQOREXX(ISPF->Command).
• El QMGR de conexión debe estar en el mismo LPAR donde
esta conectado el usuario.
Administración de WebSphere MQ for z/OS v7.0
28. Administración de WMQ por ISPF – Menú principal
Administración de WebSphere MQ for z/OS v7.0
29. Administración de WMQ por ISPF – Lista de colas
Administración de WebSphere MQ for z/OS v7.0
30. Adicionales para la administración por ISPF
• Support Pack MA10: ISPF Utilities Collection.
Opciones:
• MQBRO: Browse de una cola local.
• MQCMD: Ejecuta comandos MQSC.
• MQDLQ: Browse de una Dead Letter Queue.
• MQR2C: Obtiene la descripción de un código de error.
• Support Pack MA17: Message Handler Sample.
Opciones:
• Permite hacer un Browse, Borrar o Reenviar mensajes de
una cola local.
Administración de WebSphere MQ for z/OS v7.0
31. Programa utilitario CSQUTIL
• Es un utilitario de WMQ for z/OS, se puede decir que es la versión Batch de la
administración de WMQ por ISPF.
• Manejo de Page set:
• Formateo de Data set como Page set
• Incremento del tamaño de Page set
• Información de Page set
• Manejo de comandos MQSC
• Ejecutar comandos MQSC
• Generar listas completas de DEFINE, ALTER y DELETE de objetos WMQ
• Manejo de colas y Page set
• Backup y restore de colas y Page set a un Data set
• Copiar colas y Page set a otro QMGR
• Borrar mensajes de una cola
• Varias operaciones se pueden realizan mientras el QMGR esta detenido.
Administración de WebSphere MQ for z/OS v7.0
32. Programa utilitario CSQUTIL - Ejemplo de uso.
//WMQUTIL EXEC PGM=CSQUTIL,PARM=‘QM01'
//STEPLIB DD DISP=SHR,DSN=thlqual.SCSQANLE
// DD DISP=SHR,DSN=thlqual.SCSQAUTH
//OUTPUT1 DD DISP=OLD,DSN=MY.COMMANDS(DEFS)
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
COMMAND DDNAME(CMDINP) MAKEDEF(OUTPUT1)
/*
//CMDINP DD *
DISPLAY QUEUE(*) ALL QSGDISP(QMGR)
DISPLAY CHANNEL(*) ALL QSGDISP(GROUP)
DISPLAY QMGR ALL
/*
Administración de WebSphere MQ for z/OS v7.0
33. WMQ CICS Trigger Monitor
Administración de WebSphere MQ for z/OS v7.0
34. WMQ Batch Trigger Monitor – Support Pack MA12
* El TM usa a INTRDR para ejecutar el JOB final
* El TM cambia de nombre al JOTESTXX según XX= 00 . . .99
* El TM reemplaza al símbolo ! por el nombre Q.REQUEST
* Al programa final solo le llega el nombre de la cola de request
Administración de WebSphere MQ for z/OS v7.0
35. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
36. 4. Comunicación entre Queue Managers
• En z/OS los MCAs se conocen como movers.
• Un QMGR en z/OS se puede comunicar con otro en cualquier
plataforma, que soporte los protocolos TCP/IP o LU6.2.
Administración de WebSphere MQ for z/OS v7.0
37. Distributed queuing
• WMQ usa al z/OS Communication Server TCP/IP y VTAM
APPC(LU6.2).
• Los MCAs usaran un address space diferente al QMGR, este se
denomina Channel Initiator.
Administración de WebSphere MQ for z/OS v7.0
38. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
39. 5. Edición Cliente de WMQ
• WMQ Client es gratis y usa un canal especial hacia el QMGR.
• El WMQ Explorer no requiere instalar WMQ Client.
Administración de WebSphere MQ for z/OS v7.0
40. Edición Cliente de WMQ
• No hay cliente de WMQ en z/OS, únicamente servidor.
• La aplicación en z/OS que usa WMQ y el QMGR deben estar en el
mismo LPAR.
• Si la máxima cantidad de conexiones clientes a un QMGR es 5, no
se requiere nada adicional en el lado del z/OS.
• Si la máxima cantidad de conexiones clientes a un QMGR es
mayor a 5 se requiere comprar el z/OS Client Attachment
Feature(CAF).
• Si no se tiene el CAF, el atributo MAXINST en la definición del
Server-Connection Channel debe tener un valor menor igual a 5.
Administración de WebSphere MQ for z/OS v7.0
41. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
42. 6. Integración por Publicación/Suscripción
Administración de WebSphere MQ for z/OS v7.0
43. Integración por Publicación/Suscripción
• Con WMQ 7.0 hay un soporte nativo para PS.
• Los objetos de PS son parte de WMQ.
• Las pantallas ISPF de WMQ no se pueden usar para crear
objetos de PS.
• Las seguridad en PS es mediante el RACF.
Administración de WebSphere MQ for z/OS v7.0
44. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
45. 7. Java Message Service(JMS)
Una opción para acceder al WMQ desde el USS es mediante JMS
Administración de WebSphere MQ for z/OS v7.0
46. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
47. 8. Clusters de Queue Managers
No hay alguna consideración especial para WMQ for z/OS
Administración de WebSphere MQ for z/OS v7.0
48. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
49. 9. Shared Queues
* Una WMQ Shared Queue es un tipo de cola local.
* La definición de la WMQ Shared Queue se guardan en el DB2 Shared Data.
* Los mensajes de la WMQ Shared Queue se guardan en el Coupling Facility.
Administración de WebSphere MQ for z/OS v7.0
50. Beneficios de Shared Queues
• Alta disponibilidad
Cualquier aplicación conectada a un Qmgr del QSG puede colocar u
obtener mensajes de un Shared Queue, esta no es exclusiva de un
Qmgr. Este es un beneficio comparado con una Clúster Queue.
• Balanceo de carga
Permite implementar un balanceo de carga automático, la misma
aplicación en diferentes imágenes de un z/OS que tenga mejores
recursos procesara más mensajes.
• Escalabilidad
Permite implementar fácilmente un mecanismo de escalabilidad.
• Mensajería rápida
Los mensajes que se intercambian por un QSG tiene costo bajo de
transporte debido al uso del Sysplex.
• Administración simple
Los Qmgrs que pertenecen a un QSG pueden compartir la definición de
diferentes tipos de objetos(Shared o No Shared).
Administración de WebSphere MQ for z/OS v7.0
51. Queue-Sharing groups(QSG)
• Un QSG es un conjunto de Qmgrs que comparten las mismas
Shared Queues
• Un Qmgr puede pertenecer a solo un QSG.
• Un CF List Structure(CFLS) le pertenece únicamente a un QSG.
• Un QSG puede tener varios CFLS.
• Al momento de crear la Shared Queue se debe indicar a que
CFLS pertenece.
• El nombre de un QSG debe ser máximo de tamaño 4.
• El nombre de CFLS iniciara con el nombre del QSG al que
pertenece.
Administración de WebSphere MQ for z/OS v7.0
52. Consideraciones en Shared Queues
• Requisitos:
• z/OS v1.4 o superior
• CF nivel 9
• DB2 v7.1 o superior
• Máximo 8 millones de mensajes por CF Structure.
• Máximo 512 Shared Queues por CF Structure.
• Máximo 512 CF Structure por Sysplex.
• Máximo 32 Qmgrs activos por QSG.
• Si el tamaño del mensaje(incluye headers) es menor a 63KB se guarda en
el CF de lo contrario solo el message headers se guarda en el CF y el
message data se guarda como un BLOB en el DB2. Este soporte es
únicamente si el nivel del CF Structure es 4.
• Tamaño máximo de un mensaje en WMQ for z/OS es 100MB.
Administración de WebSphere MQ for z/OS v7.0
53. Consideraciones en Shared Queues
• Los mensajes no persistentes que están en una Shared Queue
sobreviven a pesar de falla en el Qmgr.
• Los mensajes no persistentes se pierden si falla el CF Structure.
• Una aplicación Batch se puede conectar a un Qmgr o al QSG.
• Definición de objetos
Definición del CF Structure
DEFINE CFSTRUCT(CFS01) CFLEVEL(3) RECOVER(NO)
* Solo permite mensajes menores a 63KB.
* No permite mensajes persistentes
Definición de la Shared Queue
DEFINE QLOCAL(QUEUE01) CFSTRUCT(CFS01) QSGDISP(SHARED)
* Los mensajes se colocan en el CF.
Administración de WebSphere MQ for z/OS v7.0
54. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y Reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
55. 10. Colas de eventos y manejo de la Dead-Letter Queue
• Monitoreo en WMQ
• Monitoreo de eventos
Por ejemplo cuando una cola se llena.
• Monitoreo de mensajes
Por ejemplo trace de un mensaje por diferentes Qmgrs.
• Conteo y estadística de mensajes
Por ejemplo la cantidad de GETs en una cola.
• Monitoreo en tiempo real
Por ejemplo la lista de aplicaciones que están usando una
cola.
Administración de WebSphere MQ for z/OS v7.0
56. Monitoreo de eventos – Colas de eventos
• SYSTEM.ADMIN.QMGR.EVENT
• Eventos de autorización(No disponible en WMQ for z/OS),
eventos de MQPUT o MQGET en una cola que tiene inhibida esa
operación, eventos en objetos locales(p.e. error en MQOPEN a
una cola local), eventos en objetos remotos(p.e. error en el
nombre de la cola remota).
• Start y Stop de un QMGR(WMQ for z/OS soporta únicamente
Start)
• SYSTEM.ADMIN.PERFM.EVENT
• Queue High/Low/Full
• Intervalo de servicio
• SYSTEM.ADMIN.COMMAND.EVENT
• Únicamente en WMQ for z/OS
• Comandos MQSC o PCF procesados.
Administración de WebSphere MQ for z/OS v7.0
57. Monitoreo de eventos – Colas de eventos
• SYSTEM.ADMIN.CONFIG.EVENT
• Únicamente en WMQ for z/OS
• Definición, cambio y eliminación de objetos
• SYSTEM.ADMIN.CHANNEL.EVENT
• Activación, no activación, start y stop
• Errores de conversión
• Eventos de errores en SSL, Start y Stop de IMS Bridge.
• SYSTEM.ADMIN.LOGGER.EVENT
• Inicio de la escritura de una nueva extensión de Log(Solo para
logging lineal)
• No disponible en WMQ for z/OS
Administración de WebSphere MQ for z/OS v7.0
58. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la cola Dead-Letter
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
59. 11. Recuperación y reinicio
• Pronto . . .
Administración de WebSphere MQ for z/OS v7.0
60. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
61. 12. Seguridad
• Se puede usar al producto RACF(Resource Access Control
Facility) para el manejo de la seguridad de WMQ for z/OS.
RACF es un componente clave del z/OS System Security
Administración de WebSphere MQ for z/OS v7.0
62. RACF - Definiciones
• Resources:
Data sets y General Resources (Cualquier tipo de recurso, por ejemplo
una cola de WMQ).
• Access:
ALTER(Modificar definición del recurso), NONE, EXECUTE, READ,
UPDATE(Modificar contenido del recurso), CONTROL(Solo para
archivos VSAM).
• Users y Groups
• Member Class y Group Class:
Para agrupar recursos, por ejemplo la Class MQQUEUE para las colas
de WMQ.
• Profiles:
Es la identificación del recurso, por ejemplo para la cola QUEUE01 en el
Qmgr QM01 el profile es QM01.QUEUE01
Administración de WebSphere MQ for z/OS v7.0
63. Consideraciones de seguridad para WMQ
A nivel de librerías
• En el caso de IMS o CICS, se requiere únicamente acceso de READ a las
librerías de WMQ para el usuario de ejecución y no para todos los usuarios que
ingresan.
• Usualmente las aplicaciones que usan WMQ deberían tener solo acceso de
READ a thlqual.SCQLOAD
A nivel de comandos MQSC
• Los especificados en los Data sets de inicio: CSQINP1 y CSQINP2 no se revisa la
seguridad.
• Los que llegan a la cola de comandos: SYSTEM.COMMAND.INPUT se revisa los
accesos del MQMD.UserIdentifier.
• Consola de MVS: Usuario que inicio la consola o CSQOPR(Usuario por defecto
para comandos)
• Consola SDSF/TSO: Usuario que ejecuto el Job o TSO.
• CSQUTIL: Usuario que ejecuto el Job.
Administración de WebSphere MQ for z/OS v7.0
64. Clases de recursos en WMQ para RACF
• MQADMIN y MXADMIN, Grupo: GMQADMIN
Para las funciones de administración. MX… agrupa a profiles
en mayúsculas y
minúsculas(MIXED)
• MQCONN, Grupo: GMQADMIN
Conexiones.
El atributo SCYCASE(UPPER o
• MQCMDS, Grupo: GMQADMIN MIXED) del QMGR define si solo
Comandos MQSC. soporte profiles en mayúsculas o
mixtos.
• MQQUEUE y MXQUEUE, Grupo: GMQQUEUE
Colas.
• MQPROC y MXPROC, Grupo: GMQPROC
Procesos.
• MQNLIST y MXNLIST, Grupo: GMQNLIST
Listas de nombres.
• MXTOPIC: Para tópicos.
Administración de WebSphere MQ for z/OS v7.0
65. Profiles especiales
Profiles de “switch” para la clase MQADMIN
• ssid.NO.SUBSYS.SECURITY: Desactiva toda la seguridad.
• ssid.NO.CONNECT.CHECKS
• ssid.NO.QUEUE.CHECKS ssid identifica al QMGR, por
• ssid.NO.PROCESS.CHECKS ejemplo:
QM01.NO.QUEUE.CHECKS
• ssid.NO.NAMELIST.CHECKS
• ssid.NO.CONTEXT.CHECKS
• ssid.NO.ALTENATE.USER.CHECKS
• ssid.NO.CMD.CHECKS
• ssid.NO.CMD.RESC.CHECKS
• ssid.NO.TOPICS.CHECKS
Profiles de conexión para la clase MQCONN
• ssid.BATCH: Usuario de Batch o TSO.
• ssid.CICS: Usuario de región CICS.
• ssid.IMS: Usuario de sistema y tarea.
• ssid.CHIN: Usuario de channel initiator.
Administración de WebSphere MQ for z/OS v7.0
66. Niveles de acceso en objetos de WMQ
• MQOPEN:
MQOO_INQUIRE READ
MQOO_BROWSE READ
MQOO_INPUT_* UPDATE, Por ejemplo un MQGET
MQOO_OUTPUT UPDATE, Por ejemplo un MQPUT
MQOO_SET ALTER
• MQCLOSE:
MQCO_DELETE ALTER
MQCO_DELETE_PURGE ALTER
El revisión de accesos en un objeto es al momento del MQOPEN y/o
MQCLOSE
Administración de WebSphere MQ for z/OS v7.0
67. Consideraciones en tipos de colas especiales
• Colas alias:
DEFINE QALIAS(COLA1) TARGQ(COLA2)
Solo se revisara el profile ssid.COLA1 de la clase MQQUEUE no se
considera la revisión del profile ssid.COLA2.
• Colas remotas:
Si existe una definición local de la cola remota:
DEFINE QREMOTE(COLA1) RNAME(COLA2) RQMNAME(QM02)
DEFINE QL(QM02) USAGE(XMITQ)
Solo se revisara el profile ssid.COLA1
Si no existe la definición de cola remota, es decir se coloca el Qmgr
remoto al momento de hacer el MQOPEN:
Solo se revisara el profile ssid.QM02, es decir de la cola de transmisión.
Administración de WebSphere MQ for z/OS v7.0
68. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la cola Dead-Letter
• 11. Recuperación y Reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
69. 13. Detección de problemas
• En el Qmgr
• Mensajes en la consola de tipo CSQ+
• Abends
• El data set SYS1.LOGREC guarda errores de diferentes
componentes.
• En el CICS
• CSMT log
• CICS dump data set
• Para aplicaciones Batch y TSO se puede usar el tipo de
dump SYSUDUMP, se debe incluir un step en el JCL.
Administración de WebSphere MQ for z/OS v7.0
70. Análisis del Dump de WMQ con IPCS
Administración de WebSphere MQ for z/OS v7.0
71. Revisando el WMQ Trace
Administración de WebSphere MQ for z/OS v7.0
72. Agenda
• Introducción
• 1. Mensajería entre aplicaciones y WMQ
• 2. Instalación y configuración de WMQ en el z/OS
• 3. Administración de WMQ
• 4. Comunicación entre Queue Managers
• 5. Edición Cliente de WMQ
• 6. Integración por Publicación/Suscripción
• 7. Java Message Service(JMS)
• 8. Clusters de Queue Managers
• 9. Shared Queues
• 10. Colas de eventos y manejo de la Dead-Letter Queue
• 11. Recuperación y reinicio
• 12. Seguridad
• 13. Detección de problemas
• 14. Soporte para aplicaciones en IMS y CICS
Administración de WebSphere MQ for z/OS v7.0
73. 14. Soporte para aplicaciones en IMS y CICS
• WMQ tiene un adaptador para CICS(WMQ CICS Adapter)
• Los programas CICS pueden hacer uso de WMQ
• Se tiene un Trigger monitor
• Un CICS puede estar conectado solo a un Qmgr.
• La función MQCONN es realizada por el adaptador.
• La funciona MQCONN no esta disponible para los programas, en caso
de ejecutarse será ignorada, retornara un status NORMAL.
• Es necesario definir algunos recursos para el CICS: Mapset, Program,
Transacctions.
• Se puede configurar al CICS para que al iniciarse se conecte al Qmgr
• INITPARM(…,CSQCPARM=‘SN=QM01,TN=003,IQ=Q.INITQ’,…)
• MQCONN=YES
Administración de WebSphere MQ for z/OS v7.0
74. Soporte para aplicaciones en IMS y CICS
• Se requiere agregar las librerías del adaptador al JCL que inicia
al CICS.
//STEPLIB
…
// DD DSN=MQhlq.SCSQANLE, DISP=SHR
// DD DSN=MQhlq.SCSQAUTH, DISP=SHR
//
//DFHRPL
…
// DD DSN=MQhlq.SCSQANLE, DISP=SHR
// DD DSN=MQhlq.SCSQAUTH, DISP=SHR
…
Administración de WebSphere MQ for z/OS v7.0
75. WMQ CICS Adapter - Administración
Transacción CKQC
Administración de WebSphere MQ for z/OS v7.0
76. WMQ CICS Adapter - Datos de la conexión
Administración de WebSphere MQ for z/OS v7.0
77. WMQ CICS Adapter - Datos del Trigger Monitor
Administración de WebSphere MQ for z/OS v7.0
78. WMQ CICS Adapter - Tareas ejecutándose
Administración de WebSphere MQ for z/OS v7.0
79. CICS-MQ Bridges
• Permiten invocar a programas CICS mediante WMQ, estos
programas desconocen a WMQ.
• Se tiene 2 tipos de bridge:
• WMQ CICD DPL Bridge: Permite invocar a programas que usan COMMAREA, es
decir estan preparados para ser invocados por el comando EXEC CICS LINK.
• WMQ 3270 Bridge: Permite invocar a programas que se ejecutan en un terminal 3270,
se invocan por el comando EXEC CICS SEND.
• Requieren de WMQ CICS Adapter
• Son parte de WMQ for zOS
Administración de WebSphere MQ for z/OS v7.0
80. CICS-MQ Bridges - CICS DPL Bridge
Administración de WebSphere MQ for z/OS v7.0
81. CICS-MQ Bridges - CICS 3270 Bridge
Administración de WebSphere MQ for z/OS v7.0
82. Soporte de WMQ para IMS
• WMQ IMS Adapter
• WMQ IMS Trigger Monitor
• WMQ IMS Bridges
• MQ Header MQIIH
Administración de WebSphere MQ for z/OS v7.0