Guide Exploitation

5/13/2018 Guide Exploitation - slidepdf.com

http://slidepdf.com/reader/full/guide-exploitation 1/154

CFT Version 2.3

C2-MVS-EXPL-23-04

CFT/MVS

Guide d’exploitation

http://ccft0010.pdf/

http://ccft0010.pdf/



Copyright

Le Code de la propriété industrielle n’autorise, aux termes de l’article L.122-5 que les “copies oureproductions strictement réservées à l’usage privé du copiste et non destinées à une utilisation

collective”.

Toute reproduction totale ou partielle, toute transmission sous quelque forme ou par quel procédé que cesoit (électronique ou mécanique, photocopie ou enregistrement) et à toutes autres fins que l’usage

personnel sans autorisation écrite d'Axway Software est strictement interdite. Cette représentation oureproduction constituerait donc une contrefaçon sanctionnée par les articles L.335-2 et suivants du Codede la propriété intellectuelle.

© Axway Software, 2004. Tous droits réservés.



CFT V2.3 iii

Table des Matières

1. Caractéristiques 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 parallèle .................................................................................................................. 1-1

1.4. Description de l’environnement CFT........................................................................................... 1-2

2. Besoins matériels et logiciels, préparation de l’installation...............................................2-1

2.1. Besoins matériels.......................................................................................................................... 2-1

2.1.1. Processeurs et versions de OS/390....................................................................................... 2-1 2.1.2. Unités d’entrée/sortie ........................................................................................................... 2-1

2.2. Besoins logiciels........................................................................................................................... 2-1

2.3. Format du support d’installation CFT V2.3.0.............................................................................. 2-2

2.4. Format du support d’installation à partir de la version 2.3.1........................................................ 2-2

2.5. Taille et format des fichiers d’installation XFB/CFT V2.3.0....................................................... 2-3

2.6. Taille et format des fichiers d’installation 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. Accès aux fichiers ........................................................................................................................ 3-1

3.2. Codification des noms de fichiers ................................................................................................ 3-1

3.2.1. Codification des paramètres 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. Création dynamique des fichiers CFT/MVS................................................................................ 3-3

3.6.1. Création 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 multisystèmes GRS de CFT/MVS...................................................................... 3-5



Table des Matières

CFT V2.3iv

3.9. Fichiers hiérarchiques HFS.......................................................................................................... 3-5

3.9.1. Noms de fichiers HFS.......................................................................................................... 3-5 3.9.2. Caractéristiques des fichiers HFS ........................................................................................ 3-6 3.9.3. Interprétation des caractéristiques RECFM/LRECL/BLKSIZE .......................................... 3-6 3.9.4. Propriétaire et droits d’accès aux fichiers HFS.................................................................... 3-6

3.9.5. Message d’erreur spécifique HFS........................................................................................ 3-7

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

4.1. Installation de CFT/MVS............................................................................................................. 4-1

4.2. Définition d’un ALIAS CFT version 2 ........................................................................................ 4-1

4.3. Restauration de la bibliothèque d’installation.............................................................................. 4-2

4.3.1. Transfert des fichiers d’installation depuis un CD............................................................... 4-2

4.4. Adaptation des JOB d’installation à l’exploitation ...................................................................... 4-4

4.5. Personnalisation des fichiers d’installation de CFT/MVS (A00CUSTO).................................... 4-5

4.5.1. Création des fichiers d’installation de CFT/MVS (A10ALLOC)........................................ 4-7 4.5.2. Restauration de la bande d’installation 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 réseau 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. Définition d’un ALIAS CFT version 2 ........................................................................................ 5-1

5.3. Restauration de la bibliothèque d’installation.............................................................................. 5-2

5.3.1. Restauration des fichiers d’installation a partir d’une cassette ............................................ 5-2 5.3.2. Transfert des fichiers d’installation depuis un CD............................................................... 5-3

5.4. Décompression des fichiers de livraison...................................................................................... 5-4

5.5. Adaptation des JOB d’installation à l’exploitation ...................................................................... 5-4

5.6. Personnalisation des fichiers d’installation 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 réseau TCP/IP............................................................................. 5-10

5.7. LINK-EDIT des programmes CICS (B24LCICS) ..................................................................... 5-11

6. Création de l’environnement CFT/MVS ............................................................................6-1

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

6.2. Définition de l’index alterné du catalogue (D41AIX1, D41AIX2).............................................. 6-1

6.3. Création du fichier PKI de CFT/MVS (D43PKI)......................................................................... 6-3



CFT/MVS Guide d’exploitation

CFT V2.3 v

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

7.1. Menus CFT................................................................................................................................... 7-1

7.2. Création des fichiers de l’interface 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. Création du fichier de configuration (C33CNFxx) ...................................................................... 7-2

7.6. Création 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. Présentation.................................................................................................................................. 8-1

8.2. Mise à jour des procédures de transfert (H80EXEC)................................................................... 8-1

8.3. Exemple de JCL de demande de transfert.................................................................................... 8-1

8.3.1. Média de communication : fichier (CFTSEND).................................................................. 8-1 8.3.2. Média de communication : API synchrone (CFTSENDS) [XFB/CFT.231]........................ 8-2

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

9. Création des paramètres CFT/MVS (E50PARM) .............................................................9-1

9.1. Présentation.................................................................................................................................. 9-1

9.2. Création des paramètres CFT/MVS (E50PARM)........................................................................ 9-1

9.3. Création d’une base VFM (F60VFMC) ....................................................................................... 9-2

9.4. Partage d’une base VFM.............................................................................................................. 9-2

9.5. Mise à jour de SYS1.VTAMLST (G70VTAM)........................................................................... 9-3

9.5.1. Paramètres du NCP pour utiliser “GATE”........................................................................... 9-3 9.5.2. Compléments d’information à propos des réseaux X25 ...................................................... 9-3

9.6. Mise à jour de SYS1.VTAMLIB (G71LOGM)........................................................................... 9-4

9.7. Mise en œuvre du système des habilitations ................................................................................ 9-5



Table des Matières

CFT V2.3vi

10. Installation de l’option XFB.Scope..................................................................................10-1

10.1. Présentation.............................................................................................................................. 10-1

10.2. Personnalisation des paramètres d’installation XFB-SCOPE (NT00CUST)........................... 10-1

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

10.4. Création de fichiers XFB-SCOPE (NT20DEF) ....................................................................... 10-2

10.5. Utilisation de l’agent externe A&P(CFTAETP) ...................................................................... 10-3

11. Installation de l’option «Sentinel for XFB» ....................................................................11-1

11.1. Présentation.............................................................................................................................. 11-1

11.2. Mise en place............................................................................................................................ 11-1

11.2.1. Mise en place de l’Event Router ...................................................................................... 11-1 11.2.2. Personnalisation du fichier de configuration « Sentinel for XFB » (SN00CUST)...... 11-1 11.2.3. Modification de la procédure de lancement de CFT........................................................ 11-3 11.2.4. Prise en compte du fichier de configuration..................................................................... 11-3 11.2.5. Mode d’envoi des messages............................................................................................. 11-3 11.2.6. Remplacement de l’option XFB.Scope............................................................................ 11-4

11.3. Exemples de procédures 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 d’installation .............................................................................................. 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 d’installation 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 l’interface interactive................................................ 12-2

12.6. Sauvegarde/Restauration du paramétrage CFT/MVS.............................................................. 12-2

12.6.1. Extraction des paramètres CFT : CFTEXT...................................................................... 12-2 12.6.2. Procédure de sauvegarde du paramétrage........................................................................ 12-3 12.6.3. Procédure de restauration du paramétrage ....................................................................... 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 d’installation .............................................................................................. 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




CFT V2.3 vii

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. Récupération 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 d’une PTF (A13PTFLK) ...................................................................................... 13-3

13.7. Restauration de la librairie des exécutables (A13RSTOR) ...................................................... 13-4

13.8. Suppression d’une version de sauvegarde (A13SDEL) .......................................................... 13-4

13.9. Prise en compte de nouveaux menus de l’interface interactive................................................ 13-4

13.10. Sauvegarde/Restauration du paramétrage CFT/MVS ............................................................ 13-4 13.10.1. Extraction des paramètres CFT : CFTEXT.................................................................... 13-5 13.10.2. Procédure de sauvegarde du paramétrage...................................................................... 13-5 13.10.3. Procédure de restauration du paramétrage ..................................................................... 13-5

13.11. Sauvegarde/Restauration des fichiers CATALOGUE COMMANDE................................... 13-6

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

14.1. Présentation.............................................................................................................................. 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. Réalisation des exits en assembleur 370 .......................................................................... 15-3 15.3.3. Réalisation des exits en C ................................................................................................ 15-5 15.3.4. Réalisation des exits en COBOL for OS/390................................................................... 15-7

15.4. Appel des API de CFT dans les EXITS ................................................................................... 15-8



Table des Matières

CFT V2.3viii

16. Commandes de l’interface opérateur de CFT sous OS/390 .......................................16-1

16.1. Présentation.............................................................................................................................. 16-1

16.2. Commandes de l’interface opérateur........................................................................................ 16-1

16.2.1. Réponse de l’interface opérateur...................................................................................... 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. Réponse 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 sécurité RACF ..........................................17-1

17.1. Présentation.............................................................................................................................. 17-1

17.2. Contrôle des opérations de manipulation des fichiers.............................................................. 17-1

17.3. Activation du contrôle des autorisations RACF....................................................................... 17-1

17.4. RACF et les interfaces écran CFT/MVS.................................................................................. 17-2

17.4.1. RACF et l’interface Internet............................................................................................. 17-2 17.4.2. RACF et l’interface utilisateur JAVA.............................................................................. 17-2

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

18.1. Utilisation de la mémoire ......................................................................................................... 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 entrées/sorties disque ....................................................................................... 18-2

18.2.1. Utilisation d’un hyperspace MVS/ESA ........................................................................... 18-2 18.2.2. Libération de l’espace disque inutilisé dans les fichiers reçus......................................... 18-2

18.3. Utilisation de l’unité 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 réseaux SNA ................................................................. 18-3 18.5.3. Moniteur CFT en SYSPLEX et réseau TCP/IP ............................................................... 18-3




CFT V2.3 ix

18.6. Utilisation des services Automatic Restart Manager................................................................ 18-4

18.7. Fichiers de diagnostics de LE/370............................................................................................ 18-4

18.8. Paramétrage des réseaux X25................................................................................................... 18-5

18.8.1. Paramètres du NCP pour utiliser “GATE”....................................................................... 18-5 18.8.2. Compléments d’information à propos des réseaux 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. Règles communes d’appel 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 complémentaires.......................................................................................... 18-11 18.10.7. Messages d’erreurs....................................................................................................... 18-11 18.10.8. Performances des utilitaires ......................................................................................... 18-11

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

19.1. Présentation.............................................................................................................................. 19-1

19.2. Format du champ DIAGP ........................................................................................................ 19-1

19.2.1. Table des codes erreur fichier NNNN.............................................................................. 19-2

19.3. Diagnostics complémentaires pour les erreurs fichiers............................................................ 19-5

20. Messages des interfaces systèmes de CFT/MVS.............................................................20-1

20.1. Présentation.............................................................................................................................. 20-1

20.2. Définition ................................................................................................................................. 20-1

21. Codes erreurs réseau.........................................................................................................21-1

21.1. Réseau X25 .............................................................................................................................. 21-1

21.1.1. Présentation...................................................................................................................... 21-1

21.1.2. Erreur locale X25 : L NN PPP......................................................................................... 21-1 21.1.3. Erreur réseau X25 : R SS DDD........................................................................................ 21-1 21.1.4. Diagnostics complémentaires pour les erreurs de l’interface X25................................... 21-2 21.1.5. Erreur réseau X25 sous forme NCS................................................................................. 21-2

21.2. Réseau SNA ........................................................................................................................... 21-10

21.2.1. Présentation.................................................................................................................... 21-10 21.2.2. Erreur locale SNA L NN PPP........................................................................................ 21-10 21.2.3. Erreur réseau SNA R SSTTUU...................................................................................... 21-11 21.2.4. Codes SENSE VTAM générés par CFT ........................................................................ 21-11 21.2.5. Diagnostics complémentaires pour les erreurs de l’interface SNA................................ 21-11

21.3. Réseau TCP/IP ....................................................................................................................... 21-11

21.3.1. Présentation.................................................................................................................... 21-11



Table des Matières

CFT V2.3x

21.3.2. Erreur locale TCP/IP L NN PPP .................................................................................... 21-12 21.3.3. Erreur réseau TCP/IP R SSSSSS ................................................................................... 21-12 21.3.4. Diagnostics complémentaires pour les erreurs de l’interface TCP/IP............................ 21-12

21.4. Codes erreur réseau SNA LU 6.2........................................................................................... 21-12

21.4.1. Erreur locale SNA LU 6.2 : L NN PPP.......................................................................... 21-12 21.4.2. Erreur réseau SNA LU 6.2 : R HPPPSSSS HNNNNNNN............................................ 21-13 21.4.3. Diagnostics complémentaires pour les erreurs de l’interface SNA LU 6.2 ................... 21-13

21.5. Erreur réseau 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 réseau 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 systèmes CFT/MVS..............................22-1

22.1. Présentation.............................................................................................................................. 22-1

A. Mise en oeuvre spécifique ...................................................................................................A-1

A.1. Environnement système ..............................................................................................................A-1

A.1.1. Création 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. Procédures CFT...........................................................................................................................A-2

B. Paramétrage spécifique....................................................................................................... B-1

B.1. Tableau des valeurs spécifiques...................................................................................................B-1

B.2. Fichiers transférables...................................................................................................................B-1

B.3. Codification des noms de fichiers................................................................................................B-3

B.3.1. Noms des fichiers ................................................................................................................B-3



CFT V2.3 xi

Liste des Tableaux

Tableau 1. Format du support magnétique d’installation CFT V2.3.0...................................................... .............2-2 Tableau 2. Format du support CD d’installation CFT V2.3.0 .................................................. ..............................2-2

Tableau 3. Format du support magnétique d’installation à partir de la version 2.3.1 de CFT................................2-2

Tableau 4. Format du support CD d’installation à partir de la version 2.3.1 de CFT.............................................2-3

Tableau 5. Taille et format des fichiers d’installation ........................................................ ....................................2-3

Tableau 6. Taille et format des fichiers d’installation ........................................................ ....................................2-4

Tableau 7. Liste des mots-clés ............................................................ ......................................................... ..........4-6

Tableau 8. Liste des mots-clés ............................................................ ......................................................... ..........5-6

Tableau 9. Description du paramétrage de l’agent XFBIUI......................................................................................7-7

Tableau 10. Liste des mots-clés ................................................................ .................................................... ..........10-2

Tableau 11. Liste des mots-clés ................................................................ .................................................... ..........11-2

Tableau 12. Contenu de la bande d’installation ................................................... .................................................. 12-1

Tableau 13. librairies prises en compte lors du DUMP ADRDSSU ......................................................... .............13-1

Tableau 14. Réalisation des exits en assembleur 370.............................................................................................15-4

Tableau 15. Exemples pour la réalisation d’un exit annuaire en C .......................................................... ..............15-5

Tableau 16. Réalisation des exits en COBOL...................................................................... ..................................15-8

Tableau 17. Règles d’interprétation du DSNGEN ........................................................... ......................................18-9

Tableau 18. Performances des utilitaires : utilisation de la mémoire ............................................................. ......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 système 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 réseau 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



Liste des Tableaux

CFT V2.3xii

Tableau 36. Principaux codes erreur ou ABEND .................................................... .............................................. 22-1

Tableau 37. Valeurs spécifiques...................................................... .............................................................. ........... B-1

Tableau 38. Valeurs spécifiques : défauts pour CFTUTIL ......................................................... ............................. B-1

Tableau 39. Caractéristiques de fichiers retrouvées automatiquement ou non à l’émission .................................... B-1

Tableau 40. Combinaisons de FTYPE et FRECFM à l’émission ............................................................ ................ B-2 Tableau 41. Valeurs de FORG, FTYPE et FRECFM à la réception ................................................................ ........ B-2



CFT V2.3 1-1

1. Caractéristiques 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 réside en permanence dans un espace adresse. Plusieurs demandes de transfert peuvent êtretraitées simultanément par CFT qui, dans sa région, crée et gère le nombre de tâches approprié.

1.2. Origines des demandes de transfert

Les demandes de transfert peuvent être adressées à CFT à partir de :

· commandes opérateur depuis un écran TSO ou depuis la console système,

· travaux batch,

· programmes utilisateurs,

· interface utilisateur,

· interface Internet XFB.IUI.

CFT gère l’ensemble des transferts qui lui sont demandés à l’aide d’un fichier, “le catalogue CFT”.

Dans ce “catalogue”, CFT enregistre les caractéristiques de chaque transfert :

· l’émission ou réception,· le transfert en attente, en cours, interrompu ou terminé,

· les noms des partenaires,

· l’identifiant logique des données,

· le nom physique du fichier,

· l’heure de lancement de la commande,

· l’heure de fin du transfert,

· le nombre d’enregistrements transmis...

Ce catalogue peut être interrogé à partir d’un terminal TSO, un browser Internet ou depuis un programme utilisateur.

1.3. Transferts en parallèle

CFT peut gérer plusieurs transferts en parallèle avec un ou plusieurs interlocuteurs. Pour cesdifférents transferts, CFT peut mettre en œuvre différents protocoles.

Les protocoles supportés par CFT sont les suivants :

· PeSIT

· ODETTE,

· ETEBAC 3.



Caractéristiques de CFT en environnement MVS

CFT V2.31-2

1.4. Description de l’environnement CFT

CFT travaille à l’aide des fichiers suivants :

· un fichier des paramètres :ce fichier décrit les paramètres de fonctionnement.Il est de type VSAM KSDS,

· un fichier des partenaires :ce fichier décrit les destinataires et les émetteurs de fichiers transférés.Il est de type VSAM KSDS,

· un fichier catalogue :ce fichier enregistre toutes les opérations de transfert de fichiers.Il est de type VSAM ESDS,

· deux fichiers journaux :ces fichiers enregistrent tous les événements chronologiques d’exploitation de CFT

Version 2.Ils sont de type séquentiel,

· deux fichiers comptables facultatifs :ces fichiers enregistrent les statistiques d’exploitation de CFT Version 2.Ils sont de type séquentiel,

· un ou deux fichiers de communication :ces fichiers enregistrent les demandes adressées à CFT Version 2, en batch, depuis TSO oudepuis l’interface interactive.Ils sont de type VSAM ESDS,

· plusieurs fichiers d'images écrans.Ils sont de type VSAM KSDS,

· un fichier de configuration utilisateur par défaut.Il est de type séquentiel,

· 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 paramétrage de l’option XFB/SCOPE [XFB/CFT.230],

· un ensemble de fichiers de paramétrage de l’option XFB/SENTINEL [XFB/CFT.231],

· un fichier de paramétrage du serveur CFTIUI,

·

une base de données de sécurité, facultative,· une librairie d’exécutables de format PDSE (DSNTYPE=LIBRARY) [XFB/CFT.2.31].



CFT V2.3 2-1

2. Besoins matériels et logiciels, préparation del’installation

2.1. Besoins matériels

2.1.1. Processeurs et versions de OS/390

CFT/MVS est supporté par les systèmes IBM d’architecture ESA, dans les environnementsOS/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é d’installer CFT/MVS sur le système cible, ou a défaut une version inférieure dusystème Z/OS.

2.1.2. Unités d’entrée/sortie

Une cartouche est nécessaire pour la restauration des fichiers par l’utilisateur.

De l'espace disque est nécessaire pour recevoir les modules objets, les procédures et les exemplesde CFT/MVS.

L’installation est également possible à partir d’une station de travail (Windows, UNIX, Linux,...)

équipée d’un lecteur de CD.

2.2. Besoins logiciels

En fonction des besoins de l’exploitation, CFT/MVS utilise les produits ci-dessous à partir de laversion indiquée :

· architecture SNA (Protocoles lu62, lu0, lu2) :

- ACF-VTAM (MVS) : Version 4 ou supérieure,

- ACF-NCP : 5735-XX9,

· réseau X25 :

- X25-NPSI : 5668-981,

· réseau TCP/IP :

- eNetwork Communication services TCP/IP dans la version de OS/390,

- UNICENTER TCPACESS version 5.2 et supérieure,

· environnement d'exécution :

- Language Environment dans la version de Z/os ou en version V2R10,

· applications de CFT sous CICS :

- CICS toutes versions,



Besoins matériels et logiciels, préparation de l’installation

CFT V2.32-2

· interfaces de programmation et EXITS :

- Cobol for OS/390,

- C for OS/390.

2.3. Format du support d’installation CFT V2.3.0

CFT/MVS est livré sur un support magnétique contenant les fichiers suivants, indiqués dans letableau ci-dessous.

Tableau 1. Format du support magnétique d’installation CFT V2.3.0

Fichier Position Contenu

INSTALL 1 Exemple de JCL d’installation

SAMPLE 2 Exemples de paramétrage, de procédures

OBJ 3 Modules OBJET

PFTOBJ 4 Modules OBJET mis à jour DOC 5 Documentation d’installation et de mise à jour

CNTL 6 Fichiers de contrôle

MAC 7 Macros d’installation

SCR 8 Formats des écrans, messages, exemples SSL, composants XML

CFT/MVS est livré également sur un support CD, dont le répertoire d’installation contient lesfichiers suivants.

Tableau 2. Format du support CD d’installation CFT V2.3.0

Fichier Contenu

CFTV2.INSTALL Exemple de JCL d’installation

CFTV2.SAMPLE Exemples de paramétrage, de procédures

CFTV2.OBJ Modules OBJET

CFTV2.PFTOBJ Modules OBJET mis à jour

CFTV2.DOC Documentation d’installation et de mise à jour

CFTV2.CNTL Fichiers de contrôle

CFTV2.MAC Macros d’installation

CFTV2.SCR Formats des écrans, messages, exemples SSL

2.4. Format du support d’installation à partir de la version 2.3.1

CFT/MVS est livré sur un support magnétique contenant le fichier suivant.

Tableau 3. Format du support magnétique d’installation à partir de la version 2.3.1 de CFT


INIT 1 JCL(s) d’amorce de l’installation + Produit XFB/CFT sous la

forme (XMIT + ADRDSSU)



CFT/MVS Guide d'exploitation

CFT V2.3 2-3

CFT/MVS est livré également sur un support CD, dont le répertoire d’installation contient lesfichiers suivants.

Tableau 4. Format du support CD d’installation à partir de la version 2.3.1 de CFT

Fichier Contenu

MVS-CFT-2.3.1-tag-date Produit sous le format XMIT / ADRDSSU) jclins.txt JCL de mise en place du produit

ftp.prm Exemple de paramètres 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 d’installation XFB/CFT V2.3.0

CFT/MVS nécessite une capacité disque de 300 cylindres de 3390. Cette capacité de stockage estrépartie entre les diverses bibliothèques CFT comme indiqué dans le tableau ci-dessous.

Tableau 5. Taille et format des fichiers d’installationFichier Allocation

INSTALL SPACE = (3120, (225, 225, 40) )

SAMPLE SPACE = (3120, (225, 225, 40) )

OBJ SPACE = (3120, (18000, 5000, 120) )

PFTOBJ SPACE = (3120, (5000, 5000, 40) )

DOC SPACE = (3120, (225, 225, 40) )

CNTL SPACE = (3120, (225, 225, 40) )

MAC SPACE = (3120, (225, 225, 30) )

SCR SPACE = (3120, (5000, 500, 40) )

Les tailles sont définies dans le JCL A10ALLOC.

L’installation depuis un CD nécessite environ 300 cylindres disque 3390 d’espace temporairesupplémentaire.



Besoins matériels et logiciels, préparation de l’installation

CFT V2.32-4

2.6. Taille et format des fichiers d’installation 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 reflète l’image du produit lors desa mise en place enrichie des ‘upgrades’ successifs. L’environnement ‘Target’ ou cible correspondà celui de l’utilisateur qui sera personnalisé.

Tableau 6. Taille et format des fichiers d’installation

Fichier Environnement Allocation

INSTALL Distribution + Target SPACE = (3120, (225, 225, 40) )

SAMPLE Distribution SPACE = (3120, (225, 225, 40) )

OBJ Distribution SPACE = (3120, (10000, 5000, 120) )

PFTOBJ Distribution SPACE = (3120, (5000, 5000, 40) )

DOC Distribution SPACE = (3120, (225, 225, 40) )

CNTL Distribution SPACE = (3120, (225, 225, 40) )MAC Distribution SPACE = (3120, (225, 225, 30) )

SCR Distribution SPACE = (3120, (5000, 500, 40) )

OBJSAS Distribution SPACE = (3120, (2000, 2000, 200) )

OBJIBM Distribution SPACE = (3120, (2000, 2000, 200) )

EXEC Target SPACE = (3120, (195, 195, 30) )

XMLLIB Target SPACE = (3120, (50, 5, 10) )

CERTIF Target SPACE = (3120, (50, 5, 10) )

DLL Distribution + Target SPACE = (3120, (1000,1000,50) )

LOAD Target (DSNTYPE=LIBRARY) SPACE = (CYL, (150,50,30) )

UPLIB Distribution SPACE = (CYL, (50,50,90) )

Les tailles sont définies dans le JCL JCLINS [CFT-2.31].

L’installation depuis un CD nécessite environ 300 cylindres disque 3390 d’espace temporairesupplémentaire.




CFT V2.3 2-5

2.7. Composants de CFT/MVS

Les différents composants de CFT/MVS sont :

· CFTUTIL : programme batch de traitement des commandes et paramètres,· CFTMAIN : moniteur de transfert de fichiers, composé lui-même de :

- CFTTPRO : protocoles de transfert de fichiers (PESIT, ETEBAC, ODETTE...),

- CFTTFIL : gestionnaire des fichiers,

- CFTTCP : gestionnaire de réseau TCP/IP,

- CFTTLOG : gestionnaire du journal,

- CFTTCOM : gestionnaire des fichiers de commandes,

- CFTTCOMS : gestionnaire de commandes en mode synchrone, [CFT.231],

- CFTSNA : interface réseau SNA (LU0, LU2, LU6.2),- CFTX25 : interface réseau X25,

- CFTOPER : interface console opérateur,

· CFTINT : interface interactive TSO,

· CFTAPI : interface de programmation utilisateur en batch,

· CFTXMEM : serveur de communications MVS/ESA,

· CFTI : programme CICS d’interrogation du catalogue,

· CFTC : programme CICS de commandes,

· CFTINTV/CFTINT31 : interface utilisateur sous VTAM,

· VFMUTIL : utilitaire de gestion de fichiers VFM,

· CFTXNTF/XFBSCOPE : service d’administration centralisée de CFT [XFB/CFT.230],

· CFTTRK : service d’administration centralisée de CFT [XFB/CFT.231],

· CFTIUI : interface utilisateur à distance sur technologies Internet,

· CFTTSSL : interface d’authentification forte des partenaires et dechiffrement des données,

· CFTPKI : : utilitaire de gestion de la base de donnée de sécurité.



CFT V2.3 3-1

3. Codification des noms de fichiers de CFT/MVS

3.1. Accès aux fichiers

CFT/MVS accède en lecture ou en écriture aux fichiers suivants :

· les fichiers séquentiels disque,

· les fichiers séquentiels disque multivolumes,

· les fichiers PDS,

· les fichiers en GENERATION DATA GROUP (GDG),

· les fichiers VSAM KSDS,

· les fichiers VSAM ESDS

· les fichiers hiérarchiques HFS.

CFT/MVS crée, supprime et renomme les fichiers suivants par appel à IDCAMS :

· les fichiers VSAM KSDS,

· les fichiers VSAM ESDS.

CFT/MVS ne sait pas transférer les fichiers suivants :

· les fichiers VSAM RRDS,

· les fichiers VSAM LINEAR,

· les fichiers concaténés,

· les fichiers sur bande magnétique.

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 caractéristiques suivantes :

- indique le nom du volume disque sur lequel le fichier est créé ou recherché,

- facultatif mais utile pour demander à CFT la création d’un fichier VSAM ou non,hors SMS,

- correspond au paramètre VOLUME du DEFINE CLUSTER VSAM ouVOL=SER= du JCL,

- déconseillé avec DF/SMS,



Codification des noms de fichiers de CFT/MVS

CFT V2.33-2

· pour UNIT, les caractéristiques suivantes :

- indique le UNITNAME utilisé,

- facultatif mais utile pour un fichier SAM bande ou disque,

- correspond au paramètre UNIT= du JCL,

- par défaut, la valeur SYSALLDA ou la valeur forcée par votre EXIT DYNALLOCsera utilisée,

· pour NOM1.NOM2.NOMx, les caractéristiques suivantes :

- définit le nom du fichier,

- obligatoire.

· le nom des fichiers HFS commence par le caractère ‘/’.

Exemples :

CFTVOL%%NOM.DU.FICHIER%3390%NOM.DU.FICHIER

%%NOM.DU.FICHIERNOM.DU.FICHIER/path/file.extension

Remarque :les deux caractères ‘%’ sont obligatoires uniquement si le paramètre VOLUME ou le paramètreUNIT est spécifié.

3.2.1. Codification des paramètres SMS

CFT/MVS permet une codification limitée de certains paramètres SMS dans le paramètre UNIT.

Les valeurs possibles sont :

· >STORCLA : permet de spécifier une valeur de STORAGE-CLASS dont le nom estlimité à 7 caractères,

· <DATACLA : permet de spécifier une valeur de DATA CLASS dont le nom est limitéà 7 caractères,

· *MGTCLAS : permet de spécifier une valeur de MANGEMENT CLASS dont le nomest limité à 7 caractères.

