home / infca / mq / mq_zos (navigation links) Sonrie, y serás feliz  

MQ al z/OS


Install Customize Parameters Tuning BSDSs Logging Restart
Seguridad Commands Control Events Support Packs Explorer Performance Auditoria
Trigger (CKTI) CICS bridge COBOL 63 KB msg CHINIT Consola Shared Qs
Kutxka Acc Llibres URLs mapa

Install

Amunt! Top Amunt!

Installable features

System Setup Guide, WS MQ for z/OS, version 6.0, SC34-6853-00, page 3 to 19/321


Customize

Amunt! Top Amunt!

Before you perform the customization tasks, there are a number of configuration options that you should consider because they affect the performance and resource requirements of WebSphere MQ for z/OS. These options are discussed in the MQ for z/OS Concepts and Planning Guide. [llibres]

Task 1: Identify the z/OS system parameters Task 2: APF authorize the WebSphere MQ load libraries Task 3: Update the z/OS link list and LPA Task 4: Update the z/OS program properties table Task 5: Define the WebSphere MQ subsystem to z/OS Task 6: Create procedures for the WebSphere MQ queue manager Task 7: Create procedures for the channel initiator Task 8: Define the WebSphere MQ subsystem to a z/OS WLM service class Task 9: Set up the DB2 environment Task 10: Set up the Coupling Facility Task 11: Implement your ESM security controls Task 12: Update SYS1.PARMLIB members Task 13: Customize the initialization input data sets Task 14: Create the bootstrap and log data sets Task 15: Define your page sets Task 16: Add the WebSphere MQ entries to the DB2 data-sharing group Task 17: Tailor your system parameter module Task 18: Tailor the channel initiator parameters Task 19: Set up Batch, TSO, and RRS adapters Task 20: Set up the operations and control panels Task 21: Include the WebSphere MQ dump formatting member Task 22: Suppress information messages

M'agradaria saber la manera de mostrar, visualitzar tots aquestos valors en una instalació ja feta !


Parameters

Amunt! Top Amunt!

La tabla de parámetros está compuesta por tres macros. Estas macros establecen los valores operativos del SISTEMA, LOGs y proceso de ARCHIVE. En general, los valores de los parámetros no son críticos y los establecidos por defecto están fijados para un sistema que soportará una gran carga de trabajo.

MQ for z/OS V6.0 System Setup Guide, SC34-6583-00

Use CSQ6SYSP to set SYSTEM parameters.

LOGLOAD
Cuántas escrituras de LOG se tienen que producir antes de que se genere un registro de CheckPoint. Esto puede afectar al tiempo de recuperación y rendimiento. El defecto es 500.000 suele ser muy elevado, 50000 está más en línea.
The greater the value, the better the performance of WebSphere MQ; however, restart takes longer if the parameter is set to a large value.
QMCCSID
Es la tabla de traslación de códigos de caracteres. 1145 es la tabla de español con signo del euro.

MQ for z/OS V6.0 System Setup Guide, SC34-6583-00, page 36, 52/321

Use CSQ6LOGP to establish your logging options.

OFFLOAD
Si deseas que se arranque proceso de ARCHIVE cuando un LOG se llena.
TWOACTV
Establece escritura doble de LOGS.
TWOARCH
Establece escritura doble de ARCHIVES.
TWOBSDS
Establece escritura doble de BSDS. El BSDS es el fichero de control de LOGs.

MQ for z/OS V6.0 System Setup Guide, SC34-6583-00, page 45, 62/321

Use CSQ6ARVP to establish your archiving environment.
El primero, segundo y cuarto son muy recomendables, el tercero discutible; depende de las instalaciones.

ARCPFX1
El nombre con el que comienzan los ficheros de ARCHIVE.
ARCPFX2
Si el ARCHIVE es doble, el nombre de comienzo para el segundo fichero (TWOARCH=YES de la macro de LOG).
TSTAMP
Si YES, al prefijo anterior se le añade día y hora de creación del fichero de ARCHIVE. El nombre definitivo del ARCHIVE se sufija con una terminación que denota secuencia.
ARCWTOR
Enviará un mensaje al operador de consola cuando se produce el ARCHIVE del LOG. Si el dispositivo es DISCO o ROBOT es NO, si es CINTA, YES.
CATALOG
Este parámetro hará que el nombre del fichero de ARCHIVE quede registrado en el catálogo de ficheros del Sistema. Suele ser YES, pero muchas instalaciones disponen de gestores de CINTAS y prefieren no catalogar esos nombres de ficheros en el catálogo del sistema para registrarlo en el catálogo de cintas.
COMPACT
Si se quiere compactación de datos. Es muy recomendable NO.
BLKSIZE
Depende del dispositivo donde se grabará el fichero de ARCHIVE. En el libro vienen los valores recomendados.
UNIT
Es el nombre del dispositivo, cinta o disco. Cada instalación tiene sus nombres.

