Vous êtes sur la page 1sur 154

CFT Version 2.

CFT/MVS Guide dexploitation

C2-MVS-EXPL-23-04

Copyright Le Code de la proprit industrielle nautorise, aux termes de larticle L.122-5 que les copies ou reproductions strictement rserves lusage priv du copiste et non destines une utilisation collective. Toute reproduction totale ou partielle, toute transmission sous quelque forme ou par quel procd que ce soit (lectronique ou mcanique, photocopie ou enregistrement) et toutes autres fins que lusage personnel sans autorisation crite d'Axway Software est strictement interdite. Cette reprsentation ou reproduction constituerait donc une contrefaon sanctionne par les articles L.335-2 et suivants du Code de la proprit intellectuelle. Axway Software, 2004. Tous droits rservs.

Table des Matires


1. Caractristiques de CFT en environnement MVS .............................................................1-1
1.1. Versions de CFT........................................................................................................................... 1-1 1.2. Origines des demandes de transfert.............................................................................................. 1-1 1.3. Transferts en parallle .................................................................................................................. 1-1 1.4. Description de lenvironnement CFT........................................................................................... 1-2

2. Besoins matriels et logiciels, prparation de linstallation...............................................2-1


2.1. Besoins matriels.......................................................................................................................... 2-1 2.1.1. Processeurs et versions de OS/390....................................................................................... 2-1 2.1.2. Units dentre/sortie ........................................................................................................... 2-1 2.2. Besoins logiciels........................................................................................................................... 2-1 2.3. Format du support dinstallation CFT V2.3.0 .............................................................................. 2-2 2.4. Format du support dinstallation partir de la version 2.3.1........................................................ 2-2 2.5. Taille et format des fichiers dinstallation XFB/CFT V2.3.0....................................................... 2-3 2.6. Taille et format des fichiers dinstallation XFB/CFT V2.3.1....................................................... 2-4 2.7. Composants de CFT/MVS ........................................................................................................... 2-5

3. Codification des noms de fichiers de CFT/MVS ................................................................3-1


3.1. Accs aux fichiers ........................................................................................................................ 3-1 3.2. Codification des noms de fichiers ................................................................................................ 3-1 3.2.1. Codification des paramtres SMS........................................................................................ 3-2 3.3. Codification des noms de fichiers avec DDNAME ..................................................................... 3-2 3.4. Codification des noms de fichiers PDS........................................................................................ 3-3 3.5. Codification des noms de fichiers GDG....................................................................................... 3-3 3.6. Cration dynamique des fichiers CFT/MVS ................................................................................ 3-3 3.6.1. Cration dynamique de fichiers multivolumes..................................................................... 3-4 3.7. Suppression et RENAME des fichiers CFT/MVS ....................................................................... 3-4 3.7.1. Remplacement de membres de PDS et de fichiers............................................................... 3-4 3.8. Partage des fichiers CFT/MVS..................................................................................................... 3-5 3.8.1. Protection multisystmes GRS de CFT/MVS...................................................................... 3-5

CFT V2.3

iii

Table des Matires

3.9. Fichiers hirarchiques HFS .......................................................................................................... 3-5 3.9.1. Noms de fichiers HFS .......................................................................................................... 3-5 3.9.2. Caractristiques des fichiers HFS ........................................................................................ 3-6 3.9.3. Interprtation des caractristiques RECFM/LRECL/BLKSIZE .......................................... 3-6 3.9.4. Propritaire et droits daccs aux fichiers HFS.................................................................... 3-6 3.9.5. Message derreur spcifique HFS ........................................................................................ 3-7

4. Installation de CFT/MVS Version 2.3.0 ..............................................................................4-1


4.1. Installation de CFT/MVS ............................................................................................................. 4-1 4.2. Dfinition dun ALIAS CFT version 2 ........................................................................................ 4-1 4.3. Restauration de la bibliothque dinstallation .............................................................................. 4-2 4.3.1. Transfert des fichiers dinstallation depuis un CD............................................................... 4-2 4.4. Adaptation des JOB dinstallation lexploitation ...................................................................... 4-4 4.5. Personnalisation des fichiers dinstallation de CFT/MVS (A00CUSTO).................................... 4-5 4.5.1. Cration des fichiers dinstallation de CFT/MVS (A10ALLOC) ........................................ 4-7 4.5.2. Restauration de la bande dinstallation de CFT/MVS (A11REST) ..................................... 4-7 4.5.3. Choix des options de fonctionnement de CFT/MVS (A120PTS)........................................ 4-7 4.5.4. LINK-EDIT de CFT/MVS (B20LINK) ............................................................................... 4-9 4.5.5. Installation des modules rseau TCP/IP............................................................................. 4-10 4.6. LINK-EDIT des programmes CICS (B24LCICS) ..................................................................... 4-11

5. Installation de CFT/MVS Version 2.3.1 ..............................................................................5-1


5.1. Installation de CFT/MVS ............................................................................................................. 5-1 5.2. Dfinition dun ALIAS CFT version 2 ........................................................................................ 5-1 5.3. Restauration de la bibliothque dinstallation .............................................................................. 5-2 5.3.1. Restauration des fichiers dinstallation a partir dune cassette ............................................ 5-2 5.3.2. Transfert des fichiers dinstallation depuis un CD............................................................... 5-3 5.4. Dcompression des fichiers de livraison ...................................................................................... 5-4 5.5. Adaptation des JOB dinstallation lexploitation ...................................................................... 5-4 5.6. Personnalisation des fichiers dinstallation de CFT/MVS (A00CUSTO).................................... 5-5 5.6.1. Choix des options de fonctionnement de CFT/MVS (A120PTS)........................................ 5-7 5.6.2. LINK-EDIT de CFT/MVS (B20LINK) ............................................................................... 5-9 5.6.3. Installation des modules rseau TCP/IP............................................................................. 5-10 5.7. LINK-EDIT des programmes CICS (B24LCICS) ..................................................................... 5-11

6. Cration de lenvironnement CFT/MVS ............................................................................6-1


6.1. Formatage des fichiers de travail de CFT/MVS (D40INIT) ........................................................ 6-1 6.2. Dfinition de lindex altern du catalogue (D41AIX1, D41AIX2).............................................. 6-1 6.3. Cration du fichier PKI de CFT/MVS (D43PKI)......................................................................... 6-3

iv

CFT V2.3

CFT/MVS Guide dexploitation

7. Installation des menus CFT..................................................................................................7-1


7.1. Menus CFT................................................................................................................................... 7-1 7.2. Cration des fichiers de linterface interactive (C31SCRxx) ....................................................... 7-1 7.3. Serveur de communications OS/390 ............................................................................................ 7-1 7.3.1. Mise en uvre (C32XMEM) ............................................................................................... 7-1 7.4. Utilisation (CFTXMEM).............................................................................................................. 7-2 7.5. Cration du fichier de configuration (C33CNFxx) ...................................................................... 7-2 7.6. Cration du fichier des moniteurs (C33MON)............................................................................. 7-4 7.7. Appel des menus CFT .................................................................................................................. 7-4 7.7.1. Sous TSO (CFT) .................................................................................................................. 7-4 7.7.2. Sous VTAM (CFTINT)........................................................................................................ 7-5 7.7.3. Touches de Fonctions........................................................................................................... 7-5 7.7.4. Menus en langue anglaise .................................................................................................... 7-6 7.8. Interface utilisateur Internet (CFTIUI)......................................................................................... 7-6 7.8.1. Appel aux interface utilisateur Internet en JAVA................................................................ 7-9

8. Exploitation de CFT/MVS....................................................................................................8-1
8.1. Prsentation .................................................................................................................................. 8-1 8.2. Mise jour des procdures de transfert (H80EXEC)................................................................... 8-1 8.3. Exemple de JCL de demande de transfert .................................................................................... 8-1 8.3.1. Mdia de communication : fichier (CFTSEND) .................................................................. 8-1 8.3.2. Mdia de communication : API synchrone (CFTSENDS) [XFB/CFT.231]........................ 8-2 8.4. Exemple de lancement de JCL de CFT/MVS (CFTMAIN)......................................................... 8-2

9. Cration des paramtres CFT/MVS (E50PARM) .............................................................9-1


9.1. Prsentation .................................................................................................................................. 9-1 9.2. Cration des paramtres CFT/MVS (E50PARM)........................................................................ 9-1 9.3. Cration dune base VFM (F60VFMC) ....................................................................................... 9-2 9.4. Partage dune base VFM .............................................................................................................. 9-2 9.5. Mise jour de SYS1.VTAMLST (G70VTAM)........................................................................... 9-3 9.5.1. Paramtres du NCP pour utiliser GATE........................................................................... 9-3 9.5.2. Complments dinformation propos des rseaux X25 ...................................................... 9-3 9.6. Mise jour de SYS1.VTAMLIB (G71LOGM) ........................................................................... 9-4 9.7. Mise en uvre du systme des habilitations ................................................................................ 9-5

CFT V2.3

Table des Matires

10. Installation de loption XFB.Scope ..................................................................................10-1


10.1. Prsentation .............................................................................................................................. 10-1 10.2. Personnalisation des paramtres dinstallation XFB-SCOPE (NT00CUST) ........................... 10-1 10.3. LINK-EDIT du module A&P (NT10LMQS).......................................................................... 10-2 10.4. Cration de fichiers XFB-SCOPE (NT20DEF) ....................................................................... 10-2 10.5. Utilisation de lagent externe A&P(CFTAETP) ...................................................................... 10-3

11. Installation de loption Sentinel for XFB ....................................................................11-1


11.1. Prsentation .............................................................................................................................. 11-1 11.2. Mise en place............................................................................................................................ 11-1 11.2.1. Mise en place de lEvent Router ...................................................................................... 11-1 11.2.2. Personnalisation du fichier de configuration Sentinel for XFB (SN00CUST) ...... 11-1 11.2.3. Modification de la procdure de lancement de CFT ........................................................ 11-3 11.2.4. Prise en compte du fichier de configuration..................................................................... 11-3 11.2.5. Mode denvoi des messages............................................................................................. 11-3 11.2.6. Remplacement de loption XFB.Scope............................................................................ 11-4 11.3. Exemples de procdures pour un suivi de bout en bout ........................................................... 11-4

12. Installation de PTF sur CFT/MVS V2.3.0 ......................................................................12-1


12.1. Format du support dinstallation .............................................................................................. 12-1 12.1.1. Mise jour de CFT/MVS par CD .................................................................................... 12-1 12.1.2. Mise jour de CFT/MVS par Internet ............................................................................. 12-1 12.2. Restauration de la bande dinstallation CFT/MVS (A13PTF) ................................................. 12-1 12.3. Informations importantes ......................................................................................................... 12-2 12.4. Prise en compte des PTF .......................................................................................................... 12-2 12.5. Prise en compte de nouveaux menus de linterface interactive................................................ 12-2 12.6. Sauvegarde/Restauration du paramtrage CFT/MVS .............................................................. 12-2 12.6.1. Extraction des paramtres CFT : CFTEXT...................................................................... 12-2 12.6.2. Procdure de sauvegarde du paramtrage ........................................................................ 12-3 12.6.3. Procdure de restauration du paramtrage ....................................................................... 12-3 12.7. Sauvegarde/Restauration des fichiers CATALOGUE COMMANDE ................................ 12-4

13. Installation de PTF sur CFT/MVS V2.3.1 ......................................................................13-1


13.1. Format du support dinstallation .............................................................................................. 13-1 13.1.1. Mise jour de CFT/MVS par cassette ............................................................................. 13-1 13.1.2. Mise jour de CFT/MVS par CD .................................................................................... 13-1 13.1.3. Mise jour de CFT/MVS par Internet ............................................................................. 13-1

vi

CFT V2.3

CFT/MVS Guide dexploitation

13.2. Restauration de la bande PTF CFT/MVS (A13PTF) ............................................................... 13-2 13.3. Transfert des PTF sur le host.................................................................................................... 13-2 13.3.1. Transfert du fichier de PTF partir de la station de travail via FTP................................ 13-2 13.3.2. Rcupration du fichier de PTF partir du HOST via FTP............................................. 13-2 13.4. Prise en compte des PTF .......................................................................................................... 13-2 13.5. Informations importantes ......................................................................................................... 13-3 13.6. Application dune PTF (A13PTFLK) ...................................................................................... 13-3 13.7. Restauration de la librairie des excutables (A13RSTOR) ...................................................... 13-4 13.8. Suppression dune version de sauvegarde (A13SDEL) .......................................................... 13-4 13.9. Prise en compte de nouveaux menus de linterface interactive................................................ 13-4 13.10. Sauvegarde/Restauration du paramtrage CFT/MVS ............................................................ 13-4 13.10.1. Extraction des paramtres CFT : CFTEXT.................................................................... 13-5 13.10.2. Procdure de sauvegarde du paramtrage ...................................................................... 13-5 13.10.3. Procdure de restauration du paramtrage ..................................................................... 13-5 13.11. Sauvegarde/Restauration des fichiers CATALOGUE COMMANDE................................... 13-6

14. Interfaces de programmation...........................................................................................14-1


14.1. Prsentation .............................................................................................................................. 14-1 14.2. API CFT : mise en oeuvre sous OS/390................................................................................... 14-1 14.2.1. Exemples de programmation............................................................................................ 14-2 14.3. CFT : mise en oeuvre sous CICS ............................................................................................. 14-2 14.3.1. Interrogation du catalogue : CFTI.................................................................................... 14-3 14.3.2. Commandes de transferts : CFTC .................................................................................... 14-4 14.3.3. Utilisation......................................................................................................................... 14-5 14.4. VFM : mise en oeuvre sous OS/390......................................................................................... 14-7 14.4.1. Exemples de programmation............................................................................................ 14-8

15. Exits ....................................................................................................................................15-1


15.1. Exit ASIT ................................................................................................................................. 15-1 15.2. Exit-list..................................................................................................................................... 15-1 15.3. Exits de CFT............................................................................................................................. 15-2 15.3.1. Introduction aux exits de CFT.......................................................................................... 15-2 15.3.2. Ralisation des exits en assembleur 370 .......................................................................... 15-3 15.3.3. Ralisation des exits en C ................................................................................................ 15-5 15.3.4. Ralisation des exits en COBOL for OS/390................................................................... 15-7 15.4. Appel des API de CFT dans les EXITS ................................................................................... 15-8

CFT V2.3

vii

Table des Matires

16. Commandes de linterface oprateur de CFT

sous OS/390 .......................................16-1

16.1. Prsentation .............................................................................................................................. 16-1 16.2. Commandes de linterface oprateur........................................................................................ 16-1 16.2.1. Rponse de linterface oprateur...................................................................................... 16-1 16.3. Commandes de diagnostic........................................................................................................ 16-1 16.3.1. Format et utilisation des commandes de diagnostic......................................................... 16-2 16.4. Commandes ? ........................................................................................................................... 16-4 16.4.1. Rponse des commandes de DISPLAY ........................................................................... 16-5 16.5. Commande PATCH ................................................................................................................. 16-7 16.6. Commandes du serveur de communications CROSS-MEMORY ........................................... 16-8 16.6.1. Commande DUMP........................................................................................................... 16-8 16.6.2. Commande DELETE ....................................................................................................... 16-8 16.6.3. Commande DELREQ....................................................................................................... 16-8 16.6.4. Commande QRYOPN...................................................................................................... 16-8 16.6.5. Commande OPEN............................................................................................................ 16-9 16.6.6. Commande CLOSE.......................................................................................................... 16-9 16.6.7. Commande SGTRACE .................................................................................................... 16-9

17. Utilisation de CFT/MVS avec le logiciel de scurit RACF ..........................................17-1


17.1. Prsentation .............................................................................................................................. 17-1 17.2. Contrle des oprations de manipulation des fichiers.............................................................. 17-1 17.3. Activation du contrle des autorisations RACF....................................................................... 17-1 17.4. RACF et les interfaces cran CFT/MVS.................................................................................. 17-2 17.4.1. RACF et linterface Internet............................................................................................. 17-2 17.4.2. RACF et linterface utilisateur JAVA.............................................................................. 17-2

18. Performances du moniteur de transfert CFT/MVS.......................................................18-1


18.1. Utilisation de la mmoire ......................................................................................................... 18-1 18.1.1. Par le moniteur de transfert de fichiers ............................................................................ 18-1 18.1.2. Par le moniteur des interfaces interactives sous VTAM .................................................. 18-1 18.2. Utilisation des entres/sorties disque ....................................................................................... 18-2 18.2.1. Utilisation dun hyperspace MVS/ESA ........................................................................... 18-2 18.2.2. Libration de lespace disque inutilis dans les fichiers reus......................................... 18-2 18.3. Utilisation de lunit centrale ................................................................................................... 18-2 18.4. Utilisation de la compression DF/SMS .................................................................................... 18-3 18.5. Utilisation de CFT/MVS en environnement SYSPLEX .......................................................... 18-3 18.5.1. Utilitaires et applications de CFT en SYSPLEX ............................................................. 18-3 18.5.2. Moniteur CFT en SYSPLEX et rseaux SNA ................................................................. 18-3 18.5.3. Moniteur CFT en SYSPLEX et rseau TCP/IP ............................................................... 18-3

viii

CFT V2.3

CFT/MVS Guide dexploitation

18.6. Utilisation des services Automatic Restart Manager................................................................ 18-4 18.7. Fichiers de diagnostics de LE/370............................................................................................ 18-4 18.8. Paramtrage des rseaux X25................................................................................................... 18-5 18.8.1. Paramtres du NCP pour utiliser GATE....................................................................... 18-5 18.8.2. Complments dinformation propos des rseaux X25 .................................................. 18-5 18.9. Fichiers de format fixe standard et variable SPANNED.......................................................... 18-6 18.9.1. Fichiers de format fixe standard....................................................................................... 18-6 18.9.2. Fichiers de format variable SPANNED ........................................................................... 18-6 18.10. Appel aux utilitaires Z/OS depuis CFT/MVS ........................................................................ 18-6 18.10.1. Rgles communes dappel aux utilitaires....................................................................... 18-7 18.10.2. Codage des commandes CFTSEND ou SEND .............................................................. 18-7 18.10.3. Codage des commandes CFTRECV ou RECV.............................................................. 18-7 18.10.4. Appel IEBCOPY ......................................................................................................... 18-7 18.10.5. Appel ADRDSSU........................................................................................................ 18-8 18.10.6. Messages complmentaires.......................................................................................... 18-11 18.10.7. Messages derreurs....................................................................................................... 18-11 18.10.8. Performances des utilitaires ......................................................................................... 18-11

19. Codes erreurs fichiers CFT/MVS ....................................................................................19-1


19.1. Prsentation .............................................................................................................................. 19-1 19.2. Format du champ DIAGP ........................................................................................................ 19-1 19.2.1. Table des codes erreur fichier NNNN.............................................................................. 19-2 19.3. Diagnostics complmentaires pour les erreurs fichiers ............................................................ 19-5

20. Messages des interfaces systmes de CFT/MVS.............................................................20-1


20.1. Prsentation .............................................................................................................................. 20-1 20.2. Dfinition ................................................................................................................................. 20-1

21. Codes erreurs rseau.........................................................................................................21-1


21.1. Rseau X25 .............................................................................................................................. 21-1 21.1.1. Prsentation...................................................................................................................... 21-1 21.1.2. Erreur locale X25 : L NN PPP ......................................................................................... 21-1 21.1.3. Erreur rseau X25 : R SS DDD........................................................................................ 21-1 21.1.4. Diagnostics complmentaires pour les erreurs de linterface X25................................... 21-2 21.1.5. Erreur rseau X25 sous forme NCS ................................................................................. 21-2 21.2. Rseau SNA ........................................................................................................................... 21-10 21.2.1. Prsentation.................................................................................................................... 21-10 21.2.2. Erreur locale SNA L NN PPP ........................................................................................ 21-10 21.2.3. Erreur rseau SNA R SSTTUU...................................................................................... 21-11 21.2.4. Codes SENSE VTAM gnrs par CFT ........................................................................ 21-11 21.2.5. Diagnostics complmentaires pour les erreurs de linterface SNA................................ 21-11 21.3. Rseau TCP/IP ....................................................................................................................... 21-11 21.3.1. Prsentation.................................................................................................................... 21-11

CFT V2.3

ix

Table des Matires

21.3.2. Erreur locale TCP/IP L NN PPP .................................................................................... 21-12 21.3.3. Erreur rseau TCP/IP R SSSSSS ................................................................................... 21-12 21.3.4. Diagnostics complmentaires pour les erreurs de linterface TCP/IP............................ 21-12 21.4. Codes erreur rseau SNA LU 6.2........................................................................................... 21-12 21.4.1. Erreur locale SNA LU 6.2 : L NN PPP.......................................................................... 21-12 21.4.2. Erreur rseau SNA LU 6.2 : R HPPPSSSS HNNNNNNN............................................ 21-13 21.4.3. Diagnostics complmentaires pour les erreurs de linterface SNA LU 6.2 ................... 21-13 21.5. Erreur rseau SNA LU 6.2 sous forme NCS.......................................................................... 21-13 21.5.1. Erreurs de traitement du module CFT LU 6.2 ............................................................... 21-13 21.5.2. Erreurs de traitement du module rseau LU 6.2............................................................. 21-14 21.5.3. Erreurs de traitement des ressources SNA LU 6.2......................................................... 21-14 21.5.4. Autres erreurs SNA LU 6.2............................................................................................ 21-15

22. Codes retour et codes ABEND des interfaces systmes CFT/MVS ..............................22-1
22.1. Prsentation .............................................................................................................................. 22-1

A. Mise en oeuvre spcifique ................................................................................................... A-1


A.1. Environnement systme ..............................................................................................................A-1 A.1.1. Cration des fichiers sous OS/MVS....................................................................................A-1 A.1.2. Option de partage des fichiers sous OS/MVS .....................................................................A-1 A.1.3. Suppression des fichiers sous OS/MVS ..............................................................................A-2 A.1.4. Gestion des fichiers par DF/SMS........................................................................................A-2 A.1.5. CFT/MVS et les fichiers PDSE...........................................................................................A-2 A.2. Procdures CFT...........................................................................................................................A-2

B. Paramtrage spcifique....................................................................................................... B-1


B.1. Tableau des valeurs spcifiques...................................................................................................B-1 B.2. Fichiers transfrables...................................................................................................................B-1 B.3. Codification des noms de fichiers................................................................................................B-3 B.3.1. Noms des fichiers ................................................................................................................B-3

CFT V2.3

Liste des Tableaux


Tableau 1. Format du support magntique dinstallation CFT V2.3.0 ...................................................................2-2 Tableau 2. Format du support CD dinstallation CFT V2.3.0 ................................................................................2-2 Tableau 3. Format du support magntique dinstallation partir de la version 2.3.1 de CFT................................2-2 Tableau 4. Format du support CD dinstallation partir de la version 2.3.1 de CFT.............................................2-3 Tableau 5. Taille et format des fichiers dinstallation ............................................................................................2-3 Tableau 6. Taille et format des fichiers dinstallation ............................................................................................2-4 Tableau 7. Liste des mots-cls ...............................................................................................................................4-6 Tableau 8. Liste des mots-cls ...............................................................................................................................5-6 Tableau 9. Description du paramtrage de lagent XFBIUI......................................................................................7-7 Tableau 10. Liste des mots-cls ..............................................................................................................................10-2 Tableau 11. Liste des mots-cls ..............................................................................................................................11-2 Tableau 12. Contenu de la bande dinstallation .....................................................................................................12-1 Tableau 13. librairies prises en compte lors du DUMP ADRDSSU ......................................................................13-1 Tableau 14. Ralisation des exits en assembleur 370.............................................................................................15-4 Tableau 15. Exemples pour la ralisation dun exit annuaire en C ........................................................................15-5 Tableau 16. Ralisation des exits en COBOL ........................................................................................................15-8 Tableau 17. Rgles dinterprtation du DSNGEN .................................................................................................18-9 Tableau 18. Performances des utilitaires : utilisation de la mmoire ...................................................................18-11 Tableau 19. Code environnement...........................................................................................................................19-1 Tableau 20. Code fonction F ..................................................................................................................................19-1 Tableau 21. Code RR .............................................................................................................................................19-2 Tableau 22. Table des codes NNNN pour S=0 ......................................................................................................19-2 Tableau 23. Table des codes NNNN pour S=4 ......................................................................................................19-3 Tableau 24. Table des codes NNNN pour S=F ......................................................................................................19-4 Tableau 25. Valeur de F pour la fonction DYNALLOC ........................................................................................19-5 Tableau 26. Messages des interfaces systme de CFT/MVS .................................................................................20-1 Tableau 27. Erreurs de traitement du module X25.................................................................................................21-2 Tableau 28. Erreurs de traitement du module MCH ..............................................................................................21-3 Tableau 29. Erreurs de traitement des CV..............................................................................................................21-4 Tableau 30. Valeur de REASON X25....................................................................................................................21-5 Tableau 31. Valeur de DIAG X25..........................................................................................................................21-5 Tableau 32. Erreurs de traitement du module CFT LU 6.2 ..................................................................................21-13 Tableau 33. Erreurs de traitement du module rseau SNA LU 6.2 .......................................................................21-14 Tableau 34. Erreurs de traitement des ressources SNA LU 6.2 ............................................................................21-14 Tableau 35. Autres erreurs de traitement SNA LU 6.2 ........................................................................................21-15

CFT V2.3

xi

Liste des Tableaux

Tableau 36. Principaux codes erreur ou ABEND ..................................................................................................22-1 Tableau 37. Valeurs spcifiques............................................................................................................................... B-1 Tableau 38. Valeurs spcifiques : dfauts pour CFTUTIL ...................................................................................... B-1 Tableau 39. Caractristiques de fichiers retrouves automatiquement ou non lmission .................................... B-1 Tableau 40. Combinaisons de FTYPE et FRECFM lmission ............................................................................ B-2 Tableau 41. Valeurs de FORG, FTYPE et FRECFM la rception ........................................................................ B-2

xii

CFT V2.3

1. Caractristiques de CFT en environnement MVS

1.1. Versions de CFT


CFT est disponible pour les environnements OS/390 partir de la version 2.64. CFT rside en permanence dans un espace adresse. Plusieurs demandes de transfert peuvent tre traites simultanment par CFT qui, dans sa rgion, cre et gre le nombre de tches appropri.

1.2. Origines des demandes de transfert


Les demandes de transfert peuvent tre adresses CFT partir de : commandes oprateur depuis un cran TSO ou depuis la console systme, travaux batch, programmes utilisateurs, interface utilisateur, interface Internet XFB.IUI. CFT gre lensemble des transferts qui lui sont demands laide dun fichier, le catalogue CFT. Dans ce catalogue, CFT enregistre les caractristiques de chaque transfert : lmission ou rception, le transfert en attente, en cours, interrompu ou termin, les noms des partenaires, lidentifiant logique des donnes, le nom physique du fichier, lheure de lancement de la commande, lheure de fin du transfert, le nombre denregistrements transmis... Ce catalogue peut tre interrog partir dun terminal TSO, un browser Internet ou depuis un programme utilisateur.

1.3. Transferts en parallle


CFT peut grer plusieurs transferts en parallle avec un ou plusieurs interlocuteurs. Pour ces diffrents transferts, CFT peut mettre en uvre diffrents protocoles. Les protocoles supports par CFT sont les suivants : PeSIT ODETTE, ETEBAC 3.

CFT V2.3

1-1

Caractristiques de CFT en environnement MVS

1.4. Description de lenvironnement CFT


CFT travaille laide des fichiers suivants : un fichier des paramtres : ce fichier dcrit les paramtres de fonctionnement. Il est de type VSAM KSDS, un fichier des partenaires : ce fichier dcrit les destinataires et les metteurs de fichiers transfrs. Il est de type VSAM KSDS, un fichier catalogue : ce fichier enregistre toutes les oprations de transfert de fichiers. Il est de type VSAM ESDS, deux fichiers journaux : ces fichiers enregistrent tous les vnements chronologiques dexploitation de CFT Version 2. Ils sont de type squentiel, deux fichiers comptables facultatifs : ces fichiers enregistrent les statistiques dexploitation de CFT Version 2. Ils sont de type squentiel, un ou deux fichiers de communication : ces fichiers enregistrent les demandes adresses CFT Version 2, en batch, depuis TSO ou depuis linterface interactive. Ils sont de type VSAM ESDS, plusieurs fichiers d'images crans. Ils sont de type VSAM KSDS, un fichier de configuration utilisateur par dfaut. Il est de type squentiel, un fichier de sauvegarde des communications, facultatif. Il est de type VSAM LINEAR, un fichier index altern du catalogue utilisable sous CICS, facultatif, un ensemble de fichiers de paramtrage de loption XFB/SCOPE [XFB/CFT.230], un ensemble de fichiers de paramtrage de loption XFB/SENTINEL [XFB/CFT.231], un fichier de paramtrage du serveur CFTIUI, une base de donnes de scurit, facultative, une librairie dexcutables de format PDSE (DSNTYPE=LIBRARY) [XFB/CFT.2.31].

1-2

CFT V2.3

2. Besoins matriels et logiciels, prparation de linstallation

2.1. Besoins matriels


2.1.1. Processeurs et versions de OS/390
CFT/MVS est support par les systmes IBM darchitecture ESA, dans les environnements OS/390, partir de la version 2.6 pour CFT V2.3.0 et 2.10 partir de la version CFT 2.3.1. CFT/MVS fonctionne galement sous Z/OS, toutes versions. Il est recommand dinstaller CFT/MVS sur le systme cible, ou a dfaut une version infrieure du systme Z/OS.

2.1.2. Units dentre/sortie


Une cartouche est ncessaire pour la restauration des fichiers par lutilisateur. De l'espace disque est ncessaire pour recevoir les modules objets, les procdures et les exemples de CFT/MVS. Linstallation est galement possible partir dune station de travail (Windows, UNIX, Linux,...) quipe dun lecteur de CD.

2.2. Besoins logiciels


En fonction des besoins de lexploitation, CFT/MVS utilise les produits ci-dessous partir de la version indique : architecture SNA (Protocoles lu62, lu0, lu2) : ACF-VTAM (MVS) : Version 4 ou suprieure, ACF-NCP : 5735-XX9, X25-NPSI : 5668-981, eNetwork Communication services TCP/IP dans la version de OS/390, UNICENTER TCPACESS version 5.2 et suprieure, Language Environment dans la version de Z/os ou en version V2R10, CICS toutes versions,

rseau X25 : rseau TCP/IP :

environnement d'excution : applications de CFT sous CICS :

CFT V2.3

2-1

Besoins matriels et logiciels, prparation de linstallation

interfaces de programmation et EXITS : Cobol for OS/390, C for OS/390.

2.3. Format du support dinstallation CFT V2.3.0


CFT/MVS est livr sur un support magntique contenant les fichiers suivants, indiqus dans le tableau ci-dessous.
Tableau 1. Format du support magntique dinstallation CFT V2.3.0 Fichier INSTALL SAMPLE OBJ PFTOBJ DOC CNTL MAC SCR Position 1 2 3 4 5 6 7 8 Contenu Exemple de JCL dinstallation Exemples de paramtrage, de procdures Modules OBJET Modules OBJET mis jour Documentation dinstallation et de mise jour Fichiers de contrle Macros dinstallation Formats des crans, messages, exemples SSL, composants XML

CFT/MVS est livr galement sur un support CD, dont le rpertoire dinstallation contient les fichiers suivants.
Tableau 2. Format du support CD dinstallation CFT V2.3.0 Fichier CFTV2.INSTALL CFTV2.SAMPLE CFTV2.OBJ CFTV2.PFTOBJ CFTV2.DOC CFTV2.CNTL CFTV2.MAC CFTV2.SCR Contenu Exemple de JCL dinstallation Exemples de paramtrage, de procdures Modules OBJET Modules OBJET mis jour Documentation dinstallation et de mise jour Fichiers de contrle Macros dinstallation Formats des crans, messages, exemples SSL

2.4. Format du support dinstallation partir de la version 2.3.1


CFT/MVS est livr sur un support magntique contenant le fichier suivant.
Tableau 3. Format du support magntique dinstallation partir de la version 2.3.1 de CFT Fichier INIT Position 1 Contenu JCL(s) damorce de linstallation + Produit XFB/CFT sous la forme (XMIT + ADRDSSU)

2-2

CFT V2.3

CFT/MVS Guide d'exploitation

CFT/MVS est livr galement sur un support CD, dont le rpertoire dinstallation contient les fichiers suivants.
Tableau 4. Format du support CD dinstallation partir de la version 2.3.1 de CFT Fichier MVS-CFT-2.3.1-tag-date jclins.txt ftp.prm Contenu Produit sous le format XMIT / ADRDSSU) JCL de mise en place du produit Exemple de paramtres FTP pour le transfert du produit XFB.CFT vers le HOST ainsi que le JCL de mise en place

2.5. Taille et format des fichiers dinstallation XFB/CFT V2.3.0


CFT/MVS ncessite une capacit disque de 300 cylindres de 3390. Cette capacit de stockage est rpartie entre les diverses bibliothques CFT comme indiqu dans le tableau ci-dessous.
Tableau 5. Taille et format des fichiers dinstallation Fichier INSTALL SAMPLE OBJ PFTOBJ DOC CNTL MAC SCR Allocation SPACE SPACE SPACE SPACE SPACE SPACE SPACE SPACE = (3120, (225, 225, 40) ) = (3120, (225, 225, 40) ) = (3120, (18000, 5000, 120) ) = (3120, (5000, 5000, 40) ) = (3120, (225, 225, 40) ) = (3120, (225, 225, 40) ) = (3120, (225, 225, 30) ) = (3120, (5000, 500, 40) )

Les tailles sont dfinies dans le JCL A10ALLOC. Linstallation depuis un CD ncessite environ 300 cylindres disque 3390 despace temporaire supplmentaire.

CFT V2.3

2-3

Besoins matriels et logiciels, prparation de linstallation

2.6. Taille et format des fichiers dinstallation XFB/CFT V2.3.1


A partir de la version XFB/CFT V2.3.1, un environnement de distribution est cr lors de la phase de mise en place du produit. Cet environnement de distribution reflte limage du produit lors de sa mise en place enrichie des upgrades successifs. Lenvironnement Target ou cible correspond celui de lutilisateur qui sera personnalis.
Tableau 6. Taille et format des fichiers dinstallation Fichier INSTALL SAMPLE OBJ PFTOBJ DOC CNTL MAC SCR OBJSAS OBJIBM EXEC XMLLIB CERTIF DLL LOAD UPLIB Environnement Distribution + Target Distribution Distribution Distribution Distribution Distribution Distribution Distribution Distribution Distribution Target Target Target Distribution + Target Target (DSNTYPE=LIBRARY) Distribution Allocation SPACE SPACE SPACE SPACE SPACE SPACE SPACE SPACE SPACE SPACE SPACE SPACE SPACE SPACE = (3120, (225, 225, 40) ) = (3120, (225, 225, 40) ) = (3120, (10000, 5000, 120) ) = (3120, (5000, 5000, 40) ) = (3120, (225, 225, 40) ) = (3120, (225, 225, 40) ) = (3120, (225, 225, 30) ) = (3120, (5000, 500, 40) ) = (3120, (2000, 2000, 200) ) = (3120, (2000, 2000, 200) ) = (3120, (195, 195, 30) ) = (3120, (50, 5, 10) ) = (3120, (50, 5, 10) ) = (3120, (1000,1000,50) )

SPACE = (CYL, (150,50,30) ) SPACE = (CYL, (50,50,90) )

Les tailles sont dfinies dans le JCL JCLINS [CFT-2.31]. Linstallation depuis un CD ncessite environ 300 cylindres disque 3390 despace temporaire supplmentaire.

2-4

CFT V2.3

CFT/MVS Guide d'exploitation

2.7. Composants de CFT/MVS


Les diffrents composants de CFT/MVS sont : CFTUTIL : programme batch de traitement des commandes et paramtres, CFTMAIN CFTTPRO CFTTFIL CFTTCP CFTTLOG CFTTCOM CFTTCOMS CFTSNA CFTX25 CFTOPER : moniteur de transfert de fichiers, compos lui-mme de : : protocoles de transfert de fichiers (PESIT, ETEBAC, ODETTE...), : gestionnaire des fichiers, : gestionnaire de rseau TCP/IP, : gestionnaire du journal, : gestionnaire des fichiers de commandes, : gestionnaire de commandes en mode synchrone, [CFT.231], : interface rseau SNA (LU0, LU2, LU6.2), : interface rseau X25, : interface console oprateur, : interface interactive TSO, : interface de programmation utilisateur en batch, : serveur de communications MVS/ESA, : programme CICS dinterrogation du catalogue, : programme CICS de commandes, : utilitaire de gestion de fichiers VFM, : service dadministration centralise de CFT [XFB/CFT.231], : interface utilisateur distance sur technologies Internet, : interface dauthentification forte des partenaires et de chiffrement des donnes, : utilitaire de gestion de la base de donne de scurit.