Remarque : la limitation à 7 caractères sera levée dans une prochaine version.

3.3. Codification des noms de fichiers avec DDNAME

CFT/MVS utilise la codification suivante pour faire référence à un DDNAME déclaré dans le JCL :

FNAME=$DDNAME

Exemple :

FNAME=$CFTCAT




CFT V2.3 3-3

3.4. Codification des noms de fichiers PDS

CFT/MVS manipule les fichiers PDS :

· membre par membre, séquentiellement,· par appel à IEBCOPY UNLOAD :

- pour la totalité du PDS en codant : FNAME=#DSNAME,

- pour une sélection d'un sous-ensemble de membres, en utilisant les caractères '*' pour remplacer une chaîne de caractères ou '?' pour remplacer un caractère, encodant : 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 concaténation de toutes les versions d’un fichier GDG n’est pas permise par CFT/MVS.

3.6. Création dynamique des fichiers CFT/MVS

Tous les fichiers créés par CFT sont catalogués.

Les fichiers SAM sont créés par DYNALLOC.

Les fichiers VSAM sont créés par appel dynamique à IDCAMS.

Les fichiers PDS sont créés avec ’BLKPDS’ blocs de directory. BLKPDS est une option du JOBA12OPTS d’installation de CFT. Sa valeur par défaut est 150.

Les fichiers GDG ne peuvent être créés que si le ‘PATTERN DSCB’ existe.

L’espace primaire est calculé à partir de la taille en Ko indiquée dans le paramétrage ou annoncée par le partenaire. L’espace secondaire est égal à 10 % du primaire.

Le BLKSIZE est :

· soit calculé en fonction de la valeur indiquée dans le paramétrage,

· soit annoncé par le partenaire (en PESIT profil CFT et ANY),

· ou encore calculé à partir de ‘BLKSIZE’ défini dans le JOB A12OPTS.

L’allocation du fichier sera sous la forme :SPACE=(BBBB,(PPPP,SSSS)),DCB=(BLKSIZE=BBBB), avec :

· BBBB : valeur de BLKSIZE calculée,

· PPPP : allocation primaire,

· SSSS : 10 % de PPPP.




CFT V2.33-4

CFT/MVS crée des fichiers multivolumes à travers les 'ACS ROUTINES' de DF/SMS. La tailletotale étant demandée dans l’allocation primaire, il est nécessaire d’utiliser une "DATACLASS"décrivant des fichiers "striped". Pour plus de détails, reportez-vous à la documentation IBM deréférence "DFSMSDP Storage Administration Référence".

3.6.1. Création dynamique de fichiers multivolumes

La création dynamique de fichiers multivolumes est une nouvelle fonction permettant la réceptiondes très "gros" fichiers. Elle est complémentaire au support existant à travers SMS.

Ce dispositif est appelé automatiquement quand :

· la création du fichier échoue par manque de place ou demande de plus de 65.535 pistessur un volume « NON EXTENDED FORMAT »,

· le paramètre ‘VOLUME’ n’est pas renseigné. La présence du paramètre permet dedésactiver ce dispositif.

DYNALLOC est appelé jusqu’a 19 fois supplémentaires avec :

· la demande d'un volume supplémentaire,

· le calcul de l’allocation primaire PPPP divisée par le nombre de volumes.

Puis CFT/MVS réserve l’espace demandé sur les volumes attribués. Si la réservation échoue pour un volume, la création du fichier est rejetée avec un code erreur de la forme ‘xxxxxE37’.

La codification de fname=’%+nnn%DSNAME’ ou nnn est une valeur numérique comprise entre 2et 127, permet de demander directement la création d’un fichier multivolumes:

· si nnn est inférieur à 20, l’allocation sera re-tentée jusqu’a la limite de 20 volumes,

· si nnn est supérieur à 20, une seule tentative est effectuée.

3.7. Suppression et RENAME des fichiers CFT/MVS

Tous les fichiers supprimés par CFT sont décatalogués.

Les fichiers SAM sont supprimés/renommés par CAMLST.

Les membre de PDS sont supprimés/renommés par STOW.

Les fichiers VSAM sont supprimés/renommés par appel dynamique à IDCAMS.

Lors du RENAME d'un fichier, CFT/MVS libère 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 paramètre CFTRECV MACTION=REPLACE commande le remplacement de membres defichiers PDS reçus.

Le paramètre CFTRECV MACTION=REPLACE commande le remplacement des fichiers reçusdans un DUMP de l’utilitaire ADRDSSU.




CFT V2.3 3-5

3.8. Partage des fichiers CFT/MVS

Les fichiers VSAM du moniteur CFT sont alloués en DISP=SHR.

Les fichiers de transfert en lecture sont alloués en DISP=SHR. Les fichiers en écriture sont allouésen DISP=OLD.

3.8.1. Protection multisystèmes GRS de CFT/MVS

CFT utilise le QNAME 'CFTFILES' pour la protection des fichiers transférés par ENQ.

Il n'est pas nécessaire de propager les ENQ 'CFTFILES' à tous les systèmes du 'RING GRS'.

En configuration multi-CPU ou SYSPLEX, il est nécessaire de propager uniquement le QNAME"CFTSHARE" à tous les systèmes du RING GRS.

3.9. Fichiers hiérarchiques HFS

Les fichiers HFS sont des fichiers dont l’architecture de données est consécutive et non structuréeen enregistrements et en blocs. Ces fichiers sont installés dans des espaces disques hiérarchisés,compartimentés conformément à la normalisation UNIX en répertoires (directory) et en sous-répertoires (sous-directory).

Les fichiers HFS sont gérés par les applications qui se déroulent dans un environnementUNIX/OMVS, ou par celles qui utilisent les services d’USS (UNIX System Services) commeinterface de gestion et d’accès.

CFT/MVS accepte uniquement le nom complet depuis le répertoire racine. Tous les éléments participant à l’élaboration d’un nom de fichier sont séparés par des ‘/’.

Les caractéristiques des fichiers MVS, comme le format (RECFM), la taille d’un enregistrement(LRECL) et la taille d’un bloc (BLKSIZE) sont sans objet pour un fichier HFS. CFT se basecependant sur ces caractéristiques pour assurer, pour un transfert, la gestion des données et latransmission des caractéristiques du fichier vers le destinataire. Le paramétrage doit donc tout particulièrement tenir compte de ces caractéristiques lorsqu’elles seront véhiculées entre partenaires hétérogènes.

Les fichiers HFS sont accessibles uniquement en vue de transfert par le moniteur CFT/MVS, àl’exclusion de tout autre usage dans les différents modules de XFB/CFT.

Remarques :

·

l’envoi générique de fichiers HFS n’est pas supporté,· la fonction COPYFILE de l’utilitaire CFTUTIL n’est pas opérante dans le cadre des

fichiers HFS.

3.9.1. Noms de fichiers HFS

Les noms de fichiers codés dans les paramètres FNAME, WFNAME et NFNAME doivent êtreconformes aux usages employés pour l’identification des fichiers sous UNIX.Pour respecter la codification des noms de fichier en minuscules et/ou majuscules, les valeursassociées aux paramètres FNAME et NFNAME devront être codées entre guillemets.

Exemple : FNAME= "/home/qualcft/recv/Recv.Fichier.Minuscul".




CFT V2.33-6

3.9.2. Caractéristiques des fichiers HFS

Les fichiers HFS sont caractérisés par un type particulier selon qu’ils contiennent du texte(structuré) ou du binaire (non structuré).

Le type du fichier est véhiculé par les paramètres FTYPE et NTYPE.

Les valeurs attribuées à TYPE sont les suivantes :

· T : fichier « texte ».Ce fichier est structuré, les enregistrements logiques sont délimités, les données sonttraitées en mode enregistrement par CFT,

· B : fichier « binaire ».Ce fichier n’est pas structuré, les données sont traitées en flot continu par CFT.

En l’absence de ce paramètre, le type de fichier « binaire » est pris par défaut.

3.9.3. Interprétation des caractéristiques RECFM/LRECL/BLKSIZE

Ces caractéristiques conservent leur portée lorsqu’elles sont véhiculées entre partenaireshétérogènes.

CFT se base sur ces caractéristiques pour assurer, pour un transfert, la gestion des données.

Le paramétrage doit donc tout particulièrement tenir compte des remarques suivantes :

· le format du fichier (FRECFM et NRECFM) est interprété par CFT pour adopter uneméthode d’échange des données. En cas d’absence de ce paramètre, la valeur prise par défaut est "V",

· la taille d’un enregistrement logique (FLRECL et NRECL) est interprétée par CFT pour adapter la taille des articles échangés. En cas d’absence de ce paramètre, la valeur prise par défaut est "4096",

· la taille d’un bloc (FBLKSIZE et NBLKSIZE) est ignorée et est mise à "0".

3.9.4. Propriétaire et droits d’accès aux fichiers HFS

La propriété d’un fichier HFS est caractérisée par un ‘UID’ (numéro d’utilisateur), un ‘GID’(numéro de groupe) et une chaîne donnant les droits d’accès.

CFT/MVS gère la propriété et les droits d’accès de deux manières :· CFT/MVS est un programme autorisé, le paramètre USERCTRL est à YES.

Dans ce cas, les fichiers sont créés/lus/écrits avec les droits de l’utilisateur demandeur.Ce mode opératoire est recommandé,

· sinon, les fichiers HFS sont créés/lus/écrits avec les droits du moniteur CFT/MVS.Il est recommandé de donner au moniteur CFT un UID différent de "0".

Lorsqu’un transfert en réception aboutit à la création d’un fichier HFS, celui-ci est créé avec lachaîne d’accès ‘-rwxr-xr-x’.

Avant de créer un fichier, CFT/MVS vérifie que la place nécessaire est disponible dans le ‘File-System’. Sinon, la création est refusée avec un code erreur ‘00F00B37’.

CFT/MVS manipule les fichiers HFS de taille inférieure à 2 téra-octets.




CFT V2.3 3-7

Le changement du nom d’un fichier HFS s’opère exclusivement dans le même répertoire.Le chemin d'accès du fichier décrit dans le paramètre FNAME doit être identique à celui renseignédans le paramétrage WFNAME.

3.9.5. Message d’erreur spécifique HFS

CFT/MVS affiche dans la SYSLOG un message spécifique ‘CFTHF01E’ pour chaque erreur d’accès 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 l’erreur.

Avec :

· RSN=xxxxxxxx : reason code retourné, expliqué dans la brochure IBM UNIX System

Services « Messages & Codes »,

· RC= : code retour sous forme mnémonique (numérique) et abrégée.Il est expliqué dans la brochure IBM déjà citée.



CFT V2.3 4-1

4. Installation de CFT/MVS Version 2.3.0

4.1. Installation de CFT/MVS

La procédure suivante indique les principales étapes de cette installation :

1. Définition d’un ALIAS CFT Version 2 (facultatif).

2. Restauration de la bibliothèque d’installation.

3. Alternativement transfert des fichiers d’installation depuis un CD.

4. Adaptation des jobs d’installation aux standards de l’exploitation.

5. Allocation des fichiers d’installation.

6. Restauration des fichiers contenus sur la bande.

7. Soumission des jobs d’installation.

8. Paramétrage de CFT version 2.

9. Personnalisation des procédures CFT version 2.

4.2. Définition d’un ALIAS CFT version 2

Si les noms de fichiers mentionnés dans les différents jobs d’installation sont conservés par

l’exploitation, il est possible de créer un “ALIAS” CFTV2 dans un USER CATALOG, défini de lamanière 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 paramètres en gras sont à adapter à votre environnement.



Installation de CFT/MVS Version 2.3.0

CFT V2.34-2

4.3. Restauration de la bibliothèque d’installation

L’utilisateur de CFT/MVS trouvera, ci-dessous, un exemple de JCL à utiliser pour restaurer les

fichiers d’installation 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/*//


Le nom de volume SOPnnn figure sur l’étiquette de la cartouche.

4.3.1. Transfert des fichiers d’installation depuis un CD

L’utilisateur peut recharger les fichiers indifféremment depuis une K7 ou un CD. Les fichiersinstallés sont alors interchangeables.

4.3.1.1. Configuration nécessaire

Pour procéder à l’installation de CFT/MVS livré sur CD-ROM, l’utilisateur doit disposer :· d'une station de travail équipée d’un lecteur de CD-ROM,

· d'un logiciel client FTP permettant le transfert de fichiers vers le HOST MVS,

· d'un réseau TCP/IP de performances suffisantes pour transférer environ 150 méga-octetsde données (1 mégabit/seconde est souhaitable).

Pour réaliser l’installation de CFT/MVS, les étapes suivantes sont déroulées :

1. Transfert du CD-ROM vers MVS, par FTP, des 8 fichiers de livraison.Cette étape nécessite environ 200 cylindres 3390 d’espace disque côté MVS.

2. Décompression et rechargement des fichiers d’installation.Cette étape nécessite environ 300 cylindres supplémentaires d’espace disque.




CFT V2.3 4-3

4.3.1.2. Transfert des fichiers d'un CD par FTP

Les fichiers de livraison se trouvent sous le répertoire « install » du CD-ROM.

Pour les transférer vers MVS, vous devez procéder de la manière suivante :1. Ouvrir une session FTP par la commande FTP "your.mvs".

2. Fournir le USERID et le mot de passe de l’utilisateur TSO qui procédera à l’installationde CFT/MVS.

3. Conserver l’option par défaut ou choisir le "QUALIFIER" des fichiers MVS.

Par défaut le "QUALIFIER" sera le USERID TSO.Pour changer de "QUALIFIER", utiliser les commandes FTP CD et MKDIR.

4. Positionner les 2 options FTP¨suivantes :

BINARY

QUOTE SITE RECFM=FB LRECL=80 BLKSIZE=3120 CYL PRIMARY=100 SECONDARY=50

(ces 2 options sont impératives).

5. Transférer les 8 fichiers par la commande mput cftv2.* et répondre "yes" à chaquedemande 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 créés ou remplacés selon le cas.

Les 8 fichiers sont nommés "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. L’utilisation de FTP est terminée, l’utilisateur peut fermer la session.




CFT V2.34-4

4.3.1.3. Décompression des fichiers de livraison par CD

Les fichiers de livraison sont transformés en bibliothèques d’installation par la commande TSORECEIVE.

Depuis votre session TSO :

1. Faire la liste des 8 fichiers transférés, puis passer sur le premier de la liste lacommande : RECEIVE INDSNAME(/).

Au message "INMR906A Enter restore parameters or 'DELETE' or 'END' +", par défaut le nom du fichier sera : CFTV2.Cnnn.CNTL.

Pour en changer, répondre 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'" apparaît, alors répondre ‘R’ pour remplacer les membres identiques

(à répéter pour les 8 fichiers).Les 8 fichiers d’installation sont rechargés à l’identique d’une K7 de livraison.L’utilisateur peut poursuivre l’installation à l’étape A00CUSTO.

L’utilisateur peut également détruire les 8 fichiers de livraison transférés par FTP, cesderniers étant devenus inutiles.

4.4. Adaptation des JOB d’installation à l’exploitation

Les JOB contenus dans cette bibliothèque sont les suivants :

· 1 : A00CUSTO : personnalisation des jobs d'installation,

· 2 : A10ALLOC : allocation des fichiers,

· 3 : A11REST : restauration du reste de la bande,

· 4 : A12OPTS : choix des options de fonctionnement de CFT version 2,

· 5 : B20LINK : LINK-EDIT général des modules CFT,

· 6 : B22LTCP : LINK-EDIT spécifiques à TCP/IP,

· 7 : B24CICS : LINK-EDIT de l’interface de programmation CICS,

· 8 : C31SCRxx : allocation des fichiers des écrans (Français et/ou Anglais),

· 9: C32XMEM : allocation du fichier de sauvegardes des communications,

· 10 : C33CNFxx : allocation du fichier de configuration (Français et/ou Anglais),

· 11 : C33MON : allocation du fichier des moniteurs,

· 12 : D40INIT : initialisation des fichiers d’exécution de CFT Version 2,

· 13 : D41AIX1 : définition de l’index alterné du catalogue,

· 14 : D41AIX2 : construction de l’index alterné du catalogue,

· 15 : D42SSL : création d'une base de données expérimentale de clés et decertificats SSL,

· 16 : D43PKI : création d'une base de données PKI,

·

17 : E50PARM : fourniture d'un exemple de paramétrage CFTPARM,




CFT V2.3 4-5

· 18 : F60VFMC : fourniture d'un exemple de création de base VFM,

· 19 : G70VTAM : fourniture d'un exemple de paramétrage de VTAMLST,

· 20 : G71LOGM : fourniture d'un exemple de MODETAB utilisée par CFTVersion 2,

·

21 : H80EXEC : création de procédures (fin de transferts, bascule log...) CFTVersion 2,

· 22 : I90VALID : validation de l'installation de CFT Version 2.

· 23 : NT00CUST : personnalisation des jobs d'installation de XFB.Scope,

· 24 : NT10LMQS : LINK EDIT spécifique de l’agent utilisé par A&P 2,

· 25 : NT20DEF : définir et initialiser les fichiers tampons et des messages utilisés par XFB.Scope.

Ces jobs doivent être exécutés dans l’ordre indiqué ci-dessus.

Dans les paragraphes suivants, l’utilisateur de CFT/MVS trouvera en quelques mots la descriptionde la/des fonctions de ces jobs.

4.5. Personnalisation des fichiers d’installation de CFT/MVS (A00CUSTO)

Ce JOB personnalise les fichiers d’installation.La personnalisation se fait directement dans la bibliothèque d'installation. Il est nécessaire deQUITTER l’éditeur après 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 numbermsgclass 'R' 04 Message classclass 'P' 05 Execution classjobparm '/*JOBPARM ROOM=CFTx' 06 Job parm (//* if none)tape '3490' 07 Tape unittapvol 'SOPnnn' 08 Tape volumecftvol 'CFTVOL' 09 CFT library volumecftunit '3390' 10 CFT library unitcftv2 'CFTV2' 11 CFT data set prefixsysout 'L' 12 Sysout classtcpsns 'SNSTCP' 13 INTERLINK tcp/ip library prefix

tcpibm 'TCPIP' 14 IBM tcp/ip library prefix




CFT V2.34-6

lever 'YES' 15 Le/370 version YES or NOle370 'CEE' 16 Le/370 data set prefixc370 '**’ 17 Not used (C/370 DS prefix)sysda 'VIO' 18 SYSUTx UNIT= VIO or SYSDA cicscob 'DFH' 19 Cics cobol library prefixcicslod 'DFH' 20 Cics loadlib library prefix

cobol2 'SYS1.COB2' 21 Cobol 2 library prefixacbint 'CFT2INT' 22 Vtam acbname for cftintdisc '1441' 23 Disconnect delay for cftint userlang 'FR' 24 CFT screen language (FR or UK)

@@


Les mots-clés doivent rester en minuscule.

La valeur de ces mots-clés doit figurer entre apostrophes.

L'ordre des mots-clés ne doit pas être modifié.

L’utilisateur doit :

1. Soumettre ce JOB.

2. Quitter EDIT.

3. Attendre la fin d’exécution du JOB.

L'explication des différents mots-clés est indiquée dans le tableau suivant.

Tableau 7. Liste des mots-clés

Mot-clé Explication

Jobname Nom du job avec lequel seront soumis les JCL d'installation

Userid Nom de l'utilisateur avec lequel seront soumis les JCL d'installationAccount "Account Number" avec lequel seront soumis les JCL d'installation

Msgclass Classe de sortie des messages

Class Classe d'exécution des JCL d'installation

Jobparm Paramètres relatifs aux jobs d'installation pour JES2( //* si inexistant)

Tape Type d'unité utilisée pour restaurer les bibliothèques d'installation

Tapvol Nom du volume utilisé pour restaurer les bibliothèques d'installation

Cftvol Nom du volume de création des fichiers CFT/MVS

Cftunit Type d'unité disque

Cftv2 Alias de création des fichiers CFT/MVS

Sysout Classe de sortie des comptes rendus d'exécution

Tcpsns Alias des bibliothèques TCP/IP INTERLINK Tcpibm Alias des bibliothèques TCP/IP IBM

Lever Utilisation de LE/370 (YES/NO)

le370 Alias des bibliothèques LE/370

c370 Alias des bibliothèques C/370 (Inutilisé)

sysda UNITNAME des fichiers temporaires de LINK-EDIT (VIO/SYSDA)

Cicscob Alias des bibliothèques CICS pour COBOL

cicslod Alias des bibliothèques CICS

cobol2 Alias des bibliothèques COBOL 2

acbint Nom de l'ACB utilisé pour les interfaces interactives sous VTAM

disc Timer de déconnexion pour les interfaces interactives sous VTAM

lang Langage utilisé ( FR ou UK) dans les interfaces interactives




CFT V2.3 4-7

Remarque :les paramètres 25 à 32 sont utilisés uniquement avec le dispositif «Sécurité d’exploitation de CFT»et sont décrits dans le «Guide des habilitations» CFT/MVS.

4.5.1. Création des fichiers d’installation de CFT/MVS (A10ALLOC)

Ce JOB crée les fichiers d’installation.

4.5.2. Restauration de la bande d’installation de CFT/MVS (A11REST)

Ce JOB restaure les fichiers de la bande d’installation.

Attention : après avoir restauré la bande d’installation, il est nécessaire de lire le membre"IMPORTAN" du fichier CFTV2.DOC. Ce dernier contient les dernières mises à jour relatives àl’installation ou à l’utilisation de CFT Version 2.

Dans le cas où une bande de corrections est livrée, il faut alors exécuter une seconde fois cetteétape pour lire la bande de correction en complément de la bande d'installation.

Les fichiers d’installation sont rechargés à l’identique quel que soit le type de support delivraison : K7 ou CD. L’utilisateur 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 génère la tables des options de CFT/MVS.

SYST = MVS

Type de système 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 défaut ROUTCDE=X‘0008’ correspond au ROUTCDE=(13).

Cette valeur sera utilisée en liaison avec l’option ‘OPERMSG’ du paramètre ‘CFTLOG’.

Pour les options DESC et ROUTCE, consulter la brochure IBM “Supervisor services and macros” pour l’utilisation des DESCRIPTOR CODES et ROUTCODES.

[MAXAB = {15 | n} ] {1…255}

Nombre d'abend permis par CFT avant son arrêt.

[MAXDUMP = {2 | n}] {1…255}

Nombre d'abend qui feront l’objet d’un DUMP demandé par CFT.

Les abend supplémentaires ne donneront pas lieu à prise de DUMP.

http://g/A-Deliverable/CFT/V2.3/Documentation%20fran%E7%A1%A9se/Mvs/CFT%20V2.3%20MVS%20Guide%20des%20habilitations.pdf





CFT V2.34-8

[SGTRACE = {0 | n}] {1…65535}

Valeur initiale de la trace fichier SGTRACE.

Une valeur différente de 0 sera utilisée à la demande du support client CFT.

Les combinaisons possibles sont :

· 1 : actions du réseau (SNA/X25/TCP/LU62),

· 2 : actions en erreur,

· 4 : actions du gestionnaire de fichiers,

· 8 : lecture/écriture de fichiers,

· 16 : fonctions C,

· 32 : messages longs,

· 64 : actions de communications entre tâches,

· 128 : appels et retours de programmes,

· 256 : actions de l’interface interactive,

· 512 : appel des exits utilisateur.

Attention : l’utilisation des options SGTRACE avec l’interface CFT sous VTAM provoquel’édition 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}] {0…255}

Options de fonctionnement de RACF.

Ce paramètre n’est utilisé que dans le cas où RACF est installé.

Les valeurs possibles sont les suivantes :

· 0 : CFT n’appelle pas RACF ; il manipule tous les fichiers sous son autorité,

· 1 : CFT soumet les procédures (JCL) de transfert avec contrôle du paramètre USERID".CFT doit alors être un programme autorisé (APF),

· 2 : CFT alloue et ouvre les fichiers de transfert avec contrôle du paramètre "USERID".

CFT doit alors être un programme autorisé (APF),· 3 : cumul des options de fonctionnement 1 et 2.

[BLKSIZE = {27998 | n}] {4100…32760}

Valeur maximum utilisée pour calculer le BLKSIZE des fichiers créés par CFT, lorsque cetteinformation est absente.

[BLKPDS = {150 | n}] {1…32760}

Nombre de blocs de PDS alloués lors de la création d’un fichier partitionné par CFT.




CFT V2.3 4-9

[TRACE = {128 | n}] {4…16383}

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 decommunications (Procédure CFTXMEM).

[XSIZE = {1024 | n}]

Nombre maximum des entrées mise en attente dans le service de CFTXMEM.

[TSOEDIT = {NO | YES}]

Support des fichiers avec numéros de séquence en colonnes 73 à 80 :

· YES : s'ils sont créés par l'éditeur ISPF avec l'option 'NUMBER ON', les fichiers enentrée lus par CFTUTIL/VFMUTIL peuvent contenir un numéro de séquence sur 8 chiffres dans les colonnes 73 à 80. Ce numéro de séquence est alors ignoré par CFT/MVS,

· NO : les fichiers en entrée sont lus inchangés par CFTUTIL/VFMUTIL.

[NTFDEST = {'CFTSCOPP' | n}] SCOPE A&P

Nom symbolique de la file d’attente XCF utilisée par XFB.Scope.

Ce paramètre est utilisé uniquement avec le logiciel complémentaire 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 auprès du composant ARM.Il utilise un élément de nom « Xidparm », idparm étant le paramètre delancement du moniteur CFT (voir également le paragraphe «Utilisation des

services Automatic Restart M anager » ,

· NO : CFT/MVS ne s’enregistre 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 d’exécution de ce job.

Les programmes ‘CFTMAIN/CFTMA31’ seront copiés dans une bibliothèque autorisée 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.34-10

· utilise des UCB dynamiques (DRM) ou définis en 31 bits dans IODF,

· utilise les services ARM.

Les programmes ‘CFTINTV/CFTIN31’, ‘CFTXMEM’, ‘CFTIUI’, sont copiés dans une bibliothèque autorisée ‘APF’, s’ils sont utilisés.

Remarque : le code retour du LINK-EDIT doit être inférieur ou égal à 4.

4.5.5. Installation des modules réseau 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 réalisé avec les interfaces SOCKET deTCP/IP, bibliothèques "tcpip.SEZACMTX" en tête des SYSLIB.

Le LINK-EDIT des modules utilisant TCP/IP doit être réalisé de préférence sur le système MVScible ou a défaut sur une version OS/390 V2 R10.

La bibliothèque LE/370 CEE.SCEELKED contient les interfaces SOCKET() de OPENEDITIONnon utilisables par CFT, et des services communs qui sont nécessaires au LINK-EDIT. Toujours placer au LINK-EDIT les bibliothèques TCP/IP avant les bibliothèques LE/370.

Exemple :

//SYSLIB DD DSN=TCPIP.SEZACMTX,

//* DD DSN=solve.LOAD, Uniquement pour TCPACCESS// DD DSN=CEE.SCEELKED,

A l’exécution, dans le cas où ces bibliothèques seraient en « LINKLIST », dans un ordre contraire,il faut également forcer dans l’ordre TCP/IP puis LE/370 dans les STEPLIB. Cette méthode estimpérative avec UNICENTER :TCPACCESS.

Exemple :

//STEPLIB DD DSN=cftv2.LOAD,

// DD DSN=solve.LINK, Uniquement pour TCPACCESS// DD DSN=CEE.SCEERUN,

Remarques : Il est conseillé de conserver le listing d’exécution de ce job.Le code retour du LINK-EDIT doit être inférieur ou égal à 4.Les modules créés dans cette étape ne sont pas ré-entrants.




CFT V2.3 4-11

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 adressées à CFT. Cette étape est facultative.Le chapitre "API CFT : mise en œuvre sous CICS" indique la procédure pour INSTALLER etUTILISER ces 2 programmes.

Remarque :le code retour du LINK-EDIT doit être égal à 0.



CFT V2.3 5-1

5. Installation de CFT/MVS Version 2.3.1

5.1. Installation de CFT/MVS

La procédure suivante indique les principales étapes de cette installation :

1 Définition d’un ALIAS CFT Version 2 (facultatif).

2 Restauration des fichiers d’installation à partir d’une K7 ou Transfert des fichiersd’installation depuis un CD.

3 Décompression des fichiers d’installation.

4 Adaptation des jobs d’installation aux standards de l’exploitation.

5 Soumission des jobs d’installation.

6 Paramétrage de CFT version 2.

7 Personnalisation des procédures CFT version 2.

5.2. Définition d’un ALIAS CFT version 2

Si les noms de fichiers mentionnés dans les différents jobs d’installation sont conservés par l’exploitation, il est possible de créer un “ALIAS” CFTV2 dans un USER CATALOG, défini de lamanière 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)).................../*//





CFT V2.35-2

5.3. Restauration de la bibliothèque d’installation

L’utilisateur peut recharger les fichiers indifféremment depuis une K7 ou un CD. Les fichiers

installés sont alors interchangeables.

5.3.1. Restauration des fichiers d’installation a partir d’une cassette

Sur le premier label (et seul label) de la bande se trouvent le JCL d’amorce d’installation du produit ainsi que le produit XFB/CFT (sous un format ADRDSSU + XMIT (lrecl=80)).

A l’issue du chargement une librairie temporaire sera créée contenant deux membres :

· ‘jclins’ : JCL permettant l’amorce de l’installation de XFB/CFT,

· ‘cftmvs’ : produit XFB/CFT.

L’utilisateur de CFT/MVS trouvera, ci-dessous, un exemple de JCL à utiliser pour restaurer lesfichiers d’installation 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 paramètres en gras sont à adapter à votre environnement.Le nom de volume SOPnnn figure sur l’étiquette de la cartouche.




