CFT FAQ

Creation: 3 Aout 2005
Mise à jour: 10 aout 2016
Version: 1.5
Author: Jean-Louis Bicquelet-Salaün
Location: http://jlbicquelet.free.fr
Copyright: (c) 2004-2016 Jean-Louis BICQUELET-SALAÜN
Frequently-Asked Questions built by makefaq.py

CFT Frequently-Asked Questions

Pour plus d'information au sujet de cette faq, contactez Jean-Louis BICQUELET


FAQ Revised: Wednesday 10 August 2016 18:29:18


Table of Contents

1. generalites
2. installation
3. configuration
4. messages
5. envoi/reception
6. fichiers
7. gestion de cft
8. diagnostique
9. xfb

1. generalites

1.1. Que signifie CFT?
CFT signifie Cross File Transfer

1.2. A quoi sert CFT?
CFT est un logiciel de transfert de fichiers développé par la société Axway, aussi appelé moniteur de transfert de fichier, parce qu'il permet de suivre les différentes phases d'évolution des transferts et d'éventuellement reprendre un transfert après un echec.

CFT est utilisé dans les systèmes informatiques complexes et multi plate-formes qui souhaitent transmettre des fichiers en appliquant des contrôles (sécurité, accusé de réception, reprise après interruption, trace des erreurs).

Il peut être utilisé avecTranspac en X.25, mais maintenant il supporte TCP/IP ce qui lui permet d'être utilisé avec Internet de manière sécurisée. Enfin CFT utilise des protocoles d'échanges comme PESIT ou ETEBAC (protocoles français utilisés pour les échanges bancaires), ce qui explique sont utilisation dans le monde banquaire.

1.3. Comment fonctionne CFT?
Chaque site permettant l'échange de fichiers est appelé un partenaire. Chaque partenaire CFT, possède une liste des partenaires avec lesquels il échange des fichiers (transfert ou reception). Le protocole CFT est indépendant de la plate-forme. Windows NT, Unix, VMS, MVS, GCOS, NetWare, AS400/iseries peuvent communiquer via CFT en toute sécurité. D'un autre coté, cela implique que CFT doit être installé sur chaque plate-forme.

1.4. Comment arrêter cft ?
$ cftstop

Starting CFT with IDPARM "IDPARM0" and 64 transferts active
Starting CFTMAIN ... started
Starting CFTTCOM ... started
Starting CFTTPRO ... started
Starting CFTLOG ... started
Starting CFTTCPS ... started

CFT started correctly.
CFTMAIN process id is 385208.


1.5. comment forcer l'arrêt de cft?
cftstop –kill


1.6. comment vérifier la version de cft?
$ cftutil about

    CFT informations :
      * product = CFT/V2/UAIX 43xL
      * version = 230
      * level   = m-1-25
      * upgrade = 6014 6052 6056 6149 6155 6214 6220 6275 6302 6311 6374 6417
                  6666 6687 6706 6810 6814 6872

    Host informations :
      * model   = 4C
      * cpuid   = 1ADFCF1ADFCF1ADF

CFTU00I ABOUT    _ Correct ()

1.7. Comment vérifier que CFT fonctionne ?
$ cftping -v cft: not running

1.8. Comment redémarrer CFT en cas d'arrêt ?
$ cftstart

1.9. Quels sont les répertoires de CFT ?

Désignation

Commentaires

filapi

contient les fichiers liés à l’interface de programmation CFT

fildat

Fichiers base de données de CFT

filexe

Exécutables de CFT

filexit

fichiers liés aux différents EXITs de CFT

filinst

répertoire spécifique à la procédure d’installation regroupant divers fichiers de configuration de test

filint

fichiers base de données des fonctions interactives

fillog

Fichiers journaux d’activité ou trace de CFT

filpub

répertoire tampon pour les fichiers émis et reçus

filusr

répertoire contenant les fichiers de commandes CFT




2. installation