CFTINT CFTAPI CFTXMEM CFTI CFTC VFMUTIL CFTTRK CFTIUI CFTTSSL CFTPKI :

CFTINTV/CFTINT31 : interface utilisateur sous VTAM, CFTXNTF/XFBSCOPE : service dadministration centralise de CFT [XFB/CFT.230],

CFT V2.3

2-5

3. Codification des noms de fichiers de CFT/MVS

3.1. Accs aux fichiers


CFT/MVS accde en lecture ou en criture aux fichiers suivants : les fichiers squentiels disque, les fichiers squentiels disque multivolumes, les fichiers PDS, les fichiers en GENERATION DATA GROUP (GDG), les fichiers VSAM KSDS, les fichiers VSAM ESDS les fichiers hirarchiques HFS. CFT/MVS cre, supprime et renomme les fichiers suivants par appel IDCAMS : les fichiers VSAM KSDS, les fichiers VSAM ESDS. CFT/MVS ne sait pas transfrer les fichiers suivants : les fichiers VSAM RRDS, les fichiers VSAM LINEAR, les fichiers concatns, les fichiers sur bande magntique.

3.2. Codification des noms de fichiers


CFT/MVS utilise la codification suivante pour manipuler les fichiers : FNAME=VOLUME%UNIT%NOM1.NOM2.NOMx Avec : pour VOLUME, les caractristiques suivantes : indique le nom du volume disque sur lequel le fichier est cr ou recherch, facultatif mais utile pour demander CFT la cration dun fichier VSAM ou non, hors SMS, correspond au paramtre VOLUME du DEFINE CLUSTER VSAM ou VOL=SER= du JCL, dconseill avec DF/SMS,

CFT V2.3

3-1

Codification des noms de fichiers de CFT/MVS

pour UNIT, les caractristiques suivantes : indique le UNITNAME utilis, facultatif mais utile pour un fichier SAM bande ou disque, correspond au paramtre UNIT= du JCL, par dfaut, la valeur SYSALLDA ou la valeur force par votre EXIT DYNALLOC sera utilise, dfinit le nom du fichier, obligatoire.

pour NOM1.NOM2.NOMx, les caractristiques suivantes : -

le nom des fichiers HFS commence par le caractre /. Exemples : CFTVOL%%NOM.DU.FICHIER %3390%NOM.DU.FICHIER %%NOM.DU.FICHIER NOM.DU.FICHIER /path/file.extension Remarque : les deux caractres % sont obligatoires uniquement si le paramtre VOLUME ou le paramtre UNIT est spcifi.

3.2.1. Codification des paramtres SMS


CFT/MVS permet une codification limite de certains paramtres SMS dans le paramtre UNIT. Les valeurs possibles sont : >STORCLA : permet de spcifier une valeur de STORAGE-CLASS dont le nom est limit 7 caractres, <DATACLA : permet de spcifier une valeur de DATA CLASS dont le nom est limit 7 caractres, *MGTCLAS : permet de spcifier une valeur de MANGEMENT CLASS dont le nom est limit 7 caractres. Remarque : la limitation 7 caractres sera leve dans une prochaine version.

3.3. Codification des noms de fichiers avec DDNAME


CFT/MVS utilise la codification suivante pour faire rfrence un DDNAME dclar dans le JCL : FNAME=$DDNAME Exemple : FNAME=$CFTCAT

3-2

CFT V2.3

CFT/MVS Guide d'exploitation

3.4. Codification des noms de fichiers PDS


CFT/MVS manipule les fichiers PDS : membre par membre, squentiellement, par appel IEBCOPY UNLOAD : pour la totalit du PDS en codant : FNAME=#DSNAME, pour une slection d'un sous-ensemble de membres, en utilisant les caractres '*' pour remplacer une chane de caractres ou '?' pour remplacer un caractre, en codant : FNAME=#DSNAME(ME?BRE*).

Un fichier PDS est cod sous la forme : FNAME=NOM1.NOMX(MEMBRE).

3.5. Codification des noms de fichiers GDG


Un fichier GDG est cod sous la forme : FNAME=NOM1.NOMX(0) FNAME=NOM1.NOMX(+n) FNAME=NOM1.NOMX(-n) Remarque : la concatnation de toutes les versions dun fichier GDG nest pas permise par CFT/MVS.

3.6. Cration dynamique des fichiers CFT/MVS


Tous les fichiers crs par CFT sont catalogus. Les fichiers SAM sont crs par DYNALLOC. Les fichiers VSAM sont crs par appel dynamique IDCAMS. Les fichiers PDS sont crs avec BLKPDS blocs de directory. BLKPDS est une option du JOB A12OPTS dinstallation de CFT. Sa valeur par dfaut est 150. Les fichiers GDG ne peuvent tre crs que si le PATTERN DSCB existe. Lespace primaire est calcul partir de la taille en Ko indique dans le paramtrage ou annonce par le partenaire. Lespace secondaire est gal 10 % du primaire. Le BLKSIZE est : soit calcul en fonction de la valeur indique dans le paramtrage, soit annonc par le partenaire (en PESIT profil CFT et ANY), ou encore calcul partir de BLKSIZE dfini dans le JOB A12OPTS. Lallocation du fichier sera sous la forme : SPACE=(BBBB,(PPPP,SSSS)),DCB=(BLKSIZE=BBBB), avec : BBBB : valeur de BLKSIZE calcule, PPPP : allocation primaire, SSSS : 10 % de PPPP.

CFT V2.3

3-3

Codification des noms de fichiers de CFT/MVS

CFT/MVS cre des fichiers multivolumes travers les 'ACS ROUTINES' de DF/SMS. La taille totale tant demande dans lallocation primaire, il est ncessaire dutiliser une "DATACLASS" dcrivant des fichiers "striped". Pour plus de dtails, reportez-vous la documentation IBM de rfrence "DFSMSDP Storage Administration Rfrence".

3.6.1. Cration dynamique de fichiers multivolumes


La cration dynamique de fichiers multivolumes est une nouvelle fonction permettant la rception des trs "gros" fichiers. Elle est complmentaire au support existant travers SMS. Ce dispositif est appel automatiquement quand : la cration du fichier choue par manque de place ou demande de plus de 65.535 pistes sur un volume NON EXTENDED FORMAT , le paramtre VOLUME nest pas renseign. La prsence du paramtre permet de dsactiver ce dispositif. DYNALLOC est appel jusqua 19 fois supplmentaires avec : la demande d'un volume supplmentaire, le calcul de lallocation primaire PPPP divise par le nombre de volumes. Puis CFT/MVS rserve lespace demand sur les volumes attribus. Si la rservation choue pour un volume, la cration du fichier est rejete avec un code erreur de la forme xxxxxE37. La codification de fname=%+nnn%DSNAME ou nnn est une valeur numrique comprise entre 2 et 127, permet de demander directement la cration dun fichier multivolumes: si nnn est infrieur 20, lallocation sera re-tente jusqua la limite de 20 volumes, si nnn est suprieur 20, une seule tentative est effectue.

3.7. Suppression et RENAME des fichiers CFT/MVS


Tous les fichiers supprims par CFT sont dcatalogus. Les fichiers SAM sont supprims/renomms par CAMLST. Les membre de PDS sont supprims/renomms par STOW. Les fichiers VSAM sont supprims/renomms par appel dynamique IDCAMS. Lors du RENAME d'un fichier, CFT/MVS libre l'espace inutilis uniquement s'il est autoris (APF) et si le fichier est allou sur un seul volume.

3.7.1. Remplacement de membres de PDS et de fichiers


Le paramtre CFTRECV MACTION=REPLACE commande le remplacement de membres de fichiers PDS reus. Le paramtre CFTRECV MACTION=REPLACE commande le remplacement des fichiers reus dans un DUMP de lutilitaire ADRDSSU.

3-4

CFT V2.3

CFT/MVS Guide d'exploitation

3.8. Partage des fichiers CFT/MVS


Les fichiers VSAM du moniteur CFT sont allous en DISP=SHR. Les fichiers de transfert en lecture sont allous en DISP=SHR. Les fichiers en criture sont allous en DISP=OLD.

3.8.1. Protection multisystmes GRS de CFT/MVS


CFT utilise le QNAME 'CFTFILES' pour la protection des fichiers transfrs par ENQ. Il n'est pas ncessaire de propager les ENQ 'CFTFILES' tous les systmes du 'RING GRS'. En configuration multi-CPU ou SYSPLEX, il est ncessaire de propager uniquement le QNAME "CFTSHARE" tous les systmes du RING GRS.

3.9. Fichiers hirarchiques HFS


Les fichiers HFS sont des fichiers dont larchitecture de donnes est conscutive et non structure en enregistrements et en blocs. Ces fichiers sont installs dans des espaces disques hirarchiss, compartiments conformment la normalisation UNIX en rpertoires (directory) et en sousrpertoires (sous-directory). Les fichiers HFS sont grs par les applications qui se droulent dans un environnement UNIX/OMVS, ou par celles qui utilisent les services dUSS (UNIX System Services) comme interface de gestion et daccs. CFT/MVS accepte uniquement le nom complet depuis le rpertoire racine. Tous les lments participant llaboration dun nom de fichier sont spars par des /. Les caractristiques des fichiers MVS, comme le format (RECFM), la taille dun enregistrement (LRECL) et la taille dun bloc (BLKSIZE) sont sans objet pour un fichier HFS. CFT se base cependant sur ces caractristiques pour assurer, pour un transfert, la gestion des donnes et la transmission des caractristiques du fichier vers le destinataire. Le paramtrage doit donc tout particulirement tenir compte de ces caractristiques lorsquelles seront vhicules entre partenaires htrognes. Les fichiers HFS sont accessibles uniquement en vue de transfert par le moniteur CFT/MVS, lexclusion de tout autre usage dans les diffrents modules de XFB/CFT. Remarques : lenvoi gnrique de fichiers HFS nest pas support, la fonction COPYFILE de lutilitaire CFTUTIL nest pas oprante dans le cadre des fichiers HFS.

3.9.1. Noms de fichiers HFS


Les noms de fichiers cods dans les paramtres FNAME, WFNAME et NFNAME doivent tre conformes aux usages employs pour lidentification des fichiers sous UNIX. Pour respecter la codification des noms de fichier en minuscules et/ou majuscules, les valeurs associes aux paramtres FNAME et NFNAME devront tre codes entre guillemets. Exemple : FNAME= "/home/qualcft/recv/Recv.Fichier.Minuscul".

CFT V2.3

3-5

Codification des noms de fichiers de CFT/MVS

3.9.2. Caractristiques des fichiers HFS


Les fichiers HFS sont caractriss par un type particulier selon quils contiennent du texte (structur) ou du binaire (non structur). Le type du fichier est vhicul par les paramtres FTYPE et NTYPE. Les valeurs attribues TYPE sont les suivantes : T : fichier texte . Ce fichier est structur, les enregistrements logiques sont dlimits, les donnes sont traites en mode enregistrement par CFT, B : fichier binaire . Ce fichier nest pas structur, les donnes sont traites en flot continu par CFT. En labsence de ce paramtre, le type de fichier binaire est pris par dfaut.

3.9.3. Interprtation des caractristiques RECFM/LRECL/BLKSIZE


Ces caractristiques conservent leur porte lorsquelles sont vhicules entre partenaires htrognes. CFT se base sur ces caractristiques pour assurer, pour un transfert, la gestion des donnes. Le paramtrage doit donc tout particulirement tenir compte des remarques suivantes : le format du fichier (FRECFM et NRECFM) est interprt par CFT pour adopter une mthode dchange des donnes. En cas dabsence de ce paramtre, la valeur prise par dfaut est "V", la taille dun enregistrement logique (FLRECL et NRECL) est interprte par CFT pour adapter la taille des articles changs. En cas dabsence de ce paramtre, la valeur prise par dfaut est "4096", la taille dun bloc (FBLKSIZE et NBLKSIZE) est ignore et est mise "0".

3.9.4. Propritaire et droits daccs aux fichiers HFS


La proprit dun fichier HFS est caractrise par un UID (numro dutilisateur), un GID (numro de groupe) et une chane donnant les droits daccs. CFT/MVS gre la proprit et les droits daccs de deux manires : CFT/MVS est un programme autoris, le paramtre USERCTRL est YES. Dans ce cas, les fichiers sont crs/lus/crits avec les droits de lutilisateur demandeur. Ce mode opratoire est recommand, sinon, les fichiers HFS sont crs/lus/crits avec les droits du moniteur CFT/MVS. Il est recommand de donner au moniteur CFT un UID diffrent de "0". Lorsquun transfert en rception aboutit la cration dun fichier HFS, celui-ci est cr avec la chane daccs -rwxr-xr-x. Avant de crer un fichier, CFT/MVS vrifie que la place ncessaire est disponible dans le FileSystem. Sinon, la cration est refuse avec un code erreur 00F00B37. CFT/MVS manipule les fichiers HFS de taille infrieure 2 tra-octets.

3-6

CFT V2.3

CFT/MVS Guide d'exploitation

Le changement du nom dun fichier HFS sopre exclusivement dans le mme rpertoire. Le chemin d'accs du fichier dcrit dans le paramtre FNAME doit tre identique celui renseign dans le paramtrage WFNAME.

3.9.5. Message derreur spcifique HFS


CFT/MVS affiche dans la SYSLOG un message spcifique CFTHF01E pour chaque erreur daccs aux fichiers HFS. CFHF01E:BPX1mod ,RSN=05F1006C,RC=ENOENT (129)No such file or directory Explication BPX1mod : nom du module de service qui a rendu lerreur. Avec : RSN=xxxxxxxx : reason code retourn, expliqu dans la brochure IBM UNIX System Services Messages & Codes , RC= : code retour sous forme mnmonique (numrique) et abrge. Il est expliqu dans la brochure IBM dj cite.

CFT V2.3

3-7

4. Installation de CFT/MVS Version 2.3.0

4.1. Installation de CFT/MVS


La procdure suivante indique les principales tapes de cette installation : 1. Dfinition dun ALIAS CFT Version 2 (facultatif). 2. Restauration de la bibliothque dinstallation. 3. Alternativement transfert des fichiers dinstallation depuis un CD. 4. Adaptation des jobs dinstallation aux standards de lexploitation. 5. Allocation des fichiers dinstallation. 6. Restauration des fichiers contenus sur la bande. 7. Soumission des jobs dinstallation. 8. Paramtrage de CFT version 2. 9. Personnalisation des procdures CFT version 2.

4.2. Dfinition dun ALIAS CFT version 2


Si les noms de fichiers mentionns dans les diffrents jobs dinstallation sont conservs par lexploitation, il est possible de crer un ALIAS CFTV2 dans un USER CATALOG, dfini de la manire suivante. //jobname JOB account,'DEFALIAS',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //DEFALIAS EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=sysout //SYSIN DD * DEFINE ALIAS(NAME(CFTV2) RELATE(USER.CATALOG)) ................... /* // Les paramtres en gras sont adapter votre environnement.

CFT V2.3

4-1

Installation de CFT/MVS Version 2.3.0

4.3. Restauration de la bibliothque dinstallation


Lutilisateur de CFT/MVS trouvera, ci-dessous, un exemple de JCL utiliser pour restaurer les fichiers dinstallation de CFT. Exemple : RESTAURE : restauration du fichier INSTALL //jobname JOB account,'RESTAURE',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //RESTAURE EXEC PGM=IEBCOPY //SYSPRINT DD SYSOUT=sysout //TAPE DD DSN=CFTV2.INSTALL,VOL=SER=SOPnnn, // UNIT=3480, // DISP=OLD, // LABEL=(1,SL) //DISK DD DSN=CFTV2.INSTALL, // UNIT=SYSDA,DISP=(NEW,CATLG), // SPACE=(3120,(225,225,40)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=3120), // VOL=SER=XXXXXX //SYSIN DD * COPY INDD=TAPE,OUTDD=DISK /* // Les paramtres en gras sont adapter votre environnement. Le nom de volume SOPnnn figure sur ltiquette de la cartouche.

4.3.1. Transfert des fichiers dinstallation depuis un CD


Lutilisateur peut recharger les fichiers indiffremment depuis une K7 ou un CD. Les fichiers installs sont alors interchangeables.

4.3.1.1. Configuration ncessaire


Pour procder linstallation de CFT/MVS livr sur CD-ROM, lutilisateur doit disposer : d'une station de travail quipe dun lecteur de CD-ROM, d'un logiciel client FTP permettant le transfert de fichiers vers le HOST MVS, d'un rseau TCP/IP de performances suffisantes pour transfrer environ 150 mga-octets de donnes (1 mgabit/seconde est souhaitable). Pour raliser linstallation de CFT/MVS, les tapes suivantes sont droules : 1. Transfert du CD-ROM vers MVS, par FTP, des 8 fichiers de livraison. Cette tape ncessite environ 200 cylindres 3390 despace disque ct MVS. 2. Dcompression et rechargement des fichiers dinstallation. Cette tape ncessite environ 300 cylindres supplmentaires despace disque.

4-2

CFT V2.3

CFT/MVS Guide d'exploitation

4.3.1.2. Transfert des fichiers d'un CD par FTP


Les fichiers de livraison se trouvent sous le rpertoire install du CD-ROM. Pour les transfrer vers MVS, vous devez procder de la manire suivante : 1. Ouvrir une session FTP par la commande FTP "your.mvs". 2. Fournir le USERID et le mot de passe de lutilisateur TSO qui procdera linstallation de CFT/MVS. 3. Conserver loption par dfaut ou choisir le "QUALIFIER" des fichiers MVS. Par dfaut le "QUALIFIER" sera le USERID TSO. Pour changer de "QUALIFIER", utiliser les commandes FTP CD et MKDIR. 4. Positionner les 2 options FTPsuivantes :
BINARY QUOTE SITE RECFM=FB LRECL=80 BLKSIZE=3120 CYL PRIMARY=100 SECONDARY=50

(ces 2 options sont impratives). 5. Transfrer les 8 fichiers par la commande mput cftv2.* et rpondre "yes" chaque demande de FTP. Les 8 fichiers du CD-ROM sont : CFTV2.CNTL CFTV2.DOC CFTV2.INSTALL CFTV2.MAC CFTV2.OBJ CFTV2.PTFOBJ CFTV2.SAMPLE CFTV2.SCR Les 8 fichiers sont crs ou remplacs selon le cas. Les 8 fichiers sont nomms "userid/QUALIFIER" : userid.CFTV2.CNTL userid.CFTV2.DOC userid.CFTV2.INSTALL userid.CFTV2.MAC userid.CFTV2.OBJ userid.CFTV2.PTFOBJ userid.CFTV2.SAMPLE userid.CFTV2.SCR 6. Lutilisation de FTP est termine, lutilisateur peut fermer la session.

CFT V2.3

4-3

Installation de CFT/MVS Version 2.3.0

4.3.1.3. Dcompression des fichiers de livraison par CD


Les fichiers de livraison sont transforms en bibliothques dinstallation par la commande TSO RECEIVE. Depuis votre session TSO : 1. Faire la liste des 8 fichiers transfrs, puis passer sur le premier de la liste la commande : RECEIVE INDSNAME(/). Au message "INMR906A Enter restore parameters or 'DELETE' or 'END' +", par dfaut le nom du fichier sera : CFTV2.Cnnn.CNTL. Pour en changer, rpondre en donnant le nom du fichier : DSNAME(CUSTOMER.CFTV2.NEW.CNTL). 2. Si le message "INMR045I Dataset 'CUSTOMER.CFTV2.NEW.CNTL' already exists. Reply 'R'" apparat, alors rpondre R pour remplacer les membres identiques ( rpter pour les 8 fichiers). Les 8 fichiers dinstallation sont rechargs lidentique dune K7 de livraison. Lutilisateur peut poursuivre linstallation ltape A00CUSTO. Lutilisateur peut galement dtruire les 8 fichiers de livraison transfrs par FTP, ces derniers tant devenus inutiles.

4.4. Adaptation des JOB dinstallation lexploitation


Les JOB contenus dans cette bibliothque sont les suivants : 1 : A00CUSTO : personnalisation des jobs d'installation, 2 : A10ALLOC 3 : A11REST 4 : A12OPTS 5 : B20LINK 6 : B22LTCP 7 : B24CICS 8 : C31SCRxx 9: C32XMEM 10 : C33CNFxx 11 : C33MON 12 : D40INIT 13 : D41AIX1 14 : D41AIX2 15 : D42SSL 16 : D43PKI 17 : E50PARM : allocation des fichiers, : restauration du reste de la bande, : choix des options de fonctionnement de CFT version 2, : LINK-EDIT gnral des modules CFT, : LINK-EDIT spcifiques TCP/IP, : LINK-EDIT de linterface de programmation CICS, : allocation des fichiers des crans (Franais et/ou Anglais), : allocation du fichier de sauvegardes des communications, : allocation du fichier de configuration (Franais et/ou Anglais), : allocation du fichier des moniteurs, : initialisation des fichiers dexcution de CFT Version 2, : dfinition de lindex altern du catalogue, : construction de lindex altern du catalogue, : cration d'une base de donnes exprimentale de cls et de certificats SSL, : cration d'une base de donnes PKI, : fourniture d'un exemple de paramtrage CFTPARM,

4-4

CFT V2.3

CFT/MVS Guide d'exploitation

18 : F60VFMC 19 : G70VTAM 20 : G71LOGM 21 : H80EXEC 22 : I90VALID 23 : NT00CUST 24 : NT10LMQS 25 : NT20DEF

: fourniture d'un exemple de cration de base VFM, : fourniture d'un exemple de paramtrage de VTAMLST, : fourniture d'un exemple de MODETAB utilise par CFT Version 2, : cration de procdures (fin de transferts, bascule log...) CFT Version 2, : validation de l'installation de CFT Version 2. : personnalisation des jobs d'installation de XFB.Scope, : LINK EDIT spcifique de lagent utilis par A&P 2, : dfinir et initialiser les fichiers tampons et des messages utiliss par XFB.Scope.

Ces jobs doivent tre excuts dans lordre indiqu ci-dessus. Dans les paragraphes suivants, lutilisateur de CFT/MVS trouvera en quelques mots la description de la/des fonctions de ces jobs.

4.5. Personnalisation des fichiers dinstallation de CFT/MVS (A00CUSTO)