CFT V2.3 5-3

5.3.2. Transfert des fichiers d’installation depuis un CD

5.3.2.1. Configuration nécessaire

Pour procéder à l’installation de CFT/MVS livré sur CD-ROM, l’utilisateur doit disposer :

· d'une station de travail équipée d’un lecteur de CD-ROM,

· d'un logiciel client FTP permettant le transfert de fichiers vers le HOST MVS,

· d'un réseau TCP/IP de performances suffisantes pour transférer environ 30 méga-octetsde données (1 mégabit/seconde est souhaitable).

Pour réaliser l’installation de CFT/MVS, les étapes suivantes sont déroulées :

1. Transfert du CD-ROM vers MVS, par FTP, des fichiers de livraison.Cette étape nécessite environ 40 cylindres 3390 d’espace disque côté MVS.

2. Décompression et rechargement des fichiers d’installation.Cette étape nécessite environ 200 cylindres supplémentaires d’espace disque.

5.3.2.2. Transfert des fichiers d'un CD par FTP

Les fichiers de livraison se trouvent sous le répertoire « install » du CD-ROM.

Pour les transférer vers MVS, vous devez procéder de la manière suivante :

1. Copier et adapter le fichier paramètre ‘ftp.prm’.Les paramètres à préciser sont : l’adresse du host, le userid TSO, le mot passe associé,le préfixe de la librairie temporaire d’installation (à préciser 3 fois) (note : le paramètrevolume est optionnel).

2. Transférer les fichiers de livraison vers le host avec, par exemple, la commande :FTP –s:ftp.prm

Le fichier jclins.txt sera transféré avec conversion.Le fichier cftmvs.bin sera transféré sans conversion ASCII<>EBCDIC.

Liste du fichier ftp.prm :open hostnameuseriduserpswquote site volume=xxxxxxquote site cylquote site primary=35quote site secondary=15quote site recfm=fb lrecl=80quote site directory=10mkdir 'dznindx.UPLIB'ascii put d:\Install\jclins.txt 'dznindx.UPLIB(JCLINS)' binary put MVS-CFT-2.3.1-tag-date 'dznindx.UPLIB(CFTMVS)' bye


ftp://ftp.prm/

ftp://ftp.prm/




CFT V2.35-4

5.4. Décompression des fichiers de livraison

Cette étape est commune à tous les modes de livraison. A partir de la librairie restaurée ou

transférée (cftv2.UPLIB), il faut dans un premier temps adapter le JCL ‘JCLINS’ puis lesoumettre.

Cette procédure va réaliser plusieurs opérations :

1. Transformation du fichier ‘produit’ en fichier de type ADRDSSU.

2. Restauration des fichiers de distribution CFT via ADRDSSU.

3. Création de l’environnement CFT ‘user’ ou cible.

4. Copie de certains composants CFT de l’environnement de distribution versl’environnement cible.

Après cette étape, le processus d’installation est similaire à une installation CFT V2.3.0, en notantque les étapes A10ALLOC et A11REST n’ont plus lieu d’être. L’utilisateur conserveral’environnement de distribution en l’état et adaptera son environnement cible.

Remarque : les fichiers de distribution sont restaurés avec quatre niveaux index (ADRDSSU), 3 sontmodifiables par l’utilisateur via le paramètre RENAMEUNC de l’utilitaire ADRDSSU.

Par exemple : AXWAY.XFB.CFT00231.CF0level.CNTL

RENAMEUNC ((AXWAY.XFB.CFT00231.**, -'

PRODUCT.AXWAYXFB.CFT00231.**)) -'

5.5. Adaptation des JOB d’installation à l’exploitation

Les JOB contenus dans cette bibliothèque sont les suivants :

· 1 : A00CUSTO : personnalisation des jobs d'installation,

· 2 : A12OPTS : choix des options de fonctionnement de CFT version 2,

· 3 : B20LINK : LINK-EDIT général des modules CFT,

· 4 : B22LTCP : LINK-EDIT spécifiques à TCP/IP IBM,

· 5 : B22LTCPX : LINK-EDIT spécifiques à TCP/IP UNICENTER:TCPACCESS

· 6 : B24CICS : LINK-EDIT de l’interface de programmation CICS,

· 7 : C31SCRxx : allocation des fichiers des écrans (Français et/ou Anglais),

· 8: C32XMEM : allocation du fichier de sauvegardes des communications,

· 9 : C33CNFxx : allocation du fichier de configuration (Français et/ou Anglais),

· 10 : C33MON : allocation du fichier des moniteurs,

· 11 : D40INIT : initialisation des fichiers d’exécution de CFT Version 2,

· 12 : D41AIX1 : définition de l’index alterné du catalogue,

· 13 : D41AIX2 : construction de l’index alterné du catalogue,

· 14 : D42SSL : création d'une base de données expérimentale de clés et de

certificats SSL,




CFT V2.3 5-5

· 15 : D43PKI : création d'une base de données PKI,

· 16 : E50PARM : fourniture d'un exemple de paramétrage CFTPARM,

· 17 : F60VFMC : fourniture d'un exemple de création de base VFM,

· 18 : G70VTAM : fourniture d'un exemple de paramétrage de VTAMLST,

· 19 : G71LOGM : fourniture d'un exemple de MODETAB utilisée par CFTVersion 2,

· 20 : H80EXEC : création de procédures (fin de transferts, bascule log...) CFTVersion 2,

· 21 : I90VALID : validation de l'installation de CFT Version 2,

· 22 : SN00CUST : personnalisation du fichier de configuration ‘SENTINEL’.


Dans les paragraphes suivants, l’utilisateur de CFT/MVS trouvera en quelques mots la descriptionde la ou des fonctions de ces jobs.

5.6. Personnalisation des fichiers d’installation de CFT/MVS (A00CUSTO)

Ce JOB personnalise les fichiers d’installation (environnement USER).La personnalisation se fait directement dans la bibliothèque d'installation (environnement USER).Il est nécessaire de QUITTER l’éditeur après 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 nameuserid '&SYSUID' 02 User identifier (for notify)account 'ACCT' 03 Account numbermsgclass 'R' 04 Message classclass 'P' 05 Execution classjobparm '/*JOBPARM ROOM=CFTx' 06 Job parm (//* if none)tape '3490' 07 Tape unittapvol 'SOPnnn' 08 Tape volumecftvol 'CFTVOL' 09 CFT library volumecftunit '3390' 10 CFT library unitcftv2 'CFTV2' 11 CFT data set prefixsysout 'L' 12 Sysout classtcpsns 'SNSTCP' 13 UNICENTER:tcpaccess lib prefix

tcpibm 'TCPIP' 14 IBM tcp/ip library prefixlever 'YES' 15 Le/370 version YES or NO




CFT V2.35-6

le370 'CEE' 16 Le/370 data set prefixc370 '**’ 17 Not used (C/370 DS prefix)sysda 'VIO' 18 SYSUTx UNIT= VIO or SYSDA cicscob 'DFH' 19 Cics cobol library prefixcicslod 'DFH' 20 Cics loadlib library prefixcobol2 'SYS1.COB2' 21 Cobol 2 library prefix

acbint 'CFT2INT' 22 Vtam acbname for cftintdisc '1441' 23 Disconnect delay for cftint userlang 'FR' 24 CFT screen language (FR or UK)

..

iuisp '2975' 33 IUI TCP/IP secured portiuinsp '2976' 34 IUI TCP/IP unsecured portapisaddr '127.0.0.1' 35 synchronous API TCP/IP addressapisp '7010' 36 synchronous API TCP/IP port

distlib 'AXWAY.XFB.CFT00231' 37 Distrib library prefix

distlev 'CF006439' 38 level distribution

@@





L’utilisateur doit :

1 Soumettre ce JOB.

2 Quitter EDIT.

3 Attendre la fin d’exécution du JOB.

L'explication des différents mots-clés est indiquée dans le tableau suivant :



Jobname Nom du job avec lequel seront soumis les JCL d'installation

Userid Nom de l'utilisateur avec lequel seront soumis les JCL d'installation

Account "Account Number" avec lequel seront soumis les JCL d'installation

Msgclass Classe de sortie des messages

Class Classe d'exécution des JCL d'installationJobparm Paramètres relatifs aux jobs d'installation pour JES2( //* si inexistant)

Tape Type d'unité utilisée pour restaurer les bibliothèques d'installation

Tapvol Nom du volume utilisé pour restaurer les bibliothèques d'installation

Cftvol Nom du volume de création des fichiers CFT/MVS

Cftunit Type d'unité disque

Cftv2 Alias de création des fichiers CFT/MVS

Sysout Classe de sortie des comptes rendus d'exécution

Tcpsns Alias des bibliothèques TCP/IP UNICENTER : TCPACCESS

Tcpibm Alias des bibliothèques TCP/IP IBM

Lever Utilisation de LE/370 (YES/NO)

le370 Alias des bibliothèques LE/370




CFT V2.3 5-7

Tableau 8. Liste des mots-clés (suite)


c370 Alias des bibliothèques C/370 (Inutilisé)

sysda UNITNAME des fichiers temporaires de LINK-EDIT (VIO/SYSDA)

Cicscob Alias des bibliothèques CICS pour COBOLcicslod Alias des bibliothèques CICS

cobol2 Alias des bibliothèques COBOL 2

acbint Nom de l'ACB utilisé pour les interfaces interactives sous VTAM

disc Timer de déconnexion pour les interfaces interactives sous VTAM

lang Langage utilisé ( FR ou UK) dans les interfaces interactives

iuisp Port sécurisé pour XFB.UI

iuinsp Port non sécurisé pour XFB.IUI

apisaddr Adresse TCP/IP de l’API synchrone

apisp Port de l’API synchrone

distlib Alias de l’environnement de distribution

distlev Niveau version distribution

Remarque :les paramètres 25 à 32 sont utilisés uniquement avec le dispositif «Sécurité d’exploitation de CFT»et sont décrits dans le «Guide des habilitations» CFT/MVS.

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

Ce JOB génère la tables des options de CFT/MVS.

SYST = MVS

Type de système 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 défaut ROUTCDE=X‘0008’ correspond au ROUTCDE=(13).

Cette valeur sera utilisée en liaison avec l’option ‘OPERMSG’ du paramètre ‘CFTLOG’.

Pour les options DESC et ROUTCE, consulter la brochure IBM “Supervisor services and macros” pour l’utilisation des DESCRIPTOR CODES et ROUTCODES.

[MAXAB = {15 | n}] {1…255}

Nombre d'abend permis par CFT avant son arrêt.

[MAXDUMP = {2 | n}] {1…255}

Nombre d'abend qui feront l’objet d’un DUMP demandé par CFT.

Les abend supplémentaires ne donneront pas lieu à prise de DUMP.






CFT V2.35-8

[SGTRACE = {0 | n}] {1…65535}

Valeur initiale de la trace fichier SGTRACE.

Une valeur différente de 0 sera utilisée à la demande du support client CFT.

Les combinaisons possibles sont :

· 1 : actions du réseau (SNA/X25/TCP/LU62),

· 2 : actions en erreur,

· 4 : actions du gestionnaire de fichiers,

· 8 : lecture/écriture de fichiers,

· 16 : fonctions C,

· 32 : messages longs,

· 64 : actions de communications entre tâches,

· 128 : appels et retours de programmes,

· 256 : actions de l’interface interactive,

· 512 : appel des exits utilisateur.

Attention : l’utilisation des options SGTRACE avec l’interface CFT sous VTAM provoquel’édition 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}] {0…255}

Options de fonctionnement de RACF.

Ce paramètre n’est utilisé que dans le cas où RACF est installé.

Les valeurs possibles sont les suivantes :

· 0 : CFT n’appelle pas RACF ; il manipule tous les fichiers sous son autorité,

· 1 : CFT soumet les procédures (JCL) de transfert avec contrôle du paramètre USERID".CFT doit alors être un programme autorisé (APF),

· 2 : CFT alloue et ouvre les fichiers de transfert avec contrôle du paramètre "USERID".

CFT doit alors être un programme autorisé (APF),· 3 : cumul des options de fonctionnement 1 et 2.

[BLKSIZE = {27998 | n}] {4100…32760}

Valeur maximum utilisée pour calculer le BLKSIZE des fichiers créés par CFT, lorsque cetteinformation est absente.

[BLKPDS = {150 | n}] {1…32760}

Nombre de blocs de PDS alloués lors de la création d’un fichier partitionné par CFT.




CFT V2.3 5-9

[TRACE = {128 | n}] {4…16383}

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 decommunications (Procédure CFTXMEM).

[XSIZE = {1024 | n}]

Nombre maximum des entrées mise en attente dans le service de CFTXMEM.

[TSOEDIT = {NO | YES}]

Support des fichiers avec numéros de séquence en colonnes 73 à 80 :

· YES : s'ils sont créés par l'éditeur ISPF avec l'option 'NUMBER ON', les fichiers enentrée lus par CFTUTIL/VFMUTIL peuvent contenir un numéro de séquence sur 8 chiffres dans les colonnes 73 à 80. Ce numéro de séquence est alors ignoré par CFT/MVS,

· NO : les fichiers en entrée sont lus inchangés par CFTUTIL/VFMUTIL.

[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 auprès du composant ARM.Il utilise un élément de nom « Xidparm », idparm étant le paramètre delancement du moniteur CFT (voir également le chapitre «Utilisation des services Automatic Restart M anager »),

· NO : CFT/MVS ne s’enregistre 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 d’exécution de ce job.

Les programmes ‘CFTMAIN/CFTMA31’ seront copiés dans une bibliothèque autorisée 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 définis en 31 bits dans IODF,

· utilise les services ARM.

Les programmes ‘CFTINTV/CFTIN31’, ‘CFTXMEM’, ‘CFTIUI’, sont copiés dans une bibliothèque autorisée ‘APF’, s’ils sont utilisés.




CFT V2.35-10

Remarque : le code retour du LINK-EDIT doit être inférieur ou égal à 4.

5.6.3. Installation des modules réseau 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 réalisé avec les interfaces SOCKET deTCP/IP. Les modules réentrant TCP/IP sont inclus à partir de la librairie «tcpip.TSEZARNT1».

Il est important de respecter l’ordre des bibliothèques au niveau des SYSLIB.

Le LINK-EDIT des modules utilisant TCP/IP doit être réalisé de préférence sur le système MVScible ou a défaut sur une version OS/390 V2 R10.

La bibliothèque LE/370 CEE.SCEELKED contient les interfaces SOCKET() de OPENEDITIONnon utilisables par CFT, et des services communs qui sont nécessaires au LINK-EDIT. Toujours placer au LINK-EDIT les bibliothèques TCP/IP avant les bibliothèques LE/370.

Exemple :

//RNT1 DD DSN=&TCP..SEZARNT1,DISP=SHR//SYSLIB DD DSN=&TCP..SEZACMTX,DISP=SHR// DD DSN=&LE..SCEELKED,DISP=SHR// DD DSN=SYS1.CSSLIB,DISP=SHR

A l’exécution, dans le cas où ces bibliothèques seraient en « LINKLIST », dans un ordre contraire,il faut également forcer dans l’ordre TCP/IP puis LE/370 dans les STEPLIB.

Exemple :

//STEPLIB DD DSN=cftv2.LOAD,// DD DSN=CEE.SCEERUN,

Remarques : Il est conseillé de conserver le listing d’exécution de ce job.

Le code retour du LINK-EDIT doit être inférieur 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 decompatibilité IBM HPNS.

Remarque importante :Le LINK-EDIT des modules utilisant TCP/IP se déroule en deux étapes : un PRELINK suivi d’unLINK-EDIT.

L’ordre des librairies au niveau SYSLIB des PRELINK et LINK-EDIT sont à respecter.

Exemple :

au niveau du PRELINK ://RNT1 DD DISP=SHR,DSN=tcpip.SEZARNT1 TCPIP RENT//SYSLIB DD DISP=SHR,DSN=tcpip.SEZARNT1 TCPIP RENT

// DD DISP=SHR,DSN=&LE..SCEEOBJ




CFT V2.3 5-11

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

A l’exécution, dans le cas où ces bibliothèques seraient en « LINKLIST », dans un ordre contraire,il faut également forcer dans l’ordre TCP/IP puis LE/370 dans les STEPLIB. Cette méthode estimpérative avec UNICENTER :TCPACCESS.

Exemple ://STEPLIB DD DSN=cftv2.LOAD,// DD DSN=solve.LINK, Uniquement pour TCPACCESS// DD DSN=CEE.SCEERUN,

Remarques : Il est conseillé de conserver le listing d’exécution de ce job.Le code retour du LINK-EDIT doit être inférieur 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 adressées à CFT. Cette étape est facultative.

Le chapitre «CFT : mise en oeuvre sous CICS » indique la procédure pour INSTALLER etUTILISER ces 2 programmes.

Remarque :le code retour du LINK-EDIT doit être égal à 0.



CFT V2.3 6-1

6. Création de l’environnement CFT/MVS

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

Ce chapitre fournit les données nécessaires pour la mise en œuvre d’un paramétrage de base deCFT version 2.3.0 et suivantes, dans le cadre de son installation.

Ces fichiers de travail sont :

· CFTPARM : fichier VSAM KSDS, description des paramètres de CFT,

· CFTPART : fichier VSAM KSDS, description des partenaires de CFT,

· CFTCAT : fichier VSAM ESDS, catalogue de CFT,

· CFTLOG1 : fichier séquentiel utilisé comme journal par CFT,

· CFTLOG2 : fichier séquentiel utilisé par CFT comme journal alterné du précédent,

· CFTACNT1 : fichier séquentiel utilisé comme fichier comptable par CFT,

· CFTACNT2 : fichier comptable alterné,

· CFTCOM : fichier VSAM ESDS utilisé par CFT comme tampon pour lescommandes CFT Version 2 soumises par CFTUTIL, un programme batch, un utilisateur TSO, l’interface Internet XFB.IUI.

Le JOB D40INIT prépare les fichiers de CFT/MVS.

Avant de soumettre ce job, les points suivants doivent être adaptés aux besoins de l’environnement :

· les noms des fichiers (si les valeurs par défaut des exemples ne sont pas satisfaisantes),

· les valeurs des paramètres RECNB et FSPACE.

6.2. Définition de l’index alterné du catalogue (D41AIX1, D41AIX2)

Remarque : cette étape sera exécutée uniquement si vous utilisez le module CFTI d’interrogation du catalogue,depuis CICS.

Le JCL qui suit est un exemple de définition de l’index 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 */



Création de l’environnement CFT/MVS

CFT V2.36-2

DELETE cftv2.CFTAIX AIX PURGEDEFINE 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 paramètres en gras seront remplacés lors de la phase de personnalisation.




CFT V2.3 6-3

6.3. Création du fichier PKI de CFT/MVS (D43PKI)

Le fichier PKI contient toutes les informations nécessaires à l’utilisation du composant SSL :

· autorités de certification,· certificats,

· clés privées.

Les exemples sont créés à partir du logiciel OPENSSL, de l’Institut Fédéral Suisse de technologie.L’étape D43PKI crée un fichier VSAM KSDS et l’initialise avec les exemples livrés.

Pour mettre à jour le fichier PKIFILE, vous pouvez utiliser le modèle d’utilitaire CFTPKI.

Consultez le "Guide de la sécurité de transport " pour l’explication détaillée de l’utilitaireCFTPKI.

Remarques importantes :

· les exemples livrés sont uniquement destinés à vérifier le bon fonctionnement ducomposant SSL. Ils ne doivent en aucun cas être utilisés à d’autres fins,

· l’utilisateur doit prendre toutes les mesures de sécurité appropriées pour garantir laconfidentialité des données de sécurité,

· l’utilisation du chiffrement des données est soumise à des obligations légales, variablesselon les pays.



CFT V2.3 7-1

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 possibilités suivantes à un opérateur CFT :

· envoyer une commande à CFT,

· interroger de façon sélective le fichier catalogue de CFT Version 2,

· interroger et/ou mettre à jour de façon sélective les fichiers paramètres et partenaires deCFT Version 2,

· examiner le fichier journal.

7.2. Création des fichiers de l’interface interactive (C31SCRxx)

L’interface interactive de CFT utilise (par langage) les fichiers suivants :

· sept fichiers VSAM :ces fichiers sont créés et chargés par l’utilitaire IDCAMS,

· un fichier séquentiel :ce fichier est créé et chargé par l’utilitaire CFTUTIL.

En fonction de la langue utilisée (FR pour le français, UK pour l’anglais), la création se fera avecle job C31SCRFR pour la version française, et C31SCRUK pour la version anglaise.

7.3. Serveur de communications OS/390

Le serveur de communications permet d’accélérer le traitement des commandes de transfert,normalement déposées 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 données(DIV), partagé entre tous les utilisateurs CFT/MVS du même ordinateur.

Le serveur de communications est accessible à tous les utilisateurs par une instruction ‘PC’ de typeGLOBAL. Pour cette raison, il est RECOMMANDE de ne jamais stopper le serveur.

L’espace adresse de données est sauvegardé dans un fichier ‘VSAM LINEAR’.

Chaque commande de configuration ‘CFTCOM TYPE=MBX,NAME=nnn’ , réserve 1024 pagesdans l’espace DIV, et donc 1024 blocs de 4K dans le fichier de sauvegarde (environ 7 cylindres de3390).



Installation des menus CFT

CFT V2.37-2

Un seul serveur gère toutes les communications d’un ou plusieurs CFT/MVS du même ordinateur.Il doit être actif avant l’initialisation d’un moniteur CFT.

Chaque moniteur CFT doit faire référence à un nom de boîte à lettres différent.

Le JOB C32XMEM crée le fichier de sauvegarde du serveur.

Remarque :le serveur de communications n’est pas accessible aux applications s’exécutant sur des ordinateursdifférents dans un SYSPLEX.

7.4. Utilisation (CFTXMEM)

Le JCL qui suit est un exemple de procédure d’activation 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

//


Le DDNAME du fichier de sauvegarde correspond à la valeur du paramètre MAIL= deSGINSTAL (voir A12OPTS). La valeur par défaut est ‘CFTPCMBX’.

7.5. Création du fichier de configuration (C33CNFxx)

Ce fichier sert de modèle à chaque utilisateur de l'interface interactive de CFT.

En fonction de la langue utilisée (FR pour le français, UK pour l’anglais), la création se fait avec le job C33CNFFR pour la version française, et C33CNFUK pour la version anglaise.

Pour le créer, l’utilisateur doit fournir en entrée les paramètres suivants :

COUNTRYCODE = {FR | UK}

Code du langage utilisé.

· FR pour le français,

· UK pour l’anglais.




CFT V2.3 7-3

DATEFORMAT = date

Format de la date affichée : JJ/MM/AA, JJMMAAAA, SSAAMMJJ ou MM/JJ/AA.

TIMEFORMAT = time

Format de l’heure : HHMM (heures et minutes) ou HH:MM (heures et minutes).

MONITORFILENAME = filename

Nom du fichier des moniteurs CFT accessibles sous forme de DDNAME précédé par $, ousous forme de DSNAME.

USERFILENAME = filename

Nom du fichier de sauvegarde de l'environnement d'un utilisateur codé sous forme deDSNAME.La variable symbolique ‘&USER’ sera remplacée par le nom de l’utilisateur.

Ce nom sera codé sous la forme : CFTVOL%CFTUNIT%DSNAME , CFTVOL et CFTUNITsont facultatifs.

SELECTIONFILENAME = filename

Nom du fichier temporaire de selection qui sera utilisé pour transférer des fichiers génériquesou une sélection des membres d'une bibliothèques codé sous forme de DSNAME.La variable symbolique ‘&USER’ sera remplacée par le nom de l’utilisateur.

Ce nom sera codé sous la forme : CFTVOL%CFTUNIT%DSNAME , CFTVOL et CFTUNITsont facultatifs.Il est recommandé de générer un nom de fichier unique par utilisateur.

# Indique une carte commentaire.

Exemple de configuration en français :

## 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.37-4

#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


7.6. Création du fichier des moniteurs (C33MON)

Ce fichier sert à définir les moniteurs CFT gérés par l’interface interactive. Pour le créer, vousdevez fournir en entrée les paramètres suivants :

PARAMETERFILENAME = filename

Le nom du fichier des paramètres CFT accessibles sous forme de DDNAME précédé par $,ou sous forme de DSNAME.

CFTPARMID = identifier

Identifiant d'un CFTPARM se trouvant dans le fichier paramètre.

Ces deux paramètres peuvent être répétés plusieurs fois.

Exemple de configuration :

# Nom du fichier parametre ** A PERSONNALISER# Parameter file name

#PARAMETERFILENAME = $CFTPARM## Identifiant d'un CFTPARM ** A PERSONNALISER# CFTPARM identifier#CFTPARMID = IDPARM0

7.7. Appel des menus CFT

7.7.1. Sous TSO (CFT)

Le membre CFT de la bibliothèque CFTV2.INSTALL est un exemple d’appel aux menus CFTsous TSO. Pour exécuter cette CLIST, une REGION TSO DE 4000K est nécessaire.




CFT V2.3 7-5

7.7.2. Sous VTAM (CFTINT)

CFT/MVS dispose de deux modes de fonctionnement pour l’interface écran :

·

dans une région séparée du moniteur CFT/MVS.Le programme ‘CFTINTV’ peut recevoir au maximum quatre paramètres, dont l’ordreest imposé :

- paramètres 1 et 2 : SGTRACE nnn.

Redéfinit l’option SGTRACE de la macro SGINSTAL.

Ces 2 paramètres sont liés et facultatifs,

- paramètres 3 et 4 : ACBNAME DISC.

Ces 2 paramètres sont liés et obligatoires, avec :

- ACBNAME : nom de l’APPLID VTAM qui sera réservé à cette application,

- DISC : délai en minutes de libération du terminal inactif.

La valeur 1440 indique que les terminaux inactifs ne sont jamais libérés.

Le membre CFTINT de la bibliothèque CFTV2.INSTALL est un exemple delancement de ce programme,

· en sous-tâche du moniteur CFT/MVS (programme CFTINT31).Cet appel est automatique en codant :

- les 5 paramètres suivants à CFTMAIN :

SGTRACE nnn ACBNAME DISC idparm

- une définition réseau CFTNET TYPE=SNA est activée dans le paramétrage deCFT, afin d’initialiser le réseau SNA, par exemple :

CFTNET ID=NETGATE,PROFILE=GATE,TYPE=SNA,ACB=acbgate

Pour se connecter à l’interface écran CFT/MVS sous VTAM, un utilisateur mettra en œuvre la procédure suivante :

· sur la mire VTAM : LOGON APPLID=ACBNAME,

· sur la mire d’accueil CFT/MVS, il doit entrer son USERID/PASSWORD qui sontvérifiés par RACF (ou équivalent).

7.7.3. Touches de Fonctions

Sur chaque écran, les touches de fonctions utilisables sont affichées.Leurs définitions est la suivante :

· <F1> HLP Aide en ligne,

· <F3> END Fin (retour au menu précédent),

· <F4> RET Retour au menu général,

· <F5> TOP Aller au début de la sélection,

· <F6> BOT Aller à la fin de la sélection,

·

<F7> UP Déplacement d'une page vers le haut,




CFT V2.37-6

· <F8> DWN Déplacement d'une page vers le bas,

· <F10> LFT Déplacement vers la gauche,

· <F11> RIG Déplacement vers la droite,

· <F12> EXI Sortie des interfaces interactives.

Sur les écrans d'aide, les touches <F7> et <F8> servent à se déplacer respectivement vers la pagesuivante ou vers la page précédente.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 estnécessaire : 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 bibliothèque CFTV2.INSTALL est un exemple de lancement del’interface XFB.IUI sous OS/390. Le programme CFTIUI doit être ‘APF’.Le JCL qui suit est un exemple de procédure d’activation de l’agent 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




CFT V2.3 7-7

//CFTTCP DD DISP=SHR,DSN=&QUAL..INSTALL(&IUIAPIS)//* LE/370 DEBUG//CEEDUMP DD SYSOUT=&OUT//STDOUT DD SYSOUT=&OUT//SYSPRINT DD SYSOUT=&OUT// PEND

//*//IUIP EXEC CFTIUI//


Trois exemples de fichier paramètres ‘profile’ sont livrés :

· IUISYAN : API synchrone (média de communication) et mode anonyme (certification),

· IUISYCF : API synchrone (média de communication) et fichier certificat,

· IUISYNS : média de communication standard (fichier) et échange non sécurisé.

Remarque : l’utilisation de l’API synchrone comme média de communication avec le moniteur XFB/CFT ainsi

que la sécurisation des échanges, ne pourront être réalisées qu’à partir de la version XFB/CFT.231.

La description du paramétrage de l’agent Internet XFBIUI (Fichier PROFIL) est la suivante.

Tableau 9. Description du paramétrage de l’agent XFBIUI

(SERVER) Mot clé obligatoire pour MVS

Port Numéro de Port d’écoute, paramètre obligatoire

RecvTimeout Temps d’attente en secondes de réception de données

Défaut = 1000

CloseTimeout Temps d’attente en secondes sur envoi de données

Défaut = 1000

Trace Masque des trace

Défaut = 0

Addr Nom du serveur TCP/IP

Défaut = aucun, travaille avec tous (ANYHOST)

ServerMax Nombre maximum de connexions simultanées

Défaut = 48

TermDelay Temps d’attente en secondes de connexion entrante

Défaut = 0

ARM Nom utilisé pour s’abonner au composant ARM de OS/390

Par défaut : pas d’abonnement au composant ARM




CFT V2.37-8

Tableau 9. Description du paramétrage de l’agent XFBIUI (suite)

(SERVER) Mot clé obligatoire pour MVS