2.1. Comment installer cft ?
$ cd /cft/aix43
$ tar xvf /prd/home/COPIE_CD/CD_CFT/aix43.tar
$ ./cft_instal fr
$ cd /cft/cft230/filinst
$ cftinit cftparm.cpuid cftidf.cft cftpart.cft | grep error
Il doit y avoir 0 error
$ cftstart


2.2. Comment désinstaller cft ?
  • Allez dans le répertoire où se trouve installé CFT
  • Tapez
     cd XIP
    
  • Vérifiez que X11 est disponible
  • Tapez
     ./uninstaller.bin
    
  • Suivez les wizards
  • Effacez si necessaire les restes avec rm -r


2.3. Comment modifier l'installation ?
  1. Arrêter le serveur cft
  2. lancer l'utilitaire cftcatal, répondre aux questions. Le catalogue se dimensionne en absolu (il faut donner le nombre total de messages).
  3. Redémarrer cft


2.4. Comment entrer la clé de licence ?
Modifiez le paramétrage (en général dans le répertoire filiinst) dans la partie CFTPARM. Entrez la clé dans la partie en vert. Note: ici le fichier s'appelle CFTPARM.tcp.
 CFTPARM      ID       = 'IDPARM0',
              ACCNT    = 'ACCNT0',
              BUFSIZE  = '4096',
              CAT      = 'CAT0',
              DEFAULT  = 'DEFAUT',
              EXECRE   = '/apps/products/cft/filinst/recv_ko.cmd',
              EXECRF   = '/apps/products/cft/filinst/recv_ok.cmd',
              EXECRM   = '/apps/products/cft/filinst/recvm.cmd',
              EXECSE   = '/apps/products/cft/filinst/send_ko.cmd',
              EXECSF   = '/apps/products/cft/filinst/send_ok.cmd',
              FBUFSIZE = '0',
              KEY      = 'XXXFAUXXXXPXDHXXXSX9X1XXXLN97XXXFAQXXX2XX',
              LOG      = 'LOG0',
              MAXTASK  = '16',
              MAXTRANS = '8',
              NPART    = 'XENA',
              PART     = 'XENA',
              PARTFNAM = '_CFTPART',
              CTLPASSW = 'NO',
              TRANTASK = '8',
              USERCTRL = 'NO',
              WAITRESP = '100',
              WAITTASK = '1441',
              COM      = ( 'COM0'),
              NET      = ( 'TCPIP'),
              PROT     = ( 'PESITTCP'),
              LENAPPL  = '8',
              RCVALLER = 'STOP',
              SSLMTASK = '16',
              SSLTTASK = '16',
              SSLWTASK = '1441',
              SSLWRESP = '100',
              PKIPASSW = 'PKIPASSW',
              TRKPART  = 'UNDEFINED',
              TRKSEND  = 'UNDEFINED',
              TRKRECV  = 'UNDEFINED',
              MODE     = 'REPLACE'

Il faut ensuite faire un update de la configuration, ce qui demande un arrêt de CFT:

#cftstop
#cftupdate CFTPARM.tcp

la réponse obtenue est du style:

