IBM InfoSphere Replication Server IBM InfoSphere Data .

Transcription

IBM InfoSphere Replication ServerIBM InfoSphere Data Event Publisher Version 9.7Référence du programme ASNCLP pour la réplication et la publicationd’événementsSC19-1018-04

IBM InfoSphere Replication ServerIBM InfoSphere Data Event Publisher Version 9.7Référence du programme ASNCLP pour la réplication et la publicationd’événementsSC19-1018-04

ImportantAvant d’utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant dans«Remarques», à la page 317.Quatrième édition - juillet 2009Réf. US : SC19-1018-04LE PRESENT DOCUMENT EST LIVRE EN L’ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBMDECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DECONTREFACON AINSI QU’EN CAS DE DEFAUT D’APTITUDE A L’EXECUTION D’UN TRAVAIL DONNE.Ce document est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. Les informations qui ysont fournies sont susceptibles d’être modifiées avant que les produits décrits ne deviennent eux-mêmesdisponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ouservices non annoncés dans ce pays. Cela ne signifie cependant pas qu’ils y seront annoncés.Pour plus de détails, pour toute demande d’ordre technique, ou pour obtenir des exemplaires de documents IBM,référez-vous aux documents d’annonce disponibles dans votre pays, ou adressez-vous à votre partenairecommercial.Vous pouvez également consulter les serveurs Internet suivants :v http://www.fr.ibm.com (serveur IBM en France)v http://www.can.ibm.com (serveur IBM au Canada)v http://www.ibm.com (serveur IBM aux Etats-Unis)Compagnie IBM FranceDirection QualitéTour Descartes92066 Paris-La Défense Cedex 50 Copyright IBM France 2009. Tous droits réservés. Copyright International Business Machines Corporation 2004, 2009.

Table des matièresAvis aux lecteurs canadiens . . . . . viiChapitre 1. Démarrage avec leprogramme ASNCLP . . . . . . . . . 1Systèmes d’exploitation pris en charge . . . . . .Configuration d’un environnement Java pourexécuter le programme ASNCLP. . . . . . . .Liaison de packages z/OS pour le programmeASNCLP. . . . . . . . . . . . . . . .Exécution des commandes ASNCLP en modeinteractif . . . . . . . . . . . . . . . .Exécution de commandes ASNCLP en moded’exécution immédiate . . . . . . . . . . .Exécution des commandes ASNCLP via un fichier enentrée. . . . . . . . . . . . . . . . .Fichier de configuration ASNCLP . . . . . . .1123344Chapitre 2. Commandes ASNCLP pour laréplication SQL . . . . . . . . . . . 7Exemple de scripts ASNCLP pour configurer uneréplication SQL . . . . . . . . . . . .Commande ALTER MEMBER ADD COLS . . .Commande ALTER REGISTRATION . . . . .Commande ALTER SUBSCRIPTION SET . . .Commande ASNCLP SESSION SET TO (réplicationSQL) . . . . . . . . . . . . . . .Commande CREATE CONTROL TABLES FOR(réplication SQL) . . . . . . . . . . .Commande CREATE MEMBER. . . . . . .Commande CREATE REGISTRATION . . . .Commande CREATE STMT . . . . . . . .Commande CREATE SUBSCRIPTION SET . . .Commande DROP CONTROL TABLES ON . .Commande DROP MEMBER . . . . . . .Commande DROP REGISTRATION . . . . .Commande DROP STMT . . . . . . . . .Commande DROP SUBSCRIPTION SET . . . .Commande OFFLINE LOAD . . . . . . .Commande PROMOTE REGISTRATION . . .Commande PROMOTE SUBSCRIPTION SET . .Commande SET CAPTURE SCHEMA (réplicationSQL) . . . . . . . . . . . . . . .Commande SET DROP (réplication SQL) . . .Commande SET LOG . . . . . . . . . .Commande SET OUTPUT (réplication SQL) . .Commande SET PROFILE (réplication SQL) . .Commande SET RUN SCRIPT (réplication SQL) .Commande SET SERVER (réplication SQL) . . .Commande SET TRACE . . . . . . . . . 8. 12. 13. 16. itre 3. Exemples de scriptsASNCLP pour la réplication Q . . . . . 65Exemple de scripts ASNCLP pour configurer uneréplication Q unidirectionnelle . . . . . . . Copyright IBM Corp. 2004, 2009. 65Exemples de scripts ASNCLP permettant deconfigurer la réplication Q unidirectionnelle à partird’une source de données classique. . . . . . .Exemples de scripts ASNCLP permettant deconfigurer la réplication Q bidirectionnelle . . . .Exemple de scripts ASNCLP pour configurer uneréplication Q entre homologues (deux serveurs) . .Exemples de scripts ASNCLP pour configurer uneréplication Q entre homologues (trois serveurs) . .Exemple de script ASNCLP pour la promotion desconfigurations unidirectionnelles . . . . . . .Exemple de scripts ASNCLP pour la promotion desconfigurations entre homologues . . . . . . .697379859293Chapitre 4. Commandes ASNCLP pourla réplication Q unidirectionnelle . . . 97Commande ALTER ADD COLUMN . . . . .Commande ALTER CAPTURE PARAMETERS(réplication Classic) . . . . . . . . . .Commande ALTER CONFIGURATION APPLY .Commande ALTER REPLQMAP . . . . . .Commande ALTER QSUB (réplicationunidirectionnelle) . . . . . . . . . . .Commande ASNCLP SESSION SET TO . . .Commande CREATE CONTROL TABLES FOR .Commande CREATE REPLQMAP . . . . .Commande CREATE QSUB (réplicationunidirectionnelle) . . . . . . . . . . .Commande DROP CONTROL TABLES ON . .Commande DROP REPLQMAP . . . . . .commande DROP QSUB (réplication Qunidirectionnelle) . . . . . . . . . . .Commande LIST QSUB (réplication Q) . . . .Commande LIST APPLY SCHEMA . . . . .Commande LIST CAPTURE SCHEMA . . . .Commande LIST REPLQMAP (réplication Q). .Commande LOAD DONE . . . . . . . .Commande PROMOTE QSUB . . . . . . .Commande PROMOTE REPLQMAP . . . .Commande SET APPLY SCHEMA . . . . .Commande SET CAPTURE SCHEMA . . . .Commande SET DROP (réplicationunidirectionnelle) . . . . . . . . . . .Commande SET LOG . . . . . . . . .Commande SET OUTPUT . . . . . . . .Commande SET PROFILE . . . . . . . .Commande SET QMANAGER . . . . . .Commande SET RUN SCRIPT. . . . . . .Commande SET SERVER . . . . . . . .Commande SET TRACE. . . . . . . . .Commande SHOW SET ENV . . . . . . .Commande START QSUB . . . . . . . .Commande STOP QSUB. . . . . . . . .commande VALIDATE WSMQ ENVIRONMENTFOR . . . . . . . . . . . . . . . 98. 100. 101. 101.104108109115. 117. 133. 153157160160161162. 163iii