[Paramètres

XFB/CFT 2.31]

TlsUsed Echange en mode sécurisé : 1TlsCipherSuite Indique les « ciphers suite » acceptées 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 paramétrage CFT des cipher suites)

TLS_RSA_WITH_NULL_SHA (=2 dans le paramétrage CFT)

TLS_RSA_WITH_DES_CBC_SHA (=9 dans le paramétrage CFT)

TLS_RSA_WITH_3DES_EDE_CBC_SHA (=10 dans le paramétrage CFT)

TLS_RSA_WITH_RC4_128_MD5

TLS_RSA_WITH_RC4_128_SHA

TLS_RSA_WITH_AES_128_CBC_SHA

Ce paramètre décrit :

- le type d’authentification

- le mode anomyne (sinon rien)

- l’algorithme de chiffrement sinon NULL

- l’algorithme de scellement

TlsServerCertificateFile Référence par indirection DD : (ddname) un fichier contenant la chaîne decertification au format pkcs12

Ce paramêtre est optionnel si cipher suite est de type anonyme

TlsPasswordFile Référence par indirection DD : (ddname) un fichier contenant le mot de passe (en

EBCDIC) du certificat au format pkcs12

(CFT) Mot-clé

Fileconfig Référence par indirection $ (ddname) un fichier décrivant le type de média de

communication utilisé avec le moniteur XFB/CFT (ex : API synchrone)

1) Exemple de fichier de configuration :

SERVER)PORT = 1972TRACE = 255

Avec :

· (SERVER) : mot clé obligatoire,

· PORT : numéro de port IP d’écoute,

· TRACE : options de trace interne de XFBIUI.




CFT V2.3 7-9

2) Exemple de fichier de configuration : [XFB/CFT.231]

# IUI configuration file# with synchronous API# with data security exchange

# with certificat(SERVER)PORT=iuispTlsUsed=1TlsCipherSuite=TLS_RSA_WITH_DES_CBC_SHA

TlsServerCertificateFile="DD:TLSCER"

TlsPasswordFile="DD:TLSPSW"(CFT)Fileconfig="$CFTTCP"

Avec :

· (SERVER) : mot clé obligatoire,

· PORT : numéro de port IP d’écoute personnalisé lors del’installation,

· TlsUsed=1 : échange en mode sécurisé,

· TlsCipherSuite : indique les «ciphers suite» acceptées par le serveur,

· TlsServerCertificateFile : référence par indirection (ddname : TLSCER) un fichier contenant la chaîne de certification au format pkcs12,

· TlsPasswordFile : ddname (TLSPSW) du fichier contenant le mot de passedu certificat,

· (CFT) : mot clé obligatoire dans le cas de la configuration du

média de communication CFT,

· Fileconfig="$CFTTCP" : ddname (CFTTCP) du fichier décrivant le type de médiade communication.

7.8.1. Appel aux interface utilisateur Internet en JAVA

Le programme CFTIUI permet également un accès aux API de CFT depuis un programme JAVA.Le package JAVA nécessaire, et des exemples d’utilisation sont disponibles en téléchargement sur le site web : http://support.axway.com (une identification est requise).

http://support.axway.com/





CFT V2.3 8-1

8. Exploitation de CFT/MVS

8.1. Présentation

Ce chapitre fournit des exemples de JCL à partir desquels l’utilisateur pourra créer des jobscorrespondant à ses besoins d’exploitation de CFT version 2.3.0 et suivantes.

8.2. Mise à jour des procédures de transfert (H80EXEC)

Le JOB H80EXEC contient un exemple de procédures CFT :

· EXECSF : procédure de fin d'émission de fichier,· EXECRF : procédure de fin de réception de fichier,

· SWIACC : procédure soumise au SWITCH du comptable CFT,

· SWILOG : procédure soumise au SWITCH du journal CFT,

Ces procédures sont personnalisées dans la phase A00CUSTO.

8.3. Exemple de JCL de demande de transfert

8.3.1. Média de communication : fichier (CFTSEND)

Ce job est un exemple de JCL de demande de transfert de fichier. A partir de l’exempleCFTSEND, il est possible de créer des jobs répondant aux besoins de l’exploitation.

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/*//




Exploitation de CFT/MVS

CFT V2.38-2

8.3.2. Média 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

//


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 l’exemple CFTMAIN, il est possible de créer des jobs répondant aux besoins de l’exploitation.

Remarque : en réseau TCP/IP, il est nécessaire de s’inspirer de l’exemple CFTMAINT.



CFT V2.3 9-1

9. Création des paramètres CFT/MVS (E50PARM)

9.1. Présentation

L’administrateur de CFT version 2.3.0 et suivantes trouvera, dans ce chapitre, les informationsnécessaires à la création des fichiers paramètres et partenaires de CFT/MVS.

9.2. Création des paramètres CFT/MVS (E50PARM)

Exemple :

E50PARM : mise à jour des paramètres 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


Avant de soumettre ce job, les points suivants doivent être adaptés aux besoins de l’exploitation :

· la clé d’utilisation de CFT Version 2 propre à l’utilisateur,

· les valeurs des paramètres CFT Version 2.

L’exemple de paramétrage est donné dans le fichier CFTV2.SAMPLE (CFTPARM).



Création des paramètres CFT/MVS (E50PARM)

CFT V2.39-2

9.3. Création d’une base VFM (F60VFMC)

Le JOB F60VFMC crée une base VFM. Pour l’utiliser, il convient de disposer de l’option 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

//


L’utilisateur dispose des exemples suivants de commandes VFM :

· VFMCOPY : copie de fichier dans une base VFM,

· VFMASS : copie de fichiers d’une base VFM vers un fichier séquentiel,

· VFMLIST : liste le contenu d’une base VFM.

9.4. Partage d’une base VFM

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




CFT V2.3 9-3

9.5. Mise à jour de SYS1.VTAMLST (G70VTAM)

CFT Version 2 permet le transfert de fichiers à travers des réseaux SNA et X25. Les définitions

suivantes sont nécessaires à VTAM :· des noms d’applications VTAM,

· une INTERPRET table pour la réception des connexions X25 en PCNE,

· des nœuds commutés VTAM pour X25 en mode GATE,

· des nœuds commutés VTAM pour X25 en mode PCNE,

· des nœuds commutés VTAM pour LU 6.2 sur token ring.

Le JOB G70VTAM est un exemple de mise à jour de SYS1.VTAMLST .

9.5.1. Paramètres du NCP pour utiliser “GATE”

Les paramètres suivants sont requis dans le NCP, au niveau X25.MCH :

Exemple :

paramétrage 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. Compléments d’information à propos des réseaux X25

Un réseau X25 géré en “GATE” est décrit dans CFT/MVS par les commandes :

CFTNET TYPE = X25 et CFTX25

Une première forme de paramétrage du nœud commuté VTAM est alors utilisée.

Un réseau X25 géré en mode “PCNE” est décrit dans CFT/MVS par les commandes :

CFTNET TYPE = SNA et CFTSNA

Une seconde forme de paramétrage du nœud commuté VTAM est alors utilisée.

L’utilisation simultanée de “PCNE” et de “GATE” est possible sur une ligne X25.

Il est alors nécessaire de se reporter à la "documentation IBM X25-NPSI " qui présente lesdifférentes combinaisons de paramètres NCP possibles.

9.5.2.1. Utilisation de la sous-adresse dans le numéro d’appel X25

La sous-adresse est utilisable si NPSI est paramétré avec : SUBADDR = YES

Dans ce cas, le caractère de DROITE de la sous-adresse est le service LLCn de NPSI :

n = 0 -> PCNE et n = 4 -> GATE



Création des paramètres CFT/MVS (E50PARM)

CFT V2.39-4

9.5.2.2. Réception d’un appel entrant en PCNE

Il existe deux possibilités :

·

le premier message est associé à un APPLID SNA par une INTERPRET TABLE deVTAM,

· l’APPLID SNA est forcé par un LOGAPPL = de VTAM.

9.5.2.3. Utilisation des USER DATA

Il s’agit de tous les caractères alphanumériques du SAP :

· réception d’un appel entrant en GATE :

- si NPSI contient SUBADDR = YES, alors DIALNO doit se terminer par 4 et lavaleur du SAP est comparée (y compris le 4),

- sinon, le caractère de GAUCHE des USER DATA est le service LLCn de NPSI(exemple : ‘C4’ -> GATE) et la valeur du SAP est comparée (y compris le premier caractère ayant servi à déterminer le service LLC).

9.6. Mise à jour de SYS1.VTAMLIB (G71LOGM)

CFT/MVS permet le transfert de fichiers à travers des réseaux SNA, X25 et LU6.2. Pour cela, ilutilise des paramètres de session qui sont définis dans une table MODETAB, compilée puis LINK-EDITE 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)




CFT V2.3 9-5

//*//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


9.7. Mise en œuvre du système des habilitations

CFT/MVS permet le contrôle des droits d’accès aux paramètres et au catalogue de CFT par appelaux services SAF de OS/390 ou encore par un dispositif propriétaire de CFT.

La mise en œuvre du système des habilitations est décrite dans des documents séparés. Une bonneconnaissance de SAF (RACF) est recommandée.

Les JOB suivants, présents dans la bibliothèque d’installation, sont à utiliser exclusivement dansce cadre :

· H89SAFAS

· H89SAFAU

· H81SAFCD

· H82SAFRT

· H83SAFDA

· H89SAFDD

· H89SAFDS

· H84SAFDF

· H85SAFPR

· H86SAFCR

· H87SECEN

· H88INIT

· H88PARM



CFT V2.3 10-1

10. Installation de l’option XFB.Scope

10.1. Présentation

Ces étapes sont nécessaires dans le cas d’installation de l’option d’administration centraliséeXFB.Scope et/ou du logiciel complémentaire A&P dans le cadre d’une version XFB/CFT V2.3.0.

Les étapes contenues dans cette bibliothèque sont les suivantes :

1. NT00CUST : personnaliser les jobs d'installation.

2. (Utilisateurs de A&P uniquement) NT10LMQS : LINK-EDIT des modules A&P avecmise en œuvre de MQSeries.

3. NT20DEF : Création des fichiers de XFB-SCOPE.4. Modification du paramétrage de CFT (CFTCAT et CFTLOG) : consulter le "Guide

d’installation et d’utilisation MVS" XFB.Scope.


Dans les paragraphes suivants l’utilisateur de CFT/MVS trouvera en quelques mots, la descriptionde la ou des fonctions de ces jobs.

10.2. Personnalisation des paramètres d’installation XFB-SCOPE(NT00CUST)

Ce JOB personnalise les paramètres d’installation. Il est à copier dans une bibliothèque del'utilisateur.

La personnalisation se faisant directement dans la bibliothèque d'installation, il est recommandé dela 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 sizentfnbr '5000' 02 Maximum file number of messagesqltport '44444' 03 XFB-SCOPE TCP/IP port number

qltserver 'ntf.srv.xx' 04 XFB-SCOPE TCP/IP address or namemqgr 'MQME' 05 MQSeries : local queue manager



Installation de l’option XFB.Scope

CFT V2.310-2

mqseries 'MQM' 06 Dataset prefix for MQseriesntfdest 'CFTSCOPP' 07 XFB-SCOPE XCF communication

queuentfaetp 'NTFAETP' 08 AETP : config file with A&Pexclude '' 09 Transfert status to be EXCLUDED

@@

Les paramètres en gras sont à adapter à votre environnement. Les valeurs proposées sontappropriées à la plupart des besoins, sauf « qltserver », adresse IP du serveur XFB-SCOPE àrenseigner obligatoirement.







Ntflen Taille des enregistrement du fichier de mise en attente des événements

Ntfnbr Nombre des enregistrements du fichier de mise en attente des événements

Mqgr Nom du gestionnaire MQSeries

Mqseries Alias des bibliothèques de MQSeries IBM

Qltport Numéro de port TCP du serveur XFB-SCOPE

Qltserver Nom ou adresse IP du serveur XFB-SCOPE, à renseigner OBLIGATOIREMENT

Ntfdest Nom du membre XCF déclaré dans le JOB A12OPTS "NTFDEST= "

Ntfaetp Nom du membre de configuration si utilisation associée à A&P

Exclude Liste des critères d’exclusion des transferts par XFB-SCOPE

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

Ce JOB fait le LINK-EDIT de l’agent utilisé par le logiciel A&P, en liaison avec MQ/series.

Remarque :le code retour du link-edit doit être inférieur ou égal à 4.

10.4. Création de fichiers XFB-SCOPE (NT20DEF)

Ce job crée les fichiers utilisés par XFB-SCOPE :

· fichier des messages en français et en anglais,

· fichier de mise en attente des événements.

Exemple :

//jobname JOB account,'NT20DEF',// CLASS=class,MSGCLASS= msgclass,NOTIFY=userid jobparm

//NTFFILE PROC QUAL=cftv2,// OUT=sysout,




CFT V2.3 10-3

// 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 ) ;

/*


10.5. Utilisation de l’agent externe A&P (CFTAETP)

Le JCL qui suit est un exemple de procédure d’activation de l’agent 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//


La description du paramétrage de l’agent XFB-SCOPE (Fichier CONFIG), se trouve dans ladocumentation spécifique à cette option.

Remarques :

· CFTAETP doit être lancé avant le moniteur CFT. Il peut être lancé sur n’importelaquelle des machines d’un « SYSPLEX »,

· CFTAETP utilise le composant XCF de OS/390.Le nom de la file d’attente, paramètre NTFDEST, est unique pour un SYSPLEX donné.



Installation de l’option XFB.Scope

CFT V2.310-4

Si plusieurs CFT/MVS sont administrés par l’intermédiaire de A&P, il y a 2 possibilités :

- utiliser un seul agent , qui reçoit les événements des CFT/MVS sur une filed’attente XCF. C’est l’option par défaut,

- utiliser plusieurs agents gérant chacun une file d’attente. Il est préférable de recréer

une autre copie de la bibliothèque cftv2.INSTALL à partir de la banded’installation, et d’exécuter au minimum les étapes A00CUSTO, A12OPTS, NT00CUST, NT20DEF, avec de nouveaux paramètres, en particulier Ntfdest quidoit changer.



CFT V2.3 11-1

11. Installation de l’option «Sentinel for XFB»

11.1. Présentation

Les étapes indiquées ci-dessous sont nécessaires dans le cadre d’une installation de l’option‘Sentinel for XFB’, à partir de la version XFB/CFT.231.

1. Mise en place de l’‘Event Router’ et de l’’Universal Agent’.

2. Personnalisation du fichier de configuration Sentinel pour le moniteur.

3. Modification de la procédure de lancement de CFT.

4. Arrêt du moniteur.

5. Relance du moniteur.

L’ordre de ces étapes doit être respecté.

L’installation de l’‘Universal Agent’ n’est nécessaire que dans le cadre d’un suivi bout en bout.

11.2. Mise en place

11.2.1. Mise en place de l’Event Router

Pour une information complémentaire, consulter le «Manuel d’installation de l’’Event Router’ sur MVS».

Lors de la mise en place, préciser l’option de création d’un fichier TAMPON de type LOGGER.

A l’issue de ce processus de mise en place, un fichier TAMPON est créé ; ce fichier est de typeLOGGER. Le nom du fichier est à conserver pour le paramétrage du fichier de configuration.

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

La personnalisation se fait directement dans la bibliothèque 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=*



Installation de l’option «Sentinel for XFB»

CFT V2.311-2

//SYSTSIN DD DUMMY//CFTIN DD DATA,DLM='@@'sntlocad '127.0.0.1' 01 Sentinel local TCP/IP addresssntladdr 'sntl.srv.xx' 02 Sentinel tracker TCP/IP addresssntlp '41111' 03 Sentinel tracker TCP/IP portsntlqueue ' AXQSENT2' 04 Sentinel tracker queue XCF/SOPIX

sntlgstr 'EVROUT.LOGGER ' 05 Sentinel tracker logstream name@@


Dans le cas d’une connexion avec l’EVENT ROUTER via XCF, il est nécessaire de modifier manuellement le fichier de configuration pour activer ce mode de communication et de mettre, encommentaire, les lignes correspondant aux paramètres :

TRKIPADDR=sntladdr

TRKIPPORT=sntlp


La valeur de ces mots-clés doit figurer entre ‘apostrophes’.





sntlocad Adresse locale (TCP/IP)

sntladdr Adresse de l’EVENT-ROUTER, (TCP/IP)

sntlp Port de l’EVENT-ROUTER (TCP/IP)

sntlqueue Identification de la Queue en mode de connexion XCF avec l’EVENT ROUTER, il n’est

pas utile de renseigner les paramètres sntladdr – sntlp

sntlgstr Identifiant du fichier LOGGER (le nom de doit pas dépasser 26 caractères)

La description des paramètres généraux est décrite dans la documentation de l’’Event Router’ .

Le fichier SNTLCNF est présent à titre d’exemple :

TRKTRACE=0TRKPRODUCTNAME=API-SCRIPT

TRKMODELDIR=cftv2.XMLLIBTRKMODELEVENT=TRKEVENTTRKMODELLINK=TRKLINKCTRKMODELLOG=TRKLOG

------TRKIPADDR=sntl.srv.xx Adresse de l’’Event Router’TRKIPPORT=41111 PortTRKLOCALADDR=127.0.0.1

ou

TRKTYPE=XCFTRKSVC=200




CFT V2.3 11-3

TRKQUEUE=AXQSENT2 Queue définie au niveau de l’’Event Router’

------

TRKTNAME=EVROUT.LOGGER XFB.Sentinel=YES

XFB.Transfer=ALLXFB.log=E

Mots-clés spécifiques au moniteur :

· XFB.Sentinel,

· XFB.Transfer,

· XFB.log.

Ces paramètres sont décrits dans la « Note de diffusion » du moniteur CFT.

11.2.3. Modification de la procédure de lancement de CFT

Au niveau de la procédure de lancement, il est nécessaire d’ajouter l’assignation du fichier deconfiguration (ddname = TRKCNF).

Exemple :

//TRKCNF DD DISP=SHR,// DSN=cftv2.INSTALL(SNTLCNF)

Lors de l’exécution, la tâche dédiée à la gestion des messages à destination de «Sentinel for XFB» va allouer une sysout (ddname=TRKPRINT) destinée à une trace possible ou à des

messages d’erreurs.

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 cefichier paramètre, faire un arrêt / relance du moniteur.

11.2.5. Mode d’envoi des messages

Le paramètre TRKTMODE, au niveau du fichier de configuration, permet de gérer le moded’envoi des messages à destination de «Sentinel for XFB».

Valeurs possibles :

· TRKTMODE=I immédiat, valeur par défaut,

· TRKTMODE=D différé, les messages sont directement insérés dans le fichier Tampon,

· TRKTMODE=R retry, permet de gérer un temporisation à l’aide du paramètreTRKTCONNRETRY=nn dans le cas d’un problème deconnexion avec «SENTINEL».



Installation de l’option «Sentinel for XFB»

CFT V2.311-4

11.2.6. Remplacement de l’option XFB.Scope

Au niveau du JCL de lancement de CFTMAIN, la carte //CFTNTFC DD .. n’a plus lieud’être.

Au niveau du fichier de paramétrage CFT, si le paramètre NTF=YES est codé dans la commandeCFTCAT, il faut impérativement avoir au niveau du JCL de lancement de CFT la référence aufichier de configuration «Sentinel for XFB», via le DDNAME «TRKCNF ».Dans le cas ou le fichier de configuration n’est pas présent, le moniteur s’arrêtera lors de la première notification Un message du type ‘CFTS29I Cannot acces XTRK task _ Shutdown in progress’ précédera l’arrêt du moniteur.

11.3. Exemples de procédures pour un suivi de bout en bout

Dans le cadre d’un suivi de bout en bout deux JCL sont livrés dans la librairie SAMPLE :

· SNTLCFT : dépôt d’une commande de transfert d’un fichier à l’aide de l’utilitaireCFTUTIL avec un même ‘CycleID’ qu’au niveau du ‘SENDEVENT’ réalisé par l’utilitaire TRKUTIL.

· SNTLEXEC : procédure de fin de transfert associant un acquittement à l’aide del’utilitaire CFTUTIL et des ‘COMPUTEIDENT’, ‘SENDEVENT’, ‘SENDCYCLE’réalisés par l’utilitaire TRKUTIL.

Remarque :l’utilitaire TRKUTIL est mis en place lors de l’installation du produit « Sentinel for XFB ».



CFT V2.3 12-1

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

12.1. Format du support d’installation

Le format d’une bande PTF est identique à celui d’une bande d’installation.

CFT/MVS PTF MVS est livré sur un support magnétique contenant les fichiers indiqués dans letableau ci-dessous.

Tableau 12. Contenu de la bande d’installation


INSTALL 1 Mises à jour des JCL d’installation

SAMPLE 2 Mises à jour des SAMPLEOBJ 3 Nouveaux modules

PFTOBJ 4 Modules OBJECT mis à jour

DOC 5 Documentation mise à jour

CNTL 6 Fichiers de contrôle

MAC 7 Macros

SCR 8 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 procédure est similaire à une installation initiale (voir le chapitre « Restauration de labibliothèque d’installation»). En général, seulement deux fichiers (CNTL et PTFOBJ) sont livrés.

12.1.2. Mise à jour de CFT/MVS par Internet

Des fichiers de mise à jour peuvent être mis à disposition ou livrés par Internet. Dans ce cas, vousdevez suivre les instructions accompagnant ces fichiers.

12.2. Restauration de la bande d’installation CFT/MVS (A13PTF)

Ce JOB restaure les fichiers de la bande d’installation ou d’une bande de PTF. Il est livré avec la bande d’installation. Le nom de volume d’une bande PTF est indiqué sur la bande.

Remarque : les bandes de PTF sont cumulatives.Une bande d’installation (ou un CD) de CFT/MVS peut également contenir des PTF. Dans ce cas,l’installation inclura automatiquement les PTF.

La mise à jour des JCL d’installation n’est pas automatique. Il est conseillé de recréer le fichier INSTALL.



Installation de PTF sur CFT/MVS V2.3.0

CFT V2.312-2

12.3. Informations importantes

Il est nécessaire 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 detoutes les PTF contenues dans cette bande.

12.4. Prise en compte des PTF

Après chargement de la bande, il est nécessaire de refaire les LINK-EDIT suivants :

· B20LINK : LINK EDIT général de tous les modules CFT,

· B22LTCP : LINK EDIT spécifique de l’interface réseau TCP/IP,

·

NT10LMQS : LINK-EDIT spécifique de l’agent A&P.

12.5. Prise en compte de nouveaux menus de l’interface interactive

Les JOBs C31SCRFR et C31SCRUK permettent de mettre à jour les menus de l’interfaceinteractive en français et en anglais.

12.6. Sauvegarde/Restauration du paramétrage CFT/MVS

A la mise à jour du noyau CFT/MVS, il est parfois nécessaire de sauvegarder le paramétrageexistant, puis de le recharger avec la nouvelle version de l’utilitaire CFTUTIL. Cette éventualitévous sera signalée dans le fichier CFTV2.DOC(IMPORTAN).

Cette fonction est réalisée de manière simple avec la commande CFTEXT de CFTUTIL, dontl’utilisation vous est rappelée dans le paragraphe ci-après.

12.6.1. Extraction des paramètres CFT : CFTEXT

12.6.1.1. Fonction

L’exemple CFTEXT restitue un fichier des paramètres de CFT, tels qu’ils ont été soumis par lescommandes de paramétrage de type CFTxxxx (sauf les commentaires).

Le paramètre TYPE permet de sélectionner le type de commande.

En l’absence d’une précédente commande CONFIG TYPE=OUTPUT, le compte rendu del’exécution est écrit sur la sortie standard du programme CFTUTIL.




CFT V2.3 12-3

12.6.2. Procédure de sauvegarde du paramétrage

Cette procédure sera lancée AVANT l’installation de la nouvelle version CFT/MVS.

Exemple de JCL de sauvegarde du paramétrage 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.BACKUPCFTEXT TYPE=ALL

//


Remarque : ne pas tenter d’extraire le paramétrage CFT/MVS dans un membre de PDS.

12.6.3. Procédure de restauration du paramétrage

Cette procédure sera lancée APRES l’installation de la nouvelle version CFT/MVS.Exemple de JCL de création du paramétrage 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.312-4

12.7. Sauvegarde/Restauration des fichiers CATALOGUECOMMANDE

A la mise à jour du noyau CFT/MVS, il est parfois nécessaire de sauvegarder/recréer les fichierscatalogue et commandes de CFT.

La syntaxe des commandes se trouve dans le «Manuel de référence» de CFT.

Le fichier MIGR2022 est un exemple de sauvegarde/restauration des 2 fichiersCFTCAT/CFTCOM.

Remarques :

· il faut utiliser le module de migration de la même version que le fichier à migrer.Il faut effectuer le déchargement avec la version courante et le chargement du nouveaufichier avec la nouvelle version,

· cet utilitaire est également approprié pour agrandir un fichier CATALOGUE.

Ne pas tenter d’extraire les fichiers de CFT/MVS dans des membres de PDS.



CFT V2.3 13-1

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

13.1. Format du support d’installation

Une PTF est le résultat d’une mise en forme fixe (80) d’un fichier de type ADRDSSU contenantles librairies de mise à jour. Le format de la PTF est commun à tous les modes de livraison ou demise à disposition.

Remarque : Les PTF sont cumulatives.Une installation (de base) de CFT/MVS peut également intégrer des PTF. Dans ce cas, il faudrales appliquer une à une.

Tableau 13. librairies prises en compte lors du DUMP ADRDSSU

Librairies Contenu

INSTALL Mises à jour des JCL d’installation

SAMPLE Mises à jour des SAMPLE

PFTOBJ Modules OBJECT mis à jour

DOC Documentation mise à jour

CNTL Fichiers de contrôle

MAC Macros

SCR 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 identfiée sous le nom CF0xxxxx où xxxxx est le numéro de PTF à appliquer.

13.1.2. Mise à jour de CFT/MVS par CD

Les fichiers de PTF sont à transférer, 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 numéro de PTF à appliquer.

13.1.3. Mise à jour de CFT/MVS par Internet

Les fichiers PTF peuvent être mis à disposition ou livrés par Internet.

Les fichiers de PTF sont à transférer, via FTP par exemple, sur le site central en binaire.




CFT V2.313-2

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

Ce JOB restaure le fichier d’une bande de PTF. Il est mis en place lors de la phase d’installation.

Le nom de volume est indiqué sur la bande.Le fichier de PTF sera restauré par IEBCOPY dans une librairie intermédiaire (UPLIB), préfixée par l’ALIAS de l’environnement 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 à transférer en binaire sur le site central (à partir de la station de travail ou à partir du Host), dans une librairie UPLIB prévue à 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 numéro de PTF,

· dznindx est le préfixe de l’environnement de distribution,· la librairie dznindx.UPLIB a été créée lors de la phase d’installation du produit.

13.3.2. Récupération 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 transférer en binaire le fichier de PTF via FTP.

Au niveau du JCL, il convient de préciser l’adresse de la station de travail ainsi que l’identifiant dela PTF (à préciser 2 fois).

13.4. Prise en compte des PTF

Après le chargement de la bande ou le transfert des fichiers PTF, il est nécessaire d’intégrer leséléments composants la PTF dans les librairies de distribution. Cette opération se réalise à l’aidedu JCL :

A13PTFLD : intégration des PTF dans les librairies de distribution.




CFT V2.3 13-3

Avant de soumettre le JOB il faut préciser au niveau de la carte EXEC l’identifiant de la PTF :

//* -------------------------------------//* Execute procedure//* -------------------------------------

//LOADPTF EXEC LOADPF,PTF=CF0xxxxx Must be cutomized

Ce JOB se déroule 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 trouventdans la librairie de distribution ‘.DOC’, sous le nom CVSxxxxx où xxxxxx est l’identifiant de laPTF. Elle décrit l’incident, la correction et la façon d’appliquer la PTF pour les cas particuliers(Exit …) .

13.6. Application d’une PTF (A13PTFLK)

Dans la plupart des cas, une PTF se traduit par l’application d’un LINK-EDIT.

Il existe deux modes d’application d’une correction :

· correction de mise à niveau,

· correction incrémentale (contacter le Support XFB/CFT chez Axway Software).

Le mode d’application se détermine en choisissant le plan de LINK-EDIT à appliquer :

· CCFxxxxx pour une correction de mise à niveau,

· CCAxxxxx pour une correction incrémentale.

Avant de soumettre le JOB, il convient de préciser au niveau de la carte EXEC l’identifiant du plan de link-edit :


//APPLY EXEC APPLY,SSIREF=CCyxxxxx Must be customized

Remarques :

· y : mode de correction,

· xxxxx : identifiant de la correction.




CFT V2.313-4

Ce JOB se déroule en deux étapes :

· 1 : sauvegarde de la librairies des LOAD (dont un des qualifiants est l’identifiant dela PTF),

· 2 : LINK-EDIT.

13.7. Restauration de la librairie des exécutables (A13RSTOR)

Le JCL permet en cas d’incident sur l’application d’une PTF ou lors du test de validation de celle-ci de restaurer la librairie des exécutables avant son application.


//* -------------------------------------//* Execute procedure

//* -------------------------------------//RESTOR EXEC RESTOR,SSIREF=CCyxxxxx Must be customized

Remarque :le moniteur devra être arrêté.

13.8. Suppression d’une version de sauvegarde (A13SDEL)

Ce job permet de supprimer un fichier de sauvegarde après validation de l’application d’une PTF(sachant que chaque sauvegarde représente environ 130 cylindres de 3390).



//DELSAV EXEC DELSAV,SSIREF=CCyxxxxx Must be customized

13.9. Prise en compte de nouveaux menus de l’interface interactive

Les JOBs C31SCRFR et C31SCRUK permettent de mettre à jour les menus de l’interfaceinteractive en français et en anglais.

13.10. Sauvegarde/Restauration du paramétrage CFT/MVS

A la mise à jour du noyau CFT/MVS, il est parfois nécessaire de sauvegarder le paramétrageexistant, puis de le recharger avec la nouvelle version de l’utilitaire CFTUTIL. Cette éventualitévous sera signalée dans le fichier CFTV2.DOC(IMPORTAN).

Cette fonction est réalisée de manière simple avec la commande CFTEXT de CFTUTIL, dont

l’utilisation vous est rappelée dans le paragraphe ci-après.




CFT V2.3 13-5

13.10.1. Extraction des paramètres CFT : CFTEXT

13.10.1.1. Fonction

L’exemple CFTEXT restitue un fichier des paramètres de CFT, tels qu’ils ont été soumis par lescommandes de paramétrage de type CFTxxxx (sauf les commentaires).

Le paramètre TYPE permet de sélectionner le type de commande.

En l’absence d’une précédente commande CONFIG TYPE=OUTPUT, le compte rendu del’exécution est écrit sur la sortie standard du programme CFTUTIL.

13.10.2. Procédure de sauvegarde du paramétrage

Cette procédure sera lancée AVANT l’installation de la nouvelle version CFT/MVS.

Exemple de JCL de sauvegarde du paramétrage 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.BACKUPCFTEXT TYPE=ALL

//


Remarque : ne pas tenter d’extraire le paramétrage CFT/MVS dans un membre de PDS.

13.10.3. Procédure de restauration du paramétrage

Cette procédure sera lancée APRES l’installation de la nouvelle version CFT/MVS.Exemple de JCL de création du paramétrage 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.313-6

// PEND//PARM EXEC CFTPARM

13.11. Sauvegarde/Restauration des fichiers CATALOGUE

COMMANDE

A la mise à jour du noyau CFT/MVS, il est parfois nécessaire de sauvegarder/recréer les fichierscatalogue et commandes de CFT.

La syntaxe des commandes se trouve dans le «Manuel de référence» CFT.

Le fichier MIGR2022 est un exemple de sauvegarde/restauration des 2 fichiersCFTCAT/CFTCOM.

Remarques :

· il faut utiliser le module de migration de la même version que le fichier à migrer.Il faut effectuer le déchargement 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 d’extraire les fichiers de CFT/MVS dans des membres de PDS.



CFT V2.3 14-1

14. Interfaces de programmation

14.1. Présentation

Ce chapitre décrit les procédures de mise en œuvre, des interfaces de programmation CFT (batchet 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 l’interface de programmation est donnée dans le “Guide de programmation” deCFT.Cette interface de programmation est accessible depuis les langages de programmationAssembleur, Cobol, C. Des exemples se trouvent dans le fichier CFTV2.SAMPLE.

Les règles de chargement et d’exécution 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 nécessaired’inclure le texte USERAPI livré à l’utilisateur de CFT Version 2.

A l’exécution, une JOBLIB/STEPLIB contenant le LOAD-MODULE ‘CFTAPI’ est nécessaire.

Des exemples de LINK EDIT se trouvent dans les membres LINKAPI et I92APILK (LINK-EDITdes exemples livrés) de la bibliothèque 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



Interfaces de programmation

CFT V2.314-2

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

/*//


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 sélection, de la zone cataloguerendue,...

