Mémento des commandes MQSERIES

 

Commandes MQSERIES

 

Explications notions, abréviations   :

 

FA (Queue) : File d’attente (FA système…)

GFA (Queue manager) : Gestionnaire de File d’attente

QLOCAL : queue locale

QREMOTE : queue distante

QALIAS : redéfinition nom de la queue.

CHANNEL : canal d’émission et/ou de réception entre 2 machines (une FA de chaque côté).

SDR : sender (émetteur)

RCVR : recever (récepteur)

RETRYING : le message ne passe pas (problème de communication)

 

Les commandes mqseries :

Sur la plupart des machines se loguer « mqm ».

 

Visualiser les files d’attentes ou gestionnaire de FA (GFA) avec leur état (status) : dspmq

Création de la Queue Manager (création GFA) : crtmqm –ll queue_manager

Suppression de la Queue Manager       : dltmqm queue_manager

Démarrer la Queue Manager               : strmqm queue_manager

Arrêter la Queue Manager                   : endmqm queue_manager

Démarrer le serveur de commande       : strmqcsv queue_manager

Visualiser que la création des F.A. peut s’exécuter sans erreur : runmqsc –v queue_manager

(simule l’exécution des commandes).

Exemple : runmqsc –v PAINTIR14 < ebasiliq.cfg 2>&1 | tee -a /prog/mqm/trace1.log

Passer en mode commande (lancement création file d’attente …) : runmqsc queue_manager

Exemples : a) runmqsc PAINTIR14

b) runmqsc PAINTSR1 < MQSReggae_PAINT.cfg > MQSReggae_PAINT.log

 

Commandes (en « mode commande ») :

 

Affichage des statuts _ RETRYING, STOPPED … _ des canaux (« channel ») : dis ch(*)

Arrêt du canal (de la queue de nom « queue ») : stop CHANNEL (queue)

Démarrage du canal (de la queue)                               : start CHANNEL (queue)

Réinitialisation du canal (de la queue)               : reset CHANNEL

Destruction du canal (de la queue)                               : delete CHANNEL (queue)

Création du canal (de la queue)                                   :

define CHANNEL (queue) chltype (type) replace tcptype(type) conname(‘@IP(prt)’) \

[cluster(nom_cluster)] descr(‘hqeqrnt)

Sortie du mode commande                                          : end

 


Diagnostique dans le cas d’un canal en RETRYING

 

1/ La configuration du canal et des queues est correcte des 2 côtés ? :

VERICATION des *.cfg

 

Pour un canal en SDR

1/ vérification du nom de la file émettrice

2/ vérification du nom de la file distante

3/ vérification du nom du canal (généralement queue_manager_SDR.queue_manager _RCVR)

4/ vérification du port

5/ vérification de l’adresse IP

 

       : *******************************************************************

       : *** Definition des files

       : *******************************************************************

       : *** File de transmission avec l'application cliente

DEFINE QLOCAL('DFSD6E011') +                                                                                 1/

       :   REPLACE +

       :   USAGE(XMITQ) +

       :   SHARE PUT(ENABLED) +

       :   DEFPSIST(YES)  

 

       : *** File d'emission, liee a la file de transmission

DEFINE QREMOTE('UMIBLOC.OUT.RQ') +

       :   REPLACE +

       :   RNAME('BAS.IR.UMIBLOC.IN') +                                                                      2/

       :   RQMNAME('DFSD6E011') +

       :   XMITQ('DFSD6E011') +

       :   PUT(ENABLED) +

       :   DEFPSIST(YES)  

       :

       : *********************************************************************

       : **** Definition des canaux

       : *********************************************************************

       : *** Canal d'emission, lie a la file de transmission

DEFINE CHANNEL ('PAINTIR14.DFSD6E011') +                                                        3/

       :   CHLTYPE(SDR) +

       :   TRPTYPE(TCP) +

       :   XMITQ('DFSD6E011') +

       :   DISCINT(0) +

       :   CONNAME('10.170.65.41(1417)')                                                                         4/ et 5/

 

Pour un canal en RCVR

1/ vérification du nom de la file réceptrice (nom de la file.Q)

2/ vérification du nom du canal (généralement Gestionnaire_file_attente_SDR. Gestionnaire_file_attente_RCVR)

 

       : *******************************************************************

       : *** Definition des files

       : *******************************************************************

       : *** File locale de réception

DEFINE QLOCAL('BAS.IR.UMIBLOC.IN.Q') REPLACE +                                         1/

           DESCR('File en entree pour IRONMAN') +

           DEFPSIST(YES) +

           DEFSOPT(SHARED) +

           MAXDEPTH(600000)

 

       : *** File alias locale de réception (FACULTATIF)

DEFINE QALIAS('BAS.IR.UMIBLOC.IN') REPLACE  +

           DESCR('alias sur BAS.IR.UMIBLOC.IN.Q') +

           DEFPSIST(YES) +

           TARGQ('BAS.IR.UMIBLOC.IN.Q')

 

       : *********************************************************************

       : **** Definition des canaux

       : *********************************************************************

       : *** Canal de réception, lie a la file de réception

DEFINE CHANNEL ('PAINTIR14.DFSD6E011') CHLTYPE(RCVR) REPLACE        2/

 

Pour le canal distant, si la machine n’appartient pas au périmètre GAETE, téléphoner à la personne responsable et lui demander sa configuration

 

2/ Le listner est-il démarré ? (seulement pour les canaux en RCVR)

Pré requis :     la configuration du canal des queues est correcte des 2 côtés

 

1/ vérification du fichier etc/services

MQSeries        1414/tcp        #Programm d'ecoute des canaux MQSeries

 

2/ vérification etc/inetd.conf

MQSeries        stream tcp nowait mqm /opt/mqm/bin/amqcrsta amqcrsta  -m DFSD6E011

 

3/ Démarrage – synchronisation ?

Pré requis :     la configuration du canal et des queues est correcte des 2 côtés

                        le listner est lancé

 

3.1/ Dans le cas d’une création d’un nouveau canal

Sur les 2 machines, effectuer les opérations suivantes

1/ runmqsc queue_manager  

2/ stop channel(canal)

3/ start channel(canal)

 

runmqsc PAINTIR14

stop channel(PAINTIR14.DFSD6E011)

start channel(PAINTIR14.DFSD6E011)

 

runmqsc .DFSD6E011

stop channel(PAINTIR14.DFSD6E011)

start channel(PAINTIR14.DFSD6E011)

 

3.2/ Dans le cas d’un canal existant (cas de désynchronisation)

Sur les 2 machines, effectuer les opérations suivantes

1/ runmqsc queue_manager

2/ stop channel(canal)

3/ reset channel(canal)

4/ start channel(canal)

 

runmqsc PAINTIR14

stop channel(PAINTIR14.DFSD6E011)

reset channel(PAINTIR14.DFSD6E011)

start channel(PAINTIR14.DFSD6E011)

 

runmqsc .DFSD6E011

stop channel(PAINTIR14.DFSD6E011)

reset channel(PAINTIR14.DFSD6E011)

start channel(PAINTIR14.DFSD6E011)