Ce JOB personnalise les fichiers dinstallation. La personnalisation se fait directement dans la bibliothque d'installation. Il est ncessaire de QUITTER lditeur aprs avoir fait le SUBMIT. //jobname JOB account,'A00CUSTO',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* //* //CLIST EXEC PGM=IKJEFT01 //SYSPROC DD DISP=OLD,DSN=CFTV2.INSTALL //SYSTSPRT DD SYSOUT=* //SYSPRINT DD SYSOUT=* //* //SYSTSIN DD * %A01CUSTO CFTV2.INSTALL A01MEMBR /* //CFTIN DD DATA,DLM='@@' jobname 'CFT230IN' 01 Job name userid '&SYSUID' 02 User identifier (for notify) account 'ACCT' 03 Account number msgclass 'R' 04 Message class class 'P' 05 Execution class jobparm '/*JOBPARM ROOM=CFTx' 06 Job parm (//* if none) tape '3490' 07 Tape unit tapvol 'SOPnnn' 08 Tape volume cftvol 'CFTVOL' 09 CFT library volume cftunit '3390' 10 CFT library unit cftv2 'CFTV2' 11 CFT data set prefix sysout 'L' 12 Sysout class tcpsns 'SNSTCP' 13 INTERLINK tcp/ip library prefix tcpibm 'TCPIP' 14 IBM tcp/ip library prefix

CFT V2.3

4-5

Installation de CFT/MVS Version 2.3.0

lever le370 c370 sysda cicscob cicslod cobol2 acbint disc lang @@

'YES' 'CEE' '** 'VIO' 'DFH' 'DFH' 'SYS1.COB2' 'CFT2INT' '1441' 'FR'

15 16 17 18 19 20 21 22 23 24

Le/370 version YES or NO Le/370 data set prefix Not used (C/370 DS prefix) SYSUTx UNIT= VIO or SYSDA Cics cobol library prefix Cics loadlib library prefix Cobol 2 library prefix Vtam acbname for cftint Disconnect delay for cftint user CFT screen language (FR or UK)

Les paramtres en gras sont adapter votre environnement. Les mots-cls doivent rester en minuscule. La valeur de ces mots-cls doit figurer entre apostrophes. L'ordre des mots-cls ne doit pas tre modifi. Lutilisateur doit : 1. Soumettre ce JOB. 2. Quitter EDIT. 3. Attendre la fin dexcution du JOB. L'explication des diffrents mots-cls est indique dans le tableau suivant.
Tableau 7. Liste des mots-cls Mot-cl Jobname Userid Account Msgclass Class Jobparm Tape Tapvol Cftvol Cftunit Cftv2 Sysout Tcpsns Tcpibm Lever le370 c370 sysda Cicscob cicslod cobol2 acbint disc lang Explication Nom du job avec lequel seront soumis les JCL d'installation Nom de l'utilisateur avec lequel seront soumis les JCL d'installation "Account Number" avec lequel seront soumis les JCL d'installation Classe de sortie des messages Classe d'excution des JCL d'installation Paramtres relatifs aux jobs d'installation pour JES2( //* si inexistant) Type d'unit utilise pour restaurer les bibliothques d'installation Nom du volume utilis pour restaurer les bibliothques d'installation Nom du volume de cration des fichiers CFT/MVS Type d'unit disque Alias de cration des fichiers CFT/MVS Classe de sortie des comptes rendus d'excution Alias des bibliothques TCP/IP INTERLINK Alias des bibliothques TCP/IP IBM Utilisation de LE/370 (YES/NO) Alias des bibliothques LE/370 Alias des bibliothques C/370 (Inutilis) UNITNAME des fichiers temporaires de LINK-EDIT (VIO/SYSDA) Alias des bibliothques CICS pour COBOL Alias des bibliothques CICS Alias des bibliothques COBOL 2 Nom de l'ACB utilis pour les interfaces interactives sous VTAM Timer de dconnexion pour les interfaces interactives sous VTAM Langage utilis ( FR ou UK) dans les interfaces interactives

4-6

CFT V2.3

CFT/MVS Guide d'exploitation

Remarque : les paramtres 25 32 sont utiliss uniquement avec le dispositif Scurit dexploitation de CFT et sont dcrits dans le Guide des habilitations CFT/MVS.

4.5.1. Cration des fichiers dinstallation de CFT/MVS (A10ALLOC)


Ce JOB cre les fichiers dinstallation.

4.5.2. Restauration de la bande dinstallation de CFT/MVS (A11REST)


Ce JOB restaure les fichiers de la bande dinstallation. Attention : aprs avoir restaur la bande dinstallation, il est ncessaire de lire le membre "IMPORTAN" du fichier CFTV2.DOC. Ce dernier contient les dernires mises jour relatives linstallation ou lutilisation de CFT Version 2. Dans le cas o une bande de corrections est livre, il faut alors excuter une seconde fois cette tape pour lire la bande de correction en complment de la bande d'installation. Les fichiers dinstallation sont rechargs lidentique quel que soit le type de support de livraison : K7 ou CD. Lutilisateur peut par exemple installer depuis un CD, puis mettre jour depuis une K7.

4.5.3. Choix des options de fonctionnement de CFT/MVS (A120PTS)


Ce JOB gnre la tables des options de CFT/MVS. SYST = MVS

Type de systme d'exploitation supportant le moniteur. [DESC = {Valeur du champ DESCRIPTOR CODE des WTO | n}]

Le bit de gauche correspond 1, celui de droite 16. [ROUTCDE = {Valeur du champ ROUTCODE CODE des WTO | n}]

Le bit de gauche correspond 1, celui de droite 16. La valeur par dfaut ROUTCDE=X0008 correspond au ROUTCDE=(13). Cette valeur sera utilise en liaison avec loption OPERMSG du paramtre CFTLOG. Pour les options DESC et ROUTCE, consulter la brochure IBM Supervisor services and macros pour lutilisation des DESCRIPTOR CODES et ROUTCODES. [MAXAB = {15 | n} ] {1255}

Nombre d'abend permis par CFT avant son arrt. [MAXDUMP = {2 | n}] {1255}

Nombre d'abend qui feront lobjet dun DUMP demand par CFT. Les abend supplmentaires ne donneront pas lieu prise de DUMP.

CFT V2.3

4-7

Installation de CFT/MVS Version 2.3.0

[SGTRACE

= {0 | n}]

{165535}

Valeur initiale de la trace fichier SGTRACE. Une valeur diffrente de 0 sera utilise la demande du support client CFT. Les combinaisons possibles sont : 1 2 4 8 16 32 64 128 256 512 : actions du rseau (SNA/X25/TCP/LU62), : actions en erreur, : actions du gestionnaire de fichiers, : lecture/criture de fichiers, : fonctions C, : messages longs, : actions de communications entre tches, : appels et retours de programmes, : actions de linterface interactive, : appel des exits utilisateur.

Attention : lutilisation des options SGTRACE avec linterface CFT sous VTAM provoque ldition des mots de passe en clair dans les enregistrements de trace. [MAXTRACE = {128 | n}]

Taille en Ko de la trace interne de CFT. [RACFOPT = {1 | n}] {0255}

Options de fonctionnement de RACF. Ce paramtre nest utilis que dans le cas o RACF est install. Les valeurs possibles sont les suivantes : 0 : CFT nappelle pas RACF ; il manipule tous les fichiers sous son autorit, 1 : CFT soumet les procdures (JCL) de transfert avec contrle du paramtre USERID". CFT doit alors tre un programme autoris (APF), 2 : CFT alloue et ouvre les fichiers de transfert avec contrle du paramtre "USERID". CFT doit alors tre un programme autoris (APF), 3 : cumul des options de fonctionnement 1 et 2. [BLKSIZE = {27998 | n}] {410032760}

Valeur maximum utilise pour calculer le BLKSIZE des fichiers crs par CFT, lorsque cette information est absente. [BLKPDS = {150 | n}] {132760}

Nombre de blocs de PDS allous lors de la cration dun fichier partitionn par CFT.

4-8

CFT V2.3

CFT/MVS Guide d'exploitation

[TRACE

= {128 | n}]

{416383}

Taille de la trace interne de CFT Version 2 en Ko. [MAIL = {'CFTPCMBX' | n}]

Nom symbolique du service de communications CFTXMEM. Cette valeur constitue galement le DDNAME du fichier des sauvegardes du serveur de communications (Procdure CFTXMEM). [XSIZE = {1024 | n}]

Nombre maximum des entres mise en attente dans le service de CFTXMEM. [TSOEDIT = {NO | YES}]

Support des fichiers avec numros de squence en colonnes 73 80 : YES : s'ils sont crs par l'diteur ISPF avec l'option 'NUMBER ON', les fichiers en entre lus par CFTUTIL/VFMUTIL peuvent contenir un numro de squence sur 8 chiffres dans les colonnes 73 80. Ce numro de squence est alors ignor par CFT/MVS, NO : [NTFDEST les fichiers en entre sont lus inchangs par CFTUTIL/VFMUTIL. = {'CFTSCOPP' | n}]
SCOPE A&P

Nom symbolique de la file dattente XCF utilise par XFB.Scope. Ce paramtre est utilis uniquement avec le logiciel complmentaire A&P. [ARM = {YES | NO}]

Support du composant Automatic Restart Manager par le moniteur de transferts CFT/MVS : YES : CFT/MVS est autoris (APF) et s'enregistre auprs du composant ARM. Il utilise un lment de nom Xidparm , idparm tant le paramtre de lancement du moniteur CFT (voir galement le paragraphe Utilisation des services Automatic Restart Manager, NO : CFT/MVS ne senregistre pas.

4.5.4. LINK-EDIT de CFT/MVS (B20LINK)


Ce JOB fait le LINK-EDIT des modules de CFT/MVS.Le message IEW2635I est ignorer. Remarque : il est conseill de conserver le listing dexcution de ce job. Les programmes CFTMAIN/CFTMA31 seront copis dans une bibliothque autorise de APF, pour les cas suivants o CFT/MVS : crit des enregistrements ACCOUNT dans SMF, utilise des options RACF, envoie des messages des utilisateurs TSO,

CFT V2.3

4-9

Installation de CFT/MVS Version 2.3.0

utilise des UCB dynamiques (DRM) ou dfinis en 31 bits dans IODF, utilise les services ARM. Les programmes CFTINTV/CFTIN31, CFTXMEM, CFTIUI, sont copis dans une bibliothque autorise APF, sils sont utiliss. Remarque : le code retour du LINK-EDIT doit tre infrieur ou gal 4.

4.5.5. Installation des modules rseau TCP/IP 4.5.5.1. LINK-EDIT de CFT/MVS pour TCP/IP IBM (B22LTCP)
Ce JOB est utiliser pour TCP/IP IBM(eNetwork CS). Ce JOB sera galement utilis pour UNICENTER TCPACCESS version 5.2 et suivantes avec interface de compatibilit IBM HPNS. Remarque importante : le LINK-EDIT des modules utilisant TCP/IP doit tre ralis avec les interfaces SOCKET de TCP/IP, bibliothques "tcpip.SEZACMTX" en tte des SYSLIB. Le LINK-EDIT des modules utilisant TCP/IP doit tre ralis de prfrence sur le systme MVS cible ou a dfaut sur une version OS/390 V2 R10. La bibliothque LE/370 CEE.SCEELKED contient les interfaces SOCKET() de OPENEDITION non utilisables par CFT, et des services communs qui sont ncessaires au LINK-EDIT. Toujours placer au LINK-EDIT les bibliothques TCP/IP avant les bibliothques LE/370. Exemple : //SYSLIB DD //* // DD DD DSN=TCPIP.SEZACMTX, DSN=solve.LOAD, DSN=CEE.SCEELKED, Uniquement pour TCPACCESS

A lexcution, dans le cas o ces bibliothques seraient en LINKLIST , dans un ordre contraire, il faut galement forcer dans lordre TCP/IP puis LE/370 dans les STEPLIB. Cette mthode est imprative avec UNICENTER :TCPACCESS. Exemple : //STEPLIB DD // // DD DD DSN=cftv2.LOAD, DSN=solve.LINK, DSN=CEE.SCEERUN, Uniquement pour TCPACCESS

Remarques : Il est conseill de conserver le listing dexcution de ce job. Le code retour du LINK-EDIT doit tre infrieur ou gal 4. Les modules crs dans cette tape ne sont pas r-entrants.

4-10

CFT V2.3

CFT/MVS Guide d'exploitation

4.6. LINK-EDIT des programmes CICS (B24LCICS)


Ce JOB fait le LINK-EDIT des modules CFTI, interrogation du catalogue CFT depuis CICS et CFTC, demandes adresses CFT. Cette tape est facultative. Le chapitre "API CFT : mise en uvre sous CICS" indique la procdure pour INSTALLER et UTILISER ces 2 programmes. Remarque : le code retour du LINK-EDIT doit tre gal 0.

CFT V2.3

4-11

5. Installation de CFT/MVS Version 2.3.1

5.1. Installation de CFT/MVS


La procdure suivante indique les principales tapes de cette installation : 1 Dfinition dun ALIAS CFT Version 2 (facultatif). 2 3 4 5 6 7 Restauration des fichiers dinstallation partir dune K7 ou Transfert des fichiers dinstallation depuis un CD. Dcompression des fichiers dinstallation. Adaptation des jobs dinstallation aux standards de lexploitation. Soumission des jobs dinstallation. Paramtrage de CFT version 2. Personnalisation des procdures CFT version 2.

5.2. Dfinition dun ALIAS CFT version 2


Si les noms de fichiers mentionns dans les diffrents jobs dinstallation sont conservs par lexploitation, il est possible de crer un ALIAS CFTV2 dans un USER CATALOG, dfini de la manire suivante. //jobname JOB account,'DEFALIAS',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //DEFALIAS EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=sysout //SYSIN DD * DEFINE ALIAS(NAME(CFTV2) RELATE(USER.CATALOG)) ................... /* // Les paramtres en gras sont adapter votre environnement.

CFT V2.3

5-1

Installation de CFT/MVS Version 2.3.1

5.3. Restauration de la bibliothque dinstallation


Lutilisateur peut recharger les fichiers indiffremment depuis une K7 ou un CD. Les fichiers installs sont alors interchangeables.

5.3.1. Restauration des fichiers dinstallation a partir dune cassette


Sur le premier label (et seul label) de la bande se trouvent le JCL damorce dinstallation du produit ainsi que le produit XFB/CFT (sous un format ADRDSSU + XMIT (lrecl=80)). A lissue du chargement une librairie temporaire sera cre contenant deux membres : jclins : JCL permettant lamorce de linstallation de XFB/CFT, cftmvs : produit XFB/CFT. Lutilisateur de CFT/MVS trouvera, ci-dessous, un exemple de JCL utiliser pour restaurer les fichiers dinstallation de CFT. Exemple : RESTAURE : restauration du fichier INSTALL //jobname JOB account,'RESTAURE',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //RESTAURE EXEC PGM=IEBCOPY //SYSPRINT DD SYSOUT=sysout //TAPE DD DSN=CFTV2.INIT,VOL=SER=SOPnnn, // UNIT=3480, // DISP=OLD, // LABEL=(1,SL) //DISK DD DSN=CFTV2.UPLIB, // UNIT=SYSDA,DISP=(NEW,CATLG), // SPACE=(CYL,(40,15,5,),RLSE), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=3120), // VOL=SER=XXXXXX //SYSIN DD * COPY INDD=TAPE,OUTDD=DISK /* // Les paramtres en gras sont adapter votre environnement. Le nom de volume SOPnnn figure sur ltiquette de la cartouche.

5-2

CFT V2.3

CFT/MVS Guide d'exploitation

5.3.2. Transfert des fichiers dinstallation depuis un CD 5.3.2.1. Configuration ncessaire


Pour procder linstallation de CFT/MVS livr sur CD-ROM, lutilisateur doit disposer : d'une station de travail quipe dun lecteur de CD-ROM, d'un logiciel client FTP permettant le transfert de fichiers vers le HOST MVS, d'un rseau TCP/IP de performances suffisantes pour transfrer environ 30 mga-octets de donnes (1 mgabit/seconde est souhaitable). Pour raliser linstallation de CFT/MVS, les tapes suivantes sont droules : 1. Transfert du CD-ROM vers MVS, par FTP, des fichiers de livraison. Cette tape ncessite environ 40 cylindres 3390 despace disque ct MVS. 2. Dcompression et rechargement des fichiers dinstallation. Cette tape ncessite environ 200 cylindres supplmentaires despace disque.

5.3.2.2. Transfert des fichiers d'un CD par FTP


Les fichiers de livraison se trouvent sous le rpertoire install du CD-ROM. Pour les transfrer vers MVS, vous devez procder de la manire suivante : 1. Copier et adapter le fichier paramtre ftp.prm. Les paramtres prciser sont : ladresse du host, le userid TSO, le mot passe associ, le prfixe de la librairie temporaire dinstallation ( prciser 3 fois) (note : le paramtre volume est optionnel). 2. Transfrer les fichiers de livraison vers le host avec, par exemple, la commande : FTP s:ftp.prm Le fichier jclins.txt sera transfr avec conversion. Le fichier cftmvs.bin sera transfr sans conversion ASCII<>EBCDIC. Liste du fichier ftp.prm : open hostname userid userpsw quote site volume=xxxxxx quote site cyl quote site primary=35 quote site secondary=15 quote site recfm=fb lrecl=80 quote site directory=10 mkdir 'dznindx.UPLIB' ascii put d:\Install\jclins.txt 'dznindx.UPLIB(JCLINS)' binary put MVS-CFT-2.3.1-tag-date 'dznindx.UPLIB(CFTMVS)' bye Les paramtres en gras sont adapter votre environnement.

CFT V2.3

5-3

Installation de CFT/MVS Version 2.3.1

5.4. Dcompression des fichiers de livraison


Cette tape est commune tous les modes de livraison. A partir de la librairie restaure ou transfre (cftv2.UPLIB), il faut dans un premier temps adapter le JCL JCLINS puis le soumettre. Cette procdure va raliser plusieurs oprations : 1. Transformation du fichier produit en fichier de type ADRDSSU. 2. Restauration des fichiers de distribution CFT via ADRDSSU. 3. Cration de lenvironnement CFT user ou cible. 4. Copie de certains composants CFT de lenvironnement de distribution vers lenvironnement cible. Aprs cette tape, le processus dinstallation est similaire une installation CFT V2.3.0, en notant que les tapes A10ALLOC et A11REST nont plus lieu dtre. Lutilisateur conservera lenvironnement de distribution en ltat et adaptera son environnement cible. Remarque : les fichiers de distribution sont restaurs avec quatre niveaux index (ADRDSSU), 3 sont modifiables par lutilisateur via le paramtre RENAMEUNC de lutilitaire ADRDSSU. Par exemple : AXWAY.XFB.CFT00231.CF0level.CNTL RENAMEUNC ((AXWAY.XFB.CFT00231.**, -' PRODUCT.AXWAYXFB.CFT00231.**)) -'

5.5. Adaptation des JOB dinstallation lexploitation


Les JOB contenus dans cette bibliothque sont les suivants : 1 : A00CUSTO : personnalisation des jobs d'installation, 2 : A12OPTS 3 : B20LINK 4 : B22LTCP 5 : B22LTCPX 6 : B24CICS 7 : C31SCRxx 8: C32XMEM 9 : C33CNFxx 10 : C33MON 11 : D40INIT 12 : D41AIX1 13 : D41AIX2 14 : D42SSL : choix des options de fonctionnement de CFT version 2, : LINK-EDIT gnral des modules CFT, : LINK-EDIT spcifiques TCP/IP IBM, : LINK-EDIT spcifiques TCP/IP UNICENTER:TCPACCESS : LINK-EDIT de linterface de programmation CICS, : allocation des fichiers des crans (Franais et/ou Anglais), : allocation du fichier de sauvegardes des communications, : allocation du fichier de configuration (Franais et/ou Anglais), : allocation du fichier des moniteurs, : initialisation des fichiers dexcution de CFT Version 2, : dfinition de lindex altern du catalogue, : construction de lindex altern du catalogue, : cration d'une base de donnes exprimentale de cls et de certificats SSL,

5-4

CFT V2.3

CFT/MVS Guide d'exploitation

15 : D43PKI 16 : E50PARM 17 : F60VFMC 18 : G70VTAM 19 : G71LOGM 20 : H80EXEC 21 : I90VALID 22 : SN00CUST

: cration d'une base de donnes PKI, : fourniture d'un exemple de paramtrage CFTPARM, : fourniture d'un exemple de cration de base VFM, : fourniture d'un exemple de paramtrage de VTAMLST, : fourniture d'un exemple de MODETAB utilise par CFT Version 2, : cration de procdures (fin de transferts, bascule log...) CFT Version 2, : validation de l'installation de CFT Version 2, : personnalisation du fichier de configuration SENTINEL.

Ces jobs doivent tre excuts dans lordre indiqu ci-dessus. Dans les paragraphes suivants, lutilisateur de CFT/MVS trouvera en quelques mots la description de la ou des fonctions de ces jobs.

5.6. Personnalisation des fichiers dinstallation de CFT/MVS (A00CUSTO)


Ce JOB personnalise les fichiers dinstallation (environnement USER). La personnalisation se fait directement dans la bibliothque d'installation (environnement USER). Il est ncessaire de QUITTER lditeur aprs avoir fait le SUBMIT. //jobname JOB account,'A00CUSTO',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* // SET CFTV2=cftv2 Target prefix Environment //* //* //CLIST EXEC PGM=IKJEFT01, // PARM='%A01CUSTO &CFTV2..INSTALL' //SYSPROC DD DISP=OLD,DSN=&CFTV2..INSTALL //INSTMBR DD DISP=SHR,DSN=&CFTV2..INSTALL(A01MEMBR) //SYSTSPRT DD SYSOUT=* //SYSPRINT DD SYSOUT=* //SYSTSIN DD DUMMY //CFTIN DD DATA,DLM='@@' jobname 'CFT230IN' 01 Job name userid '&SYSUID' 02 User identifier (for notify) account 'ACCT' 03 Account number msgclass 'R' 04 Message class class 'P' 05 Execution class jobparm '/*JOBPARM ROOM=CFTx' 06 Job parm (//* if none) tape '3490' 07 Tape unit tapvol 'SOPnnn' 08 Tape volume cftvol 'CFTVOL' 09 CFT library volume cftunit '3390' 10 CFT library unit cftv2 'CFTV2' 11 CFT data set prefix sysout 'L' 12 Sysout class tcpsns 'SNSTCP' 13 UNICENTER:tcpaccess lib prefix tcpibm 'TCPIP' 14 IBM tcp/ip library prefix lever 'YES' 15 Le/370 version YES or NO

CFT V2.3

5-5

Installation de CFT/MVS Version 2.3.1

le370 c370 sysda cicscob cicslod cobol2 acbint disc lang .. iuisp iuinsp apisaddr apisp distlib distlev @@

'CEE' '** 'VIO' 'DFH' 'DFH' 'SYS1.COB2' 'CFT2INT' '1441' 'FR'

16 17 18 19 20 21 22 23 24

Le/370 data set prefix Not used (C/370 DS prefix) SYSUTx UNIT= VIO or SYSDA Cics cobol library prefix Cics loadlib library prefix Cobol 2 library prefix Vtam acbname for cftint Disconnect delay for cftint user CFT screen language (FR or UK)

'2975' '2976' '127.0.0.1' '7010' 'AXWAY.XFB.CFT00231' 'CF006439'

33 34 35 36

IUI TCP/IP secured port IUI TCP/IP unsecured port synchronous API TCP/IP address synchronous API TCP/IP port

37 Distrib library prefix 38 level distribution

Les paramtres en gras sont adapter votre environnement. Les mots-cls doivent rester en minuscule. La valeur de ces mots-cls doit figurer entre apostrophes. L'ordre des mots-cls ne doit pas tre modifi. Lutilisateur doit : 1 Soumettre ce JOB. 2 3 Quitter EDIT. Attendre la fin dexcution du JOB.

L'explication des diffrents mots-cls est indique dans le tableau suivant :


Tableau 8. Liste des mots-cls Mot-cl Jobname Userid Account Msgclass Class Jobparm Tape Tapvol Cftvol Cftunit Cftv2 Sysout Tcpsns Tcpibm Lever le370 Explication Nom du job avec lequel seront soumis les JCL d'installation Nom de l'utilisateur avec lequel seront soumis les JCL d'installation "Account Number" avec lequel seront soumis les JCL d'installation Classe de sortie des messages Classe d'excution des JCL d'installation Paramtres relatifs aux jobs d'installation pour JES2( //* si inexistant) Type d'unit utilise pour restaurer les bibliothques d'installation Nom du volume utilis pour restaurer les bibliothques d'installation Nom du volume de cration des fichiers CFT/MVS Type d'unit disque Alias de cration des fichiers CFT/MVS Classe de sortie des comptes rendus d'excution Alias des bibliothques TCP/IP UNICENTER : TCPACCESS Alias des bibliothques TCP/IP IBM Utilisation de LE/370 (YES/NO) Alias des bibliothques LE/370

5-6

CFT V2.3

CFT/MVS Guide d'exploitation Tableau 8. Liste des mots-cls (suite) Mot-cl c370 sysda Cicscob cicslod cobol2 acbint disc lang iuisp iuinsp apisaddr apisp distlib distlev Explication Alias des bibliothques C/370 (Inutilis) UNITNAME des fichiers temporaires de LINK-EDIT (VIO/SYSDA) Alias des bibliothques CICS pour COBOL Alias des bibliothques CICS Alias des bibliothques COBOL 2 Nom de l'ACB utilis pour les interfaces interactives sous VTAM Timer de dconnexion pour les interfaces interactives sous VTAM Langage utilis ( FR ou UK) dans les interfaces interactives Port scuris pour XFB.UI Port non scuris pour XFB.IUI Adresse TCP/IP de lAPI synchrone Port de lAPI synchrone Alias de lenvironnement de distribution Niveau version distribution

Remarque : les paramtres 25 32 sont utiliss uniquement avec le dispositif Scurit dexploitation de CFT et sont dcrits dans le Guide des habilitations CFT/MVS.

5.6.1. Choix des options de fonctionnement de CFT/MVS (A120PTS)


Ce JOB gnre la tables des options de CFT/MVS. SYST = MVS

Type de systme d'exploitation supportant le moniteur. [DESC = {Valeur du champ DESCRIPTOR CODE des WTO | n}]

Le bit de gauche correspond 1, celui de droite 16. [ROUTCDE = {Valeur du champ ROUTCODE CODE des WTO | n}]

Le bit de gauche correspond 1, celui de droite 16. La valeur par dfaut ROUTCDE=X0008 correspond au ROUTCDE=(13). Cette valeur sera utilise en liaison avec loption OPERMSG du paramtre CFTLOG. Pour les options DESC et ROUTCE, consulter la brochure IBM Supervisor services and macros pour lutilisation des DESCRIPTOR CODES et ROUTCODES. [MAXAB = {15 | n}] {1255}

Nombre d'abend permis par CFT avant son arrt. [MAXDUMP = {2 | n}] {1255}

Nombre d'abend qui feront lobjet dun DUMP demand par CFT. Les abend supplmentaires ne donneront pas lieu prise de DUMP.

CFT V2.3

5-7

Installation de CFT/MVS Version 2.3.1

[SGTRACE

= {0 | n}]

{165535}

Valeur initiale de la trace fichier SGTRACE. Une valeur diffrente de 0 sera utilise la demande du support client CFT. Les combinaisons possibles sont : 1 2 4 8 16 32 64 128 256 512 : actions du rseau (SNA/X25/TCP/LU62), : actions en erreur, : actions du gestionnaire de fichiers, : lecture/criture de fichiers, : fonctions C, : messages longs, : actions de communications entre tches, : appels et retours de programmes, : actions de linterface interactive, : appel des exits utilisateur.

Attention : lutilisation des options SGTRACE avec linterface CFT sous VTAM provoque ldition des mots de passe en clair dans les enregistrements de trace. [MAXTRACE = {128 | n}]

Taille en Ko de la trace interne de CFT. [RACFOPT = {1 | n}] {0255}

Options de fonctionnement de RACF. Ce paramtre nest utilis que dans le cas o RACF est install. Les valeurs possibles sont les suivantes : 0 : CFT nappelle pas RACF ; il manipule tous les fichiers sous son autorit, 1 : CFT soumet les procdures (JCL) de transfert avec contrle du paramtre USERID". CFT doit alors tre un programme autoris (APF), 2 : CFT alloue et ouvre les fichiers de transfert avec contrle du paramtre "USERID". CFT doit alors tre un programme autoris (APF), 3 : cumul des options de fonctionnement 1 et 2. [BLKSIZE = {27998 | n}] {410032760}

Valeur maximum utilise pour calculer le BLKSIZE des fichiers crs par CFT, lorsque cette information est absente. [BLKPDS = {150 | n}] {132760}

Nombre de blocs de PDS allous lors de la cration dun fichier partitionn par CFT.

5-8

CFT V2.3

CFT/MVS Guide d'exploitation

[TRACE

= {128 | n}]

{416383}

Taille de la trace interne de CFT Version 2 en Ko. [MAIL = {'CFTPCMBX' | n}]

Nom symbolique du service de communications CFTXMEM. Cette valeur constitue galement le DDNAME du fichier des sauvegardes du serveur de communications (Procdure CFTXMEM). [XSIZE = {1024 | n}]

Nombre maximum des entres mise en attente dans le service de CFTXMEM. [TSOEDIT = {NO | YES}]

Support des fichiers avec numros de squence en colonnes 73 80 : YES : s'ils sont crs par l'diteur ISPF avec l'option 'NUMBER ON', les fichiers en entre lus par CFTUTIL/VFMUTIL peuvent contenir un numro de squence sur 8 chiffres dans les colonnes 73 80. Ce numro de squence est alors ignor par CFT/MVS, NO : [ARM les fichiers en entre sont lus inchangs par CFTUTIL/VFMUTIL. = {YES | NO}]

Support du composant Automatic Restart Manager par le moniteur de transferts CFT/MVS : YES : CFT/MVS est autoris (APF) et s'enregistre auprs du composant ARM. Il utilise un lment de nom Xidparm , idparm tant le paramtre de lancement du moniteur CFT (voir galement le chapitre Utilisation des services Automatic Restart Manager), NO : CFT/MVS ne senregistre pas.

5.6.2. LINK-EDIT de CFT/MVS (B20LINK)


Ce JOB fait le LINK-EDIT des modules de CFT/MVS.Le message IEW2635I est ignorer. Remarque : il est conseill de conserver le listing dexcution de ce job. Les programmes CFTMAIN/CFTMA31 seront copis dans une bibliothque autorise de APF, pour les cas suivants o CFT/MVS : crit des enregistrements ACCOUNT dans SMF, utilise des options RACF, envoie des messages des utilisateurs TSO, utilise des UCB dynamiques (DRM) ou dfinis en 31 bits dans IODF, utilise les services ARM. Les programmes CFTINTV/CFTIN31, CFTXMEM, CFTIUI, sont copis dans une bibliothque autorise APF, sils sont utiliss.

CFT V2.3

5-9

Installation de CFT/MVS Version 2.3.1

Remarque : le code retour du LINK-EDIT doit tre infrieur ou gal 4.

5.6.3. Installation des modules rseau TCP/IP 5.6.3.1. LINK-EDIT de CFT/MVS pour TCP/IP IBM (B22LTCP)
Ce JOB est utiliser pour TCP/IP IBM(eNetwork CS). Remarque importante : le LINK-EDIT des modules utilisant TCP/IP doit tre ralis avec les interfaces SOCKET de TCP/IP. Les modules rentrant TCP/IP sont inclus partir de la librairie tcpip.TSEZARNT1. Il est important de respecter lordre des bibliothques au niveau des SYSLIB. Le LINK-EDIT des modules utilisant TCP/IP doit tre ralis de prfrence sur le systme MVS cible ou a dfaut sur une version OS/390 V2 R10. La bibliothque LE/370 CEE.SCEELKED contient les interfaces SOCKET() de OPENEDITION non utilisables par CFT, et des services communs qui sont ncessaires au LINK-EDIT. Toujours placer au LINK-EDIT les bibliothques TCP/IP avant les bibliothques LE/370. Exemple : //RNT1 //SYSLIB // // DD DD DD DD DSN=&TCP..SEZARNT1,DISP=SHR DSN=&TCP..SEZACMTX,DISP=SHR DSN=&LE..SCEELKED,DISP=SHR DSN=SYS1.CSSLIB,DISP=SHR

A lexcution, dans le cas o ces bibliothques seraient en LINKLIST , dans un ordre contraire, il faut galement forcer dans lordre TCP/IP puis LE/370 dans les STEPLIB. Exemple : //STEPLIB DD // DD DSN=cftv2.LOAD, DSN=CEE.SCEERUN,

Remarques : Il est conseill de conserver le listing dexcution de ce job. Le code retour du LINK-EDIT doit tre infrieur ou gal 4.

5.6.3.2. LINK-EDIT de CFT/MVS pour TCP/IP INTERLINK (B22LTCPX)


Ce JOB est utilis pour UNICENTER TCPACCESS version 5.2 et suivantes avec interface de compatibilit IBM HPNS. Remarque importante : Le LINK-EDIT des modules utilisant TCP/IP se droule en deux tapes : un PRELINK suivi dun LINK-EDIT. Lordre des librairies au niveau SYSLIB des PRELINK et LINK-EDIT sont respecter. Exemple : au niveau du PRELINK : //RNT1 DD DISP=SHR,DSN=tcpip.SEZARNT1 //SYSLIB DD DISP=SHR,DSN=tcpip.SEZARNT1 // DD DISP=SHR,DSN=&LE..SCEEOBJ TCPIP RENT TCPIP RENT

5-10

CFT V2.3

CFT/MVS Guide d'exploitation

au niveau du LINK-EDIT :
//SYSLIB // // DD DD DD DISP=SHR,DSN=&LE..SCEELKED DISP=SHR,DSN=SYS1.CSSLIB DISP=SHR,DSN=tcpip.LOAD LE/370 UNICENTER TCP/ACCESS

A lexcution, dans le cas o ces bibliothques seraient en LINKLIST , dans un ordre contraire, il faut galement forcer dans lordre TCP/IP puis LE/370 dans les STEPLIB. Cette mthode est imprative avec UNICENTER :TCPACCESS. Exemple : //STEPLIB DD // DD // DD DSN=cftv2.LOAD, DSN=solve.LINK, DSN=CEE.SCEERUN,

Uniquement pour TCPACCESS

Remarques : Il est conseill de conserver le listing dexcution de ce job. Le code retour du LINK-EDIT doit tre infrieur ou gal 4.

5.7. LINK-EDIT des programmes CICS (B24LCICS)


Ce JOB fait le LINK-EDIT des modules CFTI, interrogation du catalogue CFT depuis CICS, et CFTC, demandes adresses CFT. Cette tape est facultative. Le chapitre CFT : mise en oeuvre sous CICS indique la procdure pour INSTALLER et UTILISER ces 2 programmes. Remarque : le code retour du LINK-EDIT doit tre gal 0.

CFT V2.3

5-11

6. Cration de lenvironnement CFT/MVS

6.1. Formatage des fichiers de travail de CFT/MVS (D40INIT)


Ce chapitre fournit les donnes ncessaires pour la mise en uvre dun paramtrage de base de CFT version 2.3.0 et suivantes, dans le cadre de son installation. Ces fichiers de travail sont : CFTPARM : fichier VSAM KSDS, description des paramtres de CFT, CFTPART CFTCAT CFTLOG1 CFTLOG2 CFTACNT1 CFTACNT2 CFTCOM : fichier VSAM KSDS, description des partenaires de CFT, : fichier VSAM ESDS, catalogue de CFT, : fichier squentiel utilis comme journal par CFT, : fichier squentiel utilis par CFT comme journal altern du prcdent, : fichier squentiel utilis comme fichier comptable par CFT, : fichier comptable altern, : fichier VSAM ESDS utilis par CFT comme tampon pour les commandes CFT Version 2 soumises par CFTUTIL, un programme batch, un utilisateur TSO, linterface Internet XFB.IUI.

Le JOB D40INIT prpare les fichiers de CFT/MVS. Avant de soumettre ce job, les points suivants doivent tre adapts aux besoins de lenvironnement : les noms des fichiers (si les valeurs par dfaut des exemples ne sont pas satisfaisantes), les valeurs des paramtres RECNB et FSPACE.

6.2. Dfinition de lindex altern du catalogue (D41AIX1, D41AIX2)


Remarque : cette tape sera excute uniquement si vous utilisez le module CFTI dinterrogation du catalogue, depuis CICS. Le JCL qui suit est un exemple de dfinition de lindex altern du catalogue. Il se compose de deux JOBs (D41AIX1 et D41AIX2). //jobname JOB account,'D41AIX1',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* //AIX PROC OUT=sysout //DEFAIX EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=&OUT // PEND //DEF EXEC AIX //SYSIN DD * /* DELETE/DEFINE SECONDARY INDEX */

CFT V2.3

6-1

Cration de lenvironnement CFT/MVS

DELETE cftv2.CFTAIX AIX PURGE DEFINE AIX (NAME (cftv2.CFTAIX) VOL (cftvol) KEYS (62 4) CYL (1 1) SHAREOPTIONS (4 3) IMBED SPEED CISZ (4096) UNIQUE NONUNIQUEKEY UPGRADE RELATE (cftv2.CATALOG))INDEX (NAME (cftv2.CFTAIX.INDEX))DATA (NAME (cftv2.CFTAIX.DATA)) IF LASTCC = 0 THEN /* DEFINE VOIE D ACCES */ DEFINE PATH (NAME (cftv2.CFTPATH) UPDATE PATHENTRY (cftv2.CFTAIX)) /* // //jobname JOB account,'D41AIX2',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* //BUILD PROC OUT=sysout, // QUAL=cftv2 //BLDINDEX EXEC PGM=IDCAMS //SYSOUT DD SYSOUT=&OUT //SYSPRINT DD SYSOUT=&OUT //CATALOG DD DISP=SHR,DSN=&QUAL..CATALOG //CFTAIX DD DISP=SHR,DSN=&QUAL..CFTAIX // PEND //BUILDX EXEC BUILD //SYSIN DD * /* CONSTRUCTION DE L INDEX SECONDAIRE */ BLDINDEX INFILE(CATALOG) OUTFILE(CFTAIX) INTERNALSORT /* // Les paramtres en gras seront remplacs lors de la phase de personnalisation.

6-2

CFT V2.3

CFT/MVS Guide d'exploitation

6.3. Cration du fichier PKI de CFT/MVS (D43PKI)


Le fichier PKI contient toutes les informations ncessaires lutilisation du composant SSL : autorits de certification, certificats, cls prives. Les exemples sont crs partir du logiciel OPENSSL, de lInstitut Fdral Suisse de technologie. Ltape D43PKI cre un fichier VSAM KSDS et linitialise avec les exemples livrs. Pour mettre jour le fichier PKIFILE, vous pouvez utiliser le modle dutilitaire CFTPKI. Consultez le "Guide de la scurit de transport" pour lexplication dtaille de lutilitaire CFTPKI. Remarques importantes : les exemples livrs sont uniquement destins vrifier le bon fonctionnement du composant SSL. Ils ne doivent en aucun cas tre utiliss dautres fins, lutilisateur doit prendre toutes les mesures de scurit appropries pour garantir la confidentialit des donnes de scurit, lutilisation du chiffrement des donnes est soumise des obligations lgales, variables selon les pays.

CFT V2.3

6-3

7. Installation des menus CFT

7.1. Menus CFT


Les menus CFT sont utilisables sous TSO ou depuis un cran VTAM. Ces menus apportent les possibilits suivantes un oprateur CFT : envoyer une commande CFT, interroger de faon slective le fichier catalogue de CFT Version 2, interroger et/ou mettre jour de faon slective les fichiers paramtres et partenaires de CFT Version 2, examiner le fichier journal.

7.2. Cration des fichiers de linterface interactive (C31SCRxx)


Linterface interactive de CFT utilise (par langage) les fichiers suivants : sept fichiers VSAM : ces fichiers sont crs et chargs par lutilitaire IDCAMS, un fichier squentiel : ce fichier est cr et charg par lutilitaire CFTUTIL. En fonction de la langue utilise (FR pour le franais, UK pour langlais), la cration se fera avec le job C31SCRFR pour la version franaise, et C31SCRUK pour la version anglaise.

7.3. Serveur de communications OS/390


Le serveur de communications permet dacclrer le traitement des commandes de transfert, normalement dposes dans un fichier. Son installation et son utilisation sont facultatives.

7.3.1. Mise en uvre (C32XMEM)


Le serveur de communications (MAILBOX) de CFT/MVS utilise un espace adresse de donnes (DIV), partag entre tous les utilisateurs CFT/MVS du mme ordinateur. Le serveur de communications est accessible tous les utilisateurs par une instruction PC de type GLOBAL. Pour cette raison, il est RECOMMANDE de ne jamais stopper le serveur. Lespace adresse de donnes est sauvegard dans un fichier VSAM LINEAR. Chaque commande de configuration CFTCOM TYPE=MBX,NAME=nnn , rserve 1024 pages dans lespace DIV, et donc 1024 blocs de 4K dans le fichier de sauvegarde (environ 7 cylindres de 3390).

CFT V2.3

7-1

Installation des menus CFT

Un seul serveur gre toutes les communications dun ou plusieurs CFT/MVS du mme ordinateur. Il doit tre actif avant linitialisation dun moniteur CFT. Chaque moniteur CFT doit faire rfrence un nom de bote lettres diffrent. Le JOB C32XMEM cre le fichier de sauvegarde du serveur. Remarque : le serveur de communications nest pas accessible aux applications sexcutant sur des ordinateurs diffrents dans un SYSPLEX.

7.4. Utilisation (CFTXMEM)


Le JCL qui suit est un exemple de procdure dactivation du serveur de communications : //jobname JOB account,'CFTXMEM',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* //CFTXMEM PROC OUT=sysout, // QUAL=cftv2 //CFTXMEM EXEC PGM=CFTXMEM, // REGION=3000K, // TIME=1440 ** OBLIGATOIRE ** //STEPLIB DD DISP=SHR,DSN=&QUAL..LOAD //CFTPCMBX DD DISP=SHR,DSN=&QUAL..CFTXMEM //SYSUDUMP DD SYSOUT=&OUT //SGTRACE DD SYSOUT=&OUT //SGSTAE DD SYSOUT=&OUT // PEND //GO EXEC CFTXMEM // Les paramtres en gras seront remplacs lors de la phase de personnalisation. Le DDNAME du fichier de sauvegarde correspond la valeur du paramtre MAIL= de SGINSTAL (voir A12OPTS). La valeur par dfaut est CFTPCMBX.

7.5. Cration du fichier de configuration (C33CNFxx)


Ce fichier sert de modle chaque utilisateur de l'interface interactive de CFT. En fonction de la langue utilise (FR pour le franais, UK pour langlais), la cration se fait avec le job C33CNFFR pour la version franaise, et C33CNFUK pour la version anglaise. Pour le crer, lutilisateur doit fournir en entre les paramtres suivants : COUNTRYCODE = {FR | UK} Code du langage utilis. FR pour le franais, UK pour langlais.

7-2

CFT V2.3

CFT/MVS Guide d'exploitation

DATEFORMAT = date Format de la date affiche : JJ/MM/AA, JJMMAAAA, SSAAMMJJ ou MM/JJ/AA. TIMEFORMAT = time Format de lheure : HHMM (heures et minutes) ou HH:MM (heures et minutes). MONITORFILENAME = filename Nom du fichier des moniteurs CFT accessibles sous forme de DDNAME prcd par $, ou sous forme de DSNAME. USERFILENAME = filename Nom du fichier de sauvegarde de l'environnement d'un utilisateur cod sous forme de DSNAME. La variable symbolique &USER sera remplace par le nom de lutilisateur. Ce nom sera cod sous la forme : CFTVOL%CFTUNIT%DSNAME , CFTVOL et CFTUNIT sont facultatifs. SELECTIONFILENAME = filename Nom du fichier temporaire de selection qui sera utilis pour transfrer des fichiers gnriques ou une slection des membres d'une bibliothques cod sous forme de DSNAME. La variable symbolique &USER sera remplace par le nom de lutilisateur. Ce nom sera cod sous la forme : CFTVOL%CFTUNIT%DSNAME , CFTVOL et CFTUNIT sont facultatifs. Il est recommand de gnrer un nom de fichier unique par utilisateur. # Indique une carte commentaire. Exemple de configuration en franais : # # Code pays # COUNTRYCODE = FR # # Format de la date ** A PERSONNALISER # DATEFORMAT = JJ/MM/AA # # Format de l'heure ** A PERSONNALISER # TIMEFORMAT = HH:MM # # Nom du fichier des moniteurs ** A PERSONNALISER # ddname predefini: CFTFMON # MONITORFILENAME = $CFTFMON # # Nom du fichier utilisateur # &USER doit tre substitue par le user tso ** A PERSONNALISER

CFT V2.3

7-3

Installation des menus CFT

# USERFILENAME = cftvol%%&USER.CFTSAVE.CONFIG # # Nom du fichier de selection # &USER doit tre substitue par le user tso ** A PERSONNALISER # SELECTIONFILENAME = &USER.CFTV2.D&3.6DATE.H&1.6TIME Les paramtres en gras seront remplacs lors de la phase de personnalisation.

7.6. Cration du fichier des moniteurs (C33MON)


Ce fichier sert dfinir les moniteurs CFT grs par linterface interactive. Pour le crer, vous devez fournir en entre les paramtres suivants : PARAMETERFILENAME = filename Le nom du fichier des paramtres CFT accessibles sous forme de DDNAME prcd par $, ou sous forme de DSNAME. CFTPARMID = identifier Identifiant d'un CFTPARM se trouvant dans le fichier paramtre. Ces deux paramtres peuvent tre rpts plusieurs fois. Exemple de configuration : # Nom du fichier parametre # Parameter file name # PARAMETERFILENAME = $CFTPARM # # Identifiant d'un CFTPARM # CFTPARM identifier # CFTPARMID = IDPARM0 ** A PERSONNALISER

** A PERSONNALISER

7.7. Appel des menus CFT


7.7.1. Sous TSO (CFT)
Le membre CFT de la bibliothque CFTV2.INSTALL est un exemple dappel aux menus CFT sous TSO. Pour excuter cette CLIST, une REGION TSO DE 4000K est ncessaire.

7-4

CFT V2.3

CFT/MVS Guide d'exploitation

7.7.2. Sous VTAM (CFTINT)


CFT/MVS dispose de deux modes de fonctionnement pour linterface cran : dans une rgion spare du moniteur CFT/MVS. Le programme CFTINTV peut recevoir au maximum quatre paramtres, dont lordre est impos : paramtres 1 et 2 : SGTRACE nnn. Redfinit loption SGTRACE de la macro SGINSTAL. Ces 2 paramtres sont lis et facultatifs, paramtres 3 et 4 : ACBNAME DISC. Ces 2 paramtres sont lis et obligatoires, avec : - ACBNAME : nom de lAPPLID VTAM qui sera rserv cette application, - DISC : dlai en minutes de libration du terminal inactif. La valeur 1440 indique que les terminaux inactifs ne sont jamais librs. Le membre CFTINT de la bibliothque CFTV2.INSTALL est un exemple de lancement de ce programme, en sous-tche du moniteur CFT/MVS (programme CFTINT31). Cet appel est automatique en codant : les 5 paramtres suivants CFTMAIN : SGTRACE nnn ACBNAME DISC idparm une dfinition rseau CFTNET TYPE=SNA est active dans le paramtrage de CFT, afin dinitialiser le rseau SNA, par exemple : CFTNET ID=NETGATE,PROFILE=GATE,TYPE=SNA,ACB=acbgate Pour se connecter linterface cran CFT/MVS sous VTAM, un utilisateur mettra en uvre la procdure suivante : sur la mire VTAM : LOGON APPLID=ACBNAME, sur la mire daccueil CFT/MVS, il doit entrer son USERID/PASSWORD qui sont vrifis par RACF (ou quivalent).

7.7.3. Touches de Fonctions


Sur chaque cran, les touches de fonctions utilisables sont affiches. Leurs dfinitions est la suivante : <F1> HLP Aide en ligne, <F3> <F4> <F5> <F6> <F7> END Fin (retour au menu prcdent), RET Retour au menu gnral, TOP Aller au dbut de la slection, BOT Aller la fin de la slection, UP Dplacement d'une page vers le haut,

CFT V2.3

7-5

Installation des menus CFT

<F8> <F10> <F11> <F12>

DWN Dplacement d'une page vers le bas, LFT Dplacement vers la gauche, RIG Dplacement vers la droite, EXI Sortie des interfaces interactives.

Sur les crans d'aide, les touches <F7> et <F8> servent se dplacer respectivement vers la page suivante ou vers la page prcdente. La touche <F3> termine l'utilisation de l'aide en ligne.

7.7.4. Menus en langue anglaise


Pour utiliser les menus en langue anglaise, une modification mineure du JCL de lancement est ncessaire : activer la carte DD CFTFPAY. //* The next statement must not be marked as a comment for ENGLISH //* menus //*CFTFPAY DD DISP=SHR,DSN=&QUAL..CFIPAY

7.8. Interface utilisateur Internet (CFTIUI)


Le membre CFTIUI de la bibliothque CFTV2.INSTALL est un exemple de lancement de linterface XFB.IUI sous OS/390. Le programme CFTIUI doit tre APF. Le JCL qui suit est un exemple de procdure dactivation de lagent MVS de XFB.IUI :
//jobname JOB account,'CFTIUI',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //CFTIUI PROC QUAL=cftv2, // TCP=tcpibm, // PROFILE=IUISYCF, (use full motion, restrict here if need) // IUIAPIS=APIS, // IUIPSW=IUIPSWU1, // OUT=sysout //IUIM EXEC PGM=CFTIUI,REGION=32M,TIME=1440 //STEPLIB DD DSN=&QUAL..LOAD,DISP=SHR //* DD DSN=&TCP..LINK,DISP=SHR //* SYSTCPD is MANDATORY WITH SOLVE TCPACCESS //SYSTCPD DD DSN=&TCP..TCPIP.DATA,DISP=SHR //CFTCAT DD DSN=&QUAL..CATALOG,DISP=SHR //* CFTCOM unecessary if synchronous API is activated //CFTCOM DD DSN=&QUAL..COM,DISP=SHR //CFTLOG DD DSN=&QUAL..LOG1,DISP=SHR //CFTLOGA DD DSN=&QUAL..LOG2,DISP=SHR //* DIAG AND DEBUG FILES //SYSUDUMP DD SYSOUT=&OUT //SGSTAE DD SYSOUT=&OUT //SGTRACE DD SYSOUT=&OUT //CFTOUT DD SYSOUT=&OUT //* IUI Configuration SAMPLE (Port=1972) //CFTHINI DD DISP=SHR,DSN=&QUAL..INSTALL(&PROFILE) //PROFIL DD DISP=SHR,DSN=&QUAL..SAMPLE(XFBIUI) //* IUI certificat password file //TLSPSW DD DISP=SHR,DSN=&QUAL..INSTALL(&IUIPSW) //* IUI PKS12 certificat file //TLSCER DD DISP=SHR,DSN=&QUAL..IUICA //* IUI configuration file for communication media

7-6

CFT V2.3

CFT/MVS Guide d'exploitation //CFTTCP //* LE/370 //CEEDUMP //STDOUT //SYSPRINT // //* //IUIP // DD DISP=SHR,DSN=&QUAL..INSTALL(&IUIAPIS) DEBUG DD SYSOUT=&OUT DD SYSOUT=&OUT DD SYSOUT=&OUT PEND EXEC CFTIUI

Les paramtres en gras seront remplacs lors de la phase de personnalisation. Trois exemples de fichier paramtres profile sont livrs : IUISYAN : API synchrone (mdia de communication) et mode anonyme (certification), IUISYCF : API synchrone (mdia de communication) et fichier certificat, IUISYNS : mdia de communication standard (fichier) et change non scuris. Remarque : lutilisation de lAPI synchrone comme mdia de communication avec le moniteur XFB/CFT ainsi que la scurisation des changes, ne pourront tre ralises qu partir de la version XFB/CFT.231. La description du paramtrage de lagent Internet XFBIUI (Fichier PROFIL) est la suivante.
Tableau 9. Description du paramtrage de lagent XFBIUI (SERVER) Port RecvTimeout CloseTimeout Trace Addr ServerMax TermDelay ARM Mot cl obligatoire pour MVS Numro de Port dcoute, paramtre obligatoire Temps dattente en secondes de rception de donnes Dfaut = 1000 Temps dattente en secondes sur envoi de donnes Dfaut = 1000 Masque des trace Dfaut = 0 Nom du serveur TCP/IP Dfaut = aucun, travaille avec tous (ANYHOST) Nombre maximum de connexions simultanes Dfaut = 48 Temps dattente en secondes de connexion entrante Dfaut = 0 Nom utilis pour sabonner au composant ARM de OS/390 Par dfaut : pas dabonnement au composant ARM

CFT V2.3

7-7

Installation des menus CFT Tableau 9. Description du paramtrage de lagent XFBIUI (suite) (SERVER) [Paramtres XFB/CFT 2.31] TlsUsed TlsCipherSuite Mot cl obligatoire pour MVS

TlsServerCertificateFile

TlsPasswordFile (CFT) Fileconfig

Echange en mode scuris : 1 Indique les ciphers suite acceptes par le serveur : TLS_RSA_ANON_WITH_NULL_MD5 TLS_RSA_ANON_WITH_NULL_SHA TLS_RSA_ANON_WITH_DES_CBC_SHA TLS_RSA_ANON_WITH_3DES_EDE_CBC_SHA TLS_RSA_ANON_WITH_RC4_128_MD5 TLS_RSA_ANON_WITH_RC4_128_SHA TLS_RSA_ANON_WITH_AES_128_CBC_SHA TLS_RSA_WITH_NULL_MD5 (=1 dans le paramtrage CFT des cipher suites) TLS_RSA_WITH_NULL_SHA (=2 dans le paramtrage CFT) TLS_RSA_WITH_DES_CBC_SHA (=9 dans le paramtrage CFT) TLS_RSA_WITH_3DES_EDE_CBC_SHA (=10 dans le paramtrage CFT) TLS_RSA_WITH_RC4_128_MD5 TLS_RSA_WITH_RC4_128_SHA TLS_RSA_WITH_AES_128_CBC_SHA Ce paramtre dcrit : - le type dauthentification - le mode anomyne (sinon rien) - lalgorithme de chiffrement sinon NULL - lalgorithme de scellement Rfrence par indirection DD : (ddname) un fichier contenant la chane de certification au format pkcs12 Ce paramtre est optionnel si cipher suite est de type anonyme Rfrence par indirection DD : (ddname) un fichier contenant le mot de passe (en EBCDIC) du certificat au format pkcs12 Mot-cl Rfrence par indirection $ (ddname) un fichier dcrivant le type de mdia de communication utilis avec le moniteur XFB/CFT (ex : API synchrone)

1) Exemple de fichier de configuration : SERVER) PORT = 1972 TRACE = 255 Avec : (SERVER) PORT TRACE : mot cl obligatoire, : numro de port IP dcoute, : options de trace interne de XFBIUI.

7-8

CFT V2.3

CFT/MVS Guide d'exploitation

2) Exemple de fichier de configuration : [XFB/CFT.231] # IUI configuration file # with synchronous API # with data security exchange # with certificat (SERVER) PORT=iuisp TlsUsed=1 TlsCipherSuite=TLS_RSA_WITH_DES_CBC_SHA TlsServerCertificateFile="DD:TLSCER" TlsPasswordFile="DD:TLSPSW" (CFT) Fileconfig="$CFTTCP" Avec : (SERVER) PORT TlsUsed=1 TlsCipherSuite TlsServerCertificateFile TlsPasswordFile (CFT) Fileconfig="$CFTTCP" : : : : : : : : mot cl obligatoire, numro de port IP dcoute personnalis lors de linstallation, change en mode scuris, indique les ciphers suite acceptes par le serveur, rfrence par indirection (ddname : TLSCER) un fichier contenant la chane de certification au format pkcs12, ddname (TLSPSW) du fichier contenant le mot de passe du certificat, mot cl obligatoire dans le cas de la configuration du mdia de communication CFT, ddname (CFTTCP) du fichier dcrivant le type de mdia de communication.

7.8.1. Appel aux interface utilisateur Internet en JAVA


Le programme CFTIUI permet galement un accs aux API de CFT depuis un programme JAVA. Le package JAVA ncessaire, et des exemples dutilisation sont disponibles en tlchargement sur le site web : http://support.axway.com (une identification est requise).

CFT V2.3

7-9

8. Exploitation de CFT/MVS

8.1. Prsentation
Ce chapitre fournit des exemples de JCL partir desquels lutilisateur pourra crer des jobs correspondant ses besoins dexploitation de CFT version 2.3.0 et suivantes.

8.2. Mise jour des procdures de transfert (H80EXEC)


Le JOB H80EXEC contient un exemple de procdures CFT : EXECSF : procdure de fin d'mission de fichier, EXECRF : procdure de fin de rception de fichier, SWIACC : procdure soumise au SWITCH du comptable CFT, SWILOG : procdure soumise au SWITCH du journal CFT, Ces procdures sont personnalises dans la phase A00CUSTO.

8.3. Exemple de JCL de demande de transfert


8.3.1. Mdia de communication : fichier (CFTSEND)
Ce job est un exemple de JCL de demande de transfert de fichier. A partir de lexemple CFTSEND, il est possible de crer des jobs rpondant aux besoins de lexploitation. CFTSEND : exemple de JCL de demande de transfert.
//jobname JOB account,'CFTSEND',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //CFTSEND PROC QUAL=cftv2, // OUT=sysout //CFTSEND EXEC PGM=CFTUTIL,REGION=3000K //STEPLIB DD DSN=&QUAL..LOAD,DISP=SHR //CFTCOM DD DSN=&QUAL..COM,DISP=SHR //SYSUDUMP DD SYSOUT=&OUT //CFTOUT DD SYSOUT=&OUT //CFTIN DD DDNAME=SYSIN // PEND //SEND EXEC CFTSEND //CFTSEND.SYSIN DD * SEND PART=PARTTCP,FNAME=cftv2.SAMPLE(CFTPARM),IDF=SAMPLE /* //

Les paramtres en gras seront remplacs lors de la phase de personnalisation.

CFT V2.3

8-1

Exploitation de CFT/MVS

8.3.2. Mdia de communication : API synchrone (CFTSENDS) [XFB/CFT.231]


CFTSENDS : exemple de JCL de demande de transfert. //jobname JOB account,'CFTSEND',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //CFTSENDS PROC QUAL=cftv2, // OUT=sysout //CFTSEND EXEC PGM=CFTUTIL,REGION=3000K //STEPLIB DD DSN=&QUAL..LOAD,DISP=SHR //SYSUDUMP DD SYSOUT=&OUT //CFTOUT DD SYSOUT=&OUT //CFTIN DD DDNAME=SYSIN //* Synchronous API indirect configuration files //CFTTCP DD DISP=SHR,DSN=&QUAL..INSTALL(APIS) (secured access) //*CFTTCP DD DISP=SHR,DSN=&QUAL..INSTALL(APINS)(unsecured access) // PEND //UTIL EXEC CFTSENDS /* SAMPLE OF CFTUTIL COMMAND WITCH USE SUNCHRONOUS API */ /* WITH DIRECT CONFIGURATION FILE : */ /* CONFIG TYPE=COM,FNAME=cftv2.INSTALL(APIS) */ /* secured */ /* CONFIG TYPE=COM,FNAME=cftv2.INSTALL(APINS) */ /* unsecured */ /* WITH INDIRECT CONFIGURATION FILE : */ CONFIG TYPE=COM,FNAME=$CFTTCP /* indirect config file */ /* CFTUTIL COMMAND STREAM : */ SEND PART=TCPLOOP,FNAME=cftv2.SAMPLE(CFTPARM),IDF=SAMPLE,TRK=ALL // Les paramtres en gras seront remplacs lors de la phase de personnalisation.