· en Cobol :

- O$APIC utilisation CFTC,

- O$APII utilisation CFTI,

- O$APIU utilisation CFTU,

- O$APISW dépôt d'une requête et attente du résultat,

- OAPIUST 'clause copy' de description de la zone de sélection, de la zone cataloguerendue,...

En Cobol le mode d’appel 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 sélection, de la zone cataloguerendue,...

Les JCL de compilation, LINK-EDIT et exécution 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

L’interface de programmation, sous CICS, permet aux utilisateurs d’accéder au catalogue et/ou dedéposer des commandes dans le média de communication CFT/V2, à l’aide de transactions.

Cette interface se compose de deux programmes COBOL :

· CFTI gérant les accès au catalogue via un index secondaire,

· CFTC gérant les accès au fichier de communication.

L’installation des deux modules peut se faire indépendamment en fonction des besoins.

L’utilisateur devra disposer d’une version de CICS égale ou supérieure à la 2.1 et suivantes.




CFT V2.3 14-3

14.3.1. Interrogation du catalogue : CFTI

14.3.1.1. Paramétrage de CICS

1. Référencer le programme dans la Processing Program Table :

OBJECT CHARACTERISTICSCEDA ViewPROGram : CFTIGroup : CFTLanguage : Cobol Cobol ! Assembler ! Pli ! RpgRELoad : No No ! YesRESident : No No ! YesRSl : 00 0-24 ! PublicStatus : Enabled Enabled ! Disabled

Processing Program Table CFTI.

2. Définir la voie d’accès au catalogue dans la File Control Table.

Le nom, correspondant au DDNAME du fichier, sera un nom mnémonique de septcaractères au maximum.

Ce nom mnémonique aura la valeur “CFTCATx” (x prenant une valeur numériquequelconque ou blanc). Par défaut, il prendra la valeur “CFTCAT”. Le suffixe permet defaire la relation entre le fichier catalogue et le fichier de communication. Il permetégalement de travailler avec plusieurs couples CFTCATx/CFTCOMx de différentsCFT.

CFTCATx DFHFCTTYPE=DATASET,

FILE=CFTCATx,DSNAME=CFTV2.CFTPATHx,

DISP=SHR,ACCMETH=(VSAM),FILSTAT=(OPENED,ENABLED),SERVREQ=(BROWSE,READ),RECFORM=(VARIABLE,BLOCKED),

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

STRNO=2File Control Table




CFT V2.314-4

14.3.2. Commandes de transferts : CFTC

14.3.2.1. Paramétrage de CICS

1. Référencer le programme dans la Processing Program Table :

OBJECT CHARACTERISTICSCEDA ViewPROGram : CFTCGroup : CFTLanguage : Cobol Cobol ! Assembler ! Pli ! RpgRELoad : No No ! YesRESident : No No ! YesRSl : 00 0-24 ! Public

Status : Enabled Enabled ! Disabled

Processing Program Table

2. Définir le fichier de communication dans la File Control Table.

Le nom, correspondant au DDNAME du fichier, sera un nom mnémonique de septcaractères au maximum.

Ce nom mnémonique aura la valeur “CFTCOMx” (x prenant une valeur numériquequelconque ou blanc). Par défaut, il prendra la valeur “CFTCOM”.

CFTCOMx DFHFCT

TYPE=DATASET, FILE=CFTCOMx,DSNAME=CFTV2.CFTCOMx,

DISP=SHR,ACCMETH=(VSAM),

FILSTAT=(OPENED,ENABLED),

SERVREQ=(UPDATE,READ),

RECFORM=(VARIABLE,BLOCKED),RSL=PUBLIC,BUFNI=1,BUFND=2,STRNO=2

File Control Table




CFT V2.3 14-5

14.3.2.2. Définition du fichier de communication

Le fichier de communication sera défini par une commande “CFTFILE” (consulter le“Manuel deréférence” de CFT ).

Remarque : il est obligatoire de définir un fichier de communication SPECIFIQUE aux applications CICS.

14.3.3. Utilisation

14.3.3.1. Syntaxe d’appel

Les deux programmes sont appelés par "LINK" en passant une "COMMAREA", contenant les

différentes zones de l’API batch. La clause copy de la "COMMAREA" est fournie avec l’API.EXEC CICS LINK

PROGRAM (’CFTx’)COMMAREA (CFTARA)LENGTH (CFTARA-LGR)

END-EXEC.

x représentant le caractère ‘C’ ou ‘I’.

14.3.3.2. Codes retour

Les codes retour sont identiques à ceux de l’API batch.Si une erreur se produit sur un ordre CICS, la zone "CFTARA-RESERVE" contient le nom de lacommande ayant provoqué l’erreur (EIBFN), la “response code CICS” (EIBRCODE) et les deuxcodes complémentaires (EIBRESP, EIBRESP2).

14.3.3.3. Interrogation du catalogue : CFTI

Les paramètres étant identiques à l’API batch, seules les différences sont décrites dans ce paragraphe (consulter le “Guide de programmation” de CFT) :

· initialisation : OPEN.

Ce service permet de savoir à quel catalogue CFT et à quel fichier de communicationl’utilisateur s’adresse ; il permet également de vérifier sa bonne définition sous CICS.Le paramètre "D-CAT" contiendra le nom du catalogue,

· sélection : SELECT.

Les critères de sélection possibles sont les suivants :

- TYPE : Type de transfert,

- DIRECT : Direction,

- STATE : Etat,

- PART : Partenaire,

- IDF : Identifiant de fichier,




CFT V2.314-6

- IDT : Identifiant de transfert,

- BDATE : Date de début de transfert,

- EDATE : Date de fin de transfert,

- des masques (xx*yy?z) sont utilisables pour les champs PART, IDF, IDT :

‘*’ pour une chaîne de caractères,‘?’ pour 1 caractère,

· scrutation : NEXT.Délivrance des enregistrements du catalogue suivant les critères de sélection,

· modification : MODIFY.Modification de l’état du transfert du poste du catalogue précédemment lu.La commande correspondante sera déposée dans le fichier CFTCOMx correspondant aucatalogue CFTCATx, x étant un caractère alphanumérique quelconque ou ‘ ’,

· terminaison : CLOSE.Libération des blocs de contrôle.

14.3.3.4. Commandes des transferts : CFTC

Les commandes sont traitées sans analyse syntaxique :

· allocation : COM.

La commande "COM" permet de définir un type de média de communication. Le seultype média supporté sous CICS est le type "F=" pour fichier. Ce paramètre sera suividu nom du fichier de communication,

· autres commandes.

La zone "Z-CMD" contient les paramètres de la commande à exécuter.

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 définition des enregistrements catalogue se trouve dans le fichier




CFT V2.3 14-7

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

14.4. VFM : mise en oeuvre sous OS/390

La description de l’interface de programmation est donnée dans le “Guide d'utilisation del'interface de programmation VFM” de CFT. Cette interface de programmation est accessible depuis les langages de programmationAssembleur, Cobol, C. Des exemples se trouvent dans le fichier CFTV2.SAMPLE.

Les règles de chargement et d’exécution du code utilisateur sont :

1. Chargement RMODE=ANY.


Lors du LINK-EDIT du programme utilisant les services de CFT Version 2, il est nécessaired’inclure le texte USERAPI livré à l’utilisateur de CFT Version 2.

A l’exécution, une JOBLIB/STEPLIB contenant le LOAD-MODULE ‘CFTAPI’ est nécessaire.

Des exemples de LINK EDIT se trouvent dans les membres LINKAPIV de la bibliothèqued'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)