Commande VALIDATE WSMQ MESSAGE FLOWFOR REPLQMAP . . . . . . . . . . . . 165Commande VALIDATE WSMQ MESSAGE FLOWFOR REPLQMAP . . . . . . . . . . . . 224Chapitre 5. Commandes ASNCLP pourla réplication Q multidirectionnelle . . 167Chapitre 6. Commandes ASNCLP pourla publication d’événements . . . . . 227Commande ALTER REPLQMAP . . . . . . .Commande ALTER QSUB (réplicationbidirectionnelle) . . . . . . . . . . . .commande ALTER QSUB (réplication entrehomologues) . . . . . . . . . . . . .Commande ASNCLP SESSION SET TO . . . .Commande CREATE CONTROL TABLES FOR . .Commande CREATE REPLQMAP . . . . . .Commande CREATE QSUB (réplicationbidirectionnelle) . . . . . . . . . . . .commande CREATE QSUB (réplication entrehomologues) . . . . . . . . . . . . .Commande DROP CONTROL TABLES ON . . .Commande DROP REPLQMAP . . . . . . .Commande DROP SUBGROUP (réplication Qmultidirectionnelle) . . . . . . . . . . .Commande DROP SUBTYPE (réplicationbidirectionnelle) . . . . . . . . . . . .Commande DROP SUBTYPE (réplication entrehomologues) . . . . . . . . . . . . .Commande LIST APPLY SCHEMA . . . . . .Commande LIST CAPTURE SCHEMA . . . . .Commande LOAD DONE . . . . . . . . .Commande LOAD MULTIDIR REPL SCRIPT(réplication Q multidirectionnelle) . . . . . .Commande PROMOTE QSUB . . . . . . . .Commande PROMOTE REPLQMAP . . . . .Commande SET APPLY SCHEMA . . . . . .Commande SET BIDI NODE . . . . . . . .Commande SET CAPTURE SCHEMA . . . . .Commande SET CONNECTION (réplication Qmultidirectionnelle) . . . . . . . . . . .Commande SET ENFORCE MATCHINGCONSTRAINTS (réplication Q multidirectionnelle) .Commande SET LOG . . . . . . . . . .commande SET MULTIDIR SCHEMA (réplicationQ multidirectionnelle) . . . . . . . . . .Commande SET OUTPUT (réplication Qmultidirectionnelle) . . . . . . . . . . .Commande SET PEER NODE . . . . . . . .Commande SET PROFILE . . . . . . . . .Commande SET QMANAGER . . . . . . .Commande SET REFERENCE TABLE (réplicationQ multidirectionnelle) . . . . . . . . . .Commande SET SERVER (réplication Qmultidirectionnelle) . . . . . . . . . . .commande SET SUBGROUP (réplication Qmultidirectionnelle) . . . . . . . . . . .Commande SET TABLES (réplication Qmultidirectionnelle) . . . . . . . . . . .Commande SET TRACE. . . . . . . . . .Commande SHOW SET ENV . . . . . . . .Commande START QSUB . . . . . . . . .Commande STOP QSUB. . . . . . . . . .commande VALIDATE WSMQ ENVIRONMENTFOR . . . . . . . . . . . . . . . .Exemples de scripts ASNCLP pour configurer lapublication d’événements . . . . . . . .Commande ALTER ADD COLUMN . . . . .commande ALTER PUB . . . . . . . . .Commande ALTER PUBQMAP . . . . . .Commande ASNCLP SESSION SET TO . . .Commande CREATE CONTROL TABLES FOR .commande CREATE PUB . . . . . . . .Commande CREATE PUBQMAP . . . . . .Commande DROP CONTROL TABLES ON . .Commande DROP PUB . . . . . . . . .Commande DROP PUBQMAP . . . . . .Commande LIST CAPTURE SCHEMA . . . .Commande LIST PUBS . . . . . . . . .commande LIST PUBQMAPS . . . . . . .Commande PROMOTE PUB . . . . . . .Commande PROMOTE PUBQMAP . . . . .Commande SET CAPTURE SCHEMA . . . .Commande SET LOG . . . . . . . . .Commande SET OUTPUT . . . . . . . .Commande SET QMANAGER . . . . . .Commande SET RUN SCRIPT. . . . . . .Commande SET SERVER (publicationd’événements) . . . . . . . . . . . .Commande SET TRACE. . . . . . . . .commande START PUB . . . . . . . . .Commande STOP PUB . . . . . . . . .commande VALIDATE WSMQ ENVIRONMENTFOR . . . . . . . . . . . . . . 0251251252253255256257258259259260.264266267267. 268Chapitre 7. Commandes ASNCLP dumoniteur d’alertes de réplication . . . 271Exemples de scripts ASNCLP pour configurer lemoniteur d’alertes de réplication . . . . . .Commande ALTER ALERT CONDITIONS FORAPPLY . . . . . . . . . . . . . .Commande ALTER ALERT CONDITIONS FORCAPTURE . . . . . . . . . . . . .Commande ALTER ALERT CONDITIONS FORQAPPLY . . . . . . . . . . . . . .Commande ALTER ALERT CONDITIONS FORQCAPTURE . . . . . . . . . . . . .Commande ALTER CONTACT . . . . . .Commande ALTER GROUP . . . . . . .Commande ALTER MONITOR SUSPENSION .Commande ALTER MONITOR SUSPENSIONTEMPLATE . . . . . . . . . . . . .Commande CREATE ALERT CONDITIONS FORAPPLY . . . . . . . . . . . . . .Commande CREATE ALERT CONDITIONS FORCAPTURE . . . . . . . . . . . . .Commande CREATE ALERT CONDITIONS FORQAPPLY . . . . . . . . . . . . . .Commande CREATE ALERT CONDITIONS FORQCAPTURE . . . . . . . . . . . . . 272. 275. 278. 281.283285286287. 288. 289. 291. 293. 295IBM InfoSphere Replication Server - Référence du programme ASNCLP pour la réplication et la publication d’événements