MQ for z/OS V6.0 System Setup Guide, SC34-6583-00, page 49, 65/321


Tuning

Amunt! Top Amunt!

There are a number of ways in which you can improve the performance of your queue manager, which are controlled by queue manager attributes set by the ALTER QMGR command. MQ SupportPac MP16, Capacity planning and tuning for WebSphere MQ for z/OS, gives more information on performance and tuning.

z/OS Concepts and Planning Guide WS MQ for z/OS, version 6.0, GC34-6852-00, page 44, 61/207

Syncpoints - One of the roles of the queue manager is syncpoint control within an application.
Set a fairly low MAXUMSGS value, such as 100, to avoid performance problems, and to protect against looping applications.
Expired messages - Messages that have expired are discarded by the next appropriate MQGET call.
The queue manager can periodically scan any queue for expired messages, which are then deleted. You can choose how often this scanning takes place, if at all.

Concepts

Amunt! Top Amunt!

BSDSs

Use the supplied program CSQJU003 to prepare the bootstrap data sets (BSDSs) and log data sets. You must run this job once for each WebSphere MQ queue manager you use.

System Setup Guide, WS MQ for z/OS, version 6.0, SC34-6853-00, page 32 to 48/321

The print log map utility (CSQJU004) is a batch utility that lists the information stored in the BSDS.

Logging

What logs are

MQ records all significant events as they occur in an active log. The log contains the information needed to recover:

The active log comprises a collection of data sets (up to 31) which are used cyclically.

Archiving

Because the active log has a fixed size, MQ copies the contents of each log data set periodically to an archive log, which is normally a data set on a direct access storage device (DASD) or a magnetic tape. If there is a subsystem or transaction failure, MQ uses the active log and, if necessary, the archive log for recovery.

z/OS Concepts and Planning Guide WS MQ for z/OS, version 6.0, GC34-6852-00, chapter 4


Controlling archiving and logging

Many aspects of archiving and logging are controlled by parameters set using the CSQ6LOGP, CSQ6ARVP and CSQ6SYSP macros of the system parameter module when the queue manager is customized. See the "WebSphere MQ for z/OS System Setup Guide" for details of these macros.

You can display the settings of all the parameters using the

MQSC DISPLAY LOG (a) MQSC DISPLAY ARCHIVE MQSC DISPLAY SYSTEM

(a) also returns a report about the status of the logs.

Use DISPLAY USAGE to display information about the current state of a page set, or to display information about the log data sets.


How many logs are required, etc

Planning your logging environment

z/OS Concepts and Planning Guide WS MQ for z/OS, version 6.0, GC34-6852-00, chapter 18


El proceso de LOG - ARCHIVE es el siguiente [Gracias, Paco]
Se definen LOGs, que son fichero donde se registra el movimiento de los mensajes PERSISTENTES que maneja MQSeries. Se pueden definir N ficheros de LOGs con un tamaño. Supongamos 3 ficheros. Cuando el PRIMERO de TRES se llena, se conmuta al SEGUNDO y comienza el proceso de ARCHIVE del PRIMERO, esto es, se COPIA el contenido del PRIMERO a otro fichero normalmente en CINTA. Cuando se llena el SEGUNDO,... igual. Cuando se llena el TERCERO, se conmuta al PRIMERO, igual.... Esto es un CICLO de LOG.
En cualquier momento se pueden añadir, de forma dinámica, un CUARTO, QUINTO, etc.

Casuística: Estamos en el TERCER fichero de TRES. Cuando se llena, se conmuta al PRIMERO y ARCHIVE del TERCERO. Si el proceso de ARCHIVE del PRIMERO no se ha realizado (problema del hardware o pereza del operador o no hay tiempo material para hacer el ARCHIVE), el MQSeries se para.
Todos esto queda registrado en otro fichero, el BSDS (BootStrapDataSet): LOG que está ACTIVO, ficheros de ARCHIVE, si una descarga (ARCHIVE) está pendiente, etc.