============================================
CFTU00I CFTPARM  _ Correct (.........
CFTU00I RETURN   _ Correct (CODE=0)
CFTU20I Number of Command(s) 1
CFTU20I Number of error(s)   0

cftupdate complete.

On relance par cftstart


3. configuration

3.1. Comment modifier les paramètre de cft ?
$ cftstop
$ cd /cft/cft230/filinst
$ cftinit cftparm.cpuid cftidf.cft cftpart.cft | grep error
Il doit y avoir 0 error
$ cftstart


3.2. comment vérifier l'existance d'un partenaire?
$CFTUTIL cftext type=part,id=INDUS
CFTU20I
CFTU20I CFT/V2/UAIX 43xL
CFTU20I Version 230 20040401
CFTU20I (C) Copyright SOPRA 1993-2001
CFTU20I ====> Starting Session on 04/04/2005 Time is 11:39:38
CFTU20I
 CFTPART      ID       = 'INDUS',
              SAUTH    = '*',
              RAUTH    = '*',
 /*           XLATE    = '',*/
              CODE     = 'ASCII',
              OPEN     = 'NO',
              IMAXTIME = '23595999',
              IMINTIME = '00000000',
              OMAXTIME = '23595999',
              OMINTIME = '00000000',
 /*           IPART    = '',*/
              NRPART   = 'XXXXXXA0',
              NSPART   = 'XXXXXXQ0',
              NRPASSW  = 'CFT',
              NSPASSW  = 'CFT',
              COMMENT  = 'PARTITION AIX INDUS',
              SYST     = 'UNIX',
              COMMUT   = 'YES',
 /*           GROUP    = '',*/
 /*           FPREFIX  = '',*/
 /*           IDF      = '',*/
              STATE    = 'ACTIVEBOTH',
              PROT     = ( 'PESITANY'),
              SAP      = ( '57519'),
 /*           SSL      = '',*/
              MODE     = 'REPLACE'


CFTU00I CFTEXT   _ Correct (type=part,id=INDUS)
CFTU20I Number of Command(s) 1
CFTU20I Number of error(s)   0
CFTU20I Ending   Session on 04/04/2005 Time is 11:39:38
CFTU20I Session active for  0:00:00


3.3. comment obtenir la liste des partenaires?
cftutil listpart


3.4. comment obtenir la liste des partenaires d'un type donné?
cftutil listpart type=X25


3.5. comment vérifier la clé de licence CFT?
cftutil listparm type=parm | grep key
          CFT master key              KEY      = XXXFAQZQM1XXXIL9A7IXXXSOTLNXXXIZFAQWXXXE7


3.6. comment lister les protocoles utilisés?
cftutil listparm type=PROT


3.7. comment afficher le catalogue?
cftutil listparm type=CAT

                    CFTCAT   - Catalog file command
                    -------------------------------

  CAT0
          Catalog file name           FNAME    =
          *_CFTCATA

          Share file option           SHARE    = NO
          Scan file frequency         WSCAN    = 1     mn
          Update file frequency       UPDAT    = 0
          Cache memory size           CACHE    = 512
          Purge time                  TIMEP    = 23595999
          Action on error             RKERROR  = KEEP

          Optimization flag           OPTIMIZE = NONE

          Command retention period in catalog (in days)
          ---------------------------------------------

          State                            Send        Receive
          -----                            ----        -------
          (D)isp,(C)urrent,(H)old,(K)eep   SH = 90     RH = 90
          (T)erminated                     ST = 90     RT = 90
          e(X)ecuted                       SX = 45     RX = 45

          Notification of log events to NTF
          --------------------------------------------
          Notification to NTF         NTF      = NO
          Notify State transitions    NTFSTATE = CDHKTX
          Track Control System name   TCSNAME  = SCOPE_XFER_QLT
          Event Log System name       ELSNAME  = SCOPE_LOG_QLT


CFTU00I LISTPARM _ Correct (type=CAT)


3.8. ou sont configuré les logs?
cftutil listparm type=LOG

                    CFTLOG   - Log file command
                    ---------------------------

  LOG0
          Log file name               FNAME    =
          *_CFTLOG
          Alternate log file name     AFNAME   =
          *_CFTLOGA

          Maximum record length       LENGTH   = 133

          Switching from current to alternate log file
          --------------------------------------------
          Switch time                 SWITCH   = 23:59:00
          Switch nb records           MAXREC   = 0
          Execute procedure           EXEC     =
          */apps/products/cft/filinst/PROD/OUTILS_CFT/switch_log.ksh

          Which messages to operator  OPERMSG  = 0
          Operator identifier         NOTIFY   =
          Message level               CONTENT  = FULL

          Notification of log events to NTF
          --------------------------------------------
          Notification to NTF         NTF      = NO
          Messages transitions type   NTFTYP   = EF
          Event Log System name       ELSNAME  = SCOPE_LOG_QLT
          Messages for alert          NTFALERT =


3.9. comment trouver la configuration réseau dec cft?
 cftutil listparm type=NET

                    CFTNET   - Network ressources command
                    -------------------------------------

  NETX25
          Ressource type              TYPE     = X25
          Max. sessions               MAXCNX   = 64
          Ressource class             CLASS    = 4
          Call direction              CALL     = INOUT
          Ressource identifier        LINEID   = CIOX25.0
          Packet size                 PACKETSZ = 128
          Packet window               PACKETW  = 3
          Highest logic channel       MAXLCH   = 0
          Lowest  logic channel       MINLCH   = 0
          Configuration file name     NETCFG   =
          Network program             NETPGM   = NETX25
          Network object prefix       NETPFX   =
          Speed                       SPEED    = 9600
          Address                     ADDR     =
          Ax25 mailbox                AX25MBX  =
          Ax25 node                   AX25NODE =
          Controler name              CTLR     =
          Network profile             PROFILE  = X25

  TCPIP
          Ressource type              TYPE     = TCP
          Max. sessions               MAXCNX   = 32
          Ressource class             CLASS    = 1
          Call direction              CALL     = INOUT
          Network reference           HOST     = BATMAN.WARNER.TM.FR
          Range of ports
          --------------
          Lower port value            LOWPORT  = 5000
          Higher port value           HIGHPORT = 65535
          Port number                 PORT     =
          Network access
          --------------
          Intermediate network        INET     =
          Protocol identifier         PROTOCOL =
          User identifier             USERID   =
          Associated parameters       PARM     =
          *
          *


CFTU00I LISTPARM _ Correct (type=NET)



4. messages

4.1. comment envoyer un message à un partenaire via cft?
$ CFTUTIL send part=DEV, type=message,idm=test, msg=hello
CFTU20I
CFTU20I CFT/V2/UAIX 43xL
CFTU20I Version 230 20040401
CFTU20I (C) Copyright SOPRA 1993-2001
CFTU20I ====> Starting Session on 04/04/2005 Time is 11:14:17
CFTU20I
CFTU00I SEND     _ Correct (part=DEV,type=message,idm=test,msg=hello)
CFTU20I Number of Command(s) 1
CFTU20I Number of error(s)   0
CFTU20I Ending   Session on 04/04/2005 Time is 11:14:17
CFTU20I Session active for  0:00:00


4.2. comment afficher la liste des messages et des fichiers en transfert?
$ cftutil send part=PREX, fname=smit.log ,idf=smit
CFTU00I SEND     _ Correct (part=PREX,fname=smit.log,idf=smit)



5. envoi/reception

5.1. comment vérifier le transfert d'un fichier ou d'un message ?
 cftcatab

  Date = 04/04/2005   Time = 11:15:44

  Partner  DTSA File     Transfer         Records       Diags        Appli.
                Id.      Id.       Transmit     Total   CFT Protocol Id.
  -------- ---- -------- -------- ---------- ---------- --- -------- --------
  DEV      SMD  TEST     D0411142 hello                 909 RCO 301

         1 record(s) selected
       500 record(s) in Catalog file
       499 record(s) free (99%)

CFTU00I LISTCAT  _ Correct (type=all,content=brief)


5.2. comment envoyer un fichier avec cft?
$cftutil send part=PREX, fname=smit.log ,idf=smit
CFTU00I SEND     _ Correct (part=PREX,fname=smit.log,idf=smit)

Il est possible de fixer la longueur des enregistrement avec flrecl.

CFTUTIL send part=batman,idf=toto,flrecl=80,fname=/PROD/fichier

CFTU20I
CFTU20I CFT/V2/UAIX 51L
CFTU20I Version 2.3.2 20040910 / Patch20041220
CFTU20I (C) Copyright AXWAY 1989-2003
CFTU20I ====> Starting Session on 16/05/2009 Time is 10:41:24
CFTU20I
CFTU00I SEND     _ Correct (part=batman,idf=toto,flrecl=80,fname=/apps/product)
CFTU20I Number of Command(s) 1
CFTU20I Number of error(s)   0
CFTU20I Ending   Session on 16/05/2009 Time is 10:41:24
CFTU20I Session active for  0:00:00


5.3. comment recevoir un fichier
$ cftutil recv idf=smit, fname=/tmp/smit


5.4. comment lister les fichiers ou les messages envoyé vers un partenaire
CFTUTIL listcat part=MONPA00

ou si on recherche un transfert donné

CFTUTIL listcat part=MONPA00,idf=toto

exemple:

CFTUTIL send part=BOUCLE1,idf=toto,fname=/cftdata/CFT/toto
CFTU20I
CFTU20I CFT/V2/UAIX 51L
CFTU20I Version 2.3.2 20040910 / Patch20041220
CFTU20I (C) Copyright AXWAY 1989-2003
CFTU20I ====> Starting Session on 12/10/2009 Time is 10:50:53
CFTU20I
CFTU00I SEND     _ Correct (part=BOUCLE1,idf=toto,fname=/cftdata/CFT/toto)
CFTU20I Number of Command(s) 1
CFTU20I Number of error(s)   0
CFTU20I Ending   Session on 12/10/2009 Time is 10:50:53
CFTU20I Session active for  0:00:00
cft@helios:/apps/products/cft> CFTUTIL listcat part=BOUCLE1
CFTU20I
CFTU20I CFT/V2/UAIX 51L
CFTU20I Version 2.3.2 20040910 / Patch20041220
CFTU20I (C) Copyright AXWAY 1989-2003
CFTU20I ====> Starting Session on 12/10/2009 Time is 10:51:45
CFTU20I

  Date = 12/10/2009   Time = 10:51:45

  Partner  DTSA File     Transfer         Records       Diags        Appli.
                Id.      Id.       Transmit     Total   CFT Protocol Id.
  -------- ---- -------- -------- ---------- ---------- --- -------- --------
  BOUCLE1  SFX  GLOBUN   I0923062         14         14   0 CP 81%   I09N000G
  BOUCLE1  SFX  CSMUIR0R I1023194         15         15   0 CP 92%   I10N002C


         2 record(s) selected
    140000 record(s) in Catalog file
     32933 record(s) free (23%)

CFTU00I LISTCAT  _ Correct (part=BOUCLE1)
CFTU20I Number of Command(s) 1
CFTU20I Number of error(s)   0
CFTU20I Ending   Session on 12/10/2009 Time is 10:51:45


5.5. comment lister les transferts se trouvant dans un état donné ?
cftutil listcat state=K

  Date = 12/10/2009   Time = 11:17:03

  Partner  DTSA File     Transfer         Records       Diags        Appli.
                Id.      Id.       Transmit     Total   CFT Protocol Id.
  -------- ---- -------- -------- ---------- ---------- --- -------- --------
  U00PE83A SFK  XLOGMUTV J1207380          0          0 405 R 00 088 J127000F
  U00PM045 RFK  RSISR3   J1209260          0          0 405 R 0 2f2

         2 record(s) selected
    140000 record(s) in Catalog file
     32860 record(s) free (23%)

CFTU00I LISTCAT  _ Correct (state=K)


5.6. comment voir les transferts de fichiers qui ont provoqués une erreur donnée ?
  grep 82E * | grep /07 | awk '{print "grep ",$7," *"}' | sh


5.7. Comment arrêter un transfert en cours ou qui se trouve dans la file d'attente ?
cftutil halt part=MONPA00, idf=IDF, idt=I000*



6. fichiers

6.1. comment supprimer un fichier bloqué ?
cftutil delete part=BOUCLE, idt=G1915470



6.2. comment supprimer tous les fichiers qui sont à l'état hold ?
 cftcatab | grep SFH | awk '{print $4}' | sed 's/^/cftutil delete part=BOUCLE,idt=/' | sh


6.3. comment connaitre tous les fichiers envoyés?
tapez cftutil listcat ou cftcatab

Les types sont :

F File
M Message
R reply

Les types peuvent être :

S Send
R Receive

La colonne DTSA nous donne l'état des transferts:

D : Fichier en attente des transferts
C: Fichier en cours de transfert
H : Fichier non reçu (H pour HOLD), le fichier n'a pas été mis à disposition
K : Fichier non envoyé (K pour KEEP), le partenaire n'a pas déclenché l'émission
T : Fichier ayant eu un problème d'exécution de procédure de fin de transfert ou n'ayant pas de procédure de fin de transfert
X : Transfert réalisé et procédure de fin de transfert exécutée (X pour eXecute)

Exemples:

  • SFX nous indique que l'envoie du fichier a été effectué avec succès ( ).

  • RFH nous indique que le transfert envoyé par un partenaire n'a pas était reçu ( ) .



6.4. comment rechercher les erreurs de transfert sur les fichiers ?
CFTUTIL LISTCAT    TYPE=FILE,STATE=DK


6.5. comment supprimer un transfert de fichier qu'on a pas reçu?
cftutil delete part=MONPA00,idf=fichier,state=K,direct=RECV


6.6. comment supprimer tous les fichiers bloqués liés à une erreur ?
Ici l'erreur à pour code 405
 cftcatab |grep 405 | awk '{print "cftutil delete part=",$1,", idt=",$4}' | sh



7. gestion de cft

7.1. comment purger entièrement le catalogue le catalogue?
CFTUTIL DELETE IDT=* ,PART=*


7.2. comment examiner les logs?
cftlog
09/02/12 09:00:03  CFTT57I Requester transfer started   
09/02/12 09:00:03  CFTT58I Requester transfer ended     
09/02/12 09:00:03  CFTT88I+



8. diagnostique

8.1. quels sont les codes d'erreurs courrants?
  1. 001 à 499: anomalie locale
  2. 500 à 999: anomalie du partenaire
  3. 110 fichier local inexistant
  4. 610 fichier distant inexistant



9. xfb

9.1. Qu'est ce que xfb gateway ?
XFB Gateway est un composant de la Suite d'Intégration Axway. Il gère les échanges de fichiers entre les applications de l'entreprise et des partenaires extérieurs au réseau de l'entreprise. Il permet donc d'échanger des fichiers entre des terminaux utilisateurs ou des serveurs qui utilisent des logiciels standards de transefert comme FTP, Ssh-ftp, ou bien les envois de mails SMTP/POP3.

9.2. Quelles sont les fonctionnalités de xfb gateway ?
XFB Gateway permet de simplifier et d'automatiser les processus de transfert de fichiers. Il peut être utilisé des façons suivantes :
  • En tant que serveur de fichier : XFB Gateway centralise le flux de fichiers entre de les postes de travail et la production
  • En tant que routeur Gateway : XFB Gateway fournit un protocole d’accès réseau Gateway, typiquement entre le réseau d’entreprise ou des réseaux l’Internet. Le réseau local est alors isolé du réseau INTERNET par XFB Gateway ce qui assure intégrité et confidentialité des données.
  • En tant que moniteur : XFB Gateway est alors utilisé pour créer, soumettre,contrôler les requêtes de transfert de fichiers
Il est possible d’intégrer XFB Gateway dans une architecture sécurisée car il dispose des fonctions de sécurité standardisées suivantes :
  • Firewalls et proxys
  • Déploiements DMZ (via XSR ou via Gateway appareillées)
  • Identification de partenaire (base de données interne ou base externe via protocole LDAP)
  • SSL/TLS une voie ou certification mutuelle
  • Chiffrage facultatif de fichiers provisoires stockés sur la Gateway


9.3. Comment configurer ou lister la configuration de xfb gateway ?
Utilisez gatesetup situé normalement dans le répertoire racine où a eut lieu l'instalaltion.

Cela vous donnera accès à un menu dont vous pouvez voir quelques images.


Copyright (c) 2004-2010 Jean-Louis BICQUELET

This list of questions and answers was generated by makefaq.