8.4. Exemple de lancement de JCL de CFT/MVS (CFTMAIN)


Ce job est un exemple de JCL de lancement de CFT/MVS. A partir de lexemple CFTMAIN, il est possible de crer des jobs rpondant aux besoins de lexploitation. Remarque : en rseau TCP/IP, il est ncessaire de sinspirer de lexemple CFTMAINT.

8-2

CFT V2.3

9. Cration des paramtres CFT/MVS (E50PARM)

9.1. Prsentation
Ladministrateur de CFT version 2.3.0 et suivantes trouvera, dans ce chapitre, les informations ncessaires la cration des fichiers paramtres et partenaires de CFT/MVS.

9.2. Cration des paramtres CFT/MVS (E50PARM)


Exemple : E50PARM : mise jour des paramtres de CFT/MVS. //jobname JOB account,'E50PARM',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* //CFTPARM PROC QUAL=cftv2, // OUT=sysout, // MEMBER=CFTPARM ** A PERSONNALISER //PARM EXEC PGM=CFTUTIL,REGION=3000K //STEPLIB DD DSN=&QUAL..LOAD,DISP=SHR //CFTPARM DD DSN=&QUAL..PARM,DISP=SHR //CFTPART DD DSN=&QUAL..PART,DISP=SHR //CFTOUT DD SYSOUT=&OUT //CFTIN DD DSN=&QUAL..SAMPLE(&MEMBER),DISP=SHR // PEND //PARM EXEC CFTPARM Les paramtres en gras seront remplacs lors de la phase de personnalisation. Avant de soumettre ce job, les points suivants doivent tre adapts aux besoins de lexploitation : la cl dutilisation de CFT Version 2 propre lutilisateur, les valeurs des paramtres CFT Version 2. Lexemple de paramtrage est donn dans le fichier CFTV2.SAMPLE (CFTPARM).

CFT V2.3

9-1

Cration des paramtres CFT/MVS (E50PARM)

9.3. Cration dune base VFM (F60VFMC)


Le JOB F60VFMC cre une base VFM. Pour lutiliser, il convient de disposer de loption VFM. Cette tape est facultative. //jobname JOB account,'F60VFMC',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //VFMUTIL PROC QUAL=cftv2, // OUT=sysout //UTIL EXEC PGM=VFMUTIL,REGION=3000K //STEPLIB DD DSN=&QUAL..LOAD,DISP=SHR //VFMOUT DD SYSOUT=&OUT // PEND //UTIL EXEC VFMUTIL //VFMIN DD * DBFILE TYPE = DELETE , DFNAME = 'cftv2.VFMDATA' DBFILE TYPE = CREATE , DFNAME = 'cftvol%%cftv2.VFMDATA' , XFNAME = 'cftvol%%cftv2.VFMINDEX', DLRECL = 4088 , DNBLOCS= 10000, XSPACE = 100 , XVER = 3

// Les paramtres en gras seront remplacs lors de la phase de personnalisation. Lutilisateur dispose des exemples suivants de commandes VFM : VFMCOPY : copie de fichier dans une base VFM, VFMASS : copie de fichiers dune base VFM vers un fichier squentiel, VFMLIST : liste le contenu dune base VFM.

9.4. Partage dune base VFM


Dans le cadre de la protection multi-systmes GRS, CFT/MVS utilise le "QNAME" "CFTSHARE" pour la protection des bases VFM. Il est indispensable de propager les ENQ "CFTSHARE" tous les systmes GRS partageant les bases VFM.

9-2

CFT V2.3

CFT/MVS Guide d'exploitation

9.5. Mise jour de SYS1.VTAMLST (G70VTAM)


CFT Version 2 permet le transfert de fichiers travers des rseaux SNA et X25. Les dfinitions suivantes sont ncessaires VTAM : des noms dapplications VTAM, une INTERPRET table pour la rception des connexions X25 en PCNE, des nuds commuts VTAM pour X25 en mode GATE, des nuds commuts VTAM pour X25 en mode PCNE, des nuds commuts VTAM pour LU 6.2 sur token ring. Le JOB G70VTAM est un exemple de mise jour de SYS1.VTAMLST .

9.5.1. Paramtres du NCP pour utiliser GATE


Les paramtres suivants sont requis dans le NCP, au niveau X25.MCH : Exemple : paramtrage du NCP pour X25-GATE. X25.MCH ADDRESS= LUNAME=Luname, Nom de la LU MULTIVOIE pour GATE LLCLIST=( ,LLC4, ), GATE LLC4=4, GATE * * * *

9.5.2. Complments dinformation propos des rseaux X25


Un rseau X25 gr en GATE est dcrit dans CFT/MVS par les commandes : CFTNET TYPE = X25 et CFTX25 Une premire forme de paramtrage du nud commut VTAM est alors utilise. Un rseau X25 gr en mode PCNE est dcrit dans CFT/MVS par les commandes : CFTNET TYPE = SNA et CFTSNA Une seconde forme de paramtrage du nud commut VTAM est alors utilise. Lutilisation simultane de PCNE et de GATE est possible sur une ligne X25. Il est alors ncessaire de se reporter la "documentation IBM X25-NPSI" qui prsente les diffrentes combinaisons de paramtres NCP possibles.

9.5.2.1. Utilisation de la sous-adresse dans le numro dappel X25


La sous-adresse est utilisable si NPSI est paramtr avec : SUBADDR = YES Dans ce cas, le caractre de DROITE de la sous-adresse est le service LLCn de NPSI : n = 0 -> PCNE et n = 4 -> GATE

CFT V2.3

9-3

Cration des paramtres CFT/MVS (E50PARM)

9.5.2.2. Rception dun appel entrant en PCNE


Il existe deux possibilits : le premier message est associ un APPLID SNA par une INTERPRET TABLE de VTAM, lAPPLID SNA est forc par un LOGAPPL = de VTAM.

9.5.2.3. Utilisation des USER DATA


Il sagit de tous les caractres alphanumriques du SAP : rception dun appel entrant en GATE : si NPSI contient SUBADDR = YES, alors DIALNO doit se terminer par 4 et la valeur du SAP est compare (y compris le 4), sinon, le caractre de GAUCHE des USER DATA est le service LLCn de NPSI (exemple : C4 -> GATE) et la valeur du SAP est compare (y compris le premier caractre ayant servi dterminer le service LLC).

9.6. Mise jour de SYS1.VTAMLIB (G71LOGM)


CFT/MVS permet le transfert de fichiers travers des rseaux SNA, X25 et LU6.2. Pour cela, il utilise des paramtres de session qui sont dfinis dans une table MODETAB, compile puis LINKEDITE en SYS1.VTAMLIB. Exemple : G71LOGM : mise jour de SYS1.VTAMLIB. //jobname JOB account,'G71LOGM',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* //ASML PROC OUT=sysout, // QUAL=cftv2, // LOGM=SNALOGM, ** A PERSONNALISER // MODETAB='SYS1.SISTMAC1', ** A PERSONNALISER // AMODGEN='SYS1.AMODGEN' ** A PERSONNALISER //* //ASM EXEC PGM=IEV90, // PARM='OBJ,XREF(SHORT),NODECK', // REGION=2500K //SYSLIB DD DSN=SYS1.MACLIB,DISP=SHR // DD DSN=&MODETAB,DISP=SHR // DD DSN=&AMODGEN,DISP=SHR //SYSUT1 DD UNIT=VIO,SPACE=(CYL,(2,2)) //SYSPRINT DD SYSOUT=&OUT //SYSIN DD DSN=&QUAL..SAMPLE(&LOGM),DISP=SHR //SYSLIN DD DSN=&OBJ,DISP=(NEW,PASS), // UNIT=VIO,SPACE=(TRK,(1,1)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=800)

9-4

CFT V2.3

CFT/MVS Guide d'exploitation

//* //LINK EXEC PGM=IEWL, // PARM='LIST,LET,RENT,REUS,NCAL,MAP' //SYSLMOD DD DSN=SYS1.VTAMLIB(&LOGM),DISP=SHR //SYSUT1 DD UNIT=VIO,SPACE=(CYL,(1,1)) //SYSPRINT DD SYSOUT=&OUT //SYSLIN DD DSN=&OBJ,DISP=SHR // PEND //LOGM EXEC ASML Les paramtres en gras seront remplacs lors de la phase de personnalisation.

9.7. Mise en uvre du systme des habilitations


CFT/MVS permet le contrle des droits daccs aux paramtres et au catalogue de CFT par appel aux services SAF de OS/390 ou encore par un dispositif propritaire de CFT. La mise en uvre du systme des habilitations est dcrite dans des documents spars. Une bonne connaissance de SAF (RACF) est recommande. Les JOB suivants, prsents dans la bibliothque dinstallation, sont utiliser exclusivement dans ce cadre : H89SAFAS H89SAFAU H81SAFCD H82SAFRT H83SAFDA H89SAFDD H89SAFDS H84SAFDF H85SAFPR H86SAFCR H87SECEN H88INIT H88PARM

CFT V2.3

9-5

10. Installation de loption XFB.Scope

10.1. Prsentation
Ces tapes sont ncessaires dans le cas dinstallation de loption dadministration centralise XFB.Scope et/ou du logiciel complmentaire A&P dans le cadre dune version XFB/CFT V2.3.0. Les tapes contenues dans cette bibliothque sont les suivantes : 1. NT00CUST : personnaliser les jobs d'installation. 2. (Utilisateurs de A&P uniquement) NT10LMQS : LINK-EDIT des modules A&P avec mise en uvre de MQSeries. 3. NT20DEF : Cration des fichiers de XFB-SCOPE. 4. Modification du paramtrage de CFT (CFTCAT et CFTLOG) : consulter le "Guide dinstallation et dutilisation MVS" XFB.Scope. Ces jobs doivent tre excuts dans lordre indiqu ci-dessus. Dans les paragraphes suivants lutilisateur de CFT/MVS trouvera en quelques mots, la description de la ou des fonctions de ces jobs.

10.2. Personnalisation des paramtres dinstallation XFB-SCOPE (NT00CUST)


Ce JOB personnalise les paramtres dinstallation. Il est copier dans une bibliothque de l'utilisateur. La personnalisation se faisant directement dans la bibliothque d'installation, il est recommand de la dupliquer. //jobname JOB account,'NT00CUST',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* //* //CLIST EXEC PGM=IKJEFT01 //SYSPROC DD DISP=OLD,DSN=CFTV2.INSTALL //SYSTSPRT DD SYSOUT=* //SYSPRINT DD SYSOUT=* //* //SYSTSIN DD * %A01CUSTO CFTV2.INSTALL NT01MEML /* //CFTIN DD DATA,DLM='@@' ntflen '4000' 01 Maximum file record size ntfnbr '5000' 02 Maximum file number of messages qltport '44444' 03 XFB-SCOPE TCP/IP port number qltserver 'ntf.srv.xx' 04 XFB-SCOPE TCP/IP address or name mqgr 'MQME' 05 MQSeries : local queue manager

CFT V2.3

10-1

Installation de loption XFB.Scope

mqseries ntfdest queue ntfaetp exclude @@

'MQM' 'CFTSCOPP' 'NTFAETP' ''

06 07 08 09

Dataset prefix for MQseries XFB-SCOPE XCF communication AETP : config file with A&P Transfert status to be EXCLUDED

Les paramtres en gras sont adapter votre environnement. Les valeurs proposes sont appropries la plupart des besoins, sauf qltserver , adresse IP du serveur XFB-SCOPE renseigner obligatoirement. Les mots-cls doivent rester en minuscule. La valeur de ces mots-cls doit figurer entre apostrophes. L'ordre des mots-cls ne doit pas tre modifi. L'explication des diffrents mots-cls est indique dans le tableau suivant.
Tableau 10. Liste des mots-cls Mot-cl Ntflen Ntfnbr Mqgr Mqseries Qltport Qltserver Ntfdest Ntfaetp Exclude Explication Taille des enregistrement du fichier de mise en attente des vnements Nombre des enregistrements du fichier de mise en attente des vnements Nom du gestionnaire MQSeries Alias des bibliothques de MQSeries IBM Numro de port TCP du serveur XFB-SCOPE Nom ou adresse IP du serveur XFB-SCOPE, renseigner OBLIGATOIREMENT Nom du membre XCF dclar dans le JOB A12OPTS "NTFDEST= " Nom du membre de configuration si utilisation associe A&P Liste des critres dexclusion des transferts par XFB-SCOPE

10.3. LINK-EDIT du module A&P (NT10LMQS)


Ce JOB fait le LINK-EDIT de lagent utilis par le logiciel A&P, en liaison avec MQ/series. Remarque : le code retour du link-edit doit tre infrieur ou gal 4.

10.4. Cration de fichiers XFB-SCOPE (NT20DEF)


Ce job cre les fichiers utiliss par XFB-SCOPE : fichier des messages en franais et en anglais, fichier de mise en attente des vnements. Exemple : //jobname JOB account,'NT20DEF', // CLASS=class,MSGCLASS=msgclass,NOTIFY=userid jobparm //NTFFILE PROC QUAL=cftv2, // OUT=sysout,

10-2

CFT V2.3

CFT/MVS Guide d'exploitation

// UNIT=cftunit, // VOL=cftvol, //DEFNTF.SYSIN DD * DELETE (cftv2.NTFFILE) CL; SET MAXCC = 0 ; DEFINE CLUSTER (NAME(cftv2.NTFFILE) VOL(cftvol) RECSZ(4000 4000) FSPC( 0 0 ) RECORDS(ntfnbr 1) SHR (2 3 ) NUMBERED ) ; /*

Les paramtres en gras seront remplacs lors de la phase de personnalisation.

10.5. Utilisation de lagent externe A&P (CFTAETP)


Le JCL qui suit est un exemple de procdure dactivation de lagent notificateur MVS de A&P.
//jobname JOB account,'AGENT NTF',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* //CFTAETP PROC OUT=sysout, // QUAL=cftv2, // CONFIG=NTFCONF, Default configuration // LANG=lang //NTFRUN EXEC PGM=CFTSCOPE,REGION=4000K, // PARM='NTFQLT SYS' //* //STEPLIB DD DISP=SHR,DSN=&QUAL..LOAD //CONFIG DD DISP=SHR,DSN=&QUAL..INSTALL(&CONFIG) Config. sample //MSGTAB DD DISP=SHR,DSN=&QUAL..NTFMSG&LANG //* //SYSPRINT DD SYSOUT=&OUT //SYSOUT DD SYSOUT=&OUT //CEEDUMP DD SYSOUT=&OUT //SYSUDUMP DD SYSOUT=&OUT //* // PEND //GO EXEC CFTAGENT //

Les paramtres en gras seront remplacs lors de la phase de personnalisation. La description du paramtrage de lagent XFB-SCOPE (Fichier CONFIG), se trouve dans la documentation spcifique cette option. Remarques : CFTAETP doit tre lanc avant le moniteur CFT. Il peut tre lanc sur nimporte laquelle des machines dun SYSPLEX , CFTAETP utilise le composant XCF de OS/390. Le nom de la file dattente, paramtre NTFDEST, est unique pour un SYSPLEX donn.

CFT V2.3

10-3

Installation de loption XFB.Scope

Si plusieurs CFT/MVS sont administrs par lintermdiaire de A&P, il y a 2 possibilits : utiliser un seul agent , qui reoit les vnements des CFT/MVS sur une file dattente XCF. Cest loption par dfaut, utiliser plusieurs agents grant chacun une file dattente. Il est prfrable de recrer une autre copie de la bibliothque cftv2.INSTALL partir de la bande dinstallation, et dexcuter au minimum les tapes A00CUSTO, A12OPTS, NT00CUST, NT20DEF, avec de nouveaux paramtres, en particulier Ntfdest qui doit changer.

10-4

CFT V2.3

11. Installation de loption Sentinel for XFB

11.1. Prsentation
Les tapes indiques ci-dessous sont ncessaires dans le cadre dune installation de loption Sentinel for XFB, partir de la version XFB/CFT.231. 1. Mise en place de lEvent Router et de lUniversal Agent. 2. Personnalisation du fichier de configuration Sentinel pour le moniteur. 3. Modification de la procdure de lancement de CFT. 4. Arrt du moniteur. 5. Relance du moniteur. Lordre de ces tapes doit tre respect. Linstallation de lUniversal Agent nest ncessaire que dans le cadre dun suivi bout en bout.

11.2. Mise en place


11.2.1. Mise en place de lEvent Router
Pour une information complmentaire, consulter le Manuel dinstallation de lEvent Router sur MVS. Lors de la mise en place, prciser loption de cration dun fichier TAMPON de type LOGGER. A lissue de ce processus de mise en place, un fichier TAMPON est cr ; ce fichier est de type LOGGER. Le nom du fichier est conserver pour le paramtrage du fichier de configuration.

11.2.2. Personnalisation du fichier de configuration Sentinel for XFB (SN00CUST)


La personnalisation se fait directement dans la bibliothque d'installation. //jobname JOB account,'SN00CUST',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* //* //CLIST EXEC PGM=IKJEFT01, // PARM='%A01CUSTO cftv2.INSTALL' //SYSPROC DD DISP=OLD,DSN=cftv2.INSTALL //INSTMBR DD DISP=SHR,DSN=cftv2.INSTALL(SN01MEML) //SYSTSPRT DD SYSOUT=* //SYSPRINT DD SYSOUT=*

CFT V2.3

11-1

Installation de loption Sentinel for XFB

//SYSTSIN DD //CFTIN DD sntlocad sntladdr sntlp sntlqueue sntlgstr @@

DUMMY DATA,DLM='@@' '127.0.0.1' 'sntl.srv.xx' '41111' 'AXQSENT2' 'EVROUT.LOGGER'

01 02 03 04 05

Sentinel Sentinel Sentinel Sentinel Sentinel

local TCP/IP address tracker TCP/IP address tracker TCP/IP port tracker queue XCF/SOPIX tracker logstream name

Les paramtres en gras sont adapter votre environnement. Dans le cas dune connexion avec lEVENT ROUTER via XCF, il est ncessaire de modifier manuellement le fichier de configuration pour activer ce mode de communication et de mettre, en commentaire, les lignes correspondant aux paramtres : TRKIPADDR=sntladdr TRKIPPORT=sntlp Les mots-cls doivent rester en minuscule. La valeur de ces mots-cls doit figurer entre apostrophes. L'ordre des mots-cls ne doit pas tre modifi. L'explication des diffrents mots-cls est indique dans le tableau suivant.
Tableau 11. Liste des mots-cls Mot-cl sntlocad sntladdr sntlp sntlqueue sntlgstr Explication Adresse locale (TCP/IP) Adresse de lEVENT-ROUTER, (TCP/IP) Port de lEVENT-ROUTER (TCP/IP) Identification de la Queue en mode de connexion XCF avec lEVENT ROUTER, il nest pas utile de renseigner les paramtres sntladdr sntlp Identifiant du fichier LOGGER (le nom de doit pas dpasser 26 caractres)

La description des paramtres gnraux est dcrite dans la documentation de lEvent Router. Le fichier SNTLCNF est prsent titre dexemple : TRKTRACE=0 TRKPRODUCTNAME=API-SCRIPT TRKMODELDIR=cftv2.XMLLIB TRKMODELEVENT=TRKEVENT TRKMODELLINK=TRKLINKC TRKMODELLOG=TRKLOG -----TRKIPADDR=sntl.srv.xx TRKIPPORT=41111 TRKLOCALADDR=127.0.0.1 ou TRKTYPE=XCF TRKSVC=200 Adresse de lEvent Router Port

11-2

CFT V2.3

CFT/MVS Guide d'exploitation

TRKQUEUE=AXQSENT2 -----TRKTNAME=EVROUT.LOGGER XFB.Sentinel=YES XFB.Transfer=ALL XFB.log=E Mots-cls spcifiques au moniteur : XFB.Sentinel, XFB.Transfer, XFB.log.

Queue dfinie au niveau de lEvent Router

Ces paramtres sont dcrits dans la Note de diffusion du moniteur CFT.

11.2.3. Modification de la procdure de lancement de CFT


Au niveau de la procdure de lancement, il est ncessaire dajouter lassignation du fichier de configuration (ddname = TRKCNF). Exemple : //TRKCNF // DD DISP=SHR, DSN=cftv2.INSTALL(SNTLCNF)

Lors de lexcution, la tche ddie la gestion des messages destination de Sentinel for XFB va allouer une sysout (ddname=TRKPRINT) destine une trace possible ou des messages derreurs.

11.2.4. Prise en compte du fichier de configuration


Pour que le fichier de configuration soit pris en compte ou pour toute autre modification de ce fichier paramtre, faire un arrt / relance du moniteur.

11.2.5. Mode denvoi des messages


Le paramtre TRKTMODE, au niveau du fichier de configuration, permet de grer le mode denvoi des messages destination de Sentinel for XFB. Valeurs possibles : TRKTMODE=I TRKTMODE=D TRKTMODE=R immdiat, valeur par dfaut, diffr, les messages sont directement insrs dans le fichier Tampon, retry, permet de grer un temporisation laide du paramtre TRKTCONNRETRY=nn dans le cas dun problme de connexion avec SENTINEL.

CFT V2.3

11-3

Installation de loption Sentinel for XFB

11.2.6. Remplacement de loption XFB.Scope


Au niveau du JCL de lancement de CFTMAIN, la carte //CFTNTFC DD .. na plus lieu dtre. Au niveau du fichier de paramtrage CFT, si le paramtre NTF=YES est cod dans la commande CFTCAT, il faut imprativement avoir au niveau du JCL de lancement de CFT la rfrence au fichier de configuration Sentinel for XFB, via le DDNAME TRKCNF . Dans le cas ou le fichier de configuration nest pas prsent, le moniteur sarrtera lors de la premire notification Un message du type CFTS29I Cannot acces XTRK task _ Shutdown in progress prcdera larrt du moniteur.

11.3. Exemples de procdures pour un suivi de bout en bout


Dans le cadre dun suivi de bout en bout deux JCL sont livrs dans la librairie SAMPLE : SNTLCFT : dpt dune commande de transfert dun fichier laide de lutilitaire CFTUTIL avec un mme CycleID quau niveau du SENDEVENT ralis par lutilitaire TRKUTIL. SNTLEXEC : procdure de fin de transfert associant un acquittement laide de lutilitaire CFTUTIL et des COMPUTEIDENT, SENDEVENT, SENDCYCLE raliss par lutilitaire TRKUTIL. Remarque : lutilitaire TRKUTIL est mis en place lors de linstallation du produit Sentinel for XFB .

11-4

CFT V2.3

12. Installation de PTF sur CFT/MVS V2.3.0

12.1. Format du support dinstallation


Le format dune bande PTF est identique celui dune bande dinstallation. CFT/MVS PTF MVS est livr sur un support magntique contenant les fichiers indiqus dans le tableau ci-dessous.
Tableau 12. Fichier INSTALL SAMPLE OBJ PFTOBJ DOC CNTL MAC SCR Contenu de la bande dinstallation Position 1 2 3 4 5 6 7 8 Contenu Mises jour des JCL dinstallation Mises jour des SAMPLE Nouveaux modules Modules OBJECT mis jour Documentation mise jour Fichiers de contrle Macros Mise jour des Formats des crans, messages, exemples SSL

12.1.1. Mise jour de CFT/MVS par CD


Des fichiers de mise jour sont galement disponibles sur CD-ROM La procdure est similaire une installation initiale (voir le chapitre Restauration de la bibliothque dinstallation). En gnral, seulement deux fichiers (CNTL et PTFOBJ) sont livrs.

12.1.2. Mise jour de CFT/MVS par Internet


Des fichiers de mise jour peuvent tre mis disposition ou livrs par Internet. Dans ce cas, vous devez suivre les instructions accompagnant ces fichiers.

12.2. Restauration de la bande dinstallation CFT/MVS (A13PTF)


Ce JOB restaure les fichiers de la bande dinstallation ou dune bande de PTF. Il est livr avec la bande dinstallation. Le nom de volume dune bande PTF est indiqu sur la bande. Remarque : les bandes de PTF sont cumulatives. Une bande dinstallation (ou un CD) de CFT/MVS peut galement contenir des PTF. Dans ce cas, linstallation inclura automatiquement les PTF. La mise jour des JCL dinstallation nest pas automatique. Il est conseill de recrer le fichier INSTALL.

CFT V2.3

12-1

Installation de PTF sur CFT/MVS V2.3.0

12.3. Informations importantes


Il est ncessaire de lire le fichier CFTV2.DOC(IMPORTAN) contenant des informations importantes. Il est galement utile de lire le fichier CFTV2.DOC(DOCPTF) contenant une description de toutes les PTF contenues dans cette bande.

12.4. Prise en compte des PTF


Aprs chargement de la bande, il est ncessaire de refaire les LINK-EDIT suivants : B20LINK : LINK EDIT gnral de tous les modules CFT, B22LTCP NT10LMQS : LINK EDIT spcifique de linterface rseau TCP/IP, : LINK-EDIT spcifique de lagent A&P.

12.5. Prise en compte de nouveaux menus de linterface interactive


Les JOBs C31SCRFR et C31SCRUK permettent de mettre jour les menus de linterface interactive en franais et en anglais.

12.6. Sauvegarde/Restauration du paramtrage CFT/MVS


A la mise jour du noyau CFT/MVS, il est parfois ncessaire de sauvegarder le paramtrage existant, puis de le recharger avec la nouvelle version de lutilitaire CFTUTIL. Cette ventualit vous sera signale dans le fichier CFTV2.DOC(IMPORTAN). Cette fonction est ralise de manire simple avec la commande CFTEXT de CFTUTIL, dont lutilisation vous est rappele dans le paragraphe ci-aprs.

12.6.1. Extraction des paramtres CFT : CFTEXT

12.6.1.1. Fonction
Lexemple CFTEXT restitue un fichier des paramtres de CFT, tels quils ont t soumis par les commandes de paramtrage de type CFTxxxx (sauf les commentaires). Le paramtre TYPE permet de slectionner le type de commande. En labsence dune prcdente commande CONFIG TYPE=OUTPUT, le compte rendu de lexcution est crit sur la sortie standard du programme CFTUTIL.

12-2

CFT V2.3

CFT/MVS Guide d'exploitation

12.6.2. Procdure de sauvegarde du paramtrage


Cette procdure sera lance AVANT linstallation de la nouvelle version CFT/MVS. Exemple de JCL de sauvegarde du paramtrage CFT/MVS : //jobname JOB account,'CFTEXT',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //CFTPARM PROC QUAL=cftv2, // OUT=sysout //PARM EXEC PGM=CFTUTIL,REGION=3000K //STEPLIB DD DSN=&QUAL..LOAD,DISP=SHR //CFTPARM DD DSN=&QUAL..PARM,DISP=SHR //CFTPART DD DSN=&QUAL..PART,DISP=SHR //CFTOUT DD SYSOUT=&OUT // PEND //PARM EXEC CFTPARM //CFTIN DD * CONFIG TYPE=OUTPUT,FNAME= cftv2.BACKUP CFTEXT TYPE=ALL // Les paramtres en gras seront remplacs lors de la phase de personnalisation. Remarque : ne pas tenter dextraire le paramtrage CFT/MVS dans un membre de PDS.

12.6.3. Procdure de restauration du paramtrage