Commande CREATE CONTACT . . . . .Commande CREATE CONTROL TABLES FORCommande CREATE GROUP . . . . . .Commande CREATE MONITOR SUSPENSIONCommande CREATE MONITOR SUSPENSIONTEMPLATE . . . . . . . . . . . .Commande DELEGATE CONTACT . . . .Commande DROP ALERT CONDITIONS FORAPPLY . . . . . . . . . . . . .Commande DROP ALERT CONDITIONS FORCAPTURE . . . . . . . . . . . .Commande DROP ALERT CONDITIONS FORQAPPLY . . . . . . . . . . . . .Commande DROP ALERT CONDITIONS FORQCAPTURE . . . . . . . . . . . .Commande DROP CONTACT . . . . . .Commande DROP GROUP . . . . . . .Commande DROP MONITOR SUSPENSION .Commande DROP MONITOR SUSPENSIONTEMPLATE . . . . . . . . . . . . 297. 297. 300300. 302. 303. 303. 304. 304. 307304306306307Commande LIST MONITOR SUSPENSIONCommande LIST MONITOR SUSPENSIONTEMPLATE . . . . . . . . . . .Commande SET OUTPUT . . . . . .Commande SET SERVER . . . . . .Commande SUBSTITUTE CONTACT . . 307.308308309310Documentation du produit . . . . . . 311Contacter IBM .Lecture des diagrammes de syntaxe. 311313Accessibilité du produit . . . . . . . 315Remarques . . . . . . . . . . . . 317Marques . 320Index . . . . . . . . . . . . . . . 321Table des matièresv