Recomendación: Un ciclo de LOG debe durar 24 horas. ¿Por qué? Porque diariamente se debe hacer una copia de seguridad y, por razones de rapidez de recuperación, todos los datos de recuperación deberían estar en los LOG.

Nota: Cuando el proceso de ARCHIVE se produce (copia de LOG a CINTA), los datos siguen vivos en los LOG y se usarán antes que los datos de CINTA. Si el ciclo de LOG es de 24 horas, se puede recuperar cualquier cosa sin necesidad de tirar de CINTA, mucho más lenta.


Sistemas LIGHT, MEDIUM and HEAVY Workload. [Gracias, Paco]
Un CICLO viene dado por el número y la velocidad de mensajes PERSISTENTES que maneja MQSeries y este es un dato que se desconoce de antemano. El mejor método es el consejo del inglés: mirar los mensajes CSQJ001I y CSQJ002I en SDSF (log del sistema), ver cada cuánto tiempo se producen y, a partir de aquí, dimensionar el espacio y el número. Te recuerdo que se pueden añadir dinámicamente sin parar nada.

En el Concept and Planning, me parece recordar, vienen unas recomendaciones para sistemas LIGHT, MEDIUM and HEAVY Workload.


CSQJ001I [Gracias, Paco]
When the current active log data set is full (or when an ARCHIVE LOG command is issued), MQ will switch to the next available active log data set. This message identifies the next available active log data set that will be used for logging.
CSQJ002I [Gracias, Paco]
This message is sent when logging switches to a new empty data set. The message shows the name and log RBA range of the full data set.

Messages and Codes, WS MQ for z/OS, version 6.0, GC34-6602-00, chapter 5, page 47

Recovery & Restart

 SYSTEM SETUP GUIDE                    SC34-6052-xx
 CONCEPTS AND PLANNING GUIDE           SC34-6051-xx
 SYSTEM ADMINISTRATION GUIDE for Z/OS  SC34-6053-xx    Part 5 = Recovery & Restart.

z/OS Concepts and Planning Guide WS MQ for z/OS, version 6.0, GC34-6852-00, chapter 6

System Administration Guide, WS MQ for z/OS, version 6.0, SC34-6585-00, part 5, chapter 13-16.

Seguridad

 SYSTEM SETUP GUIDE           SC34-6052-xx (z/OS, v 5.3)
 CONCEPTS AND PLANNING GUIDE  SC34-6051-xx (z/OS, v 5.3)
 SECURITY                     SC34-6079-xx (v 5.3)

System Setup Guide, WS MQ for z/OS, version 6.0, SC34-6853-00, chapter 17

z/OS Concepts and Planning Guide WS MQ for z/OS, version 6.0, GC34-6852-00, chapter 7

Security, WS MQ version 6.0, SC34-6588-01


Useful commands

Amunt! Top Amunt!

MQSC DISPLAY ARCHIVE = MQSC DISPLAY CHANNEL(*) ALL = MQSC DISPLAY LOG = MQSC DISPLAY QMGR ALL = MQSC DISPLAY QUEUE(*) ALL = MQSC DISPLAY SYSTEM = MQSC DISPLAY USAGE =

Que fa al z/OS la comanda DISPLAY DQM ? [MQMONNTP]


Event Control

These fields correspond to the INHIBTEV, LOCALEV,REMOTEEV, STRSTPEV, PERFMEV and CONFIGEV attributes of the queue manager.


Support Packs

Amunt! Top Amunt!

MP15
CSQWFSMF, program to print out SMF (Systems Management Facility) records that contain statistics and accounting info from MQ for MVS.
MP16
Capacity planning and tuning for MQ for z/OS. 143 pages, high level.
At T42:\MQ\SupportPacks\. [URLs]

Explorer

Amunt! Top Amunt!

Al recurs SYSTEM.DEF.SVRCONN de z/OS, posar la linia MCAUSER('ST9010')

Performance Analysis

Amunt! Top Amunt!

Investigating performance problems

Performance can be adversely affected by:

System Setup Guide, WS MQ for z/OS, version 6.0, SC34-6853-00, page 120 to 136/321


Auditoria / Diagnosi de MQ

Amunt! Top Amunt!

System parameters to verify
MQ configuration parameters . Log size / disk space . Log ubication . Log mirroring . Page Set number and ubication . Backup period . Queue Manager configuration . Queues definitions . Channels definitions .
Time measurements

Trigger Monitors

Amunt! Top Amunt!