Cette procdure sera lance APRES linstallation de la nouvelle version CFT/MVS. Exemple de JCL de cration du paramtrage CFT/MVS partir de la sauvegarde : //CFTPARM PROC QUAL=cftv2, // OUT=sysout //PARM EXEC PGM=CFTUTIL,REGION=3000K //STEPLIB DD DSN=&QUAL..LOAD,DISP=SHR //CFTPARM DD DSN=&QUAL..PARM,DISP=SHR //CFTPART DD DSN=&QUAL..PART,DISP=SHR //CFTIN DD DSN=&QUAL..BACKUP,DISP=OLD //CFTOUT DD SYSOUT=&OUT // PEND //PARM EXEC CFTPARM

CFT V2.3

12-3

Installation de PTF sur CFT/MVS V2.3.0

12.7. Sauvegarde/Restauration des fichiers CATALOGUE COMMANDE


A la mise jour du noyau CFT/MVS, il est parfois ncessaire de sauvegarder/recrer les fichiers catalogue et commandes de CFT. La syntaxe des commandes se trouve dans le Manuel de rfrence de CFT. Le fichier MIGR2022 est un exemple de sauvegarde/restauration des 2 fichiers CFTCAT/CFTCOM. Remarques : il faut utiliser le module de migration de la mme version que le fichier migrer. Il faut effectuer le dchargement avec la version courante et le chargement du nouveau fichier avec la nouvelle version, cet utilitaire est galement appropri pour agrandir un fichier CATALOGUE. Ne pas tenter dextraire les fichiers de CFT/MVS dans des membres de PDS.

12-4

CFT V2.3

13. Installation de PTF sur CFT/MVS V2.3.1

13.1. Format du support dinstallation


Une PTF est le rsultat dune mise en forme fixe (80) dun fichier de type ADRDSSU contenant les librairies de mise jour. Le format de la PTF est commun tous les modes de livraison ou de mise disposition. Remarque : Les PTF sont cumulatives. Une installation (de base) de CFT/MVS peut galement intgrer des PTF. Dans ce cas, il faudra les appliquer une une.
Tableau 13. Librairies INSTALL SAMPLE PFTOBJ DOC CNTL MAC SCR librairies prises en compte lors du DUMP ADRDSSU Contenu Mises jour des JCL dinstallation Mises jour des SAMPLE Modules OBJECT mis jour Documentation mise jour Fichiers de contrle Macros Mise jour des Formats des crans, messages, exemples SSL

13.1.1. Mise jour de CFT/MVS par cassette


La cassette de PTF contient un seul label. Le fichier CFTV2.INIT se restaure par IEBCOPY. La PTF est identfie sous le nom CF0xxxxx o xxxxx est le numro de PTF appliquer.

13.1.2. Mise jour de CFT/MVS par CD


Les fichiers de PTF sont transfrer, via FTP par exemple, sur le site central en binaire. Le fichier sur le CD est identifi sous le nom ,par exemple, de MVS-CFT-2.3.1-P-2-7-CF0xxxxx o xxxxx est le numro de PTF appliquer.

13.1.3. Mise jour de CFT/MVS par Internet


Les fichiers PTF peuvent tre mis disposition ou livrs par Internet. Les fichiers de PTF sont transfrer, via FTP par exemple, sur le site central en binaire.

CFT V2.3

13-1

Installation de PTF sur CFT/MVS V2.3.1

13.2. Restauration de la bande PTF CFT/MVS (A13PTF)


Ce JOB restaure le fichier dune bande de PTF. Il est mis en place lors de la phase dinstallation. Le nom de volume est indiqu sur la bande. Le fichier de PTF sera restaur par IEBCOPY dans une librairie intermdiaire (UPLIB), prfixe par lALIAS de lenvironnement de distribution.

13.3. Transfert des PTF sur le host


Dans le cas ou la PTF est obtenue via un CD, Mail ., le fichier de PTF est transfrer en binaire sur le site central ( partir de la station de travail ou partir du Host), dans une librairie UPLIB prvue cet effet.

13.3.1. Transfert du fichier de PTF partir de la station de travail via FTP


Transfert binaire du fichier de PTF de la station de travail vers le Host, exemple de commandes : open hostname userid userpsw binary put d:\Install\ MVS-CFT-2.3.1-P-2-7-CF0xxxxx 'dznindx.UPLIB(CF0xxxxx)' Remarques : xxxxxx identifie le numro de PTF, dznindx est le prfixe de lenvironnement de distribution, la librairie dznindx.UPLIB a t cre lors de la phase dinstallation du produit.

13.3.2. Rcupration du fichier de PTF partir du HOST via FTP


Dans le cas ou un Serveur FTP est configur sur la station de travail, un exemple de JCL (A13PTFFT) est mis disposition pour transfrer en binaire le fichier de PTF via FTP. Au niveau du JCL, il convient de prciser ladresse de la station de travail ainsi que lidentifiant de la PTF ( prciser 2 fois).

13.4. Prise en compte des PTF


Aprs le chargement de la bande ou le transfert des fichiers PTF, il est ncessaire dintgrer les lments composants la PTF dans les librairies de distribution. Cette opration se ralise laide du JCL : A13PTFLD : intgration des PTF dans les librairies de distribution.

13-2

CFT V2.3

CFT/MVS Guide d'exploitation

Avant de soumettre le JOB il faut prciser au niveau de la carte EXEC lidentifiant de la PTF : //* ------------------------------------//* Execute procedure //* ------------------------------------//LOADPTF EXEC LOADPF,PTF=CF0xxxxx Must be cutomized Ce JOB se droule en plusieurs tapes : 1 : mise au format ADRDSSU du fichier de PTF (IKJEFT01), 2 : extraction des librairies (temporaires) de PTF (ADRDSSU), 3 : copy (avec replace) des composants de la PTF dans les librairies de distribution, 4 : suppression des librairies (temporaires) de PTF.

13.5. Informations importantes


Il est important de consulter la documentation accompagnant la PTF. Ces informations se trouvent dans la librairie de distribution .DOC, sous le nom CVSxxxxx o xxxxxx est lidentifiant de la PTF. Elle dcrit lincident, la correction et la faon dappliquer la PTF pour les cas particuliers (Exit ) .

13.6. Application dune PTF (A13PTFLK)


Dans la plupart des cas, une PTF se traduit par lapplication dun LINK-EDIT. Il existe deux modes dapplication dune correction : correction de mise niveau, correction incrmentale (contacter le Support XFB/CFT chez Axway Software). Le mode dapplication se dtermine en choisissant le plan de LINK-EDIT appliquer : CCFxxxxx pour une correction de mise niveau, CCAxxxxx pour une correction incrmentale. Avant de soumettre le JOB, il convient de prciser au niveau de la carte EXEC lidentifiant du plan de link-edit : //* ------------------------------------//* Execute procedure //* ------------------------------------//APPLY EXEC APPLY,SSIREF=CCyxxxxx Remarques : y

Must be customized

: mode de correction,

xxxxx : identifiant de la correction.

CFT V2.3

13-3

Installation de PTF sur CFT/MVS V2.3.1

Ce JOB se droule en deux tapes : 1 : sauvegarde de la librairies des LOAD (dont un des qualifiants est lidentifiant de la PTF), 2 : LINK-EDIT.

13.7. Restauration de la librairie des excutables (A13RSTOR)


Le JCL permet en cas dincident sur lapplication dune PTF ou lors du test de validation de celleci de restaurer la librairie des excutables avant son application. Avant de soumettre le JOB, il convient de prciser au niveau de la carte EXEC lidentifiant du plan de link-edit : //* ------------------------------------//* Execute procedure //* ------------------------------------//RESTOR EXEC RESTOR,SSIREF=CCyxxxxx Remarque : le moniteur devra tre arrt.

Must be customized

13.8. Suppression dune version de sauvegarde (A13SDEL)


Ce job permet de supprimer un fichier de sauvegarde aprs validation de lapplication dune PTF (sachant que chaque sauvegarde reprsente environ 130 cylindres de 3390). Avant de soumettre le JOB, il convient de prciser au niveau de la carte EXEC lidentifiant du plan de link-edit : //* ------------------------------------//* Execute procedure //* ------------------------------------//DELSAV EXEC DELSAV,SSIREF=CCyxxxxx

Must be customized

13.9. Prise en compte de nouveaux menus de linterface interactive


Les JOBs C31SCRFR et C31SCRUK permettent de mettre jour les menus de linterface interactive en franais et en anglais.

13.10. Sauvegarde/Restauration du paramtrage CFT/MVS


A la mise jour du noyau CFT/MVS, il est parfois ncessaire de sauvegarder le paramtrage existant, puis de le recharger avec la nouvelle version de lutilitaire CFTUTIL. Cette ventualit vous sera signale dans le fichier CFTV2.DOC(IMPORTAN). Cette fonction est ralise de manire simple avec la commande CFTEXT de CFTUTIL, dont lutilisation vous est rappele dans le paragraphe ci-aprs.

13-4

CFT V2.3

CFT/MVS Guide d'exploitation

13.10.1. Extraction des paramtres CFT : CFTEXT

13.10.1.1. Fonction
Lexemple CFTEXT restitue un fichier des paramtres de CFT, tels quils ont t soumis par les commandes de paramtrage de type CFTxxxx (sauf les commentaires). Le paramtre TYPE permet de slectionner le type de commande. En labsence dune prcdente commande CONFIG TYPE=OUTPUT, le compte rendu de lexcution est crit sur la sortie standard du programme CFTUTIL.

13.10.2. Procdure de sauvegarde du paramtrage


Cette procdure sera lance AVANT linstallation de la nouvelle version CFT/MVS. Exemple de JCL de sauvegarde du paramtrage CFT/MVS : //jobname JOB account,'CFTEXT',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //CFTPARM PROC QUAL=cftv2, // OUT=sysout //PARM EXEC PGM=CFTUTIL,REGION=3000K //STEPLIB DD DSN=&QUAL..LOAD,DISP=SHR //CFTPARM DD DSN=&QUAL..PARM,DISP=SHR //CFTPART DD DSN=&QUAL..PART,DISP=SHR //CFTOUT DD SYSOUT=&OUT // PEND //PARM EXEC CFTPARM //CFTIN DD * CONFIG TYPE=OUTPUT,FNAME= cftv2.BACKUP CFTEXT TYPE=ALL // Les paramtres en gras seront remplacs lors de la phase de personnalisation. Remarque : ne pas tenter dextraire le paramtrage CFT/MVS dans un membre de PDS.

13.10.3. Procdure de restauration du paramtrage


Cette procdure sera lance APRES linstallation de la nouvelle version CFT/MVS. Exemple de JCL de cration du paramtrage CFT/MVS partir de la sauvegarde : //CFTPARM PROC QUAL=cftv2, // OUT=sysout //PARM EXEC PGM=CFTUTIL,REGION=3000K //STEPLIB DD DSN=&QUAL..LOAD,DISP=SHR //CFTPARM DD DSN=&QUAL..PARM,DISP=SHR //CFTPART DD DSN=&QUAL..PART,DISP=SHR //CFTIN DD DSN=&QUAL..BACKUP,DISP=OLD //CFTOUT DD SYSOUT=&OUT

CFT V2.3

13-5

Installation de PTF sur CFT/MVS V2.3.1

// //PARM

PEND EXEC CFTPARM

13.11. Sauvegarde/Restauration des fichiers CATALOGUE COMMANDE


A la mise jour du noyau CFT/MVS, il est parfois ncessaire de sauvegarder/recrer les fichiers catalogue et commandes de CFT. La syntaxe des commandes se trouve dans le Manuel de rfrence CFT. Le fichier MIGR2022 est un exemple de sauvegarde/restauration des 2 fichiers CFTCAT/CFTCOM. Remarques : il faut utiliser le module de migration de la mme version que le fichier migrer. Il faut effectuer le dchargement avec la version courante et le chargement du nouveau fichier avec la nouvelle version, cet utilitaire est galement appropri pour agrandir un fichier CATALOGUE. Attention : ne pas tenter dextraire les fichiers de CFT/MVS dans des membres de PDS.

13-6

CFT V2.3

14. Interfaces de programmation

14.1. Prsentation
Ce chapitre dcrit les procdures de mise en uvre, des interfaces de programmation CFT (batch et CICS) et VFM (batch) pour CFT Version 2.3.0 et suivantes.

14.2. API CFT : mise en oeuvre sous OS/390


La description de linterface de programmation est donne dans le Guide de programmation de CFT. Cette interface de programmation est accessible depuis les langages de programmation Assembleur, Cobol, C. Des exemples se trouvent dans le fichier CFTV2.SAMPLE. Les rgles de chargement et dexcution du code utilisateur sont : 1. Chargement RMODE=ANY. 2. Adressage AMODE=31. Lors du LINK-EDIT du programme utilisant les services de CFT Version 2, il est ncessaire dinclure le texte USERAPI livr lutilisateur de CFT Version 2. A lexcution, une JOBLIB/STEPLIB contenant le LOAD-MODULE CFTAPI est ncessaire. Des exemples de LINK EDIT se trouvent dans les membres LINKAPI et I92APILK (LINK-EDIT des exemples livrs) de la bibliothque d'installation CFTV2.INSTALL. Exemple : LINK-EDIT du programme C$APIXP1. //jobname JOB account,'I92APILK',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //LINKEDIT PROC OUT=sysout, // COB2=cobol2, //* PLI=p370, //* C=c370, // LE=le370, // QUAL=cftv2, // MODE='AMODE=31,RMODE=ANY' //LINKAPI EXEC PGM=IEWL, // PARM='&MODE.,CALL,XREF,LET' //SYSLMOD DD DISP=SHR,DSN=&QUAL..LOAD //USER DD DISP=SHR,DSN=&QUAL..USER.OBJ ** A PERSONNALISER //CFTC DD DISP=SHR,DSN=&QUAL..OBJ //SYSUT1 DD UNIT=VIO,SPACE=(CYL,(1,1)) //SYSPRINT DD SYSOUT=&OUT //SYSLIB DD DISP=SHR,DSN=&LE..SCEELKED LE/370 // PEND

CFT V2.3

14-1

Interfaces de programmation

//CFTAPIC1 EXEC LINKEDIT //SYSLIN DD * INCLUDE USER(C$APIXP1) INCLUDE CFTC(USERAPI) NAME CFTAPIC1(R) /* //

C SAMPLE

Les paramtres en gras seront remplacs lors de la phase de personnalisation.

14.2.1. Exemples de programmation


Des exemples se trouvent dans le fichier CFTV2.SAMPLE : en Assembleur : A$APIXP1 utilisation CFTAI CFTAC CFTAU, AAPIUST 'macro' de description de la zone de slection, de la zone catalogue rendue,... O$APIC utilisation CFTC, O$APII utilisation CFTI, O$APIU utilisation CFTU, O$APISW dpt d'une requte et attente du rsultat, OAPIUST 'clause copy' de description de la zone de slection, de la zone catalogue rendue,...

en Cobol : -

En Cobol le mode dappel statique des sous-programmes API est impos. en langage C : C$APIC utilisation CFTAI CFTAC CFTAU, C$APILI liste d'un catalogue distance (utilisation de l'exit-list), CAPIUST 'include' de description de la zone de slection, de la zone catalogue rendue,...

Les JCL de compilation, LINK-EDIT et excution de ces exemples se trouvent dans le fichier CFTV2.INSTALL et portent les noms I91APICP, I92APILK, I93APIRN. Le JOB de compilation est adapter votre environnement.

14.3. CFT : mise en oeuvre sous CICS


Linterface de programmation, sous CICS, permet aux utilisateurs daccder au catalogue et/ou de dposer des commandes dans le mdia de communication CFT/V2, laide de transactions. Cette interface se compose de deux programmes COBOL : CFTI grant les accs au catalogue via un index secondaire, CFTC grant les accs au fichier de communication. Linstallation des deux modules peut se faire indpendamment en fonction des besoins. Lutilisateur devra disposer dune version de CICS gale ou suprieure la 2.1 et suivantes.

14-2

CFT V2.3

CFT/MVS Guide d'exploitation

14.3.1. Interrogation du catalogue : CFTI 14.3.1.1. Paramtrage de CICS


1. Rfrencer le programme dans la Processing Program Table : OBJECT CHARACTERISTICS CEDA View PROGram : CFTI Group: CFT Language : Cobol Cobol ! Assembler ! Pli ! Rpg RELoad : No No ! Yes RESident : No No ! Yes RSl : 00 0-24 ! Public Status : Enabled Enabled ! Disabled Processing Program Table CFTI. 2. Dfinir la voie daccs au catalogue dans la File Control Table. Le nom, correspondant au DDNAME du fichier, sera un nom mnmonique de sept caractres au maximum. Ce nom mnmonique aura la valeur CFTCATx (x prenant une valeur numrique quelconque ou blanc). Par dfaut, il prendra la valeur CFTCAT. Le suffixe permet de faire la relation entre le fichier catalogue et le fichier de communication. Il permet galement de travailler avec plusieurs couples CFTCATx/CFTCOMx de diffrents CFT. CFTCATx TYPE=DATASET, DSNAME=CFTV2.CFTPATHx, ACCMETH=(VSAM), FILSTAT=(OPENED,ENABLED), SERVREQ=(BROWSE,READ), RECFORM=(VARIABLE,BLOCKED), DFHFCT FILE=CFTCATx, DISP=SHR,

File Control Table

RSL=PUBLIC, BUFNI=1, BUFND=2, STRNO=2

CFT V2.3

14-3

Interfaces de programmation

14.3.2. Commandes de transferts : CFTC

14.3.2.1. Paramtrage de CICS


1. Rfrencer le programme dans la Processing Program Table : OBJECT CHARACTERISTICS CEDA View PROGram : CFTC Group: CFT Language : Cobol Cobol ! Assembler ! Pli ! Rpg RELoad : No No ! Yes RESident : No No ! Yes RSl : 00 0-24 ! Public Status : Enabled Enabled ! Disabled Processing Program Table 2. Dfinir le fichier de communication dans la File Control Table. Le nom, correspondant au DDNAME du fichier, sera un nom mnmonique de sept caractres au maximum. Ce nom mnmonique aura la valeur CFTCOMx (x prenant une valeur numrique quelconque ou blanc). Par dfaut, il prendra la valeur CFTCOM. CFTCOMx TYPE=DATASET, DSNAME=CFTV2.CFTCOMx, ACCMETH=(VSAM), FILSTAT=(OPENED,ENABLED), SERVREQ=(UPDATE,READ), RECFORM=(VARIABLE,BLOCKED), RSL=PUBLIC, BUFNI=1, BUFND=2, STRNO=2 DFHFCT FILE=CFTCOMx, DISP=SHR,

File Control Table

14-4

CFT V2.3

CFT/MVS Guide d'exploitation

14.3.2.2. Dfinition du fichier de communication


Le fichier de communication sera dfini par une commande CFTFILE (consulter leManuel de rfrence de CFT). Remarque : il est obligatoire de dfinir un fichier de communication SPECIFIQUE aux applications CICS.

14.3.3. Utilisation

14.3.3.1. Syntaxe dappel


Les deux programmes sont appels par "LINK" en passant une "COMMAREA", contenant les diffrentes zones de lAPI batch. La clause copy de la "COMMAREA" est fournie avec lAPI. EXEC CICS LINK PROGRAM (CFTx) COMMAREA (CFTARA) LENGTH (CFTARA-LGR) END-EXEC. x reprsentant le caractre C ou I.

14.3.3.2. Codes retour


Les codes retour sont identiques ceux de lAPI batch. Si une erreur se produit sur un ordre CICS, la zone "CFTARA-RESERVE" contient le nom de la commande ayant provoqu lerreur (EIBFN), la response code CICS (EIBRCODE) et les deux codes complmentaires (EIBRESP, EIBRESP2).

14.3.3.3. Interrogation du catalogue : CFTI


Les paramtres tant identiques lAPI batch, seules les diffrences sont dcrites dans ce paragraphe (consulter le Guide de programmation de CFT) : initialisation : OPEN. Ce service permet de savoir quel catalogue CFT et quel fichier de communication lutilisateur sadresse ; il permet galement de vrifier sa bonne dfinition sous CICS. Le paramtre "D-CAT" contiendra le nom du catalogue, slection : SELECT. Les critres de slection possibles sont les suivants : TYPE DIRECT STATE PART IDF : Type de transfert, : Direction, : Etat, : Partenaire, : Identifiant de fichier,

CFT V2.3

14-5

Interfaces de programmation

IDT BDATE EDATE

: Identifiant de transfert, : Date de dbut de transfert, : Date de fin de transfert,

des masques (xx*yy?z) sont utilisables pour les champs PART, IDF, IDT : * pour une chane de caractres, ? pour 1 caractre,

scrutation : NEXT. Dlivrance des enregistrements du catalogue suivant les critres de slection, modification : MODIFY. Modification de ltat du transfert du poste du catalogue prcdemment lu. La commande correspondante sera dpose dans le fichier CFTCOMx correspondant au catalogue CFTCATx, x tant un caractre alphanumrique quelconque ou , terminaison : CLOSE. Libration des blocs de contrle.

14.3.3.4. Commandes des transferts : CFTC


Les commandes sont traites sans analyse syntaxique : allocation : COM. La commande "COM" permet de dfinir un type de mdia de communication. Le seul type mdia support sous CICS est le type "F=" pour fichier. Ce paramtre sera suivi du nom du fichier de communication, autres commandes. La zone "Z-CMD" contient les paramtres de la commande excuter. Exemple : clause COPY de communication avec CFT : fichier CFTV2.SAMPLE(CICSCOM).
*----------------------------------------------------------------* * LONGUEUR DE LA COMMAREA * *----------------------------------------------------------------* 77 CFTARA-LGR PIC S9(004) COMP VALUE +2127. *----------------------------------------------------------------* * DESCRIPTION DE LA COMMAREA * *----------------------------------------------------------------* 01 CFTARA. *----------------------------------------------------------------* * TYPE DE SERVICE DEMANDE * *----------------------------------------------------------------* 05 CFTARA-SERVICE PIC X(009). *----------------------------------------------------------------* * RESERVEE * *----------------------------------------------------------------* 05 CFTARA-RESERVE PIC X(016). *----------------------------------------------------------------* * DONNEES TRANSMISES AU SOUS-PROGRAMME OU * * DONNEES RENDUES PAR LE SOUS-PROGRAMME * *----------------------------------------------------------------* 05 CFTARA-DONNEES PIC X(2100). *----------------------------------------------------------------* * CODE RETOUR DU SERVICE * *----------------------------------------------------------------* 05 CFTARA-RC. 10 CFTARA-RET PIC 9(002).

La clause COPY de la dfinition des enregistrements catalogue se trouve dans le fichier

14-6

CFT V2.3

CFT/MVS Guide d'exploitation

CFTV2.SAMPLE(OAPIUST). Un exemple de transaction dinterrogation du catalogue est livr dans le fichier CFTV2.SAMPLE(COB$CICS).

14.4. VFM : mise en oeuvre sous OS/390


La description de linterface de programmation est donne dans le Guide d'utilisation de l'interface de programmation VFM de CFT. Cette interface de programmation est accessible depuis les langages de programmation Assembleur, Cobol, C. Des exemples se trouvent dans le fichier CFTV2.SAMPLE. Les rgles de chargement et dexcution du code utilisateur sont : 1. Chargement RMODE=ANY. 2. Adressage AMODE=31. Lors du LINK-EDIT du programme utilisant les services de CFT Version 2, il est ncessaire dinclure le texte USERAPI livr lutilisateur de CFT Version 2. A lexcution, une JOBLIB/STEPLIB contenant le LOAD-MODULE CFTAPI est ncessaire. Des exemples de LINK EDIT se trouvent dans les membres LINKAPIV de la bibliothque d'installation CFTV2.INSTALL. Exemple : LINK-EDIT du programme C$APVXP1 :
//jobname JOB account,'LINKAPIV',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //LINKEDIT PROC OUT=sysout, // COB2=cobol2, //* PLI=p370, //* C=c370, // LE=le370, // QUAL=cftv2, // MODE='AMODE=31,RMODE=ANY' //LINKAPI EXEC PGM=IEWL, // PARM='&MODE.,CALL,XREF,LET' //SYSLMOD DD DISP=SHR,DSN=&QUAL..LOAD //USER DD DISP=SHR,DSN=&QUAL..USER.OBJ ** A PERSONNALISER //CFTC DD DISP=SHR,DSN=&QUAL..OBJ //SYSUT1 DD UNIT=VIO,SPACE=(CYL,(1,1)) //SYSPRINT DD SYSOUT=&OUT //SYSLIB DD DISP=SHR,DSN=&LE..SCEELKED LE/370 //* DD DISP=SHR,DSN=&PLI..SIBMBASE C/IBM //* DD DISP=SHR,DSN=&C..SEDCBASE C/IBM // DD DISP=SHR,DSN=&COB2..LOADLIB COBOL 2 // PEND //CFTAPIC1 EXEC LINKEDIT C SAMPLE //SYSLIN DD * INCLUDE USER(C$APVLP1) INCLUDE CFTC(USERAPI) NAME CFTAPVC1(R) /* //

Les paramtres en gras seront remplacs lors de la phase de personnalisation.

CFT V2.3

14-7

Interfaces de programmation

14.4.1. Exemples de programmation


Des exemples se trouvent dans le fichier CFTV2.SAMPLE : en Assembleur : A$APVXP1. AAPVUST 'macro' de description des paramtres, en Cobol : O$APVXP1, O$APVXP2. OAPVUST 'clause copy' de description des paramtres. En Cobol, le mode dappel statique est impos, en langage C : C$APVL, C$APVU. CAPVUST 'include' de description des paramtres.

14-8

CFT V2.3

15. Exits

15.1. Exit ASIT


La description de lexit ASIT de CFT Version 2 est donne dans le Guide des protocoles de CFT. Il est obligatoirement crit en assembleur. Les rgles de chargement et dexcution de lexit sont : 1. Chargement RMODE=24. 2. Adressage AMODE=24. La liste de paramtres est adresse en 24 BITS. Le JOB suivant est un exemple de LINK-EDIT de lexit ASIT : //jobname JOB account,'LINKASIT',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* //LINKEDIT PROC OUT=sysout, // QUAL=cftv2 //CFTASIT EXEC PGM=IEWL, // PARM='SIZE=(524288,262144),LIST,LET,NCAL' //SYSLMOD DD DSN=&QUAL..LOAD,DISP=SHR //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) //SYSPRINT DD SYSOUT=&OUT //SYSLIN DD DDNAME=SYSIN // PEND //LINK EXEC LINKEDIT //SYSIN DD * .. LINK-EDIT STATEMENTS .. ** A PERSONNALISER NAME CFTASX(R) OBLIGATOIRE // Les paramtres en gras seront remplacs lors de la phase de personnalisation. Un exemple se trouve dans le fichier CFTV2.SAMPLE : A$ASIXP1, AASIUST 'macro' de description de la zone de communication.

15.2. Exit-list
Pour utiliser lexit-list, il est ncessaire de crer le LINK-EDIT grce au JOB LINKEXIL de la librairie CTTV2.INSTALL. Pour toute information complmentaire, se reporter au Guide de lExit-list de CFT.

CFT V2.3

15-1

Exits

15.3. Exits de CFT


La description gnrale des exits est donne dans le "Guide de programmation" de CFT. Ce chapitre donne les complments ncessaires la ralisation dexits sous OS/390.

15.3.1. Introduction aux exits de CFT


CFT offre lutilisateur plusieurs familles dexits : type annuaire (*)=A type fichier type fin de transfert type carte ETEBAC3 (*)=F (*)=E (*)=3

(*) Dans la suite des explications, le caractre * fait rfrence aux 4 exits et sera remplac par lun des 4 caractres "A, E, F, 3", selon votre besoin. Un exit est un programme compos de 3 parties : le moniteur des exits livr avec CFT, le programme d'initialisation EX*INI, le programme principal dont ladresse est rendue par le programme dinitialisation EX*INI. Le programme EX*INI et le programme principal sont crits par lutilisateur de CFT, puis LINK-EDITE avec le moniteur dexits. Le nom de la fonction dinit "EX*INI" est impos selon lexit : EXAINI : type annuaire, EXFINI : type fichier, EXEINI : type fin de transfert, EX3INI : type carte ETEBAC3. Le programme exit est charg dynamiquement par CFT la premire demande. Il sexcute comme une sous-tche OS du moniteur. Les programmes seront crits par lutilisateur en ASSEMBLEUR 370, en C IBM ou en COBOL for OS/390 version 1.2 et suprieures. Lutilisation simultane de C et de COBOL est possible. Les programmes peuvent tre appels conscutivement pour des transferts diffrents. Les programmes doivent donc tre rutilisables en srie. Chaque zone de donnes du programme sera rinitialise chaque appel, et NON PAS dclare avec une valeur initiale. Plusieurs exits diffrents peuvent sexcuter simultanment, chacun tant une tche indpendante. Il est donc impossible 2 exits dcrire dans le mme fichier, en particulier les fichiers SYSPRINT, SYSDBOUT STDOUT de mise au point des langages C ou COBOL. Linterface exit communique avec le moniteur en utilisant des zones mmoire en 31 bits. Le nom des load-module exits doit toujours commencer par les 6 caractres CFTEXI. Les exits sont appels en mode problme et cl utilisateur. Ils ont les mmes privilges que le moniteur CFT qui est le plus souvent un programme autoris.

15-2

CFT V2.3

CFT/MVS Guide d'exploitation

Loption de mise au point SGTRACE 512 permet dobtenir dans le fichier SGTRACE les informations suivantes, avant chaque appel de la fonction de traitement : EX*3RUN-PARM1-5 : 5 mots en hexadcimal : mot 1 : adresse de traitement, mots 2 5 : adresses des 4 paramtres reus,

EX*3RUN-DUMPCTX : 32 ou nnnn octets en hexadcimal. Les 32 premiers octets (SGTRACE=512) ou la totalit (SGTRACE=544) de la zone paramtre passe lexit sont lists. En cas dabend dans lexit, la fonction de traitement des erreurs de CFT prend la main : un diagnostic sommaire de lerreur est affich la console MVS. Exemple de diagnostic CFT : SGAB00E: Jobname Stepname SITMOS Date Heure Version ABEND = 84sssuuu , PSW =xxxxxxxx xxxxxxxx , EPA =xxxxxxxx SGAB01E: REG 0-7 =xxxxxxxx ....... SGAB02E: REG 8-15=xxxxxxxx ...... SGAB03E: SGNUC =xxxxxxxx , TRACE =xxxxxxxx ... SGAB08E: INSTRUCTIONS : xxxxxxxx:-6 xxxxxxx SGAB08E: ** USER EXIT ABEND DETECTED ** L=l EPA= x NAME=Mod SGAB30E: xxxxxxxx CFTEXInn TCB: Tcbaddr SGNUC: xxx EPA : Epa SGAB09E: TASK-AC =CFTEXInn , KCB =xx , PRV =xx ,SGSAVE =xxSAVE = Saveaddr MODULE = EXITASK date Version EPA= xx RET= xx De plus : une dition de la trace interne de CFT est prise dans le fichier SGSTAE, un dump est pris ou non selon la valeur de MAXDUMP, CFT dtecte labsence de rponse de lexit et le transfert passe en tat HOLD. Dans le cas dun Exit en COBOL ou en C, le diagnostic est galement disponible dans le fichier CEEDUMP .

15.3.2. Ralisation des exits en assembleur 370


Pour raliser des exits en assembleur 370, vous disposez des fichiers suivants : CFTV2.SAMPLE(A$EXFINI) : exemple de programme EXFINI crit en assembleur. Cet exemple rend ladresse de traitement EXFXMP1. Tous les exemples de programmes en assembleur sont de la forme "A$EX*INI", CFTV2.SAMPLE(A$EXFXMP) : exemple de programme de traitement EXFXMP1. Cet exemple appelle linterface RACF et vrifie que le demandeur ou le destinataire du fichier a le droit dy accder. Cet exemple est valable galement pour des fichiers logiques VFM. Tous les exemples de programmes en assembleur sont de la forme "A$EX*XMP", CFTV2.MAC(AEXFUST) : macro contenant les DSECT des zones dchange avec le moniteur CFT. Toutes les macros assembleur sont de la forme "AEX*UST".

CFT V2.3

15-3

Exits

CFTV2.OBJ(LINKEXFA) : modules du moniteur pour des exits crits en assembleur EXCLUSIVEMENT. Tous les objets assembleur sont de la forme "LINKEX*A", CFTV2.INSTALL(LINKEXFA) : exemple de JCL de LINK-EDIT. Tous les exemples sont de la forme "LINKEX*A".Le mode de chargement RMODE est libre. Lexemple prcit fonctionne en RMODE ANY. Le mode dadressage AMODE est 24 ou 31 bits. Lexemple prcit fonctionne en AMODE 31. Cet exemple suppose que le moniteur CFT est un programme autoris. Pour raliser des exits en assembleur 370, vous disposez des fichiers indiqus dans le tableau suivant :
Tableau 14. Fichier A$EX*INI A$EX*XMP AEX*UST LINKEX*A Ralisation des exits en assembleur 370 Dfinition Exemple de programme init crit en assembleur Cet exemple rend ladresse de traitement Exemple de programme de traitement EX*XMP1 Cet exemple est li au type dexit Macro contenant les DSECT des zones dchange avec le moniteur CFT Modules du moniteur pour des exits en assembleur exclusivement

Exemple de LINK-EDIT : //jobname JOB account,'LINKEXFA',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* //LINKEDIT PROC OUT=sysout, // QUAL=cftv2 //LINK EXEC PGM=IEWL, // PARM='LIST,LET,MAP,XREF,AC(1),NCAL' //SYSLMOD DD DSN=&QUAL..LOAD,DISP=SHR //CFTC DD DSN=&QUAL..PTFOBJ,DISP=SHR // DD DSN=&QUAL..OBJ,DISP=SHR //SYSUT1 DD UNIT=VIO,SPACE=(CYL,(1,1)) //SYSPRINT DD SYSOUT=&OUT //SYSLIN DD DDNAME=SYSIN //USER DD DISP=SHR,DSN=&QUAL..USER.OBJ ** A PERSONNALISER // PEND //LKED EXEC LINKEDIT //LINK.SYSIN DD * INCLUDE CFTC(LINKEXFA) OBLIGATOIRE INCLUDE USER(A$EXFINI) ** A PERSONNALISER INCLUDE USER(A$EXFXMP) ** A PERSONNALISER MODE AMODE(31) ** A PERSONNALISER MODE RMODE(ANY) ** A PERSONNALISER ENTRY CFTEXIT OBLIGATOIRE NAME CFTEXIfa(R) Change 'fa' digits ONLY // Les paramtres en gras seront remplacs lors de la phase de personnalisation.

15-4

CFT V2.3

CFT/MVS Guide d'exploitation

15.3.3. Ralisation des exits en C


Pour raliser des exits en C, vous disposez des fichiers suivants : CFTV2.SAMPLE(C$EXFINI) : exemple de programme EXFINI crit en C. Cet exemple rend ladresse de traitement EXFXMP1. Tous les exemples de programmes INIT en C sont de la forme "C$EX*INI", CFTV2.SAMPLE(C$EXFXMP) : exemple de programme de traitement EXFXMP1. Tous les exemples de programmes en C sont de la forme "C$EX*XMP", CFTV2.SAMPLE(CEXFUST) : include de description de la zone de communication. Tous les exemples de ".H" sont de la forme "CEX*UST", CFTV2.OBJ(LINKEXLE) : modules du moniteur pour des exits contenant au moins 1 module crit en C, CFTV2.INSTALL(LINKEXLE) : Exemple de JCL de LINK-EDIT.
Tableau 15. Fichier C$EXAINI C$EXAXMP CEXAUST LINKEXLE Exemples pour la ralisation dun exit annuaire en C Dfinition Exemple de programme EXAINI crit en C Cet exemple rend ladresse de traitement EXAXMP1 Exemple de programme de traitement EXAXMP1 Include C contenant les zones dchange avec le moniteur CFT Modules du moniteur pour des exits contenant au moins 1 module crit en C

Le mode de chargement RMODE est libre. Le mode dadressage AMODE 31 est impos. Les fonctions dentres-sorties GETx et PUTx ne sont pas utilisables car sadressant aux fichiers SYSIN et SYSPRINT. A la place, utiliser FGETx et FPUTx en prcisant un nom de fichier diffrent dans chaque exit. Le programme MAIN reoit par dfaut les paramtres dexcution suivants : HEAP(32K,32K,ANYWHERE,FREE) STACK(64K,32K,ANY,FREE) RPTSTG(OFF) RPTOPT(OFF)' TRACE(OFF,4K,DUMP,LE=3)' TRAP(ON ) ABTERMENC(ABEND)

CFT V2.3

15-5

Exits

