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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 2/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 3/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 4/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 5/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 6/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 7/154
CFT/MVS Guide d’exploitation
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 8/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 9/154
CFT/MVS Guide d’exploitation
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 10/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 11/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 12/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 13/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 14/154
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].
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 15/154
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,
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 16/154
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
Fichier Position Contenu
INIT 1 JCL(s) d’amorce de l’installation + Produit XFB/CFT sous la
forme (XMIT + ADRDSSU)
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 17/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 18/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 19/154
CFT/MVS Guide d'exploitation
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é.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 20/154
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,
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 21/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 22/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 23/154
Codification des noms de fichiers de CFT/MVS
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 24/154
CFT/MVS Guide d'exploitation
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".
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 25/154
Codification des noms de fichiers de CFT/MVS
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 26/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 27/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 28/154
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/*//
Les paramètres en gras sont à adapter à votre environnement.
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 29/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 30/154
Installation de CFT/MVS Version 2.3.0
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,
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 31/154
CFT/MVS Guide d'exploitation
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 32/154
Installation de CFT/MVS Version 2.3.0
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 paramètres en gras sont à adapter à votre environnement.
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 33/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 34/154
Installation de CFT/MVS Version 2.3.0
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 35/154
CFT/MVS Guide d'exploitation
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,
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 36/154
Installation de CFT/MVS Version 2.3.0
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 37/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 38/154
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)).................../*//
Les paramètres en gras sont à adapter à votre environnement.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 39/154
Installation de CFT/MVS Version 2.3.1
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 40/154
CFT/MVS Guide d'exploitation
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
Les paramètres en gras sont à adapter à votre environnement.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 41/154
Installation de CFT/MVS Version 2.3.1
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,
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 42/154
CFT/MVS Guide d'exploitation
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’.
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 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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 43/154
Installation de CFT/MVS Version 2.3.1
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
@@
Les paramètres en gras sont à adapter à votre environnement.
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 8. 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'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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 44/154
CFT/MVS Guide d'exploitation
CFT V2.3 5-7
Tableau 8. Liste des mots-clés (suite)
Mot-clé Explication
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 45/154
Installation de CFT/MVS Version 2.3.1
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 46/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 47/154
Installation de CFT/MVS Version 2.3.1
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 48/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 49/154
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 */
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 50/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 51/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 52/154
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).
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 53/154
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
//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 54/154
CFT/MVS Guide d'exploitation
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 55/154
Installation des menus CFT
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
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 56/154
CFT/MVS Guide d'exploitation
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,
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 57/154
Installation des menus CFT
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 58/154
CFT/MVS Guide d'exploitation
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//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 59/154
Installation des menus CFT
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 60/154
CFT/MVS Guide d'exploitation
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).
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 61/154
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/*//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 62/154
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
//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
8.4. Exemple de lancement de JCL de CFT/MVS (CFTMAIN)
Ce job est un exemple de JCL de lancement de CFT/MVS. A partir de 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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 63/154
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
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
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).
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 64/154
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
//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 65/154
CFT/MVS Guide d'exploitation
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 66/154
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)
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 67/154
CFT/MVS Guide d'exploitation
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
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 68/154
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.
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 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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 69/154
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.
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'explication des différents mots-clés est indiquée dans le tableau suivant.
Tableau 10. Liste des mots-clés
Mot-clé Explication
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,
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 70/154
CFT/MVS Guide d'exploitation
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 ) ;
/*
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
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//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
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é.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 71/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 72/154
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=*
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 73/154
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@@
Les paramètres en gras sont à adapter à votre environnement.
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
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'explication des différents mots-clés est indiquée dans le tableau suivant.
Tableau 11. Liste des mots-clés
Mot-clé Explication
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 74/154
CFT/MVS Guide d'exploitation
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».
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 75/154
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 ».
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 76/154
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
Fichier Position Contenu
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 77/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 78/154
CFT/MVS Guide d'exploitation
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
//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 79/154
Installation de PTF sur CFT/MVS V2.3.0
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 80/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 81/154
Installation de PTF sur CFT/MVS V2.3.1
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 82/154
CFT/MVS Guide d'exploitation
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 :
//* -------------------------------------//* Execute procedure//* -------------------------------------
//APPLY EXEC APPLY,SSIREF=CCyxxxxx Must be customized
Remarques :
· y : mode de correction,
· xxxxx : identifiant de la correction.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 83/154
Installation de PTF sur CFT/MVS V2.3.1
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.
Avant de soumettre le JOB, il convient de préciser au niveau de la carte EXEC l’identifiant du plan de link-edit :
//* -------------------------------------//* 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).
Avant de soumettre le JOB, il convient de préciser au niveau de la carte EXEC l’identifiant du plan de link-edit :
//* -------------------------------------//* Execute procedure//* -------------------------------------
//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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 84/154
CFT/MVS Guide d'exploitation
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
//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 85/154
Installation de PTF sur CFT/MVS V2.3.1
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 86/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 87/154
Interfaces de programmation
CFT V2.314-2
//CFTAPIC1 EXEC LINKEDIT C SAMPLE//SYSLIN DD *INCLUDE USER(C$APIXP1)INCLUDE CFTC(USERAPI)NAME CFTAPIC1(R)
/*//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
14.2.1. Exemples de programmation
Des exemples se trouvent dans le fichier CFTV2.SAMPLE :
· en Assembleur :
- A$APIXP1 utilisation CFTAI CFTAC CFTAU,
- AAPIUST 'macro' de description de la zone de 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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 88/154
CFT/MVS Guide d'exploitation
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 89/154
Interfaces de programmation
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 90/154
CFT/MVS Guide d'exploitation
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,
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 91/154
Interfaces de programmation
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 92/154
CFT/MVS Guide d'exploitation
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.
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 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)
/*//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 93/154
Interfaces de programmation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 94/154
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.
2. Adressage AMODE=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
//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
Un exemple se trouve dans le fichier CFTV2.SAMPLE :· A$ASIXP1,
· AASIUST 'macro' de description de la zone de communication.
15.2. Exit-list
Pour utiliser 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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 95/154
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é.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 96/154
CFT/MVS Guide d'exploitation
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".
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 97/154
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//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 98/154
CFT/MVS Guide d'exploitation
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)
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 99/154
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.
//
Les paramètres en gras seront remplacés lors de la phase de personnalisation.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 100/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 101/154
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é.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 102/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 103/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 104/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 105/154
Commandes de l’interface opérateur de CFT
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,
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 106/154
CFT/MVS Guide d'exploitation
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 107/154
Commandes de l’interface opérateur de CFT
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 108/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 109/154
Commandes de l’interface opérateur 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).
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 110/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 111/154
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é.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 112/154
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 :
· 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.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 :
· il n’est pas autorisé,
· SAF n’est pas disponible.
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é.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 113/154
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 :
· environ 16000 K sont utilisés par les programmes et les zones mémoire,
· 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 :
· environ 4000 K sont utilisés par les programmes et les zones mémoire,
· 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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 114/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 115/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 116/154
Performances du moniteur de transfert CFT/MVS
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 117/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 118/154
Performances du moniteur de transfert CFT/MVS
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 119/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 120/154
Performances du moniteur de transfert CFT/MVS
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),
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 121/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 122/154
Performances du moniteur de transfert CFT/MVS
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=’%%’
La commande ADRDSSU utilisera également le paramètre :
REPLACE
RENAME des fichiers reçus, changement du premier qualifier :
CFTRECV FNAME=’%%NEWNAME’
La commande ADRDSSU utilisera également le paramètre :
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 123/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 124/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 125/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 126/154
CFT/MVS Guide d'exploitation
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 127/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 128/154
CFT/MVS Guide d'exploitation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 129/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 130/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 131/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 132/154
CFT/MVS Guide d'exploitation
CFT V2.3 21-3
Tableau 27. Erreurs de traitement du module X25 (suite)
Valeur de YY Signification
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
Valeur de YY Signification
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)
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 133/154
Codes erreurs réseau
CFT V2.321-4
Tableau 28. Erreurs de traitement du module MCH (suite)
Valeur de YY Signification
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
Valeur de YY Signification
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 134/154
CFT/MVS Guide d'exploitation
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).
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 135/154
Codes erreurs réseau
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).
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 136/154
CFT/MVS Guide d'exploitation
CFT V2.3 21-7
Tableau 31. Valeur de DIAG X25 (suite)
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 137/154
Codes erreurs réseau
CFT V2.321-8
Tableau 31. Valeur de DIAG X25 (suite)
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 138/154
CFT/MVS Guide d'exploitation
CFT V2.3 21-9
Tableau 31. Valeur de DIAG X25 (suite)
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 139/154
Codes erreurs réseau
CFT V2.321-10
Tableau 31. Valeur de DIAG X25 (suite)
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
21.2.1. Présentation
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 140/154
CFT/MVS Guide d'exploitation
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
Les diagnostics supplémentaires suivants sont disponibles à la demande du support CFT, à l’aidede l’outil SGTRACE :
· SGTRACE 1 :trace des actions réseau,
· SGTRACE 2 :trace des événements SNA en erreur.
21.3. Réseau TCP/IP
21.3.1. Présentation
Les codes erreur réseau TCP/IP ont également un format local ou un format réseau : L NN PPP ouR SSSSSS.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 141/154
Codes erreurs réseau
CFT V2.321-12
21.3.2. Erreur locale TCP/IP 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.
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.
Les diagnostics supplémentaires suivants sont disponibles à la demande du support CFT, à l’aidede l’outil SGTRACE :
· 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
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 142/154
CFT/MVS Guide d'exploitation
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
Les diagnostics supplémentaires suivants sont disponibles à la demande du support CFT, à l’aidede l’outil SGTRACE :
· 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
Valeur de YY Signification
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
08 Type de message inconnu
09 Erreur sur prêt à émettre
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 143/154
Codes erreurs réseau
CFT V2.321-14
Tableau 32. Erreurs de traitement du module CFT LU 6.2 (suite)
Valeur de YY Signification
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
Valeur de YY Signification
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
08 Type de message inconnu
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
Valeur de YY Signification
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 144/154
CFT/MVS Guide d'exploitation
CFT V2.3 21-15
Tableau 34. Erreurs de traitement des ressources SNA LU 6.2 (suite)
Valeur de YY Signification
07 Erreur ATTACH du service de gestion des indications réseau
08 Type de message inconnu
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
Valeur de YY Signification
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 145/154
Codes erreurs réseau
CFT V2.321-16
Tableau 35. Autres erreurs de traitement SNA LU 6.2 (suite)
Valeur de YY Signification
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 146/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 147/154
Codes retour et codes ABEND des interfaces systèmes CFT/MVS
CFT V2.322-2
Tableau 36. Principaux codes erreur ou ABEND (suite)
Module Type Dec. Hexa. Explication
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 148/154
CFT/MVS Guide d'exploitation
CFT V2.3 22-3
Tableau 36. Principaux codes erreur ou ABEND (suite)
Module Type Dec. Hexa. Explication
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 149/154
Codes retour et codes ABEND des interfaces systèmes CFT/MVS
CFT V2.322-4
Tableau 36. Principaux codes erreur ou ABEND (suite)
Module Type Dec. Hexa. Explication
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 150/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 151/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 152/154
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
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 153/154
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.
5/13/2018 Guide Exploitation - slidepdf.com
http://slidepdf.com/reader/full/guide-exploitation 154/154
CFT/MVS Guide d'exploitation
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.
Top Related