viIBM InfoSphere Replication Server - Référence du programme ASNCLP pour la réplication et la publication d’événements

Avis aux lecteurs canadiensLe présent document a été traduit en France. Voici les principales différences etparticularités dont vous devez tenir compte.IllustrationsLes illustrations sont fournies à titre d’exemple. Certaines peuvent contenir desdonnées propres à la France.TerminologieLa terminologie des titres IBM peut différer d’un pays à l’autre. Reportez-vous autableau ci-dessous, au besoin.IBM FranceIBM Canadaingénieur commercialreprésentantagence commercialesuccursaleingénieur en du matérielClaviersLes lettres sont disposées différemment : le clavier français est de type AZERTY, etle clavier français-canadien de type QWERTY.OS/2 et Windows - Paramètres canadiensAu Canada, on utilise :v les pages de codes 850 (multilingue) et 863 (français-canadien),v le code pays 002,v le code clavier CF.NomenclatureLes touches présentées dans le tableau d’équivalence suivant sont libelléesdifféremment selon qu’il s’agit du clavier de la France, du clavier du Canada oudu clavier des États-Unis. Reportez-vous à ce tableau pour faire correspondre lestouches françaises figurant dans le présent document aux touches de votre clavier. Copyright IBM Corp. 2004, 2009vii

BrevetsIl est possible qu’IBM détienne des brevets ou qu’elle ait déposé des demandes debrevets portant sur certains sujets abordés dans ce document. Le fait qu’IBM vousfournisse le présent document ne signifie pas qu’elle vous accorde un permisd’utilisation de ces brevets. Vous pouvez envoyer, par écrit, vos demandes derenseignements relatives aux permis d’utilisation au directeur général des relationscommerciales d’IBM, 3600 Steeles Avenue East, Markham, Ontario, L3R 9Z7.Assistance téléphoniqueSi vous avez besoin d’assistance ou si vous voulez commander du matériel, deslogiciels et des publications IBM, contactez IBM direct au 1 800 465-1234.viiiIBM InfoSphere Replication Server - Référence du programme ASNCLP pour la réplication et la publication d’événements

Chapitre 1. Démarrage avec le programme ASNCLPLes programmes de réplication enregistrent des informations sur vosconfigurations dans des tables de contrôle. Les commandes ASNCLP créent,modifient et suppriment ces informations.Par exemple, le programme ASNCLP fournit une commande permettant de créerun abonnement Q. Dans la réplication Q, la sortie d’une commande est un scriptSQL insérant dans les tables de contrôle les informations relatives à la source, lacible, les files d’attentes et les autres options.Chaque commande ASNCLP fonctionne avec uniquement un sous-ensembled’informations. Vous pouvez utiliser plusieurs commandes ensembles afin degénérer le SQL pour une configuration entière.Avant d’exécuter le programme ASNCLP, vous devez configurer votreenvironnement. Une fois votre environnement configuré, vous devrez avoir desconnaissances de base sur l’utilisation du programme ASNCLP.Certaines commandes ne sont disponibles que pour des types de configuration deréplication ou de publication spécifiques.Systèmes d’exploitation pris en chargeLe programme ASNCLP s’exécute sous Linux , UNIX , Windows et UNIX SystemServices (USS) on z/OS. Le programme ASNCLP ne fonctionne pas nativementsous z/OS ou System i.Les commandes ASNCLP génèrent des définitions de réplication pour tous lesenvironnements de systèmes d’exploitation pris en charge par les produits deréplication : z/OS, System i (SQL replication only), Linux, UNIX, etWindows. Vousdevez disposer d’une connectivité avec chaque serveur pour lequel vous générezdes définitions de réplication. Vous devez donc être en mesure d’émettre uneinstruction de connexion de base de données vers chacun des serveurs.Remarque : Des étapes de configuration supplémentaires sont obligatoires pourpermettre à ASNCLP de s’exécuter dans USS. Pour plus de détails, voir la rubriqueFacultatif : Pour que le programme ASNCLP s’exécute dans USS du centre dedocumentation des solutions Information Management Software for z/OS.Restriction : Le programme ASNCLP ne prend pas en charge z/VM ou VSE cardans ces environnements de systèmes d’exploitation, DB2 ne prend pas en chargel’architecture de réplication pour DB2 version 8 et ultérieure.Configuration d’un environnement Java pour exécuter le programmeASNCLPLe programme ASNCLP s’exécute dans un environnement Java . Votre variabled’environnement PATH doit contenir un chemin d’accès vers un environnementd’exécution Java afin d’exécuter ASNCLP. Copyright IBM Corp. 2004, 20091

