EUROTITRISATION
Langlois Jean-Baptiste Langlois
Documentation du moniteur CFT
Version : 13/07/2007
I. DEFINITIONS....................................................................................................................2 A. PRESENTATION DE CFT....................................................................................................2 B. DETAIL DUN TRANSFERT .................................................................................................2 C. PROTOCOLES UTILISES ......................................................................................................2 II. FONCTIONS DE BASE...................................................................................................3 A. DEMARRER ET ARRETER LE MONITEUR .............................................................................3 B. CFTUTIL, LE COUTEAU SUISSE .......................................................................................3 C. FONCTIONS INTERACTIVES AVEC CFTINT .......................................................................5 III. CONFIGURATION DE BASE ......................................................................................6 A. LES PARTENAIRES ............................................................................................................6 B. LES PROTOCOLES ..............................................................................................................6 1. Transfert par TCP........................................................................................................6 2. Transfert par X.25........................................................................................................7 C. DEFINITION DES TRANSFERTS ...........................................................................................9 1. Envoi de fichiers ..........................................................................................................9 2. Rception de fichiers....................................................................................................9
1/9
EUROTITRISATION
Langlois Jean-Baptiste Langlois
I. Dfinitions
A. Prsentation de CFT
CFT est un Moniteur de transferts de fichiers sur de nombreux systmes existants, de la socit Sopra (Axway). CFT est essentiellement utilis dans le secteur bancaire du fait de son caractre scuris. Il permet en outre dautres fonctionnalits prsentes ci-dessous : Assurer l'change de donnes entre plusieurs types de systmes d'exploitation (MVS, AIX, Windows NT, AS400, etc) Supporter un grand nombre de types de rseau (ex : TCP/IP, SNA, X.25, etc) Assurer le transcodage des donnes li aux diffrents systmes d'exploitations (ex : EBCDIC => ASCII, etc) Optimiser les flux en utilisant des fonctions de compression Assurer un suivi prcis des flux, pour un pilotage efficace Scuriser les changes en certifiant les partenaires Il existe de nombreux programmes compatibles avec CFT. Le moniteur CFT cre et maintenu par la socit Axway (Sopra Group) supporte toutes ces fonctions.
B. Dtail dun transfert
Un partenaire est dfini pour un serveur. Pour communiquer, les deux serveurs doivent stre mutuellement identifis en tant que partenaire. Le transfert de fichier entre deux moniteurs suit des tapes prcises : a. Le moniteur initiateur vrifie les informations qui lui ont t fournies lors de la demande et dfini un IDT pour cette transaction. b. Pour tablir la connexion entre les deux moniteurs, ils doivent s'authentifier mutuellement en utilisant des rfrences stockes dans leurs configurations. (Voir III.A) c. Ils doivent ensuite s'accorder au niveau protocole de transfert (type de protocole, taille des paquets changs, type de compression) (Voir III.B) d. Une fois ces tapes ralises, l'change des donnes est ralis sur la base de l'IDF. e. En fin de transaction, chacun des deux moniteurs peut dclencher des procdures de fin de transfert, pour initier des traitements sur le ou les fichiers transmis ou pour valider le transfert (Acquittement -- ACK).
C. Protocoles utiliss
PESIT : Echange de donnes entre les banques pour la tlcompensation ETEBAC : Echange de donnes entre les banques et leurs clients ODETTE : Echange de donnes entre les constructeurs automobiles et les quipementiers Ce sont l tous les protocoles existants. Chez EuroTitrisation, seuls le PESIT et le ETEBAC sont prsent.
2/9
EUROTITRISATION
Langlois Jean-Baptiste Langlois
II. Fonctions de base
A. Dmarrer et arrter le moniteur
Il y a 4 fonctions de base pour grer lexcution du moniteur CFT : cftstart [<idparm> | -batch] dmarre le moniteur CFT cftstop [-kill] Arrte le moniteur CFT Options : -kill force larrt de CFT (dtruit les files de messages et les segments de mmoire partage et les vecteurs de smaphores associs lutilisateur de CFT) cftping [-v] Fait une requte auprs du moniteur pour dterminer sil est en route Options : -v Mode verbeux. Comme cftping se contente denvoyer une requte auprs du moniteur, en ne revoyant quun simple code retour, cette option permet davoir un visuel quant ltat du moniteur. cftcatab Voir II.B, CFTUTIL LISTCAT.
B. CFTUTIL, le couteau suisse
Les commandes CFTUTIL et cftutil permettent de grer la vie courante du moniteur et permet dinitier nimporte quel type de transfert au pralable configur (Voir III). N.B. : Attention toutefois de ne pas confondre CFTUTIL et cftutil dont lusage diffre totalement. Voici une liste (non exhaustive) des fonctions les plus courantes : CFTUTIL ABOUT (=cftversion) informations sur la verstion de cft, les upgrades, etc. CFTUTIL LISTCAT [ TYPE=ALL/FILE/MESSAGE/REPLY, CONTENT=BRIEF/FULL, DIRECT=BOTH/SEND/RECV, IDF=<identifiant du fichier>, STATE=<tat du transfert>, PART=<identifiant du partenaire> ] liste les enregistrements du catalogue, avec : TYPE: Type denregistrement lister CONTENT:Liste simplifie ou complte de chaque poste du catalogue DIRECT: Sens des postes lister IDF: Identifiant du fichier PART: Nom dun partenaire STATE: Etat dun transfert Sans paramtres, linstruction liste lensemble du catalogue (=cftcatab)
3/9
EUROTITRISATION
Langlois Jean-Baptiste Langlois
CFTUTIL LISTPARM [ ID=<identifiant de la commande>, TYPE=<Type de la commande> ] liste les enregistrements du fichier paramtre, avec : ID: Identifiant de la commande de paramtrage consulter TYPE: Type de commande de configuration (SEND, RECV, PARM, ACCNT, CAT, LOG, PROT, NET) Sans paramtres, linstruction liste lensemble des paramtres CFTUTIL LISTPART [ ID=<identifiant du partenaire>, TYPE=<Type denregistrement> ] liste les enregistrements du fichier paramtre, avec : ID: Identifie le partenaire ou son adresse rseau TYPE: Dfinit le type denregistrement lister (PART, TCP, X25,) Sans paramtres, linstruction liste lensemble des partenaires
CFTUTIL @<nom de fichier> met jour la configuration ( utiliser une fois le moniteur arrt) CFTUTIL DELETE
PART= <identifiant de partenaire>,
[
DIRECT={BOTH|RECV|SEND},
IDF=<identifiant de fichier>, IDT=<identifiant de transfert>, STATE={*|C|D|H|K|T|X} ] supprime du catalogue les donnes indiqus. CFTUTIL DELETE PART=*, IDT=* supprime lintgralit du catalogue
CFTUTIL SEND
PART= <identifiant de partenaire>, IDF=<identifiant de fichier> lance une requte en mission vers le moniteur. Afin de tester sa ligne CFT, il est conseill de senvoyer soi-mme des donnes pour voir si la transmission seffectue. Ce principe se nomme Boucle et sutilise en spcifiant BOUCLE ou BOUCX25 en tant que partenaires, ce qui a pour effet denvoyer respectivement les donnes via TCP ou X.25 (sous reserve que ces partenaires soient dclars dans le fichier de configuration (voir III)
CFTUTIL RECV lance une requte en rception vers le moniteur. CFTUTIL HALT [
PART= <identifiant de partenaire>, DIRECT={BOTH|RECV|SEND}, IDF=<identifiant de fichier>, IDT=<identifiant de transfert>, STATE={*|C|D|H|K|T|X} ]
Arrte immdiatement le transfert concern. Sans paramtres, linstruction arrte tous les transferts en cours. CFTUTIL CFTEXT Extrait lintgralit des informations de paramtrage actuellement configur sur le moniteur. Afin de bnficier dune configuration complte et fonctionnelle, il nest pas
4/9
EUROTITRISATION
Langlois Jean-Baptiste Langlois
rare que des utilisateurs fasse une redirection de ces donnes dans un fichier afin davoir toujours une sauvegarde sre de la configuration actuelle quon pourra alors ventuellement charger avec CFTUTIL @. Toutefois, si on utilise cette instruction cette fin, pensez bien supprimer la dernire ligne du fichier ainsi gnr, car ce nest quun code retour, et il empcherait la bonne compilation de la configuration.
C. Fonctions interactives avec CFTINT
CFTINT est un outil permettant de manipuler CFT travers une srie dcrans interactifs. La commande CFTINT sans paramtre vous affiche un menu avec diverses options. CFTINT MNE : affiche la liste des commandes mnmoniques CFTINT MAC : affiche la liste des commandes dynamiques Exemples : CFTINT listcat : consultation globale du catalogue CFTINT listpart : consultation globale des partenaires. Grce cette interface, il est possible de : Emettre/Recevoir un fichier/message Visualiser le catalogue, y faire des tris par choix de critres Visualiser les paramtres, y faire des tris par choix de critres Visualiser les partenaires, y faire des tris par choix de critres Visualiser le journal Modifier la configuration de CFTINT Visualiser les caractristiques du moniteur Commandes statiques habituelles (ces commandes servent effectuer des actions locales sur lcran en cours) : CANCEL : Retour a l'cran appelant. EXIT : Sortie de l'application CFTINT. FIRST : Revenir au menu principal s'il a t affich. HELP : Obtenir cette aide en ligne. LOG : Consulter le journal CFT courant. TOP : Aller au dbut de la liste. BOTTOM : Aller en fin de liste. NEXT : Afficher la page suivante. PREVIOUS: Afficher la page prcdente. Dans le catalogue, vous pouvez agir sur les transferts via ces commandes (B)rowse : browser le fichier transfr. (C)reate : Cration d'une autre requte de transfert sur la base des donnes de ce transfert. (H)alt : Interruption du transfert diag (I)nterne : Afficher les messages du diagnostic interne du transfert. (N)ew : Cration d'une autre requte a partir d'un cran vierge. (P)urge : Suppression de la requte de transfert, ou poste catalogue. (V)iew : Visualisation des informations du transfert.
5/9
EUROTITRISATION
Langlois Jean-Baptiste Langlois
III. Configuration de base
A. Les partenaires
Dans le fichier de configuration (par convention [Link]), les partenaires sont dfinis par le mot-cl CFTPART. Il sagit l du mot-cl le plus important et travers lequel se retrouve le plus derreurs. Un bon exemple de configuration peut tre celui-ci :
CFTPART
ID NRPART NSPART SYST PROT SAP MODE
= = = = = = =
'RENAULT', 'RENAULT', 'EUROTIT', 'MVS', ( 'PSCFTTCP', PSCFTX25 ), ( '1761', #C0980360 ), 'REPLACE'
Il sagit l du CFTPART du cdant RCI. Les paramtres indiqus (non exhaustifs) sont les plus utiliss. Dtaillons-les : ID : Dfinit lidentifiant du partenaire. Peut tre choisi arbitrairement. Cest linformation indiquer dans lappel send part=<id> de CFTUTIL. NSPART : Identifiant indiquant le nom rseau que CFT prendra pour se prsenter devant le partenaire. La valeur chez EuroTitrisation est toujours EUROTIT . NRPART : Nom rseau du partenaire. Bien entendu, le-dit partenaire aura les mmes valeurs NSPART et NRPART que nous, mais inverss. SYST : Type de systme utiliss (peut-tre MVS pour MVS Series, WINNT pour Windows, UNIX pour AIX, etc.) PROT : Protocole utilis pour lenvoi des donnes. Le nom correspond la valeur donne dans CFTPROT (Voir III.B). Dans le cas de plusieurs valeurs, le premier protocole sera utilis pour lenvoi. Si celui-ci rate, cest le deuxime protocole qui est utilis et ainsi de suite. Bien entendu, les protocoles peuvent tre inverss en fonction du type denvoi dsir. SAP : Indication rseau. Dans le cas dun transfert TCP, SAP indique le port par lequel passe les donnes. Dans le cas dun transfert X.25, cela indique le code du propritaire, code unique authentifiant coup sr lautre partie. Si plusieurs valeurs sont spcifis, les inverser quand on inverse les protocoles.
B. Les protocoles
La liste des protocoles pris en charge par CFT tant plutt large, nous ne prendrons en compte que ceux grs par EuroTitrisation (TCP/IP/RNIS et X.25)
1. Transfert par TCP
Dans le cas dun transfert par TCP/RNIS, le protocole est dfini ainsi : CFTPROT ID = PSCFTTCP, NET = NET0, TYPE = PESIT, SAP = 1761 6/9
EUROTITRISATION
Langlois Jean-Baptiste Langlois
Il sagit l du CFTPROT utilis pour le RNIS sur nosilava. Les paramtres indiqus (non exhaustifs) sont les plus utiliss. Dtaillons-les : ID : Dfinit lidentifiant du partenaire. Peut tre choisi arbitrairement. Cest linformation indiquer dans CFTPART. NET : Indique lidentifiant du dtail de la connexion. TYPE : Type du transfert gr par ce protocole. Peut-tre ODETTE, PESIT ou ETEBAC. Chez EuroTitrisation, seuls PESIT et ETEBAC sont grs. SAP : Port denvoi et de rception des paquets. En complment de ces donnes, un autre bloc doit tre dfini :
CFTNET
ID MAXCNX TYPE HOST CALL
= = = = =
NET0, 64, TCP, INADDR_ANY, INOUT
Les paramtres indiqus (non exhaustifs) sont les plus utiliss. Dtaillonsles : ID : Dfinit lidentifiant de la connexion. Peut tre choisi arbitrairement. Cest linformation indiquer dans CFTPROT. MAXCNX : Indique le nombre maximum de connexions simultans. TYPE : Type de transmission. Toujours TCP, dans notre cas. HOST : Adresse locale denvoi. Il ne sagit pas de lIP sur Internet mais bien de lIP (ou le DNS) sur le rseau local dexpdition. Si INADDR_ANY est spcifi, on peut juste ladresse principale de la machine denvoi. CALL : Type dappels autoris : entrant (IN), sortant (OUT), les deux (INOUT), ou aucun (NONE) Enfin, il faut dfinir o le fichier doit parvenir chez le partenaire. Pour cela, on utilise CFTTCP. Il faut donc une entre CFTTCP par partenaire utilisant une liaison IP.
CFTTCP
ID CNXINOUT HOST
= RENAULT, = 4, = [Link]
Les paramtres indiqus (non exhaustifs) sont les plus utiliss. Dtaillonsles : ID : Identifiant du partenaire auquel se rapporte ces informations. CNXINOUT : Indique le nombre dessais de connexions avant abandon. HOST : Adresse locale de rception. Il ne sagit pas de lIP sur Internet mais bien de lIP (ou le DNS) sur le rseau local de rception.
2. Transfert par X.25
Dans le cas dun transfert par X.25, le protocole est dfini ainsi : CFTPROT ID = PSCFTX25, NET = NET1, TYPE = PESIT,
7/9
EUROTITRISATION SAP
Langlois Jean-Baptiste Langlois = #C0908350
Il sagit l du CFTPROT utilis pour le X.25 sur nosilava. Les paramtres indiqus (non exhaustifs) sont les plus utiliss. Dtaillons-les : ID : Dfinit lidentifiant du partenaire. Peut tre choisi arbitrairement. Cest linformation indiquer dans CFTPART. NET : Indique lidentifiant du dtail de la connexion. TYPE : Type du transfert gr par ce protocole. Peut-tre ODETTE, PESIT ou ETEBAC. Chez EuroTitrisation, seuls PESIT et ETEBAC sont grs. SAP : Code du propritaire dEuroTitrisation. Cette valeur identifie EuroTitrisation coup sr chez nos partenaires. Il faut, de ce fait, toujours vrifier que cette valeur est correctement rempli. Sur nosilava, la valeur doit tre #C0908350. En complment de ces donnes, un autre bloc doit tre dfini :
CFTNET
ID MAXCNX TYPE HOST CALL
= = = = =
NET1, 64, X25, INADDR_ANY, INOUT
Les paramtres indiqus (non exhaustifs) sont les plus utiliss. Dtaillonsles : ID : Dfinit lidentifiant de la connexion. Peut tre choisi arbitrairement. Cest linformation indiquer dans CFTPROT. MAXCNX : Indique le nombre maximum de connexions simultans. TYPE : Type de transmission. Toujours X25, dans notre cas. HOST : Adresse locale denvoi. Il ne sagit pas de lIP sur Internet mais bien de lIP (ou le DNS) sur le rseau local dexpdition. Si INADDR_ANY est spcifi, on peut juste ladresse principale de la machine denvoi. CALL : Type dappels autoris : entrant (IN), sortant (OUT), les deux (INOUT), ou aucun (NONE) Enfin, il faut dfinir o le fichier doit parvenir chez le partenaire. Pour cela, on utilise CFTTCP. Il faut donc une entre CFTTCP par partenaire utilisant une liaison IP.
CFTX25
ID CNXINOUT DAILNO
= RENAULT, = 4, = 191464755
Les paramtres indiqus (non exhaustifs) sont les plus utiliss. Dtaillonsles : ID : Identifiant du partenaire auquel se rapporte ces informations. CNXINOUT : Indique le nombre dessais de connexions avant abandon. DAILNO : Numro de tlphone du modem X.25 chez le partenaire. Chez le partenaire, cette valeur doit toujours tre 191464755 sil doit contacter nosilava en X.25.
8/9
EUROTITRISATION
Langlois Jean-Baptiste Langlois
C. Dfinition des transferts
Sans grande surprise, il y a deux types de transferts : lenvoi et la rception.
1. Envoi de fichiers
Pour envoyer des fichiers, on utilise CFTSEND, une fois le partenaire dfini : CFTSEND ID = N64GR01, FCODE = ASCII, FNAME = /documents/cogera/SOLD, FACTION = DELETE, EXEC = filexe/[Link] Il sagit l du CFTSEND du fichier SOLD de RCI. Les paramtres indiqus (non exhaustifs) sont les plus utiliss. Dtaillons-les : ID : Dfinit lidentifiant du fichier. Peut tre choisi arbitrairement. Cest linformation indiquer dans lappel send idf=<id> de CFTUTIL. FCODE : Indique quel type et format de donnes sont envoys. Les valeurs possibles sont EBCDIC, ASCII et BINARY. FNAME : Emplacement physique o se trouve le fichier envoyer FACTION:Type dactions effectuer sur le fichier envoyer. Les valeurs possibles sont DELETE (effacement aprs envoi), ERASE (purge aprs envoi), NONE (aucune action entreprise) EXEC: Script effectuer une fois que lenvoi est termin.
2. Rception de fichiers
Pour recevoir des fichiers, on utilise CFTRECV, une fois le partenaire dfini : CFTRECV ID = N64GA01, FCODE = ASCII, FNAME = /documents/cogera/CESS, EXEC = filexe/[Link], MODE = REPLACE Il sagit l du CFTSEND du fichier SOLD de RCI. Les paramtres indiqus (non exhaustifs) sont les plus utiliss. Dtaillons-les : ID : Cest lidentifiant du fichier qui est envoy par le partenaire. Cest la valeur qui doit tre indiqu dans le CFTSEND du partenaire et qui doit tre communiqu par lui. FCODE : Indique quel type et format de donnes sont reus. Les valeurs possibles sont EBCDIC, ASCII et BINARY. FNAME : Emplacement physique o doit tre sauvegard le fichier une fois reu. EXEC: Script effectuer une fois que la rception est termin MODE : Action effectuer dans le cas o un fichier de mme nom existe dj. Les valeurs possibles sont REPLACE (remplacement du fichier existant), DELETE (le transfert na pas lieu mais le fichier existant demeure)
9/9
