IH03 ou RFHUTIL - GUIDE Share France – Groupe de travail

IH03 ou RFHUTIL
Sommaire
• IH03 ou RFHUTIL, définition
• 2 Interfaces, leurs fonctionnalités
• Les pré-requis
• Les commandes manuelles
• L’interface graphique
IH03 ou RFHUTIL
Est un support-pack d’IBM destiné au départ à tester le
broker, mais dont les fonctionnalités peuvent également
être intéressantes en dehors du Broker. RFHUTIL est
constitué d’un ensemble d’utilitaires C de
•tests de performance : poster des messages, des
réponses, consommer des messages, tout en mesurant
les performances
•manipulation de plusieurs en-têtes dont RFH (pour le
broker) et DLQ
•qui permet de transposer des messages entre des files
d’attente et des fichiers, dans les 2 sens
Deux interfaces
Rfhutil offre des utilitaires à lancer en ligne de commande, et une interface
graphique pour le poste de travail Windows.
Le tableau suivant présente la prise en charge des différentes fonctionnalités de
RFHUTIL par ces 2 interfaces.
Fonctionnalité
Par ligne de commande
Par GUI
Dépôt de messages
Oui
Oui
Consommation de
requêtes et envoi de
réponses
Oui
Non
Consommation simple
Oui
Oui
Consommation avec
statistiques
Oui
Limitée
Manipulation des en-têtes
(en plus de MQMD)
RFH seulement
RFH CICS IMS DLQ et qqu
autres
Pré-requis
Toutes les fonctionnalités ne nécessitent pas les mêmes pré-requis en
termes d’OS et de composant MQ (client ou serveur).
Par ligne de commande
Par GUI
Dépôt de messages
Serveur Unix ou Windows avec MQ
serveur ou client
Consommation de requêtes
et envoi de réponses
Serveur Unix ou Windows avec MQ
serveur uniquement
Consommation simple ou
avec statistique
Serveur Unix ou Windows avec MQ
serveur uniquement
Manipulation des en-têtes
Serveur Unix ou Windows avec MQ
serveur ou client
Compilation à faire
Oui sauf AIX, Solaris et Windows
Version d’MQ
Fait avec la v6, devrait fonctionner à partir de la
v5.2, voire v5.1 avec CS 4
Version du Broker (si le
broker doit être testé)
Fait pour la v6, devrait fonctionner à partir de la
v5, voire des versions antérieures
Poste
Windows
et client
MQ
non
Les commandes manuelles - 1
Les commandes passées en ligne de commande
n’ont pas été utilisées à la Banque de France.
Ce chapitre présente un résumé des différentes
commandes et de leur syntaxe.
Pour plus de détails consulter la documentation
fournie avec le support-pack.
Les commandes manuelles – 2
Déposer des messages
Dépôt de messages
3 utilitaires suivant que le PUT est effectué
• sur une file locale située sur le serveur, à partir
du serveur : mqput2
• sur une file locale située sur le serveur, à partir
d’un client : mqsputsc
• Sur une file éloignée, à partir d’un serveur :
mqsputs
Ces trois commandes ont une syntaxe similaire
Les commandes manuelles – 3
Déposer des messages
• Syntaxe :
commande –f fichier de paramètres
D’autres options facultatives peuvent être ajoutées. Elles écrasent
alors les options de même nature qui peuvent se trouver dans le
fichier de paramètres.
Le fichier de paramètre est composé de 2 sections, une section
[header] et une section [filelist].
[header] contient des options, dont les principales sont le nom de la
file et le nom du QMGR où les messages doivent être déposés, le
nombre de fois ou chaque message doit être déposé, des options
qui permettent de réguler le flux des messages à déposer suivant la
profondeur de la file, le type de message...
[filelist] contient la liste des fichiers, un message sera généré à partir
de chaque fichier autant de fois que spécifié dans la section
[header]
Les commandes manuelles - 4
Déposer des messages
$ mqput2 -f mqputparms.txt
mqput2.c V1.6.3 Release version (Jun 19 2007 17:37:32)
Copyright (c) IBM Corp., 2001/2002/2003/2004/2005/2006
32 bytes read from data file monmessage
Total files read 1
Total messages found 1
100 messages to be written to queue LOCALE on queue
manager TIC
minimum queue depth 50 max 100 batchsize 0
initial sleep time 10 tune = 0
connecting to queue manager TIC
opening queue LOCALE for output
First message written at Wed May 5 17:20:39 2010
MQ Timestamp of first message written at 15:20:39
number on queue after sleep - min 0, max 0
Last message written at Wed May 5 17:20:39 2010
MQ timestamp of last message written at 15:20:39
Total messages written 100 out of 100
Total elapsed time in seconds 0. 7546
Total bytes written 3200
Total memory used 345
closing the queue
closing the inquiry queue
disconnecting from the queue manager
MQPUT2 program ended
$ cat mqputparms.txt
[header]
qname=LOCALE
qmgr=TIC
msgcount=100
qdepth=50
qmax=100
[filelist]
monmessage
Les commandes manuelles – 5
Lire des requêtes et poster des réponses
• Syntaxe :
mqreply -f fichier de paramètres -r fichier de données –l 0 ou 1
–t temps en millisecondes –m nom QM –q nom Q –s
Seules les options soulignées sont obligatoires
• Le fichier de paramètres ne contient pas de section [filelist]
pour cet utilitaire, c’est le fichier de données qui est utilisé
pour le message de réponse
• L’option –l signifie « latency » et positionne la mesure du
temps de séjour dans la file de chaque message
• L’option –t positionne un temps d’attente entre le
traitement de 2 requêtes
• -s pour silencieux, seuls les messsages d’erreur sont
affichés
Les commandes manuelles – 6
Lire des requêtes et poster des réponses
$ mqreply -f mqcap1parms.txt -r reply.out
Reply sent to queue LOCALE on queue manager TIC
MQReply V1.01 program start
Message type is not a request message - message not
processed - type=2
(C) Copyright IBM Corp, 2001/2002/2005
Message type is not a request message - message not
Reading parameters from file mqcap1parms.txt
processed - type=2
Reading messages from Queue(LOCALE) on Qmgr(TIC)
[…]
Message type is not a request message - message not
32 bytes read from reply data file reply.out
processed - type=2
connecting to queue manager TIC
Message type is not a request message - message not
opening queue LOCALE for input
processed - type=2
opening reply queue LOCALE
Reply sent to queue LOCALE on queue manager TIC
Reply sent to queue LOCALE on queue manager TIC
[…]
Reply sent to queue LOCALE on queue manager TIC
^Clogout
$ cat mqcapparms.txt
[header]
qname=LOCALE
qmgr=TIC
msgcount=10
Les commandes manuelles – 7
Consommation simple – les utilitaires de capture
2 utilitaires, mqcapture et mqcapone (comprendre « capture one ») permettent
de lire des message et de les écrire dans un fichier.
Syntaxe :
Commande –f fichier de paramètres –o fichier d’écriture -l 0 ou 1 –m nom QM –q
nom Q -r -d
Seules les options soulignées sont obligatoires
Comme pour mqreply,le fichier de paramètres ne contient pas de section filelist.
Le fichier d ’écriture est celui ou le contenu des message est écrit. Les messages
sont séparés par une chaîne de caractères, par défaut « #@#@# », qui peut
être positionnée dans le fichier de paramètres.
• -l positionne la lecture par ordre logique des messages. Cette option
concerne seulement mqcapture.
• -d active l’inscription de l’en-tête MQMD dans le fichier de données
• -r sélectionne la lecture non destructrice des message (browse)
Les commandes manuelles – 8
Consommation simple – les utilitaires de capture
$ mqcapture -f mqcapparms.txt -o capture.out
(C) Copyright IBM Corp, 2001/2002/2003/2004
mqcapture.c V1.33 Release version (Jun 19 2007
17:37:34)
Reading parameters from file mqcapparms.txt
Reading messages from Queue(LOCALE) on Qmgr(TIC)
Delimiter length is 5 value(#@#@#)
opening output file capture.out
connecting to queue manager TIC
opening queue LOCALE for input
Maximum message size that can be read is 4194304
closing the input queue
disconnecting from the queue manager
Total messages 10
total bytes in all messages 320
average message size 32
mqcapture program ended
-> capture.out contient un message, une chaîne de séparation, un message etc…
La version de capone dont je dispose semble avoir un bog (v 4.0.4)
Les commandes manuelles – 9
Consommation avec statistiques
Il existe 2 utilitaires, mqtimes et mqtimes2, qui consomment les messages d’une
file en donnant le nombre de messages qu’ils traitent par seconde.
Mqtimes2 dispose de plus d’options et est idéal pour tourner en parallèle avec
mqsput2.
Syntaxe :
mqtimes2 -c compte -q Queue -m Queue manager -t secondes -d -b nombre
msg/UO -s taille buffer -r intervalle de rapport -p fichier de données PAN -n
fichier de données NAN –l
Les options soulignées sont également valables pour mqtimes.
• -c donne le nombre de messages à lire avant de s’arrêter
• -t est le temps d’attente de message maximum, s’il est dépassé le
programme s’arrête
• -d vide la file avant de commencer la lecture
• -l « latency » positionne la mesure du temps de séjour dans la file de chaque
message
Les commandes manuelles – 10
Consommation avec statistiques
$ mqtimes2 -c 10 -q LOCALE -t 10 -m TIC
mqtimes2.c V1.31 Release version (Jun 19 2007 17:37:33) program start
(C) Copyright IBM Corp, 2001/2002/2004/2005
Timeout parameter (10) invalid or below minimum of 30 seconds
Set to default value of 120
connecting to queue manager TIC
opening queue LOCALE for input
Reading 10 messages from LOCALE on TIC with max wait time of 120 secs
142953 10 msgs
closing the input queue (LOCALE)
disconnecting from the queue manager
Total messages 10
total bytes in all messages 320
average message size 32
Total number of seconds with at least one message 1
Peak message rate 10
Les commandes manuelles – 11
Manipulation des en-têtes
Seules les en-têtes RFH (1 et 2) et MQMD peuvent
être
• manipulées, par les utilitaires de dépôt
• et capturées, par les utilitaires de capture
en positionnant les options correspondantes dans
le fichier de paramètres de chacun des
utilitaires.
L’interface graphique – 1
Lancement
• Le binaire de l’interface graphique, rfhutilc.exe, se lance après avoir
positionné la variable d’environnement MQSERVER.
Exemple dans un point bat
Set MQSERVER=MONCANAL/TCP/XX.XXX.XX.XXX(XXXX)
Start ..\rfhutilc.exe
exit
• Le user utilisé, s’il n’est pas membre de mqm, doit avoir les droits
suivants :
Droit +conn sur le Queue Manager
droits +all sur la file RFHUTIL.REPLY.QUEUE
droits +all sur la file SYSTEM.DEFAULT.MODEL
droit +put sur la file SYSTEM.ADMIN.COMMAND.QUEUE
droits conformes aux opérations voulues sur les files à accéder : get
ou/et put ou/et browse, setall ou setid le cas échéant
L’interface graphique – 2
Résumé
File
Message 1
Message 2
…
Un ou
plusieurs
messages
Choix des
en-têtes
Fichier
Message 1
Message 2
…
Un
m
es
s
ag
e
n
Do
nt
e
lem
u
se
s
e
né
Buffer RFH
Do
en nné
-tê es
te et
s
Un message Données et en-têtes
Vision interface
graphique
L’interface graphique – 3
Accès à un QM, liste des files
L’interface ci-contre
s’affiche. On
sélectionne le canal
dans le champ Queue
Manager Name.
Puis on clique sur le
bouton Load Names et
la liste des files est
disponible dans le
champ Queue Name.
On sélectionne une file
pour les opérations
suivantes.
L’interface graphique – 4
Lister les messages d’une file
Cliquer le
bouton
Display Q
L’interface graphique – 5
Browse des messages
Cliquer le bouton Start
browse soit dans
l’onglet Main, soit dans
la fenêtre Display
Queue Contents (cf
diapo précédente)
L’interface graphique – 6
Consultation des données du message
Cliquer l’onglet Data
pour consulter les
données du message.
L’interface graphique – 7
Consultation de l’en-tête MQMD
Cliquer l’onglet MQMD
pour consulter cet entête.
L’interface graphique – 8
Consultation de l’en-tête MQMD – cas d’un message
de DLQ
L’interface graphique – 9
Consultation de l’en-tête DLQH
Cliquer l’onglet DLQ
pour consulter cet entête.
L’interface graphique – 10
Lecture d’un message
Cliquer le bouton Read
Queue. Il s’agit d’un
get, un message est
consommé.
L’interface graphique – 11
Écriture d’un message
Cliquer le bouton
Write Queue. Le
contenu du buffer est
déposé dans la file. Si
vous venez de
commencer la session
RFHUTIL, il se peut que
le buffer soit vide, et
un message vide est
déposé.
Le buffer est mis à jour
lorsqu’un message est
lu en get ou browse.
Autrement dit vous
écrivez le dernier
message que vous avez
lu ou browsé.
L’interface graphique – 12
Sauvegarde de messages dans 1 ou des fichier(s)
Cliquer le bouton Save
Queue. La fenêtre
suivante s’affiche et
permet de choisir le
nom du fichier et les
options de sauvegarde.
L’interface graphique – 13
Sauvegarde de messages dans 1 ou des fichier(s)
Autre exemple. Ici on
choisit de sauvegarder
uniquement les 4000
premiers messages de
la file.
L’interface graphique – 14
Chargement de message(s) à partir d’un fichier
Cliquer le bouton Load
Queue. La fenêtre
suivante s’affiche et
permet de choisir le
nom du fichier et les
options de
chargement.
L’interface graphique – 15
Résumé
File
Message 1
Message 2
…
Un ou
plusieurs
messages
Choix des
en-têtes
Fichier
Message 1
Message 2
…
Un
m
es
s
ag
e
n
Do
nt
e
lem
u
se
s
e
né
Buffer RFH
Do
en nné
-tê es
te et
s
Un message Données et en-têtes
Vision interface
graphique