Ces options sont contenues dans le module EXIPARMD que lutilisateur peut rcrire en assembleur si besoin est, selon lexemple qui suit : EXIPARMD CSECT , Obligatoire DC AL2(FINPARMC-DEBPARMC) Obligatoire DEBPARMC DC C' ' DC C' HEAP(32K,32K,ANYWHERE,FREE)' DC C' STACK(64K,32K,ANY,FREE)' DC C' RPTSTG(OFF) RPTOPT(OFF)' DC C' TRAP(ON ) ' DC C' ABTERMENC(ABEND) ' FINPARMC DS END 0C Obligatoire

Ce module sera toujours inclus avant LINKEXLE dans le LINK-EDIT. Exemple de LINK-EDIT sappliquant galement aux exits en COBOL : //jobname JOB account,'LINKEXFC',CLASS=class, // MSGCLASS=msgclass,NOTIFY=userid jobparm //* //LINKEDIT PROC OUT=sysout, // LE='le370', // QUAL=cftv2 //LINK EXEC PGM=IEWL, // PARM='LIST,LET,MAP,XREF,AC(1)' //SYSLMOD DD DSN=&QUAL..LOAD,DISP=SHR //CFTC DD DSN=&QUAL..PTFOBJ,DISP=SHR // DD DSN=&QUAL..OBJ,DISP=SHR //SYSUT1 DD UNIT=VIO,SPACE=(CYL,(1,1)) //SYSLIB DD DSN=&LE..SCEELKED,DISP=SHR LE/370 //SYSPRINT DD SYSOUT=&OUT //SYSLIN DD DDNAME=SYSIN //USER DD DISP=SHR,DSN=&QUAL..USER.OBJ ** A PERSONNALISER // PEND //LKED EXEC LINKEDIT //* //LINK.SYSIN DD * INCLUDE CFTC(EXIPARMC) OPTIONS UNIQUEMENT INCLUDE CFTC(LINKEXLE) OBLIGATOIRE INCLUDE USER(C$EXFINI) ** A PERSONNALISER INCLUDE USER(C$EXFXMP) ** A PERSONNALISER MODE AMODE(31) OBLIGATOIRE MODE RMODE(ANY) ** A PERSONNALISER ENTRY CFTEXIT OBLIGATOIRE NAME CFTEXIfc(R) Change 'fc' digits ONLY. // Les paramtres en gras seront remplacs lors de la phase de personnalisation.

15-6

CFT V2.3

CFT/MVS Guide d'exploitation

En cas dabend dans lexit, CFT liste dans le diagnostic sommaire les modules appels en ordre inverse de lappel : C/DSA = Adsave MODULE = exfxmp1 AAAAMMJJHHmm EPA= xx RET= xx +Offset C/DSA = Adsave MODULE = exfrun AAAAMMJJHHmm EPA= xx RET= xx +Offset C/DSA = Adsave MODULE = main AAAAMMJJHHmm EPA= xx RET= xx +Offset Avec : C/DSA : adresse de la save area du module appel, MODULE : nom de la fonction C, AAAAMMJJHHmm : anne, mois, jour, heure, minute de la compilation du programme source, EPA : adresse dentre dans la fonction, RET : adresse de retour lappelant, Offset : dplacement dans le module. Les modules exfrun et main font partie du moniteur livr avec CFT. Vous trouverez des indications pour la mise au point des programmes C dans la brochure IBM C DIAGNOSIS.

15.3.4. Ralisation des exits en COBOL for OS/390


Pour raliser des exits en COBOL, vous disposez des fichiers suivants : CFTV2.SAMPLE(A$EXFINI) : exemple de programme EXFINI crit en assembleur. Cet exemple rend ladresse de traitement EXFXMP1. Ce programme ne peut tre crit en COBOL. Tous les exemples de programmes en assembleur sont de la forme "A$EX*INI", CFTV2.SAMPLE(O$EXFXMP) : exemple de programme de traitement EXFXMP1. Tous les exemples de programmes en COBOL sont de la forme "O$EX*INI", CFTV2.SAMPLE(OEXFUST) : clause COPY de description de la zone de communication. Toutes les clauses COPY COBOL sont de la forme "OEX*UST", CFTV2.OBJ(LINKEXLE) : modules du moniteur pour des exits contenant au moins un module crit en COBOL, CFTV2.INSTALL(LINKEXLE) : exemple de JCL de LINK-EDIT. Remarque : les programmes crits en COBOL seront compils avec loption suivante : RENT. Le LINK-EDIT est identique celui dun exit en C.

CFT V2.3

15-7

Exits

Pour raliser des exits en COBOL, vous disposez des fichiers indiqus dans le tableau suivant.
Tableau 16. Ralisation des exits en COBOL Fichier ASEX*INI Dfinition Exemple de programme init crit en assembleur Cet exemple rend ladresse de traitement Ce programme ne peut tre crit en COBOL Exemple de programme de traitement Clause COPY contenant les zones dchange avec le moniteur CFT

O$EX*XMP OEX*UST

15.4. Appel des API de CFT dans les EXITS


L'appel aux APIs (consultation du catalogue et dpt de requtes CFT) est support dans les Exits. Seul le dpt de commandes CFT par le service de MAILBOX nest pas support.

15-8

CFT V2.3

16. Commandes de linterface oprateur de CFT sous OS/390

16.1. Prsentation
Ce chapitre permet lutilisateur de CFT Version 2.3.0 et suivantes de mettre en uvre les commandes de diagnostics, permettant la recherche danomalies dans le fonctionnement de CFT Version 2.

16.2. Commandes de linterface oprateur


Linterface oprateur de CFT sous OS/390 accepte deux types de commandes : la plupart des commandes CFT Version 2 dcrites dans le Manuel de rfrence de CFT, les commandes de diagnostic dcrites dans ce chapitre.

16.2.1. Rponse de linterface oprateur


Linterface oprateur de CFT sous OS/390 fournit les rponses suivantes : SGOP02I Command Complete jj/mm/aaaa, hh:mm:ss. ; la commande est traite sans erreur, CFTT00W CFT request warning - Unknown oper request ; la commande est inconnue de CFT, SGOP03E Command error,RC=xxxxxxxx. ; la commande se termine avec le code retour xx, SGCM03E Command ignored; le moniteur CFT nest pas prt traiter cette commande.

16.3. Commandes de diagnostic


Les commandes de diagnostics sont destines la recherche des anomalies de fonctionnement de CFT Version 2. Elles doivent tre utilises la demande du Support Client de CFT Version 2 et sur ses directives. Le format et lutilisation de ces commandes sont expliqus ci-aprs.

CFT V2.3

16-1

Commandes de linterface oprateur de CFT sous OS/390

16.3.1. Format et utilisation des commandes de diagnostic 16.3.1.1. Commande SGTRACE


La commande SGTRACE permet de grer un fichier de traces externes. Les valeurs possibles de la commande SGTRACE sont les suivantes : ON : active la trace, OFF : inactive la trace, CLOSE : ferme le fichier de trace, OPEN : ouvre le fichier de trace, Nnnnnn : valeur numrique de 0 a 511, permettant de slectionner les vnements enregistrs, quand la valeur correspondante est vraie. Les valeurs possibles sont : 1 2 4 8 16 32 64 : trace des messages rseau, : trace des codes retour non 0 et dautres erreurs, : trace des manipulations de fichiers DASDM/CATALOG/SVC99, : trace des lectures/critures des fichiers, : trace des appels aux fonctions C, : trace LONGUE des messages rseau (sinon, trace des 32 premiers caractres), : trace des communications entre tches CFT Version 2,

128 : trace des appels de programmes, 256 : trace des actions de linterface cran, 512 : trace des appels aux exits de CFT.

La commande SGTRACE permet de modifier dynamiquement loption par dfaut dfinie dans SGINSTAL ou prcise en PARM.

16.3.1.2. Utilisation du fichier SGTRACE


Le fichier SGTRACE est automatiquement ouvert lors de linitialisation de CFT Version 2. La trace est marque logiquement active si louverture est correcte. La valeur de trace utilise est celle qui a t dfinie lors de linstallation, dans la MACRO SGINSTAL (A12OPTS). Lenregistrement des vnements est effectif si les conditions suivantes sont remplies : lvnement est slectionn, la trace est logiquement active, le fichier est ouvert. Ce fichier est de format FIXE BLOQUE, LRECL=132. Il est possible de changer la valeur de trace utilise par le champ PARM de chaque programme CFT Version 2.

16-2

CFT V2.3

CFT/MVS Guide d'exploitation

Exemple : // UTIL EXEC PGM = CFTUTIL, // PARM = SGTRACE nnn SGTRACE nnn doivent tre les premier et deuxime paramtres du champ PARM. En labsence de carte DD SGTRACE, CFT OS/390 alloue dynamiquement le fichier en : SYSOUT = A.

16.3.1.3. Commande ITRACE


La commande ITRACE permet de grer la trace interne de CFT Version 2 et le fichier associ SGSTAE. Les valeurs possibles de la commande ITRACE sont : ON : marque la trace logiquement ACTIVE, OFF OPEN : : marque la trace logiquement INACTIVE, ferme le fichier de trace, ouvre le fichier de trace, valeur numrique de 4 4096 permettant de modifier la taille du buffer de trace interne, en K-octets. CLOSE : Nnnnnn :

La trace interne est automatiquement active linitialisation de CFT Version 2. La taille du buffer de trace utilis est celle qui a t dfinie lors de linstallation, dans la MACRO SGINSTALL.

16.3.1.4. Utilisation du fichier SGSTAE


Le fichier SGSTAE est automatiquement ouvert lors de linitialisation de CFT Version 2. Ce fichier reoit une dition mise en forme de la trace interne chaque ABEND de CFT Version 2. Ce fichier est de format FIXE BLOQUE, LRECL=132. En labsence de carte DD SGSTAE, CFT OS/390 alloue dynamiquement le fichier en : SYSOUT = A.

16.3.1.5. Commande DEBUG


La commande DEBUG permet de demander une dition formate de trace interne de CFT Version 2, sur le fichier SGSTAE. Cette commande na pas de paramtre.

16.3.1.6. Commande ABEND


La commande ABEND provoque un ABEND 0C1 dans le module oprateur. Elle provoque un DUMP de CFT Version 2 ainsi quune dition formate de la trace interne de CFT Version 2, sur le fichier SGSTAE. Cette commande na pas de paramtre. Cette commande dcrmente les compteurs MAXABEND et MAXDUMP dfinis dans SGINSTAL.

CFT V2.3

16-3

Commandes de linterface oprateur de CFT sous OS/390

16.3.1.7. Commande ECHO


La commande ECHO na pas deffet. Elle se termine par le message : SGOP02I: MVS CFTnnnn. Elle permet de vrifier que CFT Version 2 est oprationnel.

16.3.1.8. Commande SNA


La commande SNA permet de lister et dagir sur les ressources rseau SNA. Les options disponibles sont les suivantes : LIST : lister les ressources et les sessions SNA, OPEN Resname KILL Rfrence : ouvrir une ressource SNA, : fermer une session SNA en donnant sa rfrence. CLOSE Resname : fermer une ressource SNA, Remarque : les commandes daction sont excutes SANS vrification pralable de ltat de la ressource ou de la session. Il est parfois ncessaire de passer deux fois la commande KILL pour librer une session SNA. Il est conseill dutiliser en priorit les commandes VTAM VARY ACT/INACT.

16.3.1.9. Rponse a la commande SNA LIST


Le display est unique pour SNA et LU 6.2. CLASSE SNA=0003, ACBNAME=A105CF31 OPEN. CLASSE SNA=0001, ACBNAME=A105CF30 CLOSED. Acb Vtam et son tat LU-62= 0023C2F0,TRAP= 0023C440 CLASSE L62=0006, ACBNAME=A105CF50 OPEN. Acb et son tat SESSION LU6=A105CF51,ACBNAME=A105CF50,CID=0100002B SEN=00000008 REC=00000017 PREPRCV DATAFLU . DTOD03I:TOD=14:46:11:009612 ,REF=1C1400CB. Les sessions sur cet ACB

16.4. Commandes ?
La commande "?" permet de connatre ltat de certains composants du moniteur CFT/MVS. Les options disponibles sont les suivantes : ? TASK : lister les tches du moniteur, ? FILES : lister les fichiers ouverts, ? ENQ : lister les ressources partages et les conflits, ? SCB : lister les files dattente du moniteur et leur tat,

16-4

CFT V2.3

CFT/MVS Guide d'exploitation

? TCP : lister l'tat de la sous tche TCP/IP, ? APF : lister l'tat APF ON/OFF et l'utilisateur par dfaut, ? MODULES : lister les modules rsidents, ? MEM : lister ltat de la mmoire dans le fichier SGTRACE, ? LU6 : Etat du rseau LU 6.2, ? Thhhhhhhh : Affichage de la mmoire ladresse hexadcimale hhhhhhhh de la rgion CFT, 16 octets aligns un double mot, ? NTF : lister l'tat de la sous tche XFB/SCOPE, ? SSL : lister l'tat de la sous tche CFTSSL, ? EXITS : lister l'tat des sous tche(s) CFTEXIT, ? ABTCP : lister l'tat de la sous tche TCP/IP, puis provoquer un ABEND-S0C6 dans cette soustache. A utiliser uniquement sur instruction du service client XFB, ? ABNTF : lister l'tat de la sous tche XFB/SCOPE, puis provoquer un ABEND-S0C6 dans cette sous-tache. A utiliser uniquement sur instruction du service client XFB, ? ABSSL : lister l'tat de la sous tche CFTSSL, puis provoquer un ABEND-S0C6 dans cette soustache. A utiliser uniquement sur instruction du service client XFB.

16.4.1. Rponse des commandes de DISPLAY 16.4.1.1. TASK


DTSK01I:TASK SUMMARY (SGNUC=001EA000) : DTSK02I:002BFA20 " L62RCAK" EPA=07602480 OWN=CFTR223 PRIVATE. Addr bloc de tache, EPA, Nom de lutilisateur, Type Priv/OS DTOD03I:TOD=16:11:50:155444. TOD de dernier DISPATCH DTSK03I:0022F000 "CFTTPRO " EPA=8765BF18 TCB=006F6388 OWN=CFTR223 . Tache OS

CFT V2.3

16-5

Commandes de linterface oprateur de CFT sous OS/390

16.4.1.2. FILES
DFIL01I:FILE SUMMARY : DFIL02I:0022EE90 "FIL00007" "SOP$CFT.REF.C223.COMCICS Addr FCB, DDNAME, DSNAME " UPDATE Type dacces TOD=14:09:55:978181 GU SGFVSDIR 300500 A220461. TOD,de dernier acces, opration, module/date/revision

16.4.1.3. ENQ
DENQ01I:ENQ SUMMARY : DENQ02I:0725DEA0 "CFTPARM " "90.SOP$CFT.REF.C223.PARM " EXC SYSTEM . Addr bloc, QNAME RNAME Type Scope DTOD03I:TOD=16:11:46:351245. TOD de ENQ Suivi de la liste des demandeurs en attente

16.4.1.4. SCB
DSCB01I:SCB SUMMARY : DSCB02I:ADR=002BF520 RF=1BB20069 FL=110000E8 OW=001FEA20(CFTINTV ) PC=0 TM=8640001. Addr File, Reference, flags, Taches cratrice, Nb de messages posts Temps dattente en 1/100iemes DTOD03I:TOD=12:07:57:156629. TOD de mise en attente

16.4.1.5. TCP NTF SSL EXITS


DTCP01I:TCP/IP SUMMARY (NUC=00262520, TCA=0029BC30, DSA=002A7018, WCS=00000000) ; Addr bloc TCP, Blocs LE/370 DTOD03I:TOD=14:19:59:080285. TOD de dernier dispatch DTCP02I:SAVE=002A7018, NAME= EDCZMINV ,DATE=199809231700. DTCP02I:SAVE=002A70C0, NAME= main ,DATE=200010251227. DTCP02I:SAVE=002A71D8, NAME= ecoute ,DATE=200010251226. DTCP02I:SAVE=002A7290, NAME= exasoc ,DATE=200010251226. DTCP02I:SAVE=002A7340, NAME= selectex ,DATE=199901281718. DTCP02I:SAVE=002A7448, NAME=hpns_common_select ,DATE=199901281718. Liste des modules avec nom, date et heure AAAAMMJJHHMM de compilation DTCP03I:Host=172.17.6.2,P=1761, Ws=0,Rs=0, Wr=34235,Rd=247. DTOD03I:TOD=14:20:15:607661. DTCP03I:Host=172.17.6.2,P=5034, Ws=0,Rs=0, Wr=247,Rd=34235. DTOD03I:TOD=14:20:15:606025. Pour chaque socket ouvert : Addr host, port , Nombre doctets restant a ecrire/lire pour terminer un message, Nombre des octets crits/lus, Tod de derniere action.

16-6

CFT V2.3

CFT/MVS Guide d'exploitation

16.4.1.6. APF
CFAU02I:JOB "CFTR223 " USERID "CFTR223 " IS APF-AUTH. Jobname, Userid RACF, Indication APF ON/OFF CARM01I:Automatic restart for CFTR223 (STC05479) started, Element="XIDPARM Si APF ON, Nom de llment ARM utilis si enregistr.

16.4.1.7. MODULES
DMOD01I:EPA=001972D0, ID: IBM3OPE4 300500 A220237. Pour un sous-programme en assembleur, Nom, Date JJMMAA et rvision. DMOD01I:EPA=001478A8, ID: ANSADT(ANSAPI) 15NOV00-150299. Pour un module C/SAS fonction(source) date de compilation, date de modification DMOD01I:EPA=077CD0A0, ID: wrttcp 0010251227470201 Pour un module C/IBM, nom de fonction AAMMJJHHMMSSVVRR de compilation Un mme module peut tre charg plusieurs fois ou compil de diffrentes faons. La rponse est affiche uniquement dans le fichier SGTRACE.

16.4.1.8. MEM
==> Real space used by CFT 0116BEA0 freed on pages 0003A160 allocated below 002B6000 freed below 0000C7A0 La mise en forme se trouve dans le fichier SGTRACE, sous une forme identique un dump MVS (Appel au mme service MVS).

16.5. Commande PATCH


La commande PATCH permet de modifier la mmoire dans un espace adresse de CFT. Elle ne doit tre utilise que sur les instructions du support CFT. Format : PATCH VIRT-ADDR OLD-DATA NEW-DATA Modifie dans la rgion de CFT 4 octets ladresse hexadcimale "VIRT-ADDR", qui sont compars en hexadcimal "OLD-DATA" et remplacs par "NEW-DATA" si vrai. Cette commande permet de modifier les donnes ou le code rentrant de CFT.

CFT V2.3

16-7

Commandes de linterface oprateur de CFT sous OS/390

16.6. Commandes du serveur de communications CROSS-MEMORY


16.6.1. Commande DUMP
La commande DUMP liste le contenu des zones mmoire par SNAP sur le fichier SGTRACE : format : DUMP H=mbx/ALL : dump du prfixe de la file dattente mbx ou de toutes, DUMP Q=mbx/ALL : dump du contenu de la file dattente mbx ou de toutes,

rponse : CFTXM01W:DUMP MAILBOX ACCEPTED.

16.6.2. Commande DELETE


La commande DELETE supprime une file dattente : format :
-

DELETE Q=mbx/ALL : supprime la file dattente mbx ou toutes, et libre la place rserve dans le DIV,

rponse : CFTXM05W:TARGET DELETED.

16.6.3. Commande DELREQ


La commande DELREQ supprime les messages en attente dans une file : format : DELETE Q=mbx/ALL : supprime les messages de la file dattente mbx ou de toutes les files dattente, rponse : CFTXM05W:TARGET DELETED.

16.6.4. Commande QRYOPN


La commande QRYOPN liste ltat de la file dattente : format : QRYOPN Q=mbx/ALL : liste ltat de la file dattente mbx ou de toutes les files dattente, rponse : CFTXM20W:MAILBOX mbx HAS nnn/NO WAITING MESSAGE(S).

16-8

CFT V2.3

CFT/MVS Guide d'exploitation

16.6.5. Commande OPEN


La commande OPEN ouvre une file dattente : format : OPEN Q=mbx : ouvre la file dattente mbx, CFTXM10W:MAILBOX OPENED, CFTXM09E:MAILBOX UNKNOW. rponse :

16.6.6. Commande CLOSE


La commande CLOSE ferme une file dattente : format : OPEN Q=mbx/ALL : ferme la file dattente mbx ou toutes les files dattente, rponse : CFTXM10W:MAILBOX CLOSED.

16.6.7. Commande SGTRACE


La commande SGTRACE prsente les caractristiques suivantes : format et options sont identiques au chapitre prcdent, rponse : CFTXM15W:TRACE OPTION SETTING.

CFT V2.3

16-9

17. Utilisation de CFT/MVS avec le logiciel de scurit RACF

17.1. Prsentation
Ce chapitre fournit les donnes utiles la mise en uvre du logiciel RACF, permettant de contrler les oprations de manipulation des fichiers. CFT/MVS version 2.2 et suivantes utilise linterface de scurit SAF. Il est donc compatible avec les logiciels de scurit utilisant cette interface, en particulier RACF.

17.2. Contrle des oprations de manipulation des fichiers


Par dfaut, CFT/MVS effectue les oprations de manipulation des fichiers sous sa propre autorit. CFT/MVS vrifie systmatiquement les droits daccs aux fichiers, pour lui-mme ou pour le compte des utilisateurs. Toute tentative infructueuse se traduit par un code erreur ayant la valeur 91300038 ou 80000913. Il est possible dactiver un contrle plus labor dans les cas suivants : demander la soumission dune procdure de fin dmission sous lautorit du demandeur du transfert, demander la soumission dune procdure de fin de rception sous lautorit du receveur du transfert, demander louverture dun fichier mettre sous lautorit du demandeur du transfert, demander louverture dun fichier recevoir sous lautorit du receveur du transfert.

17.3. Activation du contrle des autorisations RACF


Lappel aux services SAF (RACF ou quivalent) est systmatique. Lutilisation labore des fonctions RACF est possible quand les conditions suivantes sont satisfaites : CFT Version 2 est un programme autoris, loption correspondante est active dans les options dinstallation SGINSTAL, le paramtre CFTPARM USERCTRL=YES est prcis.

CFT V2.3

17-1

Utilisation de CFT/MVS avec le logiciel de scurit RACF

17.4. RACF et les interfaces cran CFT/MVS


RACF est requis dans le cas o les interfaces cran seraient appeles sous VTAM afin de vrifier les PASSWORD. Dans 2 cas, linterface ne peut vrifier les mots de passe : il nest pas autoris, SAF nest pas disponible. Lutilisateur peut se connecter en donnant une valeur quelconque dans le champ PASSWORD. Il disposera alors des privilges du JOB sur lequel il est connect.

17.4.1. RACF et linterface Internet


RACF est requis dans le cas o linterface Internet serait utilise afin de vrifier les PASSWORD. Dans deux cas, linterface ne peut vrifier les mots de passe : il nest pas autoris, SAF nest pas disponible. Lutilisateur peut se connecter en donnant une valeur quelconque dans le champ PASSWORD. Il disposera alors des privilges du JOB sur lequel il est connect.

17.4.2. RACF et linterface utilisateur JAVA


Linterface JAVA se connecte au serveur CFTIUI, et sidentifie USERID/PASSWORD, y compris depuis OPEN/MVS. Dans 2 cas, linterface ne peut vrifier les mots de passe : il nest pas autoris, SAF nest pas disponible. Lutilisateur peut se connecter en donnant une valeur quelconque dans le champ PASSWORD. Il disposera alors des privilges du JOB sur lequel il est connect.

17-2

CFT V2.3

18. Performances du moniteur de transfert CFT/MVS

18.1. Utilisation de la mmoire


18.1.1. Par le moniteur de transfert de fichiers
La mmoire adresse en 24 bits est utilise de la manire suivante : environ 14000 K sont utiliss par les programmes et les zones mmoire, chaque tche de transfert demande 8K supplmentaires, La taille mmoire adresse en 31 bits est utilise de la manire suivante : environ 16000 K sont utiliss par les programmes et les zones mmoire, chaque tche de transfert demande 500 K supplmentaires, chaque fichier BSAM ouvert utilise 2 buffers de taille BLKSIZE, chaque transfert en rception utilise (CFTPROT PACING*CHKW) buffers de rception. Lutilisation de valeurs leves associes un grand nombre de transferts simultans peut se traduire par des ABENDS878 de CFT/MVS, chaque transfert en rseau TCP/IP utilise 2 buffers de 64 K, le module CFTSSL ncessite 8000 K supplmentaires, le module XFB/SCOPE ncessite 2000 K supplmentaires [XFB/CFT 2.3.0], limplmentation de Sentinel for XFB [XFB/CFT 2.3.1] ncessite daugmenter la taille de la rgion dexcution, en fonction des options du fichier de configuration ainsi que du nombre de messages. CFT/MVS diffre la cration de transferts supplmentaires quand : il ne dispose pas de 64K de mmoire en 24 bits, message CFTA02E, ou il ne dispose pas de 1 megaoctet de mmoire en 31 bits, message CFTA01E. Le moniteur CFT/MVS diffre les nouveaux transferts quand il ne dispose plus de 64K libres en 24bits, et de 1024K en 31 bits.

18.1.2. Par le moniteur des interfaces interactives sous VTAM


La mmoire adresse en 24 bits est utilise de la manire suivante : environ 4000 K sont utiliss par les programmes et les zones mmoire, chaque utilisateur connect demande 8 K supplmentaires, La taille mmoire adresse en 31 bits est utilise de la manire suivante : chaque utilisateur connect demande 500 K supplmentaires.

CFT V2.3

18-1

Performances du moniteur de transfert CFT/MVS

18.2. Utilisation des entres/sorties disque


Des entres/sorties disques sont faites dans les cas suivants : chaque bloc BSAM lu ou crit, un bloc BSAM est crit chaque point de synchronisation, et un TCLOSE est mis sur le fichier en criture, chaque enregistrement catalogue est crit tous les UPDAT points de synchronisation, valeur du paramtre CFTCAT, le premier enregistrement de chaque fichier CFTCOM est lu tous les WSCAN secondes, valeur du paramtre de CFTCOM, la gestion des entres/sorties sur les fichiers HFS est effectue sous le contrle de lespace adresse OMVS.

18.2.1. Utilisation dun hyperspace MVS/ESA


Sous OS/390, le moniteur CFT conserve une copie du CATALOGUE CFT dans un hyperspace de MVS : dans ce cas, le moniteur CFT ne relit pas les enregistrements, par contre, le moniteur CFT utilise alors CFTCAT RECNB pages en mmoire darrire plan ou en mmoire auxiliaire de MVS.

18.2.2. Libration de lespace disque inutilis dans les fichiers reus


Sous OS/390, le moniteur CFT libre lespace disque inutilis sur les fichiers reus si les conditions suivantes sont satisfaites : le moniteur CFT est un programme autoris, le moniteur CFT renomme le fichier reu la fin du transfert (CFTRECV WFNAME=dsn1, FNAME=dsn2), le fichier est sur un seul volume.

18.3. Utilisation de lunit centrale


La fonction de compression/dcompression des donnes est consommatrice de temps CPU. Lactivation dune option de SGTRACE est grande consommatrice de temps CPU. Le moniteur CFT est multitches. Il peut utiliser plusieurs processeurs simultanment. CFT/MVS accepte des valeurs de CFTPROT xRUSIZE infrieures ou gales 65000 octets. Une valeur de RUSIZE leve rduit significativement la charge CPU : par exemple de 30% en passant de 4 K 16 K. Lutilisation du chiffrement se traduit par une multiplication de la consommation CPU pouvant atteindre un facteur 4, selon les algorithmes utiliss.

18-2

CFT V2.3

CFT/MVS Guide d'exploitation

18.4. Utilisation de la compression DF/SMS


CFT/MVS est compatible avec la compression des fichiers gre par DF/SMS. En lecture, CFT/MVS recalcule la taille du fichier non compress partir des informations de DF/SMS. En cration, CFT/MVS demande lespace ncessaire lcriture du fichier non compress. Si possible, il libre ensuite lespace inutilis en fin de transfert.

18.5. Utilisation de CFT/MVS en environnement SYSPLEX


CFT/MVS est conu pour une utilisation en environnement SYSPLEX.

18.5.1. Utilitaires et applications de CFT en SYSPLEX


Les utilitaires de CFT et le moniteur peuvent partager tous les fichiers en lecture. Les fichiers de commandes CFTCOM et les bases de donnes VFM sont partags en lecture/criture. Les applications dposant des demandes de transfert par le fichier de commandes, interrogeant le catalogue de CFT ou mettant jour les bases VFM, peuvent sexcuter sur dautres machines. Ceci est vrai galement pour linterface utilisateur TSO ou VTAM, linterface utilisateur Internet, lagent dadministration XFB.Scope.

18.5.2. Moniteur CFT en SYSPLEX et rseaux SNA


Le moniteur CFT en SYSPLEX ne peut sexcuter que sur la machine contenant les dfinitions des ressources rseau utilises SNA et LU 6.2. Remarque : en rseau APPN, il est possible de passer des commandes VARY INACT/ACT pour lensemble des dfinitions rseau de CFT.

18.5.3. Moniteur CFT en SYSPLEX et rseau TCP/IP


A partir de OS/390 V2R7, il existe une facilit permettant denregistrer une application telle que CFT, dans le serveur de noms DNS, par appel un service de WORKLOAD MANAGER. CFT est compatible avec cette facilit. Le dispositif VIPA offre galement un service de reconfiguration dynamique du rseau. Des informations sur ce service se trouvent dans les brochures IBM suivantes : OS/390 eNetwork Communications Server, SC31-8513, TCP/IP in a SYSPLEX, SG24-5235.

CFT V2.3

18-3

Performances du moniteur de transfert CFT/MVS

18.6. Utilisation des services Automatic Restart Manager


Les programmes autoriss de CFT/MVS sabonnent au service Automatic Restart Manager de OS/390. Ces programmes seront donc automatiquement relancs en fonctions des rgles dfinies dans le composant ARM. Les noms dlments utiliss sont de la forme : CFTMAIN : Xidparm ou idparm est le nom du parm pass CFT, CFTXMEM : Xcftpcmbx ou cftpcmbx est le nom du service MAILBOX, CFTIUI CFTINTV : Xnom ou nom est un paramtre, : Xparm ou parm est le 3me paramtre facultatif reu.

Le nom de llment est modifiable de la manire suivante : 1. Ajouter une carte DD dont le DDNAME sera CFTARMID. 2. Fournir 1 enregistrement unique dont les 16 premiers octets seront utiliss comme substitution Xidparm . Le RESTART est diffr pendant une minute pour tenir compte de la rmanence des sessions rseau TCP/IP. En option, le nom dlment peut tre spcifi par lutilisateur en ajoutant la procdure un fichier dont le DDNAME est CFTARMID, et dont les 16 premiers octets du premier enregistrement seront utiliss comme nom dlment ARM.

18.7. Fichiers de diagnostics de LE/370


Certains modules de CFT/MVS utilisent des fichiers de diagnostics grs par LE/370. Il sagit de : CEEDUMP TCPOUT TCPPRINT SSLOUT SSLPPRINT NTFOUT NTFPPRINT PKUOUT : fichier de DUMP format par LE/370, : fichiers des messages du module CFTTCP, : fichiers des erreurs du module CFTTCP, : fichiers des messages du module CFTTSSL, : fichiers des erreurs du module CFTTSSL, : fichiers des messages du module XFB/SCOPE, : fichiers des erreurs du module XFB/SCOPE, : fichiers des messages du module CFTPKI.

18-4

CFT V2.3

CFT/MVS Guide d'exploitation

18.8. Paramtrage des rseaux X25


18.8.1. Paramtres du NCP pour utiliser GATE
Les paramtres suivants sont requis dans le NCP, au niveau X25.MCH : Exemple de paramtrage du NCP pour X25-GATE : X25.MCH ADDRESS= LUNAME=Luname, Nom de la LU MULTIVOIE pour GATE LLCLIST=( ,LLC4, ), GATE LLC4=4, GATE * * * *

18.8.2. Complments dinformation propos des rseaux X25


Un rseau X25 gr en GATE est dcrit dans CFT/MVS par les commandes : CFTNET TYPE = X25 et CFTX25 Une premire forme de paramtrage du noeud commut VTAM est alors utilise. Un rseau X25 gr en mode PCNE est dcrit dans CFT/MVS par les commandes : CFTNET TYPE = SNA et CFTSNA Une seconde forme de paramtrage du noeud commut VTAM est alors utilise. Lutilisation simultane de PCNE et de GATE est possible sur une ligne X25. Il est alors ncessaire de se reporter la documentation IBM X25-NPSI qui prsente les diffrentes combinaisons possibles de paramtres NCP.

18.8.2.1. Utilisation de la sous-adresse dans le numro dappel X25


La sous-adresse est utilisable si NPSI est paramtr avec : SUBADDR = YES Dans ce cas, le caractre de DROITE de la sous-adresse est le service LLCn de NPSI : et n = 0 -> PCNE n = 4 -> GATE

18.8.2.2. Rception dun appel entrant en PCNE


Il existe deux possibilits : le premier message est associ un APPLID SNA par une INTERPRET TABLE de VTAM, lAPPLID SNA est forc par un LOGAPPL = de VTAM.

CFT V2.3

18-5

Performances du moniteur de transfert CFT/MVS

18.8.2.3. Utilisation des USER DATA


Il sagit de tous les caractres alphanumriques du SAP : rception dun appel entrant en GATE : si NPSI contient SUBADDR = YES, alors DIALNO doit se terminer par 4 et la valeur du SAP est compare (y compris le 4), sinon, le caractre de GAUCHE des USER DATA est le service LLCn de NPSI (exemple : C4 -> GATE) et la valeur du SAP est compare (y compris le premier caractre ayant servi dterminer le service LLC).

18.9. Fichiers de format fixe standard et variable SPANNED


Les fichiers de format fixe standard et variable spanned, sont transfrables en respectant leurs caractristiques spcifiques. Ce mode de transfert est sujet des restrictions.

18.9.1. Fichiers de format fixe standard


Les fichiers de format fixe standard sont transfrs comme des fichiers de format fixe. Il peuvent donc tre changs entre tous les moniteurs XFB. Le format fixe standard et le respect ventuel des codes saut ASA ou MACHINE, sont assurs uniquement entre 2 moniteurs CFT/MVS intgrant ce support (noyau 2.3.0 et modification A230017). Les moniteurs CFT/MVS de niveau antrieur reoivent des fichiers fixes standards, en format fixe, aprs installation dune mise niveau de compatibilit : A230018.

18.9.2. Fichiers de format variable SPANNED


Les fichiers de format variable spanned sont transfrs en mode image de blocs physiques, exclusivement entre 2 moniteurs CFT/MVS disposant de ce support : noyau 2.3.0 et modification A230017. Les fichiers rsultat de lutilitaire IEBCOPY gnrs et transfrs par CFT/MVS, restent interchangeables entre toutes les versions des moniteurs CFT/MVS.

18.10. Appel aux utilitaires Z/OS depuis CFT/MVS


La fonction dappel aux utilitaires Z/OS permet le transfert de fichiers non directement lisibles par CFT/MVS. Les utilitaires IEBCOPY et ADRDSSU (nouveau) sont supports. Lutilisateur de CFT Version 2.3.0 et suivantes trouvera, dans les paragraphes suivants, les spcificits de ce mode opratoire.

18-6

CFT V2.3

CFT/MVS Guide d'exploitation

18.10.1. Rgles communes dappel aux utilitaires


Les utilitaires sont appels pour : transformer les donnes mettre en un fichier squentiel intermdiaire. La transformation se fait au moment de la slection du fichier, avant louverture de la session rseau, transformer le fichier reu dans un format identique au(x) fichier(s) mis. Cette transformation se fait ds la rception de la fin du transfert, la session rseau reste ouverte et lmetteur reoit une indication de bonne fin ou dchec. Les rgles suivantes sont respecter : le moniteur CFT/MVS doit tre un programme autoris (APF), le transfert est possible uniquement entre 2 CFT/MVS, une commutation par un site intermdiaire CFT quelconque est permise.

18.10.2. Codage des commandes CFTSEND ou SEND


Les paramtres suivants sont ncessaires : le caractre # est ncessaire en tte de FNAME (Code hexadcimal 7B), WFNAME indique le nom du fichier intermdiaire qui sera crit par lutilitaire, puis transfr par CFT/MVS, NSPACE indique la taille du fichier intermdiaire. Ce paramtre est ncessaire si la valeur de FNAME se traduit par une slection de fichiers ou de membres, FACTION=DELETE nest pas support (ignor), FTYPE=1 commande le choix de lutilitaire ADRDSSU, associ un ou plusieurs caractres _ a la fin de FNAME.

18.10.3. Codage des commandes CFTRECV ou RECV