Utilisez la procédure suivante si l’environnement PATH ne contient pas de chemind’accès vers un environnement d’exécution Java.ProcédureAjoutez le chemin d’accès suivant à votre variable d’environnement PATH :INSTDIR\java\jdkOù INSTDIR est le répertoire d’instance DB2. Sous Linux et UNIX, le répertoired’instance est le répertoire INSTDIR/sqllib, où INSTDIR est le répertoire de basedu propriétaire d’instance. Sous Windows, le répertoire d’instance est le répertoire\sqllib où DB2 a été installé.Pour tous les produits DB2, excepté IBM Data Server Runtime Client, le processusd’installation de DB2 Database pour Linux, UNIX et Windows installeautomatiquement le kit de développement de logiciels pour Java. Si vous devezinstaller le kit de développement de logiciels, accédez à la page ″IBM developerkits″ du site Web IBM developerWorks : tmlExemplesPour définir la variable d’environnement PATH à partir d’uneinvite de commande UNIX :exportCLASSPATH PATH:/u/myinst/sqllib/java/jdk;Pour définir la variable d’environnement PATH à partir d’uneinvite de commande Windows :set CLASSPATH %PATH%;%c:\Program File\sqllib\java\jdk;Liaison de packages z/OS pour le programme ASNCLPAvant d’utiliser le programme ASNCLP avec DB2 pour z/OS, vous devez d’abordlier les packages DRDA et CLI de base au sous-système DB2 avec lequel vouscomptez travailler.Avant de commencerAvant de lier les packages z/OS vous devez d’abord vous connecter ausous-système DB2 sur le serveur z/OS.ProcédurePour lier les packages z/OS de base pour le programme ASNCLP, ouvrez uneinvite de commande de système d’exploitation et entrez la commande suivante :bind @ddcsmvs.lst blocking all sqlerror continuedb2 bind @db2cli.lst isolation ur blocking all2IBM InfoSphere Replication Server - Référence du programme ASNCLP pour la réplication et la publication d’événements

Si vous n’effectuez pas cette liaison, la première fois que vous utilisez leprogramme ASNCLP avec un serveur DB2 pour z/OS, le programme risque devous renvoyer le message d’erreur suivant :ASN1560EL'action de réplication s'est terminée avec une erreur.Une erreur SQL a été rencontrée.Message SQL : "[IBM][CLI Driver][DB2] SQL0805N Le package"nom package" est introuvable. SQLSTATE 51002Exécution des commandes ASNCLP en mode interactifVous pouvez exécuter les commandes ASNCLP en mode interactif à partir d’uneinvite de commande.ProcédurePour exécuter les commandes ASNCLP en mode interactif :1. Ouvrez une invite de commande du système d’exploitation et lancez lacommande suivante :ASNCLPLa commande ASNCLP démarre le programme ASNCLP et modifie l’invite decommande en Repl .2. Exécutez l’une des commandes ASNCLP. Par exemple : pour définir le serveurQ Capture pour la base de données nomalias, exécutez la commande suivante :SET SERVER CAPTURE TO DBALIAS nomalias3. Pour quitter le programme ASNCLP, entrez la commande suivante :quitPour obtenir de l’aide sur le programme ASNCLP, entrez la commande suivante àpartir d’une invite de commande du système d’exploitation :ASNCLP ?Exécution de commandes ASNCLP en mode d’exécution immédiateLe mode d’exécution immédiate est utile lorsque vous d

IBM InfoSphere Replication Server IBM InfoSphere Data Event Publisher Référence du programme ASNCLP pour la réplication et la publication d’événements Version 9.7 SC19-1018-04. Important Avant d’utiliser le présent