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 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 Manipulation des en-têtes (en plus de MQMD) Oui RFH seulement Limitée 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). Dépôt de messages Consommation de requêtes et envoi de réponses Consommation simple ou avec statistique Manipulation des en-têtes Par ligne de commande Serveur Unix ou Windows avec MQ serveur ou client Serveur Unix ou Windows avec MQ serveur uniquement Serveur Unix ou Windows avec MQ serveur uniquement Serveur Unix ou Windows avec MQ serveur ou client Compilation à faire Oui sauf AIX, Solaris et Windows non Version d MQ Version du Broker (si le broker doit être testé) Par GUI Poste Windows et client MQ Fait avec la v6, devrait fonctionner àpartir de la v5.2, voire v5.1 avec CS 4 Fait pour la v6, devrait fonctionner àpartir de la v5, voire des versions antérieures

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 MQReply V1.01 program start (C) Copyright IBM Corp, 2001/2002/2005 Reading parameters from file mqcap1parms.txt Reading messages from Queue(LOCALE) on Qmgr(TIC) 32 bytes read from reply data file reply.out connecting to queue manager TIC opening queue LOCALE for input Reply sent to queue LOCALE on queue manager TIC Message type is not a request message -message not processed - type=2 Message type is not a request message -message not processed - type=2 [ ] Message type is not a request message -message not processed - type=2 Message type is not a request message -message not 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 lesmessages 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 120secs 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é Un ou plusieurs messages File Message 1 Message 2 Un message Données seulement Buffer RFH Choix des en-têtes Données et en-têtes Fichier Message 1 Message 2 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é Un ou plusieurs messages File Message 1 Message 2 Un message Données seulement Buffer RFH Choix des en-têtes Données et en-têtes Fichier Message 1 Message 2 Un message Données et en-têtes Vision interface graphique