/*//





CFT V2.314-8

14.4.1. Exemples de programmation

Des exemples se trouvent dans le fichier CFTV2.SAMPLE :

·

en Assembleur :A$APVXP1.AAPVUST 'macro' de description des paramètres,

· en Cobol :

O$APVXP1, O$APVXP2.OAPVUST 'clause copy' de description des paramètres.

En Cobol, le mode d’appel statique est imposé,

· en langage C :

C$APVL, C$APVU.

CAPVUST 'include' de description des paramètres.



CFT V2.3 15-1

15. Exits

15.1. Exit ASIT

La description de l’exit ASIT de CFT Version 2 est donnée dans le “Guide des protocoles” deCFT.Il est obligatoirement écrit en assembleur.

Les règles de chargement et d’exécution de l’exit sont :

1. Chargement RMODE=24.


La liste de paramètres est adressée en 24 BITS.

Le JOB suivant est un exemple de LINK-EDIT de l’exit 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 PERSONNALISERNAME CFTASX(R) OBLIGATOIRE

//


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 l’exit-list, il est nécessaire de créer le LINK-EDIT grâce au JOB LINKEXIL de lalibrairie CTTV2.INSTALL.

Pour toute information complémentaire, se reporter au “Guide de l’Exit-list” de CFT.



Exits

CFT V2.315-2

15.3. Exits de CFT

La description générale des exits est donnée dans le "Guide de programmation" de CFT.

Ce chapitre donne les compléments nécessaires à la réalisation d’exits sous OS/390.

15.3.1. Introduction aux exits de CFT

CFT offre à l’utilisateur plusieurs familles d’exits :

· type annuaire (*)=A

· type fichier (*)=F

· type fin de transfert (*)=E

· type carte ETEBAC3 (*)=3

(*) Dans la suite des explications, le caractère ‘*’ fait référence aux 4 exits et sera remplacé par l’un des 4 caractères "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 l’adresse est rendue par le programme d’initialisationEX*INI.

Le programme ‘EX*INI’ et le programme principal sont écrits par l’utilisateur de CFT, puisLINK-EDITE avec le moniteur d’exits.

Le nom de la fonction d’init "EX*INI" est imposé selon l’exit :· EXAINI : type annuaire,

· EXFINI : type fichier,

· EXEINI : type fin de transfert,

· EX3INI : type carte ETEBAC3.

Le programme exit est chargé dynamiquement par CFT à la première demande. Il s’exécutecomme une sous-tâche OS du moniteur.

Les programmes seront écrits par l’utilisateur en ASSEMBLEUR 370, en C IBM ou en COBOLfor OS/390 version 1.2 et supérieures. L’utilisation simultanée de C et de COBOL est possible.

Les programmes peuvent être appelés consécutivement pour des transferts différents. Les programmes doivent donc être réutilisables en série. Chaque zone de données du programme seraréinitialisée à chaque appel, et NON PAS déclarée avec une valeur initiale.

Plusieurs exits différents peuvent s’exécuter simultanément, chacun étant une tâche indépendante.Il est donc impossible à 2 exits d’écrire dans le même fichier, en particulier les fichiers‘SYSPRINT’, ‘SYSDBOUT’ ‘STDOUT’ de mise au point des langages C ou COBOL.

L’interface exit communique avec le moniteur en utilisant des zones mémoire en 31 bits. Le nomdes load-module exits doit toujours commencer par les 6 caractères ‘CFTEXI’.

Les exits sont appelés en mode problème et clé utilisateur. Ils ont les mêmes privilèges que lemoniteur CFT qui est le plus souvent un programme autorisé.




CFT V2.3 15-3

L’option de mise au point SGTRACE 512 permet d’obtenir dans le fichier SGTRACE lesinformations suivantes, avant chaque appel de la fonction de traitement :

· ‘EX*3RUN-PARM1-5’ : 5 mots en hexadécimal :

- mot 1 : adresse de traitement,

- mots 2 à 5 : adresses des 4 paramètres reçus,· ‘EX*3RUN-DUMPCTX’ : 32 ou nnnn octets en hexadécimal.

Les 32 premiers octets (SGTRACE=512) ou la totalité (SGTRACE=544) de la zone paramètre passée à l’exit sont listés.

En cas d’abend dans l’exit, la fonction de traitement des erreurs de CFT prend la main : undiagnostic sommaire de l’erreur est affiché à la console MVS.

Exemple de diagnostic CFT :

SGAB00E: Jobname Stepname SITMOS Date Heure VersionABEND = 84sssuuu , PSW =xxxxxxxx xxxxxxxx , EPA =xxxxxxxxSGAB01E: REG 0-7 =xxxxxxxx .......

SGAB02E: REG 8-15=xxxxxxxx ......SGAB03E: SGNUC =xxxxxxxx , TRACE =xxxxxxxx ...SGAB08E: INSTRUCTIONS : xxxxxxxx:-6 xxxxxxxSGAB08E: ** USER EXIT ABEND DETECTED ** L=l EPA= x NAME=ModSGAB30E: xxxxxxxx CFTEXInn TCB: Tcbaddr SGNUC: xxx EPA : EpaSGAB09E: 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 détecte l’absence de réponse de l’exit et le transfert passe en état HOLD.

Dans le cas d’un Exit en COBOL ou en C, le diagnostic est également disponible dans le fichier ’CEEDUMP’ .

15.3.2. Réalisation des exits en assembleur 370

Pour réaliser des exits en assembleur 370, vous disposez des fichiers suivants :

· CFTV2.SAMPLE(A$EXFINI) :exemple de programme EXFINI écrit en assembleur.

Cet exemple rend l’adresse 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 l’interface RACF et vérifie que le demandeur ou le destinataire dufichier a le droit d’y accéder.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 d’échange avec le moniteur CFT.Toutes les macros assembleur sont de la forme "AEX*UST".



Exits

CFT V2.315-4

· 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 estlibre. L’exemple précité fonctionne en RMODE ANY.

Le mode d’adressage AMODE est 24 ou 31 bits. L’exemple précité fonctionne en AMODE 31.

Cet exemple suppose que le moniteur CFT est un programme autorisé.

Pour réaliser des exits en assembleur 370, vous disposez des fichiers indiqués dans le tableausuivant :

Tableau 14. Réalisation des exits en assembleur 370

Fichier Définition

A$EX*INI Exemple de programme init écrit en assembleur

Cet exemple rend l’adresse de traitement

A$EX*XMP Exemple de programme de traitement ’EX*XMP1’

Cet exemple est lié au type d’exit

AEX*UST Macro contenant les DSECT des zones d’échange avec le moniteur CFT

LINKEX*A 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) OBLIGATOIREINCLUDE USER(A$EXFINI) ** A PERSONNALISERINCLUDE USER(A$EXFXMP) ** A PERSONNALISERMODE AMODE(31) ** A PERSONNALISERMODE RMODE(ANY) ** A PERSONNALISERENTRY CFTEXIT OBLIGATOIRENAME CFTEXIfa(R) Change 'fa' digits

ONLY//





CFT V2.3 15-5

15.3.3. Réalisation des exits en C

Pour réaliser des exits en C, vous disposez des fichiers suivants :

·

CFTV2.SAMPLE(C$EXFINI) :exemple de programme EXFINI écrit en C.

Cet exemple rend l’adresse 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. Exemples pour la réalisation d’un exit annuaire en C

Fichier Définition

C$EXAINI Exemple de programme EXAINI écrit en C

Cet exemple rend l’adresse de traitement ’EXAXMP1’

C$EXAXMP Exemple de programme de traitement ’EXAXMP1’

CEXAUST Include C contenant les zones d’échange avec le moniteur CFT

LINKEXLE Modules du moniteur pour des exits contenant au moins 1 module écrit en C

Le mode de chargement RMODE est libre.

Le mode d’adressage AMODE 31 est imposé .

Les fonctions d’entrées-sorties ‘GETx’ et ‘PUTx’ ne sont pas utilisables car s’adressant auxfichiers ‘SYSIN’ et ‘SYSPRINT’. A la place, utiliser ‘FGETx’ et ‘FPUTx’ en précisant un nom defichier différent dans chaque exit.

Le programme ‘MAIN’ reçoit par défaut les paramètres d’exécution 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)



Exits

CFT V2.315-6

Ces options sont contenues dans le module ‘EXIPARMD’ que l’utilisateur peut réécrire enassembleur si besoin est, selon l’exemple qui suit :EXIPARMD CSECT , Obligatoire

DC AL2(FINPARMC-DEBPARMC) ObligatoireDEBPARMC 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 0C ObligatoireEND

Ce module sera toujours inclus avant LINKEXLE dans le LINK-EDIT.

Exemple de LINK-EDIT s’appliquant é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) OBLIGATOIREINCLUDE USER(C$EXFINI) ** A PERSONNALISERINCLUDE USER(C$EXFXMP) ** A PERSONNALISERMODE AMODE(31) OBLIGATOIREMODE RMODE(ANY) ** A PERSONNALISERENTRY CFTEXIT OBLIGATOIRENAME CFTEXIfc(R) Change 'fc' digits ONLY.

//





CFT V2.3 15-7

En cas d’abend dans l’exit, CFT liste dans le diagnostic sommaire les modules appelés en ordreinverse de l’appel :

C/DSA = Adsave MODULE = exfxmp1 AAAAMMJJHHmm EPA= xx RET= xx+OffsetC/DSA = Adsave MODULE = exfrun AAAAMMJJHHmm EPA= xx RET= xx

+Offset C/DSA = Adsave MODULE = main AAAAMMJJHHmm EPA= xxRET= xx +Offset

Avec :

· C/DSA : adresse de la save area du module appelé,

· MODULE : nom de la fonction C,

· AAAAMMJJHHmm : année, mois, jour, heure, minute de la compilation du programmesource,

· EPA : adresse d’entrée dans la fonction,

· RET : adresse de retour à l’appelant,

· Offset : déplacement 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 CDIAGNOSIS.

15.3.4. Réalisation des exits en COBOL for OS/390

Pour réaliser des exits en COBOL, vous disposez des fichiers suivants :

· CFTV2.SAMPLE(A$EXFINI) :

exemple de programme EXFINI écrit en assembleur.Cet exemple rend l’adresse 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 compilés avec l’option suivante : RENT.

Le LINK-EDIT est identique à celui d’un exit en C.



Exits

CFT V2.315-8

Pour réaliser des exits en COBOL, vous disposez des fichiers indiqués dans le tableau suivant.

Tableau 16. Réalisation des exits en COBOL

Fichier Définition

ASEX*INI Exemple de programme init écrit en assembleur

Cet exemple rend l’adresse de traitementCe programme ne peut être écrit en COBOL

O$EX*XMP Exemple de programme de traitement

OEX*UST Clause COPY contenant les zones d’échange avec le moniteur CFT

15.4. Appel des API de CFT dans les EXITS

L'appel aux APIs (consultation du catalogue et dépôt de requêtes à CFT) est supporté dans lesExits.Seul le dépôt de commandes à CFT par le service de MAILBOX n’est pas supporté.



CFT V2.3 16-1

16. Commandes de l’interface opérateur de CFT sous OS/390

16.1. Présentation

Ce chapitre permet à l’utilisateur de CFT Version 2.3.0 et suivantes de mettre en œuvre lescommandes de diagnostics, permettant la recherche d’anomalies dans le fonctionnement de CFTVersion 2.

16.2. Commandes de l’interface opérateur

L’interface opérateur de CFT sous OS/390 accepte deux types de commandes :

· la plupart des commandes CFT Version 2 décrites dans le “Manuel de référence” deCFT ,

· les commandes de diagnostic décrites dans ce chapitre.

16.2.1. Réponse de l’interface opérateur

L’interface opérateur de CFT sous OS/390 fournit les réponses suivantes :

·

SGOP02I Command Complete jj/mm/aaaa, hh:mm:ss. ; la commande est traitée sanserreur,

· CFTT00W CFT request warning - Unknown oper request ; la commande est inconnue deCFT,

· SGOP03E Command error,RC=xxxxxxxx. ; la commande se termine avec le code retour xx,

· SGCM03E Command ignored; le moniteur CFT n’est pas prêt à traiter cette commande.

16.3. Commandes de diagnostic

Les commandes de diagnostics sont destinées à la recherche des anomalies de fonctionnement deCFT Version 2. Elles doivent être utilisées à la demande du Support Client de CFT Version 2 et

sur ses directives. Le format et l’utilisation de ces commandes sont expliqués ci-après.



Commandes de l’interface opérateur de CFT

sous OS/390

CFT V2.316-2

16.3.1. Format et utilisation des commandes de diagnostic

16.3.1.1. Commande SGTRACE

La commande SGTRACE permet de gérer 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 numérique de 0 a 511, permettant de sélectionner les événementsenregistrés, quand la valeur correspondante est vraie.

Les valeurs possibles sont :

- 1 : trace des messages réseau,

- 2 : trace des codes retour non 0 et d’autres erreurs,

- 4 : trace des manipulations de fichiers DASDM/CATALOG/SVC99,

- 8 : trace des lectures/écritures des fichiers,

- 16 : trace des appels aux fonctions C,

- 32 : trace LONGUE des messages réseau (sinon, trace des 32 premiers caractères),

- 64 : trace des communications entre tâches CFT Version 2,

- 128 : trace des appels de programmes,

- 256 : trace des actions de l’interface écran,

- 512 : trace des appels aux exits de CFT.

La commande SGTRACE permet de modifier dynamiquement l’option par défaut définie dansSGINSTAL ou précisée en PARM.

16.3.1.2. Utilisation du fichier SGTRACE

Le fichier SGTRACE est automatiquement ouvert lors de l’initialisation de CFT Version 2.

La trace est marquée logiquement active si l’ouverture est correcte. La valeur de trace utilisée estcelle qui a été définie lors de l’installation, dans la MACRO SGINSTAL (A12OPTS).

L’enregistrement des événements est effectif si les conditions suivantes sont remplies :

· l’événement est sélectionné,

· 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 utilisée par le champ PARM de chaque programmeCFT Version 2.




CFT V2.3 16-3

Exemple :

// UTIL EXEC PGM = CFTUTIL,// PARM = ‘SGTRACE nnn’

SGTRACE nnn doivent être les premier et deuxième paramètres du champ PARM.

En l’absence 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 gérer 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 : marque la trace logiquement INACTIVE,

·

CLOSE : ferme le fichier de trace,· OPEN : ouvre le fichier de trace,

· Nnnnnn : valeur numérique de 4 à 4096 permettant de modifier la taille du buffer de trace interne, en K-octets.

La trace interne est automatiquement activée à l’initialisation de CFT Version 2. La taille du buffer de trace utilisé est celle qui a été définie lors de l’installation, dans la MACRO SGINSTALL.

16.3.1.4. Utilisation du fichier SGSTAE

Le fichier SGSTAE est automatiquement ouvert lors de l’initialisation de CFT Version 2.Ce fichier reçoit une édition mise en forme de la trace interne à chaque ABEND de CFT Version2. Ce fichier est de format FIXE BLOQUE, LRECL=132.

En l’absence 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 formatée de trace interne de CFTVersion 2, sur le fichier SGSTAE. Cette commande n’a pas de paramètre.

16.3.1.6. Commande ABEND

La commande ABEND provoque un ABEND 0C1 dans le module opérateur. Elle provoque unDUMP de CFT Version 2 ainsi qu’une édition formatée de la trace interne de CFT Version 2, sur le fichier SGSTAE. Cette commande n’a pas de paramètre.

Cette commande décrémente les compteurs MAXABEND et MAXDUMP définis dansSGINSTAL.




sous OS/390

CFT V2.316-4

16.3.1.7. Commande ECHO

La commande ECHO n’a pas d’effet. Elle se termine par le message : ‘SGOP02I: MVS CFTnnnn’.Elle permet de vérifier que CFT Version 2 est opérationnel.

16.3.1.8. Commande SNA

La commande SNA permet de lister et d’agir sur les ressources réseau SNA. Les optionsdisponibles sont les suivantes :

· LIST : lister les ressources et les sessions SNA,

· OPEN Resname : ouvrir une ressource SNA,

· CLOSE Resname : fermer une ressource SNA,

· KILL Référence : fermer une session SNA en donnant sa référence.

Remarque : les commandes d’action sont exécutées SANS vérification préalable de l’état de la ressource ou dela session.Il est parfois nécessaire de passer deux fois la commande KILL pour libérer une session SNA.Il est conseillé d’utiliser en priorité les commandes ‘VTAM’ VARY ACT/INACT.

16.3.1.9. Réponse 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 étatLU-62= 0023C2F0,TRAP= 0023C440CLASSE L62=0006, ACBNAME=A105CF50 OPEN.Acb et son étatSESSION LU6=A105CF51,ACBNAME=A105CF50,CID=0100002B SEN=00000008REC=00000017 PREPRCV DATAFLU .DTOD03I:TOD=14:46:11:009612 ,REF=1C1400CB.Les sessions sur cet ACB

16.4. Commandes ?

La commande "?" permet de connaître l’état de certains composants du moniteur CFT/MVS.Les options disponibles sont les suivantes :

· ? TASK :lister les tâches du moniteur,

· ? FILES :lister les fichiers ouverts,

· ? ENQ :lister les ressources partagées et les conflits,

· ? SCB :

lister les files d’attente du moniteur et leur état,




CFT V2.3 16-5

· ? TCP :lister l'état de la sous tâche TCP/IP,

· ? APF :lister l'état APF ON/OFF et l'utilisateur par défaut,

· ? MODULES :

lister les modules résidents,

· ? MEM :lister l’état de la mémoire dans le fichier SGTRACE,

· ? LU6 :Etat du réseau LU 6.2,

· ? Thhhhhhhh :Affichage de la mémoire à l’adresse hexadécimale ‘hhhhhhhh’ de la région CFT, 16octets alignés à un double mot,

· ? NTF :lister l'état de la sous tâche XFB/SCOPE,

· ? SSL :lister l'état de la sous tâche CFTSSL,

· ? EXITS :lister l'état des sous tâche(s) CFTEXIT,

· ? ABTCP :lister l'état de la sous tâche TCP/IP, puis provoquer un ABEND-S0C6 dans cette sous-tache. A utiliser uniquement sur instruction du service client XFB,

· ? ABNTF :lister l'état de la sous tâche XFB/SCOPE, puis provoquer un ABEND-S0C6 dans cettesous-tache. A utiliser uniquement sur instruction du service client XFB,

· ? ABSSL :lister l'état de la sous tâche CFTSSL, puis provoquer un ABEND-S0C6 dans cette sous-tache. A utiliser uniquement sur instruction du service client XFB.

16.4.1. Réponse 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 l’utilisateur, Type Privé/OSDTOD03I:TOD=16:11:50:155444.TOD de dernier DISPATCHDTSK03I:0022F000 "CFTTPRO " EPA=8765BF18 TCB=006F6388 OWN=CFTR223.Tache OS




sous OS/390

CFT V2.316-6

16.4.1.2. FILES

DFIL01I:FILE SUMMARY :DFIL02I:0022EE90 "FIL00007" "SOP$CFT.REF.C223.COMCICSAddr FCB, DDNAME, DSNAME

" UPDATEType d’accesTOD=14:09:55:978181 GU SGFVSDIR 300500 A220461.TOD,de dernier acces, opération, 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 ScopeDTOD03I:TOD=16:11:46:351245.

TOD de ENQSuivi 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=0TM=8640001.Addr File, Reference, flags, Taches créatrice, Nb de messagespostés Temps d’attente en 1/100iemesDTOD03I: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/370DTOD03I:TOD=14:19:59:080285.TOD de dernier dispatchDTCP02I: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 decompilationDTCP03I: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 díoctetsrestant a ecrire/lire pour terminer un message, Nombre des octetsÈcrits/lus, Tod de derniere action.




CFT V2.3 16-7

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="XIDPARMSi APF ON, Nom de l’élément 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 etrévision.DMOD01I:EPA=001478A8, ID: ANSADT(ANSAPI) 15NOV00-150299.Pour un module C/SAS fonction(source) date de compilation, date demodificationDMOD01I:EPA=077CD0A0, ID: wrttcp 0010251227470201Pour un module C/IBM, nom de fonction AAMMJJHHMMSSVVRR decompilation

Un même module peut être chargé plusieurs fois ou compilé de différentes façons.

La réponse est affichée uniquement dans le fichier SGTRACE.

16.4.1.8. MEM

==> Real space used by CFT 0116BEA0 freed on pages 0003A160allocated

below 002B6000 freed below 0000C7A0

La mise en forme se trouve dans le fichier SGTRACE, sous une forme identique à un dump MVS(Appel au même service MVS).

16.5. Commande PATCH

La commande PATCH permet de modifier la mémoire dans un espace adresse de CFT.

Elle ne doit être utilisée que sur les instructions du support CFT.

Format : PATCH VIRT-ADDR OLD-DATA NEW-DATA

Modifie dans la région de CFT 4 octets à l’adresse hexadécimale "VIRT-ADDR", qui sontcomparés en hexadécimal à "OLD-DATA" et remplacés par "NEW-DATA" si vrai.

Cette commande permet de modifier les données ou le code réentrant de CFT.




sous OS/390

CFT V2.316-8

16.6. Commandes du serveur de communications CROSS-MEMORY

16.6.1. Commande DUMP

La commande DUMP liste le contenu des zones mémoire par ‘SNAP’ sur le fichier SGTRACE :

· format :

- DUMP H=mbx/ALL : dump du préfixe de la file d’attente ‘mbx’ ou de toutes,

- DUMP Q=mbx/ALL : dump du contenu de la file d’attente ‘mbx’ ou de toutes,

· réponse : CFTXM01W:DUMP MAILBOX ACCEPTED.

16.6.2. Commande DELETE

La commande DELETE supprime une file d’attente :

· format :

- DELETE Q=mbx/ALL : supprime la file d’attente ‘mbx’ ou toutes, et libère la place réservée dans le ‘DIV’,

· réponse : 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 d’attente ‘mbx’ ou de toutesles files d’attente,

· réponse : CFTXM05W:TARGET DELETED.

16.6.4. Commande QRYOPN

La commande QRYOPN liste l’état de la file d’attente :

· format :

QRYOPN Q=mbx/ALL : liste l’état de la file d’attente ‘mbx’ ou de toutes les filesd’attente,

· réponse : CFTXM20W:MAILBOX mbx HAS nnn/NO WAITING MESSAGE(S).




CFT V2.3 16-9

16.6.5. Commande OPEN

La commande OPEN ouvre une file d’attente :

·

format :- OPEN Q=mbx : ouvre la file d’attente ‘mbx’,

· réponse :

- CFTXM10W:MAILBOX OPENED,

- CFTXM09E:MAILBOX UNKNOW.

16.6.6. Commande CLOSE

La commande CLOSE ferme une file d’attente :

· format :

OPEN Q=mbx/ALL : ferme la file d’attente ‘mbx’ ou toutes les files d’attente,

· réponse : CFTXM10W:MAILBOX CLOSED.

16.6.7. Commande SGTRACE

La commande SGTRACE présente les caractéristiques suivantes :

· format et options sont identiques au chapitre précédent,

· réponse : CFTXM15W:TRACE OPTION SETTING.



CFT V2.3 17-1

17. Utilisation de CFT/MVS avec le logiciel desécurité RACF

17.1. Présentation

Ce chapitre fournit les données utiles à la mise en œuvre du logiciel RACF, permettant decontrôler les opérations de manipulation des fichiers.CFT/MVS version 2.2 et suivantes utilise l’interface de sécurité SAF. Il est donc compatible avecles logiciels de sécurité utilisant cette interface, en particulier RACF.

17.2. Contrôle des opérations de manipulation des fichiers

Par défaut, CFT/MVS effectue les opérations de manipulation des fichiers sous sa propre autorité.

CFT/MVS vérifie systématiquement les droits d’accès aux fichiers, pour lui-même ou pour lecompte des utilisateurs. Toute tentative infructueuse se traduit par un code erreur ayant la valeur ‘91300038’ ou ‘80000913’.

Il est possible d’activer un contrôle plus élaboré dans les cas suivants :

· demander la soumission d’une procédure de fin d’émission sous l’autorité du demandeur du transfert,

· demander la soumission d’une procédure de fin de réception sous l’autorité du receveur

du transfert,· demander l’ouverture d’un fichier à émettre sous l’autorité du demandeur du transfert,

· demander l’ouverture d’un fichier à recevoir sous l’autorité du receveur du transfert.

17.3. Activation du contrôle des autorisations RACF

L’appel aux services SAF (RACF ou équivalent) est systématique.

L’utilisation élaborée des fonctions RACF est possible quand les conditions suivantes sontsatisfaites :

· CFT Version 2 est un programme autorisé,· l’option correspondante est active dans les options d’installation SGINSTAL,

· le paramètre CFTPARM USERCTRL=YES est précisé.



Utilisation de CFT/MVS avec le logiciel de sécurité RACF

CFT V2.317-2

17.4. RACF et les interfaces écran CFT/MVS

RACF est requis dans le cas où les interfaces écran seraient appelées sous VTAM afin de vérifier

les PASSWORD.Dans 2 cas, l’interface ne peut vérifier les mots de passe :

· il n’est pas autorisé,

· SAF n’est pas disponible.

L’utilisateur peut se connecter en donnant une valeur quelconque dans le champ PASSWORD. Ildisposera alors des privilèges du JOB sur lequel il est connecté.

17.4.1. RACF et l’interface Internet

RACF est requis dans le cas où l’interface Internet serait utilisée afin de vérifier les PASSWORD.Dans deux cas, l’interface ne peut vérifier les mots de passe :



L’utilisateur peut se connecter en donnant une valeur quelconque dans le champ PASSWORD. Ildisposera alors des privilèges du JOB sur lequel il est connecté.

17.4.2. RACF et l’interface utilisateur JAVA

L’interface JAVA se connecte au serveur CFTIUI, et s’identifie USERID/PASSWORD, y comprisdepuis OPEN/MVS.

Dans 2 cas, l’interface ne peut vérifier les mots de passe :



L’utilisateur peut se connecter en donnant une valeur quelconque dans le champ PASSWORD.Il disposera alors des privilèges du JOB sur lequel il est connecté.



CFT V2.3 18-1

18. Performances du moniteur de transfert CFT/MVS

18.1. Utilisation de la mémoire

18.1.1. Par le moniteur de transfert de fichiers

La mémoire adressée en 24 bits est utilisée de la manière suivante :

· environ 14000 K sont utilisés par les programmes et les zones mémoire,

· chaque tâche de transfert demande 8K supplémentaires,

La taille mémoire adressée en 31 bits est utilisée de la manière suivante :


· chaque tâche de transfert demande 500 K supplémentaires,

· chaque fichier BSAM ouvert utilise 2 buffers de taille BLKSIZE,

· chaque transfert en réception utilise (CFTPROT PACING*CHKW) buffers de réception.

L’utilisation de valeurs élevées associées à un grand nombre de transferts simultanés peut se traduire par des ABENDS878 de CFT/MVS,

·

chaque transfert en réseau TCP/IP utilise 2 buffers de 64 K,· le module CFTSSL nécessite 8000 K supplémentaires,

· le module XFB/SCOPE nécessite 2000 K supplémentaires [XFB/CFT 2.3.0],

· l’implémentation de «Sentinel for XFB» [XFB/CFT 2.3.1] nécessite d’augmenter lataille de la région d’exécution, en fonction des options du fichier de configuration ainsique du nombre de messages.

CFT/MVS diffère la création de transferts supplémentaires quand :

· il ne dispose pas de 64K de mémoire en 24 bits, message ‘CFTA02E’,

· ou il ne dispose pas de 1 megaoctet de mémoire en 31 bits, message ‘CFTA01E’.

Le moniteur CFT/MVS diffère les nouveaux transferts quand il ne dispose plus de 64K libres en24bits, et de 1024K en 31 bits.

18.1.2. Par le moniteur des interfaces interactives sous VTAM

La mémoire adressée en 24 bits est utilisée de la manière suivante :


· chaque utilisateur connecté demande 8 K supplémentaires,

La taille mémoire adressée en 31 bits est utilisée de la manière suivante :

·

chaque utilisateur connecté demande 500 K supplémentaires.



Performances du moniteur de transfert CFT/MVS

CFT V2.318-2

18.2. Utilisation des entrées/sorties disque

Des entrées/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 paramètre CFTCAT,

· le premier enregistrement de chaque fichier CFTCOM est lu tous les WSCAN secondes,valeur du paramètre de CFTCOM,

· la gestion des entrées/sorties sur les fichiers HFS est effectuée sous le contrôle del’espace adresse OMVS.

18.2.1. Utilisation d’un 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 mémoire d’arrière plan ou en mémoire auxiliaire de MVS.

18.2.2. Libération de l’espace disque inutilisé dans les fichiers reçus

Sous OS/390, le moniteur CFT libère l’espace disque inutilisé sur les fichiers reçus si lesconditions suivantes sont satisfaites :

· le moniteur CFT est un programme autorisé,

· le moniteur CFT renomme le fichier reçu à la fin du transfert (CFTRECVWFNAME=dsn1, FNAME=dsn2),

· le fichier est sur un seul volume.

18.3. Utilisation de l’unité centrale

La fonction de compression/décompression des données est consommatrice de temps CPU.L’activation d’une option de SGTRACE est grande consommatrice de temps CPU.

Le moniteur CFT est multitâches. Il peut utiliser plusieurs processeurs simultanément.

CFT/MVS accepte des valeurs de CFTPROT xRUSIZE inférieures ou égales à 65000 octets.Une valeur de RUSIZE élevée réduit significativement la charge CPU : par exemple de 30% en passant de 4 K à 16 K.

L’utilisation du chiffrement se traduit par une multiplication de la consommation CPU pouvantatteindre un facteur 4, selon les algorithmes utilisés.




CFT V2.3 18-3

18.4. Utilisation de la compression DF/SMS

CFT/MVS est compatible avec la compression des fichiers gérée par DF/SMS.

En lecture, CFT/MVS recalcule la taille du fichier non compressé à partir des informations deDF/SMS.

En création, CFT/MVS demande l’espace nécessaire à l’écriture du fichier non compressé.Si possible, il libère ensuite l’espace inutilisé en fin de transfert.

18.5. Utilisation de CFT/MVS en environnement SYSPLEX

CFT/MVS est conçu 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 données VFM sont partagés enlecture/écriture.

Les applications déposant des demandes de transfert par le fichier de commandes, interrogeant lecatalogue de CFT ou mettant à jour les bases VFM, peuvent s’exécuter sur d’autres machines.Ceci est vrai également pour l’interface utilisateur TSO ou VTAM, l’interface utilisateur Internet,l’agent d’administration XFB.Scope.

18.5.2. Moniteur CFT en SYSPLEX et réseaux SNA

Le moniteur CFT en SYSPLEX ne peut s’exécuter que sur la machine contenant les définitions desressources réseau utilisées SNA et LU 6.2.

Remarque :en réseau APPN, il est possible de passer des commandes VARY INACT/ACT pour l’ensembledes définitions réseau de CFT.

18.5.3. Moniteur CFT en SYSPLEX et réseau TCP/IP

A partir de OS/390 V2R7, il existe une facilité permettant d’enregistrer une application telle queCFT, dans le serveur de noms DNS, par appel à un service de WORKLOAD MANAGER. CFTest compatible avec cette facilité. Le dispositif VIPA offre également un service de reconfigurationdynamique du réseau.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.318-4

18.6. Utilisation des services Automatic Restart Manager

Les programmes autorisés de CFT/MVS s’abonnent au service Automatic Restart Manager de

OS/390. Ces programmes seront donc automatiquement relancés en fonctions des règles définiesdans le composant ARM.

Les noms d’éléments utilisés 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 : Xnom ou nom est un paramètre,

· CFTINTV : Xparm ou parm est le 3ème paramètre facultatif reçu.

Le nom de l’élément est modifiable de la manière suivante :

1. Ajouter une carte DD dont le DDNAME sera ‘CFTARMID’.

2. Fournir 1 enregistrement unique dont les 16 premiers octets seront utilisés commesubstitution à « Xidparm ».

Le RESTART est différé pendant une minute pour tenir compte de la rémanence des sessionsréseau TCP/IP.

En option, le nom d’élément peut être spécifié par l’utilisateur en ajoutant à la procédure un fichier dont le DDNAME est ‘CFTARMID’, et dont les 16 premiers octets du premier enregistrementseront utilisés comme nom d’élément ARM.

18.7. Fichiers de diagnostics de LE/370

Certains modules de CFT/MVS utilisent des fichiers de diagnostics gérés par LE/370.

Il s’agit de :

· CEEDUMP : fichier de DUMP formaté par LE/370,

· TCPOUT : fichiers des messages du module CFTTCP,

· TCPPRINT : fichiers des erreurs du module CFTTCP,

· SSLOUT : fichiers des messages du module CFTTSSL,

· SSLPPRINT : fichiers des erreurs du module CFTTSSL,

· NTFOUT : fichiers des messages du module XFB/SCOPE,

· NTFPPRINT : fichiers des erreurs du module XFB/SCOPE,· PKUOUT : fichiers des messages du module CFTPKI.




CFT V2.3 18-5

18.8. Paramétrage des réseaux X25

18.8.1. Paramètres du NCP pour utiliser “GATE”

Les paramètres suivants sont requis dans le NCP, au niveau X25.MCH :

Exemple de paramétrage 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. Compléments d’information à propos des réseaux X25

Un réseau X25 géré en “GATE” est décrit dans CFT/MVS par les commandes :

CFTNET TYPE = X25 et CFTX25

Une première forme de paramétrage du noeud commuté VTAM est alors utilisée.

Un réseau X25 géré en mode “PCNE” est décrit dans CFT/MVS par les commandes :

CFTNET TYPE = SNA et CFTSNA

Une seconde forme de paramétrage du noeud commuté VTAM est alors utilisée.

L’utilisation simultanée de “PCNE” et de “GATE” est possible sur une ligne X25. Il est alors

nécessaire de se reporter à la documentation IBM X25-NPSI qui présente les différentescombinaisons possibles de paramètres NCP.

18.8.2.1. Utilisation de la sous-adresse dans le numéro d’appel X25

La sous-adresse est utilisable si NPSI est paramétré avec : SUBADDR = YES

Dans ce cas, le caractère de DROITE de la sous-adresse est le service LLCn de NPSI :

n = 0 -> PCNEet n = 4 -> GATE

18.8.2.2. Réception d’un appel entrant en PCNE

Il existe deux possibilités :

· le premier message est associé à un APPLID SNA par une INTERPRET TABLE deVTAM,

· l’APPLID SNA est forcé par un LOGAPPL = de VTAM.




CFT V2.318-6

18.8.2.3. Utilisation des USER DATA

Il s’agit de tous les caractères alphanumériques du SAP :

·

réception d’un appel entrant en GATE :- si NPSI contient SUBADDR = YES, alors DIALNO doit se terminer par 4 et la

valeur du SAP est comparée (y compris le 4),

- sinon, le caractère de GAUCHE des USER DATA est le service LLCn de NPSI(exemple : ‘C4’ -> GATE) et la valeur du SAP est comparée (y compris le premier caractère ayant servi à déterminer le service LLC).

18.9. Fichiers de format fixe standard et variable SPANNED

Les fichiers de format fixe standard et variable spanned, sont transférables en respectant leurs

caractéristiques spécifiques. Ce mode de transfert est sujet à des restrictions.

18.9.1. Fichiers de format fixe standard

Les fichiers de format fixe standard sont transférés comme des fichiers de format fixe. Il peuventdonc être échangés entre tous les moniteurs XFB.

Le format fixe standard et le respect éventuel des codes saut ASA ou MACHINE, sont assurésuniquement entre 2 moniteurs CFT/MVS intégrant ce support (noyau 2.3.0 et modificationA230017).

Les moniteurs CFT/MVS de niveau antérieur reçoivent des fichiers fixes standards, en format fixe,

après installation d’une mise à niveau de compatibilité : A230018.

18.9.2. Fichiers de format variable SPANNED

Les fichiers de format variable spanned sont transférés en mode image de blocs physiques,exclusivement entre 2 moniteurs CFT/MVS disposant de ce support : noyau 2.3.0 et modificationA230017.

Les fichiers résultat de l’utilitaire IEBCOPY générés et transférés par CFT/MVS, restentinterchangeables entre toutes les versions des moniteurs CFT/MVS.

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

La fonction d’appel aux utilitaires Z/OS permet le transfert de fichiers non directement lisibles par CFT/MVS. Les utilitaires IEBCOPY et ADRDSSU (nouveau) sont supportés. L’utilisateur deCFT Version 2.3.0 et suivantes trouvera, dans les paragraphes suivants, les spécificités de ce modeopératoire.




CFT V2.3 18-7

18.10.1. Règles communes d’appel aux utilitaires

Les utilitaires sont appelés pour :

·

transformer les données à émettre en un fichier séquentiel intermédiaire.La transformation se fait au moment de la sélection du fichier, avant l’ouverture de lasession réseau,

· transformer le fichier reçu dans un format identique au(x) fichier(s) émis.Cette transformation se fait dès la réception de la fin du transfert, la session réseau resteouverte et l’émetteur reçoit une indication de bonne fin ou d’échec.

Les règles 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 siteintermédiaire CFT quelconque est permise.

18.10.2. Codage des commandes CFTSEND ou SEND

Les paramètres suivants sont nécessaires :

· le caractère # est nécessaire en tête de FNAME (Code hexadécimal 7B),

· WFNAME indique le nom du fichier intermédiaire qui sera écrit par l’utilitaire, puistransféré par CFT/MVS,

· NSPACE indique la taille du fichier intermédiaire.Ce paramètre est nécessaire si la valeur de FNAME se traduit par une sélection defichiers ou de membres,

· FACTION=DELETE n’est pas supporté (ignoré),

· FTYPE=’1’ commande le choix de l’utilitaire ADRDSSU, associé à un ou plusieurscaractères ‘_’ a la fin de FNAME.

18.10.3. Codage des commandes CFTRECV ou RECV

Les paramètres suivants sont nécessaires :

· WFNAME indique le nom du fichier intermédiaire qui sera reçu par CFT/MVS, puis relu par l’utilitaire,

· FACTION n’est pas supporté (ignoré),· MACTION=REPLACE commande le remplacement des membres ou des fichiers.

18.10.4. Appel à IEBCOPY

L’appel a IEBCOPY permet le transfert de la totalité ou d’une sélection de membres d’un fichier PDS. L’utilisation est obligatoire dans le cas de LOAD MODULES.




CFT V2.318-8

Exemples :

· émission d’une bibliothèque complète :

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 d’une bibliothèque :

SEND .. FNAME=#MY.LOAD.LIBRARY(TEST*)

Le PDS reçu sera crée s’il n’existe pas avec les caractéristiques suivantes :· SPACE identique au fichier initial,

· nombre de blocs de DIRECTORY = ‘BLKPDS’, 150 par défaut.

Restrictions :

· le transfert de/vers des fichiers PDSE n’est pas supporté,

· les utilitaires « compatibles IEBCOPY » ne sont pas supportés.

18.10.5. Appel à ADRDSSU

ADRDSSU permet le transfert de 1 ou plusieurs fichiers. Le transfert d’un ensemble de fichiers est permis avec le caractère joker ‘ _’.

Il est recommandé d’utiliser cet utilitaire pour tous les fichiers autres que les fichiers séquentiels :

· VSAM,

· PDSE (en réception),

· HFS.

Un sous-ensemble des paramètres de ADRDSSU est utilisé. Il est noté en exemple.

18.10.5.1. Codage du FNAME du CFTSEND ou SEND

Le format général du CFTSEND sera :

CFTSEND FTYPE=’1’, WFNAME=TEMP.FILE.&PART.&IDT,FNAME = ‘#VOLSERt%%DSNGEN_

Avec :

· VOLSER : paramètre facultatif pouvant contenir un nom de volume,

· DSNGEN : paramètre facultatif :

- si celui-ci est présent, il doit se terminer par ‘ _’ ,

- si DSNGEN est omis, alors VOLSER est obligatoire et la totalité des fichiers du

volume ‘VOLSER’ seront transférés (Sauf SYS1.VVDS et VTOC INDEX),




CFT V2.3 18-9

- DSNGEN est un nom de fichier terminé par ‘_’ ; seul ce fichier (catalogué ou non)sera transféré,

- DSNGEN contient plusieurs ‘ _’ ; dans ce cas, il s’agit d’un modèle qui serainterprété selon les règles suivantes :

Tableau 17. Règles d’interprétation du DSNGEN

Modèle Interprétation

DSNGEN_ DSN

DSNGEN__ DSN*

DSNGEN._ DSN.*

DSNGEN_._ DSN*.*

DSNGEN_.__ DSN*.**

Exemples

Emission de 1 fichier :

SEND ..FTYPE=’1’, FNAME=#A.VSAM.FILE_

La commande ADRDSSU générée 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 paramètres :

EXCLUDE ( SYS1.VVDS.V* , SYS1.VTOCIX.* )

LOGINDYNAM ( VOLSER) SELECTMULTI ( ANY )

Remarques :

· la totalité de l’espace alloué est copié (paramètre ALLDATA),

· les CLUSTERS VSAM sont copiés avec les index alternés (paramètre SPHERE),

· les fichiers multivolumes sont copiés en totalité (paramètre SELECTMULTI).

Restrictions :· ADRDSSU ne prends pas en compte les fichiers migrés HSM,

· les fichiers PAGE DATASET et les catalogues VSAM ne sont pas supportés.




CFT V2.318-10

18.10.5.2. Codage du CFTRECV ou RECV

Le format général sera :

CFTRECV FNAME = ‘#VOLSERt%%QUALIF1’WFNAME=TEMP.FILE.&PART.&IDT

Avec :

· VOLSER : paramètre facultatif pouvant contenir le nom du volume recevant lesfichiers,

· QUALIF1 : paramètre facultatif permettant de changer le premier QUALIFIER dufichier.

Exemples

Réception de fichiers sous leur nom initial :

CFTRECV FNAME= ‘%%’La commande ADRDSSU générée aura le format :

RESTAURE DATASET ( INCLUDE ( ** ) CATALOG SPHERE

Réception de fichiers sur 1 VOLUME, sous leur nom initial :

CFTRECV FNAME=’VOLSER%%’

La commande ADRDSSU utilisera également le paramètre :

OUTDYNAM ( VOLSER )

Remplacement des fichiers reçus :CFTRECV MACTION = REPLACE, FNAME=’%%’


REPLACE

RENAME des fichiers reçus, changement du premier qualifier :

CFTRECV FNAME=’%%NEWNAME’


RENAMEUNC ( NEWNAME )

La combinaison RENAME+REPLACE peut provoquer une erreur ADRDSSU si le(s) fichier(s)résultat existait déjà.

Remarques :

· les fichiers sont recréés à l’identique du fichier initial,

· CFT/MVS force le RECALL HSM des fichiers migrés à restaurer.




CFT V2.3 18-11

18.10.6. Messages complémentaires

Si le traitement par l’utilitaire externe est correct, CFT/MVS affiche 2 messages CFTF30W dont letexte sera :

· le code retour de l’utilitaire,

· un texte complémentaire.

Dans le cas de IEBCOPY, un fichier de compte rendu est crée. Il contient pour chaque membre unenregistrement « DSNAME(MEMBER) ». Ce fichier temporaire MVS n’est pas catalogué, sonnom 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 d’erreurs

Dans le cas ou une erreur se produit, un message affiche :

· soit le code ABEND de l’utilitaire,

· soit le premier message d’erreur de l’utilitaire.

De plus, la plupart des messages d’erreur sont envoyés sur la SYSLOG MVS.

La liste de tous les fichiers non restaurés par ADRDSSU est affichée dans la SYSLOG MVS, dansle message :

CDSS04E:Failed to Restore=DSNAME

Se reporter à la documentation IBM de référence pour l’explication des paramètres et des

messages IEBCOPY et ADRDSSU.

L’option de mise au point SGTRACE 12 permet d’obtenir une trace détaillée dans le fichier SGTRACE.

18.10.8. Performances des utilitaires

CFT/MVS appelle un seul utilitaire externe à la fois.

L’utilisation de la mémoire est la suivante :

Tableau 18. Performances des utilitaires : utilisation de la mémoire

Utilitaire Mémoire 24 bits Mémoire 31 bits

IEBCOPY 1024K 0

ADRDSSU 2048K 8192K

Le paramètre CFTPROT RTO=secondes doit indiquer une valeur en ‘secondes’ suffisante pour permettre le déroulement complet de l’utilitaire coté récepteur.

ADRDSSU et RACF : le paramètre TOLERATE (ENQFAILURE) nécessite l’accès « READ » àla classe FACILITY, ressource STGADMIN.ADR.DUMP.TOLERATE.ENQF côté émetteur.



CFT V2.3 19-1

19. Codes erreurs fichiers CFT/MVS

19.1. Présentation

Les codes erreurs fichiers apparaissent sous la même forme :

· dans les messages CFT,

· dans le champ DIAGP du catalogue CFT.

19.2. Format du champ DIAGP

Le format général des codes erreur fichier est le suivant : SFRRNNNN, avec :

· S : le code environnement.

Tableau 19. Code environnement

Code Définition

S = 0 Erreur rendue par MVS/DFP

S = 4 Erreur de lecture/écriture

S = 7 Abend de lecture/écriture

S = 9 Erreur retournée par DYNALLOC

S = C Erreur de lecture/écriture VSAM

S = F Erreur de paramètres 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 Définition

F = 0 Création de fichier

F = 1 Suppression de fichier

F = 2 Interrogation des caractéristiques du fichier

F = 3 Rename d’un fichier

F = 4 Alloue un fichier par DSNAMEF = 5 Désalloue le fichier

F = 6 Alloue par DDNAME

F = 7 Submit d’une procédure CFT vers INTERNAL READER

D’autres valeurs sont ensuite détaillées



Codes erreurs fichiers CFT/MVS

CFT V2.319-2

· RR : le code RR désigne la fonction MVS demandée :

Tableau 21. Code RR

Code Définition

RR = F0 Appel à CAMLST LOCATE

RR = F1 Appel à CAMLST SCRATCHRR = 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

D’autres valeurs sont ensuite détaillées

· NNNN : le code information complétant le code retour.

NNNN est le code retour de MVS ou OPEN VSAM ou l’un des codes suivants :- pour RR=DC, NNNN est le numéro du message IDCnnnn de IDCAMS ou

ADRnnnE de ADRDSSU.

Exemple :

00DC32O3 correspond au message IDC32O3I ITEM î DOES NOT ADHERE TORESTRICTIONS.

00AD392E correspond au message ADR392E “ dsn exits on volser withnewname “.

19.2.1. Table des codes erreur fichier NNNN

Codes particuliers :

· 00F000B37 : pas de place dans un File-System HFS,

· 0x0y00E37 : le volume ‘x’ parmi ‘y’ ne permet pas la création du fichier multivolumes,

· 91300038 ou 80000913 : l’opération de lecture/écriture demandée par un utilisateur sur le fichier n’est 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 Définition

0005 Pas de carte DD

0017 Fichier multivolumes non supporté

0019 Différence de VOLUME avec le catalogue

001A Erreur de DSNAME ou accès via un alias

001B UCB non trouvé ou généré en DRM

001C Fichier non trouvé dans VTOC

001E Fichiers concaténés non supportés

0028 Fichier non trouvé au catalogue




CFT V2.3 19-3

Tableau 22. Table des codes NNNN pour S=0 (suite)

Code Définition

0030 Fichier non trouvé au catalogue

0040 DSNAME manquant

0048 Racine de fichier en GDG sans numéro de version005O DSNAME non conforme aux règles MVS

03DE Fichier non supprimé/renommé, membre de PDS

03DF Fichier non supprimé/renommé, ENQ OLD impossible

03E0 Fichier partagé non disponible, alloué par une autre tâche

03E1 Allocation d’un fichier PDS sans nom de membre

03E2 Allocation d’un GDG sans BLDG

03E3 Allocation d’un GDG en version +1

03E4 Fichier non supprimé/renommé, n’existe pas

03E5 Fichier non créé, existe déjà

03E6 Fichier non supprimé/renommé, sur bande

03E7 Création d’un fichier avec un nom logique (DDNAME)

0051 RENAME, GDG(+1) est obligatoire

0052 RENAME, fichier temporaire ne peut être GDG

0053 RENAME, erreur de CAMLST RENAME

0054 RENAME, erreur de CAMLST CATALOG

0055 RENAME, fichier temporaire ne peut être GDG(+1)

0056 RENAME, fichier en double sur 1 volume

0057 SCRATCH, fichier non trouvé

0058 SCRATCH, erreur CAMLST SCRATCH

0059 SCRATCH, volume non monté

005A SCRATCH, erreur CAMLST UNCAT hors SMS

005F RENAME, membre de fichier PDS

Exemples :

‘04F003E0’ : allocation par DSNAME, le fichier est déjà alloué àun autre transfert par CFT.

‘04F00028’ : allocation par DSNAME, fichier non trouvé aucatalogue.

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 indiquées dans le tableau suivant.

Tableau 23. Table des codes NNNN pour S=4

Code Définition

00D4 OPEN, LRECL/BLKSIZE incorrect

00D7 OPEN, pas de délimiteur de paramètre

00E4 OPEN, DDNAME incorrect

00E7 OPEN, manque DDNAME

00EC OPEN, plus de mémoire pour les buffers



Codes erreurs fichiers CFT/MVS

CFT V2.319-4

Tableau 23. Table des codes NNNN pour S=4 (suite)

Code Définition

00F0 OPEN, il manque des paramètres

00F4 Référence FCB incorrecte

00F8 Code fonction SGF erroné00FC Code fonction non autorisé

00FD OPEN, code retour non 0

0FFF BSAM, erreur lecture/écriture/POINT

Cette erreur est accompagnée de messages CFT et/ou MVS selon le cas :

· message CFT ‘POINT ERROR’ dans le cas de repositionnement sur un fichier qui ne lesupporte pas,

· message CFT ‘SYNA01E:’ accompagné du texte du message ‘SYNADAF’ de MVS.Ce message apparaît 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 à l’ouverture du fichier, CFT/MVS n’a pasle droit de lire/écrire.

19.2.1.4. Table des codes NNNN pour S=C (erreur de lecture/écriture VSAM)

F n’a pas de signification.

RR est le RETURN-CODE VSAM.

NNNN est le FDBK VSAM.

L’explication des codes RTNCD/FDBK de VSAM est indiquée 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 paramètres fichiers)

RR et NNNN sont sans signification.

Tableau 24. Table des codes NNNN pour S=F

Code Définition

F = 4 Fonction non permise

F = 8 Fonction inconnue

F = C Référence fichier incorrecte




CFT V2.3 19-5

Ces codes sont à soumettre au Support Client CFT.

19.2.1.6. Codes erreur DYNALLOC S=9

Les erreurs DYNALLOC sont expliquées dans la brochure IBM “ IBM SPL system macros & facilities”.

La valeur de F pour la fonction DYNALLOC est indiquée dans le tableau suivant :

Tableau 25. Valeur de F pour la fonction DYNALLOC

Code Définition

F = 1 Allocation

F = 2 Désallocation

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 créer le fichier.

Les messages d’erreur « IKJnnnnnI », « IGDnnnnnI » (sous SMS) rendus par DYNALLOC sontaffichés à la console MVS :

· IKJ56893I DATA SET NOT ALLOCATED+

· IGD17273I ALLOCATION HAS FAILED FOR ALL VOLUMES SELECTED FOR

DATA SET

A noter : la valeur hexadécimale ‘nnnn’ convertie en décimal donne le numéro dumessage d’erreur SMS IGD, par exemple X’4379’ correspond au message IGD17273I.

19.3. Diagnostics complémentaires pour les erreurs fichiers

Les diagnostics supplémentaires suivants sont disponibles à la demande du support CFT, à l’aidede l’outil SGTRACE :

· SGTRACE 4 : trace des actions d’allocation/libération 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 concernés sont :

- S =0 : SGF3ACC, SGF3STAT, SIFM, SGF3VSAM, SGF3REN,

- S =9 : SGF3SV99,

- S =4,8,C,F : SGF3C, SIDM.



CFT V2.3 20-1

20. Messages des interfaces systèmes deCFT/MVS

20.1. Présentation

Les interfaces système de CFT version 2.3.0 et suivantes produisent des messages opérateur MVSaffichés sur la console système. Ces messages apparaissent dans les cas suivants :

· une erreur grave est détectée par une fonction système,

· ou la trace SGTRACE correspondante est active.

20.2. Définition

Les messages ont le format suivant :

· 4 lettres correspondant à l’interface système,

· 2 chiffres pour numéroter les messages,

· 1 lettre de classification,

· le caractère ‘:’ accolé permet de reconnaître les messages des interfaces système,

· le texte du message.

Les messages sont indiqués dans le tableau suivant.Tableau 26. Messages des interfaces système de CFT/MVS

Message Définition

CFINnnI :texte Messages d’information de l’interface CFTINT sous VTAM

CFVTnnL:texte Message d’information de l’interface réseau SNA apparaît uniquement avec

‘SGTRACE 1’

SGEXnnL:texte Message d’information du gestionnaire de tâches, apparaît uniquement avec

‘SGTRACE 2’

SGABnnL:texte Message consécutif à un ABEND de CFT/V2

Le texte de ces messages est également enregistré dans le fichier de diagnostics

de CFT/V2

CFXPnnL:texte Message consécutif à une erreur réseau X25

SYNA01E:texte Le texte est retourné par la MACRO SYNADAF à la suite d’une erreur d’entrée

sortie



CFT V2.3 21-1

21. Codes erreurs réseau

21.1. Réseau X25

21.1.1. Présentation

Les codes erreurs réseau X25 ont le format suivant : L/R NN PPP.

Le premier caractère L désigne une erreur locale, R une erreur réseau.

21.1.2. Erreur locale X25 : L NN PPP

Cette erreur est la conséquence d’une erreur de paramétrage de CFT , les valeurs de NN et PPPsont expliquées dans le guide "Codes, diagnostics et messages" de CFT.

Exemple :

L 02 002 : manque de ressources locales.

CFT/MVS n’est pas en mesure d’accéder à la ressource X25. Parexemple, la LU-MCH est INACTIVE pour VTAM.

21.1.3. Erreur réseau X25 : R SS DDD

Ce code est une erreur réseau avec le code ‘REASON’ SS qui est normalisé et le code ‘SENSE’qui dépend du réseau X25 ou de l’équipement appelé.

21.1.3.1. Code REASON SS

Le code ‘REASON’ est normalisé en X25.

Vous trouverez une explication détaillée dans les "Spécifications techniques du réseau Transpac".

21.1.3.2. Code SENSE DDD

Le code diagnostic X25 , dans le cas où il serait inférieur à la valeur ‘07F’, il est également décritdans les spécifications de TRANSPAC. Les valeurs supérieures à ‘080’ sont utilisées à l’initiativedes constructeurs d’équipements X25.

Les codes utilisés par IBM sont décrits dans la "documentation de référence X25-NPSI ".

Exemple :

R 03 0B1 : refus de connexion par NPSI, il n’y a pas d’applicationen session avec la LU-MCH pour recevoir l’appel.



Codes erreurs réseau

CFT V2.321-2

21.1.4. Diagnostics complémentaires pour les erreurs de l’interface X25

Les diagnostics supplémentaires suivants sont disponibles à la demande du Support TechniqueCFT, à l’aide de l’outil SGTRACE :

· SGTRACE 1 : trace des actions réseau.

Remarque : toute demande à l’interface X25 implique une demande à l’interface SNA.

21.1.5. Erreur réseau X25 sous forme NCS

Ce code est une erreur détectée par l’interface réseau X25 de CFT.

Il a le format suivant : 00030XYY.

Où :

· ‘00030’ : désigne le réseau X25,

· ‘X’ : prend les valeurs 0,1,2 selon le module X25,

· ‘YY’ : désigne le code erreur par module X25.

21.1.5.1. Erreur de traitement du module X25

Les erreurs de traitement du module X25 sont présentées dans le tableau suivant.

Tableau 27. Erreurs de traitement du module X25

Valeur de YY Signification

01 Manque de mémoire pour définir un CV02 Plus de place dans la table des contextes

03 Manque de mémoire pour définir un MCH

04 MCH déjà défini

05 Un SAP est actif pour ce MCH à détruire

06 Un SAP nul est demandé sur ce MCH

07 Un CV est actif pour un MCH à fermer

08 Demande de fermeture pour un MCH inconnu

09 Un SAP identique est déjà défini pour ce MCH

0A Un SAP est demandé pour un MCH non défini

0B Manque de mémoire pour créer un SAP

0C Suppression de SAP avec des CV actifs

0D MCH CLEAR a échoué

0E Demande de suppression de SAP inconnu

0F MCH CLEAR a échoué

10 CALL-RQ rejeté par MCH

11 CALL-RQ rejeté, tous les CV sont actifs

12 CALL-RQ rejeté car le SAP est fermé

13 CALL-RQ rejeté car le SAP est non trouvé

14 CALL-CF rejeté par MCH

15 CLEAR rejeté par MCH, pas de SAP pour cet appel

16 CALL-IN rejeté, plus d’application pour ce SAP




CFT V2.3 21-3

Tableau 27. Erreurs de traitement du module X25 (suite)


17 CLEAR a échoué pour ce CV

18 CLEAR-CF a échoué, plus de CV

19 CALL-IN rejeté, le CV est logiquement actif 1A USER DATA de LOGON VTAM incorrect

1B Erreur de séquence LOGON/CLEAR pour ce CV

1C MCH non prêt

1D Erreur de séquence CLEAR/LOGON pour un CV

1E MCH n’existe pas

1F Le service CFT X25 est inactif

20 Erreur ATTACH du service CFT X25

21 Le service X25 n’est pas attaché

22 Le service X25 n’a pas d’entrée de contexte

23 Le service X25 n’a pas de file d’attente

24 Erreur à l’OPEN MCH

25 Session CV n’est pas ouverte

26 Aucun SAP défini

27 DATA-RQ a échoué

28 DATA-RQ a échoué (Données EXPRES)

29 Idem

2A Erreur sur le prêt à émettre

2B Erreur sur le prêt à recevoir

2C Données EXPRES déjà émises

2D Pas de données EXPRES émises

2E Action X25 inconnue

2F 2 Prêt à recevoir, reçus

30 Erreur de paramètres dans la demande X25

21.1.5.2. Erreur de traitement du module MCH

Les erreurs de traitement du module MCH sont présentées dans le tableau suivant.

Tableau 28. Erreurs de traitement du module MCH


01 Erreur de création de la file d’attente

02 Erreur de définition du MCH à SNA

03 Erreur d’OPEN SNA du MCH

04 MCH déjà en session SNA

05 Erreur de CLOSE SNA du MCH

06 Session MCH perdue

07 Confirmation de session MCH perdue

08 Session MCH déjà fermée

09 OPEN session MCH OK

0A OPEN session MCH OK pour un MCH inconnu (LOGAPPL déclaré à VTAM)




CFT V2.321-4

Tableau 28. Erreurs de traitement du module MCH (suite)


0B Session MCH terminée pour un MCH déjà fermé

0C Session MCH non fermée, erreur SNA

0E Message invalide dans la file d’attente X25

0F Message invalide dans la file d’attente MCH

10 Message SNA invalide dans la file MCH

11 Message SNA invalide dans l’EXIT MCH

12 Erreur de lecture file d’attente MCH

13 Message invalide dans la file d’attente MCH

14 CVID inactif reçu dans un CLEAR

15 CVID inactif reçu dans un CALL-CF

16 CVID inactif reçu dans un CLEAR-CF

17 CVID inactif reçu dans un CALL-RQ

18 MCH non prêt pour cette fonction

19 MCH a reçu des données EXPRES

1A MCH a reçu une session SNA pour un CV inactif

1B MCH a reçu un CALL-IN et le SAP n’existe pas

1C MCH a reçu un CALL-IN, tous les CV sont actifs

1D File d’attente saturée ou autre erreur

1E

CALL-IN non confirmé pour une erreur SNA

21.1.5.3. Erreur de traitement des CV

Les erreurs de traitement des CV sont présentées dans le tableau suivant.Tableau 29. Erreurs de traitement des CV


01 Erreur de LOGON session CV

02 Erreur sur émission du CLEAR CV

03 Erreur de CLOSE session CV

04 Erreur d’ACCEPT session CV

05 Session CV sans contexte

06 Type de message inconnu

07 Erreur de contexte session CV

08 START session CV reçu à tort09 Erreur d’OPEN session CV

0A Erreur de commande GATE reçue

0B Des données reçues sur un CV non prêt

0C START session reçu à tort

0D Indication inconnue reçue pour un CV

0E REJECT reçu à tort sur un CV




CFT V2.3 21-5

21.1.5.4. Correspondance du champ REASON sur un réseau X25

La correspondance du champ REASON pour les transferts effectués sur un réseau X25 est lasuivante.

Tableau 30. Valeur de REASON X25

Reason Signification

1 Receive time out : le temps d’exécution de l’opération sur le réseau X25 est

supérieur à la limite fixée par CFT (défaut = 2 minutes).

2 Resource unavailable : une des ressources sollicitées sur le réseau X25 n’est pas

disponible (se reporter au champ DIAG pour plus d’informations ).

21.1.5.5. Correspondance du champ DIAG sur un réseau X25

La correspondance du champ DIAG pour les transferts effectués sur un réseau X25 est la suivante.Tableau 31. Valeur de DIAG X25

DIAG Signification

1 UNAVAILABLE_MEMORY : Pas de mémoire disponible pour effectuer une

opération sur le réseau X25.

2 UNAVAILABLE_CV : Plus de circuits virtuels de disponibles sur l’abonnement

X25.

9 NET_RESSOURCE_UNDEFINE : Erreur synchronisation applicative, le

gestionnaire d’abonnement X25 (MCH CTCP) reçoit un message de déconnexion

alors qu’il contrôle des circuits actifs ou en session.

10 NET_CONNECT_IN : Erreur synchronisation NPSI, le gestionnaire d’abonnement

X25 (CV CTCP) reçoit un paquet d’appel sur une LU CV.

11 NET_RELEASE_IN : Erreur synchronisation NPSI, le gestionnaire d’abonnement

X25 (MCH CTCP) reçoit un paquet de libération de circuit virtuel actif sur la LU

MCH.

12 NET_RELEASE_CF_IN : Erreur synchronisation NPSI, le gestionnaire

d’abonnement X25 (MCH CTCP) reçoit un paquet de confirmation de libération de

circuit virtuel sur la LU MCH.

13 NET_CON_ACCEPT_IN : Erreur synchronisation NPSI, le gestionnaire

d’abonnement X25 (CV CTCP) reçoit un paquet de confirmation d’appel sur la LU

CV.

14 NET_CON_REJECT_IN : Erreur synchronisation NPSI, le gestionnaire

d’abonnement X25 (MCH CTCP) reçoit un paquet de confirmation de déconnexionsur la LU MCH.

30001 X25_CV_MEMORY_FAILURE : Pas de mémoire disponible pour démarrer une

ressource X25 sur un abonnement (LU CV).

30002 X25_MCH_AREF_FAILURE : Une erreur s’est produite pendant l’acquisition de

l’interface de gestion des appels entrants pour un SAP X25.

30003 X25_MCH_MEMORY_FAILURE : Pas de mémoire disponible pour démarrer un

abonnement X25 (LU MCH).

30004 X25_MCH_ALREADY_EXIST : La même LU est employée pour plusieurs

abonnements X25 (commandes CFTNET).

30005 X25_REGISTER_IN_USE : Erreur de séquence interne, l’interface de gestion des

appels entrants pour ce SAP est encore active quand CFT est en phase d’arrêt

définitive (commande SHUT).




CFT V2.321-6

Tableau 31. Valeur de DIAG X25 (suite)

DIAG Signification

30006 X25_REGISTER_FAILURE : Erreur de séquence interne, l’interface de gestion des

appels pour le SAP par défaut est déjà enregistrée.

30007 X25_CONNEXION_IN_USE : Erreur de séquence interne, un circuit virtuel estencore actif quand CFT est en phase d’arrêt définitive (commande SHUT).

30008 X25_RESSOURCE_NOT_FOUND : Erreur interne, un abonnement initialisé n’est

pas trouvé quand CFT est en phase d’arrêt définitive (commande SHUT).

30009 X25_REGISTER_ALREADY_EXIST : L’interface de gestion des appels pour ce

SAP est déjà enregistrée. (commande CFTPROT/CFTX25).

30010 X25_REGISTER_CLASS_NOT_FOUND : L’interface de gestion des appels

entrants pour un SAP particulier ne peut pas être enregistrée, la classe de réseau n’est

pas définie.

30011 X25_REGISTER_MEMORY_FAILURE : Pas de mémoire disponible pour

enregistrer une interface d’appel pour un SAP particulier.

30012 X25_CONNECT_IN_USE : Erreur de séquence interne, un circuit virtuel est encore

actif quand CFT tente de supprimer le gestionnaire d’appel (commande SHUT).30013 X25_CLEAR_CV_FAILURE : Erreur de réseau, un circuit virtuel actif ne peut pas

être stoppé quand CFT tente de supprimer le gestionnaire d’appel (commande

SHUT).

30014 X25_DEREGISTER_SAP_NOT_FOUND : Erreur interne, un gestionnaire d’appel

n’est pas trouvé quand CFT tente de le supprimer (commande SHUT).

30015 X25_DEREGISTER_CLEAR_FAILURE : Erreur réseau, un circuit virtuel actif ne

peut pas être stoppé par force quand CFT est en phase d’arrêt définitive (commande

SHUT).

30016 X25_CONNECT_REQUEST_FAILURE : Erreur réseau, un abonnement actif ne

peut pas être contacté par SNA pour communiquer un paquet d’appel (commande

SEND).

30017 X25_CONNECT_CV_UNAVAILABLE : Erreur logique de paramétrage, un

abonnement actif est défini avec plus de circuits virtuels (CV) que l’administration

du réseau X25 en a octroyé (abonnement TRANSPAC, NCP, VTAMLST à vérifier).

30018 X25_CONNECT_SAP_UNAVAILABLE : Erreur logique de manipulation, une

commande de transfert SEND est servie alors que le gestionnaire d’appel pour le

SAP sollicité est en cours d’arrêt. (commande SHUT).

30019 X25_CONNECT_SAP_NOT_FOUND : Erreur logique de paramétrage, un appel

entrant est servi alors qu’aucun gestionnaire d’appel pour le SAP sollicité n’est

démarré.

30020 X25_CONNECT_ACCEPT_FAILURE : Erreur réseau, un abonnement actif ne peut

pas être contacté par SNA pour communiquer un paquet de confirmation d’appel

(commande RECV).30021 X25_CONNECT_REJECT_FAILURE : Erreur réseau, un abonnement actif ne peut

pas être contacté par SNA pour communiquer un paquet de libération d’appel sortant

(commande SEND).

30022 X25_PROVIDER_NOT_FOUND : Erreur de séquence, les références de

l’abonnement ne peuvent pas être trouvées par SNA pour communiquer un paquet de

confirmation d’appel (par exemple : abonnement déconnecté ou inactivé entre

temps).

30023 X25_RELEASE_RQ_FAILURE : Erreur réseau, un circuit virtuel actif ne peut pas

être contacté par SNA pour communiquer un paquet de libération de circuit (toutes

commandes).




CFT V2.3 21-7


DIAG Signification

30024 X25_RELEASE_RS_FAILURE : Erreur réseau, un circuit virtuel actif ne peut pas

être contacté par SNA pour communiquer un paquet de confirmation de libération de

circuit (toutes commandes).30025 X25_CONNECT_CV_OUT : Erreur logique de paramétrage, un abonnement est

défini avec moins de circuits virtuels (CV) que l’administration du réseau X25 en a

octroyé (abonnement TRANSPAC, NCP, VTAMLST à vérifier).

30026 X25_LOGON_FAILURE : Erreur logique de paramétrage VTAM, les définitions de

l’abonnement ne sont pas correctes, les informations remontées par le SIMLOGON

du LU simulator de NPSI ne sont pas correctes. (NCP, VTAMLST à vérifier).

30027 X25_RELEASE_NT_FAILURE : Erreur réseau, CFT notifie le gestionnaire d’appel

de rejeter un appel alors que la session avec le LU simulator de NPSI n’est pas prête.

Au Start_Data_Trafic, le circuit virtuel actif ne peut pas être contacté par SNA pour

communiquer le paquet de libération d’appel en attente (toutes commandes).

30028 X25_MCHTASK_NOT_READY : Erreur de synchronisation réseau, un circuit

virtuel est établi en appel entrant alors que le gestionnaire d’appel n’est pas encoreactif. L’appel entrant est rejeté et le circuit virtuel sera ouvert par CFT à la prochaine

tentative.

30029 X25_CV_RELEASE_NT_FAILURE : Erreur réseau, CFT notifie le gestionnaire

d’appel de fermer le circuit virtuel alors que la session avec le LU simulator de NPSI

n’est pas prête. Au start_data_trafic, le circuit virtuel actif ne peut pas être contacté

par SNA pour communiquer le paquet de libération de circuit virtuel en attente

(toutes commandes).

30030 X25_SERVICE_REQUEST_NOT_FOUND : Erreur interne, le gestionnaire d’appel

ne peut plus communiquer avec CFT (toutes commandes).

30031 X25_TASK_UNDEFINED : Erreur interne et/ou de paramétrage, l’administrateur de

X25 n’est pas actif (exemple : manque la définition de l’ACB GATE).

30032 X25_ATTACH_FAILURE : Erreur interne, l’administrateur de X25 ne peut pas

lancer l’exécution d’un gestionnaire d’appel.

30033 X25_TASK_NOT_READY : Erreur interne synchronisation, un appel est

communiqué à un gestionnaire d’appel qui n’est pas encore actif ou absent

(abended).

30034 X25_REG_REF_NOT_FOUND : Erreur interne CFT, un gestionnaire d’appel est

activé sans qu’il ait enregistré l’abonnement qu’il contrôle.

30035 X25_SEMAPHORE_ERROR : Erreur interne CFT, un gestionnaire d’appel détecte

que CFT ne correspond plus avec sa messagerie.

30036 X25_MCH_ATTACH_FAILURE : Erreur interne, l’administrateur de X25 ne peut

pas lancer l’exécution d’un gestionnaire d’abonnement (MCH).

30037 X25_CVC_NOT_READY : Erreur interne CFT, le gestionnaire d’abonnement(MCH) détecte que le circuit virtuel n’est pas prêt.

30038 X25_REF_NOT_FOUND : Erreur interne CFT, le gestionnaire d’abonnement

(MCH) ne retrouve pas le gestionnaire d’appel correspondant au SAP qu’il reçoit.

30039 X25_DATA_RQ_FAILURE : Erreur réseau, la transmission d’un paquet de donnée

n’est pas réalisée avec succès.

30040 X25_DATA_EXPRESS_RQ_FAILURE : Erreur réseau, la transmission d’un paquet

de donnée express n’est pas réalisée avec succès.

30041 X25_DATA_EXPRESS_RS_FAILURE : Erreur réseau, la transmission de la

réponse à un paquet de donnée express n’est pas réalisée avec succès.

30042 X25_READY_TO_RECEIVE_FAILURE : Erreur synchronisation réseau, le

contrôle de flux entre CFT, le gestionnaire de données et le gestionnaire de réseau

SNA n’est pas réalisé avec succès.




CFT V2.321-8


DIAG Signification

30043 X25_READY_TO_RECEIVE_RQ : Erreur synchronisation réseau, la demande de

contrôle de flux entre le gestionnaire de données et le gestionnaire de réseau SNA

n’est pas servie avec succès.

30044 X25_DATA_EXPRESS_IN_PROGRESS : Erreur synchronisation réseau, la

demande de contrôle de données express a déjà été envoyée pour le circuit virtuel.

30045 X25_NO_DATA_EXPRESS_IN_PROGRESS : Erreur synchronisation réseau, la

demande de contrôle de données express n’a pas été envoyée pour le circuit virtuel.

30046 X25_MESSAGE_TYPE_ERROR : Erreur interne CFT, la demande émise avec le

message n’est pas connue de l’interface X25.

30047 X25_READY_NOT_REQUEST : Erreur synchronisation réseau, la demande de

contrôle de flux reçue n’est pas sollicitée pour circuit virtuel.

30048 X25_PARAMETER_ERROR : Erreur interne CFT, les paramètres de contrôle X25

échangés sur la messagerie interne ne sont pas corrects

30101 MCH_SEMAPHORE_FAILURE

: Erreur interne CFT, le gestionnaire d’abonnement (MCH CTCP) ne peut pas établir une connexion avec la messagerie interne de CFT.

30102 MCH_REGISTER_FAILURE : Erreur interne CFT, le gestionnaire d’abonnement

(MCH CTCP) ne peut pas enregistrer le type de connexion avec l’interface SNA.

30103 MCH_CONNECT_FAILURE : Erreur de paramétrage VTAM, le gestionnaire

d’abonnement (MCH CTCP) ne peut pas établir la connexion avec la LU MCH, rejet

de la demande par l’interface SNA.

30104 MCH_ALREADY_CONNECTED : Erreur de paramétrage, le gestionnaire

d’abonnement (MCH CTCP) ne peut pas établir la connexion avec la LU MCH,

celle-ci est déjà établie par un autre gestionnaire d’abonnement.

30105 MCH_RELEASE_FAILURE : Erreur interne CFT, le gestionnaire d’abonnement

(MCH CTCP) ne peut pas libérer la connexion avec la LU MCH, rejet de la demande

par l’interface SNA.

30106 MCH_RELEASE_IN : Erreur réseau, le gestionnaire d’abonnement (MCH CTCP)

détecte une coupure sur l’abonnement qu’il contrôle et décide de libérer la connexion

avec la LU MCH.

30107 MCH_RELEASE_OK : Erreur réseau, le gestionnaire d’abonnement (MCH CTCP)

libère la connexion avec la LU MCH et arme la procédure de remise en service

automatique (automatic recovery).

30110 MCH_NOT_CONNECTED : Erreur synchronisation en remise en service, le

gestionnaire d’abonnement (MCH CTCP) détecte dans la procédure de remise en

service automatique (automatic recovery) que la LU MCH est à nouveau

opérationnelle alors qu’elle vient d’être désactivée logiquement.

30111 MCH_ALREADY_DISCONNECTED : Erreur synchronisation en remise enservice, le gestionnaire d’abonnement (MCH CTCP) reçoit dans la procédure de

remise en service automatique (automatic recovery) une indication de déconnexion

de l’interface alors qu’elle est déjà désactivée.

30112 MCH_DEREGISTER_FAILURE : Erreur interne CFT, le gestionnaire

d’abonnement (MCH CTCP) ne peut pas désactiver la LU MCH.

30113 MCH_INVALID_SNA_REQUEST : Erreur interne CFT, le gestionnaire

d’abonnement (MCH CTCP) reçoit une demande de l’interface SNA qu’il ne connaît

pas.

30108 MCH_ALREADY_RELEASED : Remise en service automatique des abonnements,

le gestionnaire d’abonnement (MCH CTCP) détecte dans la procédure de remise en

service automatique (automatic recovery) que la LU MCH est déjà déconnectée.




CFT V2.3 21-9


DIAG Signification

30109 MCH_CONNECT_OK : Remise en service automatique des abonnements, le

gestionnaire d’abonnement (MCH CTCP) détecte dans la procédure de remise en

service automatique (automatic recovery) que la LU MCH est à nouveauopérationnelle.

30114 MCH_INVALID_SNA_REQUEST : Erreur interne CFT, le gestionnaire

d’abonnement (MCH CTCP) reçoit une demande de l’interface SNA qu’il ne connaît

pas.

30115 MCH_INVALID_X25_REQUEST : Erreur interne CFT pendant la remise en

service automatique, le gestionnaire d’abonnement (MCH CTCP) ne peut pas avoir

redémarré.

30116 MCH_UNEXPECTED_SNA_INDICATION : Erreur interne CFT, le gestionnaire

d’abonnement (MCH CTCP) reçoit un message de l’interface SNA qu’il ne connaît

pas..

30117 MCH_UNEXPECTED_NET_INDICATION : Erreur interne CFT, le gestionnaire de

circuit virtuel (CV CTCP) reçoit un message de l’interface SNA qu’il ne connaît pas..

30118 MCH_INDICATION_READ_ERROR : Erreur interne CFT, le gestionnaire

d’abonnement (MCH CTCP) ne peut plus exploiter sa messagerie interne.

30119 MCH_UNEXPECTED_INDICATION : Erreur interne CFT, le gestionnaire

d’abonnement (MCH CTCP) ne connaît pas le message qu’il reçoit de sa messagerie

interne.

30120 MCH_UNEXPECTED_CON_REJECT_IN : Erreur NPSI, après l’émission d’un

rejet de connexion par le gestionnaire d’abonnement (MCH CTCP), NPSI la rejette.

30121 MCH_UNEXPECTED_CON_ACCEPT_IN : Erreur NPSI, après l’émission d’une

confirmation d’appel par le gestionnaire d’abonnement (MCH CTCP), NPSI la

rejette.

30122 MCH_UNEXPECTED_RELEASE_CF_IN : Erreur NPSI, après l’émission d’une

confirmation de rejet d’appel par le gestionnaire d’abonnement (MCH CTCP), NPSI

la rejette.

30123 MCH_UNEXPECTED_RELEASE_IN : Erreur NPSI, après l’émission d’un paquet

d’appel ou d’un paquet de rejet, le CVID est incorrect, NPSI la rejette.

30124 MCH_NOT_READY : Erreur synchronisation interne, le gestionnaire d’abonnement

n’est pas prêt à accepter des messages de CFT et de SNA.

30125 MCH_EXPECTED_PACKET : Erreur réseau/NPSI, le gestionnaire d’abonnement

reçoit un paquet de service inconnu sur la LU MCH.

30126 MCH_UNEXPECTED_SSTAT : Erreur interne/NPSI, le gestionnaire d’abonnement

reçoit un paquet de service sur la LU MCH alors que le StartDataTrafic n’a pas été

reçu.30127 MCH_INCOMING_SAP_NOT_FOUND : Erreur paramétrage, le gestionnaire

d’abonnement reçoit un paquet d’appel sur la LU MCH alors qu’il n’existe pas de

SAP enregistré.

30128 MCH_INCOMING_CV_UNAVAILABLE : Erreur paramétrage, le gestionnaire

d’abonnement reçoit un paquet d’appel sur la LU MCH alors qu’il ne dispose plus de

circuits logiques de disponible avec CFT.

30129 MCH_INCOMING_QUEUE_ERROR : Erreur générale, le gestionnaire

d’abonnement ne reçoit plus suffisamment d’unité de service du "dispatcheur" et ne

peut plus faire face au trafic de paquets de service qu’il reçoit.

30130 MCH_ACCEPT_RS_FAILURE : Erreur générale, le gestionnaire d’abonnement ne

traite pas les confirmations d’appel sortant, le service de l’interface SNA n’est plus

disponible.




CFT V2.321-10


DIAG Signification

30201 CV_LOGON_FAILURE : Erreur interne CFT, le gestionnaire de circuit virtuel (CV

CTCP) le bloc de contrôle de circuit virtuel ne peut pas être localisé avec le network

identifier récupéré dans la chaîne de LOGON de la LU CV.

30202 CV_RELEASE_GATE_FAILURE : Erreur réseau, le gestionnaire de circuit virtuel

(CV CTCP) ne peut pas émettre un paquet de refus. Le CV est perdu.

30203 CV_RELEASE_FAILURE : Erreur réseau, le gestionnaire de circuit virtuel (CV

CTCP) ne peut pas émettre un paquet de libération un circuit virtuel, l’interface SNA

le refuse.

30204 CV_CON_ACCEPT_FAILURE : Erreur réseau, le gestionnaire de circuit virtuel

(CV CTCP) ne peut pas confirmer un appel entrant, l’interface SNA le refuse.

30205 CV_RELEASE_NOT_FOUND : Erreur procédure X25, le gestionnaire de circuit

virtuel (CV CTCP) ne retrouve pas le circuit logique correspondant à un paquet de

libération qu’il reçoit.

30206 CV_UNEXPECTED_INDICATION : Erreur procédure X25, le gestionnaire de

circuit virtuel (CV CTCP) reçoit un paquet qu’il ne connaît pas30207 CV_UNEXPECTED_CONTEXT : Erreur interne, le gestionnaire de circuit virtuel

(CV CTCP) reçoit un paquet pour un circuit logique inactif.

30208 CV_UNEXPECTED_SSTART : Erreur réseau, le gestionnaire de circuit virtuel (CV

CTCP) reçoit un StartDataTraffic en dehors de sa phase d’initialisation.

30209 CV_CON_REJECT_IN : le gestionnaire de circuit virtuel (CV CTCP) reçoit un

paquet de refus d’appel.

30210 CV_EXPECTED_PACKET : Erreur réseau, le gestionnaire de circuit virtuel (CV

CTCP) reçoit sur un circuit virtuel actif un paquet inconnu.

30211 CV_NOT_READY : Erreur synchronisation réseau, le gestionnaire de circuit virtuel

(CV CTCP) reçoit un paquet sur un circuit logique inactif.

30212 CV_NOT_CONNECTED : Erreur synchronisation réseau, le gestionnaire de circuit

virtuel (CV CTCP) reçoit un paquet sur un circuit logique déconnecté.

30213 CV_UNEXPECTED_SNA_CONDITION : Erreur interne, le gestionnaire de circuit

virtuel (CV CTCP) reçoit de l’interface SNA, sur sa messagerie interne un message

qu’il ne connaît pas.

30214 CV_REJECT_CF_FAILURE : Erreur synchronisation réseau, le gestionnaire de

circuit virtuel (CV CTCP) reçoit de l’interface SNA, un paquet de confirmation de

libération de circuit virtuel pour un circuit logique actif.

21.2. Réseau SNA


Les codes erreur réseau SNA ont également un format local ou un format réseau : 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 conséquence d’une erreur de paramétrage de CFT, les valeurs de NN et PPPsont expliquées dans le guide "Codes, diagnostics et messages" de CFT.




CFT V2.3 21-11

21.2.3. Erreur réseau SNA R SSTTUU

Elle est de la forme : R SSTTUU .

La valeur est déduite du SENSE VTAM qui se compose de 4 octets, réduit à 3 octets pour CFT :· SS est déduit du BYTE 0 du SENSE VTAM selon la règle 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 s’il est différent 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 générés par CFT

CFT peut refuser des sessions si le BIND ne lui convient pas. Dans ce cas il génère le SENSE‘084E00nn’, nn étant la position du paramètre rejeté dans le BIND.

Exemple :

CFT refuse une session SLU demandant l’option ‘BRACKET’, avec le

SENSE 084E0005. Il sera traduit par un CFT distant en ‘DIAGf84E05’.

21.2.5. Diagnostics complémentaires pour les erreurs de l’interface SNA


· SGTRACE 1 :trace des actions réseau,

· SGTRACE 2 :trace des événements SNA en erreur.

21.3. Réseau TCP/IP


Les codes erreur réseau TCP/IP ont également un format local ou un format réseau : L NN PPP ouR SSSSSS.




CFT V2.321-12

21.3.2. Erreur locale TCP/IP L NN PPP

Elle est de la forme : L NN PPP.


21.3.3. Erreur réseau TCP/IP R SSSSSS

SSSSSS est la valeur hexadécimale de ‘ERRNO’. ERRNO est défini dans la documentation deréférence TCP/IP.

21.3.4. Diagnostics complémentaires pour les erreurs de l’interface 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 d’explication à rechercher dans la documentation de référenceIBM.


· SGTRACE 128 : trace des appels et des retours de modules,

· SGTRACE 1 : trace des actions réseau.

21.4. Codes erreur réseau SNA LU 6.2

Les codes erreurs réseau SNA LU 6.2 ont le format suivant :L NN PPPR HPPPSSSS HNNNNNNN

Le premier caractère L désigne une erreur locale, R une erreur du réseau.

21.4.1. Erreur locale SNA LU 6.2 : L NN PPP





CFT V2.3 21-13

21.4.2. Erreur réseau SNA LU 6.2 : R HPPPSSSS HNNNNNNN

Le code erreur réseau est composé de deux parties :

·

HPPPSSSS : le code retour de l’interface APPC VTAM.Le code retour de l’interface comprend le code primaire (HPPP) et le code retour secondaire (SSSS).Ces codes sont décrits 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” ainsile code 002C0002 (Invalid conversation) deviendra F02C0002,

· HNNNNNNN : le "sense" VTAM.Le "sens" code VTAM subira le même traitement : lesense 084B0003 (Requested Resources not available) sera traduit par F84B0003.

21.4.3. Diagnostics complémentaires pour les erreurs de l’interface SNA LU 6.2


· SGTRACE 1 : trace des actions réseau,

· SGTRACE 2 : trace des événements SNA LU 6.2 en erreur.

21.5. Erreur réseau SNA LU 6.2 sous forme NCS

Ce code est une erreur détectée par l’interface réseau SNA LU 6.2 de CFT.

Il a le format suivant : 00062XYY.

Où :

· ‘00062’ : désigne le réseau 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 présentées dans le tableau suivant.

Tableau 32. Erreurs de traitement du module CFT LU 6.2


01 Manque de mémoire pour définir un buffer de données

02 Erreur de paramètres sur acceptation d’une conversation

03 Erreur de paramètres sur rejet d’une conversation

04 Erreur de paramètres sur ouverture d’une conversation

05 Conversation non active

06 Erreur de paramètres sur suppression d’un SAP

07 Erreur ATTACH du service réseau LU 6.2


09 Erreur sur prêt à émettre




CFT V2.321-14

Tableau 32. Erreurs de traitement du module CFT LU 6.2 (suite)


0A Erreur sur prêt à recevoir

0B Erreur de paramètres sur prêt à recevoir

0C Erreur de paramètres sur création d’un SAP0D Erreur de paramètres sur fermeture d’une conversation

0E Erreur de paramètres sur réponse de fermeture d’une conversation

0F Erreur de paramètres sur création d’une ressource SNA LU 6.2

10 Erreur de paramètres sur suppression d’une ressource SNA LU 6.2

11 Erreur de paramètres sur envoi de données

12 Référence de conversation inconnue

13 Etat de la conversation invalide

14 Erreur dans la commande de modification du mode de conversation

21.5.2. Erreurs de traitement du module réseau LU 6.2

Les erreurs de traitement du module réseau SNA LU 6.2 sont présentées dans le tableau suivant.

Tableau 33. Erreurs de traitement du module réseau SNA LU 6.2


01 Demande de suppression de SAP avec des conversations encore enregistrées

02 Erreur de fermeture de conversation sur une demande de suppression de SAP

03 SAP inconnu

04 Erreur ATTACH du service ressource LU 6.2

05 Demande de création d’un SAP déjà existant

06 La ressource n’existe pas dans la classe demandée07 Demande de suppression de SAP avec des modes encore enregistrées


09 Création d’une ressource déjà existante

0A Suppression d’une ressource inexistante

0B Erreur de création de la file d’attente

0C Erreur de suppression de la file d’attente

0D Demande de suppression de SAP avec des sessions encore enregistrées

0E 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 présentées dans le tableau suivant.

Tableau 34. Erreurs de traitement des ressources SNA LU 6.2


01 Erreur de fermeture de l’ACB VTAM

02 ACB VTAM non ouvert

03 Erreur d’ouverture d’une conversation sortante

04 Erreur de définition du nombre de sessions

05 Erreur de fermeture d’une conversation sortante

06 Erreur ATTACH du service de réception des données




CFT V2.3 21-15

Tableau 34. Erreurs de traitement des ressources SNA LU 6.2 (suite)


07 Erreur ATTACH du service de gestion des indications réseau


09 Erreur d’ouverture d’une conversation entrante0A Contexte de la conversation inconnu

0B Erreur de création de la file d’attente

0C Erreur de suppression de la file d’attente

0D Erreur sur autorisation à accepter les sessions entrantes

0E Erreur sur refus de recevoir les sessions entrantes

0F Manque de mémoire pour définir une indication

10 Erreur sur la demande du tour de parole

11 Nombre de sessions maximum atteint

12 Erreur de fermeture des sessions

21.5.4. Autres erreurs SNA LU 6.2

Les autres erreurs de traitement SNA LU 6.2 sont présentées dans le tableau ci-dessous :

Tableau 35. Autres erreurs de traitement SNA LU 6.2


01 Manque de mémoire pour définir la zone de réception des données

02 Erreur sur la commande de réception de données

03 Erreur d’écriture dans la file d’attente de CFT

04 Réception de données incomplètes

05 Erreur de déverrouillage d’une ressource LU-MODE06 Erreur de verrouillage d’une ressource LU-MODE

07 Manque de mémoire pour définir un bloc de contrôle LU-MODE

08 Bloc réseau non trouvé

09 Tâche réseau non prête

0A Manque de mémoire pour définir le bloc de contrôle réseau

0B Erreur de déverrouillage d’une ressource RECEIVE_ANY

0C Erreur de verrouillage d’une ressource RECEIVE_ANY

0D Manque de mémoire pour définir un bloc de contrôle RECEIVE_ANY

0E Tâche ressource non prête

0F Erreur d’écriture dans la file d’attente de la tâche ressource

10 Bloc ressource non trouvé

11 Erreur de déverrouillage d’une ressource

12 Erreur de verrouillage d’une ressource

13 Manque de mémoire pour définir un bloc de contrôle ressource

14 Erreur de déverrouillage d’une ressource SAP

15 Erreur de verrouillage d’une ressource SAP

16 Manque de mémoire pour définir un bloc de contrôle SAP

17 Erreur de déverrouillage d’une ressource session

18 Erreur de verrouillage d’une ressource session

19 Manque de mémoire pour définir un bloc de contrôle session

1A Erreur de fermeture des sessions




CFT V2.321-16

Tableau 35. Autres erreurs de traitement SNA LU 6.2 (suite)


1B Erreur de fermeture de l’ACB VTAM

1C Type d’indication inconnue

1D Erreur sur rejet de session1E Erreur sur rejet de conversation

1F LOSS reçu sur la session

20 TPEND reçu

21 Manque de mémoire pour définir un bloc requête

22 Erreur sur rejet de conversation

23 Erreur de définition du nombre de sessions

24 Erreur de visualisation du nombre de sessions



CFT V2.3 22-1

22. Codes retour et codes ABEND des interfacessystèmes CFT/MVS

22.1. Présentation

Le tableau suivant résume les principaux codes erreur ou ABEND utilisés par CFT/MVS.

Tableau 36. Principaux codes erreur ou ABEND

Module Type Dec. Hexa. Explication

SGFBSAM ABEND 0001 00000001 DCB/Buffer fichier incorrect

SGF3C ABEND 0011 00000017 FCB incorrect

SERURG ABEND 0091 0000005B Détection de TCP errno imprévu

MEMCOPY ABEND 0204 000000CC Erreur fonction memcpy/memmove

SGKWAIT ABEND 0257 00000101 ECB privé incorrect

SGKDEQ ABEND 0304 00000130 DEQ sans ENQ

SGKENQ ABEND 0312 00000138 2 ENQ sur la même ressource

SNAEXIT ABEND 0376 00000178 Plus de mémoire

SGIDINIT ABEND 0376 00000178 Plus de mémoire

SIMM Info 0376 00000178 Plus de mémoire

SGKPOST ABEND 0514 00000202 ECB privé incorrect

SGKDEQ ABEND 0560 00000230 Erreur chaîne des ENQ major

SGKENQ ABEND 0568 00000238 Erreur chaîne des ENQ minor SGKWAIT ABEND 0769 00000301 ECB privé détruit

SGKDEQ ABEND 0816 00000330 Erreur chaîne des ENQ major

SGKENQ ABEND 0824 00000338 Erreur chaîne des ENQ minor

SIFM Info 0991 000003DF Fichier indisponible (RENAME)

SIFM Info 0992 000003E0 Fichier indisponible (ENQ)

SIFM Info 0993 000003E1 Membre de PDS absent

SGF3ACC Info 0994 000003E2 Erreur de fichier GDG

SIFM Info 0996 000003E4 Fichier non trouvé/existe déjà

SIFM Info 0999 000003E7 Création par DDNAME

SGIWARNC ABEND 0999 000003E7 Paramètres de fonction C non supportés

SGKSWAIT ABEND 1025 00000401 ECB privé incorrect

SGKDEQ ABEND 1072 00000430 DEQ demandé par une autre tâche

SGSENQ ABEND 1080 00000438 Erreur de paramètres

SGKMWAIT ABEND 1281 00000501 ECB privé incorrect

SGKENQ ABEND 1336 00000538 Erreur de retour du WAIT

SGINUCDS ABEND 2300 000008FC Mot 1 de TCBFSA utilisé

L62EXIT ABEND 2376 00000949 Ressource LU 6.2 inconnue

L62EXIT ABEND 2378 0000094A Exit LU 6.2 inconnu



Codes retour et codes ABEND des interfaces systèmes CFT/MVS

CFT V2.322-2

Tableau 36. Principaux codes erreur ou ABEND (suite)


L62EXIT ABEND 2379 0000094B Exit LU 6.2 manque de mémoire

L62xxxx ABEND 2399 0000095F RPL LU6.2 Actif

SISM Info 2483 000009B3 Programme non autorisé APF

SNA3 Info 2499 000009C3 Fonction SNA non supportée

SNAINSES Info 2601 00000A29 Pas de paramètre CINIT

SNAINSES Info 2602 00000A2A SAP non trouvé

SNAINSES Info 2603 00000A2B Arrêt de VTAM demandé

SNARELRS Info 2616 00000A38 Pas de fermeture à confirmer

SNARELRS Info 2617 00000A39 Session non encore ouverte

SNARELRS Info 2618 00000A3A Session déjà fermée par applicatif

SNARELRS Info 2619 00000A3B Session non fermée par le réseau

SNARELRQ Info 2627 00000A43 Session non ouverte

SNARELRQ Info 2628 00000A44 Session déjà fermée par applicatif

SNARELRQ Info 2629 00000A45 Session déjà fermée par réseau

SNAIXRPL ABEND 2630 00000A46 Erreur acronyme RPL VTAM

SNASNDRQ Info 2634 00000A4A Pas le tour de parole applicatif

SNASNDRQ Info 2635 00000A4B Session perdue

SNASNDRQ Info 2636 00000A4C Session terminée

SNASNDRQ Info 2637 00000A4D Session fermée

SNASNDRQ Info 2638 00000A4E Session non ouverte

SNASNDRQ Info 2639 00000A4F Erreur paramètre QUALIFY

SNASNDRQ Info 2640 00000A50 Référence session invalide

SNARELRQ Info 2640 00000A50 Référence session invalide

SNARELRS Info 2640 00000A50 Référence session invalideSNAREJRS Info 2640 00000A50 Référence session invalide

SNAREADY Info 2640 00000A50 Référence session invalide

SNAACPRS Info 2640 00000A50 Référence session invalide

SNASESOP Info 2642 00000A52 Limite sessions atteinte

SNACONRQ Info 2650 00000A5A Nom de LU incorrect

SNACONRQ Info 2651 00000A5B Type LU incorrect

SNAACPRS Info 2651 00000A5B Adresse de EXIT incorrect

SNAACPRS Info 2651 00000A5B Adresse de EXIT incorrect

SNACONRQ Info 2652 00000A5C Profil non trouvé

SNAACPRS Info 2652 00000A5C Profil non trouvé

SNAREG Info 2653 00000A5D Erreur SAP

SNACONRQ Info 2653 00000A5D SAP invalide

SNAREG Info 2688 00000A80 Ressource non définie

SNAREG Info 2689 00000A81 SAP déjà défini

SNAUNDEF ABEND 2690 00000A82 Chaîne des ressources détruite

SNADEREG ABEND 2690 00000A82 Chaîne des SAP détruite

SGFHYPER ABEND 2864 00000B30 Erreur HSPSERV SWRITE




CFT V2.3 22-3



SGKCP ABEND 2881 00000B41 Une tâche obligatoire a fait ABEND

SGKCP ABEND 2884 00000B44 Chaîne des ECB en boucle

SGKCP ABEND 2885 00000B45 Chaîne des KECB en boucle

SGKCP ABEND 2886 00000B46 Chaîne des taches en boucle

SGKCP ABEND 2887 00000B47 KCP écrasé

SGKCP ABEND 2888 00000B48 Second init du dispatcher

SGKCP ABEND 2889 00000B49 Erreur dans la chaîne des tâches

MVSBXCRE Info 2915 00000B63 Erreur d’ouverture

MVSBXCRE Info 2916 00000B64 Erreur file d’attente

MVSBXCRE Info 2917 00000B65 Erreur nom de mailbox

MVSBXCRE Info 2918 00000B66 Système MVS non-ESA

MVSBXCRE Info 2919 00000B67 Mailbox existe déjà

MVSBXCRE Info 2920 00000B68 Erreur GQSCAM

IBM3PARM ABEND 2930 00000B72 Plus de 16 paramètres

SISY Info 2933 00000B76 ACR sémaphore invalide

SISY Info 2934 00000B77 Référence sémaphore invalide

SISY Info 2935 00000B78 Mode ENQ message incorrect

SISY ABEND 2936 00000B78 Acronyme sémaphore incorrect

SISYDEL ABEND 2937 00000B79 Acronyme sémaphore incorrect

SISY ABEND 2937 00000B79 Acronyme message incorrect

SISYDEL ABEND 2938 00000B7A Acronyme message incorrect

SISY ABEND 2938 00000B7A Acronyme message incorrect

SISYDEF Info 2939 00000B7B Message de longueur nulle

SISY Info 2940 00000B7C Boîte aux lettres non supportée sous VMSISY Info 2941 00000B7D Boîte aux lettres non supportée sous VM

SISY Info 2942 00000B7E Boîte aux lettres non supportée sous VM

SISY Info 2943 00000B7F Demande de libération d’un LOCK libre

SISY Info 2945 00000B81 2 demandes du même LOCK

SISY Info 2946 00000B82 Numéro de LOCK > 63

SISY Info 2946 00000B82 Numéro de LOCK > 63

SISY Info 2947 00000B83 Erreur longueur données de contrôle

SISY Info 2948 00000B84 Erreur longueur message

SISYDEL Info 2949 00000B85 Référence sémaphore incorrecte

SITM Info 2951 00000B87 Fonction inconnue

SISM Info 2960 00000B90 Fonction inconnue

SYMSYSF ABEND 2976 00000BA0 FREEMAIN en 0

SYMSYSF ABEND 2977 00000BA1 Erreur de chaînage mémoire

SYMSYSF ABEND 2978 00000BA2 FREEMAIN d’une zone non allouée

SYMSYSF ABEND 2979 00000BA3 Préfixe zone mémoire incorrect

SYMSYSF ABEND 2980 00000BA4 Plus de SAVE AREA



Codes retour et codes ABEND des interfaces systèmes CFT/MVS

CFT V2.322-4



SYMSYSG ABEND 2986 00000BAA Préfixe zone mémoire incorrect

SYMSYSG ABEND 2987 00000BAB Préfixe zone mémoire incorrect

SYMSYSG ABEND 2988 00000BAC Paramètres incorrects

SYMSYSG ABEND 2989 00000BAD Zone mémoire utilisée

SYMSYSG ABEND 2990 00000BAE Plus de SAVE AREA

SGIDEXIT ABEND 2991 00000BAF CRAB incorrect

SGIDEXIT ABEND 2992 00000BB0 Fin de pile de travail dépassée

SGIDINIT ABEND 2993 00000BB1 CLINK incorrect

SGIDINIT ABEND 2994 00000BB2 Programme C en version < 4.50

SGIDINIT ABEND 2995 00000BB3 Délimiteur de fin de DSA écrasé

SGIDINIT ABEND 2996 00000BB4 Routage d’un programme C

SGIDINIT ABEND 2997 00000BB5 Routage d’un programme C

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



CFT V2.3 A-1

A. Mise en oeuvre spécifique

A.1. Environnement système

A.1.1. Création des fichiers sous OS/MVS

CFT/MVS crée des fichiers dans les cas suivants :

· par la fonction CFTFILE TYPE=CREATE,

· par la fonction COPYFILE,

· lors de la réception des fichiers transférés.

La création des fichiers SAM est faite par SVC99(DYNALLOC). Les principales options decréation de fichiers SAM sont les suivantes :

· si le format F/V/U est reçu, il est pris en compte, sinon le format U est pris par défaut,

· 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 d’installation, sa valeur par défaut est 27920),

– en format V, MAXBLKSIZE est pris,

– en format U, 32760 est pris,

· l’espace primaire alloué est calculé à partir de la valeur de SPACE,

· l’espace secondaire alloué est égal à 10 % du primaire,

· pour un PDS, 150 blocs de DIRECTORY sont alloués, cette valeur est modifiable lors del’installation de CFT/MVS,

· le fichier est détruit en cas d’erreur,

· si ‘VOLUME’ et/ou ‘UNIT’ ne sont pas précisés, SVC99 utilise la valeur par défaut deSVC99 (voir MVS/ESA SPL : Dynamic allocation).

Cette valeur par défaut peut entrer en conflit avec les options ou EXITS del’installation, les options de DF/SMS.

Les fichiers VSAM sont créés par appel dynamique à IDCAMS. Dans ce cas, le paramètre‘VOLUME’ est obligatoire, sauf si DF/SMS prend une option par défaut.

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

CFT/MVS permet le partage des fichiers avec l’exploitation, avec les options suivantes :

· un fichier en émission est alloué avec DISP=SHR,

· un fichier en réception est alloué avec DISP=OLD.



Mise en oeuvre spécifique

CFT V2.3A-2

De plus CFT/MVS interdit :

· l’émission et la réception simultanée dans le même fichier, y compris 2 membres d’unPDS,

· la réception simultanée de 2 membres d’un même fichier PDS.

A.1.3. Suppression des fichiers sous OS/MVS

CFT/MVS ne permet pas la suppression :

· de la version -n d’un fichier GDG,

· d’un fichier alloué par un autre utilisateur.

A.1.4. Gestion des fichiers par DF/SMS

CFT/MVS crée des fichiers compatibles avec DF/SMS, avec les options suivantes :· le DCB est toujours précisé sous la forme

DCB=(RECFM=xx,LRECL=lll,BLKSIZE=bbb),

· le SPACE est toujours précisé sous la forme SPACE=(bbb,(nnn,sss)),

· les ‘ROUTINES ACS’ devront dans certains cas être adaptées au mode opératoire deCFT.

A.1.5. CFT/MVS et les fichiers PDSE

CFT/MVS ne sait pas créer des fichiers PDSE.

A.2. Procédures CFT

CFT construit et soumet des JOB à partir de tout type de fichier lisible par le moniteur. Par défaut,le JOB sera soumis avec le USERID du demandeur du transfert.

Dans le cas ou la dernière carte du JOB est une carte de JCL commençant par ‘/*’ ou ‘//’, CFTajoute une carte commentaire supplémentaire de la forme :

‘//* SUBMITTED BY:jjjjjjjj AT hh:mm:ss, USERID=uuuuuuuu ,CARDS= nnnnnnnn’

avec :

· jjjjjjjj : JOBNAME de CFT,

· hh :mm :ss : heure du SUBMIT,

· uuuuuuuu : USERID utilisé,

· nnnnnnnn : nombre de cartes soumises.



CFT V2.3 B-1

B. Paramétrage spécifique

B.1. Tableau des valeurs spécifiques

Tableau 37. Valeurs spécifiques

Notation Objet Valeur spécifique

char_file Préfixe des noms logiques $

char_mask Caractère joker (wild card) ?

char_unit Caractère séparateur (volume) %

char_symb Préfixe des variables symboliques &

file_symb Caractère introduisant un nom de fichier passé en

paramètre à CFTUTIL, VFMUTIL

£

Tableau 38. Valeurs spécifiques : défauts pour CFTUTIL

Objet Valeur spécifique

Fichier Paramètres $CFTPARM

Fichier Partenaires $CFTPART

Fichier catalogue $CFTCAT

Fichier journal $CFTLOG

Fichier communication $CFTCOM

Média préférentiel Fichier

B.2. Fichiers transférables

Tableau 39. Caractéristiques de fichiers retrouvées automatiquement ou non à l’émission

Paramètre Retrouvé automatiquement à l’émission

FSPACE OUI

FLRECL OUI

FBLKSIZE OUI

FRECFM OUI FTYPE OUI



Paramétrage spécifique

CFT V2.3B-2

Tableau 40. Combinaisons de FTYPE et FRECFM à l’émission

Nature du fichier à émettre Valeur implicitede FTYPE

Valeur implicitede FRECFM

Fichiers séquentiels disque F/V/U

Membres de fichiers PDS (1 transfert par membre) F/V/U Version désignée d’un fichier en GDG F/V/U

Fichier disque multivolume F/V/U

Fichier VSAM KSDS ou ESDS F/V

Fichier d’impression avec codes saut ASA (MVS àMVS)

A F/V/U

Fichier d’impression avec codes saut machine (MVS àMVS)

M F/V

Fichier en format variable spanné (MVS à MVS) S V

Remarque : les fichiers variables ""spannés"" peuvent transiter par un CFT intermédiaire en protocole PeSITuniquement (profil ANY). Dans ce cas, le fichier reçu sur CFT/MVS sera toujours en format ‘U’.Les PDS déchargés par IEBCOPY sont également reçus en format ‘U’, ce qui est compatible avecIEBCOPY.

Tableau 41. Valeurs de FORG, FTYPE et FRECFM à la réception

FORG FTYPE FRECFM Nature du fichier réception

SEQ F/V/U Fichier séquentiel disque

PART F/V/U Membre de fichiers PDS (1 transfert par membre)

SEQ F/V/U Version désignée -1 à 0 d’un fichier en GDG

SEQ F/V/U Fichier disque multivolume

DIRECT F/V Fichier VSAM ESDS

INDEXED F/V Fichier VSAM KSDS (préexistant vide)

SEQ A F/V/U Fichier d’impression avec code saut ASA(MVS à MVS)

SEQ M F/V/U Fichier d’impression avec code saut machine(MVS à MVS)

SEQ S V Fichier en format variable spanné (MVS à MVS)

SEQ F/V/U Fichier bande magnétique ou cassette en position 1(avec STANDARD LABELS)

Ces valeurs sont explicites dans CFTRECV ou déduites des valeurs protocolaires reçues.




B.3. Codification des noms de fichiers

B.3.1. Noms des fichiers

Un nom de fichier peut se présenter sous différentes formes :

· un DSNAME ou un triplet ‘VOLUME%UNITE%DSNAME’(VOLUME et UNITE étant souvent facultatifs)

Exemple :

pour demander l’émission d’un 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 d’unité

imposé)

SEND FNAME=‘CFTRES%%CFT.SEND.FILE’

le fichier est recherché sur le disque CFTRES.

L’emploi des paramètres ‘VOLUME’ et/ou ‘UNITE’ peuvent entrer en conflit avec lagestion de fichier DF/SMS,

· un nom de membre de PDS : mêmes principes que ci-dessus, en complétant avec lenom du membre mis entre parenthèses.

Exemple :

pour demander l’émission d’un 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 sélectionner un fichier PARTENAIRES

CFTPARM PARTFNAM=$CFTPART,

ce fichier sera précisé 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 associés) réservent l’emploi des « DDNAMES » commençant par ‘FIL’ aux allocations dynamiques.

Guide Exploitation

Documents

Transcript of Guide Exploitation