To a queue manager, a trigger monitor is like any other application that serves a queue. However, a trigger monitor serves initiation queues. A trigger monitor is usually a continuously-running program. When a trigger message arrives on an initiation queue, the trigger monitor retrieves that message. It uses information in the message to issue a command to start the application that is to process the messages on the application queue. The trigger monitor must pass sufficient information to the program it is starting so that the program can perform the right actions on the right application queue.

Trigger monitors on z/OS

The following trigger monitor is provided for CICS Transaction Server for z/OS and CICS for MVS/ESA: CKTI
You need to start one instance of CKTI for each initiation queue (see WebSphere MQ for z/OS System Administration Guide for information on how to do this). CKTI passes the MQTM structure of the trigger message to the program it starts by EXEC CICS START TRANSID. The started program gets this information by using the EXEC CICS RETRIEVE command. A program can use the EXEC CICS RETRIEVE command with the RTRANSID option to determine how the program was started; if the value returned is CKTI, the program was started by "MQ for z/OS".

For an example of how to use CKTI, see the source code supplied for module CSQ4CVB2 in the Credit Check sample application supplied with WebSphere MQ for z/OS. See The Credit Check sample for a full description. URL

The following trigger monitor is provided for IMS/ESA: CSQQTRMN
You need to start one instance of CSQQTRMN for each initiation queue (see WebSphere MQ for z/OS System Administration Guide for information on how to do this). CSQQTRMN passes the MQTMC2 structure of the trigger message to the programs it starts.

URL

"Application Programming Guide", WS MQ for z/OS, version 6.0, SC34-6895-01, page 195 [216/601]

The CICS trigger monitor (CKTI) issued a 'EXEC CICS START TRANSID' for the value (CICS tranid) specified in the ApplId parameter of the Process definition. - {Fora}

Start the CKTI trigger monitor (supplied with WebSphere MQ for z/OS) against queue CSQ4SAMP.INITIATION.QUEUE, using the CICS transaction CKQC.

"Application Programming Guide", WS MQ for z/OS, version 6.0, SC34-6895-01, page 467 [487/601]

{Fora} - 1. Use the CKBM transaction to tell the CKTI transaction what initiation queue to monitor
2. In your PROCESS definition set APPLTYPE to CICS and APPLICID to the name of the transaction you want to start.

CKBM - tell init q to monitor CKBR - with Request queue CKQC - tell init q CKTI -

Why trigger?

Triggering is only really good for very intermittent invocation. It has extra overhead of a PUT and GET to the initiation queue and has to load the application program into the system each time a message arrives.

Just code a long-running CICS transaction with MQGET WAIT on the queue. Process the message, reply to it and repeat the MQGET WAIT in a loop. For a server program that is invoked fairly frequently this is the most efficient way to code it.


The CICS bridge

Amunt! Top Amunt!

The WebSphere MQ-CICS bridge is the component of WebSphere MQ for z/OS that allows direct access from WebSphere MQ applications to applications on your CICS system. In bridge applications there are no WebSphere MQ calls within the CICS application (the bridge enables implicit MQI support). This means that you can re-engineer legacy applications that were controlled by 3270-connected terminals to be controlled by WebSphere MQ messages, without having to rewrite, recompile, or re-link them.

Concepts and Planning Guide, WS MQ for z/OS, version 6.0, GC34-6582-00, page 99 [116/207]

You can use the CICS Bridge to run a DPL program or a 3270 transaction.

Application Programming Guide, chapter 17, "Using and writing MQ-CICS Bridge applications for z/OS"

A MQ application can start a CICS application by sending a structured message to the CICS bridge request queue. Any data required by the CICS application can be included in the request message:

Similarly, the CICS application can send data back to the MQ application in a message that is sent to a reply queue:

Application Programming Guide, pg 268 [288/601] "CICS DPL bridge message structure".

Concepts & Planning Guide - esquema maco.

url


COBOL

Amunt! Top Amunt!

Application Programming Guide, WS MQ for z/OS, version 6.0, SC34-6595-01,
ch 26 = Building your application on z/OS,
ch 29 = Sample programs fo MQ for z/OS

Supportpac MA12 provides two sample COBOL programs which can be used as MVS-Batch trigger monitors. This can be found here: url


63 KB msg

Amunt! Top Amunt!

The size for normal messages was 4 MB at some time and moved to 100 MB with mq v 6
When ibm started with shared queues, in the first versions only non persistent and < 64kb messages where possible