Les paramtres suivants sont ncessaires : WFNAME indique le nom du fichier intermdiaire qui sera reu par CFT/MVS, puis relu par lutilitaire, FACTION nest pas support (ignor), MACTION=REPLACE commande le remplacement des membres ou des fichiers.

18.10.4. Appel IEBCOPY


Lappel a IEBCOPY permet le transfert de la totalit ou dune slection de membres dun fichier PDS. Lutilisation est obligatoire dans le cas de LOAD MODULES.

CFT V2.3

18-7

Performances du moniteur de transfert CFT/MVS

Exemples : mission dune bibliothque complte : SEND .. FNAME=#MY.LOAD.LIBRARY, WFNAME=TEMP.FILE.&PART.&IDT

Et le CFTRECV : CFTRECV FNAME=A.LOAD.LIBRARY, WFNAME=TEMP.FILE.&PART.&IDT, MACTION = REPLACE mission partielle dune bibliothque : SEND .. FNAME=#MY.LOAD.LIBRARY(TEST*)

Le PDS reu sera cre sil nexiste pas avec les caractristiques suivantes : SPACE identique au fichier initial, nombre de blocs de DIRECTORY = BLKPDS, 150 par dfaut. Restrictions : le transfert de/vers des fichiers PDSE nest pas support, les utilitaires compatibles IEBCOPY ne sont pas supports.

18.10.5. Appel ADRDSSU


ADRDSSU permet le transfert de 1 ou plusieurs fichiers. Le transfert dun ensemble de fichiers est permis avec le caractre joker _. Il est recommand dutiliser cet utilitaire pour tous les fichiers autres que les fichiers squentiels : VSAM, PDSE (en rception), HFS. Un sous-ensemble des paramtres de ADRDSSU est utilis. Il est not en exemple.

18.10.5.1. Codage du FNAME du CFTSEND ou SEND


Le format gnral du CFTSEND sera : CFTSEND Avec : VOLSER : paramtre facultatif pouvant contenir un nom de volume, DSNGEN : paramtre facultatif : si celui-ci est prsent, il doit se terminer par _ , si DSNGEN est omis, alors VOLSER est obligatoire et la totalit des fichiers du volume VOLSER seront transfrs (Sauf SYS1.VVDS et VTOC INDEX), FTYPE=1, WFNAME=TEMP.FILE.&PART.&IDT, FNAME = #VOLSERt%%DSNGEN_

18-8

CFT V2.3

CFT/MVS Guide d'exploitation

DSNGEN est un nom de fichier termin par _ ; seul ce fichier (catalogu ou non) sera transfr, DSNGEN contient plusieurs _ ; dans ce cas, il sagit dun modle qui sera interprt selon les rgles suivantes :
Tableau 17. Rgles dinterprtation du DSNGEN Modle DSNGEN_ DSNGEN__ DSNGEN._ DSNGEN_._ DSNGEN_.__ Interprtation DSN DSN* DSN.* DSN*.* DSN*.**

Exemples Emission de 1 fichier : SEND ..FTYPE=1, FNAME=#A.VSAM.FILE_ La commande ADRDSSU gnre aura le format : DUMP DATASET ( INCLUDE ( A.VSAM.FILE ) COMPRESS ALLDATA(*) TOLERATE(ENQFAILURE) SPHERE Emission de n fichiers : SEND ..FTYPE=1, FNAME=#CFTV2.NEW.VERSION.__ , NSPACE=150000 Emission de n fichiers de 1 volume : SEND ..FTYPE=1, FNAME=#VOLSER%%CFTV2.NEW.__, NSPACE=1000000 La commande ADRDSSU utilisera galement les paramtres : EXCLUDE ( SYS1.VVDS.V* , SYS1.VTOCIX.* ) LOGINDYNAM ( VOLSER) SELECTMULTI ( ANY ) Remarques : la totalit de lespace allou est copi (paramtre ALLDATA), les CLUSTERS VSAM sont copis avec les index alterns (paramtre SPHERE), les fichiers multivolumes sont copis en totalit (paramtre SELECTMULTI). Restrictions : ADRDSSU ne prends pas en compte les fichiers migrs HSM, les fichiers PAGE DATASET et les catalogues VSAM ne sont pas supports.

CFT V2.3

18-9

Performances du moniteur de transfert CFT/MVS

18.10.5.2. Codage du CFTRECV ou RECV


Le format gnral sera : CFTRECV Avec : VOLSER : paramtre facultatif pouvant contenir le nom du volume recevant les fichiers, FNAME = #VOLSERt%%QUALIF1 WFNAME=TEMP.FILE.&PART.&IDT