On v531 the Shared Messages is on the CF. On v600 the Shared Messages is on DB2 (for messages larger than 63 KB).


CHINT start

Amunt! Top Amunt!

El método más "limpio" de arrancar el chinit es:
En el arranque de la tarea MSTR, en vuestro caso CSQ1MSTR, tenemos una DD llamada CSQINP2. Esta DD se "ALLOCA" con una concatenación de miembros con definiciones de objeto. La primera vez del mundo mundial que se arranca la tarea MSTR, se concatenan varios miembros y a partir de esta primera vez, se deja uno solo con comandos que le pueden ser útiles al administrador de sistema. Personalmente, yo en ese miembros solo dejo un comando, precisamente el arranque del CHINIT.

* ARRANQUE de la tarea de COMUNICACIONES. START CHINIT

Consola segura

Amunt! Top Amunt!

Repasar

  1. Perfiles definidos en la CLASS MQADMIN
  2. Perfiles y lista de acceso de la CLASS MQCMDS.
  3. Valor del parámetro CMDUSER de la macro CSQ6SYSP. Este valor aparece en el arranque de la tarea MSTR.
  4. Al dar un comando por una consola NOT MASTER, se recibe un NOT AUTHORIZED. En el LOG del sistema hay un mensaje ICH408I con información de seguridad.
  5. En el arranque de la tarea MSTR, aparecen una serie de líneas de mensajes, CSQH024I y CSQH021I.

Shared queues

Amunt! Top Amunt!

url


Amunt! Top Amunt!
MQ on Z

Rest assured that 'implementing' WebSphere MQ on a z/OS platform is exponentially more involved and difficult than an implementation on one of the distributed platforms.

Unlike the distributed platforms, on z/OS you have to include/involve/negotiate around numerous other technical departments to complete the 'implementation'. Some that come to mind immediately are RACF Authorizations, APF Authorizations, MVS Support, CICS support and it wouldn't hurt to have some indepth SMPE knowledge to boot.

Creating a new QMGR on z/OS is not the simple crtmqm as found on the distributed platforms.


Kutxka

Amunt! Top Amunt!

Several shared message queues within a Coupling Facility. Estimated total workload of about 8000 messages per second. Each message will be 4K in size. (8.000 msg/seg * 4 KB/msg = 32.000 Kbytes/seg) Each queue is attended by a recording process that converts the MQ message to an INSERT/UPDATE operation against a DB2 database.

Acc

Amunt! Top Amunt!

o Parametrización del MQ o Seguridad o Restart / Recovery

Uni

Amunt! Top Amunt!

Customer is using linear logs. Used rcdmqimg to take backups. Recovered the damaged objects using rcrmqobj command.


Print Log Utility

The print log utility is CSQ1LOGP. It runs as an MVS batch job. You can print active logs and inactive logs. There are control statements that allow the z/OS admin to pick and choose what to print. The EXTRACT control statement is a good place to start reading.

This is from the System Admin manual about EXTRACT:

Typical uses of the EXTRACT parameter are to:

Print the BSDS log directory to determine which are active and which are inactive (archivable). There is a supplied utility to print the BSDS. Refer to the z/OS WMQ System Admin manual unit on managing the bsds. Use the print log map utility (CSQJU004) to print the contents of the BSDS.


Llibres

Amunt! Top Amunt!

De URL

A T42:\MQ\BOOKS\V6\zOS

MQ for z/OS V6.0 Concepts and Planning Guide GC34-6582-00 MQ for z/OS V6.0 Messages and Codes GC34-6602-00 MQ for z/OS V6.0 Problem Determination Guide GC34-6600-00 MQ for z/OS V6.0 Program Directory GI10-2584-00 MQ for z/OS V6.0 System Administration Guide SC34-6585-00 MQ for z/OS V6.0 System Setup Guide SC34-6583-00

URLs

Amunt! Top Amunt!

MQ Support page
MQ Library
MQ Support packs
MQ Performance Reports - MP1D (5.3) & MP1E (6.0)
Sizing WebSphere MQ for z/OS CF structures
REXX utility for MQ on z/OS administration
I think you might need to run WAS on z/OS to get LTPA to work. url url url url
Pruebas de Put() y Get() con programas ejemplo : están en MQM.SCSQPROC(CSQ4BVJR).
Use of HiperSockets between WebSphere MQ on z/OS and WebSphere MQ on z/Linux
z/OS MQ v6v manuals

Valid HTML 4.01!   Valid CSS!
Updated 20240621