QUALIF1 : paramtre facultatif permettant de changer le premier QUALIFIER du fichier. Exemples Rception de fichiers sous leur nom initial : CFTRECV FNAME= %% La commande ADRDSSU gnre aura le format : RESTAURE DATASET ( INCLUDE ( ** ) CATALOG SPHERE Rception de fichiers sur 1 VOLUME, sous leur nom initial : CFTRECV FNAME=VOLSER%% La commande ADRDSSU utilisera galement le paramtre : OUTDYNAM ( VOLSER ) Remplacement des fichiers reus : CFTRECV MACTION = REPLACE, FNAME=%% La commande ADRDSSU utilisera galement le paramtre : REPLACE RENAME des fichiers reus, changement du premier qualifier : CFTRECV FNAME=%%NEWNAME La commande ADRDSSU utilisera galement le paramtre : RENAMEUNC ( NEWNAME ) La combinaison RENAME+REPLACE peut provoquer une erreur ADRDSSU si le(s) fichier(s) rsultat existait dj. Remarques : les fichiers sont recrs lidentique du fichier initial, CFT/MVS force le RECALL HSM des fichiers migrs restaurer.

18-10

CFT V2.3

CFT/MVS Guide d'exploitation

18.10.6. Messages complmentaires


Si le traitement par lutilitaire externe est correct, CFT/MVS affiche 2 messages CFTF30W dont le texte sera : le code retour de lutilitaire, un texte complmentaire. Dans le cas de IEBCOPY, un fichier de compte rendu est cre. Il contient pour chaque membre un enregistrement DSNAME(MEMBER) . Ce fichier temporaire MVS nest pas catalogu, son nom est stock dans le catalogue CFT, rubrique SELFNAME. Par exemple : VOLSER%%SYS03132.T164138.RA000.CFT.R0200169 Ce fichier est automatiquement supprim par CFT la suppression du poste catalogue.

18.10.7. Messages derreurs


Dans le cas ou une erreur se produit, un message affiche : soit le code ABEND de lutilitaire, soit le premier message derreur de lutilitaire. De plus, la plupart des messages derreur sont envoys sur la SYSLOG MVS. La liste de tous les fichiers non restaurs par ADRDSSU est affiche dans la SYSLOG MVS, dans le message : CDSS04E:Failed to Restore=DSNAME Se reporter la documentation IBM de rfrence pour lexplication des paramtres et des messages IEBCOPY et ADRDSSU. Loption de mise au point SGTRACE 12 permet dobtenir une trace dtaille dans le fichier SGTRACE.

18.10.8. Performances des utilitaires


CFT/MVS appelle un seul utilitaire externe la fois. Lutilisation de la mmoire est la suivante :
Tableau 18. Performances des utilitaires : utilisation de la mmoire Utilitaire IEBCOPY ADRDSSU Mmoire 24 bits 1024K 2048K Mmoire 31 bits 0 8192K

Le paramtre CFTPROT RTO=secondes doit indiquer une valeur en secondes suffisante pour permettre le droulement complet de lutilitaire cot rcepteur. ADRDSSU et RACF : le paramtre TOLERATE (ENQFAILURE) ncessite laccs READ la classe FACILITY, ressource STGADMIN.ADR.DUMP.TOLERATE.ENQF ct metteur.

CFT V2.3

18-11

19. Codes erreurs fichiers CFT/MVS

19.1. Prsentation
Les codes erreurs fichiers apparaissent sous la mme forme : dans les messages CFT, dans le champ DIAGP du catalogue CFT.

19.2. Format du champ DIAGP


Le format gnral des codes erreur fichier est le suivant : SFRRNNNN, avec : S : le code environnement.
Tableau 19. Code environnement Code S=0 S=4 S=7 S=9 S=C S=F Dfinition Erreur rendue par MVS/DFP Erreur de lecture/criture Abend de lecture/criture Erreur retourne par DYNALLOC Erreur de lecture/criture VSAM Erreur de paramtres de traitement du fichier

F : le code fonction F indique le traitement demand sur le fichier. Les valeurs du code fonction F sont :
Tableau 20. Code fonction F Code Dfinition

F=0 Cration de fichier F=1 Suppression de fichier F=2 Interrogation des caractristiques du fichier F=3 Rename dun fichier F=4 Alloue un fichier par DSNAME F=5 Dsalloue le fichier F=6 Alloue par DDNAME F=7 Submit dune procdure CFT vers INTERNAL READER Dautres valeurs sont ensuite dtailles

CFT V2.3

19-1

Codes erreurs fichiers CFT/MVS

RR : le code RR dsigne la fonction MVS demande :


Tableau 21. Code RR Code Dfinition

RR = F0 Appel CAMLST LOCATE RR = F1 Appel CAMLST SCRATCH RR = F2 Appel CAMLST RENAME RR = F3 Appel CAMLST OBTAIN / SHOWCB si VSAM RR = F4 Appel la fonction RACROUTE RR = F5 Appel la fonction SFMWTM RR = F6 Appel dynamique IDCAMS RR = DC Appel dynamique IDCAMS, message IDC 3nnn en retour Dautres valeurs sont ensuite dtailles

NNNN : le code information compltant le code retour. NNNN est le code retour de MVS ou OPEN VSAM ou lun des codes suivants : pour RR=DC, NNNN est le numro du message IDCnnnn de IDCAMS ou ADRnnnE de ADRDSSU.

Exemple : 00DC32O3 correspond au message IDC32O3I ITEM DOES NOT ADHERE TO RESTRICTIONS. 00AD392E correspond au message ADR392E dsn exits on volser with newname .

19.2.1. Table des codes erreur fichier NNNN


Codes particuliers : 00F000B37 0x0y00E37

: pas de place dans un File-System HFS, : le volume x parmi y ne permet pas la cration du fichier multivolumes,

91300038 ou 80000913 : lopration de lecture/criture demande par un utilisateur sur le fichier nest pas permise par RACF.

19.2.1.1. Table des codes NNNN pour S=0


Tableau 22. Table des codes NNNN pour S=0 Code 0005 0017 0019 001A 001B 001C 001E 0028 Dfinition Pas de carte DD Fichier multivolumes non support Diffrence de VOLUME avec le catalogue Erreur de DSNAME ou accs via un alias UCB non trouv ou gnr en DRM Fichier non trouv dans VTOC Fichiers concatns non supports Fichier non trouv au catalogue

19-2

CFT V2.3

CFT/MVS Guide d'exploitation Tableau 22. Table des codes NNNN pour S=0 (suite) Code 0030 0040 0048 005O 03DE 03DF 03E0 03E1 03E2 03E3 03E4 03E5 03E6 03E7 0051 0052 0053 0054 0055 0056 0057 0058 0059 005A 005F Dfinition Fichier non trouv au catalogue DSNAME manquant Racine de fichier en GDG sans numro de version DSNAME non conforme aux rgles MVS Fichier non supprim/renomm, membre de PDS Fichier non supprim/renomm, ENQ OLD impossible Fichier partag non disponible, allou par une autre tche Allocation dun fichier PDS sans nom de membre Allocation dun GDG sans BLDG Allocation dun GDG en version +1 Fichier non supprim/renomm, nexiste pas Fichier non cr, existe dj Fichier non supprim/renomm, sur bande Cration dun fichier avec un nom logique (DDNAME) RENAME, GDG(+1) est obligatoire RENAME, fichier temporaire ne peut tre GDG RENAME, erreur de CAMLST RENAME RENAME, erreur de CAMLST CATALOG RENAME, fichier temporaire ne peut tre GDG(+1) RENAME, fichier en double sur 1 volume SCRATCH, fichier non trouv SCRATCH, erreur CAMLST SCRATCH SCRATCH, volume non mont SCRATCH, erreur CAMLST UNCAT hors SMS RENAME, membre de fichier PDS

Exemples : 04F003E0 : allocation par DSNAME, le fichier est dj allou un autre transfert par CFT. 04F00028 : allocation par DSNAME, fichier non trouv au catalogue.

19.2.1.2. Table des codes NNNN pour S=4 (erreur de lecture/criture)


F et RR sont sans signification. NNNN prend les valeurs indiques dans le tableau suivant.
Tableau 23. Table des codes NNNN pour S=4 Code 00D4 00D7 00E4 00E7 00EC Dfinition OPEN, LRECL/BLKSIZE incorrect OPEN, pas de dlimiteur de paramtre OPEN, DDNAME incorrect OPEN, manque DDNAME OPEN, plus de mmoire pour les buffers

CFT V2.3

19-3

Codes erreurs fichiers CFT/MVS Tableau 23. Table des codes NNNN pour S=4 (suite) Code 00F0 00F4 00F8 00FC 00FD 0FFF Dfinition OPEN, il manque des paramtres Rfrence FCB incorrecte Code fonction SGF erron Code fonction non autoris OPEN, code retour non 0 BSAM, erreur lecture/criture/POINT

Cette erreur est accompagne de messages CFT et/ou MVS selon le cas : message CFT POINT ERROR dans le cas de repositionnement sur un fichier qui ne le supporte pas, message CFT SYNA01E: accompagn du texte du message SYNADAF de MVS. Ce message apparat uniquement la console MVS, message MVS IEA000 ou IECxxx. Ces messages apparaissent uniquement la console MVS.

19.2.1.3. Table des codes NNNN pour S=8 (ABEND durant une lecture/criture)
F et RR sont sans signification. NNNN contient le code ABEND intercept par CFT. Exemples : 0B37, 0013. Exemple : 80000913 : AbendS913 louverture du fichier, CFT/MVS na pas le droit de lire/crire.

19.2.1.4. Table des codes NNNN pour S=C (erreur de lecture/criture VSAM)
F na pas de signification. RR est le RETURN-CODE VSAM. NNNN est le FDBK VSAM. Lexplication des codes RTNCD/FDBK de VSAM est indique dans la documentation VSAM. Exemple : C004001C : plus de place dans le fichier.

19.2.1.5. Table des codes NNNN pour S=F (erreur de paramtres fichiers)
RR et NNNN sont sans signification.
Tableau 24. Table des codes NNNN pour S=F Code F=4 F=8 F=C Dfinition Fonction non permise Fonction inconnue Rfrence fichier incorrecte

19-4

CFT V2.3

CFT/MVS Guide d'exploitation

Ces codes sont soumettre au Support Client CFT.

19.2.1.6. Codes erreur DYNALLOC S=9


Les erreurs DYNALLOC sont expliques dans la brochure IBM IBM SPL system macros & facilities. La valeur de F pour la fonction DYNALLOC est indique dans le tableau suivant :
Tableau 25. Valeur de F pour la fonction DYNALLOC Code F=1 F=2 Dfinition Allocation Dsallocation

Valeur de RR pour DYNALLOC : RR est le code retour de DYNALLOC. Il peut prendre les valeurs 04, 08, 0C. Valeur de NNNN pour DYNALLOC : NNNN est le REASON CODE de DYNALLOC. Exemple de code erreur DYNALLOC : erreur 9104970C : plus de place pour crer le fichier. Les messages derreur IKJnnnnnI , IGDnnnnnI (sous SMS) rendus par DYNALLOC sont affichs la console MVS : IKJ56893I DATA SET NOT ALLOCATED+ IGD17273I ALLOCATION HAS FAILED FOR ALL VOLUMES SELECTED FOR DATA SET A noter : la valeur hexadcimale nnnn convertie en dcimal donne le numro du message derreur SMS IGD, par exemple X4379 correspond au message IGD17273I.

19.3. Diagnostics complmentaires pour les erreurs fichiers


Les diagnostics supplmentaires suivants sont disponibles la demande du support CFT, laide de loutil SGTRACE : SGTRACE 4 : trace des actions dallocation/libration des fichiers. Cette valeur est utiliser pour les codes S=0 et S=9, SGTRACE 8 : trace des actions de lecture/criture des fichiers. Cette valeur est utiliser pour les codes S=4,8,C,F, SGTRACE 2 : trace des erreurs, SGTRACE 128 : trace des appels et des retours de modules. Les modules concerns sont : -

S =0 : SGF3ACC, SGF3STAT, SIFM, SGF3VSAM, SGF3REN, S =9 : SGF3SV99, S =4,8,C,F : SGF3C, SIDM.

CFT V2.3

19-5

20. Messages des interfaces systmes de CFT/MVS

20.1. Prsentation
Les interfaces systme de CFT version 2.3.0 et suivantes produisent des messages oprateur MVS affichs sur la console systme. Ces messages apparaissent dans les cas suivants : une erreur grave est dtecte par une fonction systme, ou la trace SGTRACE correspondante est active.

20.2. Dfinition
Les messages ont le format suivant : 4 lettres correspondant linterface systme, 2 chiffres pour numroter les messages, 1 lettre de classification, le caractre : accol permet de reconnatre les messages des interfaces systme, le texte du message. Les messages sont indiqus dans le tableau suivant.
Tableau 26. Messages des interfaces systme de CFT/MVS Message CFINnnI :texte CFVTnnL:texte SGEXnnL:texte SGABnnL:texte Dfinition Messages dinformation de linterface CFTINT sous VTAM Message dinformation de linterface rseau SNA apparat uniquement avec SGTRACE 1 Message dinformation du gestionnaire de tches, apparat uniquement avec SGTRACE 2 Message conscutif un ABEND de CFT/V2 Le texte de ces messages est galement enregistr dans le fichier de diagnostics de CFT/V2 Message conscutif une erreur rseau X25 Le texte est retourn par la MACRO SYNADAF la suite dune erreur dentre sortie

CFXPnnL:texte SYNA01E:texte

CFT V2.3

20-1

21. Codes erreurs rseau

21.1. Rseau X25


21.1.1. Prsentation
Les codes erreurs rseau X25 ont le format suivant : L/R NN PPP. Le premier caractre L dsigne une erreur locale, R une erreur rseau.

21.1.2. Erreur locale X25 : L NN PPP


Cette erreur est la consquence dune erreur de paramtrage de CFT, les valeurs de NN et PPP sont expliques dans le guide "Codes, diagnostics et messages" de CFT. Exemple : L 02 002 : manque de ressources locales. CFT/MVS nest pas en mesure daccder la ressource X25. Par exemple, la LU-MCH est INACTIVE pour VTAM.

21.1.3. Erreur rseau X25 : R SS DDD


Ce code est une erreur rseau avec le code REASON SS qui est normalis et le code SENSE qui dpend du rseau X25 ou de lquipement appel.

21.1.3.1. Code REASON SS


Le code REASON est normalis en X25. Vous trouverez une explication dtaille dans les "Spcifications techniques du rseau Transpac".

21.1.3.2. Code SENSE DDD


Le code diagnostic X25, dans le cas o il serait infrieur la valeur 07F, il est galement dcrit dans les spcifications de TRANSPAC. Les valeurs suprieures 080 sont utilises linitiative des constructeurs dquipements X25. Les codes utiliss par IBM sont dcrits dans la "documentation de rfrence X25-NPSI". Exemple : R 03 0B1 : refus de connexion par NPSI, il ny a pas dapplication en session avec la LU-MCH pour recevoir lappel.

CFT V2.3

21-1

Codes erreurs rseau

21.1.4. Diagnostics complmentaires pour les erreurs de linterface X25


Les diagnostics supplmentaires suivants sont disponibles la demande du Support Technique CFT, laide de loutil SGTRACE : SGTRACE 1 : trace des actions rseau. Remarque : toute demande linterface X25 implique une demande linterface SNA.

21.1.5. Erreur rseau X25 sous forme NCS


Ce code est une erreur dtecte par linterface rseau X25 de CFT. Il a le format suivant : 00030XYY. O : 00030 : dsigne le rseau X25, X : prend les valeurs 0,1,2 selon le module X25, YY : dsigne le code erreur par module X25.

21.1.5.1. Erreur de traitement du module X25


Les erreurs de traitement du module X25 sont prsentes dans le tableau suivant.
Tableau 27. Erreurs de traitement du module X25 Valeur de YY 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10 11 12 13 14 15 16 Signification Manque de mmoire pour dfinir un CV Plus de place dans la table des contextes Manque de mmoire pour dfinir un MCH MCH dj dfini Un SAP est actif pour ce MCH dtruire Un SAP nul est demand sur ce MCH Un CV est actif pour un MCH fermer Demande de fermeture pour un MCH inconnu Un SAP identique est dj dfini pour ce MCH Un SAP est demand pour un MCH non dfini Manque de mmoire pour crer un SAP Suppression de SAP avec des CV actifs MCH CLEAR a chou Demande de suppression de SAP inconnu MCH CLEAR a chou CALL-RQ rejet par MCH CALL-RQ rejet, tous les CV sont actifs CALL-RQ rejet car le SAP est ferm CALL-RQ rejet car le SAP est non trouv CALL-CF rejet par MCH CLEAR rejet par MCH, pas de SAP pour cet appel CALL-IN rejet, plus dapplication pour ce SAP

21-2

CFT V2.3

CFT/MVS Guide d'exploitation Tableau 27. Erreurs de traitement du module X25 (suite) Valeur de YY 17 18 19 1A 1B 1C 1D 1E 1F 20 21 22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F 30 Signification CLEAR a chou pour ce CV CLEAR-CF a chou, plus de CV CALL-IN rejet, le CV est logiquement actif USER DATA de LOGON VTAM incorrect Erreur de squence LOGON/CLEAR pour ce CV MCH non prt Erreur de squence CLEAR/LOGON pour un CV MCH nexiste pas Le service CFT X25 est inactif Erreur ATTACH du service CFT X25 Le service X25 nest pas attach Le service X25 na pas dentre de contexte Le service X25 na pas de file dattente Erreur lOPEN MCH Session CV nest pas ouverte Aucun SAP dfini DATA-RQ a chou DATA-RQ a chou (Donnes EXPRES) Idem Erreur sur le prt mettre Erreur sur le prt recevoir Donnes EXPRES dj mises Pas de donnes EXPRES mises Action X25 inconnue 2 Prt recevoir, reus Erreur de paramtres dans la demande X25

21.1.5.2. Erreur de traitement du module MCH


Les erreurs de traitement du module MCH sont prsentes dans le tableau suivant.
Tableau 28. Erreurs de traitement du module MCH Valeur de YY 01 02 03 04 05 06 07 08 09 0A Signification Erreur de cration de la file dattente Erreur de dfinition du MCH SNA Erreur dOPEN SNA du MCH MCH dj en session SNA Erreur de CLOSE SNA du MCH Session MCH perdue Confirmation de session MCH perdue Session MCH dj ferme OPEN session MCH OK OPEN session MCH OK pour un MCH inconnu (LOGAPPL dclar VTAM)

CFT V2.3

21-3

Codes erreurs rseau Tableau 28. Erreurs de traitement du module MCH (suite) Valeur de YY 0B 0C 0E 0F 10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E Signification Session MCH termine pour un MCH dj ferm Session MCH non ferme, erreur SNA Message invalide dans la file dattente X25 Message invalide dans la file dattente MCH Message SNA invalide dans la file MCH Message SNA invalide dans lEXIT MCH Erreur de lecture file dattente MCH Message invalide dans la file dattente MCH CVID inactif reu dans un CLEAR CVID inactif reu dans un CALL-CF CVID inactif reu dans un CLEAR-CF CVID inactif reu dans un CALL-RQ MCH non prt pour cette fonction MCH a reu des donnes EXPRES MCH a reu une session SNA pour un CV inactif MCH a reu un CALL-IN et le SAP nexiste pas MCH a reu un CALL-IN, tous les CV sont actifs File dattente sature ou autre erreur CALL-IN non confirm pour une erreur SNA

21.1.5.3. Erreur de traitement des CV


Les erreurs de traitement des CV sont prsentes dans le tableau suivant.
Tableau 29. Erreurs de traitement des CV Valeur de YY 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E Signification Erreur de LOGON session CV Erreur sur mission du CLEAR CV Erreur de CLOSE session CV Erreur dACCEPT session CV Session CV sans contexte Type de message inconnu Erreur de contexte session CV START session CV reu tort Erreur dOPEN session CV Erreur de commande GATE reue Des donnes reues sur un CV non prt START session reu tort Indication inconnue reue pour un CV REJECT reu tort sur un CV

21-4

CFT V2.3

CFT/MVS Guide d'exploitation

21.1.5.4. Correspondance du champ REASON sur un rseau X25


La correspondance du champ REASON pour les transferts effectus sur un rseau X25 est la suivante.
Tableau 30. Valeur de REASON X25 Reason 1 2 Signification Receive time out : le temps dexcution de lopration sur le rseau X25 est suprieur la limite fixe par CFT (dfaut = 2 minutes). Resource unavailable : une des ressources sollicites sur le rseau X25 nest pas disponible (se reporter au champ DIAG pour plus dinformations ).

21.1.5.5. Correspondance du champ DIAG sur un rseau X25


La correspondance du champ DIAG pour les transferts effectus sur un rseau X25 est la suivante.
Tableau 31. Valeur de DIAG X25 DIAG 1 2 9 Signification UNAVAILABLE_MEMORY : Pas de mmoire disponible pour effectuer une opration sur le rseau X25. UNAVAILABLE_CV : Plus de circuits virtuels de disponibles sur labonnement X25. NET_RESSOURCE_UNDEFINE : Erreur synchronisation applicative, le gestionnaire dabonnement X25 (MCH CTCP) reoit un message de dconnexion alors quil contrle des circuits actifs ou en session. NET_CONNECT_IN : Erreur synchronisation NPSI, le gestionnaire dabonnement X25 (CV CTCP) reoit un paquet dappel sur une LU CV. NET_RELEASE_IN : Erreur synchronisation NPSI, le gestionnaire dabonnement X25 (MCH CTCP) reoit un paquet de libration de circuit virtuel actif sur la LU MCH. NET_RELEASE_CF_IN : Erreur synchronisation NPSI, le gestionnaire dabonnement X25 (MCH CTCP) reoit un paquet de confirmation de libration de circuit virtuel sur la LU MCH. NET_CON_ACCEPT_IN : Erreur synchronisation NPSI, le gestionnaire dabonnement X25 (CV CTCP) reoit un paquet de confirmation dappel sur la LU CV. NET_CON_REJECT_IN : Erreur synchronisation NPSI, le gestionnaire dabonnement X25 (MCH CTCP) reoit un paquet de confirmation de dconnexion sur la LU MCH. X25_CV_MEMORY_FAILURE : Pas de mmoire disponible pour dmarrer une ressource X25 sur un abonnement (LU CV). X25_MCH_AREF_FAILURE : Une erreur sest produite pendant lacquisition de linterface de gestion des appels entrants pour un SAP X25. X25_MCH_MEMORY_FAILURE : Pas de mmoire disponible pour dmarrer un abonnement X25 (LU MCH). X25_MCH_ALREADY_EXIST : La mme LU est employe pour plusieurs abonnements X25 (commandes CFTNET). X25_REGISTER_IN_USE : Erreur de squence interne, linterface de gestion des appels entrants pour ce SAP est encore active quand CFT est en phase darrt dfinitive (commande SHUT).

10 11

12

13

14

30001 30002 30003 30004 30005

CFT V2.3

21-5

Codes erreurs rseau Tableau 31. Valeur de DIAG X25 (suite) DIAG 30006 30007 30008 30009 30010 Signification X25_REGISTER_FAILURE : Erreur de squence interne, linterface de gestion des appels pour le SAP par dfaut est dj enregistre. X25_CONNEXION_IN_USE : Erreur de squence interne, un circuit virtuel est encore actif quand CFT est en phase darrt dfinitive (commande SHUT). X25_RESSOURCE_NOT_FOUND : Erreur interne, un abonnement initialis nest pas trouv quand CFT est en phase darrt dfinitive (commande SHUT). X25_REGISTER_ALREADY_EXIST : Linterface de gestion des appels pour ce SAP est dj enregistre. (commande CFTPROT/CFTX25). X25_REGISTER_CLASS_NOT_FOUND : Linterface de gestion des appels entrants pour un SAP particulier ne peut pas tre enregistre, la classe de rseau nest pas dfinie. X25_REGISTER_MEMORY_FAILURE : Pas de mmoire disponible pour enregistrer une interface dappel pour un SAP particulier. X25_CONNECT_IN_USE : Erreur de squence interne, un circuit virtuel est encore actif quand CFT tente de supprimer le gestionnaire dappel (commande SHUT). X25_CLEAR_CV_FAILURE : Erreur de rseau, un circuit virtuel actif ne peut pas tre stopp quand CFT tente de supprimer le gestionnaire dappel (commande SHUT). X25_DEREGISTER_SAP_NOT_FOUND : Erreur interne, un gestionnaire dappel nest pas trouv quand CFT tente de le supprimer (commande SHUT). X25_DEREGISTER_CLEAR_FAILURE : Erreur rseau, un circuit virtuel actif ne peut pas tre stopp par force quand CFT est en phase darrt dfinitive (commande SHUT). X25_CONNECT_REQUEST_FAILURE : Erreur rseau, un abonnement actif ne peut pas tre contact par SNA pour communiquer un paquet dappel (commande SEND). X25_CONNECT_CV_UNAVAILABLE : Erreur logique de paramtrage, un abonnement actif est dfini avec plus de circuits virtuels (CV) que ladministration du rseau X25 en a octroy (abonnement TRANSPAC, NCP, VTAMLST vrifier). X25_CONNECT_SAP_UNAVAILABLE : Erreur logique de manipulation, une commande de transfert SEND est servie alors que le gestionnaire dappel pour le SAP sollicit est en cours darrt. (commande SHUT). X25_CONNECT_SAP_NOT_FOUND : Erreur logique de paramtrage, un appel entrant est servi alors quaucun gestionnaire dappel pour le SAP sollicit nest dmarr. X25_CONNECT_ACCEPT_FAILURE : Erreur rseau, un abonnement actif ne peut pas tre contact par SNA pour communiquer un paquet de confirmation dappel (commande RECV). X25_CONNECT_REJECT_FAILURE : Erreur rseau, un abonnement actif ne peut pas tre contact par SNA pour communiquer un paquet de libration dappel sortant (commande SEND). X25_PROVIDER_NOT_FOUND : Erreur de squence, les rfrences de labonnement ne peuvent pas tre trouves par SNA pour communiquer un paquet de confirmation dappel (par exemple : abonnement dconnect ou inactiv entre temps). X25_RELEASE_RQ_FAILURE : Erreur rseau, un circuit virtuel actif ne peut pas tre contact par SNA pour communiquer un paquet de libration de circuit (toutes commandes).

30011 30012 30013

30014 30015

30016

30017

30018

30019

30020

30021

30022

30023

21-6

CFT V2.3

CFT/MVS Guide d'exploitation Tableau 31. Valeur de DIAG X25 (suite) DIAG 30024 Signification X25_RELEASE_RS_FAILURE : Erreur rseau, un circuit virtuel actif ne peut pas tre contact par SNA pour communiquer un paquet de confirmation de libration de circuit (toutes commandes). X25_CONNECT_CV_OUT : Erreur logique de paramtrage, un abonnement est dfini avec moins de circuits virtuels (CV) que ladministration du rseau X25 en a octroy (abonnement TRANSPAC, NCP, VTAMLST vrifier). X25_LOGON_FAILURE : Erreur logique de paramtrage VTAM, les dfinitions de labonnement ne sont pas correctes, les informations remontes par le SIMLOGON du LU simulator de NPSI ne sont pas correctes. (NCP, VTAMLST vrifier). X25_RELEASE_NT_FAILURE : Erreur rseau, CFT notifie le gestionnaire dappel de rejeter un appel alors que la session avec le LU simulator de NPSI nest pas prte. Au Start_Data_Trafic, le circuit virtuel actif ne peut pas tre contact par SNA pour communiquer le paquet de libration dappel en attente (toutes commandes). X25_MCHTASK_NOT_READY : Erreur de synchronisation rseau, un circuit virtuel est tabli en appel entrant alors que le gestionnaire dappel nest pas encore actif. Lappel entrant est rejet et le circuit virtuel sera ouvert par CFT la prochaine tentative. X25_CV_RELEASE_NT_FAILURE : Erreur rseau, CFT notifie le gestionnaire dappel de fermer le circuit virtuel alors que la session avec le LU simulator de NPSI nest pas prte. Au start_data_trafic, le circuit virtuel actif ne peut pas tre contact par SNA pour communiquer le paquet de libration de circuit virtuel en attente (toutes commandes). X25_SERVICE_REQUEST_NOT_FOUND : Erreur interne, le gestionnaire dappel ne peut plus communiquer avec CFT (toutes commandes). X25_TASK_UNDEFINED : Erreur interne et/ou de paramtrage, ladministrateur de X25 nest pas actif (exemple : manque la dfinition de lACB GATE). X25_ATTACH_FAILURE : Erreur interne, ladministrateur de X25 ne peut pas lancer lexcution dun gestionnaire dappel. X25_TASK_NOT_READY : Erreur interne synchronisation, un appel est communiqu un gestionnaire dappel qui nest pas encore actif ou absent (abended). X25_REG_REF_NOT_FOUND : Erreur interne CFT, un gestionnaire dappel est activ sans quil ait enregistr labonnement quil contrle. X25_SEMAPHORE_ERROR : Erreur interne CFT, un gestionnaire dappel dtecte que CFT ne correspond plus avec sa messagerie. X25_MCH_ATTACH_FAILURE : Erreur interne, ladministrateur de X25 ne peut pas lancer lexcution dun gestionnaire dabonnement (MCH). X25_CVC_NOT_READY : Erreur interne CFT, le gestionnaire dabonnement (MCH) dtecte que le circuit virtuel nest pas prt. X25_REF_NOT_FOUND : Erreur interne CFT, le gestionnaire dabonnement (MCH) ne retrouve pas le gestionnaire dappel correspondant au SAP quil reoit. X25_DATA_RQ_FAILURE : Erreur rseau, la transmission dun paquet de donne nest pas ralise avec succs. X25_DATA_EXPRESS_RQ_FAILURE : Erreur rseau, la transmission dun paquet de donne express nest pas ralise avec succs. X25_DATA_EXPRESS_RS_FAILURE : Erreur rseau, la transmission de la rponse un paquet de donne express nest pas ralise avec succs. X25_READY_TO_RECEIVE_FAILURE : Erreur synchronisation rseau, le contrle de flux entre CFT, le gestionnaire de donnes et le gestionnaire de rseau SNA nest pas ralis avec succs.

30025

30026

30027

30028

30029

30030 30031 30032 30033

30034 30035 30036 30037 30038 30039 30040 30041 30042

CFT V2.3

21-7

Codes erreurs rseau Tableau 31. Valeur de DIAG X25 (suite) DIAG 30043 Signification X25_READY_TO_RECEIVE_RQ : Erreur synchronisation rseau, la demande de contrle de flux entre le gestionnaire de donnes et le gestionnaire de rseau SNA nest pas servie avec succs. X25_DATA_EXPRESS_IN_PROGRESS : Erreur synchronisation rseau, la demande de contrle de donnes express a dj t envoye pour le circuit virtuel. X25_NO_DATA_EXPRESS_IN_PROGRESS : Erreur synchronisation rseau, la demande de contrle de donnes express na pas t envoye pour le circuit virtuel. X25_MESSAGE_TYPE_ERROR : Erreur interne CFT, la demande mise avec le message nest pas connue de linterface X25. X25_READY_NOT_REQUEST : Erreur synchronisation rseau, la demande de contrle de flux reue nest pas sollicite pour circuit virtuel. X25_PARAMETER_ERROR : Erreur interne CFT, les paramtres de contrle X25 changs sur la messagerie interne ne sont pas corrects MCH_SEMAPHORE_FAILURE : Erreur interne CFT, le gestionnaire dabonnement (MCH CTCP) ne peut pas tablir une connexion avec la messagerie interne de CFT. MCH_REGISTER_FAILURE : Erreur interne CFT, le gestionnaire dabonnement (MCH CTCP) ne peut pas enregistrer le type de connexion avec linterface SNA. MCH_CONNECT_FAILURE : Erreur de paramtrage VTAM, le gestionnaire dabonnement (MCH CTCP) ne peut pas tablir la connexion avec la LU MCH, rejet de la demande par linterface SNA. MCH_ALREADY_CONNECTED : Erreur de paramtrage, le gestionnaire dabonnement (MCH CTCP) ne peut pas tablir la connexion avec la LU MCH, celle-ci est dj tablie par un autre gestionnaire dabonnement. MCH_RELEASE_FAILURE : Erreur interne CFT, le gestionnaire dabonnement (MCH CTCP) ne peut pas librer la connexion avec la LU MCH, rejet de la demande par linterface SNA. MCH_RELEASE_IN : Erreur rseau, le gestionnaire dabonnement (MCH CTCP) dtecte une coupure sur labonnement quil contrle et dcide de librer la connexion avec la LU MCH. MCH_RELEASE_OK : Erreur rseau, le gestionnaire dabonnement (MCH CTCP) libre la connexion avec la LU MCH et arme la procdure de remise en service automatique (automatic recovery). MCH_NOT_CONNECTED : Erreur synchronisation en remise en service, le gestionnaire dabonnement (MCH CTCP) dtecte dans la procdure de remise en service automatique (automatic recovery) que la LU MCH est nouveau oprationnelle alors quelle vient dtre dsactive logiquement. MCH_ALREADY_DISCONNECTED : Erreur synchronisation en remise en service, le gestionnaire dabonnement (MCH CTCP) reoit dans la procdure de remise en service automatique (automatic recovery) une indication de dconnexion de linterface alors quelle est dj dsactive. MCH_DEREGISTER_FAILURE : Erreur interne CFT, le gestionnaire dabonnement (MCH CTCP) ne peut pas dsactiver la LU MCH. MCH_INVALID_SNA_REQUEST : Erreur interne CFT, le gestionnaire dabonnement (MCH CTCP) reoit une demande de linterface SNA quil ne connat pas. MCH_ALREADY_RELEASED : Remise en service automatique des abonnements, le gestionnaire dabonnement (MCH CTCP) dtecte dans la procdure de remise en service automatique (automatic recovery) que la LU MCH est dj dconnecte.

30044 30045 30046 30047 30048 30101

30102 30103

30104

30105

30106

30107

30110

30111

30112 30113

30108

21-8

CFT V2.3

CFT/MVS Guide d'exploitation Tableau 31. Valeur de DIAG X25 (suite) DIAG 30109 Signification MCH_CONNECT_OK : Remise en service automatique des abonnements, le gestionnaire dabonnement (MCH CTCP) dtecte dans la procdure de remise en service automatique (automatic recovery) que la LU MCH est nouveau oprationnelle. MCH_INVALID_SNA_REQUEST : Erreur interne CFT, le gestionnaire dabonnement (MCH CTCP) reoit une demande de linterface SNA quil ne connat pas. MCH_INVALID_X25_REQUEST : Erreur interne CFT pendant la remise en service automatique, le gestionnaire dabonnement (MCH CTCP) ne peut pas avoir redmarr. MCH_UNEXPECTED_SNA_INDICATION : Erreur interne CFT, le gestionnaire dabonnement (MCH CTCP) reoit un message de linterface SNA quil ne connat pas.. MCH_UNEXPECTED_NET_INDICATION : Erreur interne CFT, le gestionnaire de circuit virtuel (CV CTCP) reoit un message de linterface SNA quil ne connat pas.. MCH_INDICATION_READ_ERROR : Erreur interne CFT, le gestionnaire dabonnement (MCH CTCP) ne peut plus exploiter sa messagerie interne. MCH_UNEXPECTED_INDICATION : Erreur interne CFT, le gestionnaire dabonnement (MCH CTCP) ne connat pas le message quil reoit de sa messagerie interne. MCH_UNEXPECTED_CON_REJECT_IN : Erreur NPSI, aprs lmission dun rejet de connexion par le gestionnaire dabonnement (MCH CTCP), NPSI la rejette. MCH_UNEXPECTED_CON_ACCEPT_IN : Erreur NPSI, aprs lmission dune confirmation dappel par le gestionnaire dabonnement (MCH CTCP), NPSI la rejette. MCH_UNEXPECTED_RELEASE_CF_IN : Erreur NPSI, aprs lmission dune confirmation de rejet dappel par le gestionnaire dabonnement (MCH CTCP), NPSI la rejette. MCH_UNEXPECTED_RELEASE_IN : Erreur NPSI, aprs lmission dun paquet dappel ou dun paquet de rejet, le CVID est incorrect, NPSI la rejette. MCH_NOT_READY : Erreur synchronisation interne, le gestionnaire dabonnement nest pas prt accepter des messages de CFT et de SNA. MCH_EXPECTED_PACKET : Erreur rseau/NPSI, le gestionnaire dabonnement reoit un paquet de service inconnu sur la LU MCH. MCH_UNEXPECTED_SSTAT : Erreur interne/NPSI, le gestionnaire dabonnement reoit un paquet de service sur la LU MCH alors que le StartDataTrafic na pas t reu. MCH_INCOMING_SAP_NOT_FOUND : Erreur paramtrage, le gestionnaire dabonnement reoit un paquet dappel sur la LU MCH alors quil nexiste pas de SAP enregistr. MCH_INCOMING_CV_UNAVAILABLE : Erreur paramtrage, le gestionnaire dabonnement reoit un paquet dappel sur la LU MCH alors quil ne dispose plus de circuits logiques de disponible avec CFT. MCH_INCOMING_QUEUE_ERROR : Erreur gnrale, le gestionnaire dabonnement ne reoit plus suffisamment dunit de service du "dispatcheur" et ne peut plus faire face au trafic de paquets de service quil reoit. MCH_ACCEPT_RS_FAILURE : Erreur gnrale, le gestionnaire dabonnement ne traite pas les confirmations dappel sortant, le service de linterface SNA nest plus disponible.

30114

30115

30116

30117

30118 30119

30120 30121

30122

30123 30124 30125 30126

30127

30128

30129

30130

CFT V2.3

21-9

Codes erreurs rseau Tableau 31. Valeur de DIAG X25 (suite) DIAG 30201 Signification CV_LOGON_FAILURE : Erreur interne CFT, le gestionnaire de circuit virtuel (CV CTCP) le bloc de contrle de circuit virtuel ne peut pas tre localis avec le network identifier rcupr dans la chane de LOGON de la LU CV. CV_RELEASE_GATE_FAILURE : Erreur rseau, le gestionnaire de circuit virtuel (CV CTCP) ne peut pas mettre un paquet de refus. Le CV est perdu. CV_RELEASE_FAILURE : Erreur rseau, le gestionnaire de circuit virtuel (CV CTCP) ne peut pas mettre un paquet de libration un circuit virtuel, linterface SNA le refuse. CV_CON_ACCEPT_FAILURE : Erreur rseau, le gestionnaire de circuit virtuel (CV CTCP) ne peut pas confirmer un appel entrant, linterface SNA le refuse. CV_RELEASE_NOT_FOUND : Erreur procdure X25, le gestionnaire de circuit virtuel (CV CTCP) ne retrouve pas le circuit logique correspondant un paquet de libration quil reoit. CV_UNEXPECTED_INDICATION : Erreur procdure X25, le gestionnaire de circuit virtuel (CV CTCP) reoit un paquet quil ne connat pas CV_UNEXPECTED_CONTEXT : Erreur interne, le gestionnaire de circuit virtuel (CV CTCP) reoit un paquet pour un circuit logique inactif. CV_UNEXPECTED_SSTART : Erreur rseau, le gestionnaire de circuit virtuel (CV CTCP) reoit un StartDataTraffic en dehors de sa phase dinitialisation. CV_CON_REJECT_IN : le gestionnaire de circuit virtuel (CV CTCP) reoit un paquet de refus dappel. CV_EXPECTED_PACKET : Erreur rseau, le gestionnaire de circuit virtuel (CV CTCP) reoit sur un circuit virtuel actif un paquet inconnu. CV_NOT_READY : Erreur synchronisation rseau, le gestionnaire de circuit virtuel (CV CTCP) reoit un paquet sur un circuit logique inactif. CV_NOT_CONNECTED : Erreur synchronisation rseau, le gestionnaire de circuit virtuel (CV CTCP) reoit un paquet sur un circuit logique dconnect. CV_UNEXPECTED_SNA_CONDITION : Erreur interne, le gestionnaire de circuit virtuel (CV CTCP) reoit de linterface SNA, sur sa messagerie interne un message quil ne connat pas. CV_REJECT_CF_FAILURE : Erreur synchronisation rseau, le gestionnaire de circuit virtuel (CV CTCP) reoit de linterface SNA, un paquet de confirmation de libration de circuit virtuel pour un circuit logique actif.

30202 30203

30204 30205

30206 30207 30208 30209 30210 30211 30212 30213

30214

21.2. Rseau SNA


21.2.1. Prsentation
Les codes erreur rseau SNA ont galement un format local ou un format rseau : L NN PPP ou R SSSSSS.

21.2.2. Erreur locale SNA L NN PPP


Elle est de la forme : L NN PPP . Cette erreur est la consquence dune erreur de paramtrage de CFT, les valeurs de NN et PPP sont expliques dans le guide "Codes, diagnostics et messages" de CFT.

21-10

CFT V2.3

CFT/MVS Guide d'exploitation

21.2.3. Erreur rseau SNA R SSTTUU


Elle est de la forme : R SSTTUU . La valeur est dduite du SENSE VTAM qui se compose de 4 octets, rduit 3 octets pour CFT : SS est dduit du BYTE 0 du SENSE VTAM selon la rgle suivante : si Byte 0 = 08 (Request Reject), SS = F8, si Byte 0 = 10, 20, 40, 80, SS = Byte 0,

TT : est la copie du BYTE 1 du SENSE VTAM, MODIFIER, UU contient soit : le Byte 3 du SENSE VTAM sil est diffrent de 0, le Byte 4 du SENSE VTAM. Exemples de SENSE SNA : le SENSE VTAM 087D0001 sera traduit en DIAGP R f87D01, le SENSE VTAM 80200000 sera traduit en DIAGP R 802000.

21.2.4. Codes SENSE VTAM gnrs par CFT


CFT peut refuser des sessions si le BIND ne lui convient pas. Dans ce cas il gnre le SENSE 084E00nn, nn tant la position du paramtre rejet dans le BIND. Exemple : CFT refuse une session SLU demandant loption BRACKET, avec le SENSE 084E0005. Il sera traduit par un CFT distant en DIAG f84E05.

21.2.5. Diagnostics complmentaires pour les erreurs de linterface SNA


Les diagnostics supplmentaires suivants sont disponibles la demande du support CFT, laide de loutil SGTRACE : SGTRACE 1 : trace des actions rseau, SGTRACE 2 : trace des vnements SNA en erreur.

21.3. Rseau TCP/IP


21.3.1. Prsentation
Les codes erreur rseau TCP/IP ont galement un format local ou un format rseau : L NN PPP ou R SSSSSS.

CFT V2.3

21-11

Codes erreurs rseau

21.3.2. Erreur locale TCP/IP L NN PPP


Elle est de la forme : L NN PPP. Cette erreur est la consquence dune erreur de paramtrage de CFT, les valeurs de NN et PPP sont expliques dans le guide "Codes, diagnostics et messages" de CFT.

21.3.3. Erreur rseau TCP/IP R SSSSSS


SSSSSS est la valeur hexadcimale de ERRNO. ERRNO est dfini dans la documentation de rfrence TCP/IP.

21.3.4. Diagnostics complmentaires pour les erreurs de linterface TCP/IP


Les erreurs TC/IP donnent lieu un message dans le fichier TCPOUT. Ce message est de la forme : hhmmss.ccc : SERddd : texte : EZYnnnnE msg , avec : hhmmss.ccc : heure du message, SERddd : nom du module CFTTCP, texte : texte sommaire CFTTCP, EZYnnnnE msg : message dexplication rechercher dans la documentation de rfrence IBM. Les diagnostics supplmentaires suivants sont disponibles la demande du support CFT, laide de loutil SGTRACE : SGTRACE 128 : trace des appels et des retours de modules, SGTRACE 1 : trace des actions rseau.

21.4. Codes erreur rseau SNA LU 6.2


Les codes erreurs rseau SNA LU 6.2 ont le format suivant : L NN PPP R HPPPSSSS HNNNNNNN Le premier caractre L dsigne une erreur locale, R une erreur du rseau.

21.4.1. Erreur locale SNA LU 6.2 : L NN PPP


Cette erreur est la consquence dune erreur de paramtrage de CFT, les valeurs de NN et PPP sont expliques dans le guide "Codes, diagnostics et messages" de CFT.

21-12

CFT V2.3

CFT/MVS Guide d'exploitation

21.4.2. Erreur rseau SNA LU 6.2 : R HPPPSSSS HNNNNNNN


Le code erreur rseau est compos de deux parties : HPPPSSSS : le code retour de linterface APPC VTAM. Le code retour de linterface comprend le code primaire (HPPP) et le code retour secondaire (SSSS). Ces codes sont dcrits dans la brochure VTAM Programming for LU 6.2 de IBM. Si le premier chiffre (H) du code primaire est 0, il sera remplac par la lettre F ainsi le code 002C0002 (Invalid conversation) deviendra F02C0002, HNNNNNNN : le "sense" VTAM.Le "sens" code VTAM subira le mme traitement : le sense 084B0003 (Requested Resources not available) sera traduit par F84B0003.

21.4.3. Diagnostics complmentaires pour les erreurs de linterface SNA LU 6.2


Les diagnostics supplmentaires suivants sont disponibles la demande du support CFT, laide de loutil SGTRACE : SGTRACE 1 : trace des actions rseau, SGTRACE 2 : trace des vnements SNA LU 6.2 en erreur.

21.5. Erreur rseau SNA LU 6.2 sous forme NCS


Ce code est une erreur dtecte par linterface rseau SNA LU 6.2 de CFT. Il a le format suivant : 00062XYY. O : 00062 : dsigne le rseau SNA LU 6.2, X : prend les valeurs 1, 2, 3, 4 selon le module LU 6.2, YY : code erreur par module SNA LU 6.2.

21.5.1. Erreurs de traitement du module CFT LU 6.2


Les erreurs de traitement du module CFT LU 6.2 sont prsentes dans le tableau suivant.
Tableau 32. Erreurs de traitement du module CFT LU 6.2 Valeur de YY 01 02 03 04 05 06 07 08 09 Signification Manque de mmoire pour dfinir un buffer de donnes Erreur de paramtres sur acceptation dune conversation Erreur de paramtres sur rejet dune conversation Erreur de paramtres sur ouverture dune conversation Conversation non active Erreur de paramtres sur suppression dun SAP Erreur ATTACH du service rseau LU 6.2 Type de message inconnu Erreur sur prt mettre

CFT V2.3

21-13

Codes erreurs rseau Tableau 32. Erreurs de traitement du module CFT LU 6.2 (suite) Valeur de YY 0A 0B 0C 0D 0E 0F 10 11 12 13 14 Signification Erreur sur prt recevoir Erreur de paramtres sur prt recevoir Erreur de paramtres sur cration dun SAP Erreur de paramtres sur fermeture dune conversation Erreur de paramtres sur rponse de fermeture dune conversation Erreur de paramtres sur cration dune ressource SNA LU 6.2 Erreur de paramtres sur suppression dune ressource SNA LU 6.2 Erreur de paramtres sur envoi de donnes Rfrence de conversation inconnue Etat de la conversation invalide Erreur dans la commande de modification du mode de conversation

21.5.2. Erreurs de traitement du module rseau LU 6.2


Les erreurs de traitement du module rseau SNA LU 6.2 sont prsentes dans le tableau suivant.
Tableau 33. Erreurs de traitement du module rseau SNA LU 6.2 Valeur de YY 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E Signification Demande de suppression de SAP avec des conversations encore enregistres Erreur de fermeture de conversation sur une demande de suppression de SAP SAP inconnu Erreur ATTACH du service ressource LU 6.2 Demande de cration dun SAP dj existant La ressource nexiste pas dans la classe demande Demande de suppression de SAP avec des modes encore enregistres Type de message inconnu Cration dune ressource dj existante Suppression dune ressource inexistante Erreur de cration de la file dattente Erreur de suppression de la file dattente Demande de suppression de SAP avec des sessions encore enregistres Erreur ATTACH du service suivi des ressources LU 6.2

21.5.3. Erreurs de traitement des ressources SNA LU 6.2


Les erreurs de traitement des ressource SNA LU 6.2 sont prsentes dans le tableau suivant.
Tableau 34. Erreurs de traitement des ressources SNA LU 6.2 Valeur de YY 01 02 03 04 05 06 Signification Erreur de fermeture de lACB VTAM ACB VTAM non ouvert Erreur douverture dune conversation sortante Erreur de dfinition du nombre de sessions Erreur de fermeture dune conversation sortante Erreur ATTACH du service de rception des donnes

21-14

CFT V2.3

CFT/MVS Guide d'exploitation Tableau 34. Erreurs de traitement des ressources SNA LU 6.2 (suite) Valeur de YY 07 08 09 0A 0B 0C 0D 0E 0F 10 11 12 Signification Erreur ATTACH du service de gestion des indications rseau Type de message inconnu Erreur douverture dune conversation entrante Contexte de la conversation inconnu Erreur de cration de la file dattente Erreur de suppression de la file dattente Erreur sur autorisation accepter les sessions entrantes Erreur sur refus de recevoir les sessions entrantes Manque de mmoire pour dfinir une indication Erreur sur la demande du tour de parole Nombre de sessions maximum atteint Erreur de fermeture des sessions

21.5.4. Autres erreurs SNA LU 6.2


Les autres erreurs de traitement SNA LU 6.2 sont prsentes dans le tableau ci-dessous :
Tableau 35. Autres erreurs de traitement SNA LU 6.2 Valeur de YY 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10 11 12 13 14 15 16 17 18 19 1A Signification Manque de mmoire pour dfinir la zone de rception des donnes Erreur sur la commande de rception de donnes Erreur dcriture dans la file dattente de CFT Rception de donnes incompltes Erreur de dverrouillage dune ressource LU-MODE Erreur de verrouillage dune ressource LU-MODE Manque de mmoire pour dfinir un bloc de contrle LU-MODE Bloc rseau non trouv Tche rseau non prte Manque de mmoire pour dfinir le bloc de contrle rseau Erreur de dverrouillage dune ressource RECEIVE_ANY Erreur de verrouillage dune ressource RECEIVE_ANY Manque de mmoire pour dfinir un bloc de contrle RECEIVE_ANY Tche ressource non prte Erreur dcriture dans la file dattente de la tche ressource Bloc ressource non trouv Erreur de dverrouillage dune ressource Erreur de verrouillage dune ressource Manque de mmoire pour dfinir un bloc de contrle ressource Erreur de dverrouillage dune ressource SAP Erreur de verrouillage dune ressource SAP Manque de mmoire pour dfinir un bloc de contrle SAP Erreur de dverrouillage dune ressource session Erreur de verrouillage dune ressource session Manque de mmoire pour dfinir un bloc de contrle session Erreur de fermeture des sessions

CFT V2.3

21-15

Codes erreurs rseau Tableau 35. Autres erreurs de traitement SNA LU 6.2 (suite) Valeur de YY 1B 1C 1D 1E 1F 20 21 22 23 24 Signification Erreur de fermeture de lACB VTAM Type dindication inconnue Erreur sur rejet de session Erreur sur rejet de conversation LOSS reu sur la session TPEND reu Manque de mmoire pour dfinir un bloc requte Erreur sur rejet de conversation Erreur de dfinition du nombre de sessions Erreur de visualisation du nombre de sessions

21-16

CFT V2.3

22. Codes retour et codes ABEND des interfaces systmes CFT/MVS

22.1. Prsentation
Le tableau suivant rsume les principaux codes erreur ou ABEND utiliss par CFT/MVS.
Tableau 36. Principaux codes erreur ou ABEND Module SGFBSAM SGF3C SERURG MEMCOPY SGKWAIT SGKDEQ SGKENQ SNAEXIT SGIDINIT SIMM SGKPOST SGKDEQ SGKENQ SGKWAIT SGKDEQ SGKENQ SIFM SIFM SIFM SGF3ACC SIFM SIFM SGIWARNC SGKSWAIT SGKDEQ SGSENQ SGKMWAIT SGKENQ SGINUCDS L62EXIT L62EXIT Type ABEND ABEND ABEND ABEND ABEND ABEND ABEND ABEND ABEND Info ABEND ABEND ABEND ABEND ABEND ABEND Info Info Info Info Info Info ABEND ABEND ABEND ABEND ABEND ABEND ABEND ABEND ABEND Dec. 0001 0011 0091 0204 0257 0304 0312 0376 0376 0376 0514 0560 0568 0769 0816 0824 0991 0992 0993 0994 0996 0999 0999 1025 1072 1080 1281 1336 2300 2376 2378 Hexa. 00000001 00000017 0000005B 000000CC 00000101 00000130 00000138 00000178 00000178 00000178 00000202 00000230 00000238 00000301 00000330 00000338 000003DF 000003E0 000003E1 000003E2 000003E4 000003E7 000003E7 00000401 00000430 00000438 00000501 00000538 000008FC 00000949 0000094A Explication DCB/Buffer fichier incorrect FCB incorrect Dtection de TCP errno imprvu Erreur fonction memcpy/memmove ECB priv incorrect DEQ sans ENQ 2 ENQ sur la mme ressource Plus de mmoire Plus de mmoire Plus de mmoire ECB priv incorrect Erreur chane des ENQ major Erreur chane des ENQ minor ECB priv dtruit Erreur chane des ENQ major Erreur chane des ENQ minor Fichier indisponible (RENAME) Fichier indisponible (ENQ) Membre de PDS absent Erreur de fichier GDG Fichier non trouv/existe dj Cration par DDNAME Paramtres de fonction C non supports ECB priv incorrect DEQ demand par une autre tche Erreur de paramtres ECB priv incorrect Erreur de retour du WAIT Mot 1 de TCBFSA utilis Ressource LU 6.2 inconnue Exit LU 6.2 inconnu

CFT V2.3

22-1

Codes retour et codes ABEND des interfaces systmes CFT/MVS Tableau 36. Principaux codes erreur ou ABEND (suite) Module L62EXIT L62xxxx SISM SNA3 SNAINSES SNAINSES SNAINSES SNARELRS SNARELRS SNARELRS SNARELRS SNARELRQ SNARELRQ SNARELRQ SNAIXRPL SNASNDRQ SNASNDRQ SNASNDRQ SNASNDRQ SNASNDRQ SNASNDRQ SNASNDRQ SNARELRQ SNARELRS SNAREJRS SNAREADY SNAACPRS SNASESOP SNACONRQ SNACONRQ SNAACPRS SNAACPRS SNACONRQ SNAACPRS SNAREG SNACONRQ SNAREG SNAREG SNAUNDEF SNADEREG SGFHYPER Type ABEND ABEND Info Info Info Info Info Info Info Info Info Info Info Info ABEND Info Info Info Info Info Info Info Info Info Info Info Info Info Info Info Info Info Info Info Info Info Info Info ABEND ABEND ABEND Dec. 2379 2399 2483 2499 2601 2602 2603 2616 2617 2618 2619 2627 2628 2629 2630 2634 2635 2636 2637 2638 2639 2640 2640 2640 2640 2640 2640 2642 2650 2651 2651 2651 2652 2652 2653 2653 2688 2689 2690 2690 2864 Hexa. 0000094B 0000095F 000009B3 000009C3 00000A29 00000A2A 00000A2B 00000A38 00000A39 00000A3A 00000A3B 00000A43 00000A44 00000A45 00000A46 00000A4A 00000A4B 00000A4C 00000A4D 00000A4E 00000A4F 00000A50 00000A50 00000A50 00000A50 00000A50 00000A50 00000A52 00000A5A 00000A5B 00000A5B 00000A5B 00000A5C 00000A5C 00000A5D 00000A5D 00000A80 00000A81 00000A82 00000A82 00000B30 Explication Exit LU 6.2 manque de mmoire RPL LU6.2 Actif Programme non autoris APF Fonction SNA non supporte Pas de paramtre CINIT SAP non trouv Arrt de VTAM demand Pas de fermeture confirmer Session non encore ouverte Session dj ferme par applicatif Session non ferme par le rseau Session non ouverte Session dj ferme par applicatif Session dj ferme par rseau Erreur acronyme RPL VTAM Pas le tour de parole applicatif Session perdue Session termine Session ferme Session non ouverte Erreur paramtre QUALIFY Rfrence session invalide Rfrence session invalide Rfrence session invalide Rfrence session invalide Rfrence session invalide Rfrence session invalide Limite sessions atteinte Nom de LU incorrect Type LU incorrect Adresse de EXIT incorrect Adresse de EXIT incorrect Profil non trouv Profil non trouv Erreur SAP SAP invalide Ressource non dfinie SAP dj dfini Chane des ressources dtruite Chane des SAP dtruite Erreur HSPSERV SWRITE

22-2

CFT V2.3

CFT/MVS Guide d'exploitation Tableau 36. Principaux codes erreur ou ABEND (suite) Module SGKCP SGKCP SGKCP SGKCP SGKCP SGKCP SGKCP MVSBXCRE MVSBXCRE MVSBXCRE MVSBXCRE MVSBXCRE MVSBXCRE IBM3PARM SISY SISY SISY SISY SISYDEL SISY SISYDEL SISY SISYDEF SISY SISY SISY SISY SISY SISY SISY SISY SISY SISYDEL SITM SISM SYMSYSF SYMSYSF SYMSYSF SYMSYSF SYMSYSF Type ABEND ABEND ABEND ABEND ABEND ABEND ABEND Info Info Info Info Info Info ABEND Info Info Info ABEND ABEND ABEND ABEND ABEND Info Info Info Info Info Info Info Info Info Info Info Info Info ABEND ABEND ABEND ABEND ABEND Dec. 2881 2884 2885 2886 2887 2888 2889 2915 2916 2917 2918 2919 2920 2930 2933 2934 2935 2936 2937 2937 2938 2938 2939 2940 2941 2942 2943 2945 2946 2946 2947 2948 2949 2951 2960 2976 2977 2978 2979 2980 Hexa. 00000B41 00000B44 00000B45 00000B46 00000B47 00000B48 00000B49 00000B63 00000B64 00000B65 00000B66 00000B67 00000B68 00000B72 00000B76 00000B77 00000B78 00000B78 00000B79 00000B79 00000B7A 00000B7A 00000B7B 00000B7C 00000B7D 00000B7E 00000B7F 00000B81 00000B82 00000B82 00000B83 00000B84 00000B85 00000B87 00000B90 00000BA0 00000BA1 00000BA2 00000BA3 00000BA4 Explication Une tche obligatoire a fait ABEND Chane des ECB en boucle Chane des KECB en boucle Chane des taches en boucle KCP cras Second init du dispatcher Erreur dans la chane des tches Erreur douverture Erreur file dattente Erreur nom de mailbox Systme MVS non-ESA Mailbox existe dj Erreur GQSCAM Plus de 16 paramtres ACR smaphore invalide Rfrence smaphore invalide Mode ENQ message incorrect Acronyme smaphore incorrect Acronyme smaphore incorrect Acronyme message incorrect Acronyme message incorrect Acronyme message incorrect Message de longueur nulle Bote aux lettres non supporte sous VM Bote aux lettres non supporte sous VM Bote aux lettres non supporte sous VM Demande de libration dun LOCK libre 2 demandes du mme LOCK Numro de LOCK > 63 Numro de LOCK > 63 Erreur longueur donnes de contrle Erreur longueur message Rfrence smaphore incorrecte Fonction inconnue Fonction inconnue FREEMAIN en 0 Erreur de chanage mmoire FREEMAIN dune zone non alloue Prfixe zone mmoire incorrect Plus de SAVE AREA

CFT V2.3

22-3

Codes retour et codes ABEND des interfaces systmes CFT/MVS Tableau 36. Principaux codes erreur ou ABEND (suite) Module SYMSYSG SYMSYSG SYMSYSG SYMSYSG SYMSYSG SGIDEXIT SGIDEXIT SGIDINIT SGIDINIT SGIDINIT SGIDINIT SGIDINIT Type ABEND ABEND ABEND ABEND ABEND ABEND ABEND ABEND ABEND ABEND ABEND ABEND Dec. 2986 2987 2988 2989 2990 2991 2992 2993 2994 2995 2996 2997 Hexa. 00000BAA 00000BAB 00000BAC 00000BAD 00000BAE 00000BAF 00000BB0 00000BB1 00000BB2 00000BB3 00000BB4 00000BB5 Explication Prfixe zone mmoire incorrect Prfixe zone mmoire incorrect Paramtres incorrects Zone mmoire utilise Plus de SAVE AREA CRAB incorrect Fin de pile de travail dpasse CLINK incorrect Programme C en version < 4.50 Dlimiteur de fin de DSA cras Routage dun programme C Routage dun programme C

Remarque : pour tous les codes ABEND, contactez le Service Assistance Technique.

22-4

CFT V2.3

A. Mise en oeuvre spcifique

A.1. Environnement systme


A.1.1. Cration des fichiers sous OS/MVS
CFT/MVS cre des fichiers dans les cas suivants : par la fonction CFTFILE TYPE=CREATE, par la fonction COPYFILE, lors de la rception des fichiers transfrs. La cration des fichiers SAM est faite par SVC99(DYNALLOC). Les principales options de cration de fichiers SAM sont les suivantes : si le format F/V/U est reu, il est pris en compte, sinon le format U est pris par dfaut, si le BLKSIZE est omis, 3 cas sont possibles : en format F, la valeur la plus proche de MAXBLKSIZE est prise (MAXBLKSIZE est une option dinstallation, sa valeur par dfaut est 27920), en format V, MAXBLKSIZE est pris, en format U, 32760 est pris,

lespace primaire allou est calcul partir de la valeur de SPACE, lespace secondaire allou est gal 10 % du primaire, pour un PDS, 150 blocs de DIRECTORY sont allous, cette valeur est modifiable lors de linstallation de CFT/MVS, le fichier est dtruit en cas derreur, si VOLUME et/ou UNIT ne sont pas prciss, SVC99 utilise la valeur par dfaut de SVC99 (voir MVS/ESA SPL : Dynamic allocation). Cette valeur par dfaut peut entrer en conflit avec les options ou EXITS de linstallation, les options de DF/SMS. Les fichiers VSAM sont crs par appel dynamique IDCAMS. Dans ce cas, le paramtre VOLUME est obligatoire, sauf si DF/SMS prend une option par dfaut.

A.1.2. Option de partage des fichiers sous OS/MVS


CFT/MVS permet le partage des fichiers avec lexploitation, avec les options suivantes : un fichier en mission est allou avec DISP=SHR, un fichier en rception est allou avec DISP=OLD.

CFT V2.3

A-1

Mise en oeuvre spcifique

De plus CFT/MVS interdit : lmission et la rception simultane dans le mme fichier, y compris 2 membres dun PDS, la rception simultane de 2 membres dun mme fichier PDS.

A.1.3. Suppression des fichiers sous OS/MVS


CFT/MVS ne permet pas la suppression : de la version -n dun fichier GDG, dun fichier allou par un autre utilisateur.

A.1.4. Gestion des fichiers par DF/SMS


CFT/MVS cre des fichiers compatibles avec DF/SMS, avec les options suivantes : le DCB est toujours prcis sous la forme DCB=(RECFM=xx,LRECL=lll,BLKSIZE=bbb), le SPACE est toujours prcis sous la forme SPACE=(bbb,(nnn,sss)), les ROUTINES ACS devront dans certains cas tre adaptes au mode opratoire de CFT.

A.1.5. CFT/MVS et les fichiers PDSE


CFT/MVS ne sait pas crer des fichiers PDSE.

A.2. Procdures CFT


CFT construit et soumet des JOB partir de tout type de fichier lisible par le moniteur. Par dfaut, le JOB sera soumis avec le USERID du demandeur du transfert. Dans le cas ou la dernire carte du JOB est une carte de JCL commenant par /* ou //, CFT ajoute une carte commentaire supplmentaire de la forme :
//* SUBMITTED BY:jjjjjjjj AT hh:mm:ss, USERID=uuuuuuuu ,CARDS= nnnnnnnn

avec : jjjjjjjj hh :mm :ss uuuuuuuu nnnnnnnn : JOBNAME de CFT, : heure du SUBMIT, : USERID utilis, : nombre de cartes soumises.

A-2

CFT V2.3

B. Paramtrage spcifique

B.1. Tableau des valeurs spcifiques


Tableau 37. Valeurs spcifiques

Notation char_file char_mask char_unit char_symb file_symb

Objet Prfixe des noms logiques Caractre joker (wild card) Caractre sparateur (volume) Prfixe des variables symboliques Caractre introduisant un nom de fichier pass en paramtre CFTUTIL, VFMUTIL

Valeur spcifique $ ? % &

Tableau 38. Valeurs spcifiques : dfauts pour CFTUTIL

Objet Fichier Paramtres Fichier Partenaires Fichier catalogue Fichier journal Fichier communication Mdia prfrentiel

Valeur spcifique $CFTPARM $CFTPART $CFTCAT $CFTLOG $CFTCOM Fichier

B.2. Fichiers transfrables


Tableau 39. Caractristiques de fichiers retrouves automatiquement ou non lmission

Paramtre FSPACE FLRECL FBLKSIZE FRECFM FTYPE

Retrouv automatiquement lmission OUI OUI OUI OUI OUI

CFT V2.3

B-1

Paramtrage spcifique Tableau 40. Combinaisons de FTYPE et FRECFM lmission

Nature du fichier mettre Fichiers squentiels disque Membres de fichiers PDS (1 transfert par membre) Version dsigne dun fichier en GDG Fichier disque multivolume Fichier VSAM KSDS ou ESDS Fichier dimpression avec codes saut ASA (MVS MVS) Fichier dimpression avec codes saut machine (MVS MVS) Fichier en format variable spann (MVS MVS)

Valeur implicite de FTYPE

Valeur implicite de FRECFM F/V/U F/V/U F/V/U F/V/U F/V

A M S

F/V/U F/V V

Remarque : les fichiers variables ""spanns"" peuvent transiter par un CFT intermdiaire en protocole PeSIT uniquement (profil ANY). Dans ce cas, le fichier reu sur CFT/MVS sera toujours en format U. Les PDS dchargs par IEBCOPY sont galement reus en format U, ce qui est compatible avec IEBCOPY.
Tableau 41. Valeurs de FORG, FTYPE et FRECFM la rception

FORG SEQ PART SEQ SEQ DIRECT INDEXED SEQ SEQ SEQ SEQ

FTYPE

FRECFM F/V/U F/V/U F/V/U F/V/U F/V F/V

Nature du fichier rception Fichier squentiel disque Membre de fichiers PDS (1 transfert par membre) Version dsigne -1 0 dun fichier en GDG Fichier disque multivolume Fichier VSAM ESDS Fichier VSAM KSDS (prexistant vide) Fichier dimpression avec code saut ASA (MVS MVS) Fichier dimpression avec code saut machine (MVS MVS) Fichier en format variable spann (MVS MVS) Fichier bande magntique ou cassette en position 1 (avec STANDARD LABELS)

A M S

F/V/U F/V/U V F/V/U

Ces valeurs sont explicites dans CFTRECV ou dduites des valeurs protocolaires reues.

B-2

CFT V2.3

CFT/MVS Guide d'exploitation

B.3. Codification des noms de fichiers


B.3.1. Noms des fichiers
Un nom de fichier peut se prsenter sous diffrentes formes : un DSNAME ou un triplet VOLUME%UNITE%DSNAME (VOLUME et UNITE tant souvent facultatifs) Exemple : pour demander lmission dun fichier SEND FNAME=CFT.SEND.FILE le fichier est recherch au catalogue SEND FNAME=CFTRES%3480%CFT.SEND.FILE le fichier est recherch sur le volume CFTRES, unit 3480 SEND FNAME=%3480%CFT.SEND.FILE le fichier est recherch au catalogue (type dunit impos) SEND FNAME=CFTRES%%CFT.SEND.FILE le fichier est recherch sur le disque CFTRES. Lemploi des paramtres VOLUME et/ou UNITE peuvent entrer en conflit avec la gestion de fichier DF/SMS, un nom de membre de PDS : mmes principes que ci-dessus, en compltant avec le nom du membre mis entre parenthses. Exemple : pour demander lmission dun membre SEND FNAME=CFT.SEND.FILE(MEMBER) le fichier est recherch au catalogue un nom logique, associ une carte DD [ JCL ] ou un ALLOC [ CLIST ] Exemple : pour slectionner un fichier PARTENAIRES CFTPARM PARTFNAM=$CFTPART, ce fichier sera prcis dans le JCL de lancement de CFT, par //CFTPART DD DISP=SHR,DSN=..., ou sous TSO : ALLOC FI(CFTPART) SHR DA(...). CFT (et les utilitaires associs) rservent lemploi des DDNAMES commenant par FIL aux allocations dynamiques.

CFT V2.3

B-3

Vous aimerez peut-être aussi