Manuel de Référence [PDF]

Zitiervorschau

&)79HUVLRQ

0DQXHOGHUpIpUHQFH

C2-MREF-23-04

Copyright Le Code de la propriété industrielle n’autorise, aux termes de l’article L.122-5 que les “copies ou reproductions 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 ce soit (é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 ou reproduction constituerait donc une contrefaçon sanctionnée par les articles L.335-2 et suivants du Code de la propriété intellectuelle. © Axway Software, 2003. Tous droits réservés.

Table des Matières Conventions typographiques utilisées dans la description des commandes .................................. xvii Conventions typographiques utilisées pour les paramètres .......................................................... xviii Conventions typographiques utilisées pour les valeurs des paramètres ......................................... xix Conventions typographiques utilisées pour les valeurs de type générique..................................... xix Conventions typographiques utilisées pour les valeurs concernant des catégories prédéfinies ...... xx Conventions relatives aux spécificités dépendantes du système d’exploitation.............................. xx Conventions relatives aux spécificités dépendantes du protocole.................................................. xxi Conventions relatives aux spécificités inhérentes aux différents protocoles................................. xxii

1.

Les commandes.................................................................................................................1-1 1.1. Les commandes propres à CFTUTIL ........................................................................................... 1-1 1.2. Les commandes de paramétrage................................................................................................... 1-1 1.2.1. Présentation .......................................................................................................................... 1-1 1.2.2. Modification des paramètres ................................................................................................ 1-2 1.2.3. Syntaxe ................................................................................................................................. 1-4 1.3. Les commandes associées aux transferts...................................................................................... 1-5 1.3.1. Présentation .......................................................................................................................... 1-5 1.3.2. Commandes de transfert ....................................................................................................... 1-5 1.3.2.1. Définition ..................................................................................................................... 1-5 1.3.2.2. Syntaxe ......................................................................................................................... 1-6 1.3.3. Commandes de contrôle des transferts ................................................................................. 1-6 1.4. Les commandes d’administration de CFT.................................................................................... 1-8

2. Les commandes propres à l’utilitaire CFTUTIL................................................................2-1 2.1 Services.......................................................................................................................................... 2-1 2.1.1. CONFIG - Redéfinition des médias de données de CFTUTIL ............................................ 2-1 2.1.1.1. Syntaxe ......................................................................................................................... 2-4 2.1.1.2. Paramètres .................................................................................................................... 2-4 2.1.1.3. Exemples pour TYPE = OUTPUT............................................................................... 2-5 2.1.2. WAIT - Suspension de CFTUTIL ........................................................................................ 2-5 2.1.2.1. Syntaxe ......................................................................................................................... 2-5 2.1.2.2. Paramètre...................................................................................................................... 2-5 2.1.3. PURGE - Purge du catalogue ............................................................................................... 2-6 2.1.3.1. Syntaxe ......................................................................................................................... 2-6 2.1.3.2. Paramètre...................................................................................................................... 2-6

CFT V2.3

iii

Table des Matières

2.1.4. CLEARCMD - Suppression d'une requête de transfert........................................................ 2-6 2.1.4.1. Syntaxe ......................................................................................................................... 2-6 2.1.4.2. Paramètres .................................................................................................................... 2-6 2.1.4.3. Exemple........................................................................................................................ 2-7 2.1.5. KSTATE - Suspension d'un transfert ................................................................................... 2-8 2.1.5.1. Syntaxe ......................................................................................................................... 2-8 2.1.5.2. Paramètres .................................................................................................................... 2-9 2.1.6. WLOG - Demande d'écriture dans le fichier LOG............................................................... 2-9 2.1.6.1. Syntaxe ......................................................................................................................... 2-9 2.1.6.2. Paramètre...................................................................................................................... 2-9 2.2 Consultation et extraction.............................................................................................................. 2-9 2.2.1. CFTEXT - Extraction des données des fichiers Paramètres et Partenaires .......................... 2-9 2.2.1.1. Syntaxe ....................................................................................................................... 2-10 2.2.1.2. Paramètres .................................................................................................................. 2-10 2.2.1.3. Exemples .................................................................................................................... 2-11 2.2.2. LISTCAT - Liste des postes du catalogue.......................................................................... 2-12 2.2.2.1. Syntaxe ....................................................................................................................... 2-13 2.2.2.2. Paramètres .................................................................................................................. 2-13 2.2.2.3. Exemples .................................................................................................................... 2-15 2.2.2.4. Informations visualisées ............................................................................................. 2-16 2.2.2.4.1. Pour LISTCAT CONTENT = BRIEF, NPART = {identifier | mask}.............. 2-16 2.2.2.4.2. Pour LISTCAT CONTENT = BRIEF, PART = {identifier | mask}.................. 2-18 2.2.2.4.3. Pour LISTCAT CONTENT = FULL ................................................................. 2-20 2.2.3. LISTPARM - Liste des paramètres de CFT ....................................................................... 2-25 2.2.3.1. Syntaxe ....................................................................................................................... 2-25 2.2.3.2. Paramètres .................................................................................................................. 2-25 2.2.3.3. Exemples .................................................................................................................... 2-26 2.2.4. LISTPART - Liste des partenaires ..................................................................................... 2-26 2.2.4.1. Syntaxe ....................................................................................................................... 2-27 2.2.4.2. Paramètres .................................................................................................................. 2-27 2.2.4.3. Exemples .................................................................................................................... 2-28 2.3 Manipulation de fichiers.............................................................................................................. 2-28 2.3.1. CFTFILE - Création ou suppression des fichiers CFT....................................................... 2-28 2.3.1.1. Syntaxe ....................................................................................................................... 2-29 2.3.1.2. Paramètres .................................................................................................................. 2-30 2.3.1.3. Exemple de paramétrage CFTFILE............................................................................ 2-32

iv

CFT V2.3

Manuel de référence

2.3.2. COPYFILE - Copie de fichiers “off line” .......................................................................... 2-33 2.3.2.1. Syntaxe ....................................................................................................................... 2-33 2.3.2.2. Paramètres .................................................................................................................. 2-34 2.3.2.3. Statistiques ................................................................................................................. 2-39 2.3.2.4. Exemple...................................................................................................................... 2-40 2.3.3. LISTCOM - Liste des enregistrements du média de communication ................................ 2-41 2.3.3.1. Syntaxe ....................................................................................................................... 2-41 2.3.3.2. Paramètres .................................................................................................................. 2-41

3. Les commandes de paramétrage de l’environnement du moniteur..................................3-1 3.1 CFTPARM - Paramètres généraux................................................................................................ 3-1 3.1.1. Description ........................................................................................................................... 3-1 3.1.2. Syntaxe ................................................................................................................................. 3-2 3.1.3. Paramètres ............................................................................................................................ 3-3 3.1.4. Exemple.............................................................................................................................. 3-14 3.2 CFTCOM - Modes de communication applications / moniteur CFT .......................................... 3-16 3.2.1. Syntaxe ............................................................................................................................... 3-16 3.2.2. Paramètres .......................................................................................................................... 3-17 3.2.3. Exemples ............................................................................................................................ 3-19 3.3 CFTCAT - Paramètres de gestion du catalogue .......................................................................... 3-19 3.3.1. Syntaxe ............................................................................................................................... 3-19 3.3.2. Paramètres .......................................................................................................................... 3-20 3.3.3. Exemple.............................................................................................................................. 3-22 3.4 CFTLOG - Paramètres de gestion des fichiers journaux............................................................. 3-22 3.4.1. Syntaxe ............................................................................................................................... 3-23 3.4.2. Paramètres .......................................................................................................................... 3-23 3.4.3. Exemple.............................................................................................................................. 3-28 3.5 CFTACCNT - Mode d’enregistrement des données statistiques................................................. 3-28 3.5.1. Syntaxe ............................................................................................................................... 3-31 3.5.2. Paramètres .......................................................................................................................... 3-31 3.5.3. Exemples ............................................................................................................................ 3-32

4. Les commandes de paramétrage de l’environnement des transferts................................4-1 4.1 CFTSEND - Description d’émission ............................................................................................. 4-1 4.1.1. Paramètres associés à un fichier type ................................................................................... 4-1 4.1.1.1. Syntaxe ......................................................................................................................... 4-2 4.1.1.2. Synthèse des paramètres............................................................................................... 4-4 4.1.1.3. Paramètres .................................................................................................................... 4-5 4.1.2. Exemples ............................................................................................................................ 4-27

CFT V2.3

v

Table des Matières

4.1.3. Paramètres associés à un fichier type en cas d’émission à partir d’une base VFM............ 4-29 4.1.3.1. Syntaxe ....................................................................................................................... 4-29 4.1.3.2. Paramètres .................................................................................................................. 4-30 4.1.3.3. Exemples .................................................................................................................... 4-31 4.2 CFTRECV - Description de réception......................................................................................... 4-31 4.2.1. Paramètres associés à un fichier type ................................................................................. 4-31 4.2.1.1. Syntaxe ....................................................................................................................... 4-33 4.2.1.2. Synthèse des paramètres............................................................................................. 4-34 4.2.1.3. Paramètres .................................................................................................................. 4-35 4.2.1.4. Exemples .................................................................................................................... 4-54 4.2.2. Paramètres associés à un fichier type en cas de réception dans une base VFM ................. 4-55 4.2.2.1. Syntaxe ....................................................................................................................... 4-55 4.2.2.2. Paramètres .................................................................................................................. 4-56 4.2.2.3. Exemple...................................................................................................................... 4-57 4.3 CFTEXIT - Activation d’une tâche “exit”................................................................................... 4-57 4.3.1. Syntaxe ............................................................................................................................... 4-57 4.3.2. Paramètres .......................................................................................................................... 4-58 4.3.3. Exemples ............................................................................................................................ 4-59 4.4 CFTAUTH - Liste d’identifiants de fichiers types (IDF) ............................................................ 4-60 4.4.1. Syntaxe ............................................................................................................................... 4-60 4.4.2. Paramètres .......................................................................................................................... 4-61 4.4.3. Exemple.............................................................................................................................. 4-62 4.5 CFTIDF - Identifiants “réseau” d’un fichier type........................................................................ 4-62 4.5.1. Syntaxe ............................................................................................................................... 4-63 4.5.2. Paramètres .......................................................................................................................... 4-63 4.5.3. Exemple.............................................................................................................................. 4-64 4.6 CFTXLATE - Table de transcodage utilisée lors d’un transfert ................................................. 4-64 4.6.1. Principe du transcodage...................................................................................................... 4-64 4.6.2. Syntaxe ............................................................................................................................... 4-65 4.6.3. Paramètres .......................................................................................................................... 4-66 4.6.4. Exemple.............................................................................................................................. 4-67

5. Les commandes de paramétrage des réseaux et protocoles...............................................5-1 5.1 CFTNET - Ressources (locales) réseau......................................................................................... 5-1 5.1.1. CFTNET - Commande “générique” ..................................................................................... 5-2 5.1.1.1. Syntaxe ......................................................................................................................... 5-2 5.1.1.2. Paramètres .................................................................................................................... 5-2

vi

CFT V2.3

Manuel de référence

5.1.2. CFTNET TYPE = ASY - Ressource réseau asynchrone...................................................... 5-3 5.1.2.1. Syntaxe ......................................................................................................................... 5-3 5.1.2.2. Paramètres .................................................................................................................... 5-4 5.1.3. CFTNET TYPE = DNA - Ressource réseau DECNET ....................................................... 5-5 5.1.3.1. Syntaxe ......................................................................................................................... 5-5 5.1.3.2. Exemple........................................................................................................................ 5-5 5.1.4. CFTNET TYPE = DSA - Ressource réseau DSA................................................................ 5-5 5.1.4.1. Syntaxe ......................................................................................................................... 5-6 5.1.4.2. Paramètres .................................................................................................................... 5-6 5.1.4.3. Exemple........................................................................................................................ 5-6 5.1.5. CFTNET TYPE = LU62 - Ressources réseau LU6.2........................................................... 5-6 5.1.5.1. Syntaxe ......................................................................................................................... 5-7 5.1.5.2. Paramètres .................................................................................................................... 5-7 5.1.5.3. Exemple........................................................................................................................ 5-8 5.1.6. CFTNET TYPE = SNA - Ressources réseau SNA .............................................................. 5-8 5.1.6.1. Syntaxe générale .......................................................................................................... 5-9 5.1.6.2. Paramétrage côté HOST............................................................................................. 5-10 5.1.6.3. Exemples .................................................................................................................... 5-11 5.1.6.4. Paramétrage côté PU type2 : spécifique OS400......................................................... 5-11 5.1.6.5. Exemple...................................................................................................................... 5-12 5.1.6.6. Paramétrage côté PU type2 : spécifique VMS ........................................................... 5-12 5.1.6.7. Exemple...................................................................................................................... 5-13 5.1.6.8. Paramétrage côté PU type 2 : spécifique VOS........................................................... 5-14 5.1.6.9. Exemple...................................................................................................................... 5-14 5.1.7. CFTNET TYPE = TCP - Ressources réseau TCP/IP ......................................................... 5-14 5.1.7.1. Syntaxe ....................................................................................................................... 5-15 5.1.7.2. Paramètres .................................................................................................................. 5-15 5.1.7.3. Exemple...................................................................................................................... 5-15 5.1.8. CFTNET TYPE = TCP - Ressources réseaux déportées.................................................... 5-16 5.1.8.1. Syntaxe ....................................................................................................................... 5-16 5.1.8.2. Paramètres .................................................................................................................. 5-16 5.1.8.3. Exemple...................................................................................................................... 5-17 5.1.9. CFTNET TYPE = X25 - Ressources réseau X25............................................................... 5-18 5.1.9.1. Syntaxe ....................................................................................................................... 5-18 5.1.9.2. Paramètres spécifiques utilisables par systèmes......................................................... 5-18 5.1.9.2.1. Paramètres .......................................................................................................... 5-19 5.1.9.3. Exemple...................................................................................................................... 5-22

CFT V2.3

vii

Table des Matières

5.2 CFTPROT - Protocole de transfert .............................................................................................. 5-22 5.2.1. CFTPROT - Paramétrage “générique” ............................................................................... 5-23 5.2.1.1. Syntaxe ....................................................................................................................... 5-23 5.2.1.2. Paramètres .................................................................................................................. 5-24 5.2.2. CFTPROT TYPE = ETEBAC - Protocole ETEBAC 3...................................................... 5-30 5.2.2.1. Syntaxe ....................................................................................................................... 5-31 5.2.2.2. Paramètres .................................................................................................................. 5-31 5.2.3. CFTPROT TYPE = ODETTE - Protocole ODETTE......................................................... 5-31 5.2.3.1. Syntaxe ....................................................................................................................... 5-32 5.2.3.2. Paramètres .................................................................................................................. 5-32 5.2.4. CFTPROT TYPE = PESIT - Protocole PeSIT ................................................................... 5-34 5.2.4.1. Syntaxe ....................................................................................................................... 5-35 5.2.4.2. Paramètres .................................................................................................................. 5-36 5.2.4.3. Exemples .................................................................................................................... 5-42 5.3 CFTETB - Format de la carte ETEBAC 3................................................................................... 5-43 5.3.1. Caractéristiques relatives au transfert................................................................................. 5-43 5.3.2. Description du format de la carte paramètre ...................................................................... 5-44 5.3.3. Syntaxe ............................................................................................................................... 5-45 5.3.4. Paramètres .......................................................................................................................... 5-45 5.3.5. Exemple.............................................................................................................................. 5-47

6. Les commandes de paramétrage des partenaires...............................................................6-1 6.1 CFTPART - Définition d’un partenaire......................................................................................... 6-1 6.1.1. Syntaxe ................................................................................................................................. 6-1 6.1.2. Paramètres ............................................................................................................................ 6-2 6.1.3. Exemple................................................................................................................................ 6-9 6.2 CFTDEST - Définition d’une listes de partenaires...................................................................... 6-10 6.2.1. Syntaxe ............................................................................................................................... 6-11 6.2.2. Paramètres .......................................................................................................................... 6-11 6.3 CFTXXX - Définition réseau des partenaires ............................................................................. 6-13 6.3.1. Syntaxe ............................................................................................................................... 6-14 6.3.2. Paramètres .......................................................................................................................... 6-14 6.3.3. CFTDNA - Paramètres réseau d’un partenaire DNA (VAX)............................................. 6-16 6.3.3.1. Syntaxe ....................................................................................................................... 6-16 6.3.3.2. Paramètre.................................................................................................................... 6-16 6.3.3.3. Exemple...................................................................................................................... 6-17

viii

CFT V2.3

Manuel de référence

6.3.4. CFTDSA - Paramètres réseau d’un partenaire DSA (BULL) ............................................ 6-17 6.3.4.1. Syntaxe ....................................................................................................................... 6-17 6.3.4.2. Paramètres .................................................................................................................. 6-18 6.3.4.3. Exemple...................................................................................................................... 6-18 6.3.5. CFTSNA - Paramètres réseau d’un partenaire SNA .......................................................... 6-19 6.3.5.1. Syntaxe générale ........................................................................................................ 6-19 6.3.5.2. Paramétrage côté HOST............................................................................................. 6-20 6.3.5.3. Exemple...................................................................................................................... 6-22 6.3.5.4. Paramétrage côté PU T2............................................................................................. 6-22 6.3.5.5. Exemples .................................................................................................................... 6-23 6.3.6. CFTTCP - Paramètres réseau d’un partenaire TCP/IP ....................................................... 6-25 6.3.6.1. Syntaxe ....................................................................................................................... 6-25 6.3.6.2. Paramètres .................................................................................................................. 6-25 6.3.6.3. Exemple...................................................................................................................... 6-26 6.3.7. CFTX25 - Paramètres réseaux d’un partenaire X25 .......................................................... 6-26 6.3.7.1. Syntaxe ....................................................................................................................... 6-27 6.3.7.2. Paramètres .................................................................................................................. 6-27 6.3.7.3. Exemple...................................................................................................................... 6-29 6.3.8. CFTLU62 - Paramètres réseau d’un partenaire LU62........................................................ 6-30 6.3.8.1. Syntaxe ....................................................................................................................... 6-30 6.3.8.2. Paramètres .................................................................................................................. 6-30 6.3.8.3. Exemples .................................................................................................................... 6-31 6.3.9. CFTASY - Paramètres réseau d’un partenaire asynchrone ................................................ 6-32 6.3.9.1. Syntaxe ....................................................................................................................... 6-32 6.3.9.2. Paramètres .................................................................................................................. 6-32

7.

Les commandes associées aux transferts........................................................................7-1 7.1. Transferts ...................................................................................................................................... 7-1 7.1.1. SEND TYPE = FILE - Emission de fichier.......................................................................... 7-1 7.1.1.1. Syntaxe ......................................................................................................................... 7-1 7.1.1.2. Paramètres .................................................................................................................... 7-3 7.1.1.3. Exemples ...................................................................................................................... 7-7 7.1.2. SEND TYPE = MESSAGE - Emission de message ............................................................ 7-7 7.1.2.1. Syntaxe ......................................................................................................................... 7-8 7.1.2.2. Paramètres .................................................................................................................... 7-8

CFT V2.3

ix

Table des Matières

7.1.3. SEND TYPE = REPLY - Emission de réponse .................................................................. 7-9 7.1.3.1. Syntaxe ....................................................................................................................... 7-10 7.1.3.2. Paramètres .................................................................................................................. 7-10 7.1.3.3. Exemple...................................................................................................................... 7-11 7.1.4. RECV - Réception de fichiers ............................................................................................ 7-12 7.1.4.1. Syntaxe ....................................................................................................................... 7-13 7.1.4.2. Paramètres .................................................................................................................. 7-14 7.1.4.3. Exemples .................................................................................................................... 7-20 7.2. Les actions sur les transferts ....................................................................................................... 7-22 7.2.1. DELETE - Suppression des postes du catalogue................................................................ 7-22 7.2.1.1. Syntaxe ....................................................................................................................... 7-22 7.2.1.2. Paramètres .................................................................................................................. 7-22 7.2.1.3. Exemples .................................................................................................................... 7-23 7.2.2. HALT - Arrêt de transferts ................................................................................................. 7-24 7.2.2.1. Syntaxe ....................................................................................................................... 7-24 7.2.2.2. Paramètres .................................................................................................................. 7-24 7.2.2.3. Exemples .................................................................................................................... 7-25 7.2.3. KEEP - Suspension de transferts ........................................................................................ 7-25 7.2.3.1. Syntaxe ....................................................................................................................... 7-26 7.2.3.2. Paramètres .................................................................................................................. 7-26 7.2.3.3. Exemples .................................................................................................................... 7-27 7.2.4. RESUME - Remise à disposition ....................................................................................... 7-27 7.2.4.1. Syntaxe ....................................................................................................................... 7-27 7.2.4.2. Paramètres .................................................................................................................. 7-27 7.2.4.3. Exemples .................................................................................................................... 7-28 7.2.5. START - Redémarrage de transferts .................................................................................. 7-28 7.2.5.1. Syntaxe ....................................................................................................................... 7-29 7.2.5.2. Paramètres .................................................................................................................. 7-29 7.2.5.3. Exemples .................................................................................................................... 7-30 7.2.6. SUBMIT - Soumission d’une procédure de fin de transfert............................................... 7-30 7.2.6.1. Syntaxe ....................................................................................................................... 7-30 7.2.6.2. Paramètres .................................................................................................................. 7-31 7.2.6.3. Exemples .................................................................................................................... 7-32 7.2.6.3.1. Transfert simple ................................................................................................. 7-32 7.2.6.3.2. Liste de diffusion................................................................................................ 7-32

x

CFT V2.3

Manuel de référence

7.2.7. END - Déclaration de transferts exécutés........................................................................... 7-33 7.2.7.1. Syntaxe ....................................................................................................................... 7-33 7.2.7.2. Paramètres .................................................................................................................. 7-33 7.2.7.3. Exemples .................................................................................................................... 7-34 7.3. Interrogation d’un composant du moniteur ................................................................................ 7-35 7.3.1. MQUERY - Interrogation d’un composant du moniteur.................................................... 7-35 7.3.1.1. Syntaxe ....................................................................................................................... 7-35 7.3.1.2. Paramètres .................................................................................................................. 7-35 7.3.1.3. Exemples .................................................................................................................... 7-35 7.4. Actions sur les partenaires .......................................................................................................... 7-36 7.4.1. INACT - Désactivation de partenaire................................................................................. 7-36 7.4.1.1. Syntaxe ....................................................................................................................... 7-36 7.4.1.2. Paramètres .................................................................................................................. 7-36 7.4.2. ACT - Réactivation de partenaire....................................................................................... 7-37 7.4.2.1. Syntaxe ....................................................................................................................... 7-37 7.4.2.2. Paramètres .................................................................................................................. 7-38

8. Les commandes d’administration du moniteur CFT.........................................................8-1 8.1. SHUT - Arrêt de CFT................................................................................................................... 8-1 8.1.1. Syntaxe ................................................................................................................................. 8-1 8.1.2. Paramètre.............................................................................................................................. 8-1 8.2. SWITCH - Basculement manuel des fichiers de suivi ................................................................. 8-1 8.2.1. Syntaxe ................................................................................................................................. 8-2 8.2.2. Paramètres ............................................................................................................................ 8-2 8.3. ABOUT - Caractéristiques de la machine .................................................................................... 8-2 8.3.1. Syntaxe ................................................................................................................................. 8-2 8.3.2. Paramètre.............................................................................................................................. 8-2 8.3.3. Informations affichées .......................................................................................................... 8-3 8.3.4. Exemple................................................................................................................................ 8-3 8.4. FLUSH - Optimisation des blocs internes du fichier catalogue ................................................... 8-3 8.4.1. Syntaxe ................................................................................................................................. 8-3 8.4.2. Paramètres ............................................................................................................................ 8-4

A. La compression ....................................................................................................................A-1 A.1. La compression ........................................................................................................................ A-1 A.1.1. Compression en protocole PeSIT “hors SIT”..................................................................... A-1 A.1.2. Compression en protocole ODETTE.................................................................................. A-3 A.1.3. Compression en protocole ETEBAC.................................................................................. A-3

CFT V2.3

xi

Table des Matières

B. NTYPE émis par défaut ......................................................................................................B-1 B.1. Valeur par défaut du NTYPE émis........................................................................................... B-1

C. Transcodage : tables internes, exemples............................................................................C-1 C.1. Tables internes.......................................................................................................................... C-1 C.1.1. Table interne de correspondance des alphabets ASCII / EBCDIC ..................................... C-1 C.1.2. Tables de transcodage internes à CFT ................................................................................ C-7 C.2. Exemples de transcodage ......................................................................................................... C-8 C.2.1. Exemple de transcodage d’un alphabet réduit .................................................................... C-8

D. Fichier statistique des transferts : structures....................................................................D-1 D.1. Le fichier statistique des transferts........................................................................................... D-1 D.1.1. Structure des données en langage C ................................................................................... D-1 D.1.2. Structure des données en langage COBOL......................................................................... D-2

E. CFTCATAL..........................................................................................................................E-1 E.1. Définition ..................................................................................................................................E-1 E.2. Fonctionnement.........................................................................................................................E-1 E.3. Mode d’utilisation .....................................................................................................................E-1

F. Structure du fichier de configuration................................................................................. F-1

G.

F.1.

Introduction ...............................................................................................................................F-1

F.2.

Paramètres obligatoires .............................................................................................................F-1

F.3.

Paramètres facultatifs pour TYPE=TCP ...................................................................................F-2

F.4.

Exemples de fichiers .................................................................................................................F-2

Fichier de configuration de l’API de suivi Sentinel .................................................... G-1 G.1. Introduction ................................................................................................................................ G-1 G.2. Paramètres .................................................................................................................................. G-1 G.3. Exemple de fichier...................................................................................................................... G-3

Index ...................................................................................................................................Index-1

xii

CFT V2.3

Table des Figures Figure 1.

Médias concernés par les commandes de CFTUTIL ............................................................................ 2-2

Figure 2. LISTCAT CONTENT = BRIEF, NPART = {identifier | mask}............................................................. 2-16 Figure 3. LISTCAT CONTENT = BRIEF, PART = {identifier | mask}................................................................ 2-18 Figure 4. LISTCAT CONTENT = FULL............................................................................................................... 2-20 Figure 5.

Statistiques de l’exécution - Commande COPYFILE......................................................................... 2-39

Figure 6.

Mécanisme d’émission d’un message de réponse............................................................................... 7-11

Figure 7.

Exemple de paramétrage..................................................................................................................... 7-18

CFT V2.3

xiii

Liste des Tableaux Tableau 1. Conventions typographiques utilisées pour les valeurs des paramètres...................................................xix Tableau 2. Conventions typographiques utilisées pour les valeurs de type générique ..............................................xix Tableau 3. Conventions typographiques utilisées pour les valeurs concernant des catégories prédéfinies ................xx Tableau 4. Commandes propres à CFTUTIL ......................................................................................................... 1-1 Tableau 5. Signification des mots-clés des commandes de paramétrage................................................................ 1-2 Tableau 6. Signification des mots-clés des commandes de transfert ...................................................................... 1-5 Tableau 7. Commandes de contrôle des transferts.................................................................................................. 1-7 Tableau 8. Signification des états de transfert ........................................................................................................ 1-7 Tableau 9. Transition d’état .................................................................................................................................... 1-8 Tableau 10. Signification des mots-clés des commandes d’administration.............................................................. 1-8 Tableau 11. CFTUTIL TYPE - Médias concernés ................................................................................................... 2-5 Tableau 12. CFTEXT TYPE - Valeurs prédéfinies ............................................................................................... 2-11 Tableau 13. LISTCAT CONTENT = BRIEF, NPART - Commentaires des rubriques ......................................... 2-17 Tableau 14. LISTCAT CONTENT = BRIEF, PART - Commentaires des rubriques ............................................ 2-19 Tableau 15. LISTCAT CONTENT = FULL - Commentaires des rubriques.......................................................... 2-22 Tableau 16. LISTPARM Type - Valeurs prédéfinies ............................................................................................. 2-25 Tableau 17. LISTPART TYPE - Valeurs prédéfinies............................................................................................. 2-27 Tableau 18. CFTFILE FBLKSIZE - Valeurs par défaut et OS concernés............................................................. 2-30 Tableau 19. CFTFILE FSPACE - Valeurs par défaut et OS concernés................................................................. 2-31 Tableau 20. CFTFILE FSPACEX - Valeurs par défaut et OS concernés............................................................... 2-31 Tableau 21. CFTFILE TYPE - Types de fichiers concernés .................................................................................. 2-32 Tableau 22. COPYFILE - Paramètres .................................................................................................................... 2-34 Tableau 23. COPYFILE IBLKSIZE - OS concernés ............................................................................................. 2-34 Tableau 24. COPYFILE OBLKSIZE - OS concernés............................................................................................ 2-36 Tableau 25. COPYFILE - Statistiques d’exécution ................................................................................................ 2-40 Tableau 26. CFTPARM BUFSIZE - Tailles maximales et valeurs par défaut ......................................................... 3-3 Tableau 27. CFTPARM MAXTASK - Nombre maximum...................................................................................... 3-9 Tableau 28. CFTPARM MAXTRANS - Nombre maximum ................................................................................... 3-9 Tableau 29. CFTPARM TRANTASK - Nombre maximum .................................................................................. 3-11 Tableau 30. CFTPARM USERCTRL - OS concernés ........................................................................................... 3-13 Tableau 31. CFTPARM WAITRESP - Valeurs par défaut .................................................................................... 3-13 Tableau 32. CFTPARM WAITTASK - OS concernés........................................................................................... 3-14 Tableau 33 CFTCOM ADDRLIST - Types d'adresses autorisées.......................................................................... 3-18 Tableau 34. CFTLOG NOTIFY - Destinataires possibles...................................................................................... 3-25 Tableau 35. CFTLOG NOTIFY - Valeurs par défaut............................................................................................. 3-26

xiv

CFT V2.3

Manuel de référence Tableau 36. CFTLOG NOTIFY - Choix possibles dans le cas «console opérateur».............................................. 3-26 Tableau 37. Catégories des messages d’information sur les transferts ................................................................... 3-27 Tableau 38. CFTLOG OPERMSG - Valeurs par défaut ........................................................................................ 3-27 Tableau 39. CFTACCNT - Liste des rubriques ...................................................................................................... 3-29 Tableau 40. CFTSEND FBLKSIZE - OS concernés................................................................................................ 4-7 Tableau 41. CFTSEND FNAME - Récapitulatif des différents cas ......................................................................... 4-9 Tableau 42. CFTSEND FNAME - Fichier à versions ............................................................................................ 4-10 Tableau 43. CFTSEND NOTIFY - Destinataires possibles.................................................................................... 4-19 Tableau 44. CFTSEND NOTIFY - Valeurs par défaut .......................................................................................... 4-19 Tableau 45. CFTSEND NOTIFY - Choix dans le cas «console opérateur»........................................................... 4-20 Tableau 46. Catégories des messages d’information sur les transferts ................................................................... 4-21 Tableau 47. CFTSEND OPERMSG - Valeurs par défaut ...................................................................................... 4-22 Tableau 48. CFTRECV FACTION/FDISP - Actions possibles ............................................................................. 4-37 Tableau 49. CFTRECV FBLKSIZE - OS concernés.............................................................................................. 4-38 Tableau 50. CFTRECV NOTIFY - Destinataires possibles ................................................................................... 4-46 Tableau 51. CFTRECV NOTIFY - Valeurs par défaut .......................................................................................... 4-47 Tableau 52. CFTRECV NOTIFY - Choix dans le cas «console opérateur»........................................................... 4-47 Tableau 53. Catégories des messages d’information sur les transferts ................................................................... 4-48 Tableau 54. CFTRECV OPERMSG - Valeurs par défaut ...................................................................................... 4-48 Tableau 55. CFTEXIT ID - Commande et paramètre associé à l’EXIT traité........................................................ 4-58 Tableau 56. CFTEXIT RESERV - Valeurs par défaut et plage de valeurs............................................................. 4-59 Tableau 57. CFTXLATE FCODE - Valeurs par défaut ......................................................................................... 4-66 Tableau 58. CFTNET TYPE = SNA - Nombre maximum de commandes .............................................................. 5-8 Tableau 59. CFTNET TYPE = SNA - Emploi des paramètres................................................................................. 5-9 Tableau 60. CFTNET TYPE = X25 - Emploi des paramètres................................................................................ 5-19 Tableau 61. CFTNET TYPE = X25 LINEID - Valeurs du paramètre.................................................................... 5-20 Tableau 62. CFTPROT DISCTD - Valeurs par défaut........................................................................................... 5-24 Tableau 63. CFTPROT DISCTS - Valeurs par défaut............................................................................................ 5-25 Tableau 64. CFTPROT RCOMP - Valeurs par défaut ........................................................................................... 5-27 Tableau 65. FTPROT SAP - Valeurs du paramètre............................................................................................... 5-28 Tableau 66. CFTPROT SCOMP - Valeurs par défaut............................................................................................ 5-29 Tableau 67. CFTPART SAP - Valeurs du paramètre ............................................................................................... 6-7 Tableau 68. CFTXXX CNXINOUT - Nombre maximum de sessions................................................................... 6-14 Tableau 69. CFTSNA LUNAME/LOGMODE - Emploi des paramètres .............................................................. 6-20 Tableau 70. RECV IDF - Types d’identifiants autorisés ........................................................................................ 7-12 Tableau 71. SUBMIT - Catalogue avant exécution de la procédure de fin de transfert ......................................... 7-33 Tableau 72. Protocoles et compression.....................................................................................................................A-1 Tableau 73. Protocole PeSIT - Types de compression .............................................................................................A-1 Tableau 74. Protocole PeSIT - Valeurs par défaut....................................................................................................A-3

CFT V2.3

xv

Liste des figures, Liste des Tableaux Tableau 75. CFTSEND/SEND - Valeur du NTYPE pour les systèmes émetteurs et destinataires ..........................B-2 Tableau 76. Correspondances ASCII / EBCDIC .....................................................................................................C-1 Tableau 77. Transcodage ASCII vers EBCDIC en émission et réception ................................................................C-7 Tableau 78. Transcodage EBCDIC vers ASCII en émission et en réception ...........................................................C-7 Tableau 79. Transcodage ASCII vers EBCDIC en émission....................................................................................C-8 Tableau 80. Transcodage ASCII vers EBCDIC en réception ...................................................................................C-8

xvi

CFT V2.3

Conventions typographiques utilisées dans le Manuel de référence de CFT

Conventions typographiques utilisées dans la description des commandes La description de chaque commande est organisée de façon générale en quatre parties : •

description fonctionnelle,

•

liste indiquant la syntaxe générale des paramètres attachés à la commande, regroupés par catégories, Exemple : CFTFILE [MODE = FNAME = TYPE =

•

{CREATE | DELETE},] filename, {PARM | PART | CAT | LOG | ACCNT | COM},

description détaillée des paramètres, dans l’ordre alphabétique, FNAME

= filename

Nom du fichier sur lequel s’applique la commande. •

exemple générique de paramétrage : les exemples de paramétrage sont donnés en police courrier. Exemple : CFTFILE

TYPE = PARM, MODE = CREATE, FNAME = filename Création d’un fichier Paramètres.

CFT V2.3

xvii

Conventions typographiques

Conventions typographiques utilisées pour les paramètres Deux types de paramètres existent : •

les paramètres obligatoires,

•

les paramètres facultatifs (indiqués entre crochets [ ]).

La description de chaque paramètre respecte la syntaxe générale suivante : PARAMETRE = valeur(s)

informations

Définition de la/des valeur(s) du paramètre

Indication d'un ou plusieurs compléments d'information relatifs à la valeur indiquée où à une restriction d'emploi

SPECIFICITES

Précisions sur le domaine d'utilisation du paramètre

Les champs “informations” et “spécificités” sont optionnels. Exemple 1 : OFNAME

= filename

Dans la commande considérée (en l’occurrence COPYFILE), ce paramètre est obligatoire. Sa valeur correspond à un nom de fichier. Exemple 2 : [NFNAME

= filename]

PeSIT D profil CFT

Dans la commande considérée (en l’occurrence CFTSEND), ce paramètre :

xviii

•

sert à indiquer un nom physique de fichier,

•

est facultatif sans valeur par défaut, le caractère FACULTATIF étant indiqué par les crochets [ ] ,

•

est réservé aux cas de transferts en protocole PeSIT D profil CFT et PeSIT E entre deux moniteurs CFT.

CFT V2.3

Manuel de référence

Conventions typographiques utilisées pour les valeurs des paramètres Les conventions utilisées de manière générale pour la description des valeurs des paramètres sont les suivantes : Tableau 1. Conventions typographiques utilisées pour les valeurs des paramètres Type

Notation

Exemple

Liste de valeurs possibles Choix Champ numérique (valeur comprise entre a et b) Valeur par défaut {valeur | texte} à renseigner

{valeur, valeur} {1 | 2} {a..b}

{filename, string} {CREATE | DELETE} {0..255}

soulignée italique

{CREATE | DELETE} filename

Conventions typographiques utilisées pour les valeurs de type générique Les conventions utilisées pour les valeurs de type générique sont les suivantes : Tableau 2. Conventions typographiques utilisées pour les valeurs de type générique Type

Notation

Exemple

Valeur de type caractère : un seul caractère Valeur de type numérique : chaîne de caractères numériques Valeur de type chaîne de caractères : suite de caractères alphanumériques ou suite de caractères entre quotes Si le paramètre est obligatoire : chaîne de longueur comprise entre 1 et n caractères

c n

FTYPE = c FLRECL = n

string

SAP = string

stringn

PUNAME = string10 Chaîne comprise entre 1 et 10 caractères

Si le paramètre est facultatif : chaîne de longueur comprise entre 0 et n caractères Chaîne de longueur comprise entre n et m caractères

stringn..m

Chaîne de n caractères (exactement)

stringn

Valeur de type constante (prédéfinie)

VALEUR

[COMMENT = string32] Chaîne comprise entre 0 et 32 caractères LUNAME = string3..8 Chaîne comprise entre 3 et 8 caractères KEY = string21 Chaîne de 21 caractères TYPE = PESIT

Attention : la notation string est utilisée de manière générique, par exemple dans les listes indiquant la syntaxe générale des paramètres. Les notations stringn, stringn..m et stringn sont utilisées dans la description détaillée des paramètres.

CFT V2.3

xix

Conventions typographiques

Conventions typographiques utilisées pour les valeurs concernant des catégories prédéfinies Les conventions utilisées pour les valeurs concernant des catégories prédéfinies sont les suivantes : Tableau 3. Conventions typographiques utilisées pour les valeurs concernant des catégories prédéfinies Type

Notation

Compression : valeur numérique de 0 à 15 liée à l’algorithme de compression Date : chaîne de 8 caractères numériques Nom de fichier, chaîne alphanumérique d’une longueur maximum de 64 caractères Identifiant, chaîne de 1 à 8 caractères alphanumériques avec le premier caractère alphabétique Masque, chaîne de caractères spéciaux constituant un “masque” Time : chaîne de 2 à 8 caractères numériques Identifiant de transfert attribué par CFT

cpr AAAAMMJJ filename identifier mask HHMMSS transid

Conventions relatives aux spécificités dépendantes du système d’exploitation Dans les listes indiquant la syntaxe des paramètres, les spécificités dépendantes d’un ou de plusieurs systèmes d’exploitation sont notées de la manière générique suivante :

OS

Exemple : ACCID

=n

OS

Dans la description détaillée d’un paramètre, le ou les systèmes d’exploitation pour lesquels ce paramètre est pertinent sont indiqués de façon détaillée, par système d’exploitation concerné. Exemple : ACCID

=n

GCOS7

MVS

VM

Selon le système concerné, la valeur par défaut d’un paramètre peut être différente. Cette spécificité est notée de la manière suivante :

Dft : OS

Exemple : [FCODE

xx

= {BINARY | EBCDIC | ASCII}

Dft : OS

CFT V2.3

Manuel de référence

Conventions relatives aux spécificités dépendantes du protocole Dans les listes indiquant la syntaxe des paramètres, les spécificités dépendantes d’un ou de plusieurs protocoles sont notées de la manière générique suivante :

PROTOCOLE

Exemple : [NSPACE

PROTOCOLE

= n,]

Dans la description détaillée d’un paramètre, le ou les protocoles concernés sont indiqués de manière explicite. Cette notation est utilisée, par exemple, dans les cas suivants : •

le paramètre associé n’est renseigné que pour certains protocoles. Exemple : [NSPACE

•

= {valeur de FSPACE | n},]

ODETTE

PeSIT

La valeur du paramètre associé a une longueur différente selon le protocole. Exemple : [NSPASSW

= string] string8

PeSIT

string8

ODETTE

string22

ETEBAC

Selon le protocole concerné, la valeur par défaut d’un paramètre peut être différente ; cette spécificité est indiquée de la manière suivante :

Dft : PROTOCOLE

Exemple : = {voir le commentaire | BINARY | EBCDIC | ASCII}]

Dft : PROTOCOLE

Selon le profil du protocole PeSIT utilisé, la valeur par défaut d’un paramètre peut être différente ; cette spécificité est indiquée de la manière suivante :

Dft : PROFIL

[NCODE

Exemple : [DISCTS

= n]

Dft : PROFIL

Dans la commande considérée, ici CFTPROT TYPE=PeSIT, si le paramètre n’est pas renseigné, il prendra la valeur par défaut du profil utilisé.

CFT V2.3

xxi

Conventions typographiques

Conventions relatives aux spécificités inhérentes aux différents protocoles PeSIT

Spécificité concernant le protocole PeSIT. Une spécificité peut ne concerner qu’une ou plusieurs variantes du protocole PeSIT. Ces variantes sont alors indiquées de la manière suivante :

PeSIT profil SIT

Spécificité concernant le protocole PeSIT en profil SIT.

PeSIT D profil EXTERN

Spécificité concernant le protocole PeSIT D en profil EXTERN.

PeSIT D profil CFT

Spécificité concernant le protocole PeSIT D en profil CFT.

PeSIT E

Spécificité concernant le protocole PeSIT E (standard).

PeSIT E CFT/CFT

Spécificité concernant le protocole PeSIT E utilisé entre deux moniteurs CFT (extension des fonctionnalités dans le PI 99).

ETEBAC3

xxii

Spécificité concernant le protocole ETEBAC3.

CFT V2.3

Introduction au “Manuel de référence” de CFT Le présent manuel constitue une référence pour toutes les commandes interprétables par l’utilitaire CFTUTIL, qui accompagne CFT-V2. Les commandes interprétables par CFTUTIL sont associées : • à la configuration de CFT (adaptation à son environnement d’exploitation), • à l’utilisation de CFT et CFTUTIL (notamment : déclenchement et suivi des transferts). L’utilisateur trouvera donc, dans ce document, des informations complémentaires concernant la mise en oeuvre de CFT et l’intégration des transferts de fichiers dans les chaînes de traitement applicatives : emploi des procédures de fin de transfert, des variables symboliques, ... Ce manuel est commun à tous les produits CFT. Les éléments spécifiques à chaque système d’exploitation sont signalés, lorsque nécessaire, par des encadrés (voir les “Conventions typographiques”). La recherche d’une commande ou d’un paramètre est facilitée par la présence d’un index en fin de document. Le “Manuel de référence” de CFT est articulé autour de 8 chapitres : • le chapitre 1 présente de façon générale les commandes, • le chapitre 2 présente les commandes propres à CFTUTIL, • le chapitre 3 présente les commandes de paramétrage de l’environnement du moniteur, • le chapitre 4 présente les commandes de paramétrage de l’environnement des transferts, • le chapitre 5 présente les commandes de paramétrage des réseaux et protocoles, • le chapitre 6 présente les commandes de paramétrage des partenaires, • le chapitre 7 présente les commandes associées aux transferts, • le chapitre 8 présente les commandes d’administration du moniteur. Les conventions typographiques utilisées dans le “Manuel de référence” de CFT sont décrites dans un chapitre particulier. Ces conventions permettent de préciser la syntaxe employée dans la description des commandes CFT. A qui s’adresse le “Manuel de référence” CFT ? Ce document s’adresse aux praticiens (ingénieurs système-réseau, opérateurs, responsables d’exploitation, développeurs) ayant besoin d’informations détaillées, soit pour exploiter CFT, soit pour en assurer la complète intégration dans l’environnement considéré (environnement systèmeréseau, environnement applicatif). La lecture du guide “Concepts” de CFT ou la participation à une formation CFT est un atout complémentaire, pour une bonne compréhension et un bon usage du présent document.

CFT V2.3

xxiii

1.

Les commandes

1.1. Les commandes propres à CFTUTIL Les commandes propres à l’utilitaire CFTUTIL peuvent être regroupées en trois catégories, telles que présentées dans le tableau suivant. Tableau 4.

Commandes propres à CFTUTIL

Catégorie Services

Mot-clé CLEARCMD CONFIG KSTATE PURGE WAIT

Consultations et extractions

Manipulations de fichiers

WLOG CFTEXT LISTPARM LISTPART LISTCAT CFTFILE COPYFILE

Fonctionnalité Suppression d'une requête de transfert Désignation du média de communication et des fichiers accédés par CFTUTIL Suspension d'un transfert Suppression des enregistrements du catalogue Suspension de l’exécution de CFTUTIL pour la durée indiquée Demande d'écriture dans le fichier LOG Extraction des données des fichiers Paramètres et Partenaires Liste des paramètres CFT Liste des partenaires Liste des postes du catalogue Création ou suppression des fichiers CFT Copie de fichiers avec possibilité de compression ou décompression “off line”

Concernant les consultations et extractions, les fichiers lus ne correspondent pas forcément à ceux qu’utilisent, au même moment, le moniteur CFT. Les fichiers accédés peuvent éventuellement être sélectionnés, pour une exécution de CFTUTIL, via la commande CONFIG.

1.2. Les commandes de paramétrage

1.2.1. Présentation Lors de la phase de paramétrage, les données décrivant l’environnement de CFT sont saisies : • soit par l’intermédiaire de lignes de commande interprétées par l’utilitaire CFTUTIL, • soit par l’intermédiaire des écrans de saisie des fonctions interactives (CFTINT). Une mise à jour des paramètres CFT par CFTUTIL ou CFTINT résulte en une mise à jour des fichiers indexés PARAMETRES et PARTENAIRES.

CFT 2.3

1-1

Les commandes

Remarques : les produits CFT sont livrés avec des exemples de paramétrage sous forme de source interprétable par CFTUTIL. En exploitation, on conserve généralement au moins une partie des commandes de paramétrage, adaptées à cette exploitation, dans un fichier source de référence. L’utilisateur qui décide de paramétrer CFT par l’intermédiaire des fonctions interactives (CFTINT), reconnaîtra dans les écrans de saisie les mêmes informations que celles figurant dans les commandes interprétées par CFTUTIL. Pour une information complémentaire sur CFTINT, consultez le “Guide des fonctions interactives” de CFT. Tableau 5.

Signification des mots-clés des commandes de paramétrage

Catégorie

Mot-clé

Signification

Environnement du moniteur

CFTPARM CFTCOM

Paramètres généraux d’environnement moniteur Paramètres liés à la communication entre les applications et le moniteur CFT Paramètres de gestion du catalogue Paramètres de gestion des fichiers journaux Mode d’enregistrement des données statistiques Description des paramètres d’émission d’un fichier type Description des paramètres de réception d’un fichier type Activation d’une tâche “exit” Liste d’identifiants de fichiers types (IDF) autorisés Correspondance entre identifiant réseau et identifiant local d’un fichier type transféré Table de transcodage utilisée lors d’un transfert Ressources (locales) réseau Protocole de transfert Format de la carte ETEBAC 3 Définition d’un partenaire Définition d’une liste de partenaires Paramètres réseau d’un partenaire X25 Paramètres réseau d’un partenaire TCP/IP Paramètres réseau d’un partenaire SNA Paramètres réseau d’un partenaire DSA (BULL) Paramètres réseau d’un partenaire DNA (VAX) Paramètres réseau d’un partenaire LU62 Paramètres réseau d’un partenaire asynchrone

Environnement des transferts

CFTCAT CFTLOG CFTACCNT CFTSEND CFTRECV CFTEXIT CFTAUTH CFTIDF

Réseaux et protocoles

Partenaires

CFTXLATE CFTNET CFTPROT CFTETB CFTPART CFTDEST CFTX25 CFTTCP CFTSNA CFTDSA CFTDNA CFTLU62 CFTASY

1.2.2. Modification des paramètres Lorsque le moniteur est actif, la prise en compte par celui-ci d’une modification de paramètre dépend de la commande concernée.

1-2

CFT 2.3

Manuel de référence

Le moniteur CFT doit être arrêté puis relancé, pour que les nouvelles valeurs soient prises en compte, pour les commandes : • définissant les paramètres généraux d’environnement du moniteur : -

CFTPARM,

-

CFTCOM,

-

CFTCAT,

-

CFTACCNT,

-

CFTLOG,

• définissant les paramètres réseaux et protocoles : -

CFTNET,

-

CFTPROT,

-

CFTETB.

Ces paramètres sont des paramètres statiques. Pour les autres commandes, ces modifications sont prises en compte dynamiquement par le moniteur CFT (paramètres dynamiques), lors des nouveaux transferts à venir (éventuellement sur la même connexion réseau), pour les commandes concernant : • les transferts : -

CFTAUTH,

-

CFTIDF,

-

CFTXLATE,

-

CFTSEND,

-

CFTRECV,

-

CFTEXIT,

• les partenaires : -

CFTPART,

-

CFTDEST.

Ces modifications sont également prises en compte : • lors de relance de transferts interrompus, pour la commande CFTPART, • lors de nouvelles sessions (à venir) avec un partenaire, pour les commandes CFTXXX suivantes définissant les paramètres réseaux d’un partenaire :

CFT 2.3

-

CFTX25,

-

CFTTCP,

-

CFTSNA,

-

CFTDSA,

-

CFTDNA,

-

CFTLU62,

-

CFTASY.

1-3

Les commandes

Cas particulier : les commandes associées à un identifiant par défaut L’identifiant par défaut : • concerne les commandes de transfert (CFTSEND, CFTRECV, CFTXLATE) et la commande de description réseau X25 (CFTX25), • est défini dans la commande CFTPARM de description des paramètres généraux (CFTPARM ... DEFAULT = defaut). La modification d’un identifiant par défaut n’est prise en compte que lorsque le moniteur a été arrêté puis relancé. Les commandes de paramétrage sont traitées de façon autonome par CFTUTIL ; il y a interférence avec le fonctionnement du moniteur CFT, dans la mesure où celui-ci est susceptible de lire, à tout moment, le fichier PARAMETRES ou PARTENAIRES résultant.

1.2.3. Syntaxe Les commandes de paramétrage sont présentées avec la syntaxe suivante : CFT***

ID

ID = identifier, MODE = {REPLACE | CREATE | DELETE}, PARAMETRE = valeur = identifier

SPECIFICITES

Identifie l’objet décrit par la commande de paramétrage. MODE

= {REPLACE | CREATE | DELETE}

Décrit l’opération à effectuer sur le fichier PARAMETRES ou PARTENAIRES. Chaque commande de paramétrage génère un ou plusieurs enregistrements binaires dans les fichiers PARAMETRES ou PARTENAIRES : • REPLACE :

modifier le ou les enregistrements associés, ou les créer s’ils n’existent pas ; c’est la valeur par défaut (soulignée),

• CREATE :

ajouter un ou plusieurs enregistrements,

• DELETE :

supprimer un ou plusieurs enregistrements.

Tous les paramètres nécessaires à l’identification du fichier doivent être précisés, sauf dans le cas de DELETE où le paramètre ID suffit. Attention : dans le cas de REPLACE : • si le paramètre CLASS est modifié, un nouvel enregistrement est créé, • sinon, l’enregistrement antérieur est écrasé par le nouvel enregistrement. Seuls les paramètres spécifiés dans la commande sont pris en compte. Les paramètres non spécifiés prennent les valeurs par défaut. Le commentaire sur le paramètre MODE est commun à toutes les commandes de paramétrage et n’est pas repris dans les pages suivantes.

1-4

CFT 2.3

Manuel de référence

PARAMETRE = valeur

informations

SPECIFICITES

Commentaire associé à PARAMETRE.

1.3. Les commandes associées aux transferts

1.3.1. Présentation Les commandes associées aux transferts sont listées et explicitées dans le tableau ci-dessous. Tableau 6.

Signification des mots-clés des commandes de transfert

Catégorie

Mot-clé

Signification

Transferts

SEND RECV DELETE HALT KEEP START SUBMIT

Emission de fichiers ou de messages Réception de fichiers Suppression de postes du catalogue Arrêt de transferts Suspension de transferts Redémarrage de transferts Soumission d’une procédure de fin de transfert (transfert en état T) Déclaration de transferts exécutés

Actions sur les transferts

END

Pour chacune des commandes associées, CFTUTIL assure : • le contrôle syntaxique de la commande, • le dépôt de cette commande dans le média de communication de CFTUTIL, permettant la communication vers le moniteur CFT (voir la commande CONFIG). Exemple :

suite au dépôt d’une commande SEND, le compte rendu “CFTU94I SEND PART = ... _Correct” indiqué par CFTUTIL, correspond à un dépôt bien effectué dans le média de communication de CFTUTIL.

1.3.2. Commandes de transfert 1.3.2.1. Définition Les commandes de transfert permettent de déclencher l’émission ou la réception de fichier ou l’émission de message, avec un partenaire (ou une liste de partenaires), en spécifiant selon le cas : • le nom du fichier ou le texte du message, • les caractéristiques du transfert (échéancier par exemple), • le partenaire. Toutes les demandes de transfert (commande SEND ou RECV) sont enregistrées dans le CATALOGUE des transferts CFT.

CFT 2.3

1-5

Les commandes

Un enregistrement du catalogue, appelé “poste catalogue”, est identifié par : • le sens du transfert

(S ou R),

• le type d’objet transféré (Fichier, Message ou Réponse), • le nom du partenaire

(PART),

• l’identifiant du transfert (IDT). Toutes les informations nécessaires au bon déroulement du transfert sont notées dans le catalogue.

1.3.2.2. Syntaxe Emission : l’activation d’un transfert en émission se fait par la commande SEND. Celle-ci permet d’émettre un : • FICHIER

: SENDTYPE = FILE . . . .

• MESSAGE

: SENDTYPE = MESSAGE . . . .

• MESSAGE DE REPONSE

: SENDTYPE = REPLY . . . .

Le paramètre TYPE prend “FILE” comme valeur par défaut. Réception : l’activation d’un transfert, en réception, se fait par la commande RECV. Celle-ci contrôle la réception d’un fichier ou d’un ensemble de fichiers (commande de réception globale). Paramètres : dans la syntaxe de la commande, deux catégories de paramètres sont distinguées : • les paramètres spécifiques à la commande : ces paramètres peuvent être obligatoires ou facultatifs, • les paramètres communs aux commandes de paramétrage de CFT (CFTSEND, CFTRECV) : ces paramètres sont facultatifs, leur description est détaillée dans le chapitre “Les commandes de paramétrage de l’environnement des transferts” de ce document. Les règles de préséance, quant à la valeur prise en compte lors de l’activation du transfert, dépendent en particulier du paramètre FORCE.

1.3.3. Commandes de contrôle des transferts Les commandes de contrôle des transferts permettent soit : • d’interrompre un transfert en cours, • d’activer ou de réactiver un transfert suspendu ou bloqué, • de supprimer une requête de transfert, • de soumettre (ou re-soumettre) une procédure de fin de transfert (transfert en état T), • de déclarer que le traitement consécutif à un transfert est terminé.

1-6

CFT 2.3

Manuel de référence

Les commandes associées à ces actions sont indiquées dans le tableau suivant. Tableau 7. Commande DELETE HALT KEEP START SUBMIT END

Commandes de contrôle des transferts Action Supprime un poste du catalogue Arrête un transfert et le met à l’état HOLD Arrête un transfert et le met à l’état KEEP Réactive un transfert Soumission d’une procédure de fin de transfert (transfert en état T) Déclare le traitement consécutif au transfert terminé

Les paramètres relatifs à ces commandes déterminent les critères de sélection des transferts (postes du catalogue) sur lesquels portent ces commandes. Les commandes modifient l’état des transferts concernés dans le catalogue CFT. Cet état peut être consulté par la commande LISTCAT, avant d’effectuer la commande de contrôle et après son exécution. La signification de ces états est indiquée dans le tableau suivant. Tableau 8. Etat D

C H

K T X

CFT 2.3

Signification des états de transfert

Signification Disponible Le transfert est prêt à être activé. Il le sera dès que CFT pourra lui attribuer des ressources Un transfert en cours peut repasser à l’état D suite : - à une interruption (réseau, par exemple) - ou sur une action de l’opérateur : SHUT FAST = YES En cours Le transfert est en cours d’exécution Hold Transfert arrêté sur anomalie (réseau, par exemple) ou interruption opérateur (HALT) Il sera rendu disponible (état D) par une action de l’opérateur (START) ou par une demande de réception (s’il s’agit d’un transfert en émission), issue du partenaire Keep Le transfert est suspendu soit par CFT, soit par une action de l’opérateur (KEEP) Seule une action de l’opérateur (START) peut rendre ce transfert disponible (état D) Terminé Les données ont été totalement transmises Exécuté Un applicatif ou l’opérateur a déclenché une commande END pour ce transfert, déclarant ainsi exécutés les traitements associés

1-7

Les commandes

Le tableau suivant énumère les actions pertinentes selon l’état d’un transfert et indique l’état résultant. Tableau 9.

Transition d’état

Evénements

Gérés par moniteur

Commandes

Etat

Activation Fin de Interruption transfert de transfert

START HALT

KEEP

D C

C

D

K K

T

D, H ou K (1)

H K T X

D D

H H

END

K H X

(1) : selon l’origine de l’interruption.

1.4. Les commandes d’administration de CFT Pour chacune de ces commandes, CFTUTIL assure : • le contrôle syntaxique de la commande, • le dépôt de cette commande dans le média de communication de CFTUTIL, permettant la communication vers le moniteur CFT (voir la commande CONFIG). Exemple :

suite au dépôt d’une commande SHUT, le compte rendu “CFTU94I SHUT _Correct” correspond à un dépôt bien effectué dans le média de communication de CFTUTIL. Tableau 10. Signification des mots-clés des commandes d’administration

1-8

Mot-clé

Signification

SHUT SWITCH ABOUT

Arrêt de CFT Basculement manuel des fichiers de suivi Caractéristiques de la machine sur laquelle CFT est installé

CFT 2.3

2. Les commandes propres à l’utilitaire CFTUTIL

2.1 Services

2.1.1. CONFIG - Redéfinition des médias de données de CFTUTIL La commande CONFIG permet de redéfinir les médias de données avec lesquels travaillera l’utilitaire CFTUTIL. Un média, au sens CFT, désigne tout support de données ou moyen de communication locale. Ces médias de données sont définis dans le guide “Concepts”. A l’activation, CFTUTIL utilise les médias de données (fichiers de base, journaux, communication avec le moniteur) définis par défaut, internes au produit CFT (consultez le “Guide d’exploitation” de CFT correspondant à votre OS). La commande CONFIG est donc nécessaire lorsque l’utilisateur souhaite lire ou écrire dans un autre média que ceux-ci. Dans ce cas, la commande CONFIG doit être utilisée avant de passer les autres commandes traitées par CFTUTIL. Les médias de données CFTUTIL, définis dans le guide “Concepts” de CFT, sont désignés dans cette commande par le paramètre TYPE. En relation avec ce paramètre, deux catégories de média sont à distinguer : • les médias devant s’interfacer avec les médias utilisés par le moniteur CFT. Les données associées à ces médias permettent, à partir de CFTUTIL, de : configurer et consulter les paramètres du moniteur CFT avec l’option TYPE =PARM, configurer et consulter les partenaires gérés par le moniteur CFT avec l’option TYPE = PART, consulter le catalogue utilisé par le moniteur CFT avec l’option TYPE = CAT, communiquer vers le moniteur CFT avec l’option TYPE = COM, ceci à travers les médias de communication gérés par le moniteur CFT, • les médias propres à CFTUTIL permettant de : -

transmettre les commandes à traiter (par CFTUTIL) avec l’option TYPE = INPUT,

-

retourner les comptes rendus d’exécution de ces commandes avec l’option TYPE = OUTPUT.

Pour TYPE = PARM, TYPE = PART et TYPE = CAT, les médias associés sont uniquement des fichiers. La commande CONFIG permet de modifier le nom de ces fichiers (paramètre FNAME). Pour TYPE = INPUT et TYPE = OUTPUT, la commande CONFIG permet de rediriger le flux d’entrée ou de sortie de CFTUTIL, vers un fichier dont le nom est spécifié par le paramètre FNAME. Si l’utilisateur modifie le nom du fichier d’entrée (TYPE = INPUT), les commandes de CFTUTIL ultérieures seront lues dans le nouveau média d’entrée mentionné.

CFT 2.3

2-1

Les commandes propres à l’utilitaire CFTUTIL

Pour TYPE = COM et selon les systèmes, les médias associés peuvent être : • un fichier, • une boîte aux lettres, et dans le cas d'un média de communication fondé sur TCP/IP : • un nom de host, • un nom de fichier de configuration (voir en annexe "Structure du fichier de configuration"). Si ce fichier n'existe pas ou n'a pas la syntaxe correcte, l'utilisateur n'en sera informé qu'au traitement de la première requête de transfert. L'utilisation de cette syntaxe permet la modification dynamique du média de communication, car le fichier est analysé à chaque nouvelle requête de transfert. La commande CONFIG permet de changer : • le média de communication avec le moniteur CFT (paramètre MEDIACOM), • le nom du fichier ou de la boîte aux lettres associés (paramètre FNAME). Les médias que l’on peut utiliser pour un système donné ainsi que le média de communication, par défaut associé à ce système, sont indiqués dans le guide “Concepts” de CFT, au paragraphe “Médias du moniteur”. Figure 1.

2-2

Médias concernés par les commandes de CFTUTIL

CFT 2.3

Manuel de référence

FICHIER_IN

FICHIER_OUT

CONFIG TYPE = INPUT

CONFIG TYPE = OUTPUT FICHIER Paramètres

Commandes

CONFIG TYPE = PARM Compte rendu

Configuration

FICHIER Partenaires

CFTUTIL Utilitaire CFT Consultations CONFIG TYPE = PART Transferts Modifications Gestion

FICHIER Catalogue

CONFIG TYPE = COM CONFIG TYPE = CAT

Médias de communication CFT Moniteur CFT

CFT 2.3

2-3

Les commandes propres à l’utilitaire CFTUTIL

2.1.1.1. Syntaxe CONFIG TYPE [FNAME

= {CAT| INPUT | OUTPUT | PARM | PART}, = filename]

TYPE [MEDIACOM [FNAME

= COM, = {FILE | MBX | TCP},] = {filename | string}]

CONFIG

2.1.1.2. Paramètres [FNAME

= filename]

Pour TYPE = {CAT| INPUT | OUTPUT | PARM | PART}

Définit le nom du fichier associé au type de média accédé par CFTUTIL. [FNAME

={filename | string}]

Pour TYPE = COM

Nom de fichier (filename), de la boîte aux lettres, du host ou du fichier de configuration (string). S'il s'agit d'un média de communication de type fichier ou mailbox, il doit y avoir correspondance avec la valeur du paramètre NAME de la commande CFTCOM qui définit le média de communication, vu du moniteur. S'il s'agit d'un média de communication synchrone s'appuyant sur TCP/IP (MEDIACOM=TCP), il s'agit : • soit du nom du host (string) sous la forme "protocole//machine:port", • soit du nom du fichier de configuration (filename), si le paramètre MEDIACOM est absent ou pour déclarer les options de sécurité. [MEDIACOM = {FILE | MBX | TCP}]

Pour TYPE = COM

Définit le type de média de communication si ce média est pertinent pour le système. Les valeurs possibles sont : • FILE pour les communications par fichier, • MBX pour les communications par boîte aux lettres (mailbox), • TCP pour les communications synchrones s'appuyant sur TCP/IP.

2-4

CFT 2.3

Manuel de référence

TYPE

= {PARM | PART | CAT | INPUT | OUTPUT | COM}

Définit le média concerné. Tableau 11. CFTUTIL TYPE - Médias concernés Valeur

Média concerné

CAT COM INPUT OUTPUT PARM PART

Fichier catalogue Média de communication Fichier d’entrée des commandes Fichier de sortie des comptes rendus Fichier paramètres Fichier partenaires

2.1.1.3. Exemples pour TYPE = OUTPUT CONFIG

TYPE FNAME

= =

OUTPUT,

Cette commande redirige la sortie de CFTUTIL (utilisé lors des consultations des commandes LISTPARM ou LISTPART, ...) vers le fichier de nom générique . CONFIG

TYPE = MEDIACOM = FNAME =

COM, FILE,

Cette commande permet de définir le fichier de nom générique comme média de communication avec le moniteur CFT.

2.1.2. WAIT - Suspension de CFTUTIL Cette commande suspend l’exécution de CFTUTIL pour la durée indiquée.

2.1.2.1. Syntaxe WAIT [DURING =

{0 | n}]

2.1.2.2. Paramètre [DURING

= {0 | n}]

{0..65535}

Durée en secondes de mise en sommeil de CFTUTIL.

CFT 2.3

2-5

Les commandes propres à l’utilitaire CFTUTIL

2.1.3. PURGE - Purge du catalogue Cette commande supprime les enregistrements ayant dépassé la période de rétention indiquée dans le paramétrage CFT. L’utilisateur fixe son heure de purge suivant ses besoins et l’activité de son moniteur CFT.

2.1.3.1. Syntaxe PURGE TIMEP

=

{23595999 | HHMMSSCC}

2.1.3.2. Paramètre TIMEP

= {23595999 | HHMMSSCC}

Heure de purge choisie par l’utilisateur. Attention : l’utilisateur peut choisir de désactiver la prochaine purge en renseignant : TIMEP = 00000000. Cette opération est cependant à utiliser avec précaution, du fait des risques d’engorgement du catalogue (risque de dégradation des performances, risque de débordement). Si la prochaine purge appartient à un cycle (voir le paramètre TIMEP de CFTCAT), c’est le cycle complet qui est supprimé et non pas la prochaine occurrence de ce cycle.

2.1.4. CLEARCMD - Suppression d'une requête de transfert La commande CLEARCMD est utilisée pour supprimer une requête dans le fichier de communication. Elle génère une commande WLOG qui signale l'événement dans le fichier LOG.

2.1.4.1. Syntaxe CLEARCMD COMMAND INDEX USERID

= name, = n, = string

2.1.4.2. Paramètres COMMAND

= name

Mot clé de la requête. INDEX

=n

Numéro de la requête tel qu'il est affiché par la commande LISTCOM.

2-6

CFT 2.3

Manuel de référence

USERID

= string15

Identifiant de l'utilisateur propriétaire de la requête.

2.1.4.3. Exemple Liste des enregistrements du fichier de communication CFTUTIL LISTCOM FILE HEADER ------------------------------------------------------------FILE = $CFTCOM DATE = 15/01/2003 TIME = 16:07:03 RECNB = 30 RECORDS ------------------------------------------------------------RECORD N 4 ACTIVE : YES COMMAND-TYPE : SHUT USERID : user1 GROUPID : JOBNAME : JOBCFT COMMANDE : fast=yes ------------------------------------------------------------RECORD N 5 ACTIVE : YES COMMAND-TYPE : SEND USERID : user1 GROUPID : JOBNAME : JOBCFT COMMANDE : PART=at1,IDF=aa,PRI=128,STATE=DISP ------------------------------------------------------------RECORD N 6 ACTIVE : YES COMMAND-TYPE : SEND USERID : user1 GROUPID : JOBNAME : JOBCFT COMMANDE : PART=at1,IDF=aa,PRI=128,STATE=DISP

Suppression d'un enregistrement CFTUTIL CLEARCMD COMMAND=SEND, USERID=USER1, INDEX=5 La requête correspondant à la commande SEND de numéro 5 et appartenant à USER1 va être supprimée du fichier de communication.

CFT 2.3

2-7

Les commandes propres à l’utilitaire CFTUTIL

Liste des enregistrements du fichier de communication CFTUTIL LISTCOM FILE HEADER ------------------------------------------------------------FILE = $CFTCOM DATE = 15/01/2003 TIME = 16:08:14 RECNB = 30 RECORDS ------------------------------------------------------------RECORD N 4 ACTIVE : YES COMMAND-TYPE : SHUT USERID : user1 GROUPID : JOBNAME : JOBCFT COMMANDE : fast=yes ------------------------------------------------------------RECORD N 6 ACTIVE : YES COMMAND-TYPE : SEND USERID : user1 GROUPID : JOBNAME : JOBCFT COMMANDE : PART=at1,IDF=aa,PRI=128,STATE=DISP ------------------------------------------------------------RECORD N 7 ACTIVE : YES COMMAND-TYPE : USERID : user1 GROUPID : JOBNAME : JOBCFT COMMANDE : Emission du message d'information dans le fichier LOG MSG='CLEARCMD Command=SEND, Userid=user1, Index=5 _ Successful'

2.1.5. KSTATE - Suspension d'un transfert La commande KSTATE est utilisée pour suspendre un transfert dans le catalogue. Le moniteur doit être arrêté avant de passer la commande puis relancé. Le transfert doit exister dans le catalogue et être dans un des états suivants : transfert en cours ("C"), transfert disponible ("D") ou transfert mis en attente ("H"). Après la commande, il passe à l'état "K". La commande génère une commande WLOG qui signale l'événement dans le fichier LOG.

2.1.5.1. Syntaxe KSTATE IDF IDTU PART

2-8

= = =

identifier, string, identifier

CFT 2.3

Manuel de référence

2.1.5.2. Paramètres IDF

= identifier Identifiant de fichier type.

IDTU

= string8

Identifiant compteur local de transfert. PART

= identifier

Identifiant du partenaire.

2.1.6. WLOG - Demande d'écriture dans le fichier LOG La commande WLOG est utilisée pour demander au moniteur d'écrire un message d'information (CFTR16I) dans le fichier LOG.

2.1.6.1. Syntaxe WLOG MSG

=

string

2.1.6.2. Paramètre MSG

= string255

Message d'information..

2.2 Consultation et ext raction

2.2.1. CFTEXT - Extraction des données des fichiers Paramètres et Partenaires Cette commande de CFTUTIL permet l’extraction de tout ou partie des données des fichiers Paramètre et Partenaire. Cette commande génère, en sortie, un texte des commandes de configuration permettant de reconstituer les données de ces fichiers. L’usage d’une telle commande s’intègre dans une séquence d’“extraction” par CFTEXT des données des fichiers Paramètres et Partenaires, puis “soumission” du fichier de configuration résultant à CFTUTIL pour : • reconstruire une configuration perdue ou endommagée, • faciliter l’export d’une configuration de moniteur sur une autre machine,

CFT 2.3

2-9

Les commandes propres à l’utilitaire CFTUTIL

• effectuer une montée de niveau du logiciel CFT lorsque celle-ci intègre une modification des structures des fichiers. Le texte des commandes de configuration généré est écrit sur le média de sortie de CFTUTIL. Rappelons que pour récupérer une sortie de CFTUTIL, on peut rediriger la sortie standard ou bien redéfinir le média de sortie via la commande CONFIG TYPE = OUTPUT. Toutes les valeurs des paramètres sont en MAJUSCULES.

2.2.1.1. Syntaxe CFTEXT [TYPE

=

[ID [FPARM [FPART

= = =

[FOUT

=

{ALL | ACCNT | AUTH | CAT | COM | ETB | IDF | LOG | NET | PARM | PART | PROT | RECV | SEND | XLATE | ASY | DNA | DSA | LU62 | SNA | TCP | X25},] {* | identifier | mask},] filename,] filename,] filename]

2.2.1.2. Paramètres [ID

= {* | identifier | mask}] Identifiant du paramètre à extraire. La valeur de cet identifiant est celle de l’ID de la commande CFTxxxx correspondant au paramètre TYPE ; ce qui permet de limiter l’extraction : • à une valeur indiquée explicitement (identifier), • ou à un groupe de valeurs désignées à partir d’un masque (mask) utilisant des caractères “joker”. Lorsque ce paramètre n’est pas renseigné, toutes les occurrences du type de paramètre (définies par TYPE) sont extraites.

[FOUT

= filename]

Nom du fichier sur lequel va être redirigée la sortie standard de la commande. Le fichier généré est alors directement interprétable par CFTUTIL. Lorsque ce paramètre n’est pas renseigné, toutes les occurrences du type de paramètre (définies par TYPE) sont extraites. [FPARM

= {voir le commentaire | filename}]

Sauf pour TYPE = PART

Nom du fichier Paramètres en entrée. Valeur par défaut : nom par défaut du fichier Paramètres défini pour CFTUTIL pour le système concerné (consultez le “Guide d’exploitation” de CFT correspondant à votre OS).

2-10

CFT 2.3

Manuel de référence

[FPART

= {voir le commentaire | filename}]

Pour TYPE = {ALL | PART}

Nom du fichier Partenaires en entrée. Valeur par défaut : nom par défaut du fichier Partenaires défini pour CFTUTIL pour le système concerné (consultez le “Guide d’exploitation” de CFT correspondant à votre OS). [TYPE

= {ALL | ACCNT | AUTH | CAT | COM | ETB | IDF | LOG | NET | PARM | PART | PROT | RECV | SEND | XLATE | ASY | DNA | DSA | LU62 | SNA | TCP | X25}]

Ce paramètre définit le type du paramètre que l’on désire extraire. TYPE peut prendre les valeurs prédéfinies indiquées dans le tableau suivant. Tableau 12. CFTEXT TYPE - Valeurs prédéfinies Valeur.

Signification

ALL

ETB IDF LOG NET PARM PART PROT RECV SEND XLATE ASY DNA DSA LU62 SNA TCP

Tous les types de paramètres des fichiers CFTPARM et CFTPART Description des fichiers de statistiques Liste des fichiers autorisés Définition du catalogue Description des méthodes de communication avec le moniteur CFT Définition des cartes paramètre ETEBAC Identifiant “réseau” de fichier Description des fichiers de journalisation Description réseau Paramètres généraux Définition des partenaires Définition des protocoles Description des fichiers à recevoir Description des fichiers à émettre Définition des tables de transcodage Définition du partenaire asynchrone Définition du partenaire DNA Définition du partenaire DSA Définition du partenaire LU6.2 Définition du partenaire SNA Définition du partenaire TCP/IP

CFTETB CFTIDF CFTLOG CFTNET CFTPARM CFTPART et CFT réseau CFTPROT CFTRECV CFTSEND CFTXLATE CFTASY CFTDNA CFTDSA CFTLU62 CFTSNA CFTTCP

X25

Définition du partenaire X25

CFTX25

ACCNT AUTH CAT COM

Fichier

CFTACCNT CFTAUTH CFTCAT CFTCOM

2.2.1.3. Exemples Exemple 1 : CFTEXT Extraction de l’ensemble des données des fichiers, paramètres CFTPARM et partenaires CFTPART.

CFT 2.3

2-11

Les commandes propres à l’utilitaire CFTUTIL

Exemple 2 : CFTEXT

TYPE ID FPARM

= = =

SEND, FACT, mycftparm

Extraction des données du fichier type à émettre (commande CFTSEND) d’IDF = FACT, du fichier “mycftparm”. Exemple 3 : CFTEXT

TYPE ID

= =

RECV, FACT*

Extraction des données des fichiers-types à recevoir (commande CFTRECV) dont la valeur de l’IDF commence par les 4 lettres “FACT”. Le nom du fichier Paramètres est celui par défaut indiqué, consultez le “Guide d’exploitation” de CFT correspondant à votre OS. Exemple 4 : CFTEXT

TYPE ID

= =

PART, MAGA*

Extraction des données “partenaires” correspondant aux commandes CFTPART dont l’identifiant commence par les 4 lettres “MAGA”. Le nom du fichier Partenaires est celui par défaut indiqué, consultez le “Guide d’exploitation” de CFT correspondant à votre OS.

2.2.2. LISTCAT - Liste des postes du catalogue Cette commande permet de consulter les informations associées aux transferts sélectionnés, enregistrés dans le catalogue de CFT. Suivant la valeur du paramètre CONTENT, les informations sont affichées sous la forme de : • listes où seules les caractéristiques les plus importantes des transferts apparaissent (CONTENT = BRIEF valeur par défaut), • pages où toutes les caractéristiques des transferts apparaissent (CONTENT = FULL). En l’absence d’une précédente commande CONFIG TYPE = OUTPUT, ces informations ou le compte rendu de l’exécution (erreur de syntaxe, pas d’informations associées, ...) sont écrits sur la sortie standard de la tâche. Cette commande permet de restituer : • d’une part les informations statiques des transferts associées aux paramètres des commandes SEND et RECV, • d’autre part les informations dynamiques des transferts, telles que : l’état du transfert, le nombre d’articles transférés, le taux de compression, ...

2-12

CFT 2.3

Manuel de référence

Les paramètres de la commande sont des critères de sélection. Pour la définition des états d’un transfert, consultez le chapitre “Contrôle des transferts” dans ce manuel.

2.2.2.1. Syntaxe LISTCAT

[TYPE

= [CONTENT = [DIRECT = [FILE = [IDA = [IDTU = [IDF = [IDT = [NPART = [PART = [STATE =

{ALL | FILE | MESSAGE | REPLY},] {BRIEF | FULL},] {BOTH | SEND | RECV},] filename,] {* | identifier},] string,] {* | identifier},] {* | transid},] {identifier | mask},] {* | identifier | mask},] {* | string}]

2.2.2.2. Paramètres [CONTENT

= {BRIEF | FULL}]

Permet d’obtenir une partie ou toutes les informations d’un poste du catalogue. Les valeurs possibles sont : • BRIEF : permet de visualiser les informations les plus importantes des transferts sélectionnés en affichant une ligne par transfert, • FULL : l’ensemble des informations de chaque transfert est affiché. [DIRECT

= {BOTH | SEND | RECV}]

Sens de transmission. Les valeurs possibles sont : • BOTH : pour prendre en compte les transferts en émission et en réception, • SEND : pour limiter la sélection aux transferts en émission, • RECV : pour limiter la sélection aux transferts en réception. [FILE

= {voir le commentaire | filename}]

Nom complet ou nom logique du fichier catalogue. La valeur par défaut de ce paramètre est fixe (consultez, sur ce point, le paragraphe “Médias de l’utilitaire” du guide “Concepts” de CFT). Pour désigner le catalogue courant du moniteur, il est nécessaire de renseigner ce paramètre avec le nom du fichier fourni au paramètre FNAME de la commande CFTCAT.

CFT 2.3

2-13

Les commandes propres à l’utilitaire CFTUTIL

[IDA

= {* | identifier}]

Identifiant local du transfert attribué par l’utilisateur ou l’application utilisatrice. Plusieurs postes catalogue peuvent être associés à un même IDA. [IDF

= {* | identifier}]

Identifiant de fichier type. Plusieurs postes catalogue peuvent être associés à un même IDF. [IDT

= {* | transid}]

Identifiant du transfert. Il identifie un transfert pour un partenaire et un sens de transfert donnés. [IDTU

= string8]

Identifiant compteur local de transfert. [NPART

= {identifier | mask}]

Dénomination “réseau” du (des) partenaire(s) des transferts sélectionnés. La valeur de ce paramètre peut être : • un identifiant : la sélection porte sur les transferts effectués avec cette dénomination réseau, • un masque : la sélection est générique et porte sur les transferts effectués avec la dénomination réseau dont le nom correspond à ce masque, • omise : la sélection s’opère suivant les critères indiqués dans le paramètre PART. Les informations visualisées pour LISTCAT CONTENT = FULL sont différentes, selon que le paramètre NPART est renseigné ou pas (voir les paragraphes suivants). [PART

= {* | identifier | mask}]

Identifiant du/des partenaire(s) des transferts sélectionnés. La valeur de ce paramètre peut être : • un identifiant : la sélection porte seulement sur les transferts avec ce partenaire, • un masque : la sélection concerne les transferts avec les partenaires dont l’identifiant correspond à ce masque, • omise : la sélection concerne tous les partenaires. Cette option est identique à l’option PART = *. Si le paramètre NPART est renseigné, le paramètre PART est ignoré.

2-14

CFT 2.3

Manuel de référence

[STATE

= {* | string6}]

Etats possibles d’un poste du catalogue. Les postes du catalogue ayant l’état indiqué par ce paramètre sont sélectionnés. Toute combinaison des différents états (D,C,H,K,T,X) est autorisée. [TYPE

= {ALL | FILE | MESSAGE | REPLY}]

Type de poste du catalogue. Permet de sélectionner les transferts présents dans le catalogue relatifs aux : • fichiers

: TYPE = FILE,

• messages

: TYPE = MESSAGE,

• messages de réponse

: TYPE = REPLY.

Si TYPE = ALL, aucune sélection n’est faite : tous les transferts présents dans le catalogue (fichiers, messages, messages de réponse) seront affichés s’ils remplissent les critères de sélection définis éventuellement par les autres paramètres.

2.2.2.3. Exemples Exemple 1 : LISTCAT

TYPE PART STATE

= = =

ALL, SIEGE, DC

Visualisation des informations les plus importantes (CONTENT=BRIEF par défaut) sur tous (TYPE=ALL) les transferts en émission et en réception (DIRECT=BOTH par défaut) du partenaire (PART=SIEGE), dont les états sont “Disponible” ou “en Cours” (STATE=DC). Exemple 2 : LISTCAT

TYPE PART DIRECT

= = =

FILE, PARIS5, SEND

Visualisation des informations les plus importantes (CONTENT=BRIEF par défaut) sur les transferts de fichier (TYPE=FILE) en émission (DIRECT=SEND) vers le partenaire (PART) PARIS5, tous états confondus (STATE=* par défaut).

CFT 2.3

2-15

Les commandes propres à l’utilitaire CFTUTIL

2.2.2.4. Informations visualisées Dans les exemples suivants, chaque champ visualisé est repéré par un chiffre qui renvoie au commentaire associé. L’affichage diffère selon les paramètres de sélection CONTENT et NPART. En fin d’affichage des caractéristiques des postes catalogues ainsi sélectionnés, il est indiqué : • le nombre de postes dont les caractéristiques sont affichées (n), • le nombre total des postes enregistrés dans le catalogue lors du traitement de la commande LISTCAT (p), • le nombre de postes du catalogue restant libre (q) ainsi que le pourcentage d’espace restant libre (r%). Ces informations sont affichées sous la forme : • n records selected, • p records in catalog file, • q records free (r%).

2.2.2.4.1. Pour LISTCAT CONTENT = BRIEF, NPART = {identifier | mask} Figure 2. LISTCAT CONTENT = BRIEF, NPART = {identifier | mask} 1

2

3

4

5

6

7

Date = DD-MM-YYYY, Time = hh:mm Partner (Network Name)

DTSA

File Id.

Transfer Id.

Diags

Parm CFT Prot.

______________

____

_______ _______

___ _______

_____________

xxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxx

xxxx xxxx xxxx xxxx

xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx

xxx xxx xxx xxx

xxxxxxxxxxxxxxx xxxxxxxxxxxxxxx xxxxxxxxxxxxxxx xxxxxxxxxxxxxxx

xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx

xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx

Le tableau de la page suivante contient les commentaires associés aux différentes rubriques contenues dans cette figure.

2-16

CFT 2.3

Manuel de référence

Tableau 13. LISTCAT CONTENT = BRIEF, NPART - Commentaires des rubriques Rubrique

Signification

1

Dénomination “réseau” du partenaire Le nom réseau du partenaire correspond au paramètre NRPART de la commande CFTPART. Il est affiché sur une longueur de 16 caractères seulement Etat du transfert Les caractères DTSA signifient : • Direction = S/R (Send/Receive) • Type = F/M/R (File/Message/Reply) • State = D/C/H/K/T/X (Disp/Current/Hold/Keep/Terminated/eXecuted) • Ack = A (Acknowledge) Identifiant de fichier (IDF) s’il s’agit d’une transmission de fichier ou identifiant du message (IDM) Identifiant de Transfert Identifiant du transfert attribué par le moniteur (IDT) Diagnostic interne CFT Pour un transfert avec anomalie, ce champ est renseigné avec le diagnostic interne CFT (DIAGI) relatif à cette anomalie Pour un transfert correctement achevé, ce champ est renseigné à zéro (1) Diagnostic protocolaire Si le poste concerné n’est pas un poste générique : • pour un transfert avec anomalie, ce champ est renseigné avec le diagnostic protocolaire (DIAGP) relatif à cette anomalie (2) • pour un transfert correctement achevé, ce champ indique le taux de compression obtenu documenté avec le format suivant : – CP NONE : transfert terminé correctement sans compression “on line” demandé – CP xx% : transfert terminé correctement avec un taux de compression de xx% • pour un transfert différé, ce champ est renseigné avec : – hh :mm :ss : si exécution le jour même – jj/mm/aa : si exécution les jours suivants Si le poste concerné est un poste générique, ce champ est renseigné avec l’une des valeurs suivantes : • RECV ALL : poste générique d’une demande de réception globale de tous les fichiers d’un IDF • RECV MSK : poste générique d’une demande de réception globale pour des IDF avec “jokers” • MIN CYC : poste générique de transferts cycliques, période exprimée en minutes • DAY CYC : poste générique de transferts cycliques, période exprimée en jours • MON CYC : poste générique de transferts cycliques, période exprimée en mois • DIFFUS : poste générique d’une diffusion • COLLECT : poste générique d’une collecte Champ PARM Il est affiché sur une longueur de 24 caractères et donc éventuellement tronqué

2

3 4 5

6

7

(1) (2) : consultez le guide “Codes, diagnostics et messages” de CFT.

CFT 2.3

2-17

Les commandes propres à l’utilitaire CFTUTIL

2.2.2.4.2. Pour LISTCAT CONTENT = BRIEF, PART = {identifier | mask} Le paramètre NPART n’est pas renseigné. Figure 3. LISTCAT CONTENT = BRIEF, PART = {identifier | mask} 1

2

3

4

Date = DD-MM-YYYY, File Ident

5

6

7

8

9

Time = hh:mm

Partner

DTSA

Transfer Ident

_______

____

________ ________ ________ ________ ___

xxxxxxx xxxxxxx xxxxxxx xxxxxxx

xxxx xxxx xxxx xxxx

xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx

xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx

Records Transmit Total

nnnnnnnn nnnnnnnn nnnnnnnn nnnnnnnn

nnnnnnnn nnnnnnnn nnnnnnnn nnnnnnnn

nnn nnn nnn nnn

Diag Diag Protocol

Applic. Ident

________ ________ xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx

xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx

Le tableau de la page suivante contient les commentaires associés aux différentes rubriques contenues dans cette figure.

2-18

CFT 2.3

Manuel de référence

Tableau 14. LISTCAT CONTENT = BRIEF, PART - Commentaires des rubriques Rubrique

Signification

1

Dénomination du partenaire décrit dans les commandes CFTPART (correspondant au paramètre ID) ou CFTDEST (un des PART de la liste de diffusion) Description de l’état du transfert Les caractères DTSA signifient : • Direction = S/R (Send/Receive) • Type = F/M/R (File/Message/Reply) • State = D/C/H/K/T/X (Disp/Current/Hold/Keep/Terminated/eXecuted) • Ack =A (Acknowledge) Identifiant du fichier (IDF) s’il s’agit d’une transmission de fichier ou identifiant du message (IDM). Identifiant du Transfert (IDT) S’il s’agit d’un transfert : • de fichier : nombre d’enregistrements à transmettre • de message : texte du message tronqué à 21 caractères S’il s’agit d’un transfert : • de fichier : nombre d’enregistrements transmis • de message : suite du texte du message tronqué à 21 caractères Diagnostic interne CFT Pour un transfert avec anomalie, ce champ est renseigné avec le diagnostic interne CFT (DIAGI) relatif à cette anomalie Pour un transfert correctement achevé, ce champ est renseigné à zéro (1) Diagnostic Protocolaire Si le poste concerné n’est pas un poste générique : • pour un transfert avec anomalie, ce champ est renseigné avec le diagnostic protocolaire (DIAGP) relatif à cette anomalie (2) • pour un transfert correctement achevé, ce champ indique le taux de compression obtenu documenté avec le format suivant : – CP NONE : transfert terminé correctement sans compression “on line” demandée – CP xx% : transfert terminé correctement avec un taux de compression de xx% • pour un transfert différé, ce champ est renseigné avec : – hh :mm :ss : si exécution le jour même – jj/mm/aa : si exécution les jours suivants Si le poste concerné est un poste générique, ce champ est renseigné avec l’une des valeurs suivantes : • RECV ALL : poste générique d’une demande de réception globale de tous les fichiers d’un IDF • RECV MSK : poste générique d’une demande de réception globale pour des IDF avec “jokers” • MIN CYC : poste générique de transferts cycliques, période exprimée en minutes • DAY CYC : poste générique de transferts cycliques, période exprimée en jours • MON CYC : poste générique de transferts cycliques, période exprimée en mois • DIFFUS : poste générique d’une diffusion • COLLECT : poste générique d’une collecte Identifiant de l'application (IDA) associée à ce transfert

2

3 4 5

6

7

8

9

(1) (2) : consultez le guide “Codes, diagnostics et messages” de CFT.

CFT 2.3

2-19

Les commandes propres à l’utilitaire CFTUTIL

2.2.2.4.3. Pour LISTCAT CONTENT = FULL

Figure 4. LISTCAT CONTENT = FULL Transfer informations --------------------1 Transfer id. 2 Local transfer id. 3 4 5

Direct Type Priority

6 7 8 9

State Local Protocol Complementary x-64-x x-64-x x-64-x x-63-x

10 11 12 13 14 15 16 17 18 19 20 21 22 23

24 25 26 27 28

DIRECT TYPE PRI

= = =

STATE DIAGI DIAGP DIAGC

= = = =

Item type For partner list : id. In progress Remote transfer id. Remote transfer state

DIFTYP DEST LNUM IDTD STATED

= = = = =

Network file id. File data base x-64-x File name x-64-x Temporary file name x-64-x Local Select list x-64-x Remote file name x-64-x File version Application id. Private parameter x-40-x x-40-x

NIDF FDBNAME

= =

FNAME

=

WFNAME

=

SELFNAME

=

NFNAME

=

NFVER IDA PARM

= = =

PART SPART RPART IPART NPART

= = = = =

diagnosis diagnosis diagnosis diagnosis

Partner Sender Receiver Intermediate partner Connection partner

Partner call time ----------------29 31 After TIMMC 30 32 Before TIMMAXC

2-20

IDT IDTU

= =

Date Time

= xxxxxxxx = xxxxxxxx

Command deposure" ----------------" DATED = TIMED =

CFT 2.3

Manuel de référence

33 34 37 38 41 42

35 36 39 40

Transfer validity ----------------After MINDATE MINTIME Before MAXDATE MAXTIME

= = = =

Next retry date Next retry hour

Activation time" ---------------" CYCDATE = CYCTIME = CYCLE = TCYCLE =

Before Time Each Unit

NEXTDAT = NEXTTIM =

Transfer -------43 45 Begin date 44 46 Begin time

DATEB TIMEB

Connection retry ---------------47 52 Current RETRY 48 Max number RETRYN 49 53 Max number RETRYM 50 54 Time between RETRYW 51 Last dial nb DIALNUM Transmitted ----------55 57 Records 56 Bytes

= =

= = = = =

End date End time

DATEE = TIMEE =

Protocol" --------" Id. PROT = Restart :" Allowed (YES/NO) = Current =

To transmit ----------Records NREC

NRECS NCARS

= =

58 59

Read or Written --------------Records FRECS Bytes FCARS

= =

60 61

Synchronization --------------Nb of checkpoints Nb of resynchro.

NCHKPT NRST

= =

62 63 64 65 66

User id. Group id. Origin owner transfer Translation table Exit id.

USERID GROUPID ORIGIN XLATE EXIT

= = = = =

67

Exita id.

EXITA

=

68

Exite id.

EXITE

=

69

Job name

JOBNAME

=

70 71 72

Sender user Receiver user Sender application x-48-x Receiver application x-48-x Comments

SUSER RUSER SAPPL

= = =

RAPPL

=

73 74

CFT 2.3

MSG

=

=

2-21

Les commandes propres à l’utilitaire CFTUTIL

Le tableau suivant contient les commentaires associés aux différentes rubriques du LISTCAT [CONTENT = FULL]. Tableau 15. LISTCAT CONTENT = FULL - Commentaires des rubriques Rubrique

Signification

1 2 3 4 5 6

Identifiant du transfert (IDT) IDTU : compteur local de transfert Sens du transfert : SEND/RECV Type de la requête : FILE/MESSAGE/REPLY Priorité de sélection de la demande du transfert Définit l’état de la requête du transfert (voir le tableau en introduction de LISTCAT). (DISPonible/CURRent/HOLD/KEEP/TERMinated/EXECuted) Diagnostic interne CFT (DIAGI) résultant du transfert (numérique) (1) Diagnostic au sens protocole applicatif (DIAGP) (2) Diagnostic complémentaire (DIAGC) Type du poste CATALOGUE : • SINGLE : il s’agit d’une demande de transfert simple • LIST : poste générique des transferts d’une liste de diffusion ou de collecte • PART : transfert élémentaire appartenant à une liste de diffusion ou de collecte • CYCLE : poste générique d’un transfert périodique Identifiant de la liste de diffusion/collecte (commande CFTDEST) Nombre d’éléments activés ou non de la liste de diffusion/collecte Si le partenaire acquitte le transfert : Identifiant du transfert de l’acquittement Si le partenaire a acquitté le transfert : “ACK” Nom “réseau” du fichier transféré S’il s’agit d’une transmission : • de fichier : identifiant du fichier (IDF) • de message : identifiant du message (IDM) Nom du fichier VFM transféré (FDBNAME) Nom local du fichier transféré (FNAME) Nom du fichier temporaire utilisé pour le transfert (WFNAME) Nom du fichier de sélection dans le cas de la manipulation de groupe de fichiers (SELFNAME) Identifiant réseau du fichier (NFNAME) Version du fichier transféré (NFVER) Identifiant de l’application (IDA) associée à ce transfert Paramètre privé documenté par l’utilisateur (PARM) Dénomination du partenaire correspondant immédiat pour le transfert (PART) Cet identifiant est identique soit : • au paramètre ID de la commande CFTPART • à un identifiant du paramètre PART de la commande CFTDEST Identifiant du partenaire émetteur (SPART) Identifiant du partenaire récepteur (RPART) Identifiant du partenaire intermédiaire (paramètre IPART de CFTPART) Partenaire de connexion (NPART)

7 8 9 10

11 12 13 14 15

16 17 18 19 20 21 22 23 24

25 26 27 28

2-22

CFT 2.3

Manuel de référence

Tableau 15. LISTCAT CONTENT = FULL - Commentaires des rubriques (suite) Rubrique

Signification

29 30

Fourchette horaire d’appel du partenaire Les informations affichées représentent l’intersection des 2 intervalles : • fourchette d’appel du partenaire définie par la commande CFTPART • fourchette d’appel par la méthode d’accès choisie (CFTX25, ...) Cette fourchette n’est donc renseignée qu’au moment de l’activation du transfert. Date de dépôt de la commande Heure de dépôt de la commande Premier jour de validité des transferts Il s’agit du premier jour à partir de la date de dépôt de la commande, calculé à partir du paramètre MINDATE de la commande SEND Heure minimum de validité du transfert, pour le premier jour (MINDATE de la commande SEND) Jour limite supérieure d’activation du premier transfert d’un échéancier, à partir de la date du jour, calculé avec le paramètre CYCDATE de la commande SEND Heure limite supérieure d’activation du premier transfert d’un échéancier (paramètre CYCTIME de la commande SEND) Dernier jour de validité des transferts (MAXDATE de la commande SEND) Heure maximum de validité du transfert, pour le dernier jour (MAXTIME de la commande SEND) Nombre d’unités définissant la période d’un cycle de transfert Unité de la période du cycle de transfert : • MIN Minutes • DAY Jour • MONTH Mois Date de la prochaine tentative de transfert (NEXTDAT) Heure de la prochaine tentative de transfert (NEXTTIM) Date de début du transfert (DATEB) Heure de début du transfert (TIMEB) Si le transfert est relancé suite à des interruptions, les zones 43 et 44 indiquent la date et l’heure de la dernière relance Si le transfert concerne une liste de diffusion ou de collecte, les zones 43 et 44 ne sont pas renseignées Date de fin du transfert (DATEE) Heure de fin du transfert (TIMEE) Si le transfert concerne une liste de diffusion ou de collecte, les zones 45 et 46 correspondent aux date et heure de fin du dernier transfert de la liste Nombre de tentatives de connexion espacées du temps RETRYW restant à effectuer Cette valeur est décrémentée de la valeur de RETRY jusqu’à ce qu’elle soit égale à zéro En fin de transfert, cette zone est remise à zéro Nombre total de tentatives de connexion espacées du temps RETRYW Cette valeur est décrémentée de la valeur de RETRY jusqu’à ce qu’elle soit égale à zéro En fin de transfert, cette zone est remise à zéro Nombre total de tentatives de connexion restant à faire Cette valeur évolue de RETRYM (commande CFTX25, ...) à 0 En fin de transfert, cette zone est remise à zéro Espacement des tentatives de connexion (en minutes) Cette valeur évolue de RETRYW (commande CFTX25, ...) à NNN En fin de transfert, cette zone est remise à zéro

31 32 33

34 35 36 37 38 39 40

41 42 43 44

45 46

47

48

49

50

CFT 2.3

2-23

Les commandes propres à l’utilitaire CFTUTIL

Tableau 15. LISTCAT CONTENT = FULL - Commentaires des rubriques (suite) Rubrique

Signification

51

Dans la liste définie par le paramètre DIALNO de la commande CFTX25 (...), numéro d’ordre du numéro d’appel du partenaire utilisé Cette valeur évolue de 0 au nombre maximum de numéros d’appel, moins 1 En fin de transfert, cette zone est remise à zéro Identifiant du protocole applicatif utilisé avec le partenaire (paramètre ID de la commande CFTPROT) Indique si la relance est autorisée ou non pour ce transfert (ALLOWED) Nombre de relances protocolaires effectuées pour ce transfert (CURRENT) 0 signifie pas de relance. S’il s’agit d’une transmission de fichier : nombre d’enregistrements transmis (NRECS) S’il s’agit d’une transmission de fichier : nombre de caractères transmis (NCARS) S’il s’agit d’une transmission de fichier : nombre total d’enregistrements à transmettre (NREC) S’il s’agit d’une transmission de fichier : nombre d’enregistrements lus ou écrits (FRECS) S’il s’agit d’une transmission de fichier : nombre de caractères lus ou écrits (FCARS) Numéro du dernier point de synchronisation posé (NCHKPT) Nombre de resynchronisations effectuées (NRST) Identifiant de l’utilisateur demandeur, au sens du système d’exploitation (ce champ désigne aussi le propriétaire du transfert) (USERID) Identifiant du groupe auquel appartient l’utilisateur demandeur, au sens système d’exploitation (GROUPID) Origine du propriétaire du transfert (ORIGIN) Identifiant de la commande CFTXLATE si utilisée (table de transcodage utilisée lors d’un transfert) Identifiant de la commande CFTEXIT si utilisée (il s’agit de l’EXIT fichier) (EXIT) Identifiant de la commande CFTEXIT si utilisée (il s’agit de l’EXIT annuaire) (EXITA) Identifiant de la commande CFTEXIT si utilisée (il s’agit de l’EXIT ETEBAC3) (EXITE) Nom de la tâche au sens système d’exploitation (JOBNAME) Identifiant de l’utilisateur émetteur du fichier (SUSER) Identifiant de l’utilisateur récepteur du fichier (RUSER) Identifiant de l’application émettrice du fichier (SAPPL) Identifiant de l’application réceptrice du fichier (RAPPL) S’il s’agit d’une transmission : • de fichier : zone de commentaires • de message : texte du message – en PeSIT CFT : 80 caractères – en PeSIT E : 512 caractères (affichés sur 8 lignes de 66 caractères)

52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74

(1) (2) : consultez le guide “Codes, diagnostics et messages” de CFT.

2-24

CFT 2.3

Manuel de référence

2.2.3. LISTPARM - Liste des paramètres de CFT Consultation des paramètres de CFT, tels qu’ils ont été soumis par les commandes de type CFT****. 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 de l’exécution est écrit sur la sortie standard du programme CFTUTIL.

2.2.3.1. Syntaxe LISTPARM TYPE

=

[ID [PART

= =

{ACCNT | ALL | AUTH | CAT | COM | ETB | IDF | LOG | NET | PARM | PROT | RECV | SEND | XLATE}, {* | identifier},] identifier]

2.2.3.2. Paramètres [ID

= {* | identifier}] Identifiant de la commande CFT sélectionnée à partir du paramètre TYPE. Permet de limiter la consultation à cet identifiant.

[PART

= identifier]

Pour TYPE = IDF

Identifiant du partenaire. Permet de limiter la recherche aux IDF définis dans les commandes CFTIDF, relatives à ce partenaire. TYPE

= {ACCNT | ALL | AUTH | CAT | COM | ETB | IDF | LOG | NET | PARM | PROT | RECV | SEND | XLATE}

Définit le type de commande à sélectionner. TYPE peut prendre les valeurs prédéfinies indiquées dans le tableau suivant. Tableau 16. LISTPARM Type - Valeurs prédéfinies Valeur

Signification

ACCNT

Permet la consultation des paramètres relatifs aux fichiers de statistiques Ces paramètres sont soumis lors des commandes CFTACCNT Permet la consultation de tous les paramètres indiqués dans le fichier “PARAMETRES” Permet la consultation des listes d’autorisation relatives aux fichiers Ces listes sont paramétrées par les commandes CFTAUTH Permet la consultation des paramètres relatifs aux catalogues Ces paramètres sont soumis lors des commandes CFTCAT

ALL AUTH CAT

CFT 2.3

2-25

Les commandes propres à l’utilitaire CFTUTIL

Tableau 16. LISTPARM Type - Valeurs prédéfinies (suite) Valeur

Signification

COM

Permet la consultation des paramètres relatifs aux médias de communication Ces paramètres sont soumis lors des commandes CFTCOM Permet la consultation des paramètres relatifs aux cartes ETEBAC 3 Ces paramètres sont soumis lors des commandes CFTETB Permet la consultation des identifiants “réseau” de fichiers Les identifiants sont paramétrés par les commandes CFTIDF Permet la consultation des paramètres relatifs aux fichiers de journalisation Ces paramètres sont soumis lors des commandes CFTLOG Permet la consultation des paramètres des caractéristiques réseaux Ces paramètres sont soumis lors des commandes CFTNET et sont différents suivant le type de réseau configuré Permet la consultation des paramètres généraux Ces paramètres sont soumis lors des commandes CFTPARM Permet la consultation des paramètres relatifs aux protocoles Ces paramètres sont soumis lors des commandes CFTPROT et sont différents suivant le protocole configuré Permet la consultation des paramètres relatifs aux fichiers à recevoir Ces paramètres sont soumis lors des commandes CFTRECV Permet la consultation des paramètres relatifs aux fichiers à émettre Ces paramètres sont soumis lors des commandes CFTSEND Permet la consultation des tables de transcodage Les tables de transcodage sont paramétrées par les commandes CFTXLATE

ETB IDF LOG NET

PARM PROT

RECV SEND XLATE

2.2.3.3. Exemples Exemple 1 : LISTPARM TYPE = ALL Visualisation de tous les paramètres contenus dans le fichier “PARAMETRES”. Exemple 2 : LISTPARM

TYPE = SEND

Visualisation des paramètres de toutes les commandes CFTSEND configurées.

2.2.4. LISTPART - Liste des partenaires Permet de visualiser les caractéristiques des partenaires (caractères généraux ou réseau), selon les critères de sélection cités dans la commande. En l’absence d’une précédente commande CONFIG TYPE = OUTPUT, le compte rendu de l’exécution est écrit sur la sortie standard du programme CFTUTIL.

2-26

CFT 2.3

Manuel de référence

2.2.4.1. Syntaxe LISTPART TYPE [ID [STATE

= = =

{ALL | DEST | DNA | DSA | PART | SNA | TCP | X25 | LU62 | ASY} {* | identifier}] {ACTIVEBOTH | ACTIVEREQ | ACTIVESERV | NOACTIVE]

2.2.4.2. Paramètres [ID

= {* | identifier}] Identifiant du partenaire ou de la liste de partenaires. Permet de sélectionner un seul partenaire ou un ensemble de partenaires, en utilisant le caractère spécial “*” (joker). Exemple : ID = PART1 ID = IB* ID = *

[STATE

: pour le partenaire PART1 seulement, : pour tous les partenaires dont l’identifiant commence par “IB”, : pour tous les partenaires.

= {ACTIVEBOTH | ACTIVEREQ | ACTIVESERV | NOACTIVE}]

Etat du partenaire. Ce paramètre n’est utilisé que lorsque le paramètre TYPE=PART. • ACTIVEBOTH: partenaire actif dans tous les modes, • ACTIVEREQ : partenaire actif en mode demandeur seulement, • ACTIVESERV : partenaire actif en mode serveur seulement, • NOACTIVE TYPE

: partenaire totalement inactif.

= {ALL | ASY | DEST | DNA | DSA | LU62 | PART | SNA | TCP | X25}

Définit le type de caractéristiques à lister. TYPE peut prendre les valeurs prédéfinies indiquées dans le tableau suivant. Tableau 17. LISTPART TYPE - Valeurs prédéfinies Valeur

Signification

ALL

Permet la consultation des caractéristiques (générales et réseaux) des partenaires Paramètres du fichier “PARTENAIRES” Permet la consultation des paramètres configurés dans la commande CFTASY : paramètres réseau ASY associés à chaque partenaire Permet la consultation des paramètres configurés dans la commande CFTDEST : concernent les listes de diffusion

ASY (1) DEST

(1) : selon les types de réseaux supportés par chaque OS.

CFT 2.3

2-27

Les commandes propres à l’utilitaire CFTUTIL

Tableau 17. LISTPART TYPE - Valeurs prédéfinies (suite) Valeur

Signification

DNA (1)

Permet la consultation des paramètres configurés dans la commande CFTDNA : paramètres réseau DECNET associés à chaque partenaire supportant DECNET, Permet la consultation des paramètres configurés dans la commande CFTDSA : paramètres réseau DSA associés à chaque partenaire supportant DSA Permet la consultation des paramètres configurés dans la commande CFTLU62 : paramètres réseau LU6.2 associés à chaque partenaire Permet la consultation des paramètres configurés dans la commande CFTPART : description des données générales relatives aux partenaires Permet la consultation des paramètres configurés dans la commande CFTSNA : paramètres réseau SNA associés à chaque partenaire supportant SNA Permet la consultation des paramètres configurés dans la commande CFTTCP : paramètres réseau TCP/IP associés à chaque partenaire supportant TCP/IP Pour CFTX25 (informations réseau X25), permet la consultation des paramètres configurés dans la commande CFTX25 : paramètres réseau X25 associés à chaque partenaire supportant X25

DSA (1) LU62 (1) PART SNA (1) TCP (1) X25

(1) : selon les types de réseaux supportés par chaque OS.

2.2.4.3. Exemples Exemple 1 : LISTPART TYPE = ALL Permet de visualiser tout le contenu des enregistrements du fichier PARTENAIRES. Exemple 2 : LISTPART TYPE = DEST Permet de visualiser les listes de diffusion.

2.3 Manipulation de fic hiers

2.3.1. CFTFILE - Création ou suppression des fichiers CFT La commande CFTFILE permet de créer (vides) les fichiers du moniteur CFT (MODE = CREATE) ou de les supprimer (MODE = DELETE). Les fichiers concernés sont les suivants : • le fichier PARAMETRES contenant les paramètres généraux du moniteur CFT (TYPE = PARM), • le fichier PARTENAIRES contenant les descriptions des caractéristiques des partenaires (TYPE = PART), • le fichier CATALOGUE contenant les informations de contrôle associées aux transferts (TYPE = CAT),

2-28

CFT 2.3

Manuel de référence

• les fichiers STATISTIQUES contenant des informations relatives aux transferts terminés (TYPE = ACCNT), • les fichiers JOURNAUX permettant l’enregistrement des messages associés au déroulement des transferts et au fonctionnement du moniteur en général (TYPE = LOG), • les fichiers de COMMUNICATION permettant de déposer les requêtes de transferts et les commandes de gestion du moniteur CFT (TYPE = COM), Tous les fichiers manipulés par le moniteur CFT doivent être créés par cette commande. Précisons que pour supprimer un fichier CFT (MODE = DELETE), seuls les paramètres FNAME (indiquant le nom du fichier à supprimer) et TYPE (indiquant la nature du fichier à supprimer) sont à documenter. OS400

La commande CFTFILE est intégrée à CFT/400 Manager. On pourra cependant l’activer directement, par exemple dans les procédures de basculement des fichiers de suivi (voir l’exemple fourni : membre B_EXECLOG).

VM

Les fichiers VSAM du moniteur CFT sont créés/supprimés manuellement par la commande CMS AMSERV. Ils doivent être ensuite initialisés par la commande CFTFILE TYPE = {COM | CAT ...}.

Remarque : il est possible de redimensionner le catalogue avec l’utilitaire CFTCATAL (consultez l’annexe “CFTCATAL”).

2.3.1.1. Syntaxe CFTFILE [MODE FNAME

= =

{CREATE | DELETE},] filename,

[ELSNAME= identifier] TYPE [CIPHER [MAC

OS

= = =

{ACCNT | CAT | COM | LOG | PARM | PART}, {NO | YES},] {NO | YES},]

=

n,]

OS

[FBLKSIZE =

n,]

OS

[FSPACEX =

n,]

OS

[FSPACE

=

n,]

OS

LOCK

=

filename

SUIVANT TYPE

[RECNB

CFT 2.3

2-29

Les commandes propres à l’utilitaire CFTUTIL

2.3.1.2. Paramètres [CIPHER

= {NO | YES}]

Demande de chiffrement du fichier. Ce paramètre concerne le fichier paramètre, le fichier partenaire et le fichier de communication (TYPE = PARM, PART ou COM). [FBLKSIZE

= {voir le tableau | n }]

{0..32768}

OS

Suivant TYPE

Définit la taille des blocs du fichier à créer (en octets). Le tableau suivant indique, pour chaque système, la valeur par défaut supportée suivant le type de fichier à créer. Tableau 18. CFTFILE FBLKSIZE - Valeurs par défaut et OS concernés OS

PARM

PART

CAT

COM

LOG

ACCNT

GCOS7 GCOS8 GUARDIAN MVS Netware OS2 OS400 UNIX VM VMS VOS VSE Win95 WinNT

no 2048 no no no no 0 no no no no no no no

no 1536 no no no no 0 no no no no no no no

3328 2048 no no no no 0 no no no no no no no

2052 2048 no no no no 0 no no no no no no no

no 256 no 132 no no 0 no 132 no no 132 no no

no 768 no 480 no no 0 no 480 no no 480 no no

Explications sur le contenu du tableau : dans ce tableau, lorsque la valeur par défaut de la taille des blocs du fichier à créer est égale à “no”, le paramètre FBLKSIZE n’a pas à être renseigné. FNAME

= filename

Nom du fichier sur lequel s’applique la commande. OS400

Le nom du fichier doit être défini explicitement et jamais à partir d’un nom logique.

[FSPACE = {voir le tableau | n }]

{0..65536}

Suivant TYPE

OS

Allocation primaire du fichier à créer, exprimée en nombre de K octets (1024).

2-30

CFT 2.3

Manuel de référence

Tableau 19. CFTFILE FSPACE - Valeurs par défaut et OS concernés OS

PARM

PART

CAT

COM

LOG

ACCNT

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

512 200 100 50 512 no 50 no 0 50 no

700 200 100 100 512 no 100 no 0 100 no

no no no no no no no no no no no

no no no no no no no no no no no

no 100 2 200 512 no 200 no 0 200 no

no 100 2 200 512 no 200 no 0 200 no

Explications sur le contenu du tableau : dans ce tableau, lorsque la valeur par défaut de l’allocation primaire du fichier à créer est égale à “no”, le paramètre FSPACE n’a pas à être renseigné. Pour TYPE = COM et TYPE = CAT, ce paramètre n’est pas à renseigner, ceci pour tous les systèmes. En effet, l’allocation primaire du fichier à créer est déduite de la valeur du paramètre RECNB (nombre d’enregistrements du fichier). [FSPACEX = {voir le tableau | n }]

OS

{0..65536} Suivant TYPE

Allocation secondaire du fichier à créer, exprimée en nombre de K octets (1024). Le tableau suivant indique, pour chaque système, la valeur par défaut supportée suivant le type de fichier à créer. Tableau 20. CFTFILE FSPACEX - Valeurs par défaut et OS concernés OS

PARM

PART

CAT

COM

LOG

ACCNT

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

no no 100 50 0 no 50 0 0 50 no

no no 100 100 0 no 100 0 0 100 no

no no no 0 0 no 0 0 0 0 no

no no no 0 0 no 0 0 no 0 no

no UNLIMITED 2 50 0 no 50 no 0 50 no

no 5000 2 50 0 no 50 no 0 50 no

Explications sur le contenu du tableau : dans ce tableau, lorsque la valeur par défaut de l’allocation secondaire du fichier à créer est égale à “no”, le paramètre FSPACEX n’a pas à être renseigné. LOCK

= filename

Pour TYPE = COM

GCOS8

Nom du fichier de verrou créé parallèlement au fichier de communication, permettant de gérer la concurrence d’accès à ce fichier.

CFT 2.3

2-31

Les commandes propres à l’utilitaire CFTUTIL

[MAC

= {NO | YES}]

Demande de scellement du fichier. Ce paramètre concerne le fichier paramètre et le fichier partenaire (TYPE = PARM ou PART). [MODE

= {CREATE | DELETE}]

Action demandée sur le fichier : • CREATE : création du fichier. • DELETE : destruction du fichier.

[RECNB

= n]

Pour TYPE = {COM | CAT}

Nombre d’enregistrements du fichier. La valeur par défaut est “customisable” pour chaque système d’exploitation. Si TYPE = COM, ce paramètre est obligatoire. Si TYPE = CAT, ce paramètre est optionnel. Cette valeur doit correspondre au nombre maximal de “postes” de transfert présents simultanément dans le catalogue. La valeur par défaut est 200. La taille du fichier n’étant pas extensible, l’exploitant doit adapter les valeurs des paramètres RH, SH, RD, SD, ... de la commande CFTCAT, afin d’éviter une surcharge du fichier, qui se traduirait par le refus de prise en compte de nouvelles requêtes de transfert. TYPE

= {ACCNT | CAT | COM | LOG | PARM | PART}

Type du fichier concerné par la commande. Tableau 21. CFTFILE TYPE - Types de fichiers concernés Valeur

Type de fichier à créer

ACCNT CAT COM LOG PARM PART

Fichier statistique des transferts Fichier catalogue Fichier de communication Fichier journal Fichier paramètres Fichier partenaires

2.3.1.3. Exemple de paramétrage CFTFILE CFTFILE

TYPE MODE FNAME

= = =

PARM, CREATE, filename

Création d’un fichier Paramètres.

2-32

CFT 2.3

Manuel de référence

2.3.2. COPYFILE - Copie de fichiers “off line” La commande COPYFILE permet de copier un fichier séquentiel en effectuant les opérations de : • compression/décompression ; dans ce cas un fichier compressé doit toujours avoir un format variable, • transcodage ASCII/EBCDIC et inversement ; ce transcodage est effectué avec les tables “internes” de CFT, telles qu’elles sont documentées en annexe de ce document, • modification de format d’enregistrement ou de type de fichier. La commande COPYFILE permettra ainsi de compresser un fichier “off line”, avant l’émission par CFT et de décompresser un fichier après réception.

2.3.2.1. Syntaxe COPYFILE [CREATE [ICT [ICOMP

= {‘ ’ | YES | NO},] = {H | C},] = {0 | cpr},]

[ICODE

= {ASCII | EBCDIC},]

IFNAME

= filename,

[ITYPE

= c,]

[IBLKSIZE [ILRECL

= n,] = n,]

[IRECFM

= {F | V | U},]

[OCT [OCOMP

= {H | C},] = {0 | cpr},]

[OCODE

= {ASCII | EBCDIC},]

OFNAME

= filename,

[OSPACE

= {0 | n},]

[OTYPE [OBLKSIZE [OLRECL

= c,] = {valeur de IBLKSIZE | n},] = {voir le commentaire | n},]

[ORECFM

= { valeur de IRECFM | F | V | U },]

Dft : OS

OS

OS

Dft : OS

OS

OS

Les paramètres commençant par I concernent les fichiers en entrée. Les paramètres commençant par O concernent les fichiers en sortie. Ces paramètres peuvent être classés en 5 catégories, présentées dans le tableau suivant.

CFT 2.3

2-33

Les commandes propres à l’utilitaire CFTUTIL

Tableau 22. COPYFILE - Paramètres Catégorie de paramètre

Paramètre concerné

Paramètres de contrôle d’exécution Paramètres de traitement des données en entrée Paramètres associés au fichier en entrée : • nom physique, • caractéristiques physiques (fichier global), • caractéristiques physiques (enregistrements) Paramètres de traitement des données en sortie Paramètres associés au fichier en sortie : • nom physique, • caractéristiques physiques (fichier global), • caractéristiques physiques (enregistrements)

CREATE ICT, ICOMP, ICODE IFNAME ITYPE IRECFM, ILRECL, IBLKSIZE OCT, OCOMP, OCODE OFNAME OSPACE, OTYPE ORECFM, OLRECL, OBLKSIZE

2.3.2.2. Paramètres [CREATE

= {‘ ’ | YES | NO}]

Option de création du fichier en sortie : • ‘ ’ pour créer le fichier si celui-ci n’existe pas ou substituer les données du fichier, si celui-ci existe déjà, • YES pour créer le fichier ; si celui-ci existe déjà, il y a arrêt de l’exécution (Abort), • NO pour travailler sur un fichier existant ; les données reçues sont substituées aux données existantes. S’il n’existe pas, il y a arrêt de l’exécution (Abort). [IBLKSIZE

= {taille effective des blocs du fichier en entrée | n}]

{0..32768}

Définit la taille des blocs du fichier d’entrée, en octets. La valeur doit être supérieure à celle du paramètre ILRECL. Tableau 23. COPYFILE IBLKSIZE - OS concernés OS

IBLKSIZE

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE

OUI OUI NON OUI OUI NON NON NON NON OUI NON

WinNT

2-34

CFT 2.3

OS

Manuel de référence

[ICODE

= {code interne géré par le système | ASCII | EBCDIC }]

Dft: OS

Codification des données du fichier d’entrée. [ICOMP

= {0 | cpr}]

Compression des données du fichier d’entrée. La valeur 0 signifie qu’il n’y a pas de compression. Les valeurs possibles (cpr) sont indiqués dans l’annexe “Compression”. [ICT

= {H | C}]

Type de la compression des données du fichier d’entrée : • C : compression CFT à CFT, • H : compression PeSIT Hors SIT. Ce paramètre n’a de sens que si ICOMP est différent de 0. La valeur de ICOMP doit être compatible avec le type de la compression. IFNAME

= filename

Nom du fichier d’entrée à copier. [ILRECL

= {voir le commentaire | n}]

{0..32768}

Pour des enregistrements : • de format fixe (IFRECFM = F)

: taille des enregistrements du fichier d’entrée,

• de format variable (IFRECFM = V)

: taille maximale des enregistrements.

ILRECL est exprimé en nombre d’octets. Si ILRECL est inférieur à la longueur effective d’enregistrement et si : • le fichier d’entrée est compressé, il y a arrêt du traitement, • le fichier d’entrée n’est pas compressé, l’enregistrement lu est tronqué à la longueur fournie. Si ILRECL est supérieur à la longueur effective de l’enregistrement à écrire et si : • le fichier est de format fixe (IRECFM = F), l’enregistrement sera complété à “espace”, c’est-à-dire suivant la valeur du paramètre ICODE : x‘20’ si ICODE = ASCII, x‘40’ si ICODE = EBCDIC, • le fichier n’est pas de format fixe, ce paramètre n’a pas de signification. Valeurs par défaut : pour les systèmes gérant la notion d’enregistrement de fichier : taille effective des articles du fichier en entrée.

CFT 2.3

2-35

Les commandes propres à l’utilitaire CFTUTIL

Pour les systèmes suivants ne gérant pas cette notion : UNIX

WinNT

512 pour les fichiers texte (ITYPE = T, X ou O) et 4096 pour les fichiers binaires ou variables (ITYPE = {B | V}). 2048. Lorsque IRECFM = F, il est conseillé de toujours spécifier ILRECL.Lorsque IRECFM = V, il faut spécifier ILRECL quand la taille d’enregistrement est susceptible d’être supérieure à 2048.

VOS

[IRECFM

= {voir Guide d’exploitation spécifique | F | V | U}]

OS

Format des enregistrements du fichier en entrée : • F : fixe, • V : variable, • U : indéfini (“Undefined”). Les valeurs possibles par système sont indiquées dans le “Guide d’exploitation” de CFT correspondant à votre OS. Si le fichier d’entrée est compressé (ICOMP différent de 0), la valeur du paramètre IRECFM est forcée à V. OS400

UNIX

La notion de format variable est propre à CFT et ne correspond pas à une réalité pour les systèmes indiqués.

Consultez le “Guide d’exploitation” de CFT correspondant à votre OS. [ITYPE

= {voir Guide d’exploitation spécifique | c }]

OS

Type du fichier en entrée. Consultez le “Guide d’exploitation” de CFT correspondant à votre OS. [OBLKSIZE

= {valeur de IBLKSIZE | n }]

{0..32768}

OS

Taille (en octet) des blocs du fichier de sortie. La valeur indiquée doit être supérieure à celle du paramètre OLRECL. Tableau 24. COPYFILE OBLKSIZE - OS concernés

2-36

OS

OBLKSIZE

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

OUI OUI NON OUI NON NON NON NON NON OUI NON

CFT 2.3

Manuel de référence

[OCODE

= {code interne géré par le système | ASCII | EBCDIC}]

Dft : OS

Codification des données du fichier de sortie. [OCOMP

= {0 | cpr}]

Compression des données du fichier de sortie. La valeur 0 signifie qu’il n’y a pas de compression. Les valeurs possibles (cpr) sont indiquées dans l’annexe “Compression”. [OCT

= {H | C }]

Type de la compression des données du fichier de sortie : • C : compression CFT à CFT, • H : compression PeSIT Hors SIT. Ce paramètre n’a de sens que si OCOMP est différent de 0. La valeur de OCOMP doit être compatible avec le type de la compression. OFNAME

= filename

Nom du fichier de sortie. [OLRECL

= {voir le commentaire | n}]

{0..32768}

Pour des enregistrements : • de format fixe (ORECFM = F) : longueur des enregistrements du fichier de sortie, • de format variable (FRECFM = V) : longueur maximale des enregistrements. OLRECL est exprimé en nombre d’octets. Si OLRECL est : • inférieur à la longueur effective de l’enregistrement à écrire, l’enregistrement est alors tronqué à la longueur fournie, • supérieur à la longueur effective de l’enregistrement à écrire et si : -

le fichier est de format fixe (ORECFM=F), l’enregistrement sera complété à “espace” c’est-à-dire suivant la valeur du paramètre OCODE : x‘20’ si OCODE = ASCII, x‘40’ si OCODE = EBCDIC,

-

le fichier n’est pas de format fixe, ce paramètre n’aura de signification que pour la création du fichier.

Valeurs par défaut : si le fichier de sortie : • n’existe pas, valeur de ILRECL, • existe : -

CFT 2.3

pour les systèmes gérant la notion d’enregistrement de fichier : taille effective des articles du fichier de sortie,

2-37

Les commandes propres à l’utilitaire CFTUTIL

-

pour les systèmes suivants ne gérant pas cette notion : WinNT

512.

UNIX

512 pour les fichiers texte (OTYPE=T, X ou O). 4096 pour les fichiers binaires ou variables (OTYPE={B | V}).

VOS

La valeur par défaut est de 2048 octets. Lorsque ORECFM=F, il est conseillé de toujours spécifie OLRECL. Lorsque ORECFM=V, il faut spécifier OLRECL quand la taille d’enregistrement est susceptible d’être supérieure à 2048.

[ORECFM

= {valeur de IRECFM | F | V | U} ]

Format des enregistrements de sortie : • F : fixe, • V : variable, • U : indéfini (“Undefined”). Les valeurs possibles par système sont indiquées dans le “Guide d’exploitation” de CFT correspondant à votre OS. Si le fichier de sortie est compressé (OCOMP différent de 0), la valeur du paramètre ORECFM est forcée à V. UNIX

VM

[OSPACE

La valeur “U” est maintenue pour compatibilité avec les versions antérieures. Sa signification est identique à ORECFM=V.

= {0 | n }]

{0..4294967295}

Espace à réserver pour le fichier en sortie, en K-octets (1 K-octet = 1024 octets). Si le fichier de sortie existe déjà, la valeur par défaut est la valeur de ce fichier existant ; dans le cas contraire, elle est égale à 0. UNIX

[OTYPE

VM

Paramètre ineffectif.

= {voir “Guide d’exploitation” | c}]

OS

Type du fichier de sortie. Consultez le “Guide d’exploitation” de CFT correspondant à votre OS.

2-38

CFT 2.3

Manuel de référence

2.3.2.3. Statistiques L’utilitaire édite les statistiques de l’exécution. Figure 5.

(1) (2) (3) (4) (5) (6) (6b) (7) (8) (9) (10) (11) (11b) (12) (12b)

CFT 2.3

Statistiques de l’exécution - Commande COPYFILE

COPYFILE Input file parameters : File name IFNAME = *xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx File data code ICODE = xxxxx File Compression type ICT = xxx File Compression value ICOMP = nn File Record Number = nnnnn File size = nnnnn File size (truncated) = nnnnn Output file parameters : File name OFNAME = *xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx File Data code OCODE = xxxxx File Compression type OCT = xxx File Compression value OCOMP = nn File size = nnnnn File size (padded) = nnnnn Compression rate : nn % Expansion rate : nn %

2-39

Les commandes propres à l’utilitaire CFTUTIL

Le tableau ci-dessous détaille le contenu des rubriques figurant dans la figure précédente. Tableau 25. COPYFILE - Statistiques d’exécution Numéro de rubrique

Contenu

1 2 3

Nom complet du fichier en entrée Codification des données du fichier en entrée Type de compression du fichier en entrée : • EXT (PeSIT hors SIT) • CFT (PeSIT CFT à CFT) Valeur de la compression du fichier en entrée Nombre d’enregistrements à copier (fichier en entrée) Taille du fichier en entrée en K octets (1) Taille du fichier en entrée, en K octets, si ILRECL est inférieur à la taille réelle de l’enregistrement (2) Nom complet du fichier de sortie Codification des données du fichier de sortie Type de compression : • EXT (PeSIT hors SIT) • CFT (PeSIT CFT à CFT) Valeur de la compression du fichier de sortie Taille du fichier de sortie en K octets Taille du fichier de sortie en K octets, si padding (OLRECL > ILRECL) Taux de compression réalisé lors de la copie Taux d’expansion réalisé lors de la copie

4 5 6 6b 7 8 9

10 11 11b 12 12b

(1) (2) : les rubriques 6 et 6b sont exclusives : si la rubrique 6b est affichée, la rubrique 6 ne l’est pas et réciproquement.

2.3.2.4. Exemple COPYFILE

ICODE IFNAME ILRECL IRECFM ICOMP OFNAME OCODE OLRECL ORECFM OCOMP OCT

= = = = = = = = = = =

ASCII, filename1, 45, V, 0, filename2, ASCII, 45, V, 15, C

Copie avec compression d’un fichier séquentiel d’enregistrements de longueur variable (15 : toutes les compressions disponibles). La compression effectuée est de type “CFT”.

2-40

CFT 2.3

Manuel de référence

2.3.3. LISTCOM - Liste des enregistrements du média de communication Cette commande liste en clair les enregistrements du média de communication que ceux-ci soient chiffrés ou non (voir la commande CFTFILE TYPE = COM, CIPHER = YES). Seul le média de communication de type fichier est concerné par cette commande.

2.3.3.1. Syntaxe LISTCOM [FILENAME [CONTENT [FIRST [LAST [VERIFY

= = = = =

{voir le commentaire | filename},] {ACTIVE | FULL},] {1 | n},] {nombre max d’enregistrements | n},] {NO | YES}]

2.3.3.2. Paramètres [CONTENT = {ACTIVE | FULL}] Type d’affichage des résultats : • ACTIVE : requêtes susceptibles d’être activées par CFT, • FULL : liste de l’ensemble des enregistrements (actifs ou non). [FIRST

= {1 | n}]

{1 .. nombre max d’enregistrements}

Numéro du premier enregistrement à afficher ou à lister. Le nombre maximum d’enregistrements est celui défini à la création du fichier dans le paramètre RECNB de la commande CFTFILE. [FILE

= {voir le commentaire | filename}]

Nom du fichier de média de communication. Le type fichier est implicite (le type de média mailbox n’est pas concerné). La valeur par défaut de ce paramètre est fixe (consultez, sur ce point, le paragraphe ”Médias de l’utilitaire” du guide ”Concepts” de CFT). Pour désigner le fichier de communication courant du moniteur, il est nécessaire de renseigner ce paramètre avec la valeur du paramètre NAME de la commande CFTCOM TYPE=FILE.

CFT 2.3

2-41

Les commandes propres à l’utilitaire CFTUTIL

[LAST

= {nombre max d’enregistrements | n}]

{1 .. nombre max d’enregistrements}

Numéro du dernier enregistrement à afficher ou à lister. La valeur par défaut est le nombre maximum d’enregistrements défini à la création du fichier dans le paramètre RECNB de la commande CFTFILE. Le nombre maximum d’enregistrements est celui défini à la création du fichier dans le paramètre RECNB de la commande CFTFILE. [VERIFY

= {NO | YES}]

Demande de vérification de la validité de chaque enregistrement du fichier au moment du listage ou de l’affichage.

2-42

CFT 2.3

3. Les commandes de paramétrage de l’environnement du moniteur 3.1 CFTPARM - Param ètres généraux

3.1.1. Description La commande CFTPARM permet : • d’une part de préciser les paramètres qui contrôlent le fonctionnement global de CFT, • d’autre part de sélectionner les autres commandes de paramétrage devant être prises en compte à l’exécution. Généralement, l’utilisateur travaille avec une seule commande CFTPARM présente dans le fichier Paramètres. Il peut toutefois y en avoir plusieurs, une seule étant sélectionnée au moment de l’activation du moniteur, en précisant (en paramètre d’activation) la valeur de l’identifiant (ID) de la commande CFTPARM choisie (consultez le paragraphe “Activation” du manuel “Concepts” de CFT). Si ce paramètre d’activation n’est pas renseigné, le moniteur CFT cherche une commande CFTPARM ID = IDPARM0 (chiffre 0). Les paramètres définissant l’environnement de CFT sont relatifs, en particulier : • aux constantes de dimensionnement, • aux “pointeurs” vers les autres paramètres, • aux actions de fin de transfert, • à la clé d’activation du produit. Ils sont définis au lancement de CFT et ne sont pas modifiables dynamiquement. La description complète de l’usage des procédures de fin de transfert (paramètres EXECSE, EXECSF, ...) est faite dans le manuel “Concepts” de CFT, au chapitre “Procédures de fin de transfert”. Par ailleurs, le paragraphe "Variables symboliques" du manuel “Concepts” de CFT décrit l’usage qui peut être fait des variables symboliques, dans la dénomination et dans le corps de ces procédures. En ce qui concerne la sécurité des échanges (SSL), les paramètres spécifiques sont décrits dans le "Guide de la sécurité de transport".

CFT V2.3

3-1

Les commandes de paramétrage de l’environnement du moniteur

3.1.2. Syntaxe CFTPARM CAT COM ID KEY NET PART PARTFNAM PROT [BUFSIZE

= = = = = = = = =

identifier, (identifier, identifier,...), identifier, {string | #filename}, (identifier, identifier,.....), identifier, filename, (identifier, identifier,....), n,]

[COMMENT = string,] [CTLPASSW [EXITEOT [NPART [DEFAULT [ACCNT [LOG [EXECSE [EXECSM [EXECRM [EXECSF [EXECRF [EXECRE [EXECSFA [EXECSMA [MAXTRANS [MAXTASK [MODE [RCVALLER [SECFNAME [TRANTASK [TRKPART [TRKRECV [TRKSEND

= = = = = = = = = = = = = = = = = = = = = = =

{NO | YES},] identifier,] string,] {DEFAUT | identifier},] identifier,] identifier,] filename,] filename,] filename,] filename,] filename,] filename,] filename,] filename,] {maximum supporté | n},] {maximum supporté | n},] {REPLACE | CREATE | DELETE},] {STOP | CONTINUE},] filename,] {maximum supporté | n},] {NO | ALL | SUMMARY},] {NO | ALL | SUMMARY},] {NO | ALL | SUMMARY },]

[USERCTRL = {NO | YES},] [WAITRESP

=

OS

n,]

[WAITTASK = {1441 | n}]

3-2

PROTOCOLE

OS

CFT V2.3

Manuel de référence

3.1.3. Paramètres [ACCNT = identifier] Identifiant de la commande de description de l’enregistrement des données statistiques des transferts (CFTACCNT). [BUFSIZE = {voir le tableau | n}] {512..voir le tableau} Taille du buffer interne du moniteur, permettant l’échange des données entre les tâches du moniteur, exprimée en caractères (octets). Une taille importante privilégie les performances mais alourdit l’occupation mémoire. La valeur de BUFSIZE doit être supérieure ou égale au maximum des valeurs des paramètres RRUSIZE et SRUSIZE des divers protocoles. Si cette valeur est inférieure, le moniteur force comme valeur de BUFSIZE le maximum des valeurs des paramètres RRUSIZE et SRUSIZE. Le tableau suivant indique la valeur maximum et la valeur par défaut supportées sur chaque système. Tableau 26. CFTPARM BUFSIZE - Tailles maximales et valeurs par défaut OS

Valeur maximale

Valeur par défaut

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

4096 32700 4096 32767 32000 8192 32767 8000 4096 32767 4096

4096 4096 4096 4104 4096 4096 4104 4096 4096 4104 4096

CAT = identifier Identifiant de la commande décrivant la gestion du fichier catalogue (CFTCAT). COM = (identifier, identifier,...) Liste des identifiants des commandes de description des médias de communication (CFTCOM). Le nombre maximum d’identifiants supporté est de 3.

CFT V2.3

3-3

Les commandes de paramétrage de l’environnement du moniteur

[COMMENT = string32] Zone commentaire de 32 caractères. Cette zone apparaît dans la liste des moniteurs de CFTINT. ODETTE

Si le premier caractère vaut ‘*’, alors l’EERP reçu ne sera pas traité.

[CTLPASSW = NO | YES] Demande de contrôle par l’outil de sécurité des paramètres NSPART et du NSPASSW lors d’une connexion entrante sur un site serveur. • NO

: le contrôle s’effectue dans le moniteur par rapport aux paramètres NRPART et NRPASSW,

• YES

: le contrôle s’effectue dans le logiciel de sécurité :

-

après la création d’un partenaire dynamique, si le paramètre DYNAM de la commande CFTPROT est renseigné,

-

après l’appel à l’EXIT de type annuaire, si le paramètre EXIT de la commande CFTPROT est renseigné.

[DEFAULT = {DEFAUT | identifier}] Identifiant par défaut (noté d’une façon générique ) des commandes CFTRECV, CFTSEND, CFTXLATE et CFTX25. CFTRECV et CFTSEND ID = Ces commandes précisent les valeurs par défaut, complémentaires des paramètres des commandes RECV et SEND, lorsque l’IDF de la requête de transfert n’est pas défini explicitement par une commande CFTRECV ou CFTSEND. Les commandes CFTRECV et CFTSEND ID = sont obligatoires. Attention : les caractéristiques des fichiers types par défaut (CFTSEND et CFTRECV d’identifiant “default”) sont, contrairement aux autres fichiers types, chargées en mémoire à l’initialisation de CFT. Elles constituent donc des paramètres STATIQUES. L’usage de la commande CFTRECV ID = peut concerner la réception de fichiers de tailles et de formats différents. Lorsque le protocole le permet, il est donc souhaitable que les valeurs des paramètres FSPACE, FRECFM, FORG (...) de cette commande ne soient pas renseignées, afin que CFT prenne en compte les valeurs réelles du fichier reçu, transmises par le protocole (voir les possibilités de chaque protocole). CFTXLATE ID = Cette commande précise les tables de transcodage par défaut, lorsque les commandes SEND/CFTSEND (ou RECV/CFTRECV) et CFTPART ne les désignent pas explicitement. La commande CFTXLATE ID = est facultative ; en cas d’absence, ce sont les tables de transcodage internes au moniteur qui sont utilisées (voir leur description en annexe). CFTX25 ID = Exploité par le moniteur pour les appels entrants (fonctionnement en mode serveur). Lorsqu’une description réseau X25 du partenaire, correspondant à la ressource sur laquelle arrive l’appel est absente, le moniteur recherche la description “par défaut” : CFTX25 ID = , ... Cette commande ne fait pas apparaître les paramètres spécifiques à un partenaire, ni les paramètres propres aux appels sortants (DIALNO, CNXOUT, RETRY*, O*TIME).

3-4

CFT V2.3

Manuel de référence

[EXECRE = filename] Nom générique du fichier décrivant les procédures à exécuter, suite à un incident (Erreur) lors d’un transfert en réception, le transfert passant à l’état H ou K. Ce nom peut être composé des variables symboliques suivantes : • &IDF, &PARM, • &PART, &RPART, &SPART, &GROUP, • &RUSER, &SUSER, • &RAPPL, &SAPPL, • &DIAGI, &DIAGP, • &NIDF. Le caractère ‘&’ désigne le caractère char_symb défini dans le “Guide d’exploitation” de CFT correspondant à votre OS. [EXECRF = filename] Nom générique du fichier décrivant les procédures à exécuter en fin de réception d’un fichier. Ce nom peut être composé des variables symboliques suivantes : • &IDF, &PARM, • &PART, &RPART, &SPART, &GROUP, • &RUSER, &SUSER, &USERID, • &RAPPL, &SAPPL, • &NIDF. Le caractère ‘&’ désigne le caractère char_symb défini dans le “Guide d’exploitation” de CFT correspondant à votre OS. [EXECRM = filename] Nom générique du fichier décrivant les procédures à exécuter en fin de réception d’un message. Ce nom peut être composé des variables symboliques suivantes : • &IDM, &PARM, • &PART, &RPART, &SPART, &GROUP, • &RUSER, &SUSER, &USERID, • &RAPPL, &SAPPL. Le caractère ‘&’ désigne le caractère char_symb défini dans le “Guide d’exploitation” de CFT correspondant à votre OS.

CFT V2.3

3-5

Les commandes de paramétrage de l’environnement du moniteur

[EXECSE = filename] Nom générique du fichier décrivant les procédures à exécuter, suite à un incident (Erreur) lors d’un transfert en émission, le transfert passant à l’état H ou K. Ce nom peut être composé des variables symboliques suivantes : • &IDF, &PARM, • &PART, &RPART, &SPART, &GROUP, • &RUSER, &SUSER, &USERID, • &RAPPL, &SAPPL, • &DIAGI, &DIAGP, • &NIDF. Le caractère ‘&’ désigne le caractère char_symb défini dans le “Guide d’exploitation” de CFT correspondant à votre OS. [EXECSF = filename] Nom générique du fichier décrivant les procédures à exécuter en fin d’émission d’un fichier. Ce nom peut être composé des variables symboliques suivantes : • &IDF, &PARM, • &PART, &RPART, &SPART, &GROUP, • &RUSER, &SUSER, &USERID, • &RAPPL, &SAPPL, • &NIDF. Le caractère ‘&’ désigne le caractère char_symb défini dans le “Guide d’exploitation” de CFT correspondant à votre OS. [EXECSFA = filename] Nom générique du fichier décrivant les procédures à exécuter lors de la réception d’un acquittement (message de type REPLY), suite à l’émission d’un fichier. Ce nom peut être composé des variables symboliques suivantes : • &IDF, &PARM, • &PART, &RPART, &SPART, &GROUP, • &RUSER, &SUSER, &USERID, • &RAPPL, &SAPPL. Le caractère ‘&’ désigne le caractère char_symb défini dans le “Guide d’exploitation” de CFT correspondant à votre OS.

3-6

CFT V2.3

Manuel de référence

[EXECSM = filename] Nom générique du fichier décrivant les procédures à exécuter en fin d’émission d’un message. Ce nom peut être composé des variables symboliques suivantes : • &IDM, &PARM, • &PART, &RPART, &SPART, &GROUP, • &RUSER, &SUSER, &USERID, • &RAPPL, &SAPPL. Le caractère ‘&’ désigne le caractère char_symb défini dans le “Guide d’exploitation” de CFT correspondant à votre OS. [EXECSMA = filename] Nom générique du fichier décrivant les procédures à exécuter lors de la réception d’un acquittement (message de type REPLY), suite à l’émission d’un message. Ce nom peut être composé des variables symboliques suivantes : • &IDM, &PARM, • &PART, &RPART, &SPART, &GROUP, • &RUSER, &SUSER, &USERID, • &RAPPL, &SAPPL. Le caractère ‘&’ désigne le caractère char_symb défini dans le “Guide d’exploitation” de CFT correspondant à votre OS. [EXITEOT = identifier] Identifiant de l’EXIT. Pour activer un EXIT de type fin de transfert, il faut indiquer un identifiant d’EXIT pointant sur une commande CFTEXIT. On peut utiliser une variable symbolique pour l’identifiant d’EXIT de type fin de transfert : • EXITEOT = (&NPART, &PART, &IDF, &GROUP ou &IDA) où NPART désigne le nom réseau du partenaire distant (les 8 premiers caractères au plus sont pris en compte), • PART désigne l’identifiant du partenaire local, • IDF désigne l’identifiant de fichier ou de message, • GROUP désigne le groupe du partenaire, • IDA désigne l’identifiant local d’application. ID

= identifier Identifiant de la commande CFTPARM. Cette valeur, passée comme paramètre d’activation, décrit une configuration du moniteur.

CFT V2.3

3-7

Les commandes de paramétrage de l’environnement du moniteur

KEY = {string33 | #filename} Clé d’utilisation de CFT dont la valeur est fournie par SOPRA, ou bien nom d’un fichier d’indirection (précédé du caractère spécifique à chaque système) contenant l’ensemble des clés associées au moniteur. Remarque : le nom du fichier est limité à 40 caractères mais il est possible d’utiliser un nom de fichier logique. C’est un fichier de type texte dont chaque enregistrement correspond à une clé logicielle. Le premier caractère de cette clé doit obligatoirement être inscrit en première colonne. Toute chaîne de caractères, séparée par au moins un blanc et suivant une clé, est considérée comme un commentaire. La valeur du paramètre doit être renseignée entre quotes (‘’). Cette “clé” est associée aux conditions contractuelles d’utilisation du logiciel. Elle est spécifique au système d’exploitation hôte du produit et limite l’usage de CFT à un nombre maximum de transferts simultanés (limite du paramètre MAXTRANS) ou à une option commerciale éventuelle. Par ailleurs, elle limite l’usage de CFT, suivant le type de clé qui est utilisé. Cette clé peut être : • de type “CPU”. Ce type est utilisé pour la protection liée à l’usage de logiciels complémentaires spécifiques. Cette clé a pour but essentiel de limiter l’utilisation du logiciel CFT aux machines caractérisées par leur numéro de MODELE et par leur numéro de SERIE, • de type “DATE”. Ce type est utilisable pour tous les environnements systèmes. Cette clé a pour but de limiter la durée d’utilisation du logiciel CFT, jusqu’à une date spécifiée au moment du calcul de cette clé, • de type “LIBELLE”. Ce type est utilisable pour tous les environnements systèmes. Cette clé a pour but de limiter l’utilisation du logiciel CFT à un usage spécifique désigné par un intitulé. Par exemple : usage limité à l’entreprise cliente, • de type “IDF”. Ce type est utilisé pour la protection liée à l’usage de logiciels complémentaires spécifiques. [LOG = identifier] Identifiant de la commande de description des fichiers de journalisation des événements du moniteur (CFTLOG). Si ce paramètre n’est pas renseigné, le moniteur CFT écrit les messages destinés à la journalisation sur la sortie standard du moniteur.

3-8

CFT V2.3

Manuel de référence

MAXTASK = {maximum supporté | n} {1..voir le tableau} Nombre de tâches d’accès fichier autorisées. Le tableau suivant indique le nombre maximum supporté pour chaque système. Tableau 27. CFTPARM MAXTASK - Nombre maximum OS

Nombre maximum

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

4 30 2 64 32 8 64 8 10 64 Sans objet

[MAXTRANS = {maximum supporté | n}] {1..voir le tableau} Nombre de transferts en parallèle autorisés. Le tableau suivant indique la valeur maximale supportée pour chaque système ; cette valeur fixe la limite physique du produit indépendamment de la limite fixée par la clef de protection logicielle. Tableau 28. CFTPARM MAXTRANS - Nombre maximum

CFT V2.3

OS

Valeur maximale supportée

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

32 90 20 240 32 64 16 32 200 16 16

3-9

Les commandes de paramétrage de l’environnement du moniteur

NET = (identifier, identifier,....) Liste d’identifiants des commandes de description des méthodes d’accès réseau et des ressources réseau du moniteur (CFTNET). Si le paramétrage décrit un nombre d’identifiants supérieur au maximum autorisé, la commande ne sera pas rejetée mais seuls les premiers seront pris en compte. Pour une information complémentaire, voir la définition de la commande CFTNET et consultez le “Guide d’exploitation” de CFT correspondant à votre OS. MVS VM

VSE

Dans la liste NET = ( ... , ... ), l’identifiant désignant la commande CFTNET TYPE = SNA, PROFILE = GATE, ... doit obligatoirement être indiqué avant les identifiants désignant les commandes CFTNET TYPE = X25, ...

[NPART = {Valeur de PART | string28}] Dénomination “réseau” par défaut du site local. Valeur par défaut du paramètre NSPART de la commande CFTPART. Ce nom étant transmis par certains protocoles de transfert de fichiers, l’utilisateur se référera au “Guide des protocoles” CFT, pour en vérifier la taille et le format. PART = identifier Dénomination locale, identifiant le site sur lequel s’exécute CFT. Ce paramètre n’a d’autre portée qu’une simple information apparaissant dans le catalogue des transferts. PARTFNAM = filename Nom du fichier Partenaire. OS400

L’emploi du nom logique “+CFTPART” est obligatoire, afin que CFT/400 Manager puisse lancer le moniteur avec l’OVRDBF et l’ALCOBJ appropriés.

PROT = (identifier, identifier,....) Identifiant des commandes de description des protocoles CFT (CFTPROT). Par “protocole CFT”, il faut entendre à la fois les protocoles applicatifs de transfert de fichiers et les méthodes d’accès réseau. Si le paramétrage décrit un nombre d’identifiants supérieur au maximum autorisé, la commande n’est pas rejetée, mais seuls les premiers seront pris en compte. Pour une information complémentaire, voir la définition de la commande CFTNET et consulter le “Guide d’exploitation” de CFT correspondant à votre OS. [RCVALLER = {STOP | CONTINUE}] Option à prendre en cas d’erreur lors de la réception de fichiers mis à disposition (option FILE=ALL) : • STOP : interruption du traitement de réception, • CONTINUE : poursuite du traitement.

3-10

CFT V2.3

Manuel de référence

[SECFNAME = filename] Nom du fichier sécurité dans le cadre d’une sécurité interne à CFT. [TRANTASK = {maximum supporté | n}] {..voir le tableau} Nombre de transferts en parallèle assurés par une tâche d’accès fichier, au-delà desquels une nouvelle tâche est créée, si possible. Si le nombre de tâches d’accès fichier autorisé est atteint (MAXTASK), les transferts en parallèle supplémentaires (jusqu’à MAXTRANS) sont répartis d’une manière équilibrée sur les tâches d’accès fichier les moins chargées. Le nombre maximum de transferts en parallèles (arrondi à l’unité supérieure) qu’une tâche d’accès fichier peut être amenée à gérer est : valeur de MAXTRANS valeur de MAXTASK Le mécanisme ainsi géré au travers du paramètre TRANTASK n’agit que lorsque : valeur de MAXTRANS valeur de MAXTASK

≥ valeur de TRANTASK

soit MAXTASK * TRANTASK ≤ MAXTRANS Le tableau suivant indique la valeur maximale supportée pour chaque système. Tableau 29. CFTPARM TRANTASK - Nombre maximum OS

Valeur maximale

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

8 30 10 14 32 8 14 8 20 14 Sans objet

GCOS8

Exemple : MAXTRANS = 10, MAXTASK = 2, TRANTASK = 4, Permet de créer 2 tâches d’accès fichier, gérant chacune 4 transferts. Le 9ème et le 10ème transferts sont affectés aux tâches existantes. Le 11ème transfert en parallèle est mis en attente de libération de ressource.

CFT V2.3

3-11

Les commandes de paramétrage de l’environnement du moniteur

[TRKPART = {NO | ALL | SUMMARY}] Spécification du niveau de détail que CFT fournit à Sentinel sur les transferts. CFT envoie les informations sur le transfert sous forme d'occurrences de suivi. Les valeurs possibles de ce paramètre sont : • NO:

le moniteur n'envoie jamais d'occurrences de suivi à Sentinel,

• ALL:

le moniteur envoie une occurrence de suivi à Sentinel pour chaque étape de chaque transfert,

• SUMMARY : le moniteur envoie une occurrence de suivi à Sentinel uniquement pour l'étape initiale et l'étape finale de chaque transfert. TRKPART contient la valeur par défaut du paramètre TRK de la commande CFTPART. TRKPART n'est utilisable qu'à partir de la version CFT V2.3.1. [TRKRECV = {NO | ALL | SUMMARY}] Spécification du niveau de détail que CFT fournit à Sentinel sur les transferts. CFT envoie les informations sur le transfert sous forme d'occurrences de suivi. Les valeurs possibles de ce paramètre sont : • NO:

le moniteur n'envoie jamais d'occurrences de suivi à Sentinel,

• ALL:

le moniteur envoie une occurrence de suivi à Sentinel pour chaque étape de chaque transfert,

• SUMMARY : le moniteur envoie une occurrence de suivi à Sentinel uniquement pour l'étape initiale et l'étape finale de chaque transfert. TRKRECV contient la valeur par défaut du paramètre TRK des commandes CFTRECV et RECV. TRKRECV n'est utilisable qu'à partir de la version CFT V2.3.1. [TRKSEND = {NO | ALL | SUMMARY}] Spécification du niveau de détail que CFT fournit à Sentinel sur les transferts. CFT envoie les informations sur le transfert sous forme d'occurrences de suivi. Les valeurs possibles de ce paramètre sont : • NO:

le moniteur n'envoie jamais d'occurrences de suivi à Sentinel,

• ALL:

le moniteur envoie une occurrence de suivi à Sentinel pour chaque étape de chaque transfert,

• SUMMARY : le moniteur envoie une occurrence de suivi à Sentinel uniquement pour l'étape initiale et l'étape finale de chaque transfert. TRKSEND contient la valeur par défaut du paramètre TRK des commandes CFTSEND et SEND. TRKSEND n'est utilisable qu'à partir de la version CFT V2.3.1.

3-12

CFT V2.3

Manuel de référence

[USERCTRL = {NO |YES}] Option de contrôle d’accès aux fichiers transférés. La valeur YES permet de déclencher, au niveau du moniteur, le contrôle du droit d’accès au fichier à transférer, par rapport au “userid” de l’utilisateur associé au transfert. Cet “userid” est déterminé soit : • automatiquement par le système lors du dépôt d’une demande de transfert, • par paramétrage de CFTSEND/CFTRECV (paramètre USERID) en mode serveur. Si la valeur est NO, ce contrôle ne sera pas effectué. Tableau 30. CFTPARM USERCTRL - OS concernés OS

USERCTRL

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

NON NON NON OUI NON OUI OUI OUI NON NON NON

[WAITRESP = {voir le tableau | n}] {1..32767} Délai en secondes (Time out) utilisé lors de la communication (interne) entre les différentes tâches du moniteur. Ce paramètre est exploité lors d’un échange synchrone de requêtes entre deux tâches du moniteur. Au bout de “waitresp” secondes sans réponse, l’attente est interrompue. Un message “CFTS09” est inscrit au journal. Puis, en général, la tâche concernée s’arrête (exemple : tâche CFTTCOM). En phase d’initialisation, ce paramètre contrôle le temps accordé à chacune des tâches du moniteur CFT pour démarrer. En cas de valeur insuffisante (cas d’une machine très chargée), l’initialisation du moniteur CFT s’arrête. Le tableau suivant indique la valeur par défaut pour chaque système. Tableau 31. CFTPARM WAITRESP - Valeurs par défaut

CFT V2.3

OS

Valeur par défaut

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX

100 600 5 60 1000 5

3-13

Les commandes de paramétrage de l’environnement du moniteur

Tableau 31. CFTPARM WAITRESP - Valeurs par défaut (suite) OS

Valeur par défaut

VM VMS VOS VSE WinNT

60 30 100 60 60

[WAITTASK = {1441 | n}] {1..1441} Temps d’inactivité (en minutes) d’une tâche d’accès fichier avant son arrêt. Tableau 32. CFTPARM WAITTASK - OS concernés OS

WAITTASK

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

NON OUI NON OUI OUI OUI OUI OUI OUI OUI OUI

Une valeur égale à 1441 (valeur par défaut) signifie que la tâche est permanente. GCOS8

MVS

VM

VSE

Sous ces systèmes, il est conseillé de choisir WAITTASK=1 (minimum autorisé). Ainsi les tâches inutilisées seront éliminées le plus rapidement possible.

3.1.4. Exemple Les commandes de paramétrage CFTCAT, CFTCOM, CFTLOG, CFTACCNT, CFTNET et CFTPROT présentent la particularité de n’être prise en compte, à l’exécution du moniteur, que si elles ont été sélectionnées via les paramètres correspondants : CAT, COM, LOG, ACCNT, NET et PROT.

3-14

CFT V2.3

Manuel de référence

CFTPARM

ID KEY NPART BUFSIZE DEFAULT TRANTASK MAXTRANS MAXTASK WAITRESP NET PROT COM CAT LOG EXECSF EXECRF EXECSE EXECRE PARTFNAM

= = = = = = = = = = = = = = = = = = =

PARM1, ‘XXXXXXXXXXXXXXXXXXXXX’, MYCFT, 4096, IDFDEF, 1, 4, 1, 500, (SNAGATE , X25LINE1), (PESITCFT , ETEBAC3), COM1, CAT1, LOG1, , , , ,

Dans cet exemple, parmi toutes les commandes soumises en entrée de CFTUTIL, seules seront prises en compte les commandes suivantes : CFTCAT ID = CAT1, ... CFTCOM ID = COM1, ... CFTLOG ID = LOG1, ... CFTPROT ID = PESITCFT, ... CFTPROT ID = ETEBAC3, ... CFTNET ID = SNAGATE , ... CFTNET ID = X25LINE1 , ... Les jeux de paramètres des commandes de transfert (commandes CFTRECV et CFTSEND) doivent inclure, au minimum, deux commandes associées à l’identifiant de fichier type par défaut : CFTSEND ID = IDFDEF, ... CFTRECV ID = IDFDEF, ... Les paramètres NSPART des commandes CFTPART indiquant la façon dont CFT s’identifie auprès des partenaires distants, auront pour valeur par défaut “MYCFT”. Le moniteur soumettra, en fin de transfert et selon le sens et le type de transfert, le fichier de commande obtenu par recopie et traduction des variables symboliques, à partir des fichiers de commande pointés par les paramètres suivants : • EXECSF pour les actions faisant suite à émission de fichier, • EXECRF pour les actions faisant suite à réception de fichier, • EXECSE pour les actions suite à erreur en cours d’émission, • EXECRE pour les actions suite à erreur en cours de réception. La substitution de la variable symbolique &IDF, présente dans la valeur de ces paramètres, permettra de constituer le nom véritable du fichier.

CFT V2.3

3-15

Les commandes de paramétrage de l’environnement du moniteur

3.2 CFTCOM - Modes d e communication applications / moniteur CFT La commande CFTCOM permet au moniteur d’ouvrir des médias de communication avec les applicatifs. Selon les systèmes, il est possible d’utiliser un ou plusieurs des médias suivants : • un (ou plusieurs) fichier(s) partagé(s) (paramétrage TYPE = FILE). Les requêtes sont déposées dans ce(s) fichier(s), scrutés périodiquement par le moniteur. La présence du moniteur n’est donc pas nécessaire au dépôt des requêtes, tant que celles-ci ne saturent pas le fichier. Une commande CFTCOM définit alors un fichier de communication et sa fréquence de scrutation par le moniteur, • une boîte aux lettres CFT (Mailbox) (paramétrage TYPE = MBX), La commande CFTCOM permet au moniteur de s’attacher à une boîte aux lettres définie par son nom logique. • un média de communication synchrone s'appuyant sur un réseau TCP/IP (paramétrage TYPE = TCPIP). Les médias de communication utilisables par système sont indiqués dans le Guide d’exploitation correspondant. Il doit y avoir cohérence entre la déclaration du média de communication, utilisé par un programme applicatif demandeur, et les médias “ouverts” par le moniteur : • commande CONFIG TYPE = COM, ... de l’utilitaire CFTUTIL, • fonction COM des interfaces de programmation, • option 7 - caractéristiques du moniteur. MVS

VSE

WinNT

Il est nécessaire de définir 1 fichier de communication réservé aux applications BATCH/TSO, et 1 second fichier de communication réservé aux applications CICS (si besoin est). Dans une exploitation “stand-alone”, les requêtes émises par les applicatifs Windows concernent le moniteur et dans ce cas, la méthode de communication conseillée est la boîte aux lettres. Dans une exploitation en réseau local, les requêtes émises par les applicatifs Windows concernent un moniteur CFT qui n’est pas sur la même machine. Dans ce cas, la communication ne peut se faire que via un fichier.

3.2.1. Syntaxe CFTCOM [MODE ID TYPE

= {REPLACE | CREATE | DELETE},] = identifier, = {FILE | MBX | TCPIP},

TYPE=FILE

NAME [WSCAN

= filename, = {60 | n}]

TYPE=MBX

NAME

3-16

= string

CFT V2.3

Manuel de référence

TYPE=TCPIP

PROTOCOL HOST PORT [ADDRLIST [DISCTS

= {XHTTP | XHTTPS}, = string, = numérique, = (string,string…),] = numérique]

3.2.2. Paramètres ID

= identifier Identifiant de la commande CFTCOM.

TYPE = { voir "Guide d’exploitation" | FILE | MBX | TCPIP} Moyen de communication avec CFT. Ce paramètre peut prendre les valeurs suivantes : • FILE : la communication s’effectue par fichier, • MBX : la communication s’effectue par boîte aux lettres, • TCPIP : la communication s'effectue par le média de communication synchrone. TYPE=FILE

NAME = filename Désigne le nom du fichier de communication. [WSCAN = {60 | n}] {1..3600} Délai de scrutation du fichier de communication (en secondes). Détermine le délai de prise en compte d’une commande par le moniteur CFT. La valeur optimum est un compromis entre un délai de réaction souhaité et la charge de la machine. TYPE=MBX

NAME

= string string 8 string 4

TOUS SYSTEMES SAUF - GCOS7 GCOS7

Désigne le nom de la boîte aux lettres. GCOS7 VM

CFT V2.3

Nom normalisé “CFTi” avec i de 0 à 9. “userid” de la machine virtuelle du moniteur.

3-17

Les commandes de paramétrage de l’environnement du moniteur

VSE

Non pertinent pour ce système d’exploitation.

TYPE=TCPIP

[ADDRLIST = (string1..64,string1..64…)] Liste des adresses autorisées à se connecter sur le média de communication (16 adresses maximum). Si une valeur débute par le caractère #, elle désigne un fichier dans lequel chaque ligne représente une adresse. Tableau 33 CFTCOM ADDRLIST - Types d'adresses autorisées Cas

Format

Traitement

1

ADDRLIST = 172.*

2

ADDRLIST = *.axway

3

ADDRLIST = (172.23.160.81, 172.23.160.82)

4

ADDRLIST = #FichierListe

Seuls les clients dont l’adresse IP commence par 172 sont autorisés Seuls les clients dont le nom de host se termine par « .axway » sont autorisés Seuls les clients dont l'adresse IP complète est indiquée sont autorisés Le fichier contient la liste des adresses autorisées

[DISCTS = n] Délai d'attente (en secondes) avant libération d'un canal ouvert par un client, en l'absence de requête. HOST = string1..64 Adresse IP de la ressource locale. Cette adresse (exprimée sous forme de chaîne de caractères) peut être renseignée soit avec : • l’adresse réelle IP en “notation point” (ex : 192.9.200.10), • le nom logique HOSTNAME associé à l’adresse réelle IP, • la valeur ALL, signifiant toutes les adresses réseau locales. PROTOCOL = { XHTTP | XHTTPS} Protocole de requête/réponse mis en œuvre sur la couche TCP/IP : • XHTTP : variante du protocole HTTP, propriété d'Axway Software, • XHTTPS : protocole XHTTPS, version sécurisée du protocole XHTTP. La sécurité mise en œuvre n'inclut pas l'authentification. PORT =n Port d'écoute sur le ou les réseaux définis dans le paramètre HOST.

3-18

CFT V2.3

Manuel de référence

3.2.3. Exemples TYPE=FILE

CFTCOM

ID TYPE NAME WSCAN

= = = =

IDCOM, FILE, , 120

ID TYPE NAME

= = =

IDCOM, MBX,

TYPE=MBX

CFTCOM

3.3 CFTCAT - Paramèt res de gestion du catalogue La commande CFTCAT permet de décrire l’accès au catalogue des transferts CFT : • fichier, • mode de scrutation, • durée de rétention (avant purge) des informations associées. Le catalogue consigne toutes les informations relatives aux transferts demandés à CFT. La purge du catalogue peut être déclenchée à minuit (valeur par défaut) ou à une heure spécifique indiquée dans le paramètre TIMEP. La purge s’effectue par “lots” de 10 postes. Entre chaque lot, le moniteur traite tous les événements de transferts en attente. De ce fait, si l’activité de transfert est intense, l’action de purge du catalogue peut se prolonger mais sans perturber de manière sensible les transferts.

3.3.1. Syntaxe CFTCAT FNAME ID TIMEP [CACHE [MODE [OPTIMIZE [RH [RKERROR [RT [RX [SH [ST [SX [UPDAT [WSCAN

CFT V2.3

= = = = = = = = = = = = = = =

filename, identifier, {23595999 | HHMMSSCC}, n,] {REPLACE | CREATE | DELETE},] [NONE | CACHE | MEMORY},] {10 | n},] {KEEP | DELETE},] {10 | n},] {10 | n},] {10 | n},] {10 | n},] {10 | n},] {1 | n},] {5 | n}]

3-19

Les commandes de paramétrage de l’environnement du moniteur

3.3.2. Paramètres [CACHE = {voir le commentaire | n}] {512..32000} Paramètre de dimensionnement du buffer mémoire (cache) du moniteur, contenant les transferts en attente de ressource. Exprimé en nombre de postes du catalogue, chaque poste occupant 62 octets. Un buffer important permet de limiter les consultations du fichier catalogue. La valeur par défaut de ce paramètre est égale à 512. Le cache s’étend automatiquement par bloc de taille correspondant à la valeur initiale. FNAME = filename Nom du fichier catalogue. Ce nom peut être : • un nom de fichier physique, • un nom logique. ID

= identifier Nom identifiant la commande CFTCAT. Ce paramètre ne peut être utilisé que jusqu'à la version CFT V230.

[OPTIMIZE = {NONE | CACHE| MEMORY}] Type d'optimisation à appliquer, avec : • NONE : pas d'optimisation, • CACHE : écriture sur disque des blocs internes en fonction du paramètre CACHE de la carte CFTCAT, • MEMORY : optimisation maximum avec gestion en mémoire des blocs internes, mise à jour à l'arrêt du moniteur. Attention : en cas d'arrêt brusque du moniteur (coupure électrique, arrêt système par exemple), la mise à jour n'est pas garantie et le fichier peut se retrouver dans un état incohérent. Dans un tel cas, utiliser l'utilitaire de migration en procédant de la façon suivante : 1. Générer un fichier hors version à l'aide de la commande : MIGR222 TYPE=CAT, DIRECT=FROMCAT, IFNAME=OFNAME 2. Générer le catalogue à l'aide de la commande : MIGR222 TYPE=CAT, DIRECT=TOCAT, IFNAME=OFNAME Concernant les valeurs CACHE et MEMORY, la visibilité des informations liées aux transferts est conditionnée à la mise à jour du fichier. La lecture, par les autres applicatifs (CFTUTIL, exits, …), des informations liées aux transferts est limitée à la fréquence de mise à jour sur disque.

3-20

CFT V2.3

Manuel de référence

RH

= {10 | n}] {1..99} Nombre de jours au bout desquels les postes catalogue des demandes de réception “non terminées” (état C, D, H ou K) sont purgés automatiquement.

[RKERROR = {KEEP | DELETE}] Action à entreprendre lorsqu’un transfert échoue en phase de sélection (mode serveur) : • KEEP : le transfert reste au catalogue, • DELETE : le transfert est supprimé du catalogue. Si le paramètre RKERROR est aussi défini dans la commande CFTRECV, c’est ce dernier qui va être pris en compte. [RT

= {10 | n}] {1..99} Nombre de jours au bout desquels les postes catalogue des réceptions terminées (état RT) sont purgés automatiquement.

[RX

= {10 | n}] {1..99} Nombre de jours au bout desquels les postes catalogue des réceptions dont la procédure de fin de réception s’est correctement exécutée (état RX), sont purgés automatiquement.

[SH

= {10 | n}] {1..99} Nombre de jours au bout desquels les postes catalogue des demandes d’émission “non terminées” (état D, C, H ou K), sont purgés automatiquement.

[ST

= {10 | n}] {1..99} Nombre de jours au bout desquels les postes catalogue des émissions terminées (état ST) sont purgés automatiquement.

[SX

= {10 | n}] {1..99} Nombre de jours au bout desquels les postes catalogue des émissions terminées, dont la procédure de fin d’émission s’est correctement exécutée (état SX), sont purgés automatiquement.

TIMEP = {23595999 | HHMMSSCC} Heure de purge journalière choisie par l’utilisateur. L’utilisateur programme ainsi une purge cyclique et automatique du catalogue. Par défaut, la purge s’effectue à minuit. Attention : l’utilisateur peut choisir de désactiver complètement la purge en renseignant TIMEP = 00000000. Cette opération est à utiliser avec précaution car, dans ce cas, aucune purge automatique (à heure choisie ou à minuit) ne s’effectue. [UPDAT = {1 | n}] {0..32767} Nombre de points de synchronisation séparant deux mises à jour consécutives du fichier catalogue pendant un transfert. Une mise à jour permet l’écriture sur disque du nombre d’enregistrements transmis et acquittés, pour le transfert concerné.

CFT V2.3

3-21

Les commandes de paramétrage de l’environnement du moniteur

Par exemple : • 0 signifie : pas de mise à jour du fichier catalogue en cours de transfert, • 1 signifie : une mise à jour à chaque point de synchronisation. Remarque : sur certains systèmes, augmenter ce nombre de mises à jour est susceptible d’augmenter la consommation CPU et I/O et/ou de dégrader les débits de transfert. [WSCAN = {5 | n}] {0..60} Périodicité de la scrutation du fichier catalogue entre deux tentatives de relance de transfert.

3.3.3. Exemple CFTCAT

ID = IDCAT, FNAME = filename, SH = 7, ST = 3, SX = 3, RH = 7, RT = 3, RX = 3 Les demandes d’émission non terminées (état SH) ainsi que les réceptions interrompues, sont purgées automatiquement au bout de 7 jours (état RH). Les postes des émissions terminées (état ST) ainsi que les postes des réceptions terminées (état RT), sont purgés automatiquement au bout de trois jours. Les postes des émissions et des réceptions terminées dont la procédure de fin s’est bien exécutée (états SX et RX), sont purgés automatiquement au bout de trois jours. Le paramètre UPDAT n’est pas mentionné ; il prend la valeur 1 (par défaut), ce qui se traduit par une mise à jour du fichier catalogue à chaque point de synchronisation de chaque transfert.

3.4 CFTLOG - Paramèt res de gestion des fichiers journaux La commande CFTLOG définit les fichiers de journalisation des messages du moniteur. La valeur du paramètre LOG de la commande CFTPARM doit être celle du paramètre ID de cette commande. Le journal CFT enregistre tous les événements marquants des transferts : • début de session, • début de transfert, • points de reprise, • fin de transfert, • fermeture de session, • incidents.

3-22

CFT V2.3

Manuel de référence

Le basculement d’un fichier sur l’autre peut être déclenché par 5 événements : • échéance quotidienne fixée par le paramètre SWITCH, • commande d’exploitation SWITCH TYPE=LOG, • le nombre d’enregistrements inscrits dans le fichier journal courant est supérieur à la limite fixée par le paramètre MAXREC ou bien, selon les possibilités des OS, le fichier est plein, • l’arrêt du moniteur (commande SHUT), • l’activation du moniteur. Au lancement, le moniteur CFT refuse d’ouvrir un fichier journal non vide. Dans ce cas, il tente automatiquement le basculement vers le fichier journal alterné. Il est donc important que la procédure associée au basculement régénère un fichier vide suite au traitement du fichier journal. Le basculement entraîne l’exécution de la procédure décrite par le paramètre EXEC de cette commande. Typiquement, cette procédure peut exécuter une sauvegarde, la création d’un nouveau fichier vide (de même nom) et éventuellement une édition du fichier sauvegardé. Les fichiers de journalisation doivent être créés par l’exploitation avant l’activation du moniteur CFT (commande CFTFILE TYPE = LOG, ....).

3.4.1. Syntaxe CFTLOG AFNAME = ID = EXEC = FNAME = [CONTENT = [LENGTH = [MAXREC = [MODE = [NOTIFY

=

filename, identifier, filename, filename, {FULL | BRIEF},] {133 | n},] {0 | n},] {REPLACE | CREATE | DELETE},] identifier,]

[OPERMSG =

n,]

[SWITCH =

{00000000 | time},]

OS OS

3.4.2. Paramètres AFNAME = filename Nom du fichier journal “alterné”. Il est déconseillé d’utiliser un nom logique.

CFT V2.3

3-23

Les commandes de paramétrage de l’environnement du moniteur

[CONTENT = {FULL | BRIEF}] Filtrage des messages écrits dans le fichier LOG actif. Les valeurs possibles sont : • FULL : tous les messages sont édités. • BRIEF : les messages suivants n’apparaissent plus dans la LOG (ce sont des messages de catégorie “information système” - voir le paramètre OPERMSG de CFTLOG) : CFTR12I &cmd Treated CFTC07I PART=&part IDF=&idf IDT=&idt State=&state Deleted -

-

en mode demandeur : CFTT53I PART=&part CFTT55I PART=&part CFTT51I PART=&part CFTT56I PART=&part CFTT54I PART=&part CFTT52I PART=&part

IDF=&idf IDF=&idf IDF=&idf IDF=&idf IDF=&idf IDF=&idf

IDT=&idt IDT=&idt IDT=&idt IDT=&idt IDT=&idt IDT=&idt

Requester Requester Requester Requester Requester Requester

en mode serveur : CFTT51I PART=&part CFTT53I PART=&part CFTT55I PART=&part CFTT56I PART=&part CFTT54I PART=&part

IDF=&idf IDF=&idf IDF=&idf IDF=&idf IDF=&idf

IDT=&idt IDT=&idt IDT=&idt IDT=&idt IDT=&idt

Server Server Server Server Server

file selected file opened session opened file closed file deselect session closed

session opened file created file opened file closed file deselect

En revanche tous les messages d’erreurs (ou de “warning”) quelle que soit leur origine sont édités. Pour un transfert sans incident, on aura dans la LOG les 2 messages suivants : • en mode demandeur : CFTT57I PART=&part IDF=&idf IDT=&idt Requester transfer started CFTT58I PART=&part IDF=&idf IDT=&idt Requester transfer ended • en mode serveur : CFTT57I PART=&part IDF=&idf IDT=&idt Server transfer started CFTT58I PART=&part IDF=&idf IDT=&idt Server transfer ended EXEC = filename Nom de la procédure à exécuter lors d’un basculement sur l’autre fichier journal. Cette procédure peut accéder à la variable symbolique &FLOG qui contient le nom du dernier fichier journal utilisé avant basculement (fichier courant). FNAME = filename Nom du fichier journal. Il convient de veiller à ce que le fichier existe et soit accessible ; dans le cas contraire, les informations sortiront tronquées sur la sortie standard CFTOUT et ne seront pas exploitables. Ceci est également valable lorsque le journal courant est le fichier défini par AFNAME. Il est déconseillé d’utiliser un nom logique.

3-24

CFT V2.3

Manuel de référence

ID

= identifier Identifiant de la commande CFTLOG.

[LENGTH = {133 | n}] Taille des enregistrements du fichier journal.

{0..1024}

La valeur de ce paramètre est fournie dans les exemples livrés. Cette valeur n’a pas à être modifiée. [MAXREC = {0 | n}] {0..4294967295} Nombre d’enregistrements inscrits dans le fichier journal, à partir duquel le basculement automatique sera effectué. MAXREC=0 signifie qu’il n’y a pas de basculement automatique sur le nombre d’enregistrements du fichier. [NOTIFY = {voir le tableau | identifier}] Définit la destination des “messages opérateur” sélectionnés, parmi les messages du journal, par la valeur du paramètre OPERMSG. La valeur de ce paramètre est une chaîne de 8 caractères cadrée à gauche. La destination de ces messages peut être, suivant les systèmes : • le “submitter” du moniteur CFT correspondant à la sortie standard associée au moniteur CFT (l’écran de soumission, par exemple). La valeur du paramètre NOTIFY doit être alors renseignée à ‘ blancs),

’ (8 caractères

• une console opérateur. La valeur du paramètre NOTIFY doit commencer par les 2 caractères OP, • un utilisateur de la machine. La valeur du paramètre NOTIFY indique l’identifiant système de l’utilisateur selon le format “xxxxxxxx”. Le tableau suivant indique les destinataires possibles suivant le système. Tableau 34. CFTLOG NOTIFY - Destinataires possibles

CFT V2.3

OS

Submitter du moniteur

Console opérateur

Utilisateur quelconque

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

OUI OUI OUI NON OUI OUI NON NON OUI NON OUI

OUI OUI OUI OUI OUI OUI OUI OUI OUI OUI NON

OUI NON OUI OUI OUI OUI OUI OUI OUI NON NON

3-25

Les commandes de paramétrage de l’environnement du moniteur

Explications sur le contenu du tableau : “OUI” signifie que le type de destinataire correspondant existe. “NON” signifie que le type de destinataire correspondant n’existe pas. Le tableau suivant indique, pour le paramètre NOTIFY, les valeurs par défaut supportées pour chaque système. Tableau 35. CFTLOG NOTIFY - Valeurs par défaut OS

Valeur par défaut pour NOTIFY

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

OP ‘ ’ OPLOG OP ‘ ’ ‘ ’ OP OP OP ‘ ’ ‘ ’

Explications sur le contenu du tableau : la valeur ‘ ’ correspond à 8 caractères blancs. Dans le cas “console opérateur”, les choix possibles sont indiqués dans le tableau suivant. Tableau 36. CFTLOG NOTIFY - Choix possibles dans le cas «console opérateur» OS “console opérateur”

Caractères interprétés

Messages dirigés vers

GCOS7 GCOS8

OP

La console opérateur La console opérateur désignée par un numéro : • console TY1 • console TY2 • console TY3 • console TY4 La console opérateur La (ou les) console(s) opérateur(s) La “message-queue” QSYSOPR La console opérateur La machine opérateur La console système et le fichier LOG système périphérique de sortie identifié par le lien “xxxxxx” présent dans le répertoire courant d’exécution du moniteur La console système et le fichier LOG système périphérique de sortie identifié par le lien “xxxxxx” présent dans le répertoire courant d’exécution du moniteur La console opérateur

GUARDIAN MVS OS400 UNIX VM VMS

3-26

OP000001 OP000002 OP000003 OP000004 OP OP OP OP OP OPxxxxxx

VOS

OP ou OPxxxxxx

VSE WinNT

OP Sans objet

CFT V2.3

Manuel de référence

Explications sur le contenu du tableau : s’il est indiqué ‘OP’ pour les caractères interprétés, seuls ces 2 caractères (OP) sont interprétés ; les caractères suivants sont non significatifs. Dans le cas “utilisateur” : MVS

Les messages CFT sont émis par SEND à destination du USERID TSO précisé ; dans ce cas, le programme “Moniteur CFT” doit être autorisé (APF).

VMS

Les messages sont dirigés vers le “User VMS” désigné par son nom VMS. Dans ce cas, la tâche “moniteur CFT” doit posséder le privilège OPER.

VM

Les messages sont émis par ‘MSGNOH’ ou ‘MSG’ selon les privilèges accordés.

[OPERMSG ={voir le tableau | n} ] {0..255} Définit les catégories de messages d’information sur les transferts destinées à l’opérateur (tous les messages étant, par ailleurs, inscrits dans le fichier de journalisation). Il s’agit d’un sous-ensemble des messages du journal CFT, défini par la somme algébrique des valeurs indiquées dans la tableau ci-après. Tableau 37. Catégories des messages d’information sur les transferts Valeur

Catégorie de message

Type

1 2 4 7 16 32 64 128

Messages d’information d’exploitation Messages d’information système Messages d’attention d’exploitation Messages d’attention système Messages d’erreur d’exploitation Messages d’erreur système Messages d’erreur fatale d’exploitation Messages d’erreur fatale système

I I W W E E F F

Explications sur le contenu du tableau : les types I,W,E,F correspondent au type de message indiqué dans le journal (consultez le guide “Codes diagnostics et messages” de CFT). La valeur “0” signifie qu’aucun message n’est redirigé vers l’opérateur. Le tableau suivant indique, pour le paramètre OPERMSG, les valeurs par défaut supportées pour chaque système. Tableau 38. CFTLOG OPERMSG - Valeurs par défaut

CFT V2.3

OS

Valeur par défaut pour OPERMSG

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM

0 0 3 0 0 3 0

3-27

Les commandes de paramétrage de l’environnement du moniteur

Tableau 38. CFTLOG OPERMSG - Valeurs par défaut (suite) OS

Valeur par défaut pour OPERMSG

VMS VOS VSE WinNT

0 3 0 0

[SWITCH = {00000000 | time}] Heure à laquelle le moniteur CFT fait un basculement automatique. Lorsque ce paramètre n’est pas renseigné, il y a un basculement quotidien des fichiers journaux à minuit. Il convient de noter que les paramètres MAXREC et SWITCH peuvent être tous deux renseignés. Dans ce cas, le basculement automatique se fait : • tous les jours à l’heure indiquée, • sur le nombre d’enregistrements du fichier.

3.4.3. Exemple Cette commande définit les noms des fichiers journaux : CFTLOG ID = IDLOG, SWITCH = 2030, FNAME = filename1, AFNAME = filename2, EXEC = procfname, OPERMSG = 240 Le basculement automatique est prévu à 20 heures 30, la procédure déclenchée lors du basculement se trouve dans le fichier nommé par le paramètre EXEC. La taille des enregistrements est la valeur par défaut, c’est-à-dire 133 caractères. La valeur du paramètre OPERMSG permet de ne rediriger que les messages d’erreur vers l’opérateur (240 = 128+64+32+16).

3.5 CFTACCNT - Mode d’enregistrement des données statistiques La commande CFTACCNT permet de définir le mode d’enregistrement des données statistiques sur les transferts terminés correctement (état T ou X). Cette commande est prise en compte lorsque le paramètre ACCNT de la commande CFTPARM est renseigné. CFT n’autorise qu’un seul identifiant de type CFTACCNT.

3-28

CFT V2.3

Manuel de référence

Suivant les systèmes, il est possible d’utiliser 2 modes d’enregistrement : • l’enregistrement des données sur des fichiers du moniteur CFT. Dans ce cas, la commande CFTACCNT définit les noms des fichiers récepteurs des données et leur gestion (paramétrage TYPE = FILE). Ce mode est accessible sur TOUS LES SYSTEMES, • l’enregistrement des données sur les fichiers de l’utilitaire d’accounting du système d’exploitation concerné (paramétrage TYPE = SYST). GCOS7 MVS VM VSE

Ce mode n’est accessible que sur ces systèmes.

Le moniteur CFT enregistre, pour chaque transfert terminé, les informations contenues dans le tableau suivant (les descriptions des structures C et COBOL sont fournies en annexe). Tableau 39. CFTACCNT - Liste des rubriques Rubrique

Offset

Mode de transfert (Serveur ou Demandeur) Sens du transfert Type de transfert (Fichier, Message ou message de Réponse)

0 1 2

Identifiant du partenaire immédiat (PART) Identifiant de l’émetteur (SPART) Identifiant du récepteur (RPART) Identifiant de l’applicatif utilisateur émetteur (SUSER) Identifiant de l’applicatif utilisateur récepteur (RUSER)

3 12 21 30 46

Identifiant du fichier type (IDF) Identifiant de l’application locale (IDA) Identifiant du transfert (IDT)

62 71 80

Nombre d’enregistrements transmis Nombre de caractères du fichier Nombre de caractères émis sur la ligne

89 100 111

Date et heure de dépôt de la commande dans le catalogue Date et heure de début de transfert Date et heure de fin de transfert Durée du transfert (en secondes) Indicateur de liste de diffusion Identifiant du protocole applicatif Identifiant du propriétaire du transfert (USERID) Identifiant du groupe (GROUPID) Taux de compression des données en ligne Taille (maxi) de l’enregistrement du fichier (FLRECL) Format du fichier (FRECFM) Code de la compression protocolaire (NCOMP)

122 140 158 176 183 184 193 209 225 228 234 235

Nom du fichier transmis (FNAME)

238

CFT V2.3

3-29

Les commandes de paramétrage de l’environnement du moniteur

Tableau 39. CFTACCNT - Liste des rubriques (suite) Rubrique

Offset

Paramètre privé CFT (PARM)

303

Identifiant de l’applicatif émetteur (SAPPL) Identifiant de l’applicatif récepteur (RAPPL)

384 433

Groupe du partenaire (GROUP)

482 Total

491

TYPE=FILE

Lorsque le fichier “statistique CFT” est plein, c’est-à-dire lorsque le nombre maximum d’enregistrements (paramètre MAXREC) a été atteint, le moniteur CFT effectue un basculement sur un fichier alterné et exécute la procédure décrite par le paramètre EXEC. Par ailleurs, la commande d’exploitation SWITCH permet à l’opérateur de basculer manuellement le fichier statistique, à la demande. Le moniteur CFT doit disposer, à son activation, d’au moins 1 fichier statistique vide. Si le premier fichier (désigné par FNAME) n’est pas vide, il y a basculement vers le second (AFNAME). Par exemple, la procédure associée au basculement peut régénérer un fichier vide. Les fichiers statistiques doivent être créés par l’exploitation, avant l’activation du moniteur CFT (commande CFTFILE TYPE = ACCNT, ....). Lors de l’arrêt (commande SHUT), le moniteur CFT exécute aussi la procédure de basculement pour vider le dernier fichier statistique en cours. TYPE=SYST

La commande CFTACCNT référence l’application CFT auprès de l’utilitaire. GCOS7 MVS VM VM

Il faut renseigner le paramètre ACCID identifiant l’application CFT. L’enregistrement account est découpé en 8 cartes ACCOUNT.

VMS Les données sont de type “USER” sous le compte de CFT.

De par la structure des enregistrements de l’accounting système VMS, les données statistiques sont tronquées à 255 caractères. Il est donc déconseillé d’utiliser TYPE = SYST pour VMS .

3-30

CFT V2.3

Manuel de référence

3.5.1. Syntaxe CFTACCNT [MODE ID [LANGUAGE [TYPE

= = = =

{REPLACE | CREATE | DELETE},] identifier, {COBOL | C},] {FILE | SYST},]

= = = = =

filename, filename, n,] filename, {00000000 | time}]

=

n

TYPE=FILE

FNAME AFNAME [MAXREC EXEC [SWITCH TYPE=SYST

ACCID

OS

3.5.2. Paramètres ID

= identifier Identifiant de la commande CFTACCNT.

[LANGUAGE = {COBOL | C}] Langage de programmation de l’application exploitant les données statistiques enregistrées. En langage C, les données de chaque champ sont complétées avec des “zéros binaires”. En COBOL, elles sont complétées avec des “blancs”. [TYPE = { FILE | SYST}] Définit le type d’accounting. • TYPE = FILE : l’enregistrement des statistiques s’effectue sur les fichiers de CFT décrits par les paramètres FNAME et AFNAME, • TYPE = SYST : l’enregistrement des statistiques s’effectue sur fichier “système”, à travers une interface avec l’utilitaire d’accounting système. TYPE=FILE

AFNAME = filename Nom du fichier statistique alterné. EXEC = filename Nom de la procédure à exécuter lors d’un basculement sur l’autre fichier statistique (SWITCH). Cette procédure a accès à la variable symbolique &FACCNT qui contient le nom du dernier fichier statistique utilisé avant basculement.

CFT V2.3

3-31

Les commandes de paramétrage de l’environnement du moniteur

FNAME = filename Nom du fichier statistique. [MAXREC = n] Nombre maximum d’enregistrements du fichier statistique. Si ce paramètre n’est pas renseigné, le moniteur CFT ne connaît d’autre limite que celle imposée par le gestionnaire de fichier du système d’exploitation. [SWITCH = {00000000 | time}] Heure à laquelle le moniteur CFT fait un basculement automatique vers le fichier statistique alterné. Lorsque ce paramètre n’est pas renseigné, il y a un basculement quotidien des fichiers statistiques à minuit. TYPE=SYST

ACCID

=n

GCOS7 MVS VM

Identifiant d’enregistrement sur les fichiers d’accounting système. MVS

Valeur par défaut : 128. Ces données sont écrites dans SMF. Le programme CFT/MVS doit alors être autorisé (APF).

VM

La machine virtuelle CFT doit posséder l’option DIRECTORY ACCOUNT.

VSE

L’option accounting doit être définie dans POWER.

VMS

Paramètre non pertinent.

3.5.3. Exemples TYPE=FILE

CFTACCNT

ID = ACCNT, LANGUAGE = C, FNAME = , AFNAME = , MAXREC = 1000, EXEC = Cette commande définit l’enregistrement des données statistiques des transferts dans des fichiers propres à CFT. Elle désigne les fichiers statistique et statistique alterné (paramètres FNAME et AFNAME). Les données y sont enregistrées aux fins d’être exploitées par un programme applicatif écrit en langage C. Le basculement a lieu manuellement (commande SWITCH) ou lorsque le nombre d’enregistrements statistiques est égal à 1000. La procédure déclenchée lors d’un basculement se trouve dans le fichier désigné par le paramètre EXEC.

3-32

CFT V2.3

Manuel de référence

TYPE=SYST

CFTACCNT

ID TYPE ACCID

= = =

ACCNT, SYST, n

si

GCOS7 MVS VM

Cette commande définit l’enregistrement des données statistiques des transferts dans les fichiers de l’utilitaire d’accounting du système d’exploitation, sous un identifiant indiqué par le paramètre ACCID, pour les systèmes désignés.

CFT V2.3

3-33

4. Les commandes de paramétrage de l’environnement des transferts

4.1 CFTSEND - Descrip tion d’émission Les particularités du paramétrage associé à un fichier type en cas d’émission, à partir d’une base VFM, font l’objet d’une partie spécifique, en fin de paragraphe.

4.1.1. Paramètres associés à un fichier type Les commandes CFTSEND regroupent des paramètres contrôlant l’accès aux données à émettre et le déroulement des émissions. Une commande CFTSEND (commande “défaut” exceptée) contrôle l’émission du fichier type de même identifiant (IDF égal à l’ID de la commande CFTSEND). Elle est prise en compte dans l’un ou l’autre des deux cas d’émission, soit : • émission faisant suite à une demande explicite SEND IDF = ..., • émission mettant en oeuvre le mécanisme du “SEND implicite” ; ce mécanisme permet d’honorer automatiquement des demandes de réception transmises à l’improviste par un partenaire distant (mode serveur exclusivement). Si l’on veut couvrir les deux cas, pour un fichier type (IDF) donné, il faut prévoir deux commandes CFTSEND de même ID : • l’une comportant le paramètre IMPL = NO, • l’autre comportant IMPL = YES. Quant à la commande CFTSEND “défaut”, elle s’applique à tous les autres fichiers types en cas de SEND explicite : elle est prise en compte à chaque fois que l’IDF du SEND ne correspond à l’ID d’aucune commande CFTSEND comportant IMPL = NO. Dans un fichier source de paramétrage, pour plus de clarté, il est conseillé de regrouper toutes les commandes CFTSEND, en mettant la commande CFTSEND “défaut” soit en première, soit en dernière position. La commande CFTSEND permet de préciser, pour chaque fichier type (IDF) : • le nom et les caractéristiques physiques locales du fichier contenant les données à émettre. En début d’une émission, ces paramètres vont être exploités par CFT : -

d’une part, pour gérer l’accès aux données à émettre. En général, ici, on précise seulement des caractéristiques de fichier qui sont invariantes d’un transfert à l’autre et que CFT ne peut pas retrouver automatiquement.

CFT V2.3

4-1

Les commandes de paramétrage de l’environnement des transferts

Par exemple : lorsque c’est toujours le même nom de fichier physique local qui est associé au fichier type (IDF), il est logique de préciser ce nom en faisant figurer un paramètre FNAME dans la commande CFTSEND, -

d’autre part, en tant que valeurs par défaut pour les caractéristiques “réseau” du fichier, si ces dernières ne sont pas précisées explicitement (voir ci-dessous),

• les caractéristiques “réseau” du fichier : valeurs qu’on va transmettre au correspondant, dans les paramètres protocolaires, pour décrire le fichier (un nom physique de fichier peut même être transmis - voir plus loin la définition du “mode ouvert”). Les caractéristiques physiques que CFT peut retrouver automatiquement pour le fichier local, peuvent être considérées comme des valeurs par défaut pour les paramètres de CFTSEND correspondants (exemple : longueur d’enregistrement locale : FLRECL), paramètres constituant eux-mêmes des valeurs par défaut pour les caractéristiques réseau (exemple : longueur d’enregistrement transmise au correspondant : NLRECL). Par ailleurs, lorsque le transfert est déclenché par une commande SEND locale comportant explicitement un ou plusieurs paramètres qui figurent également dans la commande CFTSEND, suivant la valeur du paramètre FORCE : -

si FORCE = NO : ce sont ceux de la commande SEND qui priment sur ceux de la commande CFTSEND (pour tous les paramètres communs aux deux commandes, CFTSEND ne fournit que les valeurs par défaut à SEND),

-

si FORCE = YES : ce sont ceux de la commande CFTSEND qui priment sur ceux de la commande SEND,

• certaines actions à effectuer localement : -

appel lors du transfert à une tâche “EXIT fichier” écrite par l’utilisateur,

-

action sur les données gérées par le moniteur pendant le transfert : transcodage, compression,

-

action exécutée par le moniteur sur le fichier émis, après le transfert,

-

appel à une procédure à exécuter en fin de transfert, ...

• divers paramètres contrôlant l’exécution des transferts, entre autres : -

plage horaire autorisée,

-

id. d’utilisateur associé par défaut aux transferts.

4.1.1.1. Syntaxe CFTSEND

4-2

ID = [COMMENT [CYCDATE= [CYCLE = [CYCTIME = [DELETE = [EXEC = [EXECSUB = [EXIT = [FACTION =

identifier, = string,] date,] {0 | n},] time,] {NO | YES},] filename,] { LIST | FILE}] identifier,] {NONE | ERASE | DELETE},]

[FBLKSIZE =

n,]

OS

CFT V2.3

Manuel de référence

[FCODE [FDISP

= =

{ ASCII | BINARY | EBCDIC},] {SHARE | OLD},]²

[FKEYLEN = {0 | n},] [FKEYPOS = {0 | n},]

PROTOCOLE

[FLRECL [FNAME [FORCE

= = =

n,] {filename | mask | dirname | #filename | #mask | #dirname},] {NO | YES},]

[FORG

=

{SEQ | INDEXED | DIRECT},]

[FRECFM =

{F | V | U},]

[FSPACE

=

n,]

[FTYPE

=

c,]

[GROUPID = [IMPL = [MAXDATE [MAXTIME= [MINDATE = [MINTIME = [MODE =

[NCODE [NCOMP [NFNAME

= {ASCII | BINARY | EBCDIC},] =

cpr,]

= {filename | *filename],]

[FKEYLEN = {0 | n},] [FKEYPOS = {0 | n},] [NLRECL [NOTIFY

OS OS

OS

string,] {NO | YES},] = {voir commentaire | date},] {23595999 | time},] {date système du jour | date},] {00000000 | time},] {REPLACE | CREATE | DELETE},]

[NBLKSIZE = n,]

= =

[NRECFM =

CFT V2.3

PROTOCOLE

PROTOCOLE PROTOCOLE

OS

PROTOCOLE PROTOCOLE PROTOCOLE PROTOCOLE

n,] identifier,] {F | U | V},]

[NSPACE

= n,]

[NTYPE

= c,]

[OPERMSG =

n,]

[PARM

=

string,]

[PRI

=

{128 | n},]

[RAPPL

=

string,]

PROTOCOLE

OS

PROTOCOLE

OS

PROTOCOLE

PROTOCOLE

4-3

Les commandes de paramétrage de l’environnement des transferts

[RUSER

=

string,]

[SAPPL

=

string,]

[SELFNAME = [STATE =

filename] {DISP | HOLD | KEEP},]

[SUSER

string,]

=

PROTOCOLE PROTOCOLE

PROTOCOLE

[TCYCLE =

{DAY | MIN | MONTH},]

[TRK [USERID [WFNAME [XLATE

{UNDEFINED | ALL | SUMMARY | NO},] {“userid du moniteur CFT” | string,] filename,] identifier,]

= = = =

4.1.1.2. Synthèse des paramètres Ces paramètres peuvent être classés selon les catégories suivantes : • protection des paramètres valorisés

: FORCE,

• paramètres d’identification : –

généraux

: ID, USERID, GROUPID,

–

liés au protocole PeSIT (profil SIT, PeSIT D profil CFT ou PeSIT E) : RAPPL, SAPPL,

–

liés au protocole PeSIT (PeSIT D profil CFT ou PeSIT E)

: RUSER, SUSER,

• paramètres libres pour l’utilisateur CFT : –

transmis au récepteur

: PARM, SPART,

–

d’utilisation locale

: COMMENT, OPERMSG, DELETE, NOTIFY,

• paramètres de contrôle d’exécution : –

généraux

: IMPL, STATE, PRI,

–

utilisateur

: EXEC, EXIT,

–

gestion d’échéancier

: MINDATE, ...TCYCLE,

• paramètres de traitement des données

: NCOMP, XLATE,

• paramètres associés au fichier émis :

4-4

–

gestion du fichier

: FACTION,

–

nom physique

: FNAME,

–

caractéristiques physiques (fichier global)

: FSPACE, FORG, FTYPE, FCODE, FDISP,

–

caractéristiques physiques (enregistrements)

: FRECFM, FLRECL, FBLKSIZE,

CFT V2.3

Manuel de référence

• paramètres du fichier pour le partenaire (selon protocole) : –

nom physique

: NFNAME,

–

caractéristiques physiques (fichier global)

: NSPACE, NTYPE, NCODE,

–

caractéristiques physiques (enregistrements)

: NRECFM, NLRECL, NBLKSIZE, NKEYLEN, NKEYPOS.

Concernant les paramètres du fichier pour le partenaire (Nxxxxx de SEND et CFTSEND) : • ceux-ci sont tous d’emploi facultatif, • ils permettent de forcer les valeurs des informations transmises - nom et/ou caractéristiques physiques de fichier - lorsque celles-ci sont prévues dans les unités de message (FPDUs) du protocole utilisé (ou du profil de protocole utilisé), • ces informations sont exploitées par le moniteur récepteur selon ses possibilités propres : –

si celui-ci est un moniteur CFT/V2 : voir la description de ces possibilités au niveau de la commande CFTRECV et dans le “Guide d’exploitation” spécifique concerné,

–

dans tous les cas : les valeurs émises doivent être valides pour le partenaire récepteur.

4.1.1.3. Paramètres [COMMENT

= string160]

Commentaire alphanumérique local associé à l’émission. Le contenu de ce paramètre : • n’est ni analysé, ni exploité lors des transferts, • peut être consulté en local à partir de la commande LISTCAT CONTENT=FULL, • est restitué à partir de la variable symbolique &COMMENT. [CYCDATE

= {voir le commentaire | date}]

Jour limite supérieure d’activation du premier transfert d’un échéancier. Si la périodicité est journalière ou plus (TCYCLE = DAY ou TCYCLE = MONTH), alors la valeur par défaut de CYCDATE est MINDATE + TCYCLE*CYCLE ; sinon, cette valeur est CYCDATE = MINDATE. Exemple : si TCYCLE = DAY et CYCLE = 2, la valeur par défaut de CYCDATE est MINDATE + 2 jours. CYCLE

= {0 | n}

{0..32767}

Nombre d’unités définissant la période du cycle de transfert.

CFT V2.3

4-5

Les commandes de paramétrage de l’environnement des transferts

[CYCTIME

= {voir commentaire | time}]

Heure limite supérieure d’activation du premier transfert d’un échéancier. Pour les transferts suivants, la date/heure limite est calculée comme suit : CYCDATE.CYCTIME + CYCLE * TCYCLE (valeur de la période). Si la périodicité est exprimée en minutes (TCYCLE = MIN), alors la valeur par défaut de CYCTIME est : MINTIME + TCYCLE*CYCLE ; sinon, CYCTIME = MINTIME. Exemple : si TCYCLE = MIN et CYCLE =60, la valeur par défaut de CYCTIME est MINTIME + 1 heure. [DELETE

= {NO | YES}]

Suppression automatique des postes du catalogue en état ‘T’ (terminé) pour l’IDF correspondant. Si l’utilisateur spécifie des procédures de fin de transfert (paramètres EXECSF et EXECRF de CFTPARM), cette suppression n’intervient qu’après l’exécution de ces procédures. Si la commutation des fichiers est demandée (par le biais du paramétrage CFT), aucun des postes du catalogue, associé à des transferts terminés, n’est supprimé. [EXEC

= filename]

Nom du fichier décrivant la procédure à exécuter en fin de transfert. Permet d’associer cette procédure à un identifiant de fichier type (IDF), autrement qu’en mettant la variable symbolique &IDF au niveau du paramètre EXECSF de CFTPARM. Les variables symboliques possibles dans “filename” et dans la procédure associée, ou dans l’ensemble des procédures associées, sont les mêmes que celles autorisées pour les procédures de fin de transfert référencées dans CFTPARM (consultez le paragraphe “Variables symboliques” dans le guide “Concepts”). Si ce paramètre EXEC est renseigné et : • si le fichier correspondant à “filename” existe, la procédure associée est soumise en fin de transfert, • si le fichier n’existe pas, aucun traitement n’est exécuté en fin de transfert (même si le paramètre EXECSF de la commande CFTPARM est renseigné). Si ce paramètre EXEC n’est pas renseigné, c’est le paramètre EXECSF de la commande CFTPARM qui est pris en compte. [EXECSUB

= {LIST | FILE}]

Soumission de la procédure de fin de transfert, lors de l'émission d'un groupe de fichiers en milieu hétérogène :

4-6

• LIST

: déclenchement de la procédure de fin de transfert sur la requête générique, à la fin de tous les transferts de la liste,

• FILE

: déclenchement de la procédure de fin de transfert pour chaque requête de la liste et sur la requête générique.

CFT V2.3

Manuel de référence

[EXIT

= identifier]

Identifiant de la commande CFTEXIT associée à ce transfert. Utilisé pour activer une tâche utilisateur d’EXIT fichier. La valeur de ce paramètre peut être égale à la variable symbolique &IDF. [FACTION

= {NONE | DELETE | ERASE}]

Action sur le fichier après émission : • ERASE:

effacement du contenu du fichier après le transfert (marque “End Of File” en début de fichier),

• DELETE :

destruction du fichier après transfert,

• NONE :

aucune action sur ce fichier en fin de transfert.

Attention : dans le cas d’une émission de répertoire ou de groupe de fichiers, si la commande d’émission précise FACTION = DELETE, ce paramètre est ignoré. Aucun répertoire ou fichier ne sera détruit à l’issue du transfert générique. [FBLKSIZE

=n]

{0..32768}

OS

Taille des blocs du fichier émis. Il est recommandé de ne pas renseigner ce paramètre car CFT sait en trouver la valeur pour le fichier à émettre. C’est alors cette valeur (réelle) qui sera prise en compte à l’activation du transfert. Tableau 40. CFTSEND FBLKSIZE - OS concernés OS

Utilisation

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

OUI OUI NON OUI NON NON NON NON NON OUI NON

[FCODE

= { ASCII | BINARY | EBCDIC}]

Code des données à émettre. La valeur par défaut, déterminée suivant les caractéristiques de chaque transfert, est fonction du type (FTYPE) de fichier émis (si nécessaire, consultez le “Guide d’exploitation” CFT correspondant à votre OS). La détection automatique du FTYPE par l’émetteur, le cas échéant, tient lieu (en partie) de détection automatique de code. Sur l’influence de FCODE sur le transcodage effectué à l’émission : voir les explications fournies au niveau du paramètre NCODE de la présente commande.

CFT V2.3

4-7

Les commandes de paramétrage de l’environnement des transferts

[FDISP

= {SHARE | OLD}]

Option de partage du fichier : • SHARE : accès partagé, • OLD : accès exclusif. [FKEYLEN

= {0 | n}]

PeSIT E

Longueur de la clé d’un fichier indexé. Le moniteur transmet cette information, transportée par le protocole dans le PI 38, mais ne l’exploite pas. Le fichier indexé est transféré sous forme d’enregistrements séquentiels. [FKEYPOS

= {0 | n}] PeSIT E

Position relative à 0 de la clé dans l’article d’un fichier indexé.

Le moniteur transmet cette information, transportée par le protocole dans le PI 39, mais ne l’exploite pas. Le fichier indexé est transféré sous forme d’enregistrements séquentiels. [FLRECL

= n]

Pour des enregistrements de : • format fixe (FRECFM = F) :

longueur (en octets) des enregistrements du fichier local à émettre,

• format variable (FRECFM = V):

longueur maximale (en octets) des enregistrements de ce fichier,

• format indéfini (FRECFM = U) :

longueur maximale (en octets) des enregistrements de ce fichier.

L’emploi de FLRECL est facultatif. En effet, la plupart des produits CFT/V2 sont capables, lors des transferts, de retrouver automatiquement les longueurs d’enregistrement des fichiers à émettre : • les guides d’exploitation spécifiques précisent, pour chaque système, si cette fonctionnalité est supportée, • certains systèmes, en remplacement de cette fonctionnalité, génèrent des longueurs d’enregistrement implicites : WinNT

UNIX

VOS

4-8

Longueur implicite = 512 Longueur implicite = 512 pour les fichiers texte (FTYPE=T, O ou X), = 4096 pour les fichiers binaires (FTYPE=B). Longueur implicite = 2048. FRECFM = F : toujours préciser FLRECL. FRECFM = V : préciser FLRECL quand la longueur d’enregistrement est susceptible de dépasser 2048.

CFT V2.3

Manuel de référence

[FNAME

= {filename | mask | dirname | #filename | #mask | #dirname}]

Nom du fichier local à émettre, nom de répertoire, nom de fichier d’indirection, masque de sélection ou répertoire de sélection. Le nom du fichier d’indirection, du masque de sélection ou du répertoire de sélection est précédé du caractère spécifique à chaque système. Dans la plupart des environnements, c’est le ‘#’ qui est utilisé (consultez le tableau des valeurs spécifiques dans le “Guide d’exploitation” de CFT correspondant à votre OS). En fonctionnement serveur émetteur avec émission implicite, le paramètre FNAME est d’usage obligatoire dans CFTSEND. En fonctionnement demandeur émetteur ou serveur émetteur avec requête de transfert “holdée”, le nom du fichier peut être précisé dans la requête d’émission (commande SEND ou appel à CFTAPI) plutôt que dans la commande CFTSEND. Tableau 41. CFTSEND FNAME - Récapitulatif des différents cas Cas

Format

Traitement

1

FNAME = filename

Envoi d’un fichier ou d’une version de fichier

2

FNAME = {mask | dirnam}

Listage d’un répertoire

3

FNAME = #filename

Envoi d’un groupe de fichiers dont la liste se trouve dans le fichier fourni

4

FNAME = {#mask | #dirname}

Envoi d’un groupe de fichiers après sélection sur le nom générique fourni (#mask) Envoi de tous les fichiers contenus dans le répertoire (#dirname)

Cas 1 : nom du fichier local à émettre (FNAME=filename) Ce nom est un nom complet de fichier physique. Il peut : • être constitué dynamiquement à partir de variables symboliques, • correspondre au nom d’un fichier à versions. Utilisation des variables symboliques Les variables utilisables pour la constitution de la chaîne de caractères FNAME sont les suivantes : • &FDATE, &FTIME, &FYEAR, &FMONTH, &FDAY, • &SPART, &RPART, &PART, &NPART, &GROUP, • &SUSER, &RUSER, • &SAPPL, &RAPPL, • &IDF, &PARM, &IDA, • &NIDF, &IDTU, • &BDATE, &BTIME, &BYEAR, &BMONTH, &BDAY, • &NFNAME, &NFVER (explicitées plus en détail ci-dessous).

CFT V2.3

4-9

Les commandes de paramétrage de l’environnement des transferts

Les variables se trouvant sur les deux dernières lignes sont valorisées juste avant le transfert. Or, les substitutions dans la chaîne FNAME s’effectuant lors de l’enregistrement de la requête dans le catalogue, ces variables ne peuvent donc être utilisées dans FNAME qu’en cas de SEND implicite. Le caractère ‘&’ remplace ici le caractère char_symb spécifique à chaque système d’exploitation (consultez le “Guide d’exploitation” de CFT correspondant à votre OS). Cas particulier de la variable symbolique &NFNAME

PeSIT D profil CFT PeSIT E CFT/CFT

L’emploi de &NFNAME n’est valide que si le moniteur est serveur émetteur et l’émission implicite (CFTSEND IMPL=YES). Dans ce cas, il est possible de prendre en compte à chaque transfert, le nom de fichier physique proposé par le partenaire demandeur récepteur. Remarque: lorsque le fichier émis est exactement celui que demande le partenaire (paramétrage FNAME=&NFNAME), on est dans le mode de fonctionnement dit mode ouvert. MVS

Emission d’un fichier à versions

VMS

Ce nom comporte une racine et un numéro de version. Suivant le cas, la traduction du nom relatif en nom absolu s’effectue à des étapes différentes. Tableau 42. CFTSEND FNAME - Fichier à versions Commande

Numéro de version

Paramètre

Traduction en nom absolu

CFTSEND

seulement à 0 ou -n

IMPL=YES

Au démarrage du transfert Au dépôt de la requête dans le catalogue Au dépôt de la requête dans le catalogue

IMPL=NO SEND

– à 0 ou à -n – cas particulier de MVS (1)

FNAMEABS=YES FNAMEABS=NO

Au démarrage du transfert

Explications sur le contenu du tableau : (1) le numéro de version peut être à +1 ou + n et le paramètre FNAMEABS doit être à YES. La rotation d’un fichier GDG s’effectue en fin de job. MVS

Exemple de fichier à versions : la notation de la version du fichier dans l’étape ”SEND” reste identique à la dernière notation utilisée dans le JCL.

4-10

//ST1

EXEC

PGM=USER

//DD1

DD

DSN=FIC(+1)

//ST4

EXEC

PGM=CFTX

SEND

FNAME=FIC(+1)

CFT V2.3

Manuel de référence

VMS

L’exemple de fichier à versions précédent est aussi applicable si la valeur de DSN et FNAME est FIC;1. Cas particulier de la variable symbolique &NFVER L’emploi de &NFVER n’est valide que si le moniteur est serveur émetteur et l’émission implicite (CFTSEND IMPL=YES). Dans ce cas, il est possible d’émettre la version de fichier demandée par le partenaire. Il suffit de paramétrer, par exemple, FNAME=GDGNAME(-&NFVER). Cas 2 : listage d’un répertoire FNAME {dirname | mask} Le nom fourni peut être un nom générique de fichier ou un nom de répertoire. Ce nom peut inclure : • certaines variables symboliques telles que &PART et &IDF, • les méta-caractères * et ?. Ce mode permet, par exemple, d’envoyer au partenaire le listage d’un répertoire local. Dans ce cas, chaque enregistrement transféré contient le nom de chaque fichier sélectionné. Pour une information complémentaire, consultez le paragraphe ”Listage d’un répertoire distant” dans le manuel ”Concepts”. Cas 3 : envoi d’un groupe de fichiers dont la liste se trouve dans le fichier fourni FNAME =#filename Le nom fourni est un nom complet de fichier physique. Ce fichier contient la liste des fichiers à émettre (liste de noms de fichiers physiques), à raison d’un nom par enregistrement. La valeur de FNAME peut être constituée de certaines variables symboliques telles que &PART et &IDF. Le nom du fichier d’indirection est précédé du caractère spécifique à chaque système. Dans la plupart des environnements, c’est le ’#’ qui est utilisé (consultez le tableau des valeurs spécifiques dans le ”Guide d’exploitation” de CFT correspondant à votre système d’exploitation). Un poste catalogue est créé pour chaque fichier. Le transfert de chacun des fichiers s’effectue selon les mêmes modalités qu’un transfert en émission habituel. Pour une information complémentaire, consultez l’annexe “Emission d’un groupe de fichiers” dans le manuel “Concepts” de CFT. Cas particulier : il est possible de renseigner une liste de répertoires à émettre dans le fichier d’indirection. Le critère de mise en œuvre de copie/concaténation pour chaque répertoire transmis est identique aux autres modes de transmission générique. Il est fortement déconseillé de remplir un fichier d’indirection avec un ensemble mixte de fichiers et de répertoires.

CFT V2.3

4-11

Les commandes de paramétrage de l’environnement des transferts

Cas 4 : envoi d’un groupe de fichiers après sélection (FNAME={#mask | #dirname}) PeSIT D profil CFT

PeSIT E profil CFT/CFT

Le nom fourni peut être un nom générique de fichier ou un nom de répertoire. Ce nom peut inclure : • certaines variables symboliques telles que &PART et &IDF, • les méta-caractères * et ?. Le nom de répertoire représente ici toute organisation, spécifique à l’environnement concerné, servant à regrouper les fichiers : bibliothèque, catalogue, PDS …. La sélection du groupe de fichiers à transférer s’effectue dynamiquement à partir du nom générique ou du nom de répertoire. Suivant les systèmes d’exploitation, le mécanisme de sélection est le résultat d’un listage de répertoire ou équivalent. Si l’émission s’effectue vers un site homogène (valeur de SYST de la commande CFTPART identique au système local), les fichiers sélectionnés sont copiés et concaténés dans un fichier de travail (voir paramètre WFNAME) défini dans la commande d’émission. Deux postes sont créés dans le catalogue : un poste générique et un poste de transfert. Si l’émission s’effectue vers un site hétérogène, un poste générique est créé dans le catalogue ainsi qu’un poste de transfert pour chaque fichier sélectionné. Pour une information complémentaire, consultez l’annexe “Emission d’un groupe de fichiers” dans le guide “Concepts” de CFT. [FORCE

= {NO | YES}]

Détermination de la priorité de prise en compte des paramètres valorisés dans CFTSEND et par rapport à ceux valorisés dans une commande SEND associée. • FORCE = NO : les paramètres spécifiés dans la commande SEND sont prioritaires par rapport à ceux définis dans la commande CFTSEND associée. Ainsi, si un paramètre n’est pas explicitement renseigné dans SEND mais dans CFTSEND, c’est la valeur renseignée dans cette commande CFTSEND qui sera prise en compte, • FORCE = YES : les paramètres spécifiés dans CFTSEND sont prioritaires par rapport à ceux définis dans une commande SEND associée. Ainsi, si un paramètre n’est pas explicitement renseigné dans CFTSEND mais dans SEND ou si la valeur renseignée dans CFTSEND est la valeur par défaut, c’est la valeur renseignée dans cette commande SEND qui sera prise en compte. Un message informera l’utilisateur que sa commande est partiellement prise en compte.

4-12

CFT V2.3

Manuel de référence

[FORG

= {SEQ | DIRECT | INDEXED}]

OS

Organisation du fichier à émettre : • SEQ

: séquentielle,

• INDEXED

: indexée,

• DIRECT

: relative (accès direct).

Sur certains systèmes d’exploitation, il est possible d’émettre en séquentiel des fichiers d’organisation indexée ou relative. Suivant le cas, l’emploi de paramètres tels que FTYPE, FKEYLEN, FKEYPOS et FORG peut être nécessaire. Pour une information complémentaire, consultez le “Guide d’exploitation” CFT correspondant à votre OS. [FRECFM

= {voir “Guide d’exploitation” | F | U | V}]

OS

Format des enregistrements du fichier à émettre : • F : fixe, • V : variable, • U : indéfini (“undefined”). Les valeurs possibles par système sont indiquées dans le “Guide d’exploitation” spécifique correspondante. OS400

UNIX

La notion de format variable est propre à CFT, et ne correspond pas à une réalité pour les systèmes indiqués. Le moniteur CFT ne pourra donc émettre un fichier de format variable que si celui-ci est généré par une commande COPYFILE, ou déjà reçu par CFT (cas de la commutation par exemple). Sauf exception, on n’utilisera pas FRECFM = V.

Consultez le “Guide d’exploitation” de CFT correspondant à votre OS. [FSPACE

= n]

Taille du fichier à émettre, en K-octets (1 K-octet = 1024 octets). Usuellement, ce paramètre n’a pas à être renseigné, CFT retrouvant automatiquement, lors de chaque transfert, la taille du fichier qu’il va émettre (si nécessaire, vérifier dans le “Guide d’exploitation” de CFT correspondant à votre OS que cette fonctionnalité est bien supportée par le système considéré). [FTYPE

= {voir “Guide d’exploitation” | c}]

OS

Type du fichier local à émettre (voir également le paramètre NTYPE). Dans certaines configurations de type client/serveur, le fichier local peut être physiquement implanté sur une autre machine que celle sur laquelle CFT s’exécute. Consultez le “Guide d’exploitation” de CFT correspondant à votre OS. [GROUPID

= string15]

Information complétant le USERID de la commande CFTSEND.

CFT V2.3

4-13

Les commandes de paramétrage de l’environnement des transferts

ID

= identifier Identifiant local de fichier type (IDF) à émettre. PeSIT profil SIT

[IMPL

En protocole PeSIT profil SIT, l’identifiant de fichier type est soumis à la contrainte de format (Fnnnnn) décrite dans le “Guide des protocoles” de CFT.

= {NO | YES}]

Emission implicite. Lorsque CFT fonctionne en mode serveur émetteur et qu’il n’y a pas de commande SEND (state=HOLD) déposée dans le catalogue pour cet identifiant de fichier, le paramètre IMPL valorisé à “YES” permet au moniteur CFT de mettre à disposition le fichier correspondant, en générant automatiquement une requête d’émission. Ceci permet une mise à disposition permanente d’un fichier. Attention : ce paramètre ne doit pas être égal à “YES” pour la description du fichier type par défaut. [MAXDATE = {voir le commentaire | date}]

Pris en compte uniquement en mode demandeur

Dernier jour de validité des transferts. La valeur ‘date’ peut être exprimée : • explicitement (date absolue), • ou dans les commandes SEND, d’une manière relative par rapport à la date de prise en compte de la commande. Cette valeur est alors exprimée en nombre de jours. Exemple : MAXDATE = +4 signifie que le dernier jour de validité du transfert est dans 4 jours par rapport à la date de prise en compte de la commande. La valeur par défaut est affectée par le moniteur selon le contexte du transfert. Si MAXTIME est supérieur à MINTIME, MAXDATE prend la valeur de MINDATE. Si MAXTIME est inférieur à MINTIME, MAXDATE prend la valeur de MINDATE + 1. Si MAXTIME n’est pas renseigné, MAXDATE prend la valeur “99991231”. Consultez le paragraphe “Transferts différés” dans le guide “Concepts” de CFT. [MAXTIME

= {23595999 | time}]

Pris en compte uniquement en mode demandeur

Heure maximum de validité du transfert, pour le dernier jour (MAXDATE). La valeur ‘time’ peut être exprimée : • explicitement (heure absolue), • ou dans les commandes SEND, d’une manière relative par rapport à l’heure de prise en compte de la commande.

4-14

CFT V2.3

Manuel de référence

Dans ce cas, l’heure absolue correspondante doit être inférieure à 24 heures. La valeur indiquée est exprimée en minutes. Exemple : MAXTIME = +180 signifie que l’heure maximum de validité du transfert est l’heure de prise en compte de la commande additionnée de 180 minutes. Cette heure de prise en compte doit être inférieure à 21 heures. MAXTIME ne doit pas être égal à MINTIME sauf si MAXDATE est renseigné et n’est pas la date du jour. [MINDATE

= {date système du jour | date}]

Pris en compte uniquement en mode demandeur

Premier jour de validité des transferts. La valeur ‘date’ peut être exprimée : • explicitement (date absolue), • ou dans les commandes SEND, d’une manière relative par rapport à la date de prise en compte de la commande. Cette valeur est alors exprimée en nombre de jours. Exemple : MINDATE = +2 signifie que le premier jour de validité du transfert est dans 2 jours par rapport à la date de prise en compte de la commande. Consultez le paragraphe “Transferts différés” dans le guide “Concepts” de CFT. [MINTIME

= {00000000 | time}]

Pris en compte uniquement en mode demandeur

Heure minimum de validité du transfert, pour le premier jour. La valeur ‘time’ peut être exprimée : • explicitement (heure absolue), • ou dans les commandes SEND, d’une manière relative par rapport à l’heure de prise en compte de la commande. Dans ce cas, l’heure absolue correspondante doit être inférieure à 24 heures. La valeur indiquée est exprimée en minutes. Exemple : MINTIME = +30 signifie que l’heure minimum de validité du transfert est l’heure de prise en compte de la commande additionnée de 30 minutes. Cette heure de prise en compte doit être inférieure à 23 h 30. MINTIME ne doit pas être égal à MAXTIME sauf si MAXDATE est renseigné et n’est pas la date du jour.

CFT V2.3

4-15

Les commandes de paramétrage de l’environnement des transferts

[NBLKSIZE

= {valeur de FBLKSIZE | n}]

PeSIT D profil CFT

PeSIT E CFT/CFT OS

Taille de bloc du fichier, au sens protocolaire. Peut être utilisé pour un transfert vers un partenaire dont le système gère la notion de taille de bloc (la liste de ces systèmes est indiquée au paramètre FBLKSIZE). [NCODE

= {voir le commentaire | ASCII | BINARY | EBCDIC}]

PeSIT sauf profil SIT

Code des données émises. Valeur par défaut : au niveau de la commande CFTSEND elle-même, il n’y a pas de valeur par défaut mais, pour chaque transfert, NCODE prend implicitement comme valeur soit : • BINARY, si FCODE vaut (explicitement ou implicitement) BINARY, • le code de la machine du partenaire, si FCODE a une valeur différente de BINARY ; le code (ASCII ou EBCDIC) de la machine du partenaire est alors déduit de la valeur du paramètre SYST de la commande CFTPART. NCODE, avec les paramètres FCODE et XLATE, détermine le transcodage fait lors d’une émission. Que les valeurs soient explicites ou bien déterminées implicitement : • si FCODE ou NCODE est égal à BINARY, il n’y a pas de transcodage, • sinon (les données locales et les données en ligne étant supposées codées en ASCII ou en EBCDIC) : -

si NCODE est égal à FCODE, il ne peut y avoir transcodage ASCII/ASCII ou EBCDIC/EBCDIC qu’avec une table de transcodage externe (voir l’emploi du paramètre XLATE),

-

si NCODE est différent de FCODE, il y a toujours transcodage ASCII/EBCDIC ou EBCDIC/ASCII, que ce soit avec une table de transcodage externe ou bien grâce à la table de transcodage interne de CFT.

Il n’y a qu’en protocole PeSIT (si le profil est différent de “SIT”) que CFT peut émettre un paramètre (un indicateur) protocolaire “code des données” ; ce paramètre correspond alors à NCODE. Pour les autres protocoles, le partenaire récepteur suppose a priori que les données sont codées conformément aux conventions protocolaires. Par exemple, en ETEBAC 3, il s’attend à recevoir des données en EBCDIC. Pour une information complémentaire, consultez le “Guide des protocoles” de CFT. [NCOMP

= {voir le commentaire | cpr}]

Tous protocoles SAUF PeSIT profil SIT

Compression des données en ligne, souhaitée par l’émetteur. Les valeurs autorisées ainsi que les valeurs par défaut, pour le paramètre NCOMP de la commande CFTSEND, sont les mêmes que pour le paramètre SCOMP de la commande CFTPROT. Lors d’une émission, la combinaison des valeurs prises par ces deux paramètres, sert de base à la négociation protocolaire de la compression des données en ligne (consultez l’annexe “Compression” pour des informations complémentaires).

4-16

CFT V2.3

Manuel de référence

PeSIT D profil CFT

PeSIT D profil EXTERN

PeSIT E

ODETTE

[NFNAME

= {filename | *filename}]

Ce paramètre n’a lieu d’être utilisé qu’en cas de transferts en protocole PeSIT (avec le profil ou la version indiquée), lorsque la valeur du paramètre SCOMP de la commande CFTPROT est excessive pour le fichier type considéré. Ce paramètre sert à inhiber éventuellement la compression lors d’une émission consécutive à une phase de connexion, laquelle la compression a été négociée à 1 (SCOMP et/ou RCOMP de CFTPROT à 1).

PeSIT D profil CFT

PeSIT E CFT/CFT

Nom du fichier physique communiqué au correspondant récepteur. Le caractère “*” précédant le nom du fichier indique au récepteur qu’il peut choisir d’utiliser ou non le nom de fichier transmis. Le nom du fichier physique peut : • être constitué dynamiquement à partir de variables symboliques, • correspondre au nom d’un fichier à versions. Le transfert aboutit si les conditions suivantes sont remplies : • le partenaire récepteur autorise le site émetteur (demandeur ou serveur) à forcer le nom physique du fichier à recevoir (ce nom est défini à partir d’un paramétrage tel que FNAME=&NFNAME), • le fichier désigné par NFNAME existe ou peut être créé côté récepteur, • le numéro de version du fichier GDG correspond au numéro de version +1 du fichier récepteur. Pour une information complémentaire sur les mécanismes mis en oeuvre, consultez l’annexe “Localisation des fichiers physiques” dans le guide “Concepts” de CFT. Utilisation des variables symboliques

MVS

VMS

Les variables utilisables pour la constitution de la chaîne de caractères NFNAME sont les suivantes : • &FDATE, &FTIME, &FYEAR, &FMONTH, &FDAY, • &SPART, &RPART, &PART, &NPART, &GROUP, • &SUSER, &RUSER, • &SAPPL, &RAPPL, • &IDF, &PARM, &IDA, • &NIDF, • &BDATE, &BTIME, &BYEAR, &BMONTH, &BDAY. Le caractère ’&’ remplace ici le caractère char_symb spécifique à chaque système d’exploitation (consultez le “Guide d’exploitation” de CFT correspondant à votre OS).

CFT V2.3

4-17

Les commandes de paramétrage de l’environnement des transferts MVS

Emission d’un fichier à versions

VMS

Ce nom comporte une racine et un numéro de version. [NKEYLEN

= {valeur de FKEYLEN | n}]

PeSIT E

Longueur (en octets) de la clé d’un fichier indexé. Le moniteur transmet cette information, transportée par le protocole dans le PI 38, mais ne l’exploite pas. Le fichier indexé est transféré sous forme d’enregistrements séquentiels. [NKEYPOS

= {valeur de FKEYPOS | n}]

PeSIT E

Position (en octet) de la clé dans l’article d’un fichier indexé. Le moniteur transmet cette information, transportée par le protocole dans le PI 39, mais ne l’exploite pas. Le fichier indexé est transféré sous forme d’enregistrements séquentiels. [NLRECL

= {valeur de FLRECL | n}]

Pour des enregistrements : • de format fixe (FRECFM = F) :

taille en octets des enregistrements du fichier récepteur,

• de format variable (FRECFM = V) :

taille maximale en octets des enregistrements.

Lors d’une émission, tout enregistrement envoyé de taille SUPERIEURE à celle déclarée par NLRECL, est tronqué à la valeur de NLRECL. Pour les enregistrements de FORMAT FIXE (FRECFM = F), si la taille des enregistrements à envoyer est INFERIEURE à la valeur de NLRECL, ceux-ci sont complétés (“paddés”), jusqu’à la valeur de NLRECL : • par des zéros binaires (x00) lorsque les données locales sont déclarées binaires FCODE = BINARY, • par des espaces lorsque les données locales sont déclarées alphanumériques avec, soit : –

FCODE = ASCII : le caractère espace vaut alors x‘20’,

–

FCODE = EBCDIC : le caractère espace vaut alors x ‘40’ (hexadécimal).

ODETTE

[NOTIFY

Dans le cadre du protocole ODETTE, consultez le “Guide des protocoles” de CFT pour l’usage particulier qui est fait de ce paramètre.

= {voir le tableau | identifier}]

Définit la destination des messages associés à l’émission parmi les messages du journal, par la valeur du paramètre OPERMSG. La valeur de ce paramètre est une chaîne de 8 caractères cadrée à gauche. La destination de ces messages peut être, suivant les systèmes : • le “submitter” du moniteur CFT correspondant à la sortie standard associée au moniteur CFT (l’écran de soumission, par exemple). La valeur du paramètre NOTIFY doit être alors renseignée à ‘ blancs),

4-18

’ (8 caractères

CFT V2.3

Manuel de référence

• une console opérateur. La valeur du paramètre NOTIFY doit commencer par les 2 caractères OP, • un utilisateur de la machine. La valeur du paramètre NOTIFY indique l’identifiant système de l’utilisateur selon le format “xxxxxxxx”. Le tableau suivant indique les destinataires possibles suivant le système. Tableau 43. CFTSEND NOTIFY - Destinataires possibles OS

Submitter du moniteur

Console opérateur

Utilisateur quelconque

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

OUI OUI OUI NON OUI OUI NON NON OUI NON OUI

OUI OUI OUI OUI OUI OUI OUI OUI OUI OUI NON

OUI NON OUI OUI OUI OUI OUI OUI OUI NON NON

Explications sur le contenu du tableau : “OUI” signifie que le type de destinataire correspondant existe. “NON” signifie que le type de destinataire correspondant n’existe pas. Le tableau suivant indique, pour le paramètre NOTIFY, les valeurs par défaut supportées pour chaque système. Tableau 44. CFTSEND NOTIFY - Valeurs par défaut OS

Valeur par défaut pour NOTIFY

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

‘ ’ ‘ ’ OPLOG OP ‘ ’ ‘ ’ OP OP ‘ ’ ‘ ’ ‘ ’

Explications sur le contenu du tableau : la valeur ‘ ’ correspond à 8 caractères blancs. Dans le cas “console opérateur”, les choix possibles sont indiqués dans le tableau suivant.

CFT V2.3

4-19

Les commandes de paramétrage de l’environnement des transferts

Tableau 45. CFTSEND NOTIFY - Choix dans le cas «console opérateur» OS “console opérateur”

Caractères interprétés

Messages dirigés vers

GCOS7 GCOS8

OP

Console opérateur Console opérateur désignée par un numéro parmi : • console TY1 • console TY2 • console TY3 • console TY4 Console opérateur La (ou les) console(s) opérateur(s) “message-queue” QSYSOPR (2) Console opérateur Machine opérateur Console opérateur Console système et dans le fichier LOG système périphérique de sortie identifié par le lien “xxxxxx” présent dans le répertoire courant d’exécution du moniteur Console opérateur

OP000001 OP000002 OP000003 OP000004 OP OP OP OP OP OP OP ou OPxxxxxx

GUARDIAN MVS OS400 UNIX VM VMS VOS

VSE WinNT

OP Sans objet

Explications sur le contenu du tableau : sil est indiqué ‘OP’ pour les caractères interprétés, seuls ces 2 caractères (OP) sont interprétés ; les caractères suivants sont non significatifs. Dans le cas “utilisateur” : MVS

Les messages CFT sont émis par SEND à destination du USERID TSO précisé ; dans ce cas, le programme “Moniteur CFT” doit être autorisé (APF).

VMS

Les messages sont dirigés vers le “User VMS” désigné par son nom VMS. Dans ce cas, la tâche “moniteur CFT” doit posséder le privilège OPER.

VM

Les messages sont émis par ‘MSGNOH’ ou ‘MSG’ selon les privilèges accordés.

[NRECFM

= {valeur de FRECFM | F | U | V}]

ODETTE

PeSIT

OS

Format des enregistrements du fichier renseigné au niveau protocolaire : • F : fixe, • V : variable, • U : indéfini (“undefined”). PeSIT D profil EXTERN PeSIT E ODETTE

4-20

PeSIT profil ANY

En protocole PeSIT profil SIT et EXTERN, la valeur NFRECFM = U n’est pas connue au sens protocolaire et est modifiée par le moniteur en NFRECFM = V. Cette valeur (U) est transmise sans modification en PeSIT D profil CFT ou en PeSIT E de CFT à CFT. Dans le cadre du protocole ODETTE, consultez le “Guide des protocoles” de CFT pour l’usage particulier qui est fait de ce paramètre.

CFT V2.3

Manuel de référence Le protocole ETEBAC 3 permet de transférer uniquement des fichiers à enregistrements de longueur fixe.

ETEBAC3

La valeur NRECFM = U est reconnue mais uniquement de CFT à CFT.

PeSIT profil SIT

[NSPACE

= {valeur de FSPACE | n}]

ODETTE

PeSIT

Taille du fichier, au sens protocolaire, exprimée en nombre de blocs de 1 K octets (1024 caractères). [NTYPE

= {voir le commentaire | c}]

ODETTE

PeSIT D profil CFT

PeSIT E CFT/CFT OS

Type du fichier, au sens protocolaire. Ce paramètre est exploité pour désigner le type du fichier récepteur du partenaire. PeSIT D profil CFT

PeSIT E CFT/CFT

ODETTE

[OPERMSG

Valeur par défaut : si ce paramètre n’est pas renseigné, CFT lui attribue une valeur par défaut, en fonction : l du type de fichier local (paramètre FTYPE), l du système d’exploitation du destinataire du transfert (paramètre SYST de CFTPART). Les valeurs par défaut sont données dans l’annexe “NTYPE émis par défaut”. La valeur particulière NTYPE = T peut être utilisée pour demander l’émission d’un fichier en format texte ODETTE. Consultez le “Guide des protocoles” de CFT pour l’usage particulier qui est fait de ce paramètre.

={voir le tableau | n} ]

{0..255}

Définit les catégories de messages d’information sur les transferts destinées à l’opérateur (tous les messages étant, par ailleurs, inscrits dans le fichier de journalisation). Il s’agit d’un sous-ensemble des messages du journal CFT, défini par la somme algébrique des valeurs indiquées dans le tableau ci-après. Tableau 46. Catégories des messages d’information sur les transferts Valeur

Catégorie de message

Type

1 2 4 8 16 32 64 128

Messages d’information d’exploitation Messages d’information système Messages d’attention d’exploitation Messages d’attention système Messages d’erreur d’exploitation Messages d’erreur système Messages d’erreur fatale d’exploitation Messages d’erreur fatale système

I I W W E E F F

Explications sur le contenu du tableau : les types I,W,E,F correspondent au type de message indiqué dans le journal (consultez le manuel“Codes diagnostics et messages” de CFT). La valeur “0” signifie qu’aucun message n’est redirigé vers l’opérateur.

CFT V2.3

4-21

Les commandes de paramétrage de l’environnement des transferts

Le tableau suivant indique, pour le paramètre OPERMSG, les valeurs par défaut supportées pour chaque système. Tableau 47. CFTSEND OPERMSG - Valeurs par défaut OS

Valeur par défaut pour OPERMSG

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

0 0 3 0 0 3 0 0 3 0 0

[PARM

= string80]

PeSIT D profil CFT

PeSIT E CFT/CFT

PeSIT

Paramètre utilisateur transmis au récepteur. La valeur de ce paramètre est accessible par la variable symbolique &PARM. [PRI

= {128 | n}]

{0..255}

Priorité de sélection de la demande d’émission. La valeur la plus élevée du paramètre PRI est 255. Le moniteur CFT sélectionne en priorité les demandes de transfert de priorité élevée pour un partenaire donné. [RAPPL

= string] string8

PeSIT D profil CFT

string48

PeSIT E CFT/CFT

PeSIT E

Identifiant de l’application réceptrice du fichier. Lorsque la chaîne de caractères est entre guillemets, la valeur est prise telle quelle en respectant les majuscules et les minuscules. Lors de la saisie de ce paramètre, il n’y a pas de contrôle de sa pertinence vis-à-vis du protocole qui sera utilisé pour le transfert : si le protocole utilisé est PeSIT D profil Extern, ETEBAC 3, ODETTE, ce paramètre ne sera pas transmis. De plus la taille maximum permise par le protocole utilisé n’est pas contrôlée. Seul un contrôle relatif à la taille maximum de 48 caractères (autorisé en PeSIT E entre deux CFT) est effectif.

4-22

CFT V2.3

Manuel de référence

Remarque : en PeSIT E standard, la valeur du paramètre RAPPL est transporté dans le PI 04. Sa longueur maximum est limitée par le standard à 8 caractères. Ce PI 04 contient cette valeur concaténée avec celle du paramètre RUSER. En PeSIT E entre 2 moniteurs CFT, si ce paramètre RAPPL a une valeur de longueur supérieure à 8 caractères, la valeur renseignée dans le PI04 étant tronquée à 8 caractères, cette valeur est transportée dans le PI99. En profil CFT, ce paramètre ne doit pas être renseigné lorsque le moniteur partenaire est CFT/370 Version 1 ou un CFT/PC.

PeSIT D profil CFT

PeSIT E standard

[RUSER

PeSIT E CFT/CFT

Ce paramètre peut être transmis et contrôlé par le partenaire serveur/émetteur.

= string] string8

PeSIT D profil CFT

string28

PeSIT E CFT/CFT

PeSIT E

Identifiant de l’utilisateur récepteur du fichier. Lorsque la chaîne de caractères est entre guillemets, la valeur est prise telle quelle en respectant les majuscules et les minuscules. Lors de la saisie de ce paramètre, il n’y a pas de contrôle de sa pertinence vis-à-vis du protocole qui sera utilisé pour le transfert : si le protocole utilisé est PeSIT D profil Extern, PeSIT profil SIT, ETEBAC 3, ODETTE, ce paramètre ne sera pas transmis. De plus la taille maximum permise par le protocole qui sera utilisé n’est pas contrôlée. Seul un contrôle relatif à la taille maximum de 28 caractères (autorisé en PeSIT E entre deux CFT) est effectif. Remarque : en PeSIT E standard, la valeur du paramètre RUSER est transporté dans le PI 04. Sa longueur maximum est limitée par le standard à 8 caractères. Ce PI 04 contient cette valeur concaténée avec celle du paramètre RAPPL. En PeSIT E entre 2 moniteurs CFT, si ce paramètre RUSER a une valeur de longueur supérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dans le PI 04 étant tronquée à 8 caractères. Ce paramètre ne doit pas être renseigné, en profil CFT de PeSIT, lorsque le moniteur partenaire est CFT/370 Version 1 ou un CFT/PC.

PeSIT D profil CFT

PeSIT E standard

[SELFNAME

PeSIT E CFT/CFT

Ce paramètre peut être transmis et contrôlé par le partenaire serveur/émetteur.

= filename]

Nom du fichier contenant la liste des fichiers sélectionnés à émettre.

CFT V2.3

4-23

Les commandes de paramétrage de l’environnement des transferts

[SAPPL

= string] string8

PeSIT D profil CFT

string48

PeSIT E CFT/CFT

PeSIT profil SIT

PeSIT E

Identifiant de l’application émettrice du fichier. Lorsque la chaîne de caractères est entre guillemets, la valeur est prise telle quelle en respectant les majuscules et les minuscules. Lors de la saisie de ce paramètre, il n’y a pas de contrôle de sa pertinence vis-à-vis du protocole qui sera utilisé pour le transfert : si le protocole utilisé est PeSIT D profil Extern, ETEBAC 3, ODETTE, ce paramètre ne sera pas transmis. De plus la taille maximum permise par le protocole qui sera utilisé n’est pas contrôlée. Seul un contrôle relatif à la taille maximum de 48 caractères (autorisé en PeSIT E entre deux CFT) est effectif. Remarque : en PeSIT E standard, la valeur du paramètre SAPPL est transporté dans le PI 03. Sa longueur maximum est limitée par le standard à 8 caractères. Ce PI 03 contient cette valeur concaténée avec celle du paramètre SUSER. En PeSIT E entre 2 moniteurs CFT, si ce paramètre SAPPL a une valeur de longueur supérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dans le PI 03 étant tronquée à 8 caractères. Ce paramètre ne doit pas être renseigné, en profil CFT de PeSIT, lorsque le moniteur partenaire est CFT/370 Version 1 ou un CFT/PC.

PeSIT D profil CFT

PeSIT E standard

[SPART

PeSIT E CFT/CFT

Ce paramètre peut être transmis et contrôlé par le partenaire serveur/émetteur.

= string8}

Dénomination “réseau” sous laquelle le moniteur CFT local va se présenter à son partenaire. Si le NSPART de la commande CFTPART associé au SEND n’est pas renseigné, c’est la valeur du SPART qui sera prise en compte. [STATE

= {DISP | HOLD | KEEP}

Définit l’état de la requête de transfert : • DISP : la requête est enregistrée en état ‘D’ (disponible) dans le catalogue ; cet état correspond à un transfert “immédiat” (c’est-à-dire s’exécutant dès que possible, compte tenu des contraintes de plages horaires, de parallélisme des transferts, etc.), • HOLD : la requête est enregistrée en état ‘H’ dans le catalogue ; cet état correspond à un transfert différé. Le transfert s’exécutera ultérieurement soit :

4-24

–

sur acceptation d’une demande de réception d’origine distante,

–

à la suite d’une commande locale START ayant fait passer ce transfert à l’état disponible (‘D’),

CFT V2.3

Manuel de référence

• KEEP : la requête est enregistrée en état ‘K’ dans le catalogue ; cet état correspond à un transfert différé : le transfert ne pourra s’exécuter, ultérieurement, qu’à la suite d’une commande locale START (l’ayant fait passer à l’état disponible). [SUSER

= string] string8

PeSIT D profil CFT

string28

PeSIT E CFT/CFT

PeSIT E

Identifiant de l’utilisateur émetteur du fichier. Lorsque la chaîne de caractères est entre guillemets, la valeur est prise telle quelle en respectant les majuscules et les minuscules. Lors de la saisie de ce paramètre, il n’y a pas de contrôle de sa pertinence vis-à-vis du protocole qui sera utilisé pour le transfert : si le protocole utilisé est PeSIT D profil Extern, PeSIT profil SIT, ETEBAC 3, ODETTE, ce paramètre ne sera pas transmis. De plus la taille maximum permise par le protocole qui sera utilisé n’est pas contrôlée. Seul un contrôle relatif à la taille maximum de 28 caractères (autorisé en PeSIT E entre deux CFT) est effectif. Remarque : en PeSIT E standard, la valeur du paramètre SUSER est transporté dans le PI 03. Sa longueur maximum est limitée par le standard à 8 caractères. Ce PI 03 contient cette valeur concaténée avec celle du paramètre SAPPL. En PeSIT E entre 2 moniteurs CFT, si ce paramètre SUSER a une valeur de longueur supérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dans le PI 03 étant tronquée à 8 caractères. PeSIT D profil CFT

PeSIT E standard

Ce paramètre ne doit pas être renseigné, en profil CFT de PeSIT, lorsque le moniteur partenaire est CFT/370 Version 1 ou un CFT/PC. Ce paramètre peut être transmis et contrôlé par le partenaire serveur/émetteur.

PeSIT E CFT/CFT

[TCYCLE

= {DAY |MIN | MONTH}]

Unité de la période du cycle de transfert. Cette unité pouvant être : • DAY : jour, • MIN : minute, • MONTH : mois.

CFT V2.3

4-25

Les commandes de paramétrage de l’environnement des transferts

[TRK = {"valeur de TRKSEND de CFTPART" | ALL | NO | SUMMARY | UNDEFINED}] Spécification du niveau de détail que CFT fournit à Sentinel sur les transferts. CFT envoie les informations sur le transfert sous forme d'occurrences de suivi. Les valeurs possibles de ce paramétre sont : • NO :

le moniteur n'envoie jamais d'occurrences de suivi à Sentinel,

• ALL :

le moniteur envoie une occurrence de suivi à Sentinel pour chaque étape de chaque transfert,

• SUMMARY : le moniteur envoie une occurrence de suivi à Sentinel uniquement pour l'étape initiale et l'étape finale de chaque transfert. • UNDEFINED : les options de suivi sont définies dans le paramètre TRK de la commande CFTPART. TRK n'est utilisable qu'à partir de la version CFT V2.3.1. [USERID

= {“userid du moniteur CFT” | string15}]

Identifiant de l’utilisateur propriétaire du transfert. Ce paramètre est utilisé en serveur émetteur pour définir le propriétaire du transfert associé à une commande CFTSEND IMPL=YES (émission implicite). Si ce paramètre n’est pas renseigné, sa valeur par défaut est l’“userid” système du moniteur CFT serveur. Remarque : pour les commandes SEND utilisées en demandeur émetteur ou en serveur émetteur (SEND STATE = HOLD), l’identifiant du propriétaire du transfert est l’“userid” système de l’utilisateur ayant activé la commande. La valeur de ce paramètre peut être composée à partir des variables symboliques : • &PART :

valeur substituée par l’identifiant local du partenaire du transfert (ID de CFTPART),

• &SUSER :

valeur substituée par le paramètre SUSER transmis entre deux moniteurs CFT (protocole PeSIT D profil CFT et PeSIT E),

• &RUSER :

valeur substituée par le paramètre RUSER transmis entre deux moniteurs CFT (protocole PeSIT D profil CFT et PeSIT E).

[WFNAME VM

OS

= filename] Paramètre non pertinent.

Nom du fichier temporaire à utiliser lors de l’envoi d’un groupe de fichiers après une sélection basée sur le nom générique fourni dans FNAME. Ce fichier n’est utilisé que lorsque des traitements complémentaires sont nécessaires sur la machine cible. Ce fichier est détruit après émission. Exemple : MVS

Procédure IEBCOPY pour les fichiers partitionnés (PDS).

Pour une information complémentaire sur le fichier et sa structure, consultez le “Guide d’exploitation” correspondant à votre OS.

4-26

CFT V2.3

Manuel de référence

La sélection des fichiers à émettre s’effectue à partir du nom fourni dans le paramètre FNAME. Le fichier temporaire contient alors les données à transmettre. Le transfert du fichier s’effectue selon les mêmes modalités qu’un transfert de fichier séquentiel. Restriction : ce processus ne peut être utilisé que pour : • des transferts entre systèmes homogènes (même valeur de paramètre SYST dans la commande CFTPART), •

le protocole.

PeSIT E CFT V222 à CFT V222

Les variables utilisables pour la constitution de la chaîne de caractères WFNAME sont les suivantes : • &FDATE, &FTIME, &FYEAR, &FMONTH, &FDAY, • &SPART, &RPART, &PART, &NPART, &GROUP, • &SUSER, &RUSER, • &SAPPL, &RAPPL, • &IDF, &PARM, &IDA, • &NIDF, &NFNAME, &IDT, • &BDATE, &BTIME, &BYEAR, &BMONTH, &BDAY. Le caractère ’&’ remplace ici le caractère char_symb spécifique à chaque système d’exploitation (consultez le “Guide d’exploitation” de CFT correspondant à votre OS). L’utilisateur veillera à l’unicité du nom attribué pour éviter des problèmes de conflit d’accès. [XLATE

= identifier]

Identifiant de la table de transcodage utilisée pour les transferts en émission relatifs à ce fichier type. La table de transcodage est définie par la commande CFTXLATE ID = xlate. La requête de transfert SEND permet de spécifier une autre table de transcodage que celle attachée au fichier type. Consultez, dans le guide “Concepts” de CFT, la partie "Transcodage” pour davantage de précisions sur la mise en oeuvre des tables de transcodage.

4.1.2. Exemples Exemple 1 : CFTSEND

CFT V2.3

MODE ID IMPL FCODE FNAME

= = = = =

REPLACE, SNDIMPL, YES, EBCDIC, ’JSTATI’

/* IDF

émissions implicites

/* Données EBCDIC dans fichier /* de nom ...

*/ */ */

4-27

Les commandes de paramétrage de l’environnement des transferts

Exploité uniquement si : • l’IDF du transfert a pour valeur SNDIMPL, • CFT réagit à une demande d’émission provenant du partenaire (CFT est serveur émetteur), • il n’y a pas de requête SEND pour cet IDF en attente dans le catalogue. Il s’agit du mécanisme d’émission implicite. Exemple 2 : CFTSEND MODE = REPLACE, ID = IDFDEF, /* IDF par défaut */ IMPL = NO, FCODE = ASCII Correspond au cas d’émission de fichier lorsque la commande SEND spécifie un IDF non explicité par une commande CFTSEND. C’est la description du fichier type à émettre “par défaut”. Il faut que la commande CFTPARM précise : CFTPARM DEFAULT = IDFDEF, ... La commande SEND précisera le nom du fichier à émettre (paramètre FNAME). Exemple 3 : CFTSEND MODE ID FLRECL */ FACTION FCODE MINDATE MINTIME MAXDATE MAXTIME CYCLE TCYCLE

= CREATE, = STAT, = 128, = = = = = = = =

DELETE, ASCII, 19920703, 1000, 19921231, 2000, 7, DAY,

/* Identifiant du fichier */ /* de longueur maxi 128 octets /* /* /* /* /* /* /*

Supprime apres emission Codification fichier A partir du 03/07/92 à 10h (Lundi) Jusqu’au 31/12/92 à 20h Toutes les semaines

*/ */ */ */ */ */ */

/* CYCTIME prendra la valeur 1000 */ CYCDATE = 19920705, /* Activation possible les */ /* 3 premiers jours de la */ /* semaine , donc avant */ /* le Mercredi 10 heures */ PARM = ’Statistique jour’ /* Parametre associe */ /* pour PeSIT profil CFT */ Répond à un besoin d’émission cyclique spécifique.

4-28

CFT V2.3

Manuel de référence

4.1.3. Paramètres associés à un fichier type en cas d’émission à partir d’une base VFM En cas d’émission d’un fichier logique d’une base VFM, le paramétrage de CFTSEND diffère sur les points suivants, par rapport au paramétrage de CFTSEND utilisé pour une émission de fichier physique : • il y a un paramètre supplémentaire : FDB, • le paramètre FNAME est le nom du fichier logique à émettre, • les paramètres FORG, FCODE, FTYPE, FBLKSIZE, FLRECL et FRECFM, FSPACE sont sans objet, car leurs valeurs sont connues de la méthode d’accès VFM, • les paramètres NKEYLEN, NKEYPOS, NSPACE, FREYLEN et FKEYPOS sont également sans objet, • le paramètre FACTION peut prendre pour valeur supplémentaire ROTATE. La syntaxe complète est indiquée ci-dessous. Les explications relatives aux paramètres concernent uniquement les spécificités VFM. Pour les autres explications, voir les commentaires concernant le paramétrage de CFTSEND utilisé pour une émission de fichier physique.

4.1.3.1. Syntaxe CFTSEND

CFT V2.3

[MODE ID [IMPL [USERID [FORCE

= = = = =

{REPLACE | CREATE | DELETE},] identifier, {NO | YES},] {“userid du moniteur CFT” | string},] {NO | YES},]

[RAPPL

= string,]

PROTOCOLE

[SAPPL

= string,]

PROTOCOLE

[RUSER

= string,]

PROTOCOLE

[SUSER

= string,]

PROTOCOLE

[PARM

= string,]

PROTOCOLE

[STATE [PRI [COMMENT [EXEC [MINDATE [MAXDATE [MINTIME [MAXTIME [CYCDATE [CYCTIME [CYCLE [TCYCLE

= = = = = = = = = = = =

{DISP | HOLD | KEEP},] {128 | n},] string,] filename,] {date (système) du jour | date},] date,] {00000000 | time},] {23595999 | time},] date,] time,] {0 | n},] {DAY | MIN | MONTH},]

4-29

Les commandes de paramétrage de l’environnement des transferts PROTOCOLE

[XLATE

= identifier,]

[NCOMP [EXIT [FACTION [FNAME [FDB

= = = = =

[NFNAME

= filename,]

PROTOCOLE

OS

[NTYPE

= c,]

PROTOCOLE

OS

[NBLKSIZE

= n,]

PROTOCOLE

OS

[NLRECL

= n,]

[NRECFM

= {F | U | V},]

PROTOCOLE

OS

[NCODE

= {ASCII | BINARY | EBCDIC}]

cpr,] identifier,] {NONE | DELETE | ERASE | ROTATE},] filename,] filename,]

4.1.3.2. Paramètres [FACTION

= {NONE | DELETE | ERASE | ROTATE}]

Action après transfert du fichier : • ERASE : le fichier sera remis à zéro après le transfert (EOF en début de fichier), • DELETE : le fichier sera détruit après le transfert, • NONE : aucune action sur ce fichier en fin de transfert, • ROTATE : cette valeur ne s’applique que sur un fichier logique de base VFM. Création d’une nouvelle version vide du fichier logique après transfert d’un fichier logique de version 0. La version transférée devient la version -1 du fichier. Attention : si la rotation de version est demandée sur un fichier à transmettre “sans version” ou de version -n, la demande de transfert est refusée. [FDB

= filename]

Nom de la base VFM (fichier DATA) contenant le fichier logique à émettre. [FNAME

= filename]

Nom du fichier logique de la base (FDB) à émettre. La syntaxe des noms de fichiers logiques est décrite dans le guide “Utilitaire VFM - Manuel de référence”. Ces noms peuvent comporter des caractères joker (masque), désignant ainsi le premier fichier logique dont le nom répond à ce masque.

4-30

CFT V2.3

Manuel de référence

4.1.3.3. Exemples Exemple 1 : CFTSEND

ID FDB FNAME FACTION

= = = =

BANQUE, BASE1.VFM, CFT.SEND.TEST(0), ROTATE

Demande d’émission du fichier logique CFT.SEND.TEST(0) appartenant à la base VFM “BASE1.VFM” et rotation d’une version en fin de transfert. Exemple 2 : CFTSEND

ID FDB FNAME

= = =

BANQUE, BASE1.VFM, CFT.*.TEST(0),

Demande d’émission du premier fichier logique appartenant à la base VFM “BASE1.VFM” et dont le nom correspond au masque indiqué ; ainsi le fichier logique CFT.SEND.TEST(0) sera émis.

4.2 CFTRECV - Descrip tion de réception Pour plus de clarté, les particularités du paramétrage associé à un fichier type en cas de réception, à partir d’une base VFM, font l’objet d’une partie spécifique, en fin de paragraphe.

4.2.1. Paramètres associés à un fichier type Les commandes CFTRECV regroupent des paramètres contrôlant le déroulement des réceptions et le stockage des données reçues. Chaque commande CFTRECV - commande “défaut” exceptée - contrôle la réception du fichier type de même identifiant (IDF correspondant à l’ID de la commande CFTRECV). Quant à la commande CFTRECV “défaut”, elle s’applique à tous les autres fichiers types (IDF ne correspondant à aucun ID de commande CFTRECV). Pour plus de clarté, on regroupe usuellement dans un fichier source de paramétrage, toutes les commandes CFTRECV et on met la commande CFTRECV “défaut” soit en première, soit en dernière position. La commande CFTRECV permet de préciser, pour chaque fichier type (IDF) : • le nom et les caractéristiques physiques (par exemple : format et longueur d’enregistrement) du fichier récepteur, • les actions à effectuer localement, notamment :

CFT V2.3

-

appel lors du transfert à une tâche “EXIT fichier” écrite par l’utilisateur,

-

actions exécutées par le moniteur sur le fichier récepteur en début de transfert,

-

transcodage des données pendant la réception,

-

appel à une procédure à exécuter en fin de transfert, ...

4-31

Les commandes de paramétrage de l’environnement des transferts

• divers paramètres contrôlant l’exécution des transferts, notamment : –

plage horaire autorisée,

–

identifiant d’utilisateur associé par défaut aux transferts.

Les paramètres “nom et caractéristiques physiques du fichier récepteur” sont pris en compte à chaque nouvelle réception, en début de transfert : • s’il y a création d’un nouveau fichier récepteur par CFT : –

ces paramètres priment, s’ils sont précisés explicitement, sur les valeurs extraites (ou déduites) des messages protocolaires reçus,

–

mais, si la réception est déclenchée par une commande RECV locale, les éventuels paramètres accompagnant explicitement celle-ci priment sur ceux de la commande CFTRECV si la valeur du paramètre FORCE est FORCE = NO (pour tous les paramètres communs aux deux commandes, CFTRECV ne fournit que les valeurs par défaut à RECV),

–

ils ne sont pas pris en compte s’ils sont renseignés dans la commande CFTRECV et si la valeur du paramètre FORCE est FORCE = YES.

La règle de préséance qui s’applique, globalement, est celle-ci : –

si FORCE = NO, les paramètres de RECV priment sur ceux de CFTRECV,

–

si FORCE = YES, les paramètres de CFTRECV priment sur ceux de RECV.

Ces paramètres eux-mêmes priment sur les valeurs protocolaires reçues qui ellesmêmes priment sur les éventuelles caractéristiques de fichier prévues par défaut dans les internes de certains systèmes, indépendamment du paramétrage CFT, • dans le cas où un fichier déjà existant est réutilisé pour recevoir les données d’un nouveau transfert, il est d’une manière générale impossible de prendre en compte de nouvelles caractéristiques de fichier : le comportement “standard” de CFT consiste alors simplement à vérifier la compatibilité des nouvelles valeurs avec l’existant, • en cas de stockage des données dans une “enveloppe” déjà existante (par exemple, lorsque CFT ajoute un nouveau membre dans un fichier partitionné déjà existant), on se trouve a priori dans un cas intermédiaire entre les deux cas précédents : de nouvelles valeurs peuvent être prises en compte pour certains paramètres mais pas pour d’autres ; le comportement de CFT est ici système-dépendant. Le fichier reçu peut être stocké en cours de transfert dans un fichier temporaire qui sera renommé à la fin du transfert.

4-32

CFT V2.3

Manuel de référence

4.2.1.1. Syntaxe CFTRECV

CFT V2.3

ID [COMMENT [CYCDATE [CYCTIME [DELETE [DIRNB [EXEC [EXIT [FACTION

= = = = = = = = =

identifier, string,] date,] time,] {NO | YES},] n,] filename,] identifier,] {VERIFY | DELETE | ERASE},]

[FBLKSIZE

= n,]

[FCODE

= {ASCII | BINARY | EBCDIC},]

[FDISP

= {BOTH | NEW | OLD},]

[FKEYLEN

= {valeur reçue ou 0 | n},]

PROTOCOLE

[FKEYPOS

= {valeur reçue ou 0 | n},]

PROTOCOLE

[FLRECL [FNAME [FORCE

= n,] = filename,] = {NO | YES},]

[FORG

= {SEQ | DIRECT | INDEXED},]

OS

[FRECFM

= {F | U | V},]

OS

[FSPACE

= n,]

[FTYPE

= c,]

[GROUPID

= string,]

[MACTION

= {“ ” | REPLACE},]

[MAXDATE [MAXTIME [MINDATE [MINTIME [MODE

= = = = =

[NCOMP

= cpr,]

[NOTIFY

= identifier,]

[OPERMSG

= n,]

[PRI

= {128 | n},]

OS

Dft : OS

OS

OS

{voir le commentaire | date},] {23595999 | time},] {date système du jour | date},] {00000000 | time},] {REPLACE | CREATE | DELETE},] PROTOCOLE

OS

4-33

Les commandes de paramétrage de l’environnement des transferts PROTOCOLE

[RAPPL

= string,]

[RKERROR

= {“ ” | DELETE | KEEP},]

[RUSER

= string,]

PROTOCOLE

[SAPPL

= string,]

PROTOCOLE

[STATE

= {DISP | HOLD | KEEP}]

[SUSER

= string,]

[TRK [USERID

= {UNDEFINED | ALL | SUMMARY | NO},] = {“userid” du moniteur CFT | string},]

[WFNAME

= filename,]

[XLATE

= identifier]

PROTOCOLE

OS

4.2.1.2. Synthèse des paramètres Ces paramètres peuvent être classés en : • paramètres d’identification : -

généraux

: ID, USERID, GROUPID,

-

liés au protocole PeSIT (profil SIT, PeSIT D profil CFT ou PeSIT E)

: RAPPL, SAPPL,

liés au protocole PeSIT (PeSIT D profil CFT ou PeSIT E)

: RUSER, SUSER,

-

• protection des paramètres valorisés • paramètres libres pour l’utilisateur CFT d’utilisation locale

: FORCE, : COMMENT, OPERMSG, DELETE, NOTIFY,

• paramètres de contrôle d’exécution : -

généraux

: PRI,

-

utilisateur

: EXEC, EXIT,

-

gestion d’échéancier

: MINDATE,...CYCTIME,

• paramètres de traitement des données

: NCOMP, XLATE, FCODE,

• paramètres fichier (généraux) :

4-34

-

gestion du fichier

: FACTION, FDISP,

-

nom physique

: FNAME, WFNAME,

-

caractéristiques physiques (fichier global)

: FSPACE, FORG, FTYPE,

-

caractéristiques physiques (enregistrements)

: FRECFM, FLRECL, FBLKSIZE, FKEYLEN, FKEYPOS.

CFT V2.3

Manuel de référence

Sur l’emploi des paramètres définissant les caractéristiques du fichier : parmi les paramètres définissant les caractéristiques du fichier récepteur, plusieurs pourront fréquemment être omis, en pratique, car les messages protocolaires transportent (ou permettent de retrouver) des indications relatives aux caractéristiques de fichier communiquées par l’émetteur. Pour le transfert considéré, ces valeurs protocolaires constituent les VALEURS PAR DEFAUT des paramètres Fxxxxx correspondants : PeSIT E CFT/CFT PeSIT D profil CFT

En protocole PeSIT E (CFT à CFT), ou D profil CFT (transfert entre 2 moniteurs CFT), les paramètres FSPACE, FTYPE, BLKSIZE, FLRECL, FRECFM prennent par défaut les valeurs transmises par le partenaire (voir la commande CFTSEND, paramètres NSPACE, NTYPE, NBLKSIZE, NLRECL, NRECFM). En cas de fonctionnement en mode ouvert, le paramètre FNAME peut également hériter de la valeur du paramètre NFNAME du partenaire. En PeSIT E, les paramètres FKEYLEN et FKEYPOS prennent par défaut les valeurs transmises par le partenaire (voir la commande CFTSEND, paramètre NKEYLEN et NKEYPOS).

PeSIT E

PeSIT D profil EXTERN

En protocole PeSIT D profil Extern, les informations “taille de fichier”, “format d’article” et “longueur d’article”, transmises par le protocole, sont prises par défaut comme valeurs des paramètres FSPACE, FRECFM, FLRECL.

PeSIT profil SIT

En protocole PeSIT profil SIT, les informations “taille de fichier”, “format d’article” et “longueur d’article”, transmises par le protocole, sont prises par défaut comme valeurs des paramètres FSPACE, FRECFM, FLRECL. En protocole ODETTE, les valeurs par défaut des paramètres FRECFM, FLRECL et FSPACE sont déduites des paramètres ODETTE reçus.

ODETTE

En protocole ETEBAC 3, les seuls fichiers protocolairement transférables sont de format fixe. En mode serveur récepteur, la taille d’enregistrement transmise dans la carte paramètre est prise comme valeur par défaut du paramètre FLRECL.

ETEBAC3

Pour une information complémentaire, consultez le “Guide des protocoles” de CFT.

4.2.1.3. Paramètres [COMMENT

= string160]

Commentaire alphanumérique local associé à la réception. Le contenu de ce paramètre : • n’est ni analysé, ni exploité lors des transferts, • peut être consulté en local à partir de la commande LISTCAT CONTENT=FULL, • est restitué à partir de la variable symbolique &COMMENT.

CFT V2.3

4-35

Les commandes de paramétrage de l’environnement des transferts

[CYCDATE

= {voir le commentaire | date}]

Jour limite supérieure d’activation du premier transfert d’un échéancier. Valeur par défaut : si la périodicité est journalière ou plus (TCYCLE = DAY ou TCYCLE MONTH), alors la valeur par défaut de CYCDATE est : MINDATE + TCYCLE*CYCLE. Sinon, cette valeur est CYCDATE = MINDATE. Exemple : si TCYCLE = DAY et CYCLE = 2, la valeur par défaut de CYCDATE est MINDATE + 2 jours. CYCLE et TCYCLE sont des paramètres de la commande RECV. [CYCTIME

= {voir le commentaire | time}]

Heure limite supérieure d’activation du premier transfert d’un échéancier. Pour les transferts suivants, la date/heure limite est calculée comme suit : CYCDATE.CYCTIME + CYCLE * TCYCLE (valeur de la période). Valeur par défaut : si la périodicité est exprimée en minutes (TCYCLE = MIN), la valeur par défaut de CYCTIME est : MINTIME + TCYCLE*CYCLE. Sinon, cette valeur est CYCTIME = MINTIME. Exemple : si TCYCLE = MIN et CYCLE = 60, la valeur par défaut de CYCTIME est MINTIME + 1 heure. CYCLE et TCYCLE sont des paramètres de la commande RECV. [DELETE

= {NO | YES}]

Suppression automatique des postes du catalogue en état ‘T’ (terminé) pour l’IDF correspondant. Si l’utilisateur spécifie des procédures de fin transfert (paramètres EXECSF et EXECRF de CFTPARM), cette suppression n’intervient qu’après l’exécution de ces procédures. Si la commutation des fichiers est demandée (par le biais du paramétrage CFT), aucun des postes du catalogue, associé à des transferts terminés, n’est supprimé. [DIRNB

= n]

MVS

Nombre de blocs de directories utilisés pour la création d’un répertoire. [EXEC

= filename]

Nom du fichier décrivant la procédure à exécuter en fin de transfert. Permet d’associer cette procédure à un identifiant de fichier type, autrement qu’en mettant la variable symbolique &IDF au niveau du paramètre EXECRF de CFTPARM.

4-36

CFT V2.3

Manuel de référence

Les variables symboliques possibles dans “filename” et dans la procédure associée, ou dans l’ensemble des procédures associées, sont les mêmes que celles autorisées pour les procédures de fin de transfert référencées dans CFTPARM (consultez le paragraphe “Variables symboliques” dans le guide “Concepts” de CFT). Si le paramètre EXEC est renseigné et : • si le fichier correspondant à “filename” existe, la procédure associée est soumise en fin de transfert, • si ce fichier n’existe pas, aucun traitement n’est exécuté en fin de transfert (même si le paramètre EXECRF de la commande CFTPARM est renseigné). Si le paramètre EXEC n’est pas renseigné, c’est le paramètre EXECRF de la commande CFTPARM qui est pris en compte. [EXIT

= identifier]

Identifiant de la commande CFTEXIT associée à ce transfert. Utilisé pour activer une tâche utilisateur d’EXIT fichier. La valeur de ce paramètre peut être égale à la variable symbolique &IDF. [FACTION

= {VERIFY | DELETE | ERASE}]

Action sur le fichier avant réception. Si un fichier récepteur de même nom existe déjà, le moniteur effectue, suivant la valeur de ce paramètre, l’une des actions suivantes : • ERASE : remise à zéro (effacement) du fichier, • DELETE : suppression du fichier, • VERIFY : vérification que le fichier est vide. Le moniteur réagit aux diverses situations possibles, en fonction de la valeur du paramètre FDISP, selon le tableau suivant. Tableau 48. CFTRECV FACTION/FDISP - Actions possibles FACTION FDISP

ERASE

DELETE

VERIFY

NEW

Inex : OK Exst : NOK Inex : NOK Exst : OK (Erase)

Inex : OK Exst : NOK Inex : NOK Exst : OK (Delete)

Inex : OK Exst : OK (Erase)

Inex : OK Exst : OK (Delete)

Inex : OK Exst : NOK Inex : NOK Exst : OK si vide NOK sinon Inex : OK Exst : OK si vide NOK sinon

OLD

BOTH

Explications sur le contenu du tableau : • OK signifie que le transfert est accepté, • NOK signifie que le transfert est refusé, • Inex signifie que le fichier récepteur n’existe pas encore, • Exst signifie que le fichier récepteur existe déjà (ses caractéristiques sont supposées convenir).

CFT V2.3

4-37

Les commandes de paramétrage de l’environnement des transferts

MVS VM

Pour les fichiers VSAM, seul FACTION = ERASE est accepté. FACTION = VERIFY (valeur par défaut) n’est pas supporté. Ce paramètre doit donc être renseigné explicitement avec l’une des valeurs ERASE ou DELETE.

[FBLKSIZE

= {voir le tableau | n }]

{0..32768}

OS

Ce paramètre (exprimé en nombre d’octets) contrôle le “blocage” des enregistrements du fichier récepteur : suivant les systèmes, il peut définir la taille des blocs sur disque et/ou la taille des buffers d’entrée/sortie fichier. Tableau 49. CFTRECV FBLKSIZE - OS concernés OS

FBLKSIZE

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

OUI OUI NON OUI NON NON NON NON NON OUI NON

MVS

Pour les protocoles autres que PeSIT, profil CFT, si ce paramètre n’est pas renseigné, sa valeur est fixée comme suit :

• pour les fichiers en format fixe : cette valeur est égale au plus grand multiple de FLRECL qui est inférieur à la constante (liée à la longueur de piste) définie à l’installation (valeur par défaut : 19069), ou FLRECL si FLRECL est supérieur à cette constante, • pour les fichiers en format variable : cette valeur est égale à la constante (liée à la longueur de piste) définie à l’installation du moniteur CFT dans l’environnement MVS (valeur par défaut : 19065), ou à FLRECL + 4 si FLRECL est supérieur à cette constante, • pour les fichiers en format indéfini : cette valeur est égale à 32760.

[FCODE

= {suivant FTYPE | ASCII | BINARY | EBCDIC}]

Dft : OS

Code des données du fichier récepteur (code des données locales). Valeurs par défaut : En protocole PeSIT (profil SIT excepté), si le code des données reçu du réseau est BINARY, FCODE (déterminé dynamiquement à chaque transfert) est valorisé par défaut à BINARY. Sinon, FCODE (déterminé dynamiquement à chaque transfert) est par défaut égal à la valeur du code natif du système récepteur. La valeur par défaut de FCODE n’est pas fonction du type de fichier reçu du réseau.

4-38

CFT V2.3

Manuel de référence

Le transcodage effectué à la réception dépend : • du code local (valeur explicite ou implicite du paramètre FCODE), • du code “réseau” (code des données reçu du réseau), • de la présence éventuelle d’une table de transcodage externe. Rappelons qu’une table de transcodage externe est prise en compte : • si elle correspond au code local et au code réseau, • et si l’ID de la commande CFTXLATE est référencé par un paramètre XLATE (de RECV ou CFTRECV ou CFTPART), ou bien est égal à l’ID “default” de CFTPARM. A chaque réception : • si les données reçues sont en ASCII et les données locales en EBCDIC, ou inversement, il y a toujours transcodage : transcodage en fonction d’une table externe, ou, à défaut, transcodage en fonction de la table interne de CFT, • si les données reçues et les données locales ont le même code, ASCII ou EBCDIC, seule la présence d’une table externe peut provoquer l’exécution d’un transcodage. En effet, CFT ne possède pas de table interne ASCII/ASCII ni EBCDIC/EBCDIC. Si les données reçues et/ou les données locales sont binaires, il n’y a aucun transcodage. Le code des données reçues n’est pas détecté par examen des données elles-mêmes. Ce code est soit : • explicitement communiqué par l’émetteur (voir le paramètre NCODE de la commande CFTSEND, dans le cas PeSIT CFT à CFT), • déduit des règles protocolaires : par exemple, en cas de transfert en ETEBAC 3, on

s’attend usuellement à recevoir des données codées en EBCDIC (pour des informations complémentaires, consultez le “Guide des protocoles” de CFT). [FDISP

= {BOTH | NEW | OLD}]

Indicateur de contrôle de la présence du fichier récepteur afin de déterminer l’action du moniteur CFT : • NEW :

le fichier doit être créé par CFT. Le transfert sera refusé si ce fichier existe déjà,

• OLD

le fichier doit déjà exister,

:

• BOTH : [FKEYLEN

si le fichier n’existe pas, il sera créé. = {0 | n}]

PeSIT E

Longueur (en octets) de la clé d’un fichier indexé. La valeur par défaut est la valeur reçue du protocole (PI 38) présente si elle a été renseignée par le demandeur. Si cette valeur est absente, la valeur par défaut est alors égale à 0. Le moniteur reçoit le fichier sous forme d’enregistrements séquentiels. Le client peut développer un EXIT de type fichier ou écrire une procédure de fin de transfert pour exploiter cette information récupérable par la variable symbolique &FKEYLEN.

CFT V2.3

4-39

Les commandes de paramétrage de l’environnement des transferts

[FKEYPOS

= {0 | n}]

PeSIT E

Position (en octets) de la clé dans l’article d’un fichier indexé. La valeur par défaut est la valeur reçue du protocole (PI 39) présente si elle a été renseignée par le demandeur. Si cette valeur est absente, la valeur par défaut est alors égale à 0. Le moniteur reçoit le fichier sous forme d’enregistrements séquentiels. Le client peut développer un EXIT de type fichier ou écrire une procédure de fin de transfert pour exploiter cette information récupérable par la variable symbolique &FKEYPOS. [FLRECL

= n]

Pour des enregistrements : • de format fixe (FRECFM = F)

: longueur des enregistrements du fichier récepteur,

• de format variable (FRECFM = V)

: longueur maximale des enregistrements,

• de format indéfini (FRECFM = U)

: longueur maximale des enregistrements de ce fichier.

FLRECL est exprimé en nombre d’octets. Lors d’une réception, tout enregistrement reçu de taille SUPERIEURE à celle déclarée par FLRECL, est tronqué à la valeur de FLRECL. Pour les enregistrements de FORMAT FIXE (FRECFM = F), si la taille des enregistrements reçus est INFERIEURE à la longueur d’enregistrements du fichier, ceux-ci sont complétés (“paddés”) : • par des zéros binaires (x00) lorsque les données locales sont déclarées binaires (FCODE = BINARY), • par des espaces lorsque les données locales sont déclarées alphanumériques avec, soit : –

FCODE = ASCII

: le caractère espace vaut alors x ‘20’,

–

FCODE = EBCDIC

: il vaut alors x ‘40’ (hexadécimal).

Longueurs d’enregistrement par défaut implémentées dans les internes de certains systèmes (longueur prise en compte si l’information correspondante n’est fournie ni par l’émetteur du fichier, ni par les paramètres locaux) : WinNT

4-40

Valeur par défaut : 512.

UNIX

Valeur par défaut : 512 pour les fichiers texte (FTYPE=T, O ou X), : 4096 pour les fichiers binaires (FTYPE = B).

VOS

Valeur par défaut : 2048.

CFT V2.3

Manuel de référence

[FNAME

= filename]

Nom du fichier physique récepteur (nom simple ou “pathname” complet) ou nom de répertoire. En fonctionnement serveur récepteur, ce paramètre est d’usage obligatoire. En fonctionnement demandeur récepteur, le nom du fichier peut être précisé dans la commande de réception RECV ou au niveau de la commande CFTRECV. Sauf en cas de transfert improvisé, l’utilisateur optera de préférence pour la deuxième solution. Cas particulier de l’emploi du nom de fichier complet Dans le nom de “path” complet apparaissent des noms de répertoires (ou de toute autre organisation, spécifique à l’environnement concerné, servant à regrouper les fichiers : bibliothèque, catalogue, PDS ...). Suivant l’environnement concerné, l’emploi d’un “pathname” complet peut entraîner la création implicite d’une partie ou de la totalité d’une arborescence. Un caractère spécifique (suivant le système d’exploitation) délimitera l’arborescence (les niveaux de répertoires intermédiaires) susceptible d’être créée. Seuls les noms de sousrépertoires apparaissant à droite du caractère délimiteur seront créés. Le nom du fichier peut : • être constitué dynamiquement à partir de variables symboliques, • correspondre au nom d’un fichier à versions (par exemple GDG). Utilisation des variables symboliques Les variables utilisables pour la constitution de la chaîne de caractères FNAME sont les suivantes : • &FDATE, &FTIME, &FYEAR, &FMONTH, &FDAY, • &SPART, &RPART, &PART, &NPART, &GROUP, • &SUSER, &RUSER, • &SAPPL, &RAPPL, • &IDF, &PARM, &IDA, • &NIDF, &IDTU, &IDT, • &BDATE, &BTIME, &BYEAR, &BMONTH, &BDAY, • &NFNAME, • &NFVER. Le caractère ‘&’ remplace ici le caractère char_symb spécifique à chaque système d’exploitation (consultez le “Guide d’exploitation” de CFT correspondant à votre OS).

CFT V2.3

4-41

Les commandes de paramétrage de l’environnement des transferts

PeSIT E CFT/CFT

Les variables &FUNIT, &FUNITC, &FPATH, &FROOT, &FSUF sont utilisées pour que le paramètre FNAME donne une description complète du "path" d'écriture du fichier.

Cas particulier de la variable symbolique &NFNAME

PeSIT D profil CFT

PeSIT E CFT/CFT

L’emploi de &NFNAME n’est valide que si le moniteur est serveur récepteur. Cette variable est uniquement utilisée en mode ouvert. Pour une information détaillée sur le mode ouvert, consultez dans le guide “Concepts” de CFT, le paragraphe “Localisation des fichiers” et les exemples donnés dans l’annexe “Localisation des fichiers physiques”. Réception d’un fichier à versions

MVS VMS

Ce nom comporte une racine et un numéro de version. La réception s’effectue sur le fichier temporaire défini dans le paramètre WFNAME et concerne obligatoirement la version +1 du fichier récepteur (fonctionnement avec RENAME obligatoire). La traduction du nom relatif du fichier en nom absolu s’effectue en fin de transfert. Le fichier temporaire est alors renommé avec le nom défini par FNAME. Remarque : lorsqu’un fichier temporaire est utilisé (paramètre WFNAME), il peut y avoir des restrictions liées au système d’exploitation. Sur les systèmes IBM et GCOS7, par exemple, le type d’unité ne doit pas apparaître dans le nom de fichier FNAME. Pour des informations complémentaires sur les mécanismes mis en oeuvre, consultez l’annexe “Localisation des fichiers physiques” dans le guide “Concepts” de CFT. PeSIT profil CFT/CFT

Réception d’un groupe de fichiers copiés/”concaténés”. Ce nom doit correspondre à un nom de répertoire lorsqu’il y a eu traitement de copie/”concaténation” à l’émission (transfert d’un groupe de fichiers entre systèmes homogènes). La réception des données transférées s’effectue sur le fichier temporaire défini dans le paramètre WFNAME. Le traitement de ”déconcaténation” s’effectue ensuite sur le répertoire spécifié par FNAME.

Pour une information complémentaire, consultez l’annexe “Emission d’un groupe de fichiers” dans le guide “Concepts” de CFT.

[FORCE

= {NO | YES}]

Détermination de la priorité de prise en compte des paramètres valorisés dans CFTRECV et par rapport à ceux valorisés dans une commande RECV associé. • FORCE = NO : les paramètres spécifiés dans la commande RECV sont prioritaires par rapport à ceux définis dans la commande CFTRECV associée. Ainsi, si un paramètre n’est pas explicitement renseigné dans RECV mais dans CFTRECV, c’est la valeur renseignée dans cette commande CFTRECV qui sera prise en compte.

4-42

CFT V2.3

Manuel de référence

• FORCE = YES : les paramètres spécifiés dans CFTRECV sont prioritaires par rapport à ceux définis dans une commande RECV associée. Ainsi, si un paramètre n’est pas explicitement renseigné dans CFTRECV mais dans RECV ou si la valeur renseignée dans CFTRECV est la valeur par défaut, c’est la valeur renseignée dans cette commande RECV qui sera prise en compte. [FORG

= {SEQ | DIRECT | INDEXED}]

OS

Organisation du fichier récepteur : • SEQ

: séquentielle,

• INDEXED

: indexée,

• DIRECT

: relative (accès direct).

Sur certains systèmes d’exploitation, le mécanisme de réception séquentielle peut éventuellement assurer le remplissage d’un fichier d’organisation non séquentielle (normalement pré existant). Suivant le cas, l’emploi explicite de paramètres tels que FTYPE, FKEYLEN, FKEYPOS et FORG peut être nécessaire. Pour une information complémentaire, consultez le “Guide d’exploitation” CFT correspondant à votre OS. [FRECFM

= {voir “Guide d’exploitation” | F | U | V}]

OS

Format des enregistrements du fichier récepteur : • F : fixe, • V : variable, • U : indéfini (“undefined”). Les valeurs possibles par système sont indiquées dans le “Guide d’exploitation” de CFT correspondant à votre OS. OS400

UNIX

La notion de format variable est propre à CFT, et ne correspond pas à une réalité pour les systèmes indiqués. Un fichier récepteur de format variable n’est donc pas interprétable directement par une application, car il contient des informations de contrôle. Sauf exception, par exemple la commutation de fichiers, on n’utilisera pas FRECFM = V.

Consultez le “Guide d’exploitation” de CFT correspondant à votre OS. [FSPACE

= n]

Taille du fichier récepteur, en K-octets (1 K-octet = 1024 octets). Cette taille correspond usuellement à l’“allocation primaire”. UNIX

CFT V2.3

Paramètre ineffectif.

4-43

Les commandes de paramétrage de l’environnement des transferts

[FTYPE

={ voir “Guide d’exploitation” | c}]

OS

Type du fichier récepteur. Dans certaines configurations de type client/serveur, le fichier local peut être physiquement implanté sur une autre machine que celle sur laquelle CFT s’exécute. Consultez le “Guide d’exploitation” de CFT correspondant à votre OS. [GROUPID

= string]

Information qui complète le USERID de la commande CFTRECV. ID

= identifier

{1..8}

Identifiant local de fichier type (IDF). La valeur “COMMUT” pour ce paramètre prend un sens particulier pour CFT : elle correspond à la description des fichiers reçus en tant que partenaire intermédiaire. Pour que la commutation soit acceptée, il faut que la commande (CFTRECV ID = COMMUT) soit paramétrée explicitement sur le site de commutation. Dans le cas contraire, la commutation est refusée. PeSIT profil SIT

[MACTION

En protocole PeSIT profil SIT, l’identifiant de fichier type est soumis à la contrainte de format (Fnnnnn) décrite dans le “Guide des protocoles” de CFT.

={ “ ” | REPLACE}]

Action sur les fichiers transférés par COPY au moment de la création : • “ ” : si les fichiers existent déjà sur le répertoire de réception, la copie de ces fichiers est ignorée, • REPLACE : si les fichiers existent déjà sur le répertoire, ils seront remplacés. [MAXDATE

= {voir le commentaire | date}]

Pris en compte uniquement en mode demandeur

Dernier jour de validité des transferts. La valeur ‘date’ peut être exprimée : • explicitement (date absolue), • ou dans les commandes RECV, d’une manière relative par rapport à la date de prise en compte de la commande. Cette valeur est alors exprimée en nombre de jours. Exemple : MAXDATE = +4 signifie que le dernier jour de validité du transfert est dans 4 jours par rapport à la date de prise en compte de la commande. La valeur par défaut est affectée par le moniteur, selon le contexte du transfert. Consultez le paragraphe “Transferts différés” dans le guide “Concepts” de CFT.

4-44

CFT V2.3

Manuel de référence

[MAXTIME

= {23595999 | time}]

Pris en compte uniquement en mode demandeur

Heure maximum de validité du transfert, pour le dernier jour (MAXDATE). La valeur ‘time’ peut être exprimée : • explicitement (heure absolue), • ou dans les commandes RECV, d’une manière relative par rapport à l’heure de prise en compte de la commande. Dans ce cas, l’heure absolue correspondante doit être inférieure à 24 heures. La valeur indiquée est exprimée en minutes. Exemple : MAXTIME = +180 signifie que l’heure maximum de validité du transfert est l’heure de prise en compte de la commande additionnée de 180 minutes. Cette heure de prise en compte doit être inférieure à 21 h. MAXTIME ne doit pas être égal à MINTIME sauf si MAXDATE est renseigné et n’est pas la date du jour. [MINDATE

= {date système du jour | date}] Pris en compte uniquement en mode demandeur

Premier jour de validité des transferts. La valeur ‘date’ peut être exprimée : • explicitement (date absolue), • ou dans les commandes RECV, d’une manière relative par rapport à la date de prise en compte de la commande. Cette valeur est alors exprimée en nombre de jours. Exemple : MINDATE = +2 signifie que le premier jour de validité du transfert est dans 2 jours par rapport à la date de prise en compte de la commande. Consultez le paragraphe “Transferts différés” dans le guide “Concepts” de CFT. [MINTIME

= {00000000 | time}]

Pris en compte uniquement en mode demandeur

Heure minimum de validité du transfert, pour le premier jour (MINDATE). La valeur ‘time’ peut être exprimée : • explicitement (heure absolue), • ou dans les commandes RECV, d’une manière relative par rapport à l’heure de prise en compte de la commande. Dans ce cas, l’heure absolue correspondante doit être inférieure à 24 heures. La valeur indiquée est exprimée en minutes. Exemple : MINTIME = +30 signifie que l’heure minimum de validité du transfert est l’heure de prise en compte de la commande additionnée de 30 minutes. Cette heure de prise en compte doit être inférieure à 23 h 30. MINTIME ne doit pas être égal à MAXTIME sauf si MAXDATE est renseigné et n’est pas la date du jour.

CFT V2.3

4-45

Les commandes de paramétrage de l’environnement des transferts

[NCOMP

PeSIT D profil CFT

= {voir le commentaire | cpr}]

PeSIT D profil EXTERN

PeSIT E

Compression des données en ligne, souhaitée par le récepteur. Ce paramètre est utilisé lorsque la valeur du paramètre RCOMP de la commande CFTPROT est excessive pour le fichier type considéré. Les valeurs autorisées, ainsi que les valeurs par défaut, pour le paramètre NCOMP de la commande CFTRECV, sont les mêmes que pour le paramètre RCOMP de la commande CFTPROT. Lors d’une réception, la combinaison des valeurs prises par ces deux paramètres, sert de base à la négociation protocolaire de la compression des données en ligne. Se reporter à l’annexe “Compression” pour plus de détails. [NOTIFY

= {voir le tableau | identifier}]

Définit la destination des messages associés à l’émission parmi les messages du journal, par la valeur du paramètre OPERMSG. La valeur de ce paramètre est une chaîne de 8 caractères cadrée à gauche. La destination de ces messages peut être, suivant les systèmes : • le “submitter” du moniteur CFT correspondant à la sortie standard associée au moniteur CFT (l’écran de soumission, par exemple). La valeur du paramètre NOTIFY doit être alors renseignée à ‘ blancs),

’ (8 caractères

• une console opérateur. La valeur du paramètre NOTIFY doit commencer par les 2 caractères OP, • un utilisateur de la machine. La valeur du paramètre NOTIFY indique l’identifiant système de l’utilisateur selon le format “xxxxxxxx”. Le tableau suivant indique les destinataires possibles suivant le système. Tableau 50. CFTRECV NOTIFY - Destinataires possibles OS

Submitter du moniteur

Console opérateur

Utilisateur quelconque

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

OUI NON OUI NON OUI OUI NON NON OUI NON OUI

OUI OUI OUI OUI OUI OUI OUI OUI OUI OUI NON

NON NON OUI OUI OUI OUI OUI OUI OUI NON NON

Explications sur le contenu du tableau : “OUI” signifie que le type de destinataire correspondant existe. “NON” signifie que le type de destinataire correspondant n’existe pas.

4-46

CFT V2.3

Manuel de référence

Le tableau suivant indique, pour le paramètre NOTIFY, les valeurs par défaut supportées pour chaque système. Tableau 51. CFTRECV NOTIFY - Valeurs par défaut OS GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

Valeur par défaut pour NOTIFY OP ‘ ’ OPLOG OP ‘ ’ ‘ ’ OP OP ‘ ’ ‘ ’ ‘ ’

Explications sur le contenu du tableau : la valeur ‘ ’ correspond à 8 caractères blancs. Dans le cas “console opérateur”, les choix possibles sont indiqués dans le tableau suivant. Tableau 52. CFTRECV NOTIFY - Choix dans le cas «console opérateur» OS “console opérateur” GCOS7 GCOS8

GUARDIAN MVS OS400 UNIX VM VMS

VOS

VSE WinNT

Caractères interprétés OP OP000001 OP000002 OP000003 OP000004 OP OP OP OP OP OP

OP ou OPxxxxxx OP Sans objet

Messages dirigés vers La console opérateur La console opérateur désignée par un numéro : • console TY1 • console TY2 • console TY3 • console TY4 La console opérateur La (ou les) console(s) opérateur(s) La “message-queue” QSYSOPR La console opérateur La machine opérateur La console système et le fichier LOG système périphérique de sortie identifié par le lien “xxxxxx” présent dans le répertoire courant d’exécution du moniteur La console système et dans le fichier LOG système périphérique de sortie identifié par le lien “xxxxxx” présent dans le répertoire courant d’exécution du moniteur La console opérateur

Explications sur le contenu du tableau : s’il est indiqué ‘OP’ pour les caractères interprétés, seuls ces 2 caractères (OP) sont interprétés ; les caractères suivants sont non significatifs.

CFT V2.3

4-47

Les commandes de paramétrage de l’environnement des transferts

Dans le cas “utilisateur” : MVS

Les messages CFT sont émis par SEND à destination du USERID TSO précisé. Dans ce cas, le programme “Moniteur CFT” doit être autorisé (APF).

VMS

Les messages sont dirigés vers le “User VMS” désigné par son nom VMS. Dans ce cas, la tâche “moniteur CFT” doit posséder le privilège OPER.

VM

Les messages sont émis par ‘MSGNOH’ selon les privilèges accordés.

[OPERMSG

={voir le tableau | n} ]

{0..255}

Définit les catégories de messages d’information sur les transferts destinées à l’opérateur (tous les messages étant, par ailleurs, inscrits dans le fichier de journalisation). Il s’agit d’un sous-ensemble des messages du journal CFT, défini par la somme algébrique des valeurs indiquées dans le tableau ci-après. Tableau 53. Catégories des messages d’information sur les transferts Valeur

Catégorie de message

Type

1 2 4 8 16 32 64 128

Messages d’information d’exploitation Messages d’information système Messages d’attention d’exploitation Messages d’attention système Messages d’erreur d’exploitation Messages d’erreur système Messages d’erreur fatale d’exploitation Messages d’erreur fatale système

I I W W E E F F

Explications sur le contenu du tableau : les types I,W,E,F correspondent au type de message indiqué dans le journal (consultez le guide “Codes diagnostics et messages” de CFT). La valeur “0” signifie qu’aucun message n’est redirigé vers l’opérateur. Le tableau suivant indique, pour le paramètre OPERMSG, les valeurs par défaut supportées pour chaque système. Tableau 54. CFTRECV OPERMSG - Valeurs par défaut

4-48

OS

Valeur par défaut pour OPERMSG

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

0 0 3 0 0 3 0 0 3 0 0

CFT V2.3

Manuel de référence

[PRI

= {128 | n}]

{0..255}

Définit la priorité de sélection de la demande de réception. La valeur la plus élevée du paramètre PRI est 255. Le moniteur (demandeur) sélectionne en priorité les demandes de transfert de priorité élevée pour un partenaire donné. [RAPPL

= string] string8 string48

PeSIT D profil CFT

PeSIT E

PeSIT E CFT/CFT

Identifiant de l’application réceptrice du fichier. Lorsque la chaîne de caractères est entre guillemets, la valeur est prise telle quelle en respectant les majuscules et les minuscules. When the character string is between quotes, the value is considered case-sensitive and used as is. Lors de la saisie de ce paramètre, il n’y a pas de contrôle de sa pertinence vis-à-vis du protocole qui sera utilisé pour le transfert : si le protocole utilisé est PeSIT D profil Extern, ETEBAC 3, ODETTE, ce paramètre ne sera pas transmis. De plus la taille maximum permise par le protocole utilisé n’est pas contrôlée. Seul un contrôle relatif à la taille maximum de 48 caractères (autorisé en PeSIT E entre deux CFT) est effectif. Remarque : en PeSIT E standard, la valeur du paramètre RAPPL est transporté dans le PI 04. Sa longueur maximum est limitée par le standard à 8 caractères. Ce PI 04 contient cette valeur concaténée avec celle du paramètre RUSER. En PeSIT E entre 2 moniteurs CFT, si ce paramètre RAPPL a une valeur de longueur supérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dans le PI 04 étant tronquée à 8 caractères. PeSIT D profil CFT

PeSIT E standard

Ce paramètre ne doit pas être renseigné, en profil CFT de PeSIT, lorsque le moniteur partenaire est CFT/370 Version 1 ou un CFT/PC. Ce paramètre peut être transmis et contrôlé par le partenaire serveur/émetteur.

PeSIT E CFT/CFT

RKERROR

= {“ ” | DELETE | KEEP}]

Action à entreprendre lorsqu’un transfert échoue en phase de sélection (mode serveur) : • KEEP : le transfert reste au catalogue, • DELETE : il est supprimé du catalogue. Si le paramètre est à blanc, c’est la valeur contenue dans le paramètre RKERROR de la commande CFTCAT qui va être prise en compte.

CFT V2.3

4-49

Les commandes de paramétrage de l’environnement des transferts

[RUSER

= string] string8 string28

PeSIT D profil CFT

PeSIT E

PeSIT E CFT/CFT

Identifiant de l’utilisateur récepteur du fichier. Lorsque la chaîne de caractères est entre guillemets, la valeur est prise telle quelle en respectant les majuscules et les minuscules. When the character string is between quotes, the value is considered case-sensitive and used as is. Lors de la saisie de ce paramètre, il n’y a pas de contrôle de sa pertinence vis-à-vis du protocole qui sera utilisé pour le transfert : si le protocole utilisé est PeSIT D profil Extern, PeSIT profil SIT, ETEBAC 3, ODETTE, ce paramètre ne sera pas transmis. De plus la taille maximum permise par le protocole qui sera utilisé n’est pas contrôlée. Seul un contrôle relatif à la taille maximum de 28 caractères (autorisé en PeSIT E entre deux CFT) est effectif. Remarque : en PeSIT E standard, la valeur du paramètre RUSER est transporté dans le PI 04. Sa longueur maximum est limitée par le standard à 8 caractères. Ce PI 04 contient cette valeur concaténée avec celle du paramètre RAPPL. En PeSIT E entre 2 moniteurs CFT, si ce paramètre RUSER a une valeur de longueur supérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dans le PI 04 étant tronquée à 8 caractères. PeSIT D profil CFT

PeSIT E standard

Ce paramètre ne doit pas être renseigné, en profil CFT de PeSIT, lorsque le moniteur partenaire est CFT/370 Version 1 ou un CFT/PC. Ce paramètre peut être transmis et contrôlé par le partenaire serveur/émetteur.

PeSIT E CFT/CFT

[SAPPL

= string] string8 string48

PeSIT profil SIT

PeSIT D profil CFT

PeSIT E

PeSIT E CFT/CFT

Identifiant de l’application émettrice du fichier. Lorsque la chaîne de caractères est entre guillemets, la valeur est prise telle quelle en respectant les majuscules et les minuscules. When the character string is between quotes, the value is considered case-sensitive and used as is. Lors de la saisie de ce paramètre, il n’y a pas de contrôle de sa pertinence vis-à-vis du protocole qui sera utilisé pour le transfert : si le protocole utilisé est PeSIT D profil Extern, ETEBAC 3, ODETTE, ce paramètre ne sera pas transmis.

4-50

CFT V2.3

Manuel de référence

De plus la taille maximum permise par le protocole qui sera utilisé n’est pas contrôlée. Seul un contrôle relatif à la taille maximum de 48 caractères (autorisé en PeSIT E entre deux CFT) est effectif. Remarque : en PeSIT E standard, la valeur du paramètre SAPPL est transporté dans le PI 03. Sa longueur maximum est limitée par le standard à 8 caractères. Ce PI 03 contient cette valeur concaténée avec celle du paramètre SUSER. En PeSIT E entre 2 moniteurs CFT, si ce paramètre SAPPL a une valeur de longueur supérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dans le PI 03 étant tronquée à 8 caractères. PeSIT D profil CFT

PeSIT E standard

Ce paramètre ne doit pas être renseigné, en profil CFT de PeSIT, lorsque le moniteur partenaire est CFT/370 Version 1 ou un CFT/PC. Ce paramètre peut être transmis et contrôlé par le partenaire serveur/émetteur.

PeSIT E CFT/CFT

[STATE

= {DISP | HOLD | KEEP}

Définit l’état de la requête de transfert : • DISP : la requête est enregistrée en état ‘D’ (disponible) dans le catalogue ; cet état correspond à un transfert “immédiat” (c’est-à-dire s’exécutant dès que possible, compte tenu des contraintes de plages horaires, de parallélisme des transferts, etc.), • HOLD : la requête est enregistrée en état ‘H’ dans le catalogue ; cet état correspond à un transfert différé. Le transfert s’exécutera ultérieurement soit : -

sur acceptation d’une demande de réception d’origine distante,

-

à la suite d’une commande locale START ayant fait passer ce transfert à l’état disponible (‘D’),

• KEEP : la requête est enregistrée en état ‘K’ dans le catalogue ; cet état correspond à un transfert différé : le transfert ne pourra s’exécuter, ultérieurement, qu’à la suite d’une commande locale START (l’ayant fait passer à l’état disponible). [SUSER

= string] string8 string28

PeSIT D profil CFT

PeSIT E

PeSIT E CFT/CFT

Identifiant de l’utilisateur émetteur du fichier. Lorsque la chaîne de caractères est entre guillemets, la valeur est prise telle quelle en respectant les majuscules et les minuscules. When the character string is between quotes, the value is considered case-sensitive and used as is. Lors de la saisie de ce paramètre, il n’y a pas de contrôle de sa pertinence vis-à-vis du protocole qui sera utilisé pour le transfert : si le protocole utilisé est PeSIT D profil Extern, PeSIT profil SIT, ETEBAC 3, ODETTE, ce paramètre ne sera pas transmis.

CFT V2.3

4-51

Les commandes de paramétrage de l’environnement des transferts

De plus la taille maximum permise par le protocole qui sera utilisé n’est pas contrôlée. Seul un contrôle relatif à la taille maximum de 28 caractères (autorisé en PeSIT E entre deux CFT) est effectif. Remarque : en PeSIT E standard, la valeur du paramètre SUSER est transporté dans le PI 03. Sa longueur maximum est limitée par le standard à 8 caractères. Ce PI 03 contient cette valeur concaténée avec celle du paramètre SAPPL. En PeSIT E entre 2 moniteurs CFT, si ce paramètre SUSER a une valeur de longueur supérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dans le PI 03 étant tronquée à 8 caractères. PeSIT D profil CFT

PeSIT E standard

Ce paramètre ne doit pas être renseigné, en profil CFT de PeSIT, lorsque le moniteur partenaire est CFT/370 Version 1 ou un CFT/PC.

Ce paramètre peut être transmis et contrôlé par le partenaire serveur/émetteur.

PeSIT E CFT/CFT

[TRK

= {"valeur de TRKRECV de CFTPART" | ALL | NO | SUMMARY | UNDEFINED}]

Spécification du niveau de détail que CFT fournit à Sentinel sur les transferts. CFT envoie les informations sur le transfert sous forme d'occurrences de suivi. Les valeurs possibles de ce paramétre sont : • NO :

le moniteur n'envoie jamais d'occurrences de suivi à Sentinel,

• ALL :

le moniteur envoie une occurrence de suivi à Sentinel pour chaque étape de chaque transfert,

• SUMMARY : le moniteur envoie une occurrence de suivi à Sentinel uniquement pour l'étape initiale et l'étape finale de chaque transfert, • UNDEFINED : les options de suivi sont définies dans le paramètre TRK de la commande CFTPART. TRK n'est utilisable qu'à partir de la version CFT V2.3.1. [USERID

= {“userid du moniteur CFT” | string15}]

Identifiant du propriétaire du transfert. Ce paramètre est utilisé en serveur récepteur pour définir le propriétaire du transfert associé à une commande CFTRECV. Si ce paramètre n’est pas renseigné, sa valeur par défaut est l’“userid” système du moniteur CFT serveur. Remarque : pour les commandes RECV utilisées en demandeur récepteur, l’identifiant du propriétaire du transfert est l’“userid” système de l’utilisateur ayant activé la commande.

4-52

CFT V2.3

Manuel de référence

La valeur de ce paramètre peut comporter les variables symboliques : • &PART : valeur substituée par l’identifiant local du partenaire du transfert (ID de CFTPART), • &SUSER : valeur substituée par le paramètre SUSER transmis entre deux moniteurs CFT (protocole PeSIT D profil CFT et PeSIT E), • &RUSER : valeur substituée par le paramètre RUSER transmis entre deux moniteurs CFT (protocole PeSIT D profil CFT et PeSIT E). [WFNAME VM

= filename]

OS

Paramètre non pertinent.

Nom du fichier temporaire utilisé en cours de transfert. Le fichier ainsi constitué est renommé à la fin du transfert avec le nom défini par le paramètre FNAME. L’emploi d’un fichier temporaire permet d’assurer l’intégrité du fichier reçu : le fichier exploitable (par une application utilisateur par exemple) n’est disponible qu’à la fin du transfert. Le nom de ce fichier peut être composé des variables symboliques suivantes : • &FDATE, &FTIME, &FYEAR, &FMONTH, &FDAY, • &BDATE, &BTIME, &BYEAR, &BMONTH, &BDAY, • &SPART, &RPART, &PART, &NPART, &GROUP, • &SUSER, &RUSER, • &SAPPL, &RAPPL, • &IDF, &PARM, &IDA, • &NIDF, &NFNAME, • &IDT. Le caractère ‘&’ remplace ici le caractère char_symb (consultez le “Guide d’exploitation” de CFT correspondant à votre OS). L’utilisateur veillera à l’unicité du nom attribué ainsi qu’aux problèmes de conflit d’accès. Ce paramètre peut être utilisé dans le cadre de la commutation “store and forward” (commande CFTRECV ID = COMMUT). MVS

VMS

Ce paramètre est obligatoire si le fichier récepteur est un fichier à versions (notamment dans le cas où on travaille en mode ouvert et que l’émetteur envoie un NFNAME correspondant à un nom de GDG).

Ce paramètre est obligatoire lorsqu’il y a eu traitement de copie/”concaténation” à l’émission (transfert d’un groupe de fichiers en PeSIT CFT/CFT).

CFT V2.3

4-53

Les commandes de paramétrage de l’environnement des transferts

[XLATE

= identifier]

Identifiant de la commande CFTXLATE définissant la table de transcodage utilisée pour les réceptions. La commande de transfert RECV permet de spécifier une autre table de transcodage que celle attachée au fichier type. Consultez dans le manuel “Concepts” de CFT, le paragraphe “Transcodage”, pour des informations complémentaires sur la mise en oeuvre des tables de transcodage.

4.2.1.4. Exemples Exemple 1 : CFTRECV

MODE ID FDISP FACTION XLATE

= = = = =

REPLACE, SRCFILES, BOTH, ERASE, ETOA

/* /* /* /*

IDF pour fichiers source Existe deja ou non Si existe Remis à blanc avec cette table ...

*/ */ */ */

Le jeu de paramètres correspondant à cette commande est exploité, lors d’une réception de données, si l’IDF du transfert a pour valeur explicite “SRCFILES”. Le moniteur dispose ainsi de valeurs par défaut pour la gestion du fichier récepteur. Le paramètre FNAME n’est pas renseigné. Le moniteur ne pourra donc fonctionner que si une commande RECV spécifiant FNAME a été déposée (CFT est demandeur), ou si le partenaire (CFT est serveur) a précisé le nom du fichier récepteur (mode ouvert en réception). Exemple 2 : CFTRECV

MODE ID FDISP FACTION

= = = =

REPLACE, IDFDEF, BOTH, DELETE,

/* IDF par défaut /* Existe deja ou non /* Si existe - supprimé

FNAME

=

R&IDT

/* Fichier selon valeur IDT */

*/ */ */

Cette commande correspond au cas de réception de données pour tous les transferts dont l’identifiant (IDF) n’a pas de description explicite (commande CFTRECV). C’est la description du fichier type récepteur “par défaut”. Il faut que la commande CFTPARM précise : CFTPARM DEFAULT = IDFDEF, ... CFT crée alors un fichier dont le nom contient l’identifiant (unique) du transfert. OS400

4-54

Cette commande répond au cas général de réception d’un fichier “data-base”.

CFT V2.3

Manuel de référence

4.2.2. Paramètres associés à un fichier type en cas de réception dans une base VFM En cas de réception dans un fichier logique d’une base VFM, le paramétrage de CFTRECV diffère sur les points suivants, par rapport au paramétrage de CFTRECV utilisé pour une réception de fichier physique : • il y a deux paramètres spécifiques : FDB et FCOMP, • le paramètre FNAME est le nom du fichier logique, • le paramètre WFNAME est sans objet, le nom du fichier temporaire étant géré par le produit VFM, • les paramètres FDISP, FORG, FTYPE et FBLKSIZE sont sans objet, leurs valeurs étant imposées par la méthode d’accès, • les paramètres FKEYLEN et FKEYPOS sont également sans objet, • le paramètre FACTION peut prendre la valeur supplémentaire CONCAT. Sa syntaxe complète est indiquée ci-après. Les explications relatives aux paramètres concernent uniquement les spécificités VFM. Pour les autres paramètres, voir dans ce même document les explications indiquées dans le paramétrage de CFTRECV utilisé pour une réception de fichier physique.

4.2.2.1. Syntaxe CFTRECV

CFT V2.3

[MODE ID [USERID [FORCE [EXEC [PRI [COMMENT [MINDATE [MAXDATE [MINTIME [MAXTIME [CYCDATE [CYCTIME [XLATE [NCOMP

= = = = = = = = = = = = = = =

{REPLACE | CREATE | DELETE},] identifier, {“userid” du moniteur CFT | string},] {NO | YES},] filename, ] {128 | n},] string,] {date système du jour | date},] date,] {00000000 | time},] {23595999 | time},] date,] time,] identifier,] cpr,]

[FCODE

= {ASCII | BINARY | EBCDIC},]

[EXIT [FNAME [FSPACE [FLRECL

= = = =

[FRECFM

= {F | U | V},]

PROTOCOLE Dft : OS

identifier,] filename,] n,] n,] OS

4-55

Les commandes de paramétrage de l’environnement des transferts

[FACTION [FDB [FCOMP

= = =

{CONCAT | DELETE | ERASE | VERIFY},] filename,] {0 | 15}]

4.2.2.2. Paramètres [FACTION

= {CONCAT | DELETE | ERASE | VERIFY}]

Action à entreprendre avant la réception du fichier. Cette action s’applique au fichier récepteur lorsqu’il existe déjà avant le transfert. Les actions sont les suivantes : • CONCAT : concaténation des données. Les données reçues s’ajoutent à celles du fichier logique existant. Si le fichier logique “FNAME” : -

existe déjà, les données reçues sont “chaînées” à celles du fichier “FNAME”,

-

n’existe pas, le fichier logique est créé,

• VERIFY : vérification que le fichier est vide, • ERASE : remise à zéro (effacement) du fichier, • DELETE : suppression du fichier. [FDB

= filename]

Nom de la base VFM (fichier DATA) contenant le fichier logique récepteur. [FCOMP

= {0 | 15}]

Définit la compression {VFM} des données dans le fichier logique récepteur. 2 valeurs sont possibles : • 0 : pas de compression, • 15 : compression selon l’algorithme propre à VFM. Si FCODE ou NCODE est égal à BINARY, les données seront stockées dans la base VFM sous forme non compressées, quelle que soit la valeur du paramètre FCOMP. [FNAME

= filename]

Nom du fichier logique de la base (FDB) récepteur. Attention : le moniteur CFT exploite comme enveloppe réceptrice un fichier logique temporaire de la même base VFM, dont le nom est : CFT.RECV.TEMP.&PART.&IDT dans lequel : • &PART correspond à l’identifiant local du partenaire, • &IDT correspond à l’identifiant de transfert.

4-56

CFT V2.3

Manuel de référence

Attention : en aucun cas ce fichier temporaire ne doit être accédé, en lecture comme en écriture. Ce fichier est protégé par la méthode d’accès VFM en cours de transfert, mais ne l’est plus en cas d’interruption du transfert. En fin de transfert, les données sont effectivement affectées au fichier FNAME.

4.2.2.3. Exemple CFTRECV MODE ID FACTION FDB FNAME

= = = = =

REPLACE, IDFDEF, CONCAT, BASE2.VFM, R&PART(0)

/* /* /* /*

IDF par défaut Ajout des données Nom base VFM Fichier selon valeur partenaire

*/ */ */ */

Description d’un fichier type en réception sur une base VFM. Les données reçues de chaque partenaire seront concaténées dans le fichier logique R(0).

4.3 CFTEXIT - Activatio n d’une tâche “exit” Cette commande décrit l’environnement de lancement d’une tâche d’EXIT et permet l’activation de cette tâche. A une commande CFTEXIT correspond une tâche EXIT. Suivant le cas, cette commande est activée : • à différentes étapes de la transmission d’un fichier (EXIT de type fichier), • en début de transfert en cas d’emploi du protocole ETEBAC 3 (EXIT de type ETEBAC 3), • en phase de connexion protocolaire (EXIT de type annuaire), • en fin de transfert (EXIT de type fin de transfert). Le nombre maximum de tâches EXIT simultanément actives est limité à 16. Pour une information complémentaire, consultez le “Guide de programmation” de CFT.

4.3.1. Syntaxe CFTEXIT ID TYPE [LANGUAGE [MODE [PARM [PROG [RESERV [WAITTASK

CFT V2.3

= = = = = = = =

identifier, {FILE | ACCESS | ETEBAC | EXEC}] {COBOL | C},] {REPLACE | CREATE | DELETE},] string,] {CFTEXIT | string},] {8192 | 1024 | n},] {1441 | n}]

4-57

Les commandes de paramétrage de l’environnement des transferts

4.3.2. Paramètres ID

= identifier Identifiant de la commande (sur 8 caractères). La valeur de cet identifiant désigne l’identifiant correspondant dans les commandes associées explicitées ci-dessous. Tableau 55. CFTEXIT ID - Commande et paramètre associé à l’EXIT traité EXIT

Commande

Paramètre

De type annuaire

CFTPROT

De type ETEBAC De type fichier

CFTPROT CFTSEND, SEND CFTRECV, RECV CFTPARM

EXITA EXIT EXITE EXIT

De type fin de transfert

EXITEOT

[LANGUAGE = {COBOL | C}] Langage utilisé pour l’écriture du programme écrit par l’utilisateur. Les valeurs possibles sont COBOL et langage C. Cet attribut permet à CFT d’échanger avec le programme utilisateur de l’EXIT des données via la structure la mieux appropriée à son langage d’implémentation. [PARM

= string64]

Zone libre à la disposition de l’utilisateur. [PROG

= {CFTEXIT | string8}]

Nom du module exécutable correspondant à la tâche EXIT à activer. Ce module est constitué de l’interface fournie avec le produit CFT linkée avec le programme écrit par l’utilisateur. Afin de reconnaître plus facilement les modules associés, il est conseillé de nommer ces modules de la façon suivante : • CFTEXA : EXIT de type annuaire, • CFTEX3 : EXIT de type ETEBAC, • CFTEXF : EXIT de type fichier, • CFTEXE : EXIT de type fin de transfert. Il est possible d’y associer un numéro d’ordre dans les deux derniers caractères (exemple : CFTEXA01).

4-58

CFT V2.3

Manuel de référence

[RESERV

= {8192 | 1024 | n}]

{0..1024} {0..8192}

Taille de la zone de travail réservée à l’utilisateur. Cette zone n’est pas utilisée par l’interface CFT. L’utilisateur y sauvegarde les informations qu’il juge nécessaire pour les besoins des traitements relatifs au programme qu’il a écrit. Cette zone est désallouée après la “désélection” du fichier par l’interface CFT. Ce paramètre est sans objet pour l’EXIT de type ETEBAC et l’EXIT de type fin de transfert. Tableau 56. CFTEXIT RESERV - Valeurs par défaut et plage de valeurs EXIT

Valeur par défaut

Plage de valeurs

De type annuaire De type fichier

1024 8192

{0 ...1024} {0 ...8192}

TYPE

= {FILE | ACCESS | ETEBAC | EXEC}

Type de l’EXIT : • ACCESS

: EXIT de type annuaire,

• ETEBAC

: EXIT de type ETEBAC,

• FILE

: EXIT de type fichier,

• EXEC

: EXIT de type fin de transfert.

[WAITTASK

= {1441 | n}]

Temps d’inactivité (en minutes) de la tâche EXIT avant arrêt automatique. Cette tâche est permanente si cette valeur est égale à 1441. Ce paramètre n’a de sens que pour l’EXIT de type fichier.

4.3.3. Exemples Exemple de paramétrage d’un EXIT de type fichier : CFTSEND

ID EXIT

= PAYE, = IDEXIT

CFTEXIT

ID LANGUAGE RESERV PROG

= = = =

IDEXIT, C, 4000, FILEXEC

Exemple de paramétrage d’un EXIT de type annuaire : CFTPROT

CFT V2.3

ID TYPE EXIT

= PSIDTH, = PESIT, = EXA

4-59

Les commandes de paramétrage de l’environnement des transferts

CFTEXIT

ID PARM LANGUAGE PROG TYPE

= = = = =

EXA, SAMPLE, C, MYEXA, ACCESS

Exemple de paramétrage d’un EXIT de type ETEBAC 3 : CFTPROT

ID TYPE EXIT

= PSIDTB, = ETEBAC, = ETB

CFTEXIT

ID PARM LANGUAGE PROG TYPE

= = = = =

ETB, SAMPLE, C, MYETB, ETEBAC

4.4 CFTAUTH - Liste d ’identifiants de fichiers types (IDF) L’utilisateur peut définir des listes d’identifiants de fichiers (IDF), soumis aux mêmes autorisations ou interdictions de transfert. A chaque partenaire peuvent être associées : • une liste en émission, • et une liste en réception. L’identifiant de la liste en émission est défini par la valeur du paramètre SAUTH de CFTPART. L’identifiant de la liste en réception est défini par la valeur du paramètre RAUTH de CFTPART. Cette liste de partenaire peut être décrite soit : • explicitement à partir d’un paramètre type liste (paramètre IDF), • à partir d’un fichier dans lequel est enregistré cette liste. Le nom de ce fichier est défini par le paramètre FNAME. Ces deux méthodes sont exclusives : les paramètres IDF et FNAME ne peuvent être utilisés simultanément.

4.4.1. Syntaxe CFTAUTH [MODE ID IDF

= = =

{REPLACE | CREATE | DELETE},] identifier, (identifier | mask, identifier | mask,...)

[MODE ID FNAME

= = =

{REPLACE | CREATE | DELETE},] identifier, filename

CFTAUTH

4-60

CFT V2.3

Manuel de référence

4.4.2. Paramètres FNAME

= filename

Nom du fichier dans lequel est renseignée la liste des IDF autorisés ou interdits. Le nombre d’identifiants composant cette liste n’est pas limité. Pour constituer ce fichier, les règles suivantes doivent être suivies : • un enregistrement de ce fichier ne peut contenir qu’un seul IDF, • la taille d’un enregistrement est limitée à 80 caractères, • un IDF doit débuter en première colonne et seuls les 8 premiers caractères de l’enregistrement sont pris en compte, • les caractères au-delà de la colonne 8 sont ignorés et considérés comme un commentaire, • un identifiant peut être indifféremment saisi en caractères majuscules ou minuscules (il est transformé en majuscules), • le fichier peut contenir des enregistrements de longueur nulle. Les IDF indiqués dans ce fichier peuvent être : • explicites (de type identifier), • ou contenir un masque (de type mask) : tous les identifiants de fichiers correspondant à ce masque sont concernés. ID

= identifier Identifiant de la liste d’autorisation. Cet identifiant est défini dans les mots-clés SAUTH ou RAUTH de CFTPART. Si la valeur identifier commence par les caractères ‘NOT’, les IDF désignés par cette commande sont interdits pour le partenaire correspondant ; les autres IDF sont autorisés. Si la valeur identifier ne commence pas par les caractères ‘NOT’, les IDF désignés par cette commande sont autorisés pour le partenaire correspondant ; les autres IDF sont interdits.

IDF

= (identifier | mask, identifier | mask, ...) Liste des IDF autorisés ou interdits. Le nombre maximum d’identifiants composant cette liste est limité à 200. La valeur associée à chacun de ces IDF peut être : • un identifiant de type explicite d’un fichier (identifier), • un masque (mask) : tous les identifiants de fichiers correspondant à ce masque sont concernés par cette commande.

CFT V2.3

4-61

Les commandes de paramétrage de l’environnement des transferts

4.4.3. Exemple CFTPART

ID SAUTH . . .

= =

IBM1, SIBM1,

CFTPART

ID RAUTH . . .

= =

BULGC8, RBULGC8,

CFTAUTH

ID IDF

= =

SIBM1, (APLI1,APLI2,LISTE,CHQ*)

CFTAUTH

ID FNAME

= =

RBULGC8, fic21

avec le fichier de nom fic21 contenant : idfdef idf1 idf2 idf3 Dans cet exemple, le CFT local ne peut émettre vers le partenaire IBM1 que les fichiers d’identifiants type APLI1, APLI2, LISTE ainsi que ceux commençant par les 3 lettres CHQ. CFT ne peut recevoir du partenaire BULGC8 que les fichiers d’identifiant type idfdef, idf1, idf2, idf3.

4.5 CFTIDF - Identifian ts “réseau” d’un fichier type Tous protocoles SAUF PeSIT profil SIT

Si, pour des raisons de contraintes d’exploitation, les partenaires ne peuvent s’accorder sur des identifiants communs de fichiers, la notion d’identifiant “réseau” (NIDF) permet de rapprocher, pour un partenaire et un sens de transfert donnés, l’identifiant local (IDF) à l’identifiant de fichier fourni par le (ou transmis au) partenaire. La commande CFTIDF permet d’établir en local cette correspondance entre l’IDF local et le NIDF transmis ou reçu. D’autres manières d’établir cette correspondance sont indiquées dans l’annexe “Correspondance NIDF/IDF” du guide “Concepts” de CFT. En particulier, il est indiqué la valeur par défaut prise par le NIDF (transmis en mode demandeur) ou l’IDF (déduit du NIDF reçu, en mode serveur) affecté en cas d’absence de cette commande. En mode DELETE, seuls les paramètres ID, TYPE et PART sont obligatoires.

4-62

CFT V2.3

Manuel de référence

4.5.1. Syntaxe CFTIDF [MODE ID PART NIDF TYPE

= = = = =

{REPLACE | CREATE | DELETE},] identifier, identifier, string, {SEND | RECV}

4.5.2. Paramètres ID

= identifier Identifiant local du fichier sur le site local (IDF). Correspond à la valeur du paramètre ID de la commande CFTSEND/CFTRECV ou au paramètre IDF de la commande SEND/RECV.

NIDF

= string string7 string14 string28 string26 string28

PeSIT D PeSIT E PeSIT E CFT/CFT ODETTE ETEBAC 3

Identifiant réseau du fichier ; c’est la valeur qui transite sur le réseau. Il est impossible, pour un sens de transfert donné, d'avoir plusieurs commandes CFTIDF comportant un NIDF identique. Remarque : en PeSIT E standard, le NIDF est transporté dans le PI 12 (14 caractères maximum). En PeSIT E entre 2 moniteurs CFT, si le NIDF a une longueur supérieure à 14 caractères, cet NIDF est transporté dans le PI 99 (28 caractères maximum), la valeur indiquée dans le PI 12 étant tronquée à 14 caractères. PART

= identifier

Identifiant local du partenaire pour lequel la correspondance IDF/NIDF est valide. Même valeur que celle du paramètre ID de CFTPART.

CFT V2.3

4-63

Les commandes de paramétrage de l’environnement des transferts

TYPE

= {RECV | SEND}

Sens de transfert pour lequel cette correspondance est valide. Les valeurs indiquées sont : • SEND pour émission, • RECV pour réception.

4.5.3. Exemple PARTENAIRE B

PARTENAIRE A CFTIDF ID PART NIDF TYPE

= = = =

FICHIER, B, FICHIER_SITE_A, SEND

CFTIDF ID PART NIDF TYPE

= = = =

FICHIERA, A, FICHIER_SITE_A, RECV

Pour le partenaire A, l’identifiant local FICHIER correspond au nom réseau FICHIER_SITE_A en émission vers le partenaire B. Le partenaire B établit la correspondance entre le même identifiant réseau et l’identifiant local FICHIERA, lors d’une réception venant de A.

4.6 CFTXLATE - Table de transcodage utilisée lors d’un transfert La commande CFTXLATE permet de définir des tables de transcodage entre 2 alphabets pour : • un sens de transfert, • un type de code des données “fichier” (FCODE : ASCII ou EBCDIC), • un type de code “réseau” des données (NCODE : ASCII ou EBCDIC). Chaque table est construite à partir d’un fichier (FNAME) contenant un enregistrement unique de 256 caractères, dans lequel chaque caractère définit, par sa position et sa valeur, la correspondance entre les deux alphabets.

4.6.1. Principe du transcodage Le “s” ième caractère prend la valeur “c” : • “s” est la valeur du caractère de l’alphabet “source”, • “c” est la valeur du caractère de l’alphabet “cible” correspondant. Le premier caractère est en position 0.

4-64

CFT V2.3

Manuel de référence

Par exemple : le caractère de valeur décimale 64 en position 32 correspond, dans une table ASCII - EBCDIC, au transcodage du caractère blanc ASCII (valeur 32) en caractère blanc EBCDIC (valeur 64). En émission, le moniteur effectue un transcodage FCODE vers NCODE. En réception, le moniteur effectue un transcodage NCODE vers FCODE. Donc, si DIRECT = SEND (ou = BOTH), le fichier (FNAME) contient la description de la table de transcodage “émission” (FCODE vers NCODE) et si DIRECT = RECV (ou = BOTH), il contient la description de la table “réception” (NCODE vers FCODE). Cette table est utilisée si l’une des conditions suivantes est respectée, par ordre de priorité : • l’identifiant de la table a été indiqué dans la commande SEND/CFTSEND (SEND XLATE = identifier) ou RECV/CFTRECV, • l’identifiant de la table a été indiqué dans la commande CFTPART (CFTPART XLATE = identifier), • l’identifiant de la table est l’identifiant par défaut du moniteur CFT (CFTPARM DEFAULT = identifier), et si toutes les conditions suivantes sont respectées : • sens du transfert correspondant au paramètre DIRECT, • code des données précisé pour ce fichier au paramètre FCODE, • code réseau des données au paramètre NCODE. Une table de transcodage peut être créée et utilisée entre 2 machines utilisant chacune un alphabet ASCII différent (FCODE = ASCII et NCODE = ASCII). Les valeurs des 2 tables internes de transcodage du moniteur CFT (ASCII -> EBCDIC et EBCDIC -> ASCII) sont décrites en annexe de ce guide. Il est possible de spécifier une table de transcodage sur un alphabet “réduit”. Les caractères invalides sont associés au caractère de l’alphabet de destination (0x7f pour une table EBCDIC vers ASCII ou 0x07 pour une table ASCII vers EBCDIC). Pour une information complémentaire, consultez le paragraphe “Transcodage” du guide “Concepts” de CFT.

4.6.2. Syntaxe CFTXLATE

CFT V2.3

[MODE ID [DIRECT

= = =

{REPLACE | CREATE | DELETE},] identifier, {BOTH | RECV | SEND},]

[FCODE

=

{ASCII | EBCDIC},]

FNAME [NCODE

= =

filename, {ASCII | EBCDIC}]

Dft : OS

4-65

Les commandes de paramétrage de l’environnement des transferts

4.6.3. Paramètres [DIRECT

= {BOTH | RECV | SEND}]

Sens du transfert pour lequel la table s’applique : • SEND : table de transcodage pour l’émission, • RECV : table de transcodage pour la réception, • BOTH : table de transcodage utilisable pour l’émission et la réception. Si la valeur du paramètre est “BOTH”, les données lues dans le fichier permettent la création d’une table de transcodage en émission (SEND). La table de transcodage en réception (RECV) est déduite de manière automatique. Pour qu’il y ait bijection (c’est-à-dire que tout caractère de l’alphabet “source” transcodé en alphabet “cible”, puis retranscodé de l’alphabet “cible” vers l’alphabet “source”, retrouve sa valeur initiale), il faut que la table contienne 256 valeurs différentes. Il n’est pas indispensable de respecter rigoureusement ce principe pour des applications de transfert utilisant des alphabets “réduits”. FCODE

= {voir le tableau | ASCII | EBCDIC}

Code des données du fichier transmis. Le tableau suivant indique la valeur par défaut supportée, sur chaque OS. Tableau 57. CFTXLATE FCODE - Valeurs par défaut

4-66

OS

Valeur par défaut

GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

EBCDIC ASCII ASCII EBCDIC EBCDIC ASCII EBCDIC ASCII ASCII EBCDIC ASCII

CFT V2.3

Manuel de référence

FNAME

= filename

Nom du fichier contenant la description de la table de transcodage (1 article de 256 caractères). Ce fichier doit être d’organisation séquentielle. Des exemples de tel fichier sont fournis avec les différents produits (consultez le “Guide d’exploitation” de CFT correspondant à votre OS). GCOS7

C’est un fichier UFAS.

GCOS8

C’est un fichier de type 6 : GFREC, média code 6, Blocksize = 1280.

ID

= identifier Identifiant de la table de transcodage. Plusieurs commandes CFTXLATE peuvent avoir le même identifiant, si les valeurs de DIRECT, FCODE ou NCODE sont différentes.

[NCODE

= {ASCII | EBCDIC}]

Code des données transmises sur le réseau.

4.6.4. Exemple CFTXLATE

ID DIRECT FCODE NCODE FNAME

= = = = =

DEFAUT, BOTH, ASCII, EBCDIC, ATOE

CFTPARM

..., DEFAULT = DEFAUT, Les tables de transcodage internes du moniteur CFT (identifiant DEFAUT) seront remplacées par les tables de l’utilisateur, utilisables dans les deux sens de transfert. En émission, le moniteur CFT transcodera d’ASCII vers EBCDIC - en réception, d’EBCDIC vers ASCII. La table ASCII vers EBCDIC est définie dans le fichier ATOE et la table EBCDIC vers ASCII en sera déduite automatiquement.

CFT V2.3

4-67

5. Les commandes de paramétrage des réseaux et protocoles

5.1 CFTNET - Ressour ces (locales) réseau Une commande CFTNET : • définit une ressource réseau : celle-ci, pour le moniteur CFT, est une entité au travers de laquelle des connexions peuvent s’établir, • fournit au moniteur CFT un certain nombre d’informations nécessaires pour accéder, à travers une ressource, au réseau du type indiqué (X25, SNA, TCP/IP ...). Cette commande est donc susceptible de regrouper : • des paramètres utilisés pour gérer les fonctionnalités internes au moniteur CFT : contrôle des mécanismes d’établissement des connexions par exemple, • des paramètres décrivant les caractéristiques de l’environnement réseau définies par le système d’exploitation local, • des paramètres permettant d’établir des liens entre : -

ces paramètres système pouvant référencer un ou plusieurs composants logiciels système (exemple : drivers utilisés au niveau des cartes),

-

et le moniteur CFT.

Sur un système donné ou pour un type de réseau donné, lorsqu’il s’avère que la description de l’environnement est trop complexe ou trop spécifique, on préfère regrouper les paramètres correspondants dans un fichier de configuration (ou dans un programme d’initialisation) séparé : c’est alors ce dernier qui est référencé par la commande CFTNET. Les paramètres décrits ci-après sont donc, pour certains, d’utilisation générale et pour d’autres, d’utilisation purement spécifique à un système et/ou à une méthode d’accès réseau. Les paramètres dont la signification est commune à tous les réseaux sont décrits dans le paragraphe “CFTNET Commande générique”. Les paramètres spécifiques, regroupés par types de réseau, sont ensuite décrits dans les paragraphes “CFTNET TYPE = xxx”. Le paramètre TYPE pouvant prendre l’une des valeurs xxx suivantes : • DNA (pour le réseau DECnet), • DSA, • SNA, • TCP (pour le réseau TCP/IP), • X25, • LU62, • ASY. Attention : le contrôle du nombre maximal de commandes CFTNET gérées, effectué en phase de mise à jour des paramètres, peut différer dans certains environnements de celui effectué lors de l’exécution de CFT. Lorsque CFT détecte un nombre excessif de CFTNET, le message suivant apparaît : CFTP16F CFTNET id for CFTPARM id_Not loading in memory CFT V2.3

5-1

Les commandes de paramétrage des réseaux et protocoles

5.1.1. CFTNET - Commande “générique” La description faite dans ce paragraphe ne correspond pas à une commande réelle de CFT. Elle fait l’inventaire des seuls paramètres “communs” à toutes les méthodes d’accès réseau. Les commandes réelles CFTNET TYPE = xxx sont explicitées dans les paragraphes suivants.

5.1.1.1. Syntaxe CFTNET [CALL [MODE ID [MAXCNX [TYPE

= = = = =

{INOUT | IN | OUT},] {REPLACE | CREATE | DELETE},] identifier, {32 | n},] {X25 | DNA | DSA | SNA | TCP | LU62 | ASY},]

... Définition de la ressource réseau (spécifique).

OS

5.1.1.2. Paramètres [CALL

= {INOUT | IN | OUT}]

Sens d’appel possible par cette ressource réseau. ID

= identifier Identifiant la ressource réseau. Les identifiants ‘SNA’ et ‘X25’ sont interdits.

[MAXCNX

= {32 | n}]

{0..valeur de MAXTRANS}

Nombre maximum de connexions simultanées que CFT acceptera d’établir sur cette ressource réseau. Cette valeur doit être cohérente avec le paramètre MAXTRANS de CFTPARM ainsi qu’avec l’environnement réseau concerné. Par exemple : cohérence avec le nombre de voies logiques disponibles (exemple : sur TRANSPAC). MVS VSE

[TYPE

Sur X25 : cohérence avec la définition du noeud commuté VTAM.

= {X25 | ASY | DNA | DSA | LU62 | SNA | TCP}]

OS

Définit la nature de la ressource réseau. Selon les systèmes, peut prendre les valeurs : • DNA : ressource d’accès au réseau DECnet, • DSA : ressource d’accès au réseau DSA : contrôleur de communications DATANET, • SNA : ressource d’accès au réseau SNA. MVS VM VSE

5-2

La ressource correspond à un APPLID de VTAM.

CFT V2.3

Manuel de référence

• TCP : ressource d’accès au réseau TCP/IP, • X25 : ressource d’accès à une liaison X25 publique (TRANSPAC par exemple) ou à une liaison X25 privée, • LU62 : ressource d’accès à une liaison LU6.2, • ASY : ressource d’accès à une liaison asynchrone.

5.1.2. CFTNET TYPE = ASY - Ressource réseau asynchrone WinNT

La commande CFTNET TYPE = ASY décrit les caractéristiques du port de communication asynchrone. Il peut exister une ou plusieurs ressources asynchrones suivant le cas. En appel sortant, une seule définition suffit pour assurer le traitement des liaisons RTC et des liaisons via un PAD (cas particulier). En appel entrant, au contraire, deux définitions seront nécessaires (deux ports en écoute). Par ressource ou plus précisément par classe de ressource, il ne peut y avoir qu’une définition de protocole (CFTPROT). Certains paramètres sont communs à toutes les commandes CFTNET. Ils ne sont pas explicités dans ce paragraphe mais sont décrits dans la commande CFTNET générique. Pour une information complémentaire, consultez la documentation CFT/Windows NT.

5.1.2.1. Syntaxe CFTNET ID TYPE [CLASS [CONFIG CALL MAXCNX [MODE LINEID [MODOUT [MODIN [SPEED [PADSET

CFT V2.3

= = = = = = = = = = = =

identifier, ASY, {1 | n},] string,] {INOUT | IN | OUT}, 1, {REPLACE | CREATE | DELETE},] string, string,] string,] {2400 | n},] string]

5-3

Les commandes de paramétrage des réseaux et protocoles

5.1.2.2. Paramètres [CLASS

= {1 | n}]

{1..32}

Classe associée à cette ressource réseau. [CONFIG

= string1..64]

Nom du fichier de configuration du modem. Ce fichier décrit les scénarios des phases de connexion, déconnexion, temporisation avec le modem et/ou le PAD spécifiques (par exemple, temps d’attente avant le BREAK ou mode d’émission des données). Si ce fichier n’est pas précisé, CFT se réfère à un fichier de scénarios interne qui prévaut sur le paramétrage de la commande. LINEID

= {string1..32}

Identifiant de la ressource asynchrone caractérisant le port de communication (chaîne de caractères, “COM1” par exemple). [MODIN

= {string1..32}]

Chaîne Hayes d’initialisation du modem pour les connexions entrantes (mode serveur). [MODOUT

= {string1..32}]

Chaîne Hayes d’initialisation du modem pour les connexions sortantes (mode demandeur). Exemple : = “ATZ” . [PADSET

= n]

{1...255}

Chaîne d’initialisation du PAD. Son format est le suivant : “1:val1,2:val2,.......,i:vali” où i est < ou = 22 et représente le paramètre i du PAD dont la valeur souhaitée est vali. La chaîne de caractères utilisée par défaut est la suivante : “SET 1:0,2:0,3:0,4:3,5:0,6:1,7:8,8:0,9:0,10:0,12:0,15:0”. Le fait d’envoyer cette chaîne d’initialisation au PAD TRANSPAC permet de l’exploiter en mode tempo, avec un tempo de 0,15 secondes. [SPEED

= {2400 | n}]

Vitesse de la transmission en bits/seconde.

5-4

CFT V2.3

Manuel de référence

5.1.3. CFTNET TYPE = DNA - Ressource réseau DECNET VMS

La commande CFTNET TYPE = DNA permet de définir une RESSOURCE d’accès au réseau DECNET. Il ne peut exister qu’une seule ressource de type DNA. Il n’y a pas de paramètre spécifique ; tous les paramètres sont décrits dans la commande CFTNET générique.

5.1.3.1. Syntaxe CFTNET [CALL [MODE

= =

ID = [MAXCNX = TYPE =

{INOUT | IN | OUT},] {REPLACE | CREATE | DELETE},] identifier, {32 | n},] DNA

5.1.3.2. Exemple CFTNET

MODE ID TYPE MAXCNX CALL

= = = = =

CREATE, DECNET, DNA, 6, INOUT

5.1.4. CFTNET TYPE = DSA - Ressource réseau DSA GCOS7

GCOS8

La commande CFTNET TYPE = DSA permet de définir une RESSOURCE d’accès au réseau DSA. Il ne peut exister qu’une seule ressource de type DSA. Certains paramètres sont communs à toutes les commandes CFTNET. Ils ne sont pas explicités dans ce paragraphe mais sont décrits dans la commande CFTNET générique.

CFT V2.3

5-5

Les commandes de paramétrage des réseaux et protocoles

5.1.4.1. Syntaxe CFTNET [CALL [MODE

= =

{INOUT | IN | OUT},] {REPLACE | CREATE | DELETE},]

ID [MAXCNX TYPE [CLASS

= = = =

identifier, {32 | n},] DSA, {1 | n},]

[TSAP

=

string,]

OS

[NSAP

=

string]

OS

5.1.4.2. Paramètres [CLASS

= {1 | n}]

{1..32}

Classe associée à cette ressource réseau.

5.1.4.3. Exemple CFTNET

MODE ID TYPE CALL CLASS MAXCNX

= = = = = =

REPLACE,/* Ressource DSA - Toujours unique*/ DSAINIOUT, DSA, INOUT, 1, 8

5.1.5. CFTNET TYPE = LU62 - Ressources réseau LU6.2 MVS

OS400

UNIX

VM

VSE

WinNT

La commande CFTNET de type LU6.2 permet de se présenter auprès de la méthode d’accès LU6.2. Certains paramètres sont communs à toutes les commandes CFTNET. Ils ne sont pas explicités dans ce paragraphe mais sont décrits dans le paragraphe la “commande CFTNET générique”.

5-6

CFT V2.3

Manuel de référence

5.1.5.1. Syntaxe CFTNET ID TYPE [CLASS [CALL [MAXCNX [MODE LUNAME

= = = = = = =

identifier, LU62, {1 | n},] {INOUT | IN | OUT},] {32 | n},] {REPLACE | CREATE | DELETE},] string,

NETPFX

=

string,

OS

PUNAME =

string,

OS

[RECV

=

{2 | n},]

OS

TPNAME

=

string

OS

5.1.5.2. Paramètres Les paramètres généraux autres que TYPE et CLASS ne sont pas explicités ici. [CLASS

= {1 | n}]

{1..32}

Classe associée à la ressource réseau. Cette notion permet de regrouper des ressources de même type, de manière à ce qu’elles soient utilisables indifféremment pour l’établissement de liaisons avec des partenaires (voir le paragraphe “Protocoles et ressources réseaux” du guide “Concepts” de CFT). LUNAME

= string1..8

{1..8}

Nom de la LU locale. NETPFX

= string3

OS400

Préfixe des objets réseau. PUNAME

= string1..10

OS400

Nom du contrôleur attaché à une ligne de communication. [RECV

= {2 | n}] {1..9}

MVS VM

VSE

Nombre de “receive any RPL” pour cette ressource.

CFT V2.3

5-7

Les commandes de paramétrage des réseaux et protocoles

TPNAME

OS2

= string1..16

UNIX

Nom de la transaction en attente de conversation sur le site local. UNIX

Utilisé seulement sur les machines demandant un nom local.

TYPE

= LU62

Utilisé par tous les systèmes, le type aura toujours la valeur LU62.

5.1.5.3. Exemple Un exemple de paramétrage des ressources locales réseau sur systèmes MVS, VM ou VSE est présenté ci-dessous : CFTNET

id type luname maxcnx class call mode

= = = = = = =

net1lu62 , lu62 , lumvs2 , 6 , 5 , inout , replace

5.1.6. CFTNET TYPE = SNA - Ressources réseau SNA MVS

OS400

VM

VMS

VSE

VOS

La commande CFTNET TYPE = SNA permet de définir une RESSOURCE d’accès au réseau SNA. Le tableau suivant indique le nombre maximal de commandes CFTNET TYPE = SNA gérées par système en précisant, s’il y a lieu, le type de LU concerné. Tableau 58. CFTNET TYPE = SNA - Nombre maximum de commandes OS

MVS OS400 VM VMS VSE

Nombre maximum de commandes en LU0

Nombre maximum de commandes en LU2

16

16

16

Non supporté

Nombre maximum de commandes en LU0 ou LU2 confondus 16 16 16 16

Le nombre total de commandes CFTNET (tous types confondus) est indiqué en introduction de CFTNET. Par ressource ou plus précisément par type de ressource, il ne peut y avoir qu’une définition de protocole (CFTPROT). Certains paramètres sont communs à toutes les commandes CFTNET. Ils ne sont pas explicités dans ce paragraphe mais sont décrits dans la commande CFTNET générique.

5-8

CFT V2.3

Manuel de référence

5.1.6.1. Syntaxe générale CFTNET [CALL [MODE ID [MAXCNX TYPE [CLASS

= = = = = =

{INOUT | IN | OUT},] {REPLACE | CREATE | DELETE},] identifier, {32 | n},] SNA, n,]

[PROFILE =

string,]

OS

[LUTYPO =

string,]

OS

[LUNAME =

{n | string},]

OS

[PUNAME =

string,]

OS

[GATEWAY=

string,]

OS

[NETPFX

=

string,]

OS

[LOCADR =

string,]

OS

[ACB

=

string,]

OS

[RECV

=

{2 | n}]

OS

Le paramètre CLASS est utilisé sur tous les systèmes. Par contre, l’emploi et la signification des autres paramètres spécifiques à CFTNET TYPE = SNA dépendent du système utilisé. Le tableau suivant décrit l’emploi de ces paramètres par système. Tableau 59. CFTNET TYPE = SNA - Emploi des paramètres OS

PROFILE

MVS OS400 VM VMS VOS VSE

(OUI) (OUI) (OUI)

LUNAME

PUNAME

OUI

OUI

OUI OUI

OUI

GATEWAY

NETPFX

LOCADR

(OUI)

OUI

OUI

(OUI)

ACB

RECV

(OUI)

(OUI)

(OUI) (OUI)

(OUI) (OUI)

(OUI)

(OUI)

Explications sur le contenu du tableau : les paramètres facultatifs (et/ou les valeurs par défaut) sont indiqués par (OUI). Les paramètres obligatoires sont indiqués par OUI. Lorsqu’il n’y a aucune précision, le paramètre est sans objet pour le système concerné. Pour plus de clarté, les commentaires décrivant ces paramètres et les exemples associés ont été regroupés suivant les systèmes : • côté Host : MVS et VM, • côté PU Type 2 : OS400, VMS et VOS. Ces commentaires sont présentés dans les paragraphes ci-après.

CFT V2.3

5-9

Les commandes de paramétrage des réseaux et protocoles

5.1.6.2. Paramétrage côté HOST MVS

VM

VSE

Rappelons qu’une ressource SNA, sur Host IBM, correspond à une définition d’application (ACB) VTAM : CFTxx

APPL AUTH = PARSESS = ACBNAME =

(ACQ) YES CFTyy

Le nom de l’ACB ‘CFTyy’ et le nom de APPL ‘CFTxx’ peuvent être différents. [ACB

= {valeur de ID de ce CFTNET | string}]

Identification de la ressource auprès de la méthode d’accès. C’est le nom de l’ACB défini à VTAM par APPL. [CLASS

= n]

{2..32}

Classe associée à cette ressource réseau. Cette notion permet de regrouper des ressources de même type, de manière à ce qu’elles soient utilisables indifféremment pour l’établissement de liaisons avec des partenaires (voir le paragraphe “Protocoles et ressources réseaux” dans le guide “Concepts” de CFT). Le paramètre est omis si PROFILE = GATE (voir ci-dessous). [PROFILE

= GATE]

Profil particulier de la ressource SNA. Ce profil GATE signifie que la ressource SNA est dédiée à X25. Les valeurs des paramètres CLASS et CALL n’ont pas alors de sens, ils doivent être omis. Une seule ressource SNA est alors permise. Remarques importantes : dans la liste des identifiants définie dans le paramètre NET de la commande CFTPARM, l’identifiant de la ressource CFTNET TYPE = SNA PROFILE = GATE doit être défini AVANT l’identifiant de la ressource CFTNET TYPE = X25 correspondante. [RECV

= {2 | n}]

{1..255}

Nombre de “receive any RPL” pour cette ressource. En règle générale, ne pas modifier la valeur par défaut.

5-10

CFT V2.3

Manuel de référence

5.1.6.3. Exemples Exemple 1 : CFTNET

MODE ID ACB CALL CLASS TYPE

= = = = = =

replace , idnet1 , CFTAPPL1, INOUT , 21 , SNA

/* Ressource SNA */

La commande CFTNET ID=IDNET1, définit une ressource SNA pour des transferts de fichiers. Exemple 2 : CFTNET

MODE ID ACB CALL PROFILE TYPE

= = = = = =

replace , idnet2 , CFTAPPL2, INOUT , GATE , SNA

/* Ress. SNA pour X25 NPSI*/

La commande CFTNET ID=IDNET2, définit une ressource SNA pour communiquer avec X25 NPSI. Dans ce cas, le paramètre CLASS n’a pas de sens. Cette ressource implique l’existence d’une ressource CFTNET TYPE=X25 (voir la remarque au paramètre PROFILE = GATE).

5.1.6.4. Paramétrage côté PU type2 : spécifique OS400 OS400

[CLASS

= {1 | n}]

{1..32}

Classe associée à cette ressource réseau. Cette notion permet de regrouper des ressources de même type, de manière à ce qu’elles soient utilisables indifféremment pour l’établissement de liaisons avec des partenaires (voir le paragraphe “Protocoles et ressources réseaux” dans le guide “Concepts” de CFT). [LOCADR

= {‘00’ | string2}]

Adresse locale réseau, exprimée en hexadécimal, de la première LU du groupe. Attention : sur le HOST, ce paramètre est exprimé en décimal dans la définition VTAM de la LU correspondante.

CFT V2.3

5-11

Les commandes de paramétrage des réseaux et protocoles

LUNAME

= string3..8

Ce paramètre fournit le nom de la première LU du groupe de LUs consécutives composant cette ressource. Le nombre de LUs est fixé à partir du paramètre MAXCNX tel que : • nombre de LUs sortantes : MAXCNX, • nombre de LUs entrantes : MAXCNX, soit au total : 2 x MAXCNX. Chaque LU est dédiée à une session entrante ou sortante. Le paramètre APPID des LUs sortantes au niveau de la description de l’unité est mis à la valeur “INCONNU”, pour toutes les LUs en attente d’appel sortant. [NETPFX

= {CF1 | string3}]

Préfixe des objets réseau. Ce préfixe permet de nommer, suivant des règles de syntaxe précises, les objets réseau créés pour CFT/OS400 et utilisés par les programmes. Il constitue, en outre, la donnée de comparaison à ajouter dans un poste de routage du sous-système dans lequel CFT/OS400 va s’exécuter. PUNAME

= string10

Nom du contrôleur (*CTLD) attaché à une ligne de communication (*LIND) et constituant une PU utilisée par CFT/OS400 ou d’autres applicatifs (255 unités au total peuvent être attachées sur un même contrôleur).

5.1.6.5. Exemple CFTNET

MODE TYPE CLASS MAXCNX NETPFX PUNAME LOCADR

= = = = = = =

REPLACE, ID=LU0LINE0, SNA, 1, 2, /* simult. virtual circuits */ CF1, /* objects & jobs name-prefix*/ CTLLU0, /* ctlid attached(line name) */ 11 /* local address */

5.1.6.6. Paramétrage côté PU type2 : spécifique VMS VMS

DECnet/SNA nécessite l’utilisation d’une carte de communication comportant un seul circuit SNA pour VMS/SNA ou une passerelle pouvant, elle, supporter plusieurs lignes SNA. A chaque ligne est associé un circuit référencé par un nom (pu_name : SNA-0 pour VMS/SNA, LC-0 par exemple pour un Gateway) et, le cas échéant, un nom de passerelle (gateway). Chaque ligne peut représenter plusieurs LU. Une ressource SNA correspond à un ensemble de LU consécutives sur un même circuit (PU), MAXCNX étant le nombre de LU. Rappelons également qu’il ne peut y avoir qu’une seule session SNA entre une LU primaire et une LU secondaire. Il y aura donc 1 seul transfert CFT par LU.

5-12

CFT V2.3

Manuel de référence

[CLASS

= {1 | n}]

{1..32}

Classe associée à cette ressource réseau. Cette notion permet de regrouper des ressources de même type, de manière à ce qu’elles soient utilisables indifféremment pour l’établissement de liaisons avec des partenaires (voir le paragraphe “Protocoles et ressources réseaux” dans le guide “Concepts” de CFT). [GATEWAY

= string]

Nom de la passerelle SNA (SNA/Gateway) permettant d’assurer la connexion du réseau DECnet au réseau SNA, lorsque cette option matérielle est choisie. LUNAME

=n

{1..255}

Ce paramètre fournit le premier numéro de l’ensemble des LU consécutives composant cette ressource. Le nombre de LUs est fixé par le paramètre MAXCNX. PUNAME

= string4..5

Nom de la PU de la machine supportant CFT/VMS. Si la communication est effectuée : • par une carte localisée sur la machine exécutant CFT/VMS, la valeur de ce paramètre doit être “SNA-0”, • par une passerelle (Decnet/SNA Gateway), la valeur de ce paramètre doit être “LC-n” où “n” est un chiffre.

5.1.6.7. Exemple CFTNET

MODE ID TYPE PUNAME LUNAME MAXCNX CLASS CALL

= = = = = = = =

CREATE, SNA01, SNA, SNA-0, 10, 4, 1, INOUT

Cette commande décrit la ressource SNA, implémentée à partir du logiciel VMS/SNA résidant sur la machine (il n’y a pas de référence à un “gateway”). Le VAX est connu comme PU : SNA-0. 4 LU sont associées à cette PU : SNA-0.10, ... SNA-0.13.

CFT V2.3

5-13

Les commandes de paramétrage des réseaux et protocoles

5.1.6.8. Paramétrage côté PU type 2 : spécifique VOS VOS

CFT sur machine VOS permet de gérer des ressources de type SNA LU0. CFT utilise le produit VOS PSSNA pour communiquer en SNA LU0. L’interface entre CFT et PSSNA est assurée par des secondary session descriptor. [CLASS

= {1 | n}]

{1 .. 32}

Classe associée à cette ressource réseau. Cette notion permet de regrouper des ressources de même type, de manière à ce qu’elles soient utilisables indifféremment pour l’établissement de liaisons avec des partenaires. LUNAME

= string1 .. 15

Ce paramètre fournit le nom du premier secondary session descriptor à placer à l’écoute du bind. Des règles de nommage du nom des secondary session descriptor permettent de placer la ressource en attente du bind, sur un ou plusieurs secondary session descriptor. Un secondary session descriptor permet de placer au maximum une LU en attente du bind. Un nombre, codé en hexadécimal sur 2 digits et placé en suffixe du nom, permet de placer des secondary session descriptor de noms consécutifs à l’écoute du bind. Le nombre maximum de secondary session descriptor à placer à l’écoute du bind est limité à la valeur MAXCNX.

5.1.6.9. Exemple CFTNET

MODE ID TYPE CLASS MAXCNX LUNAME

= = = = = =

REPLACE, NETSNA, SNA, 1, 10, in_PU0HOST_01

Cette commande définit une ressource réseau SNA LU0. Le moniteur va placer le secondary session descriptor dans PU0HOST_01 en attente du bind et va rechercher 9 autres secondary session descriptor, suffixés _02 à _0A pour les placer en attente d’un bind.

5.1.7. CFTNET TYPE = TCP - Ressources réseau TCP/IP GCOS7

GCOS8

GUARDIAN

MVS

OS400

UNIX

VMS

WinNT

La commande CFTNET de type TCP/IP permet à CFT de se présenter auprès de la méthode d’accès TCP/IP - ressource Internet. Il ne peut exister qu’une seule ressource locale de type TCP/IP. Cependant, il est possible de définir une ressource déportée de type proxy, permettant d'accéder à un autre réseau ; cette ressource étant liée à la ressource locale. Certains paramètres sont communs à toutes les commandes CFTNET. Ils ne sont pas explicités dans ce paragraphe mais sont décrits dans la commande CFTNET générique.

5-14

CFT V2.3

Manuel de référence

5.1.7.1. Syntaxe CFTNET [CALL = [MODE = ID = [MAXCNX = TYPE = [LOWPORT= [HIGHPORT= HOST =

{INOUT | IN | OUT},] {REPLACE | CREATE | DELETE},] identifier, {32 | n},] TCP, {5000 | n},] {65535 | n},] string

5.1.7.2. Paramètres [HIGHPORT

= {65535 | n}]

Définit la borne supérieure de la plage de ports sortants (valeur incluse). HOST

= string64

Adresse IP de la ressource locale. Cette adresse (exprimée sous forme de chaîne de caractères) peut être renseignée soit : • avec l’adresse réelle IP en “notation point” (exemple : 192.9.200.10), • avec le nom logique HOSTNAME associé à l’adresse réelle IP et configuré dans le fichier “base de données” correspondant (HOST) fourni avec tout package TCP/IP. [LOWPORT

= {5000 | n}]

Définit la borne inférieure de la plage de ports sortants (valeur incluse).

5.1.7.3. Exemple CFTNET

MODE ID TYPE HOST MAXCNX CALL

= = = = = =

CREATE, TCP00, TCP, localhost, 6, INOUT

Définit une ressource sur le noeud “LOCALHOST”, qui correspond à la déclaration TCP/IP du noeud local. 6 connexions simultanées pourront être ouvertes. Cette ressource accepte les connexions dans les 2 sens.

CFT V2.3

5-15

Les commandes de paramétrage des réseaux et protocoles

5.1.8. CFTNET TYPE = TCP - Ressources réseaux déportées L’accès à un réseau de télécommunications est défini par une commande CFTNET. En règle générale, la ressource qui permet d’accéder à ce réseau est locale à la machine. Un proxy permet d’accéder à un réseau de télécommunications à travers un autre réseau. Il est considéré comme une ressource déportée. L’accès à un réseau de télécommunications à travers un autre réseau est défini par : • une commande CFTNET qui décrit l’accès au premier réseau (à travers une ressource locale), • une commande CFTNET qui décrit l’accès au deuxième réseau (à travers une ressource déportée, en l’occurrence ici un proxy). Les paramètres de la commande CFTNET varient selon que la ressource est locale ou déportée. Pour une ressource locale, les paramètres restent inchangés. Pour une ressource déportée, les paramètres sont dépendants du type de la ressource.

5.1.8.1. Syntaxe CFTNET ID TYPE INET PROTOCOL HOST PORT [USER [MAXCNX [MODE

= = = = = = = = =

identifier, TCP, identifier, SOCKS4, (string, string, …), (string, string, …), string,] {32,n},] {REPLACE | CREATE | DELETE},]

5.1.8.2. Paramètres ID

= identifier Identifiant du réseau accédé à travers un proxy.

TYPE

= TCP

Définit le type de réseau accédé à travers un proxy. INET

= identifier

Identifiant de la commande CFTNET définissant l’accès au premier réseau. PROTOCOL

= SOCKS4

Le seul protocole de dialogue avec un proxy supporté est SOCKS4 (version 4 ou 4A).

5-16

CFT V2.3

Manuel de référence

HOST

= (string1..64, string1..64, …)

Adresse(s) dans le premier réseau du ou des proxy (jusqu’à 4 proxy sur un même premier réseau). Une adresse peut être exprimée soit sous la forme d’une adresse IP (format numérique ‘nnn.nnn.nnn.nnn’) soit sous la forme d’un nom de host. Si plusieurs adresses sont indiquées, CFT équilibre la charge sur chacune, par rapport au nombre de connexions déjà établies. PORT

= (string1..64, string1..64, …)

Port d’écoute du ou des proxy dans le premier réseau. Un port d’écoute peut être exprimé soit sous une forme numérique (compris entre 1 et 65535), soit sous la forme d’un nom de service. Il faut déclarer autant de PORT que de HOST, la position dans la liste du port d’écoute correspond. à l’adresse host ayant la même position. [MAXCNX

=

{32,n},]

Nombre maximum de connexions simultanées que CFT acceptera d’établir avec le(s) proxy. Cette valeur doit être cohérente d’une part avec le paramètre MAXTRANS de la commande CFTPARM (nombre maximum de transferts simultanés) et d’autre part avec le paramètre MAXCNX de la commande CFTNET définissant le réseau accédant au proxy. [USER

=

string1..28,]

Nom d’utilisateur transmis dans la requête de connexion adressée au proxy. Ce paramètre est sensible à la casse. Il prend par défaut la valeur du nom d’utilisateur sous lequel s’exécute CFT.

5.1.8.3. Exemple /** * DEFINITION DU RESEAU INTRANET **/ CFTNET

id mode call maxcnx host type

= = = = = =

INTRANET, REPLACE, INOUT, 16, adresse_locale, TCP

/** * DEFINITION DU RESEAU INTERNET * A TRAVERS UN PROXY **/ CFTNET

CFT V2.3

id mode maxcnx type user inet protocol host port

= = = = = = = = =

INTERNET, REPLACE, 8, TCP, nom_utilisateur, INTRANET, SOCKS4, adresse_proxy, port_ecoute_proxy 5-17

Les commandes de paramétrage des réseaux et protocoles

5.1.9. CFTNET TYPE = X25 - Ressources réseau X25 La ressource X25 est utilisée sur tous les systèmes. La commande CFTNET de type X25 permet de se présenter auprès de la méthode d’accès X25. Certains paramètres sont communs à toutes les commandes CFTNET. Ils ne sont pas explicités dans ce paragraphe mais sont décrits dans le paragraphe “La commande CFTNET générique”.

5.1.9.1. Syntaxe OS

CFTNET [CALL [MODE ID [MAXCNX [TYPE [CLASS [ADDR

= = = = = = =

{INOUT | IN | OUT},] {REPLACE | CREATE | DELETE},] identifier, {32 | n,] X25,] {1 | n},] string,]

[AX25NODE

= {‘ ’ | string},]

OS

[AX25MBX

= {‘ ’ | string},]

OS

[CTLR

= string,]

OS

LINEID

= string,]

OS

[MAXLCH

= n,]

OS

[MINLCH

= n,]

OS

[NETPFX

= string,]

OS

[NETPGM

= string,]

OS

[PACKETSZ

= n,]

OS

[PACKETW

= n,]

OS

[SPEED

= n]

OS

5.1.9.2. Paramètres spécifiques utilisables par systèmes Le paramètre CLASS est utilisé sur tous les systèmes. Par contre, l’emploi et la signification des autres paramètres spécifiques à CFTNET TYPE= X25 dépendent du système utilisé. Le tableau suivant indique lesquels de ces paramètres sont utilisables pour un système donné.

5-18

CFT V2.3

Manuel de référence

Tableau 60. CFTNET TYPE = X25 - Emploi des paramètres OS

ADDR

PACKETSZ

PACKETW

NET NET LINEID PGM PFX

GCOS7 GCOS8 GUARDIAN

OUI

SPEED

MAXLCH MINLCH

CTLR

AX25NODE AX25MBX

OUI

(OUI)

OUI

(OUI)

OUI OUI

MVS

OUI

OUI

OS400

(OUI)

(OUI)

OUI

OUI

UNIX

OUI OUI OUI

(OUI)

OUI

OUI OUI

VM VMS

OUI OUI

VOS

(OUI)

VSE

OUI OUI

OUI

WinNT

OUI OUI

Explications sur le contenu du tableau : les paramètres facultatifs (et/ou les valeurs par défaut) sont indiqués par (OUI). Les paramètres obligatoires sont indiqués par OUI. Lorsqu’il n’y a aucune précision, le paramètre est sans objet pour le système concerné. MVS VM VSE GCOS7 GCOS8

UNIX

Les commandes CFTNET TYPE=X25 seront précédées d’une commande CFTNET TYPE=SNA, PROFILE=GATE afin que CFT puisse dialoguer avec X25 NPSI. Le triplet AX25NODE, AX25MBX, LINEID doit être unique pour chaque commande CFTNET. Dans la plupart des systèmes UNIX, le paramètre LINEID est utilisé et obligatoire. Dans certains systèmes, ce paramètre est remplacé par le paramètre NETPGM (obligatoire dans ce cas).

5.1.9.2.1. Paramètres ADDR

= string string8

[AX25MBX

string6

GUARDIAN

Sous-adresse commune aux SU (SubUnits) référencées par ce CFTNET (obligatoire).

n

VOS

Numéro d’extension facultatif pour l’écoute d’appels entrants.

= {‘ ’ | string}]

GCOS7 GCOS8

Nom de la boîte aux lettres, au sens DSA, de la prise réseau AX25. Objet “MB” de type AX25. [AX25NODE

= {‘ ’ | string}]

GCOS7 GCOS8

Noeud DSA où se situe la prise réseau AX25.

CFT V2.3

5-19

Les commandes de paramétrage des réseaux et protocoles

[CLASS

= {1 | n}]

{1..32}

Classe associée à cette ressource réseau. Cette notion permet de regrouper des ressources de même type, de manière à ce qu’elles soient utilisables indifféremment pour l’établissement de liaisons avec des partenaires (voir le paragraphe “Protocoles et ressources réseaux” dans le guide “Concepts” de CFT). [CTLR

OS

= string8]

Nom du contrôleur de communication.

[LINEID

= string]

(longueur : voir

OS

le tableau) Décrit la ressource physique locale. Le tableau suivant indique, pour chaque système d’exploitation où l’emploi de ce paramètre est pertinent, le nombre de caractères maximum à renseigner ainsi que la signification de ce paramètre spécifique à ce système d’exploitation. Tableau 61. CFTNET TYPE = X25 LINEID - Valeurs du paramètre

GCOS7

Nombre maximum de caractères 4

GCOS8

4

GUARDIAN

8

MVS

8

OS400

10

UNIX

32

VM

8

VMS

32

VOS VSE

32 8

WinNT

32

OS

5-20

Signification de la valeur LINEID Abonnement à sélectionner par AX25 lors des appels sortants Correspond à un objet “NS” du contrôleur de communications DATANET Abonnement à sélectionner par AX25 lors des appels sortants Correspond à un objet “NS” du contrôleur de communications DATANET Nom physique de la ligne X25 tel que défini lors de l’installation de celle-ci. Exemple : LINEID=$X25 Nom de la ‘LU MCH’ de la ligne X25 supportée par cette ressource Nom physique de la ligne X25, tel que défini lors de l’installation de celle-ci Se référer au nom de “port” affiché par la commande WRKHDWPRD Nom de l’exécutable initialisant cette ressource L’appellation est dépendante du type de la machine (se référer au guide spécifique) Nom de la ‘LU MCH’ de la ligne X25 supportée par cette ressource Composé : • du nom du réseau tel que connu de PSI (par exemple TRANSPAC) • du caractère séparateur “%” • du No de DTE local (par exemple un numéro Transpac) Nom de gateway identifiant la ligne Nom de la ‘LU MCH’ de la ligne X25 supportée par cette ressource Voir OS2

CFT V2.3

Manuel de référence

[MAXLCH

OS400

= {valeur de MAXCNX | n}] {1..32}

Numéro de voie logique le plus élevé prévu par l’abonnement. A partir de la release 1.3 de l’OS/400, les numéros de voie logique doivent commencer à 1. Par conséquent, MAXLCH est égal au nombre de voies logiques de l’abonnement. [MINLCH

OS400

= {1 | n}] {0..512}

Numéro de la première voie logique à utiliser. [NETPFX

= string] string8

GUARDIAN

Radical des noms des SU (Sub-Units). Par exemple : NETPFX = #CF1

string3

OS400

Préfixe des noms des “jobs” et des objets créés automatiquement par l’interface réseau de CFT (lignes, contrôleurs, unités, fichiers ICF ...). Le choix de ces trois caractères est libre, pour autant qu’on ne contrevienne pas aux règles de nommage de l’AS/400. On pourra par exemple utiliser : NETPFX=CF1 pour un premier moniteur, NETPFX=CF2 pour un second, ou NETPFX=CFT pour tous les deux.

[NETPGM = string32] certains systèmes UNIX

Utilisé par

UNIX

Nom d’exécutable initialisant la ressource X25. [PACKETSZ

= {128 | n}] {64..4096}

MVS OS400

VM VSE

Taille des paquets de l’abonnement X25, en nombre d’octets. Cette valeur DOIT correspondre aux caractéristiques de votre abonnement X25. [PACKETW

= {3 | n}] {1..15}

MVS OS400

VM VSE

Taille de la fenêtre de l’abonnement X25, en nombre de paquets. Cette valeur DOIT correspondre aux caractéristiques de votre abonnement X25. [SPEED

= {9600 | n}] {300..65536}

OS400

Vitesse de la ligne de l’abonnement, en Bps. Cette valeur DOIT correspondre aux caractéristiques de votre abonnement X25.

CFT V2.3

5-21

Les commandes de paramétrage des réseaux et protocoles

5.1.9.3. Exemple GCOS7

CFTNET

GCOS8

MODE CALL ID MAXCNX TYPE CLASS AX25NODE AX25MBX LINEID GCOS7

= = = = = = = = =

REPLACE, INOUT, X25INOUT, 8, X25, 1, DN01, AX25, LX25

Le paramétrage serveur de communication correspondant est du type : SC DN01 LOC -ADDR ... MB AX25 AX25 NS LX25 X25 -LL LX25 -NBVC 8 -CALL 175nnnnnn NR NRNS SX25 -NS LX25

5.2 CFTPROT - Protoc ole de transfert Une commande CFTPROT permet de : • choisir un protocole (PeSIT, ODETTE, ETEBAC 3) et une manière d’utiliser ce protocole (avec ou sans compression, avec ou sans possibilité de relance, avec ou sans utilisation de SSL, ...), • préciser certains paramètres liés à l’utilisation des ressources réseau pour les échanges protocolaires (voir notamment le mécanisme de sélection du protocole lors des connexions - paramètre SAP). Rappelons que les méthodes d’accès (ou protocoles d’échange de données) implémentés sont : • sur tous les systèmes : X25, • suivant les systèmes : DNA, DSA, SNA, TCP/IP,

LU6.2, ASY (consultez le guide “Concepts” de CFT). L’emploi des protocoles d’échange de données sur réseaux SNA ou DSA n’est pas normalisé. Les protocoles de transfert de fichiers implémentés sont : • PeSIT D (profil SIT, Extern et CFT), • PeSIT E (profil ANY), • ETEBAC 3, • ODETTE. Un transfert avec un partenaire est possible si le protocole de transfert et le protocole d’échange de données utilisés sont supportés par le moniteur local et le moniteur du partenaire concerné et s’il n’y a pas d’incompatibilité dans les choix d’utilisation (par exemple, profil de PeSIT, options du protocole, ...). Pour CFT, l’association entre un partenaire et les protocoles CFT utilisables est assurée par le paramètre PROT de la commande CFTPART. 5-22

CFT V2.3

Manuel de référence

Le nombre maximal de commandes CFTPROT gérées par moniteur est de 32. Attention : le contrôle du nombre maximal de commandes CFTPROT gérées, effectué en phase de mise à jour des paramètres, peut différer dans certains environnements de celui effectué lors de l’exécution de CFT. Lorsque CFT détecte un nombre excessif de CFTPROT, le message suivant apparaît : CFTP15F CFTPROT id for CFTPARM id_Not loading in memory Le protocole supporté est spécifié par le paramètre TYPE. La commande CFTPROT présente donc un ensemble de paramètres permettant de définir l’ensemble des options de tous les protocoles de transfert de fichiers supportés. Certains de ces paramètres sont communs à tous les protocoles ; d’autres paramètres n’ont de sens que pour un protocole donné, donc pour un TYPE donné. Pour plus de clarté : • les paramètres dont la signification est commune à tous les protocoles sont décrits dans le paragraphe "CFTPROT - commande générique", • les paramètres spécifiques, regroupés par types de protocole, sont décrits ensuite dans les paragraphes "CFTPROT TYPE = xxx". Le paramètre TYPE pouvant prendre l’une des valeurs xxx suivantes : ETEBAC, ODETTE, PeSIT, • le paramètre permettant d'associer un protocole au profil de sécurité (SSL) est décrit dans le "Guide de la sécurité des échanges". Remarque : d’une façon générale, les paramètres commençant par S contrôlent le fonctionnement des émissions, et ceux commençant par R, le fonctionnement des réceptions. Toutefois, cette règle ne s’applique pas forcément lorsqu’il y a enchaînement (dans la même connexion) de transferts de sens opposé. Cette exception ne sera pas évoquée dans les paragraphes suivants.

5.2.1. CFTPROT - Paramétrage “générique” La description faite dans ce paragraphe ne correspond pas à une commande réelle de CFT. Elle fait l’inventaire des seuls paramètres “communs” à tous les protocoles. Les commandes réelles CFTPROT TYPE = xxx sont explicitées dans les paragraphes suivants. Pour les ressources réseau de type SNA ou asynchrone (pas de SAP), il ne peut y avoir plus d’une commande CFTPROT par commande CFTNET.

5.2.1.1. Syntaxe CFTPROT [MODE ID NET

= = =

{REPLACE | CREATE | DELETE},] identifier, identifier,

SAP

=

string,

[DISCTD

=

n,]

Dft: PROTOCOLE

[DISCTS

=

n,]

Dft: PROTOCOLE

[RESTART = [RTO = CFT V2.3

OS

{5 | n},] {260 | n},] 5-23

Les commandes de paramétrage des réseaux et protocoles

[SCOMP

=

cpr,]

Dft: PROTOCOLE

[RCOMP

=

cpr,]

Dft: PROTOCOLE

[SRIN [SROUT [IDF TYPE [EXITA [EXITE [DYNAM

= = = = = = =

{BOTH | NONE | RECEIVER | SENDER},] {BOTH | NONE | RECEIVER | SENDER},] string,] {PESIT | ETEBAC | ODETTE}, identifier,] identifier,] identifier]

. . . Paramètres spécifiques suivant le protocole.

5.2.1.2. Paramètres [DISCTD

= {voir le tableau | n}] {0..3600}

Dft : PROTOCOLE

Délai d’attente (en secondes) avant déconnexion, en l’absence d’une nouvelle demande de transfert vers le partenaire, en mode demandeur. La session établie pour un transfert reste active pendant DISCTD secondes après la fin de ce transfert. Si la valeur est 0, le délai d’attente est infini. La valeur par défaut (en secondes) dépend du protocole et est indiquée au tableau suivant. Tableau 62. CFTPROT DISCTD - Valeurs par défaut Protocole

Valeur par défaut de DISCTD

PeSIT profil SIT PeSIT D profil EXTERN PeSIT D profil CFT PeSIT E (profil ANY) ODETTE ETEBAC3

240 120 20 120 20 20

[DISCTS

= {voir le tableau | n}] {0..3600}

Dft : PROTOCOLE

Délai d’attente (en secondes) avant déconnexion, en l’absence d’une nouvelle demande de transfert du partenaire, en mode serveur. La session établie pour un transfert reste active pendant DISCTS secondes après la fin de ce transfert. Si au bout de ce délai, aucun nouveau transfert n’est reçu, la connexion est libérée par FPDU ABORT. Si la valeur est 0, le délai d’attente est infini. La valeur par défaut (en secondes) dépend du protocole et est indiquée au tableau suivant.

5-24

CFT V2.3

Manuel de référence

Tableau 63. CFTPROT DISCTS - Valeurs par défaut Protocole

Valeur par défaut de DISCTS

PeSIT profil SIT PeSIT D profil EXTERN PeSIT D profil CFT PeSIT E (profil ANY) ODETTE ETEBAC3

285 165 65 165 65 65

[DYNAM

= identifier]

Identifiant (8 caractères) de partenaire dynamique en mode serveur. La valeur de cet identifiant correspond à celle du paramètre ID de la commande CFTPART modèle. Pour des raisons de sécurité, ce paramètre doit être utilisé conjointement à un EXIT de type annuaire. [EXITA

= identifier]

Identifiant (8 caractères) de l’EXIT annuaire pour la version V222 exclusivement. La valeur de cet identifiant correspond à celle du paramètre ID de la commande CFTEXIT. L’identifiant peut être composé de la variable symbolique &NPART. [EXITE

= identifier]

Identifiant (8 caractères) de l’EXIT ETEBAC3. La valeur de cet identifiant correspond à celle du paramètre ID de la commande CFTEXIT. L’identifiant peut être composé de la variable symbolique &PART. ID

= identifier Identifiant de la commande CFTPROT. Ce nom doit être référencé dans les valeurs prises par le paramètre PROT de CFTPARM. WinNT

[IDF

Pour un protocole de communication s’appuyant sur un réseau X25 accédé par une carte non IBM, la valeur de ce paramètre ID peut être renseignée par une chaîne de caractères quelconques.

= string64]

Permet d’attribuer un IDF à un fichier sur réception d’un NIDF de longueur supérieure à 8 caractères. Utilisable en mode : • serveur (émetteur ou récepteur), • demandeur récepteur suite à l’activation d’une commande RECV IDF= .

CFT V2.3

5-25

Les commandes de paramétrage des réseaux et protocoles

La valeur de ce paramètre peut être : • explicite : la longueur de chaîne de caractères autorisée doit alors être inférieure ou égale à 8 caractères, • obtenue à partir d’un ou plusieurs “substring” de la variable symbolique &NIDF (correspondant au NIDF reçu), la longueur maximale de la chaîne de caractères doit être inférieure ou égale à 64 caractères. Voir la définition d’un “substring” d’une variable symbolique au chapitre “Variable symbolique” du guide “Concepts” de CFT. Exemple : pour un NIDF reçu de 19 caractères, IDF peut prendre la valeur : IDF=&2.3NIDF&12.5NIDF . La longueur maximum de la chaîne ci-dessus doit être inférieure ou égale à 64 caractères. La longueur de la chaîne après substitution des variables doit être inférieure ou égale à 8 caractères. Dans l’exemple précédent, la valeur de IDF a pour longueur : - avant substitution : 17 caractères, - après substitution : 8 caractères. NET

= identifier

Identifiant référençant une commande CFTNET associée à ce protocole (ressource réseau utilisée pour les échanges protocolaires). S’il y a plusieurs ressources (CFTNET) du même type et de la même classe que la ressource référencée par ce paramètre NET, les caractéristiques de protocole décrites par cette commande CFTPROT sont en fait associées à l’ensemble de ces ressources (et non pas seulement à celle qui est référencée par NET) : toutes ces ressources peuvent être utilisées pour les échanges protocolaires. Toutes sont concernées (en cas d’appel entrant) par la valeur du paramètre SAP de cette commande CFTPROT. Remarque : pour les protocoles définis sur une ressource SNA, il ne peut y avoir plusieurs commandes CFTPROT faisant référence à la même commande CFTNET de type SNA (en SNA, la notion de SAP n’est pas utilisée). [RCOMP

= {voir le tableau | cpr}]

Dft : PROTOCOLE

Compression maximale autorisée, en réception d’un fichier. Cette compression est négociée entre l’émetteur et le récepteur. Une valeur nulle correspond à aucune compression.

5-26

CFT V2.3

Manuel de référence

Tableau 64. CFTPROT RCOMP - Valeurs par défaut Protocole

Valeur par défaut de RCOMP

PeSIT profil SIT PeSIT D profil EXTERN PeSIT profil CFT PeSIT E (standard) PeSIT E (CFT/CFT) ODETTE ETEBAC3

Non pertinent 10 15 10 15 1 Utilisable hors norme

Pour une information complémentaire (valeurs utilisables ...), consultez l’annexe “Compression”. [RESTART

= {5 | n}]

{0..32767} Uniquement en mode demandeur

Nombre maximal de tentatives de relances d’un transfert. Une tentative est comptabilisée dès que la connexion physique est correctement établie avec le site distant. [RTO

= {260 | n}]

{0..3600}

Temporisation (exprimée en secondes) de surveillance réseau hors phase de connexion/déconnexion/rupture protocolaire. Correspond au délai d’attente d’une réponse à une FPDU avant déconnexion (READ TIME OUT). Si la valeur est 0, le délai d’attente est infini. SAP voir le tableau)

= string

(longueur :

OS

Nom du SAP (Service Access Point) local associé à ce protocole. Il permet d’identifier le “point d’accès” où seront déposées les demandes de connexion entrantes destinées à ce protocole de communication. Le SAP qu’un partenaire demandeur fournit lors de sa demande de connexion est retrouvé par le CFT local qui en déduit le protocole à utiliser. Chaque commande CFTPROT dans une classe de ressources donnée doit comporter son SAP spécifique. La valeur de ce paramètre peut être exprimée sous forme hexadécimale. Dans ce cas, le premier caractère doit être “#” (dièse) (par exemple : #31 sera compris comme caractère ASCII ‘1’). La valeur du SAP est fonction des protocoles d’échange de données utilisés par chaque méthode d’accès.

CFT V2.3

5-27

Les commandes de paramétrage des réseaux et protocoles

Tableau 65. FTPROT SAP - Valeurs du paramètre Méthode d’accès

Taille en caractères

Définition et Commentaires

DNA DSA

1à8

OBJET Decnet

GCOS7

1à8

“Mailbox” DSA appelable par le correspondant distant

GCOS8

5 à 12

Composé : • du nom de “session control” local (1 à 4 caractères éventuellement complétés avec des blancs à droite) • et du nom de la “mailbox CFT” locale (1 à 8 caractères) Sans objet. Ne doit pas être précisé Le protocole entrant est automatiquement sélectionné à partir de la ressource réseau (LU ou groupe de LU) Numéro du port d’écoute local sur lequel le moniteur est appelable, exprimé sous la forme : • du numéro réel utilisé par TCP/IP : – numéros autorisés : entre 1025 et 65535 – numéros conseillés : 1761, 1762, 1763, 1764, 1765, 1766, 1767, 1768 (1) • du nom logique associé au numéro utilisé par TCP/IP et configuré dans le fichier SERVICES, si celui-ci existe

SNA

-

TCP/IP

1 à 15

X25 sauf GCOS7 et GCOS8

1 à 15

X25 GCOS7

1à8

GCOS8

5 à 12

Noms logiques conseillés : cft-0, cft-1, cft-2, cft-3, cft-4, cft5, cft-6, cft-7 (1) Valeur véhiculée dans le paquet d’appels entrants sous la forme : • de sous-adresse (subaddr) dont la valeur doit être numérique et qui sera interprétée en majuscules (ex : SAP=33), • de Données utilisateur (user data) de format hexadécimal (ex : SAP= #3132 12 ASCII) ou alphanumérique (ex : SAP= ABC, SAP = X25) Cas particulier OS400 : en user data, seul le premier caractère (limité à certaines plages de valeurs) est significatif pour le routage des appels entrants (consultez le “Guide d’exploitation” de CFT correspondant à votre OS) Composé : • de la référence de la “mailbox” locale de CFT • du caractère séparateur ‘:’ (facultatif) • de la sous-adresse de l’appelant que CFT peut renseigner lorsqu’il est demandeur dans le paquet d’appels (facultatif) Composé : • de la référence de la “mailbox” locale de CFT : – nom de “session control” local (1 à 4 caractères éventuellement complétés par des blancs à droite) – du nom de la “mailbox CFT” locale (1 à 8 caractères) • du caractère séparateur ‘:’ (facultatif) • de la sous-adresse (de 0 à 5 caractères) de l’appelant que CFT peut renseigner dans le paquet d’appels (facultatif) lorsqu’il est demandeur

(1) : ces numéros et noms logiques de ports sont des noms et numéros officiellement réservés par SOPRA auprès de l’IANA (Internet Assigned Numbers Authority).

5-28

CFT V2.3

Manuel de référence

Les remarques suivantes concernent la méthode d’accès X25 : dans le cas où l’appelé est un Host IBM : consultez le “Guide d’exploitation” de CFT/MVS pour les remarques concernant l’emploi des sous-adresses et des données utilisateurs en X25. Concernant la compatibilité CFT V1/V2, CFT V2 ne peut pas effectuer plusieurs transferts simultanément avec un CFT V1 en utilisant les User Data pour transporter le SAP. Ceci est une limitation de CFT V1 pour IBM/370. Pour contourner cette limitation, il convient, soit : • de déclarer autant de partenaires (CFTPART et CFTX25) correspondant à CFT Version 1 que l’on veut établir de connexions simultanées, • de déclarer autant de protocoles (CFTPROT) que de connexions simultanées possibles. Le partenaire CFT Version 1 sera alors accessible par chacun de ces protocoles. On aura par exemple le paramétrage suivant : CFTPROT ID = prot1, ... CFTPROT ID = prot2, ... CFTPROT ID = prot3, ... CFTPART

ID PROT SAP

= cft370, = (prot1, prot2, prot3), = (sap1 , sap2 , sap3), ...

Le passage d’un protocole à l’autre est automatique lorsque la connexion au précédent est refusée, après la séquence des “retry”. • Ou d’être dans le mode SAPTYP = SUBADDR. En effet, cette restriction n’existe pas dans ce mode. Il faut alors travailler côté V1 avec un MCH de NPSI défini avec SUBADDR = YES. WinNT

VMS

Les couches X25 ATLANTIS ne savent pas orienter les appels entrants vers plusieurs utilisateurs en fonction des données utilisateurs (“user data”) des paquets d’appels. Les SAP numériques X25 (sous-adresse) sont gérés sous VMS sans tenir compte des zéros sur la gauche. Par exemple : CFTPROT SAP = 05,... et CFTPROT SAP = 5,... sont considérés comme identiques par VMS.

• D’utiliser un SAP décimal qui sera forcé en sous-adresse (subaddr). [SCOMP

= {voir le tableau | cpr}]

Dft : PROTOCOLE

Compression maximum autorisée, en émission d’un fichier. Cette compression est négociée entre l’émetteur et le récepteur. Une valeur nulle correspond à aucune compression. Tableau 66. CFTPROT SCOMP - Valeurs par défaut Protocole

Valeur par défaut de SCOMP

PeSIT profil SIT PeSIT D profil EXTERN PeSIT D profil CFT PeSIT E (standard) PeSIT E (CFT/CFT) ODETTE ETEBAC3

Non pertinent 10 15 10 15 1 Utilisable hors norme

Pour plus de précision (valeurs utilisables ...), consultez l’annexe “Compression”.

CFT V2.3

5-29

Les commandes de paramétrage des réseaux et protocoles

[SRIN

= {BOTH | NONE | RECEIVER | SENDER}]

Contrôle le sens des transferts autorisés pour le moniteur CFT lorsqu’il est serveur (accepteur de la connexion protocolaire). Les valeurs possibles sont les suivantes : • SENDER : seules les émissions (de fichiers ou de messages) sont acceptées ; les réceptions ne sont pas autorisées, • RECEIVER : seules les réceptions (de fichiers ou de messages) sont acceptées ; les émissions ne sont pas autorisées, • BOTH : les deux sens de transferts (émission et réception) sont acceptés, • NONE : aucun transfert ne peut être effectué en mode serveur. [SROUT

= { BOTH | NONE | RECEIVER | SENDER }]

Contrôle le sens des transferts autorisés pour le moniteur CFT lorsqu’il est demandeur (initiateur de la connexion protocolaire). Les valeurs possibles sont les suivantes : • SENDER : seules les émissions (de fichiers ou de messages) sont possibles ; les réceptions ne sont pas autorisées. • RECEIVER : seules les réceptions (de fichiers ou de messages) sont possibles ; les émissions ne sont pas autorisées. • BOTH : les deux sens de transferts (émission et réception) sont possibles. • NONE : aucun transfert ne peut être effectué en mode demandeur. TYPE

= {ETEBAC | ODETTE | PESIT}

Type de protocole de transfert de fichiers. PeSIT

TYPE = PESIT : protocole PeSIT, version D ou E.

ETEBAC

TYPE = ETEBAC : protocole ETEBAC3. Dans ce cas, CFT devra trouver 2 “cartes paramètres” par défaut (voir la commande CFTETB).

ODETTE

TYPE = ODETTE : protocole ODETTE (pour les systèmes le supportant).

5.2.2. CFTPROT TYPE = ETEBAC - Protocole ETEBAC 3 La commande CFTPROT TYPE = ETEBAC permet de décrire le protocole de transfert ETEBAC 3. Lors de l’établissement de la connexion, aucune négociation n’est effectuée : la carte paramètre (ou message de “service” débutant le transfert) est acceptée ou refusée. La description de cette carte est à préciser dans la commande CFTETB. Le protocole ETEBAC 3 ne gère pas de reprise : les transferts reprennent en début de fichier après une interruption de transfert. Pour une explication détaillée des contraintes et spécificités liées à l’utilisation de ce protocole particulier, consultez le “Guide des protocoles” de CFT.

5-30

CFT V2.3

Manuel de référence

Les paramètres communs à toutes les commandes CFTPROT sont décrits dans le paragraphe “CFTPROT Paramétrage générique”. La liste exhaustive des paramètres licites est néanmoins donnée ci-après.

5.2.2.1. Syntaxe CFTPROT MODE ID NET

= = =

{REPLACE |CREATE | DELETE}, identifier, identifier,

SAP

=

string,

[DISCTD [DISCTS [RESTART [RTO [SCOMP [RCOMP [SRIN [SROUT [IDF TYPE [EXITE DYNAM [RRUSIZE [SRUSIZE

= = = = = = = = = = = = = =

n,] n,] {5 | n},] {260 | n},] cpr,] cpr,] {BOTH | NONE | RECEIVER | SENDER},] {BOTH | NONE | RECEIVER | SENDER},] string,] ETEBAC, identifier,] identifier,] {4056 | n},] {4056 | n}]

OS

5.2.2.2. Paramètres [RRUSIZE

= {4056 | n}]

{254...4096}

Taille maximale des NSDU (Network Service Data Unit) en réception. Ce paramètre n’est pas négocié. Usuellement, il prend la valeur définie par défaut. [SRUSIZE

= {4056 | n}]

{254...4096}

Taille maximale des NSDU (Network Service Data Unit) en émission. Ce paramètre n’est pas négocié. Usuellement, il prend la valeur définie par défaut.

5.2.3. CFTPROT TYPE = ODETTE - Protocole ODETTE La commande CFTPROT TYPE = ODETTE permet de décrire le protocole de transfert ODETTE. Cette commande permet de préciser des valeurs sur lesquelles le moniteur se basera lors des négociations protocolaires concernant : • le “crédit”, • la compression des données, • la logique spéciale.

CFT V2.3

5-31

Les commandes de paramétrage des réseaux et protocoles

Le “Crédit” désigne le nombre maximum de paquets de données que peut transmettre l’émetteur, avant que le serveur n’ait besoin d’acquitter leur réception en attribuant un nouveau “crédit”. CFT simule une prise de point de synchronisation à chaque message de crédit émis ou reçu. En cas d’interruption d’un transfert, le point de reprise proposé par un CFT émetteur correspond au point d’interruption de l’émission, tel qu’il l’avait détecté. Le point de reprise négocié par un CFT récepteur, correspond toujours à un message de crédit précédemment émis par lui (sauf en cas de reprise en début de fichier). Pour une explication détaillée des contraintes et spécificités liées à l’utilisation de ce protocole particulier, consultez le “Guide des protocoles” de CFT.

5.2.3.1. Syntaxe CFTPROT [MODE ID NET

= = =

{REPLACE | CREATE | DELETE},] identifier, identifier,

SAP

=

string,

[DISCTD [DISCTS [RESTART [RTO [SCOMP [RCOMP [SRIN [SROUT [IDF TYPE [EXIT [EXITA [DYNAM [RESYNC [PAD [RRUSIZE [SRUSIZE [RCREDIT [SCREDIT [EERP [TCP

= = = = = = = = = = = = = = = = = = = = =

n,] n,] {5 | n},] {260 | n},] cpr,] cpr,] {BOTH | NONE | RECEIVER | SENDER},] {BOTH | NONE | RECEIVER | SENDER },] string,] ODETTE, identifier,] identifier,] identifier,] {NO | YES},] {NO | YES},] {2048 | n},] {2048 | n},] {4 | n},] {4 | n},] {91 | 86},] {CFT | OFTP}]

OS

5.2.3.2. Paramètres [EERP

= {91 | 86}]

Permet d’interpréter, suivant la version du protocole, la valeur des champs ORIGINATOR et DESTINATOR contenus dans le message EERP. Le service End to End ResPonse génère un message appelé EERP. Ce message indique à l’émetteur du fichier que les données transmises sont arrivées correctement.

5-32

CFT V2.3

Manuel de référence

Dans la première version du protocole (1986), il est spécifié que : • le champ protocolaire ORIGINATOR correspond à l’émetteur du fichier, • le champ protocolaire DESTINATOR correspond au récepteur du fichier. Dans la seconde version (1991), il est spécifié que : • le champ protocolaire ORIGINATOR correspond à l’émetteur de l’EERP (c’est-à-dire au récepteur du fichier), • le champ protocolaire DESTINATOR correspond au récepteur de l’EERP (c’est-à-dire à l’émetteur du fichier). Attention : les utilisateurs doivent s’assurer de la cohérence des valeurs paramétrées de bout en bout. En effet, si les versions sont différentes entre un émetteur et un récepteur, l’acquittement du transfert sera impossible. [PAD

= {NO | YES}]

Option d’application de la “LOGIQUE SPECIALE” sur les buffers d’échange de données. Cette option est négociée avec le partenaire lors de l’établissement de la session protocolaire (dans la FPDU SSID) : si pour l’un des correspondants cette option est à NO, la “logique spéciale” ne sera pas appliquée. [RCREDIT

= {4 | n}]

{0..16}

Valeur du “crédit” (en nombre de messages “DATA”) proposée par CFT lorsqu’il est serveur. Cette valeur est négociée avec la valeur proposée par le demandeur (voir le paramètre SCREDIT) lors de l’établissement de la session protocolaire. [RESYNC

= {NO | YES}]

Option de relance de transfert suite à une interruption de transfert. Cette option est négociée avec le partenaire lors de la connexion : si pour l’un des correspondants cette option est à NO, la relance des transferts ne sera pas gérée. [RRUSIZE

= {2048 | n}]

{128..4096}

Taille maximale des NSDU (Network Service Data Unit) en réception. Ce paramètre est négocié avec le partenaire (paramètre SRUSIZE si moniteur CFT), la plus petite valeur sera retenue comme taille des NSDU transmis. Consultez le “Guide des protocoles” de CFT pour définir au mieux la valeur de ce paramètre. [SCREDIT

= {4 | n}]

{0..16}

Valeur du “crédit” (en nombre de messages “DATA”) proposée par CFT lorsqu’il est demandeur. CFT aura l’autorisation d’émettre un nombre de messages protocolaires “DATA” égal au résultat de la négociation (effectuée lors de l’établissement de la session protocolaire), avant d’attendre un nouveau “crédit” envoyé par le serveur.

CFT V2.3

5-33

Les commandes de paramétrage des réseaux et protocoles

[SRUSIZE

= {2048 | n}]

{128..4096}

Taille maximum des NSDU (Network service Data Unit) en émission. Ce paramètre est négocié avec le partenaire (paramètre RRUSIZE si moniteur CFT), la plus petite valeur étant retenue comme taille des NSDU émis. Consultez le “Guide des protocoles” de CFT pour définir au mieux la valeur de ce paramètre. MVS VM VSE

[TCP

En liaison X25/NPSI, la valeur maximum de SRUSIZE est égale à la valeur ‘X25.PIU’ configurée dans le NCP (ou l’équivalent) moins (-) 6 octets.

= {CFT | OFTP}]

Méthode de traitement utilisée pour les messages protocolaires : • CFT : activation de la méthode propre à CFT, • OFTP : activation de la méthode standard (RFC 2204). Ce paramètre s'applique aussi bien en mode initiateur que répondeur.

5.2.4. CFTPROT TYPE = PESIT - Protocole PeSIT La commande CFTPROT TYPE = PESIT permet de décrire le protocole de transfert PeSIT. En PeSIT, l’utilisateur peut préciser des paramètres contrôlant : • les mécanismes associés aux points de synchronisation, • le format des messages, • les différents algorithmes de compression, • le calcul de CRC. Attention : dans certains environnements, les mécanismes de repositionnement dans les fichiers transférés ne sont pas opérationnels avec tous les fichiers supportés ; les transferts reprennent alors en début de fichier, après une interruption de transfert (consultez le “Guide d’exploitation” de CFT correspondant à votre OS). Les quatres variantes de PeSIT supportées correspondent aux quatre valeurs du paramètre PROF (CFT, SIT, EXTERN, ANY). Certains des paramètres n’ont de sens que pour une ou plusieurs de ces variantes. Pour plus de clarté, ces paramètres spécifiques sont regroupés ci-dessous suivant la ou les valeurs correspondantes du paramètre PROF. Pour une explication détaillée des contraintes et des spécificités liées à l’utilisation de chacune de ces variantes, consultez : • pour la variante PeSIT profil SIT (PROF = SIT) : le “Guide des protocoles” de CFT, • pour les variantes PeSIT D profil EXTERN (PROF = EXTERN), PeSIT D profil CFT (PROF = CFT) et PeSIT E (PROF = ANY) : le “Guide des protocoles” de CFT.

5-34

CFT V2.3

Manuel de référence

5.2.4.1. Syntaxe CFTPROT [MODE ID NET

= {REPLACE | CREATE | DELETE},] = identifier, = identifier,

SAP

= string,

[DISCTD

= n,]

[DISCTS

= n,]

[RESTART [RTO

= {5 | n},] = {260 | n},]

[SCOMP

= cpr,]

[RCOMP

= cpr,]

[SRIN

= {BOTH | NONE | RECEIVER | SENDER},]

[SROUT [IDF

= {BOTH | NONE | RECEIVER | SENDER},] = string,]

TYPE [EXIT [EXITA [DYNAM

= = = =

[RRUSIZE [SRUSIZE [DISCTC [DISCTR [SPACING [RPACING [SCHKW [RCHKW

= = = = = = = =

[MULTART

= {NO | YES},]

PROFIL

[CONCAT

= {NO | YES},]

PROFIL

[SEGMENT

= {NO | YES},]

PROFIL

[PROF

= {CFT | ANY | EXTERN | SIT | DMZ},]

OS Dft : PROFIL Dft : PROFIL

Dft : PROFIL Dft : PROFIL

PESIT, identifier,] identifier,] identifier,] n,] n,] {90 | n},] {45 | n},] {36 | n},] {36 | n},] {2 | n},] {2 | n},]

PROF = DMZ

[PART [CYCLE [CTO

= (identifier, identifier, …),] = {0 | n},] = n]

PROF = EXTERN

[RESYNC [SSERV

= {NO | YES},] = identifier]

PROF = CFT

CFT V2.3

5-35

Les commandes de paramétrage des réseaux et protocoles

[RESYNC [SSERV [REVERSE [PAD

= = = =

{NO | YES},] identifier,] {NO | YES},] {NO | YES}]

= = = =

{NO | YES},] {NO | YES},] {NO | YES},] {YES | NO}]

PROF = ANY

[RESYNC [REVERSE [PAD [LOGON

5.2.4.2. Paramètres [CONCAT

= {NO | YES}]

Uniquement en mode émetteur

Option de concaténation des FPDU (File Protocole Data Unit) dans une même NSDU. Cette option n’est pas négociée. S’il n’y a pas de contrôle d’erreur (PAD = NO) : • en mode émetteur, CONCAT = YES est conseillé dans la mesure où le partenaire supporte la concaténation. PROFIL SIT

CONCAT = YES est OBLIGATOIRE.

• En mode récepteur, CFT accepte les FPDU concaténées, quelle que soit la valeur de ce paramètre. S’il y a contrôle d’erreur (PAD = YES) : • en mode émetteur, CFT inhibe la concaténation des FPDU. CONCAT est implicitement forcé par CFT à NO. • En mode récepteur, CFT rejette la réception des FPDU concaténées. [CTO

= n]

Durée (en minutes) minimale de la session (Cycle Time Out). A la fin d'un transfert, la temporisation d'attente d'un nouveau transfert est recalculée en fonction : • de l'heure d'ouverture de la session, • de l'heure courante, • du délai d'attente avant déconnexion (DISCTS du protocole), • de la durée de la session (CTO). La session est libérée si aucun transfert n'a été initié par le partenaire distant dans la durée indiquée.

5-36

CFT V2.3

Manuel de référence

[CYCLE

= {0 | n}]

Périodicité (en minutes) de création d'une session protocolaire : • 0 : session PeSIT ouverte au démarrage, • n : périodicité. [DISCTC

= {90 | n}]

{0..3600}

Temporisation d’attente (en secondes) de la FPDU de réponse (ACONNECT), après l’émission d’une FPDU CONNECT. Si la valeur est 0, le délai d’attente est infini. [DISCTR

= {45 | n}]

{0..3600}

Temporisation d’attente de déconnexion réseau. Délai d’attente (en secondes) de la coupure de connexion par le site partenaire, après avoir émis une demande “abort” (FPDU ABORT). Si la valeur est 0, le délai d’attente est infini. [LOGON = {YES | NO}] en mode demandeur

Uniquement

PeSIT E

Mise en oeuvre de la phase de pré-connexion. Suivant la valeur de ce paramètre : • YES : cette phase est mise en oeuvre. Le demandeur émet un message EBCDIC de 24 octets composé de : -

octet 1 à 8 : ‘PESIT ’ (PeSIT suivi de 3 caractères blancs) (correspondant au protocole utilisé),

-

octet 9 à 16 : identificateur demandeur (NSPART de CFTPART),

-

octet 17 à 24 : mot de passe du demandeur (NSPASSW de CFTPART).

• NO : cette phase n’est pas mise en oeuvre : le demandeur n’envoie pas de message. Remarque : le serveur CFT s’adapte automatiquement au choix du partenaire demandeur d’envoyer ou non un message de Logon. [MULTART

= {NO | YES}]

Uniquement en mode émetteur

Option de groupement de plusieurs enregistrements du fichier émis dans une même FPDU (FPDU multi-articles). • En mode émetteur, MULTART = YES est conseillé dans la mesure où le partenaire supporte les FPDU multi-articles. PeSIT profil SIT

La valeur MULTART = YES est INTERDITE dans ce profil.

• En mode récepteur, le moniteur CFT accepte les FPDU multi-articles, quelle que soit la valeur de ce paramètre.

CFT V2.3

5-37

Les commandes de paramétrage des réseaux et protocoles

[PAD

= {NO | YES}] Uniquement en mode demandeur

Profil CFT

Utilisation du CRC (Cyclic Redundancy Checksum). Cette option n’est pas négociée : en mode serveur, le moniteur CFT s’accorde toujours au choix du partenaire demandeur. L’option PAD = YES est obligatoire dans le cas d’un accès à travers un PAD.

[PART

= (identifier, identifier, …)

Liste des partenaires (4 maximum) pour lesquels une session PeSIT avec passage de tour de parole est cycliquement ouverte. Les partenaires inactifs (résultat d'une commande INACT) ne sont pas pris en compte.

[PROF

= {CFT | ANY | EXTERN | SIT | DMZ}]

Profil du protocole PeSIT D ou E. Ces profils peuvent être : • le profil SIT : le protocole PeSIT est alors utilisé dans le cadre du réseau SIT. Il est identique en PeSIT version D et version E. Il assure les fonctions de gestion des points de synchronisation mais ne gère : -

ni la segmentation : la valeur du paramètre SEGMENT doit être renseignée à NO (SEGMENT = NO),

-

ni le multi-articles : la valeur du paramètre MULTART doit être renseignée à NO (MULTART = NO). Remarque : l’émetteur en PeSIT profil SIT ne peut ni segmenter un article émis sur plusieurs FPDU de données, ni regrouper plusieurs articles émis dans une même FPDU de données,

-

ni la compression : les paramètres RCOMP et SCOMP ne sont pas pertinents,

-

ni de demande de réception.

• le profil EXTERN : correspond à la définition normalisée “hors SIT” (hors réseau SIT) du protocole PeSIT version D, • le profil CFT : le protocole PeSIT version D est utilisé hors du cadre du réseau SIT, le partenaire disposant également d’un moniteur CFT. Son niveau de fonctionnalité est supérieur aux spécifications PeSIT D profil EXTERN, • le profil ANY : correspond à la définition normalisée “hors SIT” (hors réseau SIT) du protocole PeSIT version E. Ce profil inclut, en standard, les fonctionnalités du profil CFT. Entre deux moniteurs CFT V2.2, des fonctionnalités supplémentaires sont offertes, tout en restant conformes au standard PeSIT E. Ces fonctionnalités sont basées sur l’utilisation du PI 99 (PI libre), • le profil DMZ (DeMilitarized Zone) : correspond à la définition normalisée "hors SIT" du protocole PeSIT version E (voir, dans le "Guide des protocoles" CFT, le paragraphe "Gestion du tour de parole") . Remarque : en mode serveur, le paramètre PROF peut prendre indifféremment les valeurs EXTERN, CFT ou ANY (correspondant aux profils “Hors SIT”) : en effet, le moniteur CFT en mode serveur s’adapte automatiquement au profil “Hors SIT” proposé par le partenaire demandeur. 5-38

CFT V2.3

Manuel de référence

[RCHKW

= {2 | n}]

{0..12}

Taille de la fenêtre d’anticipation de l’acquittement des points de synchronisation en réception, exprimée en nombre de points de synchronisation. Négociée avec le partenaire émetteur. RCHKW=0 signifie qu’il n’y a pas d’acquittement de points de synchronisation. RCHKW=1 revient à fonctionner en alternat. Sur réseau LU6.2, toute valeur non nulle sera forcée à 1 lors de la négociation protocolaire. [RESYNC

= {NO | YES}]

PeSIT D profil CFT

PeSIT D profil EXTERN

PeSIT E

Resynchronisation dynamique des échanges en cours de transfert (sans rompre la phase d’échange des données). Cette option est négociée avec le partenaire lors de la connexion : si pour l’un des correspondants cette option est à NO, la resynchronisation dynamique ne sera pas gérée. Remarque : entre deux moniteurs CFT, le seul cas de resynchronisation dynamique possible est fait sur détection d’une erreur de CRC (PAD=YES). [REVERSE

= {NO |YES}] Uniquement en mode demandeur

PeSIT E

PeSIT D profil CFT

Option de réutilisation d’une connexion pour enchaîner deux transferts de sens différents. [RPACING = {36 | n}]

{0..32767}

Valeur de l’intervalle entre points de synchronisation pour les réceptions (en Koctets) (1 Koctet = 1024 octets) (voir explications du paramètre SPACING). Ce paramètre est négocié avec le partenaire (paramètre SPACING si moniteur CFT), la plus petite valeur sera retenue comme intervalle entre les points de synchronisation. Une valeur nulle (RPACING = 0) signifie qu’il n’y a pas de pose de points de synchronisation. [RRUSIZE

= {4056 | n}]

{254..32767}

Taille maximale des NSDU en réception et en émission. Ce paramètre est négocié avec le partenaire (paramètre SRUSIZE si moniteur CFT), la plus petite valeur sera retenue comme taille des NSDU transmis. Consultez le “Guide des protocoles” de CFT pour définir au mieux la valeur de ce paramètre.

[SCHKW

= {2 | n}]

{0..12}

Taille de la fenêtre d’anticipation de l’acquittement des points de synchronisation en émission, exprimée en nombre de points de synchronisation. Négociée avec le partenaire récepteur.

CFT V2.3

5-39

Les commandes de paramétrage des réseaux et protocoles

L’émetteur dispose d’une fenêtre d’acquittement dont la valeur est négociée en phase de connexion avec la valeur RCHKW du partenaire. Cette fenêtre permet d’émettre les données en anticipation sur les acquittements. SCHKW=0 signifie qu’il n’y pas d’acquittement de points de synchronisation. Sur réseau LU6.2, toute valeur non nulle sera forcée à 1 lors de la négociation protocolaire. [SEGMENT = {NO | YES}] en mode émetteur

Uniquement

PROFIL

Option de segmentation des articles de fichier sur plusieurs FPDU : • NO : segmentation “si nécessaire”. Mise en oeuvre automatiquement dès qu’un article à transférer est supérieure à la taille maximum d’une NSDU diminué de 6 octets. Ceci concerne les FPDU de données et non les autres FPDU protocolaires. Rappelons que la taille des NSDU à l’émission est négociée à l’aide du paramètre SRUSIZE de CFTPROT, • YES : segmentation “systématique”. Mise en oeuvre par le moniteur pour compléter une “unité de données” (NSDU). Elle concerne donc toutes tailles d’articles. Cette option n’est efficace que si elle est employée conjointement avec l’option CONCAT = YES. Elle n’est pas exclusive avec l’option MULTART = YES. PROFIL SIT

La valeur SEGMENT = YES est INTERDITE en profil SIT.

Cette option n’est pas négociée. Pour les autres profils, elle ne peut être adoptée (SEGMENT = YES) que face à un moniteur supportant la concaténation, dans une même unité de données (NSDU), des FPDUs DTF (article complet) et DTFDA (début d’article), DTFMA (milieu d’article) ou DTFFA (fin d’article). Face à un moniteur CFT, à partir la version V210, elle peut toujours être adoptée. En effet, en mode récepteur, ce moniteur accepte les FPDU d’articles segmentés quelle que soit la valeur locale du paramètre SEGMENT. Remarque : la valeur SEGMENT = YES est conseillée pour optimiser les transferts entre deux moniteurs V2.1.0 ou supérieur. Si un moniteur est en version V2.0, SEGMENT doit être renseigné à NO car ces versions ne supportent pas la segmentation. [SPACING

= {36 | n}]

{0..32767}

Intervalle entre points de synchronisation en émission (en Koctets) (1 Koctet = 1 024 octets). Ce paramètre est négocié avec le partenaire (paramètre RPACING si moniteur CFT), la plus petite valeur sera retenue comme intervalle entre les points de synchronisation. La valeur 0 signifie qu’il n’y a pas de point de synchronisation. Au cours d’un transfert, les deux partenaires PeSIT prennent un ‘point de synchronisation’ à chaque fois que l’émetteur envoie une FPDU ‘SYN’. Il y a émission d’une FPDU ‘SYN’ tous les ‘n Koctets’ de données transmises (‘n’ étant la valeur d’intervalle la plus petite négociée en phase de connexion - entre SPACING et RPACING dans le cas de moniteurs CFT). Chaque point de synchronisation acquitté est susceptible de constituer, en cas d’interruption du transfert, un point de reprise pour une relance ultérieure. 5-40

CFT V2.3

Manuel de référence

[SRUSIZE

= {4056 | n}]

{254..32767}

Taille maximale des NSDU en réception et en émission. Ce paramètre est négocié avec le partenaire (paramètre RRUSIZE si moniteur CFT), la plus petite valeur étant retenue comme taille des NSDU émis. Pour le transfert d’un article dont la longueur est supérieure à (SRUSIZE - 6), l’opération de segmentation est mise en oeuvre. Consultez le “Guide des protocoles” de CFT pour définir au mieux la valeur de ce paramètre. MVS VM VSE

[SSERV

En liaison X25/NPSI, la valeur maximum de SRUSIZE est égale à la valeur ‘X25.PIU’ configurée dans le NCP (ou l’équivalent) moins (-) 6 octets.

= {voir le commentaire | identifier}]

PeSIT D profil CFT

PeSIT D profil EXTERN

Identifie le “service” (variante de protocole) requis du partenaire entrant. Sa valeur est transportée dans le message de LOGON du protocole PeSIT. Ce paramètre n’est à préciser qu’en profil CFT (ou éventuellement Extern) dans certains cas particuliers. Certains produits (voir ci-dessous) s’en servent comme sélecteur de protocole lors des appels entrants. PeSIT D profil EXTERN

PeSIT D profil CFT

En profil Extern, la valeur par défaut est : SSERV = ‘PESIT ’. Cette valeur est normalisée. En profil CFT, la valeur par défaut est : SSERV = ‘CFTPSITX’. Cette valeur ne convient qu’en méthode d’accès X25. Avec les autres méthodes d’accès réseau, on emploie usuellement les valeurs suivantes : en SNA LU-0 : CFTPSITS, en SNA 3270 : CFTPSIT2, en PAD : CFTPSITP. Face à CFT 370/V1, on fait correspondre cette valeur à la valeur de RSERV configurée dans la V1. Face à CFT/PC, on fait correspondre cette valeur au paramétrage (Login type) de CFT/PC.

PeSIT profil ANY

La valeur SSERV=GSIT est utilisée en mode demandeur pour les échanges en TCP/IP. L’utilisation de cette valeur de paramètre n’influe pas sur le contenu du message qui contient alors la valeur “PESIT.

Rappelons qu’en profil SIT, la valeur par défaut est : SSERV = ‘ ’. Dans ce profil, ce paramètre est sans effet. En effet, en profil SIT, il n’y a pas de message de Logon.

CFT V2.3

5-41

Les commandes de paramétrage des réseaux et protocoles

5.2.4.3. Exemples PeSIT profil SIT

CFTPROT

ID */ TYPE NET SCOMP */ RCOMP */ CONCAT

= PSITIN,

/* Protocole PSITIN

= PESIT, PROF=SIT, /* PeSIT SIT */ = ACCEPTOR, = 0, /* Pas de compression = 0,

/*

en profil SIT

= YES

Protocole PeSIT, profil SIT, associé au protocole d’échange de données et aux ressources réseau définies par la commande CFTNET ID=ACCEPTOR. Les temporisations seront les valeurs par défaut (consultez l’annexe “La compression” de ce document). Chaque FPDU contient un seul enregistrement de fichier (MULTART=NO). Il n’y aura pas de compression en ligne. PeSIT D profil EXTERN

CFTPROT

ID TYPE NET PROF CONCAT MULTART SEGMENT

= = = = = = =

PSITEXT, PESIT, xx, EXTERN, YES, YES, NO

ID TYPE NET PROF CONCAT MULTART SEGMENT

= = = = = = =

PSITCFT, PESIT, yy, CFT, YES, YES, YES

ID TYPE NET PROF CONCAT MULTART SEGMENT

= = = = = = =

PSITE, PESIT, zz, ANY, YES, YES, YES

PeSIT D profil CFT

CFTPROT

PeSIT E

CFTPROT

5-42

CFT V2.3

Manuel de référence

5.3 CFTETB - Format d e la carte ETEBAC 3 La commande CFTETB est nécessaire si le paramétrage de CFT contient une commande CFTPROT de type ETEBAC 3. Cette commande permet de créer, modifier ou supprimer, suivant les caractéristiques relatives au transfert (identification du ou des partenaires ...), le format de la carte paramètre utilisée pour ce transfert. Rappelons qu’en ETEBAC 3, une carte paramètre est échangée entre les correspondants, lors de l’établissement de la connexion, ce qui permet de s’accorder en particulier sur le format des données échangées.

5.3.1. Caractéristiques relatives au transfert En mode demandeur, les commandes CFTETB peuvent désigner explicitement : • un partenaire donné (défini par CFTPART), • un identifiant de fichier type (défini dans la commande de transfert correspondante CFTSEND/SEND ou CFTRECV/RECV). Ceci aussi bien en émission (DIRECT = SEND) qu’en réception (DIRECT = RECV). Dans ce mode, les commandes génériques CFTETB ID = ALL, où ALL désigne “tous les partenaires” sont également exploitées. En mode serveur, seules les commandes génériques CFTETB ID=ALL sont prises en compte, c’est-à-dire : • CFTETB ID = ALL, DIRECT = SEND, ... permettant de décrire la carte générique utilisée en émission, • et/ou la carte CFTETB ID=ALL, DIRECT = RECV, ... permettant de décrire la carte générique utilisée en réception. Attention : il faut obligatoirement préciser (en mode demandeur et en mode serveur), au minimum, ces 2 commandes, car elles permettent de décrire la carte générique utilisée en émission et celle utilisée en réception : CFTETB

ID DIRECT . . .

= =

ALL, SEND,

CFTETB

ID DIRECT . . .

= =

ALL, RECV,

CFT V2.3

5-43

Les commandes de paramétrage des réseaux et protocoles

5.3.2. Description du format de la carte paramètre Une carte paramètre a une longueur totale de 80 caractères en format EBCDIC. Son en-tête est imposée par la norme ETEBAC 3 et est composée : • en première position (position numérotée par la suite à 0) : d’un octet indiquant le sens de transmission, • de trois octets réservés, • en cinquième position (position numérotée à 4) : de quatre octets indiquant la longueur d’enregistrement du fichier à transmettre. Le contenu des autres champs n’est pas imposé par la norme, leur signification est définie conventionnellement entre les correspondants. Les valeurs des paramètres de la commande CFTETB décrivant le format de la carte paramètre, sont indiquées ci-dessous sous la forme : paramètre = {pos, 255 | len} ou paramètre = {pos, 255 | len | content} tel que : • “pos” définit la position dans la carte paramètre du champ décrit par ce paramètre. La valeur de “pos” est le nombre de caractères précédant ce champ dans la carte paramètre. Elle est positive, • “len” définit la longueur en nombre de caractères de ce champ. La valeur particulière “255” signifie que le paramètre concerné est absent de cette carte paramètre (valeur par défaut). Comme une carte paramètre a une longueur totale de 80 caractères et que 8 caractères sont obligatoires en en-tête de carte, la somme des longueurs des champs “len” des paramètres facultatifs utilisés ne peut dépasser 72 caractères (en protocole ETEBAC 3). Si le nombre de caractères affecté à un champ est inférieur à celui indiqué dans le champ “len”, ce champ est complété dans la carte par des caractères “blancs” EBCDIC (x40). Il convient de noter que le moniteur CFT laisse la possibilité, en cinquième position de la carte, de ne pas indiquer de longueur d’enregistrement ou d’indiquer une longueur d’enregistrement supérieure à quatre octets. Ceci n’est pas protocolaire ETEBAC 3 mais peut être utilisé par des correspondants qui ont défini une telle convention, • “content” définit le contenu du champ sous la forme d’une chaînes de caractères arbitraires, échangées entre les partenaires mais non exploitées par le moniteur CFT. Consultez le “Guide des protocoles” du moniteur CFT pour une description plus complète de l’exploitation du moniteur CFT, en protocole ETEBAC.

5-44

CFT V2.3

Manuel de référence

5.3.3. Syntaxe CFTETB [MODE

=

DIRECT = ID = [IDF = NLRECL = [SNAME = [NSPASSW = [NIDF = [VER = [NPART = [NBR = [PARM = [FREE1 = [FREE2 =

{REPLACE | CREATE | DELETE},] {RECV | SEND}, identifier, {“ ” | identifier},] {pos, 255 | len}, {pos, 255 | len},] {pos, 255 | len},] {pos, 255 | len},] {pos, 255 | len},] {pos, 255 | len},] {pos, 255 | len},] {pos, 255 | len},] {pos, 255 | len,content},] {pos, 255 | len,content}]

5.3.4. Paramètres DIRECT

= {RECV | SEND}

Sens du transfert auquel la carte paramètre s’applique. [FREE1

= {pos, 255 | len, content}]

Position (pos), longueur (len) et contenu (content) du premier champ libre dans la carte paramètre. Le champ “content” permet de définir une chaîne de caractères arbitraires, échangées entre les partenaires mais non exploitées par le moniteur CFT. Cette chaîne doit avoir une longueur inférieure ou égale à la longueur indiquée dans le champ “len”. [FREE2

= {pos, 255 | len, content}]

Position (pos), longueur (len) et contenu (content) du second champ libre dans la carte paramètre. Le champ “content” permet de définir une chaîne de caractères arbitraires, échangées entre les partenaires mais non exploitées par le moniteur CFT. Cette chaîne doit avoir une longueur inférieure ou égale à la longueur indiquée dans le champ “len”. ID

= identifier Identifiant local du partenaire associé à ce format de carte (ID de CFTPART). La valeur conventionnelle ALL désigne “tous les partenaires”. En mode demandeur, la carte paramètre sera composée à partir : • soit de la description CFTETB telle que l’ID soit égal à l’identifiant du partenaire concerné, • soit, si cette description n’existe pas, de la description CFTETB ID = ALL.

CFT V2.3

5-45

Les commandes de paramétrage des réseaux et protocoles

En mode serveur, c’est toujours la description CFTETB ID = ALL qui permet de décoder la carte paramètre reçue (le partenaire est encore inconnu). [IDF

= {“

” | identifier}]

Identifiant local du fichier type associé à ce format de carte (ID de CFTSEND/CFTRECV). Si ce paramètre n’est pas renseigné (valeur par défaut = 8 blancs), la carte convient à tous les fichiers types. Ainsi : • en mode demandeur, la carte paramètre sera composée à partir : -

soit d’une description CFTETB telle que l’IDF soit égal à l’identifiant de fichier type de la requête de transfert,

-

soit, si cette description n’existe pas, de la description CFTETB IDF = ‘

• en mode serveur, c’est toujours la description CFTETB IDF = ‘ décoder la carte paramètre reçue.

’,

’ qui permet de

Il est donc nécessaire, pour fonctionner en mode serveur, de disposer des descriptions suivantes : CFTETB CFTETB [NBR

DIRECT = SEND, DIRECT = RECV,

ID = ID =

ALL, ALL,

IDF IDF

= =

‘ ‘

’ ’

= {pos, 255 | len}]

Position (pos) et longueur (len) du champ “nombre d’enregistrements” du fichier à transmettre. [NIDF

= {pos, 255 | len}]

Position (pos) et longueur (len) du champ “identifiant réseau de fichier type”. NLRECL

= {pos, 255 | len}

Position (pos) et longueur (len) du champ “longueur d’enregistrement” du fichier à transmettre. Pour être conforme à la norme ETEBAC 3, “pos” doit être égal à 4 et “len” égal à 4. Le moniteur offre cependant toute latitude pour fixer, selon le besoin, des valeurs différentes. [NPART

= {pos, 255 | len}]

Position (pos) et longueur (len) du champ “identifiant réseau du partenaire”. Indique le champ de stockage du NRPART (de CFTPART) d’un CFT demandeur. [NSPASSW

= {pos, 255 | len}]

Position (pos) et longueur (len) du champ “mot de passe” du demandeur. Indique le champ de stockage du NSPASSW (de CFTPART). [PARM

= {pos, 255 | len}]

Indique le champ de stockage du PARM (de CFTSEND).

5-46

CFT V2.3

Manuel de référence

[SNAME

= {pos, 255 | len}]

Position (pos) et longueur (len) du champ “identifiant du demandeur”. Indique le champ de stockage du NSPART (de CFTPART). [VER

= {pos, 255 | len}]

Position (pos) et longueur (len) du champ “numéro de version” du fichier. En mode demandeur récepteur, la carte ETEBAC 3 est créée lors de la demande de sélection. Le paramètre VER est renseigné à partir du numéro de version du fichier à recevoir, contenu dans le paramètre NFVER de la commande RECV. En mode serveur émetteur, la carte ETEBAC 3 est analysée lors de l’indication de connexion. Le numéro de version du fichier est extrait du paramètre VER.

5.3.5. Exemple CFTETB

CFT V2.3

MODE DIRECT ID NLRECL NSPASSW FREE1 FREE2 NPART

= = = = = = = =

REPLACE, RECV, ALL, (4,4), (8,8), (16,12,’MESSAGE #1 ’), (28,24,’MESSAGE DE BIENVENUE No2’), (52,18)

5-47

6. Les commandes de paramétrage des partenaires 6.1 CFTPART - Définiti on d’un partenaire La commande CFTPART décrit les caractéristiques de chaque partenaire : •

•

relatifs à l’environnement réseau / protocole en définissant : –

les protocoles CFT utilisables avec ce partenaire et les valeurs des “SAPs” (sélecteurs de protocole) associées,

–

l’identification réseau - nom réseau, mot de passe - connue du partenaire/identifiant le partenaire,

–

l’identification du partenaire intermédiaire, en cas d’absence de liaison directe,

–

l'identification du profil de sécurité (SSL). Pour une information complémentaire, consultez le "Guide de la sécurité de transport",

relatifs aux transferts effectués en définissant : –

le mode de transfert,

–

la table de transcodage associée au partenaire,

–

le type de système d’exploitation de la machine du partenaire (permettant de déduire le code des données ou les types de fichier de ce partenaire),

–

les heures d’appel autorisées (vers ce partenaire / depuis ce partenaire),

–

les listes d’identifiants de fichiers autorisés en émission et en réception,

–

l’état du partenaire (actif ou inactif, en mode demandeur ou serveur).

6.1.1. Syntaxe CFTPART

CFT V2.3

ID SAP [COMMENT [COMMUT [FPREFIX [GROUP [IDF [IMAXTIME [IMINTIME [IPART [MODE [NRPART

= = = = = = = = = = = =

identifier, (string, string, ....), string,] {YES | NO | SERVER | PART},] string,] identifier,] identifier,] {23595999 | time},] {00000000 | time},] identifier,] {REPLACE | CREATE | DELETE},] string,]

[NRPASSW

= string,]

PROTOCOLE

[NSPART

= string,]

PROTOCOLE

PROTOCOLE

6-1

Les commandes de paramétrage des partenaires

[NSPASSW

= string,]

[OMAXTIME [OMINTIME [PROT [RAUTH [SAUTH [STATE [SYST

= = = = = = =

[TRK [XLATE

PROTOCOLE

{23595999 | time},] {00000000 | time},] (identifier | mask, identifier | mask, ...),] {* | identifier},] {* | identifier},] {ACTIVEBOTH | ACTIVEREQ | ACTIVESERV | NOACTIVE}] GCOS7 | GCOS8 | GUARD | UNIX | VMS | VOS | MVS | VM | VSE | OS400 | WINNT |WIN3X},] = {UNDEFINED | ALL | NO | SUMMARY},] = identifier]

6.1.2. Paramètres [COMMENT = string32] Commentaire local associé au partenaire. Non exploité lors des transferts, excepté pour le protocole ODETTE. Peut être consulté (par exemple par la commande LISTPART). On peut donc l’utiliser pour associer localement un libellé long (description en clair) au partenaire. ODETTE

Mise en œuvre pour l’EERP. Le protocole ODETTE admet 2 modes distincts de traitement de l’EERP : le mode 86 (GALIA) et le mode 91 (Groupe de travail ODETTE). La valeur du champ COMMENT permet d’identifier le mode : - mode 86 : COMMENT = ‘EERP=86’, - mode 91 : COMMENT = ‘EERP=91’. Si ce paramètre n’est pas renseigné, c’est la valeur explicitement paramétrée dans la commande CFTPROT qui sera valide pour tout partenaire rattaché à ce protocole.

[COMMUT = {YES | NO | SERVER | PART}] Type de commutation supporté pour ce partenaire.

Uniquement sur un site de commutation

Les types suivants sont possibles : •

YES

•

SERVER : correspond à la “commutation par serveur RVA”,

•

NO

•

PART : la commutation est forcée en mode serveur si le destinataire renseigné dans le paramètre IPART n'est pas le destinataire final.

: correspond à la “commutation store and forward”, : la commutation est refusée pour ce partenaire,

Les traitements possibles suivant le type de commutation sont détaillés dans le guide “Concepts” de CFT, au paragraphe “Transfert avec routage - Mode de commutation”. [FPREFIX = string1..64] Nom de fichier. Ce paramètre permet d’associer un nom de fichier à un partenaire. A l’émission ou à la réception (CFTSEND ou SEND, CFTRECV ou RECV), ce nom de fichier est concaténé au nom spécifié dans le paramètre FNAME.

6-2

CFT V2.3

Manuel de référence

[GROUP = identifier] Groupe auquel appartient le partenaire. Ce paramètre est d’usage local et permet de renseigner (en local) la variable symbolique &GROUP. Cette variable symbolique peut être utilisée pour nommer un fichier (FNAME = &GROUP) ou une procédure de fin de transfert (exemple : EXEC = &GROUP). ID

= identifier Identifiant local du partenaire.

[IDF = identifier] Identifiant (sur 8 caractères) par défaut du fichier pour le partenaire. Ce paramètre offre la possibilité de désigner un nom générique par partenaire. Valable en émission (SEND) et en réception (RECV), celui-ci est prioritaire par rapport au paramètre DEFAULT de la commande CFTPARM. [IMAXTIME = {23595999 | time}] Heure maximum après laquelle le partenaire ne peut appeler. [IMINTIME ={ 00000000 | time}] Heure minimum avant laquelle le partenaire ne peut appeler. IMINTIME et IMAXTIME définissent la fourchette d’appel du moniteur CFT par le partenaire (appels entrants). Une fourchette de durée nulle - les appels entrants n’étant donc pas autorisés (IMINTIME = IMAXTIME) permet de paramétrer plusieurs CFTPART avec le même NRPART et des NSPART différents, l’utilisation de ces commandes étant strictement limitée au mode demandeur (voir le mécanisme dans l’annexe “Partenaire à même valeur de NRPART” du guide “Concepts” de CFT). [IPART = identifier] Dénomination locale identifiant un partenaire intermédiaire. La valeur identifier doit correspondre au paramètre ID d’une commande CFTPART. Ce paramètre intervient dans le mécanisme de commutation de fichier ou de “backup” décrit dans le guide “Concepts” de CFT. [NRPART

= {Valeur de ID | string}] string8 string24 string25 string28

PeSIT profil SIT PeSIT D profil EXTERN

PeSIT D profil CFT

PeSIT E ODETTE ETEBAC3

Dénomination “réseau” du partenaire, autorisant l’identification de celui-ci lors des appels entrants.

CFT V2.3

6-3

Les commandes de paramétrage des partenaires

Le partenaire doit se présenter sous ce nom au moniteur CFT, lors de la phase de connexion. Côté partenaire (s’il s’agit d’un moniteur CFT V2), cette valeur correspond au paramètre NSPART de la commande CFTPART décrivant le moniteur CFT local. Remarque : ODETTE

[NRPASSW

En mode serveur, il est possible d’avoir plusieurs commandes CFTPART comportant un NRPART identique. Pour cela, il faut spécifier IMINTIME = IMAXTIME.

= string] string8 string8 string22

ETEBAC3 ODETTE PeSIT

Mot de passe d’accueil du partenaire, autorisant un contrôle d’autorisation d’accès sur le site local. Le partenaire doit présenter ce mot de passe au moniteur CFT local, lors de la phase de connexion. De son côté, ce partenaire (s’il s’agit d’un moniteur CFT V2) doit déclarer ce mot de passe comme paramètre NSPASSW de la commande CFTPART décrivant le moniteur CFT local. [NSPART

= {valeur du paramètre NPART de CFTPARM | string}] string8

PeSIT profil SIT PeSIT D profil EXTERN

string24

PeSIT E

string25

ODETTE

string28

PeSIT D profil CFT

ETEBAC3

Dénomination “réseau” sous laquelle le moniteur CFT local va se présenter à son partenaire. S’il s’agit d’un moniteur CFT V2, ce partenaire (distant) doit retrouver la description CFTPART telle que le paramètre NRPART associé corresponde à cette valeur. [NSPASSW

= string] string8

PeSIT

string8

ODETTE

string22

ETEBAC3

Mot de passe de présentation auprès du partenaire. S’il s’agit d’un moniteur CFT V2, ce partenaire (distant) contrôle que le mot de passe reçu est égal à la valeur du paramètre NRPASSW documentée dans la description du CFTPART correspondant.

6-4

CFT V2.3

Manuel de référence

[OMAXTIME = {23595999 | time}] Heure maximum après laquelle le partenaire ne peut plus être appelé. [OMINTIME = {00000000 | time}] Heure minimum avant laquelle le partenaire ne peut être appelé. OMINTIME et OMAXTIME définissent la fourchette d’appel de ce partenaire par le moniteur CFT (appels sortants). Une fourchette de durée nulle signifie que le moniteur CFT ne peut appeler directement le partenaire ; il met alors en oeuvre le mécanisme de commutation en appelant le site intermédiaire (paramètre IPART). PROT = (identifier | mask, identifier | mask,..) Liste des protocoles de communication (identifiants ID de CFTPROT) autorisés pour communiquer avec ce partenaire. Le nombre maximum de protocoles supportés est de 4. En cas de transferts simultanés avec ce partenaire, le moniteur CFT impose que tous ces transferts s’effectuent selon le même protocole. La valeur du paramètre PROT peut comporter des caractères “jokers” (mask). Cette syntaxe n’est exploitée qu’en mode serveur. Elle signifie, alors, que le moniteur acceptera tout protocole dont l’identifiant correspond à la valeur générique ainsi définie. Exemple 1 : PROT = (prot1 , *) Exemple 2 : PROT = (prot1 , prot?) Le caractère ‘?’ désigne le caractère char_mask défini dans le “Guide d’exploitation” de CFT correspondant à votre OS. En mode demandeur : seul le protocole “prot1” est utilisé. En mode serveur, la communication peut être établie : •

dans le premier exemple, par tous les protocoles définis au niveau du moniteur,

•

dans le second exemple, par tous les protocoles commençant par les lettres “prot”.

[RAUTH = {* | identifier} ] Identifiant (paramètre ID) de la commande CFTAUTH désignant une liste d’IDF autorisés pour les transferts en réception avec ce partenaire. RAUTH=* signifie que tous les fichiers types (tous les IDF) peuvent être reçus. Les valeurs identifier commençant par les caractères ‘NOT’ désignent des listes d’IDF non autorisés (voir la commande CFTAUTH).

CFT V2.3

6-5

Les commandes de paramétrage des partenaires

SAP

= (string, string, ...) longueur : voir le tableau ci-dessous Valeurs des SAPs distants (service access points) associés à chacun des protocoles définis par le paramètre PROT. Vers un autre moniteur que le moniteur CFT V2, l’emploi de cette information complémentaire est à étudier au cas par cas. Vers un moniteur CFT V2, ce paramètre est exploité pour désigner le protocole auprès du moniteur CFT V2 partenaire. En d’autres termes, le “sap” est une information complémentaire permettant d’atteindre un sous-ensemble applicatif distant (un protocole dans le cas de CFT) et non pas seulement un moniteur. Chacune des valeurs du paramètre représente le “sap” associé au protocole de communication dont l’identifiant est en correspondance dans le paramètre PROT. Exemple : si

PROT = (PESITX25, ETEBCX25) SAP = (03, 04) 03 est le “sap” du partenaire pour le protocole PESITX25. 04 est le “sap” du partenaire pour le protocole ETEBCX25. La valeur de ce paramètre peut être exprimée sous forme hexadécimale. Dans ce cas, le premier caractère doit être “#” (dièse) (par exemple : #31 sera compris comme caractère ASCII ‘1’). Le nombre maximum de SAPs est égal au nombre maximum de protocoles (voir le tableau du paramètre PROT). La valeur de ce paramètre est particulière à chaque protocole d’échange de données, et éventuellement à chaque système, tel que précisé dans le tableau ci-après.

6-6

CFT V2.3

Manuel de référence

Tableau 67. CFTPART SAP - Valeurs du paramètre Méthode d’accès

Taille en caractères (alphanum)

Définition et Commentaires

DNA

1à6

OBJET Decnet

GCOS7

1à8

“Mailbox” (nom de la boîte aux lettres DSA) de l’application moniteur distant

GCOS8

1à8

“Mailbox” (nom de la boîte aux lettres DSA) de l’application moniteur distant telle que définie dans la ”Workstation” de cette application

DSA

LU6.2

Sans objet, ne doit pas être précisé Le protocole partenaire sera déterminé par la LU appelée

SNA

Sans objet, ne doit pas être précisé Le protocole partenaire sera déterminé par la LU appelée

TCP/IP

1 à 15

X25 sauf GCOS7 et GCOS8

1 à 15

Numéro du port sur lequel le moniteur partenaire est à l’écoute et qui peut avoir comme valeur : • un numéro en clair correspondant au numéro réel utilisé par le partenaire distant au niveau du protocole Numéros autorisés : entre 1025 et 65535 (bornes exclues) Numéros conseillés : 1761, 1762, 1763, 1764, 1765, 1766, 1767, 1768 (1) • le nom logique associé au numéro utilisé par TCP/IP et configuré dans le fichier SERVICES, si celui-ci existe Noms logiques conseillés : cft-0, cft-1, cft-2, cft-3, cft-4, cft-5, cft-6, cft-7 (1) Remarque : si les commandes de paramétrage CFTPART (en local) et CFTPROT (chez le partenaire) utilisent le nom logique du port défini dans la base de données “SERVICES”, la cohérence entre les 2 bases doit être assurée Valeur véhiculée dans le paquet d’appels sortant sous la forme : • de sous adresse (subaddr) dont la valeur doit être numérique et qui sera interprétée en majuscules (ex : SAP=33) • de données utilisateur (user data) de format hexadécimal (ex : SAP= #3132 12 ASCII) ou alphanumérique (ex : SAP= ABC, SAP = X25) Cas particulier OS400 : en user data, seul le premier caractère (limité à certaines plages de valeurs) est significatif pour le routage des appels entrants (consultez le “Guide d’exploitation” de CFT correspondant à votre OS)

(1) : ces numéros et noms logiques de ports sont des noms et numéros officiellement réservés par SOPRA auprès de l’IANA (Internet Assigned Numbers Authority).

CFT V2.3

6-7

Les commandes de paramétrage des partenaires

[SAUTH = {* | identifier}] Identifiant (paramètre ID) de la commande CFTAUTH désignant une liste d’IDF autorisés pour les transferts en émission vers ce partenaire. SAUTH =* signifie que tous les fichiers types (tous les IDF) peuvent être émis. Les valeurs identifier commençant par les caractères ‘NOT’ désignent des listes d’IDF non autorisés (voir la commande CFTAUTH). [STATE = {ACTIVEBOTH | ACTIVEREQ | ACTIVESERV | NOACTIVE}] Etat du partenaire. •

ACTIVEBOTH : partenaire actif dans tous les modes,

•

ACTIVEREQ : partenaire actif en mode demandeur seulement,

•

ACTIVESERV : partenaire actif en mode serveur seulement,

•

NOACTIVE : partenaire totalement inactif.

[SYST

= {GCOS7 | GCOS8 | GUARDIAN | UNIX | VMS | VOS | MVS | VM | VSE | OS400 | MSDOS| WINNT | WIN3X}] Type de système d’exploitation supportant le moniteur partenaire. Si ce paramètre n’est pas renseigné, le partenaire est considéré avoir le même système d’exploitation que la machine locale. Ce paramètre permet au moniteur : •

de déduire le code des données sur la machine partenaire (voir le commentaire du paramètre FCODE de la commande CFTXLATE),

•

dans ce profil et lorsque le partenaire est récepteur, de déclarer au moniteur CFT V2 partenaire le “type” de ce fichier, au sens de son système d’exploitation (paramètre NTYPE).

PeSIT D profil CFT

PeSIT E CFT/CFT

[TRK = {UNDEFINED | ALL | NO | SUMMARY}] Spécification du niveau de détail que CFT fournit à Sentinel sur les transferts. CFT envoie les informations sur le transfert sous forme d'occurrences de suivi. Les valeurs possibles de ce paramétre sont : • NO :

le moniteur n'envoie jamais d'occurrences de suivi à Sentinel,

• ALL :

le moniteur envoie une occurrence de suivi à Sentinel pour chaque étape de chaque transfert,

• SUMMARY : le moniteur envoie une occurrence de suivi à Sentinel uniquement pour l'étape initiale et l'étape finale de chaque transfert, • UNDEFINED : les options de suivi sont définies dans le paramètre TRKPART de la commande CFTPARM. TRK n'est utilisable qu'à partir de la version CFT V2.3.1.

6-8

CFT V2.3

Manuel de référence

[XLATE = identifier] Identifiant de la table de transcodage utilisée pour les transferts avec ce partenaire. La table de transcodage est définie par la commande CFTXLATE ID= . Si ce paramètre n’est pas renseigné, les tables de transcodage peuvent également être précisées dans les commandes SEND/CFTSEND (ou RECV/CFTRECV). Si ces tables n’y sont pas renseignées, la commande CFTXLATE ID= les précise par défaut. En cas d’absence de cette commande, ce sont les tables de transcodage internes au moniteur qui sont utilisées (voir leur description en annexe). Pour une information complémentaire sur la mise en oeuvre des tables de transcodage, consultez le paragraphe “Transcodage”, dans le guide “Concepts” de CFT.

6.1.3. Exemple CFTPART MODE CREATE, ID = PARIS5, /* Identifiant partenaire PROT = PSITCFT, /* Un seul protocole de communication -> voir CFTPROT SAP = 13, /* Mailbox distante pour ce protocole RAUTH NRPART NRPASSW NSPART NSPASSW IMINTIME IMAXTIME

= */ */ */

= RECPAR5, /* Les fichiers autorisés à recevoir --> voir CFTAUTH */ = BULLDPS, /* Nom et mot de passe que le */ = 44NTS, /* partenaire présente à la connexion */ = LOCALCFT,/* Nom et mot de passe que CFT présente */ = 75P015, /* au partenaire à la connexion */ = 0700, /* Ne peut appeler qu’entre */ = 0900, /* 7 et 9 heures */

OMINTIME = 1000, OMAXTIME = 1200,

/* Ne peut être appelé qu’entre /* 10 heures et midi

*/ */

Le paramètre OPEN = NO n’existe plus en version 2.2.0 de CFT. Le paramètre SAUTH est omis. Le partenaire peut donc émettre n’importe quel IDF vers le moniteur CFT local, alors qu’il n’est autorisé à recevoir que les fichiers auxquels on a attribué un IDF figurant dans la liste RECPAR5 définie par une commande CFTAUTH. Le paramètre SYST n’étant pas précisé, le moniteur considère que son partenaire est la même machine. Il n’y a donc pas de conversion de code des données, et pas de traduction des types de fichier émis.

CFT V2.3

6-9

Les commandes de paramétrage des partenaires

6.2 CFTDEST - Définiti on d’une listes de partenaires La commande CFTDEST sert à spécifier un “pseudo” partenaire référençant une liste de partenaires, afin d’effectuer en une seule commande : •

la diffusion de fichier (ou de message) vers plusieurs partenaires. Cette diffusion peut être activée :

•

–

par une commande SEND locale,

–

ou par une commande SEND venant d’un partenaire distant, le moniteur local jouant le rôle de site intermédiaire,

ou la collecte de fichiers (ou de messages) venant de plusieurs partenaires. Cette collecte est activée par une commande RECV locale.

Cette liste de partenaires peut être décrite soit : •

explicitement, en utilisant le paramètre PART,

•

dans un fichier où est enregistrée cette liste, le nom de ce fichier étant défini par le paramètre FNAME.

Ces deux méthodes sont exclusives : le paramètre PART et le paramètre FNAME ne peuvent être utilisés simultanément. Un partenaire désigné dans cette liste ne peut être lui-même une liste de diffusion : la récursivité est interdite. Les enregistrements créés dans le catalogue sont : •

d’une part, celui associé à la commande SEND ou RECV (vers ce “pseudo” partenaire),

•

d’autre part, ceux associés aux transferts vers chaque partenaire de la liste.

Lors de la génération d’un poste catalogue, le nombre de postes disponibles de ce catalogue n’est pas contrôlé par rapport au nombre total de partenaires de la liste. Suite à un transfert correct vers un partenaire, l’enregistrement associé (dans le catalogue) passe à l’état T. A la fin CORRECTE de TOUS les transferts correspondant à chacun des partenaires décrits dans cette liste, l’enregistrement associé au SEND ou RECV passe alors à l’état T. Une procédure de fin de transfert peut alors être exécutée, si elle a été définie : •

dans le paramètre EXEC du SEND ou du RECV initiateur du transfert,

•

ou (si ce paramètre EXEC n’est pas renseigné) dans le paramètre EXECSF (si diffusion) ou EXECRF (si collecte) de la commande CFTPARM associée.

Le paramètre EXEC de la commande CFTDEST indique le mode de soumission de la procédure : •

lorsque tous les transferts sont terminés (valeur par défaut),

•

à la fin de chaque transfert et aussi lorsque tous les transferts sont terminés.

Si un incident lors d’un transfert correspondant à un des partenaires de cette liste se produit, la procédure traitant les incidents de transfert (paramètre EXECSE ou EXECRE de CFTPARM) est alors exécutée. L’enregistrement associé à ce transfert prend l’état correspondant à celui de l’incident. L’enregistrement associé au SEND ou RECV reste, dans ce cas (au moins un transfert en incident), à l’état K.

6-10

CFT V2.3

Manuel de référence

Pour les mécanismes utilisés, consultez le paragraphe “Diffusion et collecte” ainsi que l’annexe “Diffusion et commutation” dans le guide “Concepts” de CFT. Le nombre maximal de commandes CFTDEST gérées est de 200.

6.2.1. Syntaxe CFTDEST [MODE [EXEC ID PART [FOR

= = = = =

{REPLACE | CREATE | DELETE},] {DEST | PART},] identifier, (identifier, identifier, ...), {BOTH | COMMUT | LOCAL}]

[MODE [EXEC ID FNAME [FOR

= = = = =

{REPLACE | CREATE | DELETE},] {DEST | PART},] identifier, filename, {BOTH | COMMUT | LOCAL}]

CFTDEST

6.2.2. Paramètres [EXEC = {DEST | PART}] Mode de soumission d’une procédure de fin de transfert : •

DEST : la procédure de fin de transfert est soumise lorsque tous les transferts sont terminés. La substitution des variables symboliques s’effectue par rapport à l’enregistrement générique. Par exemple, la variable &PART est substituée par l’identifiant de la commande CFTDEST,

•

PART : une procédure de fin de transfert est soumise pour chaque transfert terminé. La substitution s’effectue à partir de l’enregistrement courant. Par exemple, la variable &PART est substituée par l’identifiant du partenaire de transfert. Lorsque tous les transferts sont terminés, une procédure de fin de transfert est aussi soumise. La substitution s’effectue alors à partir de l’enregistrement générique. Par exemple, la variable &PART est substituée par l’identifiant de la commande CFTDEST.

FNAME = filename Nom du fichier dans lequel est renseignée la liste des identifiants des différents partenaires (correspondants chacun à une valeur du paramètre ID d’une commande CFTPART). Le nombre d’identifiants composant cette liste n’est pas limité. L’existence de chaque partenaire est contrôlé au moment du transfert. L’absence de définition d’un partenaire n’empêchera pas la diffusion ou la collecte vers les partenaires définis ; seuls les partenaires non décrits ne seront pas servis.

CFT V2.3

6-11

Les commandes de paramétrage des partenaires

Pour constituer ce fichier, les règles suivantes doivent être suivies : •

un enregistrement de ce fichier ne peut contenir qu’un seul identifiant de partenaire,

•

la taille d’un enregistrement est limitée à 80 caractères,

•

un identifiant de partenaire doit débuter en première colonne et seuls les 8 premiers caractères de l’enregistrement sont pris en compte,

•

les caractères au-delà de la colonne 8 sont ignorés et considérés comme un commentaire,

•

un identifiant peut être indifféremment saisi en caractères majuscules ou minuscules (il est transformé en majuscules),

•

le fichier peut contenir des enregistrements de longueur nulle. Exemple de fichier : Identifiant correspondant 1---5--8--10-------20 (Colonnes) part_a Ceci est un commentaire PART 1 PART2 PARTENAIRE

’PART_A’ ’PART 1’ ’ PART2’ ’PARTENAI’

Le moniteur ne contrôle pas les autorisations d’accès du demandeur du transfert vis-àvis de ce fichier. Si FOR=COMMUT (diffusion par un site intermédiaire) : la variable symbolique &SPART (identifiant réseau du partenaire émetteur) peut être utilisée dans la constitution du nom du fichier (valeur du paramètre FNAME). Ceci permet de distinguer les listes définies pour les différents sites origine. Les variables symboliques utilisables sont les suivantes : •

&FDATE, &FTIME, &FYEAR, &FMONTH, &FDAY,

•

&PART, &RPART, &SPART, &NPART, &GROUP,

•

&SUSER, &RUSER,

•

&SAPPL, &RAPPL,

•

&IDF, &PARM, &IDA,

•

&NIDF,

•

&NFNAME, &NFVER.

[FOR = {BOTH | COMMUT | LOCAL}] Contrôle de l’exploitation de la liste des partenaires. La valeur renseignée peut être :

6-12

•

LOCAL : la liste des partenaires est exploitée en local pour la diffusion (émission) ou la collecte (réception) du fichier (ou du message) concerné,

•

COMMUT : le moniteur CFT local assure la diffusion en tant que site intermédiaire.

CFT V2.3

Manuel de référence

Ce moniteur reçoit un fichier (ou un message) avec comme nom réseau de destinataire la valeur de l’identifiant de cette commande CFTDEST (il n’existe pas de partenaire identifié par le nom réseau reçu). Ce fichier (ou ce message) sera alors diffusé vers les partenaires de cette liste de diffusion ainsi définie, •

ID

BOTH : regroupe les fonctionnalités de LOCAL et COMMUT c’est-à-dire : -

en émission : diffusion des fichiers (ou des messages) originaires de son site et des sites distants dont il est le site intermédiaire,

-

en réception : collecte de fichiers (ou de messages).

= identifier Identifiant de la liste de partenaires. Cet identifiant doit être unique. Il n’est pas possible de spécifier plusieurs commandes CFTDEST avec le même ID.

PART = (identifier, identifier, ...) Liste explicite des identifiants des différents partenaires (correspondants chacun à une valeur du paramètre ID d’une commande CFTPART). Le nombre maximum d’identifiants composant cette liste est limité à 200. L’absence de définition d’un partenaire (CFTPART) interdit tout transfert (diffusion ou collecte).

6.3 CFTXXX - Définitio n réseau des partenaires Les commandes de type CFTxxx permettent, chacune pour un type de réseau donné, de définir les paramètres réseau des partenaires : •

localisation réseau du moniteur partenaire sur la machine hôte. Rappelons que les informations complémentaires concernant le SAP (Service Access Point) sont précisées dans la commande CFTPART associée,

•

les plages horaires d’appels par ce réseau,

•

les mécanismes de répétition des tentatives de connexion (RETRY),

•

le nombre limite de connexions simultanées avec ce partenaire, dans chaque sens.

Le présent paragraphe décrit les paramètres communs à toutes les commandes spécifiques suivantes. Leur description n’est donc par reprise par la suite.

CFT V2.3

6-13

Les commandes de paramétrage des partenaires

6.3.1. Syntaxe CFTxxx [MODE ID

= {REPLACE | CREATE | DELETE},] = identifier,

[IMINTIME [IMAXTIME [OMINTIME [OMAXTIME

= = = =

[RETRYM [RETRYN [RETRYW

= {12 | n},] = {6 | n},] = {7 | n},]

{00000000 | time},] {23595999 | time},] {00000000 | time},] {23595999 | time},]

[CNXOUT = {2 | n},] [CNXIN = {2 | n},] [CNXINOUT = {2 | n},] ... Définition suivant le type réseau.

6.3.2. Paramètres [CNXIN = {2 | n}] {0..voir le tableau} Nombre maximum de sessions attribuées à ce partenaire, pour les connexions entrantes (mode serveur). La valeur maximale supportée pour chaque système est indiquée dans le commentaire du paramètre CNXINOUT, sous forme de tableau. [CNXINOUT = {2 | n}] {0..voir le tableau} Nombre maximum de sessions pour les communications sur cette ressource réseau avec ce partenaire. Le tableau suivant indique la valeur maximale supportée pour chaque système. Tableau 68. CFTXXX CNXINOUT - Nombre maximum de sessions

6-14

OS

Maximum supporté

GCOS7 GCOS7 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE WinNT

32 90 20 240 32 48 16 32 200 16 16

CFT V2.3

Manuel de référence

[CNXOUT = {2 | n}] {0..voir le tableau} Nombre maximum de sessions pour les connexions sortantes avec ce partenaire (mode demandeur). La valeur maximale supportée pour chaque système est indiquée dans le commentaire du paramètre CNXINOUT, sous forme de tableau. Les paramètres CNXIN, CNXOUT et CNXINOUT sont indépendants entre eux. Dans le cas de DMZ, ce paramètre doit être initialisé à zéro au départ (voir, dans le "Guide des protocoles" CFT, le paragraphe "Gestion du tour de parole"). ID

= identifier Nom identifiant le partenaire. Cette valeur fait référence à une description de partenaire (CFTPART ID = ...). Lorsque ID prend la valeur du paramètre DEFAULT de CFTPARM, la commande décrit la configuration réseau par défaut d’un partenaire appelant (fonctionnement en mode SERVEUR donc si le partenaire est uniquement DEMANDEUR). Dans ce cas, les paramètres spécifiques à un partenaire et les paramètres propres aux appels sortants (DIALNO, CNXOUT, RETRY*, O*TIME) sont sans objet.

[IMAXTIME = {23595999 | time}] Heure maximale après laquelle le partenaire ne pourra appeler sur ce type de réseau. [IMINTIME = {00000000 | time}] Heure minimum avant laquelle le partenaire ne peut appeler sur ce type de réseau. IMINTIME, IMAXTIME représentent donc la plage horaire autorisée pour les appels venant de ce partenaire sur ce type de réseau. [OMAXTIME = {23595999 | time}] Heure maximale après laquelle le partenaire ne peut plus être appelé sur ce type de réseau. [OMINTIME = {00000000 | time}] Heure minimum avant laquelle le partenaire ne peut être appelé sur ce type de réseau. OMINTIME, OMAXTIME représentent donc la plage horaire permise pour appeler ce partenaire sur ce type de réseau. [RETRYM = {12 | n}] {0..32767} Nombre maximum de tentatives de reconnexions. Si ce paramètre est égal à 0 et si la connexion initiale échoue, il n’y a pas de tentative de reconnexion. [RETRYN = {6 | n}] {0..32767} Correspond au nombre de tentatives de reconnexions espacées du temps RETRYW. Lorsque RETRYN tentatives seront effectuées sans succès, CFT divise RETRYN par deux et multiplie RETRYW par deux puis recommence la séquence à concurrence du nombre total prévu (RETRYM).

CFT V2.3

6-15

Les commandes de paramétrage des partenaires

[RETRYW = {7 | n}] {0..32767} Espacement des tentatives de reconnexions (exprimé en minutes). Exemple : RETRYW = 01, RETRYN = 08, RETRYM = 20 signifient : •

huit tentatives espacées d’une minute,

•

quatre tentatives espacées de deux minutes,

•

deux tentatives espacées de quatre minutes,

•

une tentative espacée de huit minutes,

•

cinq tentatives espacées de seize minutes.

6.3.3. CFTDNA - Paramètres réseau d’un partenaire DNA (VAX) VMS

La commande CFTDNA permet de définir les paramètres réseau associés à un partenaire pour une connexion Decnet. Il ne peut y avoir qu’une seule commande CFTDNA par partenaire. Seuls les paramètres spécifiques à la commande CFTDNA sont détaillés. La liste exhaustive des paramètres licites est néanmoins donnée ci-après, les paramètres communs étant rappelés en début de liste.

6.3.3.1. Syntaxe CFTDNA [MODE ID [IMINTIME [IMAXTIME [OMINTIME [OMAXTIME [RETRYM [RETRYN [RETRYW [CNXOUT [CNXIN [CNXINOUT NODE

= = = = = = = = = = = = =

{REPLACE | CREATE | DELETE},] identifier, {00000000 | time},] {23595999 | time},] {00000000 | time},] {23595999 | time},] {12 | n},] {6 | n},] {7 | n},] {2 | n},] {2 | n},] {2 | n},] string

6.3.3.2. Paramètre NODE = string6 Identifiant Decnet de la machine distante (Nom de nœud Decnet).

6-16

CFT V2.3

Manuel de référence

6.3.3.3. Exemple CFTDNA

MODE = CREATE, /* point d’accès Decnet ID = PARIS5, /* au partenaire PARIS5 RETRYM = 6, /* les paramètres de RETRYN = 4, /* tentatives de reconnexion RETRYW = 2, NODE = PARIS5 Le partenaire PARIS5 est accessible par réseau Decnet. Il est connu comme nœud Decnet PARIS5.

*/ */ */ */

6.3.4. CFTDSA - Paramètres réseau d’un partenaire DSA (BULL) GCOS7 GCOS8

La fonction CFTDSA permet de définir les paramètres réseau associés à un partenaire pour une connexion DSA. Il ne peut y avoir qu’une seule commande CFTDSA par partenaire. Seuls les paramètres spécifiques à la commande CFTDSA sont détaillés. La liste exhaustive des paramètres licites est néanmoins donnée ci-après, les paramètres communs étant rappelés en début de liste. En mode DELETE, les paramètres suivants doivent être renseignés : •

le paramètre ID,

•

mais également le paramètre CLASS (si cette valeur est différente de la valeur par défaut 1).

Ces deux paramètres identifient en effet de manière unique un accès DSA.

6.3.4.1. Syntaxe CFTDSA

CFT V2.3

[MODE ID [IMINTIME [IMAXTIME [OMINTIME [OMAXTIME [RETRYM [RETRYN [RETRYW [CNXOUT [CNXIN [CNXINOUT [CLASS NODE

= = = = = = = = = = = = = =

{REPLACE | CREATE | DELETE},] identifier, {00000000 | time},] {23595999 | time},] {00000000 | time},] {23595999 | time},] {12 | n},] {6 | n},] {7 | n},] {2 | n},] {2 | n},] {2 | n},] {1 | n},] (string, string, ...),

SBMID

= string,

OS

SBMPROJ

= string,

OS

PIDNODE

= string

OS

6-17

Les commandes de paramétrage des partenaires

6.3.4.2. Paramètres [CLASS = {1 | n}] Classe de ressource DSA. NODE = (string4, string4, ...) Adresses réseau DSA du partenaire appelé, constituées du nom de “session control” (SCID) (4 caractères). Cette valeur doit être identique à celle configurée dans la génération réseau (SCID) de ce partenaire et dans le paramètre TSAP de la commande CFTNET TYPE = DSA correspondante. Un partenaire peut correspondre à plusieurs “noeuds” DSA, qui seront adressés successivement en cas d’échec de connexion avec les précédents. Le nombre maximum de noeuds possibles est de 4. SBMID

= string

GCOS7

Permet le contrôle d’identification du “submitter ID”. GCOS7

SBMPROJ

Ce paramètre est facultatif. Lors des appels sortants DSA, si ce paramètre n’est pas renseigné, la lettre de connexion DSA transporte l’“ID” du “submitter” de CFT pour l’exécution en cours.

= string

GCOS7

Permet le contrôle d’identification du “submitter project”. GCOS7

Ce paramètre est facultatif. Lors des appels sortants DSA, si ce paramètre n’est pas renseigné, la lettre de connexion DSA transporte le “Project” du “submitter” de CFT pour l’exécution en cours.

Les notions de “submitter ID” et “submitter project” sont prises en compte lors des demandes de connexion sortantes (il n’y a pas ici l’équivalent du paramètre VERIFY de la commande CFTX25). Ce sont des informations transportées dans les lettres de connexion DSA et vérifiées par GCOS7, lors des demandes de connexion entrantes : contrôle d’accès défini dans le fichier de configuration réseau.

6.3.4.3. Exemple CFTDSA

6-18

MODE ID IMINTIME OMINTIME CNXOUT CNXIN CNXINOUT NODE PIDNODE

= = = = = = = = =

CREATE, PARIS5, 2200, 2200, 3, 3, 5, PARI, HT02

/* /* /* /* /* /* /* /*

Point d’accès DSA au partenaire PARIS5 Peut appeler et être appelé de 22 à 24 heures Autorise 3 appels sortants 3 appels entrants mais 5 sessions au total Noeud DSA

*/ */ */ */ */ */ */ */

CFT V2.3

Manuel de référence

Le partenaire PARIS5 est connu comme noeud DSA. Pas de classe précisée, c’est donc une ressource de classe 1 (valeur par défaut) qui sera choisie pour les appels de ce partenaire. Les relances seront tentées avec l’algorithme défini par les valeurs par défaut, soit : •

6 tentatives espacées de 7 minutes,

•

3 tentatives espacées de 14 minutes,

•

2 tentatives espacées de 28 minutes,

•

1 tentative espacée après 56 minutes.

GCOS7

Aucun contrôle relatif aux “submitter ID” et “submitter project” ne sera effectué par le noeud DSA au moment de la connexion (paramètres SBMID et SBMPROJ absents).

6.3.5. CFTSNA - Paramètres réseau d’un partenaire SNA MVS

OS400

VM VMS VSE VOS

La commande CFTSNA permet de définir les paramètres réseau associés à un partenaire pour les communications sur réseau SNA. Seuls les paramètres spécifiques à la commande CFTSNA sont détaillés. La liste exhaustive des paramètres licites est néanmoins donnée ci-après. Plusieurs sessions peuvent être ouvertes avec le partenaire. Pour communiquer entre les moniteurs CFTV2 et CFT/370 version 1, la version minimum du moniteur CFT/370 version 1 est le niveau 160. En mode DELETE, les paramètres suivants doivent être renseignés : •

le paramètre ID,

•

mais également le paramètre CLASS (si sa valeur est différente de la valeur par défaut 1).

Ces deux paramètres identifient en effet de manière unique un accès SNA. MVS

VM

VSE

La commande CFTSNA permet également de définir les paramètres réseau de CFT V2, associés à un partenaire pour les communications sur réseau X25, à travers la fonction PCNE de X25/NPSI.

6.3.5.1. Syntaxe générale CFTSNA [MODE ID [IMINTIME [IMAXTIME [OMINTIME [OMAXTIME [RETRYM [RETRYN [RETRYW [CNXOUT [CNXIN

CFT V2.3

= = = = = = = = = = =

{REPLACE | CREATE | DELETE},] identifier, {00000000 | time},] {23595999 | time},] {00000000 | time},] {23595999 | time},] {12 | n},] {6 | n},] {7 | n},] {2 | n},] {2 | n},]

6-19

Les commandes de paramétrage des partenaires

[CNXINOUT [CLASS

= {2 | n},] = n,]

LUNAME

= string,

OS

= (string,string...),

OS

= string,]

OS

[LOGMODE

Le paramètre CLASS est utilisé sur tous les systèmes. Par contre, l’emploi et la signification des autres paramètres spécifiques à CFTSNA dépendent du système utilisé. Le tableau suivant décrit l’emploi de ces paramètres par système. Tableau 69. CFTSNA LUNAME/LOGMODE - Emploi des paramètres OS

LUNAME

LOGMODE

DATA

MVS OS400 VM VMS VOS VSE

OUI OUI OUI OUI OUI OUI

(OUI) (OUI) (OUI) (OUI)

(OUI)

(OUI)

Explications sur le contenu du tableau : • les paramètres obligatoires sont indiqués par OUI, • les paramètres facultatifs sont indiqués par (OUI), • sans précision, le paramètre est sans objet pour le système concerné. Pour plus de clarté, les commentaires décrivant ces paramètres et les exemples associés ont été regroupés en deux parties concernant : •

les paramètres utilisés côté Host (systèmes MVS et VM),

•

les paramètres utilisés côté PU T2 (systèmes OS400 et VMS).

6.3.5.2. Paramétrage côté HOST MVS

VM

VSE

[CLASS = n] {2..32} Classe de la (ou des) ressource(s) locale(s) SNA permettant d’établir la liaison avec le partenaire. Cette valeur de classe est définie dans la commande CFTNET correspondant à la méthode d’accès réseau utilisée pour communiquer avec le partenaire. Ce paramètre sera exploité lors d’une demande de connexion sortante, pour sélectionner ce CFTSNA à partir du protocole imposé par CFTPART (ce mécanisme permettant d’associer plusieurs CFTSNA à un CFTPART).

6-20

CFT V2.3

Manuel de référence

[LOGMODE = string0..8] Nom d’une ‘LOGMODE’ définie à VTAM et fournie avec le moniteur CFT. Si LOGMODE n’est pas renseigné, la “logmode” doit être définie dans la description de la LU à VTAM (paramètre DLOGMOD). Il est recommandé de préciser un nom de LOGMODE basé sur les exemples fournis avec la procédure d’installation de CFT. La “logmode” par défaut ne permet pas, en règle générale, d’établir une session CFT. Les ‘LOGMODE’ fournies avec le moniteur CFT sont les suivantes : •

CFT2LOG,

•

CFT2SNA,

•

CFT2BSC,

•

CFT2AS40,

•

CFT2EXT,

•

CFT2PCN,

• CFT2LISA. Ces ‘LOGMODE’ peuvent être utilisées pour les transferts entre deux moniteurs CFT, quel que soit le protocole de transfert utilisé, avec pour valeur : •

cas général : CFT2LOG,

•

cas particuliers : –

transferts vers CFT/PC 3270 avec un contrôleur type SNA : CFT2SNA,

–

transferts vers CFT/PC 3270 avec un contrôleur type BSC : CFT2BSC,

– transferts vers CFT/OS 400 sur un réseau SNA : CFT2AS40. Pour les transferts en PeSIT profil Extern entre un moniteur CFT et un autre moniteur sur un réseau SNA : CFT2EXT. Pour les transferts sur X25/NPSI utilisé en mode PCNE : •

dans le cas général : CFT2PCN,

•

en ESPAGNE : CFT2LISA.

LUNAME = {string36 | mask} Nom explicite (string) de la LU correspondant à ce partenaire ou nom générique de LU (mask). Les noms génériques seront utilisés pour se connecter à des systèmes n’acceptant pas de sessions parallèles sur une LU. Ces valeurs comportent des “*” pour désigner une suite de noms de LU. Syntaxe : * ou ** * La liste des LU, de x à 9 ** La liste des LU, de xx à 99 Une “*” permet de faire varier le dernier caractère du nom de LU (luname) parmi les lettres “A” a “Z”, puis les chiffres de “0” a “9” (au maximum 36 possibilités).

CFT V2.3

6-21

Les commandes de paramétrage des partenaires

Deux “**” permettent de faire varier les deux derniers caractères du nom de LU (luname) parmi les lettres “A” à “Z”, puis les chiffres de “0” à “9”. Le caractère de droite varie en premier (au maximum 1296 possibilités, il est déconseillé de permettre un nombre si important). L’exploration est terminée dès que le nom généré est inconnu de VTAM. Exemple : LU = LU05* Désigne les LU nommées LU05 à LU09. LU = LU0X8** Désigne les LU nommées LU0X8 a LU0X9. puis LU0Y8 a LU0Y9. . . . jusqu’à LU098 a LU099, soit 24 possibilités.

6.3.5.3. Exemple CFTSNA

MODE = CREATE, /* Point d’accès SNA au */ ID = PARIS5, /* partenaire PARIS5 */ LUNAME = CFTPAR1*, /* Nom des LU */ LOGMODE = CFT2LOG, /* LOGMODE */ CLASS = 11, IMINTIME = 2200, /* Peut appeler et être appelé*/ OMINTIME = 2200, /* de 22 à 24 heures */ CNXOUT = 3, /* Autorise 3 appels sortants */ CNXIN = 3, /* 3 appels entrants */ CNXINOUT = 5 /* mais 5 sessions au total */ Cette commande définit le mode d’accès SNA au partenaire PARIS5. Le CFT distant peut être adressé par les LU “CFTPAR1” à “CFTPAR9”, et la connexion se fera selon la LOGMODE “CFT2LOG”.

6.3.5.4. Paramétrage côté PU T2 OS400

VMS

VOS

[CLASS = {1 | n}] Classe de la (ou des) ressource(s) locale(s) SNA permettant d’établir la liaison avec le partenaire. Cette valeur de classe est définie dans la commande CFTNET correspondant à la méthode d’accès réseau utilisée pour communiquer avec le partenaire. Ce paramètre sera exploité lors d’une demande de connexion sortante, pour sélectionner ce CFTSNA à partir du protocole imposé par CFTPART (ce mécanisme permettant d’associer plusieurs CFTSNA à un CFTPART).

6-22

CFT V2.3

Manuel de référence

[LOGMODE = string8] Chaîne de caractères représentant une ‘LOGMODE’ utilisée sur le host partenaire (définie dans VTAM). Identifie l’entrée dans le “Logtable” sur le “host”, en précisant les caractéristiques de la session. En général, ce paramètre n’est pas à renseigner, côté PU T2. En effet, le nom de la ‘LOGMODE’ associé à une LU est en pratique défini côté host (DLOGMOD dans VTAM). LUNAME = string15 Chaîne de caractères représentant le nom de la LU applicative (ACB) sur le host distant (nom APPL). OS400

VOS

C’est le logon APPLID envoyé par l’AS/400 pour établir une session LU0 avec le Host. C’est le nom d’un secondary session descriptor qui identifie une LU0 ou un pool de LU0.

6.3.5.5. Exemples CFTSNA

MODE = REPLACE, ID = HOST, LUNAME = OUT_PUDHOST_OB, CLASS = 1, CNXOUT = 3, CNXIN = 5, CNXINOUT = 8 Cette commande définit le mode d’accès SNA LU0 au partenaire HOST. Le secondary session descriptor décrit un pool de 3 LU0, permettant 3 sessions simultanées en sortie vers ce partenaire. 5 transferts en entrées simultanées sont également possibles avec ce partenaire. CFTSNA

ID = PART1, /* partenaire PART1 */ CLASS = 2, LUNAME = xxxxx, LOGMODE = CFT2LOG Cette commande définit le mode d’accès SNA LU0 au partenaire PARIS5. Le nom de la logmode est celui défini au niveau du host 370. CFTSNA

CFT V2.3

MODE ID LUNAME CLASS IMINTIME OMINTIME CNXOUT CNXIN CNXINOUT

= = = = = = = = =

CREATE, PARIS5, CFT, 1, 2200, 2200, 1, 1, 1

/* Point d’accès SNA au /* partenaire PARIS5 /* Nom d’ACB du CFT distant

*/ */ */

/* /* /* /* /*

*/ */ */ */ */

Peut appeler et être appelé de 22 à 24 heures Autorise 1 appel sortant 1 appel entrant 1 seule session SNA

6-23

Les commandes de paramétrage des partenaires

Cette commande définit le mode d’accès SNA LU2 au partenaire PARIS5. Le moniteur CFT distant est adressé par un nom d’ACB. Une seule session simultanée est possible. Rappel des différences de paramétrage concernant LU2 et LU0 : Pour LU2 : CFTSNA ID CLASS LUNAME DATA ....

= = = =

..., x, ...., .....,

Pour LU0 : CFTSNA ID CLASS LUNAME DATA LOGMODE ....

= = = = =

..., y, ...., ....., .....,

OS400

CFTSNA

MODE = CREATE, /* Point d’accès SNA au */ ID = PARIS5, /* partenaire PARIS5 */ LUNAME = CFTREF, /* Nom APPL distant */ LOGMODE = CFT400, /* Entree dans la MODETAB */ CLASS = 1, IMINTIME = 2200, /* Peut appeler et être appelé */ OMINTIME = 2200, /* de 22 à 24 heures */ CNXOUT = 3, /* Autorise 3 appels sortants */ CNXIN = 3, /* 3 appels entrants */ CNXINOUT = 5 /* mais 5 sessions au total */ Cette commande définit le mode d’accès SNA au partenaire PARIS5. Le CFT distant est adressé par un nom de LU applicative, et la connexion se fera selon le mode “CFT400” qui correspond, dans la définition de la MODETAB, à une LU0. Cinq sessions simultanées sont possibles. VMS

CFTSNA

6-24

MODE ID LUNAME LOGMODE CLASS IMINTIME OMINTIME CNXOUT CNXIN CNXINOUT

= = = = = = = = = =

CREATE, PARIS5, CFT, CFTVAX, 1, 2200, 2200, 3, 3, 5

/* /* /* /*

Point d’accès SNA au partenaire PARIS5 Nom APPL distant Entree dans LOGTABLE

*/ */ */ */

/* /* /* /* /*

Peut appeler et être appelé */ de 22 à 24 heures */ Autorise 3 appels sortants */ 3 appels entrants */ mais 5 sessions au total */

CFT V2.3

Manuel de référence

Cette commande définit le mode d’accès SNA au partenaire PARIS5. Le CFT distant est adressé par un nom de LU applicative, et la connexion se fera selon le mode “CFTVAX”, qui correspond, dans la définition de la LOGTABLE, à une LU0. Cinq sessions simultanées sont possibles.

6.3.6. CFTTCP - Paramètres réseau d’un partenaire TCP/IP

GCOS7

GCOS8

GUARDIAN

MVS

OS400

UNIX

VMS

WinNT

La commande CFTTCP permet de définir les paramètres réseau associés à un partenaire pour une connexion TCP/IP. Il ne peut y avoir qu’une commande CFTTCP par partenaire. Seuls les paramètres spécifiques à la commande CFTTCP sont détaillés. La liste exhaustive des paramètres licites est néanmoins donnée ci-après.

6.3.6.1. Syntaxe CFTTCP [MODE ID [IMINTIME [IMAXTIME [OMINTIME [OMAXTIME [RETRYM [RETRYN [RETRYW [CNXOUT [CNXIN [CNXINOUT HOST

= = = = = = = = = = = = =

{REPLACE | CREATE | DELETE},] identifier, {00000000 | time},] {23595999 | time},] {00000000 | time},] {23595999 | time},] {12 | n},] {6 | n},] {7 | n},] {2 | n},] {2 | n},] {2 | n},] (string, string, …)

6.3.6.2. Paramètres HOST

= string32

HOST = (string64, string64, …) Adresse IP ou liste d’adresses IP du correspondant avec lequel l’utilisateur désire entrer en session. Le nombre maximum d’adresses de cette liste est de 4. Cette adresse (exprimée sous forme de chaîne de caractères) peut être renseignée, soit :

CFT V2.3

•

avec l’adresse réelle IP en “notation point” (par exemple : 192.9.200.10),

•

avec le nom logique HOSTNAME associé à l’adresse réelle IP et configuré dans le fichier “base de données” correspondant (HOST), fourni avec tout package TCP/IP.

6-25

Les commandes de paramétrage des partenaires

6.3.6.3. Exemple CFTTCP

MODE = CREATE, /* point d’accès TCP */ ID = PARIS5, /* au partenaire PARIS5 */ HOST = SUN3, RETRYM = 6, /* les paramètres de */ RETRYN = 4, /* tentatives de reconnexion */ RETRYW = 2 Le partenaire PARIS5 a une adresse TCP/IP correspondant au mnémonique SUN3. Les tentatives de connexion (relances) s’espaceront dans le temps selon l’algorithme suivant : •

4 tentatives espacées de 2 minutes,

•

2 tentatives espacées de 4 minutes.

6.3.7. CFTX25 - Paramètres réseaux d’un partenaire X25 Cette commande est utilisable sur TOUS les systèmes. La commande CFTX25 permet de définir les paramètres réseau associés à un partenaire pour une liaison sur X25 public ou X25 privé. Il peut y avoir plusieurs commandes CFTX25 par partenaire, mais une seule commande pour un partenaire et une classe donnée. En mode DELETE, les paramètres suivants doivent être renseignés : •

le paramètre ID,

•

mais également le paramètre CLASS (si sa valeur est différente de la valeur par défaut 1).

Ces deux paramètres identifient en effet de manière unique un accès X25. MVS

VSE

VM

CFT/MVS utilise la fonction GATE de X25/NPSI pour communiquer avec des partenaires X25. CFT/MVS permet également la communication avec des partenaires X25, avec une définition de réseau de type CFTSNA, s’appuyant sur la fonction PCNE de X25/NPSI.

Seuls les paramètres spécifiques à la commande CFTX25 sont détaillés. La liste exhaustive des paramètres licites est néanmoins donnée ci-après.

6-26

CFT V2.3

Manuel de référence

6.3.7.1. Syntaxe CFTX25 [MODE ID [IMINTIME [IMAXTIME [OMINTIME [OMAXTIME [RETRYM [RETRYN [RETRYW [CNXOUT [CNXIN [CNXINOUT [CLASS DIALNO [PCVI [PCVO [SPEED [GFA [FACILITY [DATA [VERIFY

= = = = = = = = = = = = = = = = = = = = =

{REPLACE | CREATE | DELETE},] identifier, {00000000 | time},] {23595999 | time},] {00000000 | time},] {23595999 | time},] {12 | n},] {6 | n},] {7 | n},] {2 | n},] {2 | n},] {2 | n},] {1 | n},] (n, n, .....), {YES | NO},] {NO | YES},] n,] (n, n, .....),] string,] string,] {0 | n}]

6.3.7.2. Paramètres [CLASS = {1 | n}] {1..32) Classe de la (ou des) ressource(s) locale(s) X25 permettant d’établir la liaison avec le partenaire. Cette valeur de classe est définie dans la commande CFTNET correspondant à la méthode d’accès réseau utilisée pour communiquer avec le partenaire. Ce paramètre sera exploité lors d’une demande de connexion sortante, pour sélectionner ce CFTX25 à partir du protocole imposé par CFTPART (ce mécanisme permettant d’associer plusieurs CFTX25 à un CFTPART). Ce paramètre donne lieu à une simple vérification à la demande de connexion entrante. [DATA = string33] Données du paquet d’appel sortant. Ces données seront dans le champ “user data” du paquet d’appels. Attention : ce paramètre est utilisable uniquement si le paramètre SAP de la commande CFTPART est sous forme de sous-adresse. Il ne doit pas être renseigné si le paramètre SAP de la commande CFTPART est sous forme de “user data”. Dans ce cas, les “user data” sont renseignés par la valeur de ce paramètre SAP.

CFT V2.3

6-27

Les commandes de paramétrage des partenaires

DIALNO = (n, n, ...) Numéro ou liste de numéros d’appel X25 du correspondant avec lequel on désire entrer en session. Le nombre maximum de numéros de cette liste est de 4. Attention : si le SAP est attendu par le moniteur partenaire en sous-adresse, ce paramètre doit se limiter à l’adresse X25, et ne pas être étendu avec une sous-adresse. Dans ce cas, la sousadresse sera renseignée par la valeur du paramètre SAP de la commande CFTPART, pour le protocole choisi. [FACILITY = string64] Chaîne de caractères alphanumériques donnant la représentation hexadécimale du “champ facilités” X25. Ce champ est ajouté aux facilités déduites des paramètres SPEED, PCVI, PCVO et GFA. La cohérence de la valeur de ce paramètre par rapport à la norme X25 n’est pas contrôlée. La valeur de ce paramètre doit être enclose entre cotes (’). Exemple : FACILITY = ’420909430A0A’ Demande que : •

la taille des paquets soit 512 octets dans les 2 sens,

•

la fenêtre d’émission soit de 10 paquets dans les 2 sens.

[GFA = (n, n, ...)] Numéro ou liste de numéros de Groupes Fermés d’Abonnés. Un numéro de GFA est associé, par sa position dans la liste, à un numéro d’appel X25 (paramètre DIALNO de la même commande). Le nombre maximum de numéros de cette liste est de 4. [PCVI = {YES | NO}] Le partenaire peut appeler en PCV (PCVI=YES) : il peut alors demander la taxation à l’appelé. [PCVO = {NO | YES}] Le partenaire sera appelé en PCV (PCVO=YES) : la taxation lui sera affectée. [SPEED = n] Vitesse du circuit virtuel (exprimée en bits par secondes). Génère la facilité de “classe de débit”. Si ce paramètre n’est pas renseigné, la vitesse du circuit virtuel sera celle de l’abonnement ou de la ligne X25.

6-28

CFT V2.3

Manuel de référence

[VERIFY = {0 | n}] Option de vérification du numéro (DIALNO) du partenaire lors de la demande de connexion entrante (les “n” premiers chiffres du numéro appelant seront contrôlés). Cette option peut être activée lorsqu’en protocole PeSIT un partenaire demandeur impose à CFT un changement d’identifiant d’un transfert à l’autre, sur le même circuit virtuel.

PeSIT

Si VERIFY = 0, il n’y a pas de vérification.

6.3.7.3. Exemple CFTX25

MODE ID CLASS

= CREATE, = PARIS5, = 1,

/* /* /* /*

point d’accès X25 */ au partenaire PARIS5 */ CFT lui attribue une */ ressource de classe 1 pour les

*/ /*connexions sortantes */ DIALNO = 175999999, /* 1 No appel */ RETRYM = 6, /* les paramètres de */ RETRYN = 4, /* relances */ RETRYW = 2 Les nombres des circuits virtuels de type X25 pour ce partenaire sont les valeurs par défaut, soit 2 pour les appels entrants, 2 pour les appels sortants, limités au total à 2. Selon le type de SAP décrit dans la commande CFTPART : •

le numéro d’appel sera complété d’une sous-adresse et le champ “user data” ne sera pas renseigné (SAP sous forme de sous-adresse),

•

Le champ “user data” sera renseigné (SAP sous forme de “user data”). Les paramètres IMINTIME, IMAXTIME, OMINTIME et OMAXTIME ne sont pas renseignés. Il n’y a donc pas d’autre contrainte horaire pour les appels de type X25 que celles décrites éventuellement pour ce partenaire dans la commande CFTPART. Les valeurs par défaut des paramètres PCVI et PCVO sont affectées au partenaire, qui peut donc appeler le CFT local en PCV, mais que le CFT local ne peut pas appeler en PCV. Les tentatives de connexion (relances) s’espaceront dans le temps selon l’algorithme :

CFT V2.3

•

4 tentatives espacées de 2 minutes,

•

2 tentatives espacées de 4 minutes.

6-29

Les commandes de paramétrage des partenaires

6.3.8. CFTLU62 - Paramètres réseau d’un partenaire LU62 MVS

OS400

UNIX

VM

VSE

WinNT

La commande CFTLU62 permet de définir les paramètres réseau associés à un partenaire pour une connexion LU6.2. Seuls les paramètres spécifiques à la commande CFTLU62 sont détaillés. La liste exhaustive des paramètres licites est néanmoins donnée ci-après.

6.3.8.1. Syntaxe CFTLU62 ID [CLASS [CNXIN [CNXINOUT [CNXOUT [IMINTIME [IMAXTIME [OMINTIME [OMAXTIME [RETRYM [RETRYN [RETRYW [MODE

= = = = = = = = = = = = =

identifier, {1 | n},] {2 | n},] {2 | n},] {2 | n},] {0000000 | time},] {23595999 | time},] {0000000 | time},] {23595999 | time},] {12 | n},] {6 | n},] {7 | n},] {REPLACE | CREATE | DELETE},]

NETWKID

= string,

OS

CPNAME

= string,

OS

LUNAME TPNAME MODENAME

= string, = string, = string

6.3.8.2. Paramètres Les paramètres généraux autres que CLASS ne sont pas explicités ici. [CLASS = {1 | n}] {1.32} Classe associée à la ressource réseau. Cette notion permet de regrouper des ressources de même type, de manière à ce qu’elles soient utilisables indifféremment pour l’établissement de liaisons avec des partenaires (consultez le guide “Concepts” de CFT au paragraphe “Protocoles et ressources réseaux”). CPNAME

= string1..8

OS400

UNIX

Nom du contrôle point du noeud périphérique de type 2.1 dont dépend la LU distante. LUNAME = string1..8 Nom de la LU distante ou de l’alias.

6-30

CFT V2.3

Manuel de référence

MODENAME = string1..8 Nom du MODE. Le mode contient des paramètres décrivant les règles de gestion de la session (taille des données, sécurité, priorité, qualité de service). NETWKID

= string1..8

OS400

UNIX

Nom du réseau dont dépend la LU distante. TPNAME = string1..16 Nom de la transaction déclenchée sur le site distant.

6.3.8.3. Exemples Des exemples de paramétrage de la ressource LU6.2 pour les systèmes d’exploitation MVS, VM, VSE sont présentés ci-dessous : CFTLU62 id = mvs1 , class = 5 , modename = cft2appc, luname = cft2lu61 , cnxin = 2 , cnxinout = 4 , cnxout = 2 , mode = replace CFTLU62 id = mvs2 , class = 6 , luname = cft2lu62 , modename = cft2appc, cnxin = 2 , cnxinout = 4 , cnxout = 2 , mode = replace CFTLU62 id = risc1 , class = 6 , luname = luunix , tpname = cftcvin , modename = cft2appc, cnxin = 2 , cnxinout = 4 , cnxout = 2 , mode = replace CFTLU62 id = os2 , class = 6 , luname = luos2 , tpname = cft , modename = cft2appc , cnxin = 2 , cnxinout = 4 , cnxout = 2 , mode = replace

CFT V2.3

6-31

Les commandes de paramétrage des partenaires

CFTLU62

id luname class tpname modename cnxin cnxinout cnxout mode

= = = = = = = = =

as400 , luas400 , 6 , l62hdx.cftpgm , cft2appc , 2 , 4 , 2 , replace

6.3.9. CFTASY - Paramètres réseau d’un partenaire asynchrone WinNT

Cette commande décrit les caractéristiques du partenaire distant (si liaison RTC) ou l’adresse X25 ainsi que la numéro de PAD correspondant (si liaison par un PAD). Les commandes CFTASY et CFTNET peuvent avoir des paramètres communs. S’ils sont explicitement précisés ici, ils priment sur les paramètres indiqués dans la commande CFTNET.

6.3.9.1. Syntaxe CFTASY ID CLASS MODE DIALNO [PADNO [MODOUT [SPEED [PADSET [DATA [FACIL [CONFIG LINEID

= = = = = = = = = = = =

identifier, {1 | n}, {CREATE | REPLACE | DELETE}, string, string,] string,] {2400 | n},] string,] string,] string,] string,] string

6.3.9.2. Paramètres CLASS = {1 | n} {1..32} Classe associée à cette ressource réseau. [CONFIG = string1...64] Nom du fichier de configuration du modem. Ce fichier décrit les scénarios des phases de connexion et de déconnexion entre le PAD et le partenaire. Ce fichier de configuration, s’il est précisé, prévaut sur le fichier indiqué dans la commande CFTNET ou, à défaut, sur le fichier interne.

6-32

CFT V2.3

Manuel de référence

[DATA = string1...32] Chaîne de caractères représentant les données utilisateur émises dans les DATA de connexion. DIALNO = string Numéro du partenaire.

{1...32}

Ce numéro peut avoir les formes suivantes : •

pour une liaison synchrone de bout en bout,

•

pour une liaison à un partenaire X25 via un PAD.

[FACIL = string1...64] Chaîne de caractères alphanumériques donnant la représentation hexadécimale de “champ facilités” X25 (voir commande CFTX25, paramètre FACILITY). Ce paramètre n’a de signification que pour une liaison via un PAD. ID

= identifier {1...64} Identifiant de la ressource.

LINEID = string1 ..32 Identifiant de la ressource asynchrone caractérisant le port de communication (chaîne de caractères, “COM1” par exemple). [MODE = {CREATE | DELETE | REPLACE}] Action demandée. [MODOUT = string1...32] Chaîne d’initialisation du modem pour les connexions sortantes (mode demandeur). [PADNO = string1...32] Numéro de téléphone du PAD. Si ce paramètre est renseigné, le paramètre DIALNO contient l’adresse X25. Ce numéro peut être une chaîne de caractères alphanumériques comprenant : •

une chaîne de caractères précisant au modem le type de numérotation, impulsionnelle ou fréquentielle,

• un numéro de téléphone de PAD. Exemple : “ATDT36062424\013” Remarque : “\013” sert de délimiteur de fin de chaîne.

CFT V2.3

6-33

Les commandes de paramétrage des partenaires

[PADSET = string1...255] Chaîne d’initialisation du PAD. Ce paramètre est précisé uniquement si PADNO est rempli. Son format est le suivant : “1:val1,2:val2,.......,i:vali” où i est< ou = 22 et représente le paramètre i du PAD dont la valeur souhaitée est vali. La chaîne de caractère utilisée par défaut est la suivante : “SET 1:0,2:0,3:0,4:3,5:0,6:1,7:8,8:0,9:0,10:0,12:0,15:0”. Le fait d’envoyer cette chaîne d’initialisation au PAD TRANSPAC permet de l’exploiter en mode tempo, avec un tempo de 0,15 secondes. [SPEED = {2400 | n}] Vitesse de la transmission en bits/seconde.

6-34

CFT V2.3

7.

Les commandes associées aux transferts

7.1. Transferts

7.1.1. SEND TYPE = FILE - Emission de fichier La commande SEND TYPE = FILE permet de déclencher l’émission de fichier. Les caractéristiques du transfert peuvent être précisées dans la commande SEND elle-même ou bien dans la commande CFTSEND, dont l’ID est égal à la valeur du paramètre IDF. L’émission peut concerner un partenaire (émission simple) ou une liste de partenaires (diffusion). Le paramètre PART (identifiant du PARTenaire de transfert) de la commande SEND permet de référencer les caractéristiques du partenaire (définies dans la commande CFTPART) ou la liste de partenaires (définie dans la commande CFTDEST). Les relations entre la commande SEND et les commandes CFTSEND, CFTPART et CFTDEST sont indiquées dans l’annexe “Schémas de chaînage des commandes” du guide “Concepts” de CFT. Lors d’une émission d’un fichier, CFT crée un poste dans le catalogue. Ce poste (visualisable par la commande LISTCAT) est identifié de façon unique, pour un moniteur donné, par les valeurs des paramètres IDT (IDentifiant de Transfert) et PART. Les émissions effectuées lors d’une diffusion sont identifiées avec la même valeur d’IDT, mais avec des valeurs de PART différentes. Remarque : le moniteur CFT exploite, dans la mesure des possibilités du système d’exploitation hôte, les informations qu’il peut obtenir sur le fichier réel (à transmettre), au moment de l’activation du transfert (valeur par défaut des paramètres FTYPE, FORG, FLRECL, FRECFM).

7.1.1.1. Syntaxe SEND

CFT V2.3

IDF PART

= identifier, = identifier,

[APPCYCID [APPOBJID [FDATE [FNAMEABS [FTIME [IDA [NIDF [TRK [TYPE

= = = = = = = = =

identifier,], name,] date,] {YES | NO},] time,] identifier,] string,] {UNDEFINED | ALL | NO | SUMMARY},] FILE,]

7-1

Les commandes associées aux transferts

PARAMETRES FACULTATIFS COMMUNS A CFTSEND [COMMENT = string,] [CYCDATE = date,] [CYCTIME = time,] [CYCLE = {0 | n},] [EXEC = filename,] [EXECSUB = { LIST | FILE}] [EXIT = identifier,] [FACTION = {NONE | DELETE | ERASE},] VFM

[FACTION

= {NONE | DELETE | ERASE | ROTATE},]

[FBLKSIZE

= n,]

[FCODE

= {BINARY | ASCII | EBCDIC},]

[FDB

= filename,]

VFM

[FKEYLEN

= {0 | n},]

PROTOCOLE

[FKEYPOS

= {0 | n},]

PROTOCOLE

[FLRECL

= n,]

[FNAME

= filename,]

[FORG

= {SEQ | DIRECT | INDEXED},]

OS

[FRECFM

= {F | U | V},]

OS

[FSPACE

= n,]

[FTYPE

= c,]

OS

OS

OS

[MAXDATE = date,] [MAXTIME = {23595999 | time},] [MINDATE = {date système du jour | date},] [MINTIME = {00000000 | time},] PROTOCOLE

[NBLKSIZE

= n,]

[NCODE

= {BINARY | ASCII | EBCDIC},]

[NCOMP

= cpr,]

[NFNAME

= filename,]

PROTOCOLE

[NKEYLEN

= {0 | n},]

PROTOCOLE

[NKEYPOS

= {0 | n},]

PROTOCOLE

[NLRECL

= n,]

[NRECFM

= {F | U | V},]

OS

PROTOCOLE

7-2

PROTOCOLE

CFT V2.3

OS

Manuel de référence

[NSPACE

= n,]

PROTOCOLE

[NTYPE

= c,]

PROTOCOLE

[PARM

= string,]

[PRI

= {128 | n},]

[RAPPL

= string,]

PROTOCOLE

[RUSER

= string,]

PROTOCOLE

[SAPPL

= string,]

PROTOCOLE

[SELFNAME [SPART [STATE

= filename] = string,] = {DISP | HOLD | KEEP},]

[SUSER

= string,]

[TCYCLE [XLATE

= {DAY | MIN | MONTH},] = identifier,]

OS

PROTOCOLE

PROTOCOLE

7.1.1.2. Paramètres APPCYCID = identifier {1…250} Identifiant du cycle de traitement (ensemble d’occurrences de suivi concernant un seul transfert). Ce paramètre n'est utilisable qu'à partir de la version CFT V2.3.1. APPOBJID = name Nom de l’objet suivi.

{1…50}

Dans Sentinel, un objet suivi est un objet de base de données qui décrit des évènements applicatifs. Les valeurs possibles de ce paramètre sont : • XFB.Transfer : cet objet suivi décrit les transferts de messages et de fichiers, • XFB.Log : cet objet suivi décrit le contenu des fichiers de LOG de CFT. Ce paramètre n'est utilisable qu'à partir de la version CFT V2.3.1. [FDATE = date] Date associée au fichier lors du transfert.

PeSIT

ODETTE

Véhiculé par le protocole.

CFT V2.3

7-3

Les commandes associées aux transferts

[FNAMEABS = {YES | NO}] Fichier à version identifié par FNAME : •

sous forme relative “nom de fichier (numéro de version)”,

•

sous forme absolue “nom de fichier - identifiant système de numéro de version du fichier. Valeurs : •

YES : le nom absolu est stocké dans le catalogue CFT,

•

NO : le nom relatif est stocké dans le catalogue CFT et le nom absolu sera pris en compte au début du transfert.

VFM

Le paramètre FDB = doit être indiqué dans la commande. Le paramètre FNAME pointe sur le nom du fichier.

[FTIME = time] Heure associée au fichier lors du transfert.

PeSIT

ODETTE

Véhiculé par le protocole. ODETTE La valeur par défaut est calculée par rapport à l’identifiant de transfert local.

[IDA = identifier] Identifiant local du transfert attribué par l’utilisateur ou l’application utilisatrice. Cet identifiant peut être un critère de recherche du poste catalogue associé à ce transfert. Plusieurs postes catalogue peuvent être associés à un même IDA. IDF

= identifier Identifiant logique du “fichier type” à émettre. Les caractéristiques de ce “fichier type” sont décrites dans une commande CFTSEND (paramètres facultatifs communs), telle que l’identifiant de cette commande soit égal à la valeur de cet IDF : CFTSEND

ID = , IMPL = NO, . . . Si cette commande CFTSEND n’existe pas le moniteur exploite, pour le transfert demandé, les caractéristiques du “fichier type” par défaut décrites dans la commande CFTSEND ID = . Cet identifiant peut être un critère de recherche du poste catalogue associé à ce transfert (voir la commande LISTCAT).

7-4

CFT V2.3

Manuel de référence

Remarque : si la commande CFTSEND a été configurée pour pouvoir répondre à une demande de transfert issue du partenaire (émission implicite) : CFTSEND

ID = , IMPL = YES, . . . Il est nécessaire, pour pouvoir effectuer un SEND explicite en assurant la cohérence des transferts, de configurer une autre commande CFTSEND de même ID (égal à l’IDF de ce SEND) mais avec IMPL= NO. CFTSEND

NIDF

ID = IMPL = . . .

= string string28

Utilisable en mode demandeur-émetteur et serveur-émetteur (STATE = HOLD) PeSIT E CFT/CFT

string14

PeSIT E

string7

PeSIT D

string26

ODETTE

string28

, NO,

ETEBAC3

Identifiant “réseau” du fichier. Si ce paramètre est utilisé, il prime sur le paramètre NIDF de la commande CFTIDF correspondante. Par défaut (pas de paramètre NIDF, ni de commande CFTIDF correspondante), l’identifiant “réseau” est égal à l’identifiant local (NIDF = IDF). Remarque : en PeSIT E standard, le NIDF est transporté dans le PI 12 (14 caractères maximum). En PeSIT E entre 2 moniteurs CFT, si le NIDF a une longueur supérieure à 14 caractères, cet NIDF est transporté dans le PI 99 (28 caractères maximum), la valeur indiquée dans le PI 12 étant tronquée à 14 caractères.

CFT V2.3

7-5

Les commandes associées aux transferts

PART = identifier Identifiant du partenaire de transfert. Cet identifiant désigne soit : •

un partenaire décrit par la commande : CFTPART

•

ID

=

, ...

une liste de partenaires décrite par la commande : CFTDEST

ID PART

= =

, (identifier, identifier . . .)

[SPART = string8] Uniquement en mode demandeur Permet de forcer, lors d’un transfert, la dénomination “réseau” sous laquelle le moniteur CFT local va se présenter à son partenaire. Usuellement, la valeur de ce paramètre est égale à l’identifiant (paramètre ID) d’une commande CFTPART. Le NSPART envoyé sera celui défini dans cette commande. Dans ce cas, le NSPART envoyé peut avoir une longueur supérieure à 8 caractères. S’il n’existe pas une telle commande (CFTPART), le NSPART envoyé sera égal (par défaut) à la valeur du SPART. Sa longueur sera donc inférieure ou égale à 8 caractères. Ce mécanisme sera en particulier utilisé sur le site intermédiaire assurant la commutation RVA : lors de l’activation de la commande SEND vers le site destinataire, l’utilisation de ce paramètre SPART permet, en effet, de forcer le NSPART envoyé à celui de l’émetteur INITIAL du fichier. Exemple : les commandes CFTPART suivantes sont définies : CFTPART ID = ID_PART1, NSPART = PART1, NRPART = DISTANT, . . . CFTPART

ID = ID_PART2, NSPART = PART2, NRPART = DISTANT, . . . Suite à la commande : SEND IDF = PAYE, PART = ID_PART1, SPART = ID_PART2 le NSPART envoyé est égal au NSPART de la commande CFTPART ID = ID_PART2 soit : NSPART = PART2 .

7-6

CFT V2.3

Manuel de référence

[TRK = {UNDEFINED | ALL | NO | SUMMARY}] Spécification du niveau de détail que CFT fournit à Sentinel sur les transferts. CFT envoie les informations sur le transfert sous forme d'occurrences de suivi. Les valeurs possibles de ce paramétre sont : • NO :

le moniteur n'envoie jamais d'occurrences de suivi à Sentinel,

• ALL :

le moniteur envoie une occurrence de suivi à Sentinel pour chaque étape de chaque transfert,

• SUMMARY : le moniteur envoie une occurrence de suivi à Sentinel uniquement pour l'étape initiale et l'étape finale de chaque transfert, • UNDEFINED : les options de suivi sont définies dans le paramètre TRK de la commande CFTSEND. TRK n'est utilisable qu'à partir de la version CFT V2.3.1. [TYPE = FILE] Caractérise une demande d’émission de fichier. La valeur de ce paramètre étant par défaut FILE, celui-ci peut être omis lors de la constitution d’une commande SEND utilisée pour l’émission de fichiers. PARAMETRES FACULTATIFS COMMUNS A CFTSEND : voir la

commande CFTSEND.

7.1.1.3. Exemples SEND PART = CENTRE5, IDF = TEST, FDATE = 19931202, FTIME = 10 Emission du fichier d’IDF TEST pour le partenaire CENTRE5. La date véhiculée par protocole concernant ce fichier est le 2 décembre 1993, l’heure 10 Heures 00 minute 00 seconde 00 centième. SEND PART = CENTRE2, IDF = TEST, MINDATE = 19930101, MINTIME = 10, MAXDATE = 19930131, CYCDATE = 19930101, CYCTIME = 1030, CYCLE = 1, TCYCLE = DAY Emission du fichier d’IDF TEST pour le partenaire CENTRE2, tous les jours entre 10h00 et 10h30, pendant la période qui couvre tout le mois de JANVIER 1993.

7.1.2. SEND TYPE = MESSAGE - Emission de message PeSIT D profil CFT

PeSIT E

Cette commande n’est pertinente qu’en utilisant ces protocoles.

La commande SEND TYPE = MESSAGE permet de déclencher l’émission d’un message vers un partenaire désigné. La longueur maximum de ce message est de :

CFT V2.3

•

80 caractères en PeSIT D profil CFT,

•

512 caractères en PeSIT E.

7-7

Les commandes associées aux transferts

7.1.2.1. Syntaxe SEND IDM MSG PART TYPE [IDA

= = = = =

identifier, string, identifier, MESSAGE, identifier,]

FACULTATIFS COMMUNS A CFTSEND [RAPPL [SAPPL [RUSER [SUSER [EXEC [PRI [MINDATE [MAXDATE [MINTIME [MAXTIME [CYCDATE [CYCTIME [CYCLE [TCYCLE

= = = = = = = = = = = = = =

string,] string,] string,] string,] filename,] pri,] date,] date,] time,] time,] date,] time,] {0 | n},] {DAY | MIN | MONTH}]

7.1.2.2. Paramètres [IDA = identifier] Identifiant local du transfert attribué par l’utilisateur ou l’application utilisatrice. Cet identifiant peut être un critère de recherche du poste catalogue associé à ce transfert (voir la commande LISTCAT). Plusieurs postes catalogue peuvent être associés à un même IDA. IDM = identifier Identifiant de message. Cet identifiant ne correspond pas à un “modèle” défini par une commande CFTSEND, comme cela est le cas pour le paramètre IDF de la commande SEND TYPE = FILE. La valeur de cet identifiant est libre. Cet identifiant peut être un critère de recherche du poste catalogue associé à ce transfert. Plusieurs postes catalogues peuvent être associés à un même IDM. MSG

= string string80

PeSIT D profil CFT

string512

PeSIT E

Texte émis vers le partenaire. Ce texte pourra comporter des espaces. Dans ce cas, il devra être inclus entre simples quotes (‘ ’).

7-8

CFT V2.3

Manuel de référence

PART = identifier Identifiant du partenaire pour ce transfert. Cet identifiant désigne soit : •

un partenaire décrit par la commande : CFTPART

•

ID

=

, ...

une liste de partenaires décrits dans la commande : CFTDEST

ID PART

= =

, (identifier, identifier . . .)

TYPE = MESSAGE Caractérise une demande d’émission de message. PARAMETRES FACULTATIFS COMMUNS A CFTSEND Les paramètres communs facultatifs constituent le sous-ensemble des paramètres de la commande CFTSEND, pertinent pour l’émission d’un message. Il n’inclut aucun des paramètres relatifs aux fichiers. Exemple SEND

TYPE MSG

= MESSAGE, PART = SIEGE, IDM = ANDRE, = ‘ANDRE : rappeler PIERRE ’

Emission d’un message d’identifiant ANDRE : •

vers le partenaire SIEGE si la commande CFTPART ID = SIEGE est définie,

•

sinon, vers la liste de partenaires (identifiée par SIEGE) : commande CFTDEST ID = SIEGE, PART = (identifier 1, identifier 2,...).

7.1.3. SEND TYPE = REPLY - Emission de réponse PeSIT D profil CFT

PeSIT E

ODETTE

Cette commande n’est pertinente qu’en utilisant ces protocoles.

La commande SEND TYPE = REPLY déclenche l’émission de message d’un type particulier. Ce message constitue une réponse à un transfert antérieur provenant du partenaire destinataire du message. Le moniteur partenaire interprétera ce message comme un acquittement du transfert. L’émetteur d’un tel message doit renseigner le paramètre IDT correspondant à l’identifiant de transfert à acquitter. Cette fonctionnalité pourra être exploitée, par exemple, en fin de traitement d’un fichier (ou d’un message en PeSIT D profil CFT ou en PeSIT E) reçu, afin de signifier à l’émetteur que l’ensemble des opérations liées à cette réception a été correctement réalisé. Rappelons que le protocole utilisé pour acquitter un transfert doit être le même que celui ayant servi pour ce transfert. L’acquittement d’un transfert est une notion protocolaire.

CFT V2.3

7-9

Les commandes associées aux transferts

7.1.3.1. Syntaxe SEND IDM IDT MSG PART TYPE [IDA

= = = = = =

identifier, transid, string, identifier, REPLY, identifier,]

FACULTATIFS COMMUNS A CFTSEND [EXEC [PRI

= =

filename,] pri]

7.1.3.2. Paramètres [IDA = identifier] Identifiant local du transfert attribué par l’utilisateur ou l’application utilisatrice. Cet identifiant peut être un critère de recherche du poste catalogue associé à ce transfert. Plusieurs postes catalogue peuvent être associés à un même IDA. IDM = identifier Identifiant de message. Cet identifiant ne correspond pas à un “modèle” défini par une commande CFTSEND, comme cela est le cas pour le paramètre IDF de la commande SEND TYPE = FILE. La valeur de cet identifiant est libre. Cet identifiant peut être un critère de recherche du poste catalogue associé à ce transfert. Plusieurs postes catalogue peuvent être associés à un même IDM. IDT

= transid Identifiant du transfert d’origine dont ce message est la réponse. Il correspond à l’IDT du transfert d’origine, donc du poste catalogue correspondant (en état RT ou RX, dans le catalogue). Sa valeur est une chaîne de 8 caractères, définie de la manière suivante : •

une lettre indiquant le MOIS

(de A à L, A pour janvier, etc...),

•

deux chiffres pour le JOUR

(01 à 31),

•

deux chiffres pour l’HEURE

(00 à 23),

•

deux chiffres pour les MINUTES

(00 à 59),

• un chiffre pour les DIZAINES DE SECONDES (0 à 5). Pour une commande SEND d’émission de réponse, utilisée par une procédure de fin de réception d’un fichier (cas d’utilisation la plus fréquente), on utilisera pour renseigner la valeur de ce paramètre IDT la variable symbolique &IDT, permettant de récupérer l’identifiant du transfert associé au fichier reçu.

7-10

CFT V2.3

Manuel de référence

MSG

= string string80

PeSIT D profil CFT

string512

PeSIT E

ODETTE

Texte du message émis vers le partenaire. PART = identifier Identifiant du partenaire pour ce transfert. Cet identifiant désigne l’émetteur du fichier. Si la commande est utilisée dans une procédure de fin de réception, l’utilisateur pourra renseigner ce paramètre en utilisant la variable symbolique &PART. TYPE = REPLY Caractérise une émission de réponse. PARAMETRES FACULTATIFS COMMUNS A CFTSEND : voir la commande CFTSEND.

7.1.3.3. Exemple Le SITE A envoie un fichier au partenaire SITE B. A la fin de ce transfert, le SITE B émet le message “Fichier PAYE bien reçu” vers le partenaire PART, en utilisant la variable &PART du transfert d’origine. L’identifiant de transfert à acquitter (IDT) est renseigné par la variable symbolique &IDT. Figure 6.

Mécanisme d’émission d’un message de réponse SITE A

SITE B

Transfert SEND

PART = SITEB, IDF = PAYE

Fin de Transfert IDT=A0112102

Lancement d’une commande SEND TYPE = REPLY : SEND Réception du message de réponse au transfert identifié par : PART = SITEB, IDT = A0112102

TYPE = REPLY, PART = &PART, IDM = MES2, IDT = &IDT, MSG = ‘Fichier PAYE bien reçu’

IDT = A0112102

CFT V2.3

7-11

Les commandes associées aux transferts

7.1.4. RECV - Réception de fichiers PeSIT profil SIT

Cette commande est sans objet.

Cette commande permet de demander la réception de fichiers en provenance d’un partenaire désigné. La commande RECV est exécutée au niveau d’un demandeur/récepteur (demandeur car à l’initiative de la connexion). Le partenaire est donc un serveur/émetteur. Selon les protocoles, il est possible de demander la réception : •

d’un seul fichier type : IDF explicite (IDF = identifier),

•

de tous les fichiers types en attente d’émission, côté serveur : IDF global (IDF = *),

•

de certains fichiers types en attente d’émission, côté serveur : IDF sélectif (IDF = mask).

Le tableau suivant indique les possibilités autorisées, selon les protocoles utilisés : Tableau 70. RECV IDF - Types d’identifiants autorisés Protocole

IDF explicite

IDF global

IDF sélectif

ETEBAC 3 ODETTE PeSIT D profil EXTERN PeSIT D profil CFT PeSIT E (standard) PESIT E CFT/CFT

OUI NON OUI OUI OUI OUI

NON OUI NON OUI NON OUI

NON NON NON OUI NON OUI

Les caractéristiques de cette demande de réception peuvent être précisées dans la commande RECV elle-même ou bien dans la commande CFTRECV, dont l’ID est égal à la valeur du paramètre IDF. Cette demande peut concerner un partenaire (réception simple) ou une liste de partenaires (collecte). Le paramètre PART (identifiant du PARTenaire de transfert) de cette commande RECV permet de référencer les caractéristiques du partenaire (définies dans la commande CFTPART), ou la liste de partenaires (définie dans la commande CFTDEST). Les relations entre la commande RECV et les commandes CFTRECV, CFTPART et CFTDEST sont indiquées dans l’annexe “Schémas de chaînage des commandes” du guide “Concepts” de CFT. Lors d’une réception d’un fichier, CFT crée un poste dans le catalogue. Ce poste (voir la commande LISTCAT) est identifié de façon unique, pour un moniteur donné, par les valeurs des paramètres IDT (IDentifiant de Transfert) et PART. Les réceptions effectuées lors d’une collecte sont identifiées avec la même valeur d’IDT, mais avec des valeurs de PART différentes.

7-12

CFT V2.3

Manuel de référence

7.1.4.1. Syntaxe RECV PART IDF

= identifier, = {identifier | mask},

[APPCYCID [APPOBJID [CYCLE

= identifier,] = name,] = {0 | n},]

[FILE

= {FIRST | ALL},]

[IDA

= identifier,]

[NFNAME

= filename,]

[NIDF [NFVER [TCYCLE [TRK

= = = =

PROTOCOLE

PROTOCOLE

string,] {0 | n},] {DAY | MIN | MONTH},] {UNDEFINED | ALL | NO | SUMMARY},]

PARAMETRES FACULTATIFS COMMUNS A CFTRECV

CFT V2.3

[COMMENT [CYCDATE [CYCTIME [DIRNB = [EXEC [EXIT

= string,] = date,] = time,] n,] = filename,] = identifier,]

[FACTION =

{VERIFY | DELETE | ERASE},]

VFM

[FACTION =

{CONCAT | DELETE | ERASE | VERIFY},]

VFM

[FBLKSIZE

= n,]

[FCODE

= {ASCII | BINARY | EBCDIC},]

OS Dft : OS

[FCOMP

=

{0 | 15},]

VFM

[FDB

=

filename,]

VFM

[FDISP

=

{BOTH | NEW | OLD},]

[FKEYLEN

= {0 | n},]

[FKEYPOS =

{0 | n},]

[FLRECL

= n,]

[FNAME

= filename,]

[FRECFM

= {F | U | V },]

[FORG

= {SEQ | DIRECT | INDEXED},]

PROTOCOLE

OS

PROTOCOLE OS

7-13

Les commandes associées aux transferts

[FSPACE

= n,]

[FTYPE

= c,]

[MACTION =

{“ ” | REPLACE},]

[MAXDATE [MAXTIME [MINDATE [MINTIME

= = = =

[NCOMP

= cpr,]

[PRI [WFNAME [XLATE

= {128 | n},] = filename,] = identifier,]

OS

{voir le commentaire | n},] {23595999 | time},] {date système du jour | date},] {00000000 | time},] PROTOCOLE

7.1.4.2. Paramètres [APPCYCID = identifier] {1…250} Identifiant du cycle de traitement (ensemble d’occurrences de suivi concernant un seul transfert). Ce paramètre n'est utilisable qu'à partir de la version CFT V2.3.1. [APPOBJID = name] Nom de l’objet suivi.

{1…50}

Dans Sentinel, un objet suivi est un objet de base de données qui décrit des évènements applicatifs. Les valeurs possibles de ce paramètre sont : • XFB.Transfer : cet objet suivi décrit les transferts de messages et de fichiers, • XFB.Log : cet objet suivi décrit le contenu des fichiers de LOG de CFT. Ce paramètre n'est utilisable qu'à partir de la version CFT V2.3.1. [CYCLE= {0 | n}] Nombre d’unités définissant la période du cycle de transfert (voir paramètre TCYCLE ci-après).

7-14

CFT V2.3

Manuel de référence

[FILE

= {FIRST | ALL}]

PeSIT D profil CFT

PeSIT E CFT/CFT

Option de réception du/des fichier(s) en attente d’émission, côté serveur/émetteur. Si FILE = FIRST : •

réception du premier fichier (d’IDF indiqué dans la commande RECV sous la forme “identifier” ou “mask”) en attente d’émission côté serveur/émetteur,

•

côté serveur/émetteur, ce fichier en attente peut être soit : –

en émission bloquée, avec le paramétrage associé suivant : CFTSEND ID = , IMPL = NO, . . . avec commande SEND STATE = HOLD sur ce fichier,

–

en émission implicite uniquement si l’IDF est un “identifier” (sans masque), avec le paramétrage associé suivant : CFTSEND ID = , IMPL = YES, . . .

Si FILE = ALL : •

réception séquentielle de l’ensemble des fichiers en attente d’émission, côté serveur/émetteur d’IDF correspondant. Peut être associé à IDF = identifier ou à IDF = mask . Si IDF = mask, la valeur de l’IDF de chaque transfert est fournie par le serveur ; elle permet de retrouver la description (CFTRECV) du fichier type récepteur. Après chaque transfert, le demandeur/récepteur demande à recevoir le fichier suivant en attente côté serveur ; ceci jusqu’au dernier fichier correspondant. Ce mécanisme est géré entre deux moniteurs CFT V2 et ne constitue pas un mécanisme protocolaire,

•

côté serveur/émetteur, ces fichiers en attente doivent être en émission bloquée, avec le paramétrage associé suivant : CFTSEND

ID = , IMPL = NO, . . . avec commande SEND STATE = HOLD sur ce fichier.

Les fichiers types déclarés en émission implicite, côté serveur, ne sont pas concernés par des RECV associés à des IDF sous la forme “mask”. Attention : si la commande RECV spécifie un IDF de forme “identifier” (sans masque) et si les fichiers types correspondants, côté serveur, sont déclarés en émission implicite (IMPL = YES), l’option FILE = ALL déclenchera une répétition ininterrompue du transfert, concernant le premier fichier en attente d’émission.

CFT V2.3

7-15

Les commandes associées aux transferts

[IDA = identifier] Identifiant local du transfert attribué par l’utilisateur ou l’application utilisatrice. Cet identifiant peut être un critère de recherche du poste catalogue associé à ce transfert. Plusieurs postes catalogue peuvent être associés à un même IDA. IDF

= {identifier | mask} Identification logique du “fichier type” à recevoir. La valeur associée peut être documentée : •

explicitement sous la forme “identifier”,

•

d’une manière générique sous la forme d’un masque (“mask”), correspondant à un ou plusieurs IDF explicites. ODETTE

[NFNAME

Seule la valeur IDF = * est pertinente.

= filename]

Utilisable si mode ouvert

PeSIT D profil CFT PeSIT E CFT/CFT

Nom (simple ou complet) du fichier émis par le serveur émetteur distant. Il permet au demandeur/récepteur de désigner explicitement le fichier à recevoir. Le nom peut être décrit via l’emploi de méta-caractères (* et ?) ou de variables symboliques. Ce nom peut être composé des variables symboliques suivantes : •

&FDATE, &FTIME, &FYEAR, &FMONTH, &FDAY,

•

&BDATE, &BTIME, &BYEAR, &BMONTH, &BDAY,

•

&SPART, &RPART, &PART, &NPART, &GROUP,

•

&SUSER, &RUSER,

•

&SAPPL, &RAPPL,

•

&IDF, &PARM, &IDA,

•

&IDT. PeSIT E profil CFT

Les variables symboliques spécifiques telles que &FUNIT, &FUNITC, &FPATH, &FROOT, &FREF, &FSUF peuvent être utilisées.

Suivant l’environnement concerné, l’emploi d’un nom de fichier complet (pathname) peut entraîner la création implicite d’une partie ou de la totalité d’une arborescence. Un caractère spécifique (suivant l’OS) délimitera l’arborescence à créer. Seuls les noms de sous-arborescences apparaissant à droite du caractère délimiteur seront créés.

7-16

CFT V2.3

Manuel de référence

Pour que le transfert puisse aboutir, les conditions suivantes doivent être remplies : •

côté serveur/émetteur : –

l’émission doit être en mode implicite c’est-à-dire paramétrée par la commande : CFTSEND ID = , IMPL = YES, . . .

–

le nom physique du fichier à envoyer doit pouvoir être déduit du NFNAME reçu. Le partenaire a donc dû paramétrer la commande CFTSEND comme suit : CFTSEND ID = , IMPL = YES, FNAME = &NFNAME, . . . MVS

– •

VMS

Si le fichier indiqué est un fichier à versions, la version à émettre est la version 0 ou la version -1 du fichier sur le site émetteur.

le fichier désigné par NFNAME existe.

Côté récepteur : –

si un nom complet a été fourni avec délimiteur, l’arborescence apparaissant dans la partie gauche du nom doit exister. Voir, pour plus de détails sur les mécanismes mis en oeuvre, l’annexe “Localisation des fichiers physiques” dans le guide “Concepts”. Cas particulier de la consultation à distance d’une liste de fichiers Le nom fourni peut être un nom générique de fichier ou un nom de répertoire. Il peut inclure : •

des variables symboliques,

• des méta-caractères (* et ?). Côté serveur/émetteur, l’émission doit être en mode implicite et le nom du fichier est déduit du NFNAME reçu.

CFT V2.3

7-17

Les commandes associées aux transferts

Figure 7.

Exemple de paramétrage

CFTRECV

ID FNAME ...

= =

RECV

IDF = PART = NFNAME =

IDF1, X,

IDF1, ... /

Fichier X

CFTSEND

IDF IMPL FNAME

= = =

IDF1, YES, &NFNAME

Répertoire

1 enregistrement = 1 entrée de

VFM PeSIT profil ANY [NFVER = {0 | n}] Numéro de version du fichier émis, s’il s’agit d’un fichier GDG.

PeSIT profil CFT

Les valeurs représentent : •

0 : la version 0 du fichier,

•

n : la version -n du fichier.

VFM

Cas 1 : NFVER est utilisé avec NFNAME (mode ouvert avec émission implicite du côté serveur émetteur). FNAME = &FNAME (-&NFVER). Le partenaire émet, dans ces conditions, le fichier logique NFNAME (-NFVER) de la base VFM désignée dans son paramétrage par le paramètre FDB. Cas 2 : NFVER est utilisé seul (mode fermé avec émission implicite du côté du serveur émetteur) FNAME = &PART.&IDF (-&NFVER). Le partenaire émet la version du fichier logique ‘&PART.&IDF’ indiquée dans le paramètre NFVER. Le paramètre FDB indique la base VFM dont est issu le fichier logique.

GDG

Cas 1 : NFVER est utilisé avec NFNAME (mode ouvert avec émission implicite du côté serveur émetteur). Exemple : MVS

FNAME = &FNAME (-&NFVER). Le partenaire émet le fichier GDG avec la racine et le numéro de version indiqué.

7-18

CFT V2.3

Manuel de référence

GDG

Cas 2 : NFVER est utilisé seul (mode fermé avec émission implicite du côté du serveur émetteur) Exemple : MVS

FNAME = &TEST.GDG (-&NFVER). Le partenaire émet la version du fichier ‘&PART.&IDF’ indiquée dans le paramètre NFVER.

Attention : lorsque NFVER n’est pas précisé, la valeur prise par défaut est 0. Il est donc conseillé de définir une commande d’émission (CFTSEND) par type de fichier à traiter (normal ou à versions). Voir les exemples pour une meilleure compréhension. NIDF

= string

string28

Utilisable uniquement en mode demandeur-récepteur (pour un IDF explicite)

PeSIT E CFT/CFT

string14

PeSIT E

string8

PeSIT D

string26

ODETTE ETEBAC3

string28 Identifiant réseau du fichier transitant sur le réseau. Si ce paramètre est utilisé, il prime sur le paramètre NIDF de la commande CFTIDF correspondante. Par défaut (pas de paramètre NIDF, ni de commande CFTIDF correspondante), l’identifiant “réseau” est égal à l’identifiant local (NIDF = IDF). Remarque : en PeSIT E standard, le NIDF est transporté dans le PI 12 (14 caractères maximum). En PeSIT E entre 2 moniteurs CFT, si le NIDF a une longueur supérieure à 14 caractères, cet NIDF est transporté dans le PI 99 (28 caractères maximum), la valeur indiquée dans le PI 12 étant tronquée à 14 caractères. PART = identifier Identifiant du partenaire (serveur émetteur distant) associé à ce transfert. Cet identifiant désigne soit : •

un partenaire décrit par la commande : CFTPART

•

= , ...

une liste de partenaires décrite par la commande : CFTDEST (ou

CFT V2.3

ID ID PART FNAME

= , = (identifier, identifier . . .) = filename).

7-19

Les commandes associées aux transferts

[TCYCLE = {DAY | MIN | MONTH}] Unité de la période du cycle de transfert : •

DAY : jour,

•

MIN : minute,

•

MONTH : mois.

[TRK = {UNDEFINED | ALL | NO | SUMMARY}] Spécification du niveau de détail que CFT fournit à Sentinel sur les transferts. CFT envoie les informations sur le transfert sous forme d'occurrences de suivi. Les valeurs possibles de ce paramétre sont : • NO :

le moniteur n'envoie jamais d'occurrences de suivi à Sentinel,

• ALL :

le moniteur envoie une occurrence de suivi à Sentinel pour chaque étape de chaque transfert,

• SUMMARY : le moniteur envoie une occurrence de suivi à Sentinel uniquement pour l'étape initiale et l'étape finale de chaque transfert, • UNDEFINED : les options de suivi sont définies dans le paramètre TRK de la commande CFTRECV. TRK n'est utilisable qu'à partir de la version CFT V2.3.1. FACULTATIFS COMMUNS A CFTRECV : voir la commande CFTRECV.

7.1.4.3. Exemples RECV PART=CENTRE5, IDF=STAT Réception du fichier STAT du partenaire CENTRE5. RECV PART=SIEGE, IDF=CHQ, CYCLE=1, TCYCLE=DAY Avec, comme paramétrage de la commande CFTRECV associée à l’IDF=CHQ : CFTRECV ID = CHQ, MINDATE = 19930101, MINTIME = 08, MAXDATE = 19940101, CYCDATE = 19930101, CYCTIME = 0830, FNAME = CHEQUE . . . Réception du fichier CHEQUE du partenaire SIEGE, tous les jours, à partir du 1er Janvier 1993 et jusqu’au 1er Janvier 1994, entre 8h00 et 8h30.

7-20

CFT V2.3

Manuel de référence VFM

Mode ouvert, émission implicite : RECV

PART IDF NFNAME NFVER

= = = =

SIEGE, STAT, FICSTAT, 1

CFTSEND

IMPL = YES, FNAME = &NFNAME (-&NFVER), FDB = . . . Demande de réception de la version -n du fichier logique STAT. La commande CFTSEND, côté émetteur, précise que le fichier émis est un fichier logique (paramètre FDB). Le demandeur récepteur désigne explicitement le fichier à recevoir (NFNAME). Mode fermé : RECV

PART IDF NFVER

= = =

SIEGE, STAT, n

CFTSEND

IMPL = YES, FNAME = &PART.&IDF.MVT (-&NFVER), FDB = . . . Demande de réception de la version -n du fichier STAT. La commande CFTSEND, côté émetteur, précise que le fichier émis est un fichier logique (paramètre FDB). GDG

Mode ouvert, émission implicite : RECV

PART IDF NFNAME NFVER

= = = =

SIEGE, STAT, FICSTAT, 1

CFTSEND

IMPL = YES, FNAME = &NFNAME (-&NFVER) Demande de réception de la version -1 du fichier FICSTAT. Le demandeur récepteur désigne explicitement le fichier à recevoir (NFNAME). Mode fermé : RECV

PART IDF NFVER

= = =

SIEGE, STAT, n

CFTSEND

IMPL = YES, FNAME = &PART.&IDF.MVT (-&NFVER) Demande de réception de la version -n du fichier &PART.&IDF.MVT.

CFT V2.3

7-21

Les commandes associées aux transferts GDG

VFM

Le numéro de version n’est pas précisé. RECV

PART IDF

= =

SIEGE, STAT

CFTSEND

ID = STAT, IMPL = YES, FNAME = &PART.&IDF.MVT(-&NFVER) Le numéro de version par défaut sera 0 (zéro). L’émetteur sélectionne obligatoirement le fichier &PART.&IDF.MVT(0).

7.2. Les actions sur les transferts

7.2.1. DELETE - Suppression des postes du catalogue Cette commande permet la suppression d’un ou plusieurs postes du catalogue. Un transfert en cours est interrompu et sa requête de transfert disparaît du catalogue. D’autre part, pour une requête de type R (Receive) en état non Terminé (état différent de T et X), si le fichier de réception est un fichier temporaire (classique ou VFM), ce fichier est automatiquement détruit.

7.2.1.1. Syntaxe DELETE PART

=

{identifier | mask},

[DIRECT [IDT [IDF [IDA [IDTU [STATE

= = = = = =

{BOTH | RECV | SEND},] {* | transid},] identifier,] identifier,] string,] {* | C | D | H | K | T | X}]

7.2.1.2. Paramètres [DIRECT = {BOTH | RECV | SEND}] Sens de transmission des requêtes concernées. Les valeurs possibles sont :

7-22

•

BOTH : (par défaut) prenant en compte les transferts en émission et en réception,

•

RECV : permettant de limiter l’action aux transferts en réception,

•

SEND : permettant de limiter l’action aux transferts en émission.

CFT V2.3

Manuel de référence

[IDA = identifier] Identifiant local du transfert attribué par l’utilisateur ou l’application utilisatrice. Plusieurs postes catalogue peuvent être associés à un même IDA. Pas de valeur par défaut. [IDF = identifier] Identifiant de fichier type. Plusieurs postes catalogue peuvent être associés à un même IDF. Pas de valeur par défaut. [IDT = { * | transid}] Identifiant du transfert. Il identifie un transfert pour un partenaire et un sens donnés. La valeur ‘*’ signifie que l’on ne souhaite pas effectuer de sélection sur le paramètre IDT (valeur par défaut). [IDTU = string8] Identifiant compteur local de transfert. PART = {identifier | mask} Identifiant du partenaire. La valeur associée de ce paramètre peut être : •

un identifiant (identifier) : la commande concerne seulement les transferts avec ce partenaire,

•

un masque (mask) : la commande concerne les transferts avec les partenaires dont l’identifiant correspond à ce masque.

[STATE = {* | C | D | H | K | T | X}] Etat de transfert. La signification des états est indiqué au tableau “signification des états de transfert”, dans ce chapitre. La valeur par défaut * signifie que l’on ne souhaite pas effectuer de sélection sur l’état de transfert (consultez le chapitre “Actions et phases successives à un transfert” dans le guide “Concepts” de CFT).

7.2.1.3. Exemples Exemple 1 DELETE PART = SIE?? Suppression de tous les transferts (IDT = * par défaut) en émission et en réception (DIRECT = BOTH par défaut), pour les partenaires dont l’identifiant commence par “SIE” et comprend, en tout, 5 caractères. Exemple 2 DELETE PART = SIEGE, IDF = COMPTA, DIRECT = SEND Suppression de tous les transferts (IDT = * par défaut) en émission (DIRECT = SEND) du fichier type COMPTA vers le partenaire SIEGE.

CFT V2.3

7-23

Les commandes associées aux transferts

7.2.2. HALT - Arrêt de transferts Cette commande permet la suspension d’un ou de tous les transferts en émission et/ou en réception, avec le ou les partenaires sélectionnés. Les transferts arrêtés sont mis dans le catalogue à l’état H (voir la commande LISTCAT). Ils pourront être réactivés : •

par une commande opérateur START,

•

à réception d’une demande de réactivation du transfert issue du partenaire.

Le moniteur assure l’intégrité des données en cas d’interruption et, selon le protocole utilisé, autorise la reprise du transfert au dernier point de synchronisation posé avant interruption, ou simplement en début de fichier.

7.2.2.1. Syntaxe HALT PART=

{identifier | mask},

[DIRECT [IDT [IDF [IDA [IDTU

= = = = =

{BOTH | RECV | SEND},] {* | transid},] identifier,] identifier,] string]

7.2.2.2. Paramètres [DIRECT = {BOTH | RECV | SEND}] Sens de transmission des requêtes concernées. Les valeurs possibles sont : •

BOTH : (par défaut) prenant en compte les transferts en émission et en réception,

•

RECV : permettant de limiter l’action aux transferts en réception,

•

SEND : permettant de limiter l’action aux transferts en émission.

[IDA = identifier] Identifiant local du transfert attribué par l’utilisateur ou l’application utilisatrice. Plusieurs postes catalogue peuvent être associés à un même IDA. Pas de valeur par défaut. [IDF = identifier] Identifiant de fichier type. Plusieurs postes catalogue peuvent être associés à un même IDF. Pas de valeur par défaut.

7-24

CFT V2.3

Manuel de référence

[IDT = {* | transid}] Identifiant du transfert. Il identifie un transfert pour un partenaire donné. La valeur ‘*’ signifie que l’on ne souhaite pas effectuer de sélection sur le paramètre IDT (valeur par défaut). [IDTU = string8] Identifiant compteur local de transfert. PART = {identifier | mask} Identifiant du partenaire. La valeur associée de ce paramètre peut être : •

un identifiant (identifier) : la commande concerne seulement les transferts avec ce partenaire,

•

un masque (mask) : la commande concerne les transferts avec les partenaires dont l’identifiant correspond à ce masque.

7.2.2.3. Exemples Exemple 1 HALT PART = * Arrêt de tous les transferts (IDT = * par défaut) en émission et réception (DIRECT = BOTH par défaut), pour tous les partenaires. Exemple 2 HALT PART = SIEGE, IDF = COMPTA, DIRECT = SEND Arrêt du transfert en émission du fichier type COMPTA pour le partenaire SIEGE.

7.2.3. KEEP - Suspension de transferts Cette commande permet l’arrêt d’un ou de tous les transferts en émission et/ou en réception avec le ou les partenaires sélectionnés. La suspension se distingue de l’interruption (HALT) par le fait que seule une intervention manuelle de l’opérateur peut relancer le transfert (commande START). Les transferts suspendus sont mis en état K. Le moniteur assure l’intégrité des données en cas de suspension et, selon le protocole utilisé, autorise la reprise du transfert au dernier point de synchronisation posé avant interruption, ou simplement en début de fichier.

CFT V2.3

7-25

Les commandes associées aux transferts

7.2.3.1. Syntaxe KEEP PART

=

{identifier | mask},

[DIRECT [IDT [IDF [IDA [IDTU

= = = = =

{BOTH | RECV | SEND},] {* | transid},] identifier,] identifier,] string]

7.2.3.2. Paramètres [DIRECT = {BOTH | RECV | SEND }] Sens de transmission des requêtes concernées : •

la valeur BOTH prend en compte les transferts en émission et en réception,

•

la valeur SEND permet de limiter l’action aux transferts en émission,

•

la valeur RECV permet de limiter l’action aux transferts en réception.

[IDA = identifier] Identifiant local du transfert attribué par l’utilisateur ou l’application utilisatrice. Plusieurs postes catalogue peuvent être associés à un même IDA. Pas de valeur par défaut. [IDF = identifier] Identifiant de fichier type. Plusieurs postes catalogue peuvent être associés à un même IDF. Pas de valeur par défaut. [IDT = {* | transid}] Identifiant du transfert. Il identifie un transfert pour un partenaire donné. La valeur ‘*’ signifie que l’on ne souhaite pas effectuer de sélection sur le paramètre IDT (valeur par défaut). [IDTU = string8] Identifiant compteur local de transfert. PART = {identifier | mask} Identifiant du partenaire. La valeur associée de ce paramètre peut être :

7-26

•

un identifiant (identifier) : la commande concerne seulement les transferts avec ce partenaire,

•

un masque (mask) : la commande concerne les transferts avec les partenaires dont l’identifiant correspond à ce masque.

CFT V2.3

Manuel de référence

7.2.3.3. Exemples Exemple 1 KEEP PART = PARIS2 Suspension de tous les transferts (IDT = * par défaut) en émission et réception (DIRECT = BOTH par défaut) avec le partenaire PARIS2. Exemple 2 KEEP PART = PARIS*, IDF = PAYE, DIRECT = RECV Suspension de la réception du fichier PAYE provenant d’un partenaire dont l’identifiant commence par “PARIS”.

7.2.4. RESUME - Remise à disposition Cette commande remet à disposition, en mode serveur, une requête d'émission bloquée mise en état "hold" et dont les codes diagnostics sont non nuls. Le demandeur peut alors : •

soit relancer la réception,

•

soit faire une nouvelle réception.

7.2.4.1. Syntaxe RESUME PART=

{identifier | mask},

[DIRECT [IDT [IDF [IDA [IDTU

= = = = =

{BOTH |RECV | SEND},] {* | transid},] identifier,] identifier,] string]

7.2.4.2. Paramètres [DIRECT = {BOTH | RECV | SEND}] Sens de transmission des requêtes concernées. •

BOTH prenant en compte les transferts en émission et en réception,

•

SEND permettant de limiter l’action aux transferts en émission,

•

RECV permettant de limiter l’action aux transferts en réception.

[IDA = identifier] Identifiant local du transfert attribué par l’utilisateur ou l’application utilisatrice. Plusieurs postes catalogue peuvent être associés à un même IDA. Pas de valeur par défaut.

CFT V2.3

7-27

Les commandes associées aux transferts

[IDF = identifier] Identifiant de fichier type. Plusieurs postes catalogue peuvent être associés à un même IDF. Pas de valeur par défaut. [IDT = {* | transid}] Identifiant du transfert. Il identifie un transfert pour un partenaire donné. La valeur ‘*’ signifie que l’on ne souhaite pas effectuer de sélection sur le paramètre IDT (valeur par défaut). [IDTU = string8] Identifiant compteur local de transfert. PART = {identifier | mask} Identifiant du partenaire. La valeur associée de ce paramètre peut être : •

un identifiant (identifier) : la commande concerne seulement les transferts avec ce partenaire,

•

un masque (mask) : la commande concerne les transferts avec les partenaires dont l’identifiant correspond à ce masque.

7.2.4.3. Exemples Exemple 1 RESUME PART = PARIS5 Remise à disposition de tous les transferts en mode serveur avec le partenaire PARIS5. Exemple 2 RESUME PART = PARIS5, IDF = PAYE Remise à disposition des transferts en mode serveur avec le partenaire PARIS5 pour l'IDF PAYE.

7.2.5. START - Redémarrage de transferts Seul le CFT demandeur du transfert peut être à l’initiative d’une commande START. Les transferts étant à l’état H ou K dans le catalogue passent à l’état D, après l’exécution de cette commande ; ces transferts seront donc relancés effectivement après scrutation du catalogue et si les ressources nécessaires sont disponibles. Remarque : ODETTE

7-28

une commande START reste sans effet sur l’interruption d’une commande RECV. CFT se comporte dans ce cadre en mode serveur et aucune reprise n’est envisageable. Pour effectuer la reprise des transferts, il faut activer une nouvelle commande RECV.

CFT V2.3

Manuel de référence

7.2.5.1. Syntaxe START PART=

{identifier | mask},

[DIRECT [IDT [IDF [IDA [IDTU [FORCE

= = = = = =

{BOTH |RECV | SEND},] {* | transid},] identifier,] identifier,] string] {NO | YES}]

7.2.5.2. Paramètres [DIRECT = {BOTH | RECV | SEND}] Sens de transmission des requêtes concernées. •

BOTH prenant en compte les transferts en émission et en réception,

•

SEND permettant de limiter l’action aux transferts en émission,

•

RECV permettant de limiter l’action aux transferts en réception.

[FORCE = {NO | YES}] Indication de la relance d'une requête non exécutée dans sa plage horaire : •

NO

: la requête n'est pas relancée,

• YES : la requête est relancée. L'heure maximale d'exécution d'une requête relancée devient : 23595999. Remarque : une commande START, quelle que soit la valeur du paramètre FORCE, n'aura aucun effet sur une requête n'ayant pas encore atteint l'heure minimale d'exécution. [IDA = identifier] Identifiant local du transfert attribué par l’utilisateur ou l’application utilisatrice. Plusieurs postes catalogue peuvent être associés à un même IDA. Pas de valeur par défaut. [IDF = identifier] Identifiant de fichier type. Plusieurs postes catalogue peuvent être associés à un même IDF. Pas de valeur par défaut. [IDT = {* | transid}] Identifiant du transfert. Il identifie un transfert pour un partenaire donné. La valeur ‘*’ signifie que l’on ne souhaite pas effectuer de sélection sur le paramètre IDT (valeur par défaut).

CFT V2.3

7-29

Les commandes associées aux transferts

[IDTU = string8] Identifiant compteur local de transfert. PART = {identifier | mask} Identifiant du partenaire. La valeur associée de ce paramètre peut être : •

un identifiant (identifier) : la commande concerne seulement les transferts avec ce partenaire,

•

un masque (mask) : la commande concerne les transferts avec les partenaires dont l’identifiant correspond à ce masque.

7.2.5.3. Exemples Exemple 1 START PART = PARIS5 Redémarrage de tous les transferts (IDT = * par défaut) en émission et réception (DIRECT = BOTH par défaut) avec le partenaire PARIS5. Exemple 2 START PART = PARIS5, IDF = PAYE, DIRECT = RECV Redémarrage des transferts en réception pour l’IDF PAYE provenant du partenaire PARIS5.

7.2.6. SUBMIT - Soumission d’une procédure de fin de transfert Cette commande permet de soumettre une procédure de fin de transfert pour chaque transfert sélectionné. La procédure hérite des variables symboliques du contexte du transfert. Un utilisateur a la possibilité de lancer (ou de relancer) cette procédure lorsque le transfert (de fichier ou de message) est en état T. Cette commande n’a aucun effet sur les transferts appartenant à une liste de diffusion même si ceux-ci sont en état T. En revanche, elle peut être appliquée sur le transfert générique (dont le PART est égal à l’identifiant de la liste de diffusion) lorsqu’il est à l’état T.

7.2.6.1. Syntaxe SUBMIT

7-30

PART

=

{identifier | mask},

[DIRECT [IDT [IDF [IDA [EXEC

= = = = =

{BOTH | RECV | SEND},] {* | transid},] identifier,] identifier,] filename]

CFT V2.3

Manuel de référence

7.2.6.2. Paramètres [DIRECT = {BOTH | RECV | SEND}] Sens de transmission des requêtes concernées. Les valeurs possibles sont : •

SEND permettant de limiter l’action aux transferts en émission,

•

RECV permettant de limiter l’action aux transferts en réception,

•

BOTH prenant en compte les transferts en émission et en réception.

[EXEC = filename] Nom du fichier contenant la procédure à exécuter. Par défaut, ce nom est celui défini par les paramètres : •

EXEC de la commande SEND/RECV (selon le sens du transfert),

•

ou (si ce paramètre n’est pas renseigné) EXECSF ou EXECRF de CFTPARM (selon le sens du transfert). Les variables symboliques héritent des valeurs du contexte de chaque transfert sélectionné. Ces variables peuvent donc être utilisées, comme pour les paramètres EXEC* indiqués précédemment : •

pour constituer le nom du fichier contenant la procédure à exécuter. La liste des variables symboliques utilisables est la même que celle indiquée pour le paramètre EXEC* correspondant.

•

dans les traitements de la procédure à exécuter. La liste des variables symboliques est indiquée dans le paragraphe “Variables symboliques” du guide “Concepts” de CFT.

[IDA = identifier] Identifiant local du transfert attribué par l’utilisateur ou l’application utilisatrice. Plusieurs postes catalogue peuvent être associés à un même IDA. Pas de valeur par défaut. [IDF = identifier] Identifiant de fichier type. Plusieurs postes catalogue peuvent être associés à un même IDF. Pas de valeur par défaut.

CFT V2.3

7-31

Les commandes associées aux transferts

[IDT = {* | transid}] Identifiant du transfert. Ce paramètre permet d’identifier un transfert pour un partenaire donné. La valeur ‘*’ signifie que l’on ne souhaite pas effectuer de sélection sur ce paramètre (valeur par défaut). PART = {identifier | mask} Identifiant du partenaire. La valeur de ce paramètre peut être : •

un identifiant : la commande concerne seulement les transferts avec ce partenaire,

•

un masque : la commande concerne les transferts avec les partenaires dont l’identifiant correspond à ce masque.

7.2.6.3. Exemples 7.2.6.3.1. Transfert simple SUBMIT IDT=A1020301, IDF=file1, IDA=appli1, DIRECT=SEND, EXEC=myprog La procédure définie dans le fichier “myprog” est soumise. Cette procédure hérite des valeurs des paramètres du transfert sélectionné par la commande SUBMIT. Ceci permet la substitution des variables symboliques éventuellement utilisées dans la procédure soumise.

7.2.6.3.2. Liste de diffusion CFTDEST

ID PART

= liste, = (part1, part2, part3)

CFTPART

ID . . .

= part1,

CFTPART

ID . . .

= part2,

CFTPART

ID . . .

= part3,

CFTSEND PART=liste, IDF=myfile, EXEC=myprog

7-32

CFT V2.3

Manuel de référence

La procédure myprog est exécutée UNE FOIS quand l’ensemble des transferts est terminé. Le catalogue avant l’exécution de la procédure de fin de transfert se présente de la façon suivante : Tableau 71. SUBMIT - Catalogue avant exécution de la procédure de fin de transfert ETAT

PART

IDF

SFT SFT SFT SFT

LISTE PART1 PART2 PART3

MYFILE (transfert générique) MYFILE MYFILE MYFILE

Il sera possible de soumettre à nouveau la procédure de fin de transfert par la commande : SUBMIT PART = LISTE, IDF = myfile Elle sera relative au transfert générique. Une commande SUBMIT appliquée sur un transfert de la liste (par exemple SUBMIT PART = PART1) sera sans effet.

7.2.7. END - Déclaration de transferts exécutés Cette commande permet de déclarer que toutes les opérations liées à la fin du transfert (émission comme réception) ont été correctement exécutées. Dans la plupart des cas, cette commande est soumise à CFT par les procédures de fin de transfert, mais peut l’être aussi manuellement. Les transferts concernés doivent être dans l’état T et passeront à l’état X (état exécuté).

7.2.7.1. Syntaxe END PART

=

{identifier | mask},

[DIRECT [IDT [IDF [IDA

= = = =

{BOTH | RECV | SEND},] {* | transid},] identifier,] identifier]

7.2.7.2. Paramètres [DIRECT = {BOTH | RECV | SEND}] Sens de transmission des requêtes concernées.

CFT V2.3

•

BOTH prenant en compte les transferts en émission et en réception,

•

SEND permettant de limiter l’action aux transferts en émission,

•

RECV permettant de limiter l’action aux transferts en réception.

7-33

Les commandes associées aux transferts

[IDA = identifier] Identifiant local du transfert attribué par l’utilisateur ou l’application utilisatrice. Plusieurs postes catalogue peuvent être associés à un même IDA. Pas de valeur par défaut. [IDF = identifier] Identifiant de fichier type. Plusieurs postes catalogue peuvent être associés à un même IDF. Pas de valeur par défaut. [IDT = {* | transid}] Identifiant du transfert. Il identifie un transfert pour un partenaire donné. La valeur ‘*’ signifie que l’on ne souhaite pas effectuer de sélection sur le paramètre IDT (valeur par défaut). PART = {identifier | mask} Identifiant du partenaire. La valeur associée de ce paramètre peut être : •

un identifiant (identifier) : la commande concerne seulement les transferts avec ce partenaire,

•

un masque (mask) : la commande concerne les transferts avec les partenaires dont l’identifiant correspond à ce masque.

7.2.7.3. Exemples Exemple 1 END PART = SIEGE, IDF = TEST, IDA = X32451 Mise à l’état “terminé” des transferts en émission et en réception (DIRECT=BOTH par défaut) avec le partenaire (PART) SIEGE dont l’identifiant local (IDA) est X32451 et relatifs au fichier type d’identifiant (IDF) TEST. Exemple 2 END PART = SIEGE, IDT = A0110503 Mise à l’état exécuté du transfert d’identifiant (IDT) A0110503 relatif au partenaire (PART) SIEGE. Ce transfert peut être en émission ou en réception (DIRECT=BOTH par défaut).

7-34

CFT V2.3

Manuel de référence

7.3. Interrogation d’un composant du moniteur

7.3.1. MQUERY - Interrogation d’un composant du moniteur La commande MQUERY peut être utilisée pour connaître la date et l’heure de la prochaine action.

7.3.1.1. Syntaxe MQUERY NAME

=

{CAT | COMMAND}

7.3.1.2. Paramètres NAME = {CAT | COMMAND} Nom du composant à interroger. Ce paramètre peut prendre les valeurs suivantes : •

CAT

•

COMMAND :

:

interrogation du cache catalogue, interrogation du cache de commandes.

7.3.1.3. Exemples Interrogation du cache catalogue MQUERY NAME=CAT Le résultat d’une interrogation du cache catalogue (requêtes de transferts en attente d’exécution) donne le compte-rendu suivant. Seules les requêtes différées au jour-même sont affichées, dans la limite des 15 premières. CFTI24I CFTI24I CFTI24I CFTI24I CFTI24I CFTR12I

*** 4 REQUEST(S) INTO TRANSFER *** D=2000/11/02 T=18:00:00.01 *** D=2000/11/02 T=18:00:00.02 *** D=2000/11/02 T=18:00:00.03 *** D=2000/11/02 T=18:00:00.03 MQUERY Treated for USER userid

CACHE (SIZE=512) PART=PPANYX1 IDF=1 IDT=D1015401 PART=PPANYX1 IDF=1 IDT=D1015402 PART=PPANYX1 IDF=1 IDT=D1015403 PART=PPANYX1 IDF=1 IDT=D1015404

Interrogation du cache de commande MQUERY NAME=COMMAND Le résultat d’une interrogation du cache de commandes donne le compte-rendu suivant: CFTI20I *** 2 COMMAND(S) INTO CACHE CFTI20I *** DATE=02/11/2000 TIME= 22:00:00.00 SWITCH LOG CFTI20I *** DATE=03/11/2000 TIME= 00:00:00.00 SWITCH ACCOUNT CFTR12I MQUERY Treated for USER userid

CFT V2.3

7-35

Les commandes associées aux transferts

7.4. Actions sur les partenaires

7.4.1. INACT - Désactivation de partenaire La commande INACT sert à désactiver un ou plusieurs partenaires créés par la commande CFTPART. Attention : elle ne peut donc agir sur les partenaires dont la définition a été fournie ou modifiée par un EXIT annuaire. Un partenaire désactivé par la commande INACT ne peut être réactivé que par une commande ACT. L’utilisateur peut choisir : •

d’interrompre les transferts en cours,

•

de ne désactiver qu’un mode (demandeur ou serveur) ou les deux.

Lorsque le partenaire est désactivé, en mode demandeur, les transferts en attente sont suspendus, en mode serveur, les transferts sont refusés. Une requête de transfert en attente d’exécution en mode demandeur pour un partenaire désactivé reste à l’état D avec le code diagnostic 430 et le diagnostic protocolaire INACT. Une requête de transfert en attente d’exécution en mode serveur pour un partenaire désactivé reste à l’état D avec le code diagnostic 930 et le diagnostic protocolaire RCO 312 ou ABO 312 si la session est déjà ouverte. Les transferts interrompus par une commande INACT avec le paramètre FORCE=YES se retrouvent en état H avec un code diagnostic 121 et un code diagnostic protocolaire OPER.

7.4.1.1. Syntaxe INACT [TYPE ID [MODE [FORCE

= PART,] = identifier, = {BOTH | REQUESTER | SERVER},] = {NO | YES}]

7.4.1.2. Paramètres [TYPE = PART] Objet à désactiver. ID

= identifier Identifiant(s) du (ou des) partenaire(s) à désactiver. Pour désactiver plusieurs partenaires en une seule commande, utilisez les caractères jokers ou méta-caractères.

7-36

CFT V2.3

Manuel de référence

[MODE = {BOTH | REQUESTER | SERVER}] Mode à désactiver : •

BOTH : les deux,

•

REQUESTER : demandeur,

• SERVER : serveur. Les raccourcis B, R et S peuvent être employés à la place des mots clés. Attention : le paramètre MODE est absolu. Une commande INACT MODE=SERVER, suivi d’une commande INACT MODE=REQUESTER, ne signifie pas que le partenaire est inactif pour les deux modes, mais seulement pour le mode REQUESTER (dernière commande passée). Le paramètre STATE de la commande CFTPART va être positionné à la valeur : •

NOACTIVE après l’exécution de la commande INACT MODE=BOTH,

•

ACTIVESERV après l’exécution de la commande INACT MODE=REQUESTER,

•

ACTIVEREQ après l’exécution de la commande INACT MODE=SERVER.

[FORCE = {NO | YES}] Arrêt des transferts en cours pour le (ou les) partenaire (s). •

NO : aucune action,

•

YES : force l’arrêt des transferts en cours.

7.4.2. ACT - Réactivation de partenaire La commande ACT sert à réactiver un ou plusieurs partenaires créés par la commande CFTPART. Attention : elle ne peut donc agir sur les partenaires dont la définition a été fournie ou modifiée par un EXIT annuaire. L’utilisateur peut choisir de ne désactiver qu’un mode (demandeur ou serveur) ou les deux. Lorsque le partenaire est réactivé, les requêtes de transfert suspendues par la commande INACT : •

seront reprises automatiquement, si ce sont des requêtes en mode demandeur (code diagnostic 430),

•

devront être relancées par la commande START dans les autres cas.

7.4.2.1. Syntaxe ACT

CFT V2.3

[TYPE ID [MODE

= PART,] = identifier, = {BOTH | REQUESTER | SERVER}]

7-37

Les commandes associées aux transferts

7.4.2.2. Paramètres [TYPE = PART] Objet à réactiver. ID

= identifier Identifiant(s) du (ou des) partenaire(s) à désactiver. Pour désactiver plusieurs partenaires en une seule commande, utilisez les caractères jokers ou méta-caractères.

[MODE = {BOTH | REQUESTER | SERVER}] Mode à désactiver : •

BOTH : les deux,

•

REQUESTER : demandeur,

• SERVER : serveur. Les raccourcis B, R et S peuvent être employés à la place des mots clés. Attention : le paramètre MODE est absolu. Une commande ACT MODE=SERVER, suivie d’une commande ACT MODE=REQUESTER, ne signifie pas que le partenaire est actif pour les deux modes, mais seulement pour le mode REQUESTER (dernière commande passée). Le paramètre STATE de la commande CFTPART va être positionné à la valeur :

7-38

•

ACTIVEBOTH après l’exécution de la commande ACT MODE=BOTH,

•

ACTIVEREQ après l’exécution de la commande ACT MODE=REQUESTER,

•

ACTIVESERV après l’exécution de la commande ACT MODE=SERVER.

CFT V2.3

8. Les commandes d’administration du moniteur CFT

8.1. SHUT - Arrêt de CFT Demande d’arrêt du moniteur CFT, avec interruption des transferts en cours ou en laissant les transferts en cours se terminer.

8.1.1. Syntaxe SHUT [FAST

= {NO | YES}]

8.1.2. Paramètre [FAST

= {NO |YES}]

Type d’arrêt demandé : • FAST = YES. Arrêt brutal de CFT. Tous les transferts en cours sont interrompus et passent en état D. Aucun transfert en attente n’est activé, • FAST = NO. CFT termine tous les transferts en cours et s’arrête. Aucun transfert nouveau n’est initialisé.

8.2. SWITCH - Basculement manuel des fichiers de suivi Cette commande permet de basculer les fichiers du moniteur fonctionnant à l’alternat. Elle concerne donc les fichiers “journaux” et les fichiers “statistiques” des transferts. Au moment du basculement, le moniteur exécute la procédure définie par le paramètre EXEC de la commande de paramétrage associée : •

CFTLOG pour le fichier journal,

•

CFTACCNT pour le fichier statistique.

Cette procédure peut exploiter les fichiers (journal ou statistique) utilisés avant basculement. Les noms de ces fichiers sont accessibles par les variables symboliques :

CFT V2.3

•

&FLOG pour le nom du fichier journal avant basculement,

•

&FACCNT pour le nom du fichier statistique avant basculement.

8-1

Les commandes d’administration du moniteur CFT

Il est essentiel qu’à la fin du traitement effectué par cette procédure, ces fichiers (utilisés avant basculement) soient purgés afin d’être réutilisés par le moniteur CFT lors du basculement suivant.

8.2.1. Syntaxe SWITCH [TYPE

= {LOG | ACCNT}]

8.2.2. Paramètres [TYPE

= {LOG | ACCNT}]

Ce paramètre définit si la commande SWITCH s’applique aux fichiers journaux ou aux fichiers statistiques : •

TYPE = LOG.

La commande SWITCH provoque l’arrêt de l’écriture des messages sur le fichier journal en cours, le basculement de l’écriture sur l’autre fichier journal et l’exécution de la procédure décrite par le paramètre EXEC de la commande CFTLOG, •

TYPE = ACCNT.

La commande SWITCH provoque l’arrêt de l’écriture des statistiques sur le fichier statistique en cours, le basculement de l’écriture sur l’autre fichier statistique et l’exécution de la procédure décrite par le paramètre EXEC de la commande CFTACCNT. Cette commande n’a de sens que si les statistiques sont écrites dans les fichiers propres à CFT (CFTACCNT TYPE = FILE) et non dans l’accounting système.

8.3. ABOUT - Caractéristiques de la machine Cette commande de CFTUTIL affiche les caractéristiques de la machine sur laquelle le moniteur CFT est installé.

8.3.1. Syntaxe ABOUT [COMMENT

= string32]

8.3.2. Paramètre [COMMENT = string32] Commentaire libre. Ce commentaire est affiché et peut être utilisé pour indiquer une information spécifique (exemple : nom du client, ...).

8-2

CFT V2.3

Manuel de référence

8.3.3. Informations affichées Cette commande affiche les informations suivantes : About CFT informations : * product * version * level * upgrade

= = = =



Host informations : * model * cpuid

= =



Ces informations seront exploitées ultérieurement pour déterminer une clé logicielle.

8.3.4. Exemple La commande : CFTUTIL

ABOUT

COMMENT = CLIENT

affiche les informations suivantes : About CFT

Host

CLIENT informations : * product * version * level informations : * model * cpuid

= = =

CFT/OS2 2.2.0 061-177-xxxx

= =

KERNEL 0123456789ABCDEF

8.4. FLUSH - Optimisation des blocs internes du fichier catalogue Cette commande permet de forcer l'écriture des blocs internes du fichier catalogue, dans le cadre d'une optimisation paramétrée dans la carte CFTCAT, via le paramètre OPTIMIZE (voir les fonctionnalités de ce paramètre au chapitre "CFTCAT - Paramètres de gestion du catalogue"). L'utilisateur peut ainsi visualiser les transferts à l'aide des utilitaires CFTUTIL et CFTINT.

8.4.1. Syntaxe FLUSH [TYPE [NAME

CFT V2.3

= CAT,] = valeur]

8-3

Les commandes d’administration du moniteur CFT

8.4.2. Paramètres [TYPE

= CAT]

Type de fichier, CAT pour catalogue. [NAME

= valeur]

Nom du catalogue. La valeur par défaut est la valeur du catalogue courant telle que définie dans la carte CFTCAT.

8-4

CFT V2.3

A. La compression

A.1. La compression La compression est liée au protocole. Certains protocoles supportent un ou plusieurs types de compression, identifiés par une valeur ‘cpr’. Le tableau suivant décrit les protocoles supportant la compression. Tableau 72. Protocoles et compression Protocoles

Compression

Etebac 3 ODETTE PeSIT D profil CFT PeSIT D profil Extern PeSIT E PeSIT profil SIT

Utilisable hors norme OUI OUI OUI OUI Non pertinent

A.1.1. Compression en protocole PeSIT “hors SIT” En protocole PeSIT, quatre types de compression peuvent être utilisés, décrits dans le tableau suivant. Tableau 73. Protocole PeSIT - Types de compression Type de compression

Valeur CFT

Compression d’une suite de caractères “espace” EBCDIC Compression d’une suite de caractères identiques (compression horizontale) Compactage de caractères Ce compactage ne s’applique qu’à des caractères EBCDIC (chiffres convertis en BCD, caractère “espace”) Compression verticale, par rapport aux caractères de l’enregistrement précédent

01 02 04

08

Définition de la compression d’une suite de caractères “espace” (01) : une suite de 2 à 63 caractères blancs EBCDIC sera compressée sur 1 octet. Une suite de 64 à 139 caractères blancs sera compressée sur 2 octets. Définition de la compression horizontale (02) : dans le cas de PeSIT normalisé, une suite de 2 à 63 caractères identiques consécutifs sera compressée sur 2 octets. Mais en PeSIT D profil CFT et en PeSIT E entre deux moniteurs CFT, une suite de 2 à 31 caractères identiques sera compressée sur 2 octets et une suite de 32 à 287 caractères identiques sera compressée sur 3 octets. Définition du compactage de caractères (04) : deux caractères numériques EBCDIC consécutifs seront compactés dans un seul octet.

CFT V2.3

A-1

La compression

Définition de la compression verticale (08) : il s’agit de la compression par comparaison d’articles consécutifs. Le premier article n’est jamais compressé. A partir du deuxième, une comparaison est effectuée par rapport à l’article précédent pour repérer des chaînes de caractères identiques. Deux chaînes de caractères sont considérées comme identiques si elles contiennent la même série de caractères et si elles sont situées à la même position de l’enregistrement. La valeur de la compression ‘cpr’ est le résultat de la somme des divers types de compression souhaités, parmi ceux autorisés pour les différents profils. Les valeurs ‘cpr’ possibles sont donc : •

0, 2, 8 et 10 en protocole PeSIT D Extern (Hors SIT) et PeSIT E (standard). Ces valeurs correspondent respectivement aux valeurs 0, 1, 2, 3 de la codification du GSIT, soit au maximum à une compression des caractères identiques (y compris les blancs) et une compression verticale,

•

toutes les valeurs de 0 à 15 en protocole PeSIT D profil CFT et en PeSIT E entre deux CFT : ‘cpr’ est le résultat d’un “et logique” entre les valeurs des types de compression choisis.

La compression peut être précisée dans 3 types de commandes CFT : •

CFTPROT

: définition du protocole (paramètres RCOMP et SCOMP),

•

CFTSEND/CFTRECV

: définition des fichiers type (paramètre NCOMP),

•

SEND/RECV

: émission/réception de fichiers (paramètre NCOMP).

En émission (ou en réception), le moniteur contrôle la valeur du paramètre NCOMP de la commande CFTSEND (ou CFTRECV), par rapport à la compression autorisée du protocole par le paramètre SCOMP (ou RCOMP) de la commande CFTPROT). La valeur de la compression finalement retenue par CFT est le résultat d’un “et logique”, bit à bit entre les valeurs précisées dans les commandes CFTPROT, CFTSEND/CFTRECV et SEND/RECV. Exemple : en profil CFT : - CFTPROT RCOMP = 13, ...

(1101 soit 1+4+8)

- CFTSEND/CFTRECV .... , (la valeur par défaut est 15)

(1111 soit 1+2+4+8)

- RECV/SEND ..., NCOMP = 7, ...

(0111 soit 1+2+4)

CFT retient la valeur 5 pour la compression du fichier. La valeur obtenue sert de base à la négociation avec le partenaire, au début du transfert. De plus, la compression est négociée entre les partenaires, et celle effectivement utilisée lors du transfert correspondra aux types de compression prévus par les deux partenaires.

A-2

CFT V2.3

Manuel de référence

Par exemple, si un partenaire demande une compression horizontale et l’autre partenaire une compression verticale, aucune compression ne sera effectuée lors des transferts. Par contre, si un partenaire demande une compression horizontale et une compression verticale et que l’autre partenaire souhaite une compression verticale, les transferts se feront en utilisant la compression verticale. Chaque paramètre SCOMP, RCOMP et NCOMP a une valeur par défaut, selon les profils, indiquée dans le tableau suivant. Tableau 74. Protocole PeSIT - Valeurs par défaut PeSIT D profil Extern

PeSIT D profil CFT

PeSIT E (standard)

PeSIT E (CFT/CFT)

10

15

10

15

A.1.2. Compression en protocole ODETTE Seules deux valeurs sont possibles pour ‘cpr’ : •

0 : pas de compression,

•

1 : compression de données.

La compression est négociée avec le partenaire lors de la phase de connexion protocolaire, selon la valeur du paramètre SCOMP/RCOMP de la commande CFTPROT. Les paramètres SCOMP et RCOMP comportent une valeur par défaut qui est 1. Le paramètre NCOMP agit uniquement en émission (SEND) et sert à inhiber éventuellement la compression, lors de cette émission, si elle avait négociée à 1 (SCOMP / RCOMP à 1) lors de la phase de connexion.

A.1.3. Compression en protocole ETEBAC Protocolairement, les données en ligne ne doivent pas être compressées (ETEBAC3 n’offre pas de compression normalisée). Entre deux moniteurs CFT, il est néanmoins possible d’appliquer une compression en ligne, à condition que les deux partenaires appliquent la même valeur de compression, car aucune négociation n’est réalisée. Les valeurs référençant les algorithmes de compression utilisables, sont les mêmes que celles définies pour PeSIT D profil CFT (0 à 15).

CFT V2.3

A-3

B. NTYPE émis par défaut

B.1. Valeur par défaut du NTYPE émis Le tableau suivant indique la valeur par défaut du NTYPE émis, déterminée d’après :

CFT V2.3

•

le type du fichier local (valeur du FTYPE),

•

le système destinataire (indiqué dans le paramétrage local de l’émetteur : CFTPART SYST =).

B-1

NTYPE émis par défaut

Tableau 75. CFTSEND/SEND - Valeur du NTYPE pour les systèmes émetteurs et destinataires NTYPE implicitement envoyé vers (SYST =) : GCOS7 Emetteur

GCOS8

S

S

GCOS8 0 1 2 6 7 A T T

0 1 2 6 7 A T

OS400

UNIX

VMS

Autres

B-2

OS400

UNIX

VMS

Autres

FTYPE local

GCOS7

WinNT

WinNT

D E S Z B T V X O P F L R C

6

B B B B B B B T T T B T B B T B B B T V X T B T T T B B

E E E E D E S Z E E E E E E

B B B B B B B T T T B T B B T B B B T B T O B T T T B B

P P P P P P P P P P

P

P P P P P P F L R C P

CFT V2.3

C. Transcodage : tables internes, exemples

C.1. Tables internes

C.1.1. Table interne de correspondance des alphabets ASCII / EBCDIC Tableau 76. Correspondances ASCII / EBCDIC Caractère

Code décimal ASCII

Code hexa ASCII

Code hexa EBCDIC

SP !

00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33

00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E 1F 20 21

00 01 02 03 37 2D 2E 2F 16 05 25 0B 0C 0D 0E 0F 10 11 12 13 3C 3D 32 26 18 19 3F 27 1C 1D 1E 1F 40 5A

CFT V2.3

C-1

Transcodage : tables internes, exemples

Tableau 76. Correspondances ASCII / EBCDIC (suite)

C-2

Caractère

Code décimal ASCII

Code hexa ASCII

Code hexa EBCDIC

” # $ % & ’ ( ) * + , . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C D E F G H I J K L M N

34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78

22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F 30 31 32 33 34 35 36 37 38 39 3A 3B 3C 3D 3E 3F 40 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E

7F 7B 5B 6C 50 7D 4D 5D 5C 4E 6B 60 4B 61 F0 F1 F2 F3 F4 F5 F6 F7 F8 F9 7A 5E 4C 7E 6E 6F 7C C1 C2 C3 C4 C5 C6 C7 C8 C9 D1 D2 D3 D4 D5

CFT V2.3

Manuel de référence

Tableau 76. Correspondances ASCII / EBCDIC (suite) Caractère

Code décimal ASCII

Code hexa ASCII

Code hexa EBCDIC

O P Q R S T U V W X Y Z [ \ ] ^ _ ‘ a b c d e f g h i j k l m n o p q r s t u v w x y z

79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122

4F 50 51 52 53 54 55 56 57 58 59 5A 5B 5C 5D 5E 5F 60 61 62 63 64 65 66 67 68 69 6A 6B 6C 6D 6E 6F 70 71 72 73 74 75 76 77 78 79 7A

D6 D7 D8 D9 E2 E3 E4 E5 E6 E7 E8 E9 AD E0 BD 5F 6D 79 81 82 83 84 85 86 87 88 89 91 92 93 94 95 96 97 98 99 A2 A3 A4 A5 A6 A7 A8 A9

CFT V2.3

C-3

Transcodage : tables internes, exemples

Tableau 76. Correspondances ASCII / EBCDIC (suite) Caractère

Code décimal ASCII

Code hexa ASCII

Code hexa EBCDIC

{ | } ~

123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166

7B 7C 7D 7E 7F 80 81 82 83 84 85 86 87 88 89 8A 8B 8C 8D 8E 8F 90 91 92 93 94 95 96 97 98 99 9A 9B 9C 9D 9E AF A0 A1 A2 A3 A4 A5 A6

C0 6A D0 A1 07 80 DC 08 42 15 04 17 1A 52 53 0A 57 56 8D 8E 8F 90 1B 20 CB 21 22 DB 09 23 24 28 4A 9C 9D 9E 9F A0 29 2A 2B 2C 30 31

ü é â ä à ç ê ë è ï î

ô ö û ù

C-4

CFT V2.3

Manuel de référence

Tableau 76. Correspondances ASCII / EBCDIC (suite) Caractère

CFT V2.3

Code décimal ASCII

Code hexa ASCII

Code hexa EBCDIC

167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211

A7 A8 A9 AA AB AC AD AE AF B0 B1 B2 B3 B4 B5 B6 B7 B8 B9 BA BB BC BD BE BF C0 C1 C2 C3 C4 C5 C6 C7 C8 C9 CA CB CC CD CE CF D0 D1 D2 D3

33 34 35 AA 36 38 39 AE AF B0 B1 B2 FA B4 B5 B6 B7 B8 B9 BA 3A 3B 3E BE BC AB 41 43 44 BF 45 46 47 48 49 CA 4F CC CD CE CF 51 54 55 58

C-5

Transcodage : tables internes, exemples

Tableau 76. Correspondances ASCII / EBCDIC (suite) Caractère

C-6

Code décimal ASCII

Code hexa ASCII

Code hexa EBCDIC

212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255

D4 D5 D6 D7 D8 D9 DA DB DC DD DE DF E0 E1 E2 E3 E4 E5 E6 E7 E8 E9 EA EB EC ED EE EF F0 F1 F2 F3 F4 F5 F6 F7 F8 F9 FA FB FC FD FE FF

59 06 62 63 64 BB AC 65 66 DD DE DF 67 E1 68 69 70 71 72 73 74 75 EA EB EC ED EE EF 76 77 78 14 8A 8B 8C 9A 9B B3 DA FB FC FD FE FF

CFT V2.3

Manuel de référence

C.1.2. Tables de transcodage internes à CFT Tableau 77. Transcodage ASCII vers EBCDIC en émission et réception 0 1 2 3 4 5 6 7 8 9 A B C D E F 00010203372d2e2f1605250b0c0d0e0f 101112133c3d322618193f271c1d1e1f 405a7f7b5b6c507d4d5d5c4e6b604b61 f0f1f2f3f4f5f6f7f8f97a5e4c7e6e6f 7cc1c2c3c4c5c6c7c8c9d1d2d3d4d5d6 d7d8d9e2e3e4e5e6e7e8e9ade0bd5f6d 79818283848586878889919293949596 979899a2a3a4a5a6a7a8a9c06ad0a114 80dc08421504171a52530a57568d8e8f 901b20cb2122db092324284a9c9d9e9f a0292a2b2c3031333435aa363839aeaf b0b1b2fab4b5b6b7b8b9ba3a3b3ebebc ab414344bf4546474849ca4fcccdcecf 515455585906626364bbac6566dddedf 67e16869707172737475eaebecedeeef 767778078a8b8c9a9bb3dafbfcfdfeff

00...0F 10...1F 20...2F 30...3F 40...4F 50...5F 60...6F 70...7F 80...8F 90...9F A0...AF B0...BF C0...CF D0...DF E0...EF F0...FF

Tableau 78. Transcodage EBCDIC vers ASCII en émission et en réception 0 1 2 3 4 5 6 7 8 9 A B C D E F 000102038509d5f382978a0b0c0d0e0f 101112137f840886181987911c1d1e1f 92949598990a171b9aa1a2a3a4050607 a5a616a7a8a9ab04acadbbbc1415bd1a 20c183c2c3c5c6c7c8c99b2e3c282bcb 26d08889d1d28c8bd3d421242a293b5e 2d2fd6d7d8dbdce0e2e37c2c255f3e3f e4e5e6e7e8e9f0f1f2603a2340273d22 80616263646566676869f4f5f68d8e8f 906a6b6c6d6e6f707172f7f89c9d9e9f a07e737475767778797aaac0da5baeaf b0b1b2f9b4b5b6b7b8b9bad9bf5dbec4 7b414243444546474849ca93cccdcecf 7d4a4b4c4d4e4f505152fa9681dddedf 5ce1535455565758595aeaebecedeeef 30313233343536373839b3fbfcfdfeff

CFT V2.3

00...0F 10...1F 20...2F 30...3F 40...4F 50...5F 60...6F 70...7F 80...8F 90...9F A0...AF B0...BF C0...CF D0...DF E0...EF F0...FF

C-7

Transcodage : tables internes, exemples

C.2. Exemples de transcodage

C.2.1. Exemple de transcodage d’un alphabet réduit Ces tables définissent un transcodage ASCII / EBCDIC des seuls caractères ASCII 7 bits, en ignorant les autres caractères (07 correspond au caractère en EBCDIC, 7f correspond au caractère en ASCII). Tableau 79. Transcodage ASCII vers EBCDIC en émission 0 1 2 3 4 5 6 7 8 9 A B C D E F 0707070707070707070725070c0d0707 07070707070707070707070707070707 405a7f7b5b6c507d4d5d5c4e6b604b61 f0f1f2f3f4f5f6f7f8f97a5e4c7e6e6f 7cc1c2c3c4c5c6c7c8c9d1d2d3d4d5d6 d7d8d9e2e3e4e5e6e7e8e9ade0bd5f6d 79818283848586878889919293949596 979899a2a3a4a5a6a7a8a9c06ad0a107 07070707070707070707070707070707 07070707070707070707070707070707 07070707070707070707070707070707 07070707070707070707070707070707 07070707070707070707070707070707 07070707070707070707070707070707 07070707070707070707070707070707 07070707070707070707070707070707

00...0F 10...1F 20...2F 30...3F 40...4F 50...5F 60...6F 70...7F 80...8F 90...9F A0...AF B0...BF C0...CF D0...DF E0...EF F0...FF

Tableau 80. Transcodage ASCII vers EBCDIC en réception 0 1 2 3 4 5 6 7 8 9 A B C D E F 7f7f7f7f7f7f7f7f7f7f7f7f0c0d7f7f 7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f 7f7f7f7f7f0a7f7f7f7f7f7f7f7f7f7f 7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f 207f7f7f7f7f7f7f7f7f7f2e3c282b7f 267f7f7f7f7f7f7f7f7f21242a293b5e 2d2f7f7f7f7f7f7f7f7f7c2c255f3e3f 7f7f7f7f7f7f7f7f7f603a2340273d22 7f6162636465666768697f7f7f7f7f7f 7f6a6b6c6d6e6f7071727f7f7f7f7f7f 7f7e737475767778797a7f7f7f5b7f7f 7f7f7f7f7f7f7f7f7f7f7f7f7f5d7f7f 7b4142434445464748497f7f7f7f7f7f 7d4a4b4c4d4e4f5051527f7f7f7f7f7f 5c7f535455565758595a7f7f7f7f7f7f 303132333435363738397f7f7f7f7f7f

C-8

00...0F 10...1F 20...2F 30...3F 40...4F 50...5F 60...6F 70...7F 80...8F 90...9F A0...AF B0...BF C0...CF D0...DF E0...EF F0...FF

CFT V2.3

D. Fichier statistique des transferts : structures

D.1. Le fichier statistique des transferts D.1.1. Structure des données en langage C typedef { char char char

struct mode direct type

; ; ;

char char char char char char char char char char char char char char char char char char char

part[8+1] spart[8+1] rpart[8+1] suser[15+1] ruser[15+1] idf[8+1] ida[8+1] idt[8+1] nbr[10+1] fbyte[10+1] nbyte[10+1] dated[8+1] timed[8+1] dateb[8+1] timeb[8+1] datee[8+1] timee[8+1] ttime[6+1] diftyp

; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ;

char char char char

prot[8+1] ; userid[15+1] ; groupid[15+1]; crate[2+1] ;

char char

flrecl[5+1] frecfm

; ;

char char char char char char

ncomp[2+1] fname[64+1] parm[80+1] sappl[48+1] rappl[48+1] group[8+1]

; ; ; ; ; ;

/* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /*

S ou R ( Server or Requester ) S ou R ( Send or Receive ) F ou M ou R ( File or MSG or Reply) Partner File sender partner File receiver partner File sender user File receiver user Logic File Identifier Application identifier (local id.) Transfer Identifier Transmitted records Transmitted user data (before compr.) Transmitted user data (after compr.) Date command catalog AAAAMMJJ Time command catalog HHMMSSCC Date begin transfer AAAAMMJJ Time begin transfer HHMMSSCC Date end transfer AAAAMMJJ Time end transfer HHMMSSCC Transfer Time (en sec) Transfer type : N : Single transfer D : Member of diffusion list Protocol Identifier (cf ID for CFTPROT) User Identifier Group Identifier Rate Compression nn : value 00 : cf NCOMP Record Size File record format (cf FRECFM for CFTSEND or CFTRECV Compression File Name Private parameter File appl sender File appl receiver Partner Group

*/ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */

} mgrcnT;

CFT V2.3

D-1

Fichier statistique des transferts : structures

D.1.2. Structure des données en langage COBOL 01

STAT-T.

05 S-MODE PIC X. * S OU R ( SEND OR RECEIVE ) 05 S-DIRECT PIC X. * F OU M OU R ( FILE OR MSG OR REPLY) 05 S-TYPE PIC X. * PARTNER 05 S-PART PIC X(08). 05 FILLER PIC X. * FILE SENDER PARTNER 05 S-SPART PIC X(08). 05 FILLER PIC X. * FILE RECEIVER PARTNER 05 S-RPART PIC X(08). 05 FILLER PIC X. * FILE SENDER USER 05 S-SUSER PIC X(15). 05 FILLER PIC X. * FILE RECEIVER USER 05 S-RUSER PIC X(15). 05 FILLER PIC X. * LOGIC FILE IDENTIFIER 05 S-IDF PIC X(08). 05 FILLER PIC X. * APPLICATION IDENTIFIER (LOCAL ID.) 05 S-IDA PIC X(08). 05 FILLER PIC X. * TRANSFER IDENTIFIER 05 S-IDT PIC X(08). 05 FILLER PIC X. * TRANSMITTED RECORDS 05 S-NBR PIC 9(10). 05 FILLER PIC X. * TRANSMITTED USER DATA (BEFORE COMPR.) 05 S-FBYTE PIC 9(10). 05 FILLER PIC X. * TRANSMITTED USER DATA (AFTER COMPR.) 05 S-NBYTE PIC 9(10). 05 FILLER PIC X. * DATE COMMAND CATALOG AAAAMMJJ 05 S-DATED PIC X(08). 05 FILLER PIC X. * TIME COMMAND CATALOG HHMMSSCC 05 S-TIMED PIC X(08). 05 FILLER PIC X. * DATE BEGIN TRANSFER AAAAMMJJ 05 S-DATEB PIC X(08). 05 FILLER PIC X. * TIME BEGIN TRANSFER HHMMSSCC

D-2

* * *

*

*

*

*

*

*

*

*

*

*

*

*

*

*

CFT V2.3

Manuel de référence

05 S-TIMEB PIC X(08). 05 FILLER PIC X. * DATE END TRANSFER 05 S-DATEE PIC X(08). 05 FILLER PIC X. * TIME END TRANSFER 05 S-TIMEE PIC X(08). 05 FILLER PIC X.

AAAAMMJJ

*

HHMMSSCC

*

* TRANSFER TIME (EN SEC) 05 S-TTIME PIC 9(6). 05 FILLER PIC X. * TRANSFER TYPE : * N : SINGLE TRANSFER * D : MEMBER OF DIFFUSION LIST 05 S-DIFTYP PIC X. * PROTOCOLE IDENTIFIER (CF ID FOR CFTPROT) 05 S-PROT PIC X(08). 05 FILLER PIC X. * USER IDENTIFIER 05 S-USERID PIC X(15). 05 FILLER PIC X. * GROUP IDENTIFIER 05 S-GROUPID PIC X(15). 05 FILLER PIC X. * RATE COMPRESSION * NN : VALUE * 00 : CF S-NCOMP 05 S-CRATE PIC 9(02). 05 FILLER PIC X. * RECORD SIZE 05 S-FLRECL PIC 9(5). 05 FILLER PIC X. * FILE RECORD FORMAT * (CF FRECFM FOR CFTSEND OR CFTRECV) 05 S-FRECFM PIC X.

*

* COMPRESSION NEGOCIEE 05 S-NCOMP PIC 9(02). 05 FILLER PIC X. * FILE NAME 05 S-FNAME PIC X(64). 05 FILLER PIC X. * PRIVATE PARAMETER 05 S-PARM PIC X(80). 05 FILLER PIC X. * FILE APPLICATION SENDER 05 S-SAPPL PIC X(48). 05 FILLER PIC X. * FILE APPLICATION RECEIVER 05 S-RAPPL PIC X(48). 05 FILLER PIC X.

*

01

CFT V2.3

* * * *

*

*

* *

*

* *

*

*

*

*

STAT-CONTROL-BLOCK.

D-3

Fichier statistique des transferts : structures

* S OU R ( SERVER OR REQUESTER ) 05 S_MODE PIC X. * S OU R ( SEND OR RECEIVE ) 05 S_DIRECT PIC X. * F OU M OU R ( FILE OR MSG OR REPLY) 05 S_TYPE PIC X.

*

* PARTNER 05 S_PART PIC 05 FILLER PIC * FILE SENDER PARTNER 05 S_SPART PIC 05 FILLER PIC * FILE RECEIVER PARTNER 05 S_RPART PIC 05 FILLER PIC

*

*

X(08). X. * X(08). X. * X(08). X.

* FILE SENDER USER 05 S_SUSER PIC X(15). 05 FILLER PIC X. * FILE RECEIVER USER 05 S_RUSER PIC X(15). 05 FILLER PIC X. * LOGIC FILE IDENTIFIER 05 S_IDF PIC X(08). 05 FILLER PIC X. * APPLICATION IDENTIFIER (LOCAL ID.) 05 S_IDA PIC X(08). 05 FILLER PIC X. * TRANSFER IDENTIFIER 05 S_IDT PIC X(08). 05 FILLER PIC X. * TRANSMITTED RECORDS 05 S_NBR PIC 9(10). 05 FILLER PIC X. * TRANSMITTED USER DATA (BEFORE COMPR.) 05 S_FBYTE PIC 9(10). 05 FILLER PIC X. * TRANSMITTED USER DATA (AFTER COMPR.) 05 S_NBYTE PIC 9(10). 05 FILLER PIC X. * DATE COMMAND CATALOG AAAAMMJJ 05 S_DATED PIC X(08). 05 FILLER PIC X. * TIME COMMAND CATALOG HHMMSSCC 05 S_TIMED PIC X(08). 05 FILLER PIC X. * DATE BEGIN TRANSFER AAAAMMJJ 05 S_DATEB PIC X(08). 05 FILLER PIC X. * TIME BEGIN TRANSFER HHMMSSCC 05 S_TIMEB PIC X(08). 05 FILLER PIC X. * DATE END TRANSFER AAAAMMJJ 05 S_DATEE PIC X(08).

D-4

*

*

*

*

*

*

*

*

*

*

*

*

*

*

CFT V2.3

Manuel de référence

05 FILLER PIC X. * TIME END TRANSFER HHMMSSCC 05 S_TIMEE PIC X(08). 05 FILLER PIC X. * TRANSFER TIME (EN SEC) 05 S_TTIME PIC 9(6). 05 FILLER PIC X. * TRANSFER TYPE : * N : SINGLE TRANSFER * D : MEMBER OF DIFFUSION LIST 05 S_DIFTYP PIC X. * PROTOCOLE IDENTIFIER (CF ID FOR CFTPROT) 05 S_PROT PIC X(08). 05 FILLER PIC X. * USER IDENTIFIER 05 S_USERID PIC X(15). 05 FILLER PIC X. * RATE COMPRESSION * NN : VALUE * 00 : CF S_NCOMP 05 S_CRATE PIC 9(02). 05 FILLER PIC X. * RECORD SIZE 05 S_FLRECL PIC 9(5). 05 FILLER PIC X. * FILE RECORD FORMAT * (CF FRECFM FOR CFTSEND OR CFTRECV) 05 S_FRECFM PIC X. * COMPRESSION NEGOCIEE 05 S_NCOMP PIC 9(02). 05 FILLER PIC X. * FILE NAME 05 S_FNAME PIC X(64). 05 FILLER PIC X. * PRIVATE PARAMETER 05 S_PARM PIC X(80). 05 FILLER PIC X. * FILE APPLICATION SENDER 05 S_SAPPL PIC X(48). 05 FILLER PIC X. * FILE APPLICATION RECEIVER 05 S_RAPPL PIC X(48). 05 FILLER PIC X.

CFT V2.3

*

*

* * * *

*

* *

*

* * *

*

*

*

*

D-5

E. CFTCATAL

E.1. Définition CFTCATAL est un utilitaire de déchargement/rechargement du catalogue CFT. Disponible sur toutes les plates-formes en CFT V222 et supérieure, il est utilisé pour redimensionner le catalogue.

E.2. Fonctionnement Après arrêt du moniteur, l’utilitaire déclenche le traitement suivant : •

le déchargement du catalogue sur un fichier temporaire,

•

la suppression du fichier catalogue,

•

la création du nouveau catalogue avec éventuellement de nouvelles caractéristiques (redimensionnement par exemple),

•

le rechargement du catalogue à partir du fichier temporaire,

•

la suppression du fichier temporaire.

E.3. Mode d’utilisation L’utilitaire est livré sous forme de procédure à laquelle on passe des paramètres de traitement. Attention : avant de lancer l’utilitaire, il est recommandé de sauvegarder le fichier catalogue. 1. Arrêter CFT. 2. Taper CFTCATAL pour activer l’utilitaire. 3. Entrer les paramètres de traitement et faites ENTREE. 4. Taper : •

le nom du fichier catalogue,

•

le nombre d’enregistrements.

5. Redémarrer le moniteur si le traitement s’est bien déroulé.

CFT V2.3

E-1

F. Structure du fichier de configuration

F.1. Introduction Le fichier de configuration est un fichier de type texte. Il contient des lignes de paramètres (un paramètre par ligne). Une ligne de commentaire doit débuter par un des trois caractères suivants : • "#" (dièse), • ";" (point-virgule), • "*" (étoile).

F.2. Paramètres obligatoires TYPE

= {FILE | MAILBOX | TCP }

Type de communication concerné. NAME

= MediaName

Nom du média de communication. Suivant le type de comunication, il s'agit : • soit du nom du fichier de communication, • soit du nom de la mailbox, • soit du nom complet du canal de communication TCP/IP ("protocol://host:port"). Pour un canal de communication de type TCP/IP (TYPE=TCP), la connexion avec le moniteur distant est établie en retour de l'appel au verbe COM : • le champ protocol désigne le protocole mis en œuvre sur la couche TCP/IP (paramètre PROTOCOL de la commande CFTCOM). Le protocole doit être conforme à celui déclaré côté moniteur, • le champ host désigne le nom de host ou l’adresse IP de la machine sur laquelle s’exécute le moniteur à joindre (localhost pour une communication interne à la machine uniquement), • le champ port désigne le port d’écoute du moniteur à joindre.

CFT V2.3

F-1

Structure du fichier de configuration

F.3. Paramètres facultatifs pour TYPE=TCP [LOWPORT

= {5000,n}]

Borne inférieure (valeur incluse) de la plage de ports locaux. [HIGHPORT

= {65535,n}]

Borne supérieure (valeur incluse) de la plage de ports locaux. En l’absence des instructions LOWPORT et HIGHPORT, on recherche le premier port local libre entre 5000 et 65535. [PROXY

= proxy]

Présence d'un proxy entre l’application et le moniteur CFT. La syntaxe complète est : proxy_protocol://host_proxy:port_proxy, où : • proxy_protocol : protocole à mettre en œuvre avec le proxy (protocoles supportés SOCKS4 et HTTP), • host_proxy : nom de host ou adresse IP du proxy à traverser, • port_proxy : port d’écoute du proxy à traverser.

F.4. Exemples de fichiers Exemples de fichier de configuration de l’API : ; CFT APIs CONFIGURATION FILE ; FILE COMMUNICATION TYPE=FILE NAME=$CFTCOM ; CFT APIs CONFIGURATION FILE ; TCP/IP COMMUNICATION TYPE=TCP NAME=xhttp://localhost:5001 LOWPORT=5000 HIGHPORT=5050 PROXY=socks4://proxy:8080

F-2

CFT V2.3

G.

Fichier de configuration de l'API de suivi Sentinel

G.1. Introduction L'activation du suivi se fait : • à travers le fichier de configuration de l'API de suivi, • dans les commandes du moniteur. Pour plus d'informations sur ce dernier cas, reportez-vous : -

aux paramètres TRKPART,TRKSEND, TRKRECV de la commande CFTPARM,

-

aux paramètres TRK des commandes CFTPART, CFTSEND/CFTRECV et SEND/RECV.

Le fichier de configuration est analysé au démarrage du moniteur et les paramètres qui ne lui sont pas destinés sont ignorés. Le nom et la localisation de ce fichier dépendent du système. Pour faciliter la migration, il est possible de modifier ce fichier sans changer la configuration du moniteur. Le fichier de configuration est un fichier de type texte. Il contient des lignes de paramètres (un paramètre par ligne). Une ligne de commentaire débute par un "#" (dièse) en première colonne. Attention :ce fichier de configuration n'existe qu'à partir de la version CFT V231.

G.2. Paramètres Les paramètres à renseigner sont les suivants. PRODUCTNAME

= string

Nom de l’application utilisant TRKUTIL. TRKMODELDIR

= string

Chemin d'accès complet des fichiers modèles de message au format XML. TRKMODELEVENT = string Nom du fichier modèle des messages au format XML. TRKMODELLINK

= string

Nom du fichier modèle des « Cycle Link » au format XML. TRKIPADDR

= string

Adresse IP du Serveur Sentinel.

CFT V2.3

G-1

Fichier de configuration de l'API de suivi Sentinel

TRKIPPORT

= string

Numéro de port du Serveur Sentinel. TRKTNAME

= string

Chemin d'accès et nom du fichier tampon. TRKLOCALADDR

= string

Adresse locale du moniteur XFB. TRKIPADDR

= string

Adresse du serveur Sentinel de back-up. TRKIPBRT

= string

Numéro de port du Serveur Sentinel de back-up. TRACE

= string

Paramètre de trace. TRKGMTDIFF = n Différence (en minutes) entre l’heure locale et l’heure universelle (GMT). XFB.Sentinel = {NO | YES} Activation du suivi Sentinel. Les instructions suivantes sont prises en compte uniquement si le suivi Sentinel est activé. XFB.Log = { mask(IWEF) } Activation du suivi de la classe XFB.Log et choix du type de message à envoyer au serveur Sentinel. Sa valeur est une combinaison de : • I pour Information, • W pour Attention, • E pour Erreur, • F pour Fatale. Par exemple, si XFB.Log = EF, le suivi ne s'effectue que sur les messages d’erreur. Ce paramètre n'est pris en compte que si le suivi Sentinel est activé. En l’absence du paramètre ou de sa valeur, la classe XFB.Log n’est pas suivie

G-2

CFT V2.3

Manuel de référence

XFB.Transfer = { ALL| NO | SUMMARY} Activation du suivi de la classe XFB.Transfer. Ce paramètre indique : • NO

pas de suivi,

• ALL du transfert,

si le suivi doit être complet avec notification à chaque changement d'état

• SUMMARY si le suivi doit être réduit avec notification uniquement à la création et à la fin du transfert, Ce paramètre n'est pris en compte que si le suivi Sentinel est activé. En l’absence du paramètre ou de sa valeur, la classe XFB.Transfer n’est pas suivie.

G.3. Exemple de fichier Exemple de fichier de configuration de l’API de suivi. # CONFIGURATION FILE # # Nom de l’application utilisant TRKUTIL PRODUCTNAME=API-SCRIPT # Chemin complet des fichiers modèles de message au format # XML TRKMODELDIR=c:\cft231\xml # Nom du fichier modèle des messages au format XML TRKMODELEVENT=trkevent.xml # Nom du fichier modèle des « Cycle Link » au format XML TRKMODELLINK=trklinkcycle.xml # Adresse IP du Serveur Sentinel TRKIPADDR=127.0.0.0 # Numéro de port du Serveur Sentinel TRKIPPORT=13039 # Chemin et nom du fichier tampon TRKTNAME=trktam.txt # Adresse locale du moniteur XFB TRKLOCALADDR=localhost # Adresse du serveur Sentinel de back-up # Numéro de port du Serveur Sentinel de back-up # Paramètre de trace # Différence (en minutes) entre l’heure locale et l’heure # universelle (GMT) TRKGMTDIFF = 60

CFT V2.3

G-3

&SPART variable symbolique,3-5, 3-6, 3-7, 4-17, 4-27, 4-41, 4-53 &SUSER variable symbolique,3-5, 3-6, 3-7, 4-17, 4-26, 4-27, 4-41, 4-53 &USERID variable symbolique,3-5, 3-6, 3-7

Index

A

& &BDATE variable symbolique,4-17, 4-27, 4-41, 4-53 &BDAY variable symbolique,4-17, 4-27, 4-41, 4-53 &BMONTH variable symbolique,4-17, 4-27, 4-41, 4-53 &BTIME variable symbolique,4-17, 4-27, 4-41, 4-53 &BYEAR variable symbolique,4-17, 4-27, 4-41, 4-53 &DIAGI variable symbolique,3-6 &DIAGP variable symbolique,3-6 &FACCNT variable symbolique,8-1 &FDATE variable symbolique,4-17, 4-27, 4-41, 4-53 &FDAY variable symbolique,4-17, 4-27, 4-41, 4-53 &FLOG variable symbolique,8-1 &FMONTH variable symbolique,4-17, 4-27, 4-41, 4-53 &FPATH variable symbolique,7-16 &FREF variable symbolique,7-16 &FROOT variable symbolique,7-16 &FSUF variable symbolique,7-16 &FTIME variable symbolique,4-17, 4-27, 4-41, 4-53 &FUNIT variable symbolique,7-16 &FYEAR variable symbolique,4-17, 4-27, 4-41, 4-53 &GROUP variable symbolique,3-5, 3-6, 3-7, 4-17, 4-27, 4-41, 4-53, 6-3 &IDA variable symbolique,4-17, 4-27, 4-41, 4-53 &IDF variable symbolique,3-5, 3-6, 4-17, 4-27, 4-36, 4-41, 4-53 &IDM variable symbolique,3-5, 3-7 &IDT variable symbolique,4-27, 4-41, 4-53, 4-56, 7-10 commande SEND,7-10 &IDTU variable symbolique,4-41 &NFNAME variable symbolique,4-27, 4-41, 4-53 &NFVER variable symbolique,4-41 &NIDF variable symbolique,3-5, 3-6, 4-17, 4-27, 4-41, 4-53 &NPART variable symbolique,4-17, 4-27, 4-41, 4-53 &PARM variable symbolique,3-5, 3-6, 3-7, 4-17, 4-27, 4-41, 4-53 &PART variable symbolique,3-5, 3-6, 3-7, 4-17, 4-26, 4-27, 4-41, 4-53, 4-56 &RAPPL variable symbolique,3-5, 3-6, 3-7, 4-17, 4-27, 4-41, 4-53 &RPART variable symbolique,3-5, 3-6, 3-7, 4-17, 4-27, 4-41, 4-53 &RUSER variable symbolique,3-5, 3-6, 3-7, 4-17, 4-26, 4-27, 4-41, 4-53 &SAPPL variable symbolique,3-5, 3-6, 3-7, 4-17, 4-27, 4-41, 4-53

CFT V2.3

ABOUT commande,8-2 ACB paramètre commande CFTNET TYPE = SNA,5-10 ACB paramètre,5-10 ACCNT paramètre,3-3 commande CFTPARM,3-3 Acquittement de transfert,7-9 ACT ID,7-37, 7-38 MODE,7-37, 7-38 TYPE,7-37, 7-38 Action sur les transferts,7-22 Activation d’un transfert,1-6 AFNAME paramètre,3-23, 3-31 commande CFTACCNT,3-31 commande CFTLOG,3-23 APPCYCID paramètre,7-3, 7-14 commande RECV,7-14 commande SEND TYPE = FILE,7-3 APPCYCID paramètre commande SEND,7-3 APPOBJID paramètre,7-3, 7-14 commande RECV,7-14 commande SEND,7-3 TYPE = FILE,7-3 Arrêt,1-7 d’un transfert,1-7 commande HALT,1-7 Voir aussi Action sur les transferts de CFT commande SHUT,8-1 ASCII Voir Codes ASY valeur,2-27 ASY valeur,5-1 AX25MBX paramètre,5-19, 5-22 commande CFTNET TYPE = X25,5-19, 5-22

B Basculement des fichiers de suivi commande SWITCH,8-1 Boîte aux lettres Voir Communication, par boîte aux lettres (mailbox) BUFSIZE paramètre,3-3 commande CFTPARM,3-3 GCOS8,3-3 valeurs par défaut,3-3

Index-1

Index

C CACHE paramètre,3-20 commande CFTCAT,3-20 CALL paramètre commande CFTNET,5-2 CALL paramètre,5-2 Caractéristiques,4-35 de la machine commande ABOUT,8-2 des fichiers,4-35 généraux,4-35 valeurs par défaut,4-35 commande CFTRECV,4-35 CAT paramètre,3-3 commande CFTPARM,3-3 Catalogue,2-12 CFT,1-5 gestion du,3-19 postes du,2-12 listes,2-12 suppression,1-5, 1-7 commande DELETE,1-7 CFTACCNT commande,3-28, 8-2 CFTASY commande,1-3, 6-32 CFTAUTH commande,4-60 CFTCAT commande,3-19 CFTCATAL,E-1, F-1 CFTCOM commande,3-16 CFTDEST commande,6-10 CFTDNA commande,1-3, 6-16 VMS,6-16 CFTDSA commande,1-3, 6-17 GCOS6,6-17 GCOS7,6-17 GCOS8,6-17 CFTEXIT commande,4-57 CFTEXT commande,2-9 CFTFILE commande,2-28 paramètres,2-30 syntaxe,2-29 CFTIDF commande,4-62 CFTLOG commande,3-22, 8-2 CFTLU62 commande,1-3, 6-30 CFTNET commande générique,5-2 TYPE = ASY,5-3 TYPE = DNA,5-5 TYPE = DSA,5-5 TYPE = LU62,5-7 TYPE = SNA,5-8 TYPE = TCP,5-14 TYPE = X25,5-18 CFTNET commande,5-1, 5-2 CFTPARM commande,3-1 CFTPART commande,6-1 STATE,6-8 CFTPROT command,5-23

Index-2

CFTPROT commande,5-22, 5-23 générique,5-23 TYPE = ETEBAC,5-30 TYPE = ODETTE,5-31 TYPE = PeSIT,5-34 CFTRECV commande,4-31 NOTIFY,4-46 paramètres,4-35 syntaxe,4-33 CFTSEND commande,4-1, 4-2 CFTSNA commande,1-3, 6-19 MVS,6-19 OS2,6-19 OS400,6-19 VM,6-19 VMS,6-19 CFTTCP commande,1-3, 6-25 GUARDIAN,6-25 MVS,6-25 UNIX,6-25 VMS,6-25 CFTUTIL Voir Commandes, de l’utilitaire CFTUTIL CFTX25 commande,1-3, 6-26 CFTXLATE commande,4-64 CFTXXX commande,6-13 CIPHER paramètre,2-30 commande CFTFILE,2-30 valeurs par défaut,2-30 CLASS paramètre,5-13, 5-20, 6-18, 6-20, 6-22, 6-27, 6-30, 6-32 commande CFTASY,6-32 commande CFTDSA,6-18 commande CFTLU62,6-30 commande CFTNET TYPE = ASY,5-3, 5-4 TYPE = DSA,5-6 TYPE = LU62,5-7 TYPE = SNA,5-13 TYPE = SNA,5-10, 5-11 TYPE = X25,5-20 commande CFTSNA,6-20, 6-22 commande CFTX25,6-27 CLASS paramètre,5-3, 5-4, 5-6, 5-7, 5-10, 5-11 Clé,3-8 de type CPU,3-8 de type DATE,3-8 de type IDF,3-8 de type LIBELLE,3-8 CLEARCMD commande,2-6 CNXIN paramètre,6-14, 6-30 commande CFTLU62,6-30 commande CFTXXX,6-14 CNXINOUT paramètre,6-14, 6-30 commande CFTLU62,6-30 commande CFTXXX,6-14 CNXOUT paramètre,6-15, 6-30 commande CFTLU62,6-30 commande CFTXXX,6-15

CFT V2.3

Manuel de référence Codes,4-64 ASCII,4-64 EBCDIC,4-64 COM paramètre,3-3 commande CFTPARM,3-3 COMMAND paramètre,2-6 COMMAND paramètre commande CLEARCMD,2-6 Commandes,1-1 ABOUT,8-2 ACT,7-37 paramètres,7-38 syntaxe,7-37 associées aux transferts,7-1 contrôle syntaxique,7-1 fichier,7-1 émission,7-1 commande SEND TYPE = FILE,7-1 réception,7-12 message,7-7, 7-9 émission,7-7, 7-9 commande SEND TYPE = MESSAGE,7-7 commande SEND TYPE = REPLY,7-9 de réponse,7-9 commande SEND TYPE = REPLY,7-9 syntaxe,1-6 CFTACCNT,3-28, 8-2 EXEC paramètre,8-2 paramètres,3-31 syntaxe,3-31 CFTASY,1-3, 6-32 CFTAUTH,4-60 paramètres,4-61 syntaxe,4-60 CFTCAT,3-19 paramètres,3-20 syntaxe,3-19 CFTCOM,3-16 MVS,3-16 paramètres,3-17 syntaxe,3-16 Win3.1,3-16 WinNT,3-16 CFTDEST,6-10 paramètres,6-11 syntaxe,6-11 CFTDNA,1-3, 6-16 paramètres,6-16 syntaxe,6-16 VMS,6-16 CFTDSA,1-3, 6-17 GCOS6,6-17 GCOS7,6-17 GCOS8,6-17 paramètres,6-18 syntaxe,6-17

CFT V2.3

Commandes (suite) CFTETB,5-43 paramètres,5-45 syntaxe,5-45 CFTEXIT,4-57 CFTEXT,2-9 paramètres,2-10 syntaxe,2-10 CFTFILE,2-28 GCOS8,2-31 OS400,2-29 CFTIDF,4-62 paramètres,4-63 syntaxe,4-63 CFTLOG,3-22, 8-2 EXEC paramètre,8-2 paramètres,3-23 syntaxe,3-23 CFTLU62,1-3, 6-30 CFTNET ASY valeur,5-1 LU62 valeur,5-1 paramètres,5-2 syntaxe,5-2 TYPE = ASY,5-3 TYPE = DNA syntaxe,5-5 TYPE = DNA,5-5 TYPE = DSA GCOS6,5-5 GCOS7,5-5 GCOS8,5-5 paramètres,5-6 syntaxe,5-6 TYPE = DSA,5-5 TYPE = LU62,5-7 TYPE = SNA MVS,5-8 OS2,5-8 OS400,5-8 paramètres côté HOST MVS,5-10 VM,5-10 côté HOST,5-10 côté PU type2 OS400,5-11 VMS,5-12 paramètres,5-10 syntaxe,5-9 VMS,5-8 TYPE = SNA,5-8 TYPE = TCP,5-14 GUARDIAN,5-14 MVS,5-14 paramètre,5-15 syntaxe,5-15 UNIX,5-14 VMS,5-14

Index-3

Index Commandes, CFTNET (suite) TYPE = X25,5-18 GCOS7,5-19 GCOS8,5-19 paramètres,5-18 syntaxe,5-18 CFTNET,5-1, 5-2 CFTPARM,3-1 paramètres,3-3 syntaxe,3-2 CFTPART,6-1 paramètres,6-2 syntaxe,6-1 CFTPROT,5-22, 5-23 paramètres,5-24 TYPE = ETEBAC,5-30 paramètres,5-31 syntaxe,5-31 TYPE = ODETTE,5-31 paramètres,5-32 TYPE = PeSIT,5-34 paramètres,5-36 syntaxe,5-35 CFTRECV,4-31 base VFM,4-55 paramètres,4-56 syntaxe,4-55 CFTSEND,4-1, 4-2 base VFM,4-29 paramètres,4-30 syntaxe,4-29 paramètres,4-5 syntaxe,4-2 CFTSNA,1-3, 6-19 MVS,6-19 OS2,6-19 OS400,6-19 paramètres,6-20 côté HOST,6-20 côté PU T2,6-22 syntaxe,6-19 VM,6-19 VMS,6-19 CFTTCP,1-3, 6-25 GUARDIAN,6-25 MVS,6-25 paramètres,6-25 syntaxe,6-25 UNIX,6-25 VMS,6-25 CFTX25,1-3, 6-26 paramètres,6-27 syntaxe,6-27 CFTXLATE,4-64 paramètres,4-66 syntaxe,4-65 CFTXXX,6-13 paramètres,6-14 syntaxe,6-14

Index-4

Commandes (suite) CLEARCMD,2-6 exemple,2-7 paramètres,2-6 syntaxe,2-6, 2-8 CONFIG,2-1 paramètres,2-4 syntaxe,2-4 contrôle syntaxique,1-5 Voir aussi Commandes, associées aux transferts COPYFILE,2-33 statistiques d’exécution,2-39 d’administration du moniteur CFT,8-1 commande ABOUT,8-2 commande SHUT,8-1 commande SWITCH,8-1 d’exploitation du moniteur CFT Voir Commandes, d’administration du moniteur CFT de l’utilitaire CFTUTIL,1-1 CFTEXT,1-1 CFTFILE,1-1 CONFIG,1-1 COPYFILE,1-1 LISTCAT,1-1 LISTPARM,1-1 LISTPART,1-1 WAIT,1-1 de paramétrage,3-1, 4-1, 6-1 liste,3-1, 4-1, 6-1 liste,5-1 syntaxe,1-4 de paramétrage,5-1 DELETE,1-7, 7-22 paramètres,7-22 syntaxe,7-22 END,1-7, 7-33 paramètres,7-33 syntaxe,7-33 HALT,1-7, 7-24 paramètres,7-24 syntaxe,7-24 INACT,7-36 paramètres,7-36 syntaxe,7-36 KEEP,1-7, 7-25, 7-26 paramètres,7-26 syntaxe,7-26 KSTATE,2-8 paramètres,2-9 LISTCAT,1-7, 2-12, 2-13 Voir aussi Action sur les transferts paramètres,2-13 syntaxe,2-13 LISTCOM,2-41 LISTPARM,2-25 paramètres,2-25 syntaxe,2-25

CFT V2.3

Manuel de référence Commandes (suite) LISTPART,2-26, 2-27 ASY valeur,2-27 LU62 valeur,2-27, 2-28 MQUERY,7-35 paramètres,7-35 syntaxe,7-35 PURGE,2-6 RECV,7-12 &FPATH variables symboliques,7-16 &FREF variables symboliques,7-16 &FROOT variables symboliques,7-16 &FSUF variables symboliques,7-16 &FUNIT variables symboliques,7-16 PeSIT profil SIT,7-12 syntaxe,7-13 SEND,7-1 réponse,7-9 TYPE = FILE,7-1 syntaxe,7-1 TYPE = MESSAGE,7-7 paramètres,7-8 PeSIT profil CFT,7-7 syntaxe,7-8 TYPE = REPLY,7-9 paramètres,7-10 syntaxe,7-10 SHUT,1-8, 8-1 paramètres,8-1 syntaxe,8-1 START,1-7, 7-27, 7-28, 7-29 paramètres,7-27, 7-29 syntaxe,7-27, 7-29 SUBMIT,1-7 SWITCH,1-8, 8-1 paramètres,8-2 syntaxe,8-2 WAIT,2-5 paramètres,2-5 syntaxe,2-5 WLOG,2-9 paramètres,2-9 syntaxe,2-9 COMMENT paramètre,3-4, 6-2 commande CFTPARM,3-4 commande CFTPART,6-2 Communication média de,1-8 Voir aussi Commandes, d’administration du moniteur CFT modes de,3-16 applications/moniteur,3-16 par boîte aux lettres (mailbox),2-4 Compression,A-1 ETEBAC3,A-3 ODETTE,A-3 PeSIT,A-1 CONCAT paramètre, 5-36 commande CFTPROT TYPE = PeSIT,5-36 PeSIT profil SIT,5-36

CFT V2.3

CONFIG commande,2-1 paramètre commande CFTNET TYPE = ASY,5-3 paramètre,5-3 CONFIG paramètre,6-32 commande CFTASY,6-32 commande CFTNET TYPE = ASY,5-4 CONFIG paramètre,5-4 Consultation Voir Utilitaire CFTUTIL CONTENT paramètre,2-13, 2-41 commande LISTCAT,2-13 commande LISTCOM,2-41 CONTENT paramètre,3-24 commande CFTLOG,3-24 Contrôle,1-6 des transferts,1-6 Voir aussi Action sur les transferts syntaxique des commandes,1-8 Voir aussi Commandes, d’administration du moniteur CFT Conventions typographiques,xvii description des commandes,xvii description des paramètres,xvii spécificités,xx, xxi, xxii valeurs,xix, xx Copie de fichier Voir Fichiers, copie de COPYFILE commande,2-33 paramètres,2-34 syntaxe,2-33 CPNAME paramètre,6-31 commande CFTLU62,6-31 CREATE paramètre,2-34 commande COPYFILE,2-34 CTLPASSW paramètre,3-4 commande CFTPARM,3-4 CTO paramètre commande CFTPROT TYPE = PeSIT,5-36 CTO paramètre,5-36 CYCDATE paramètre,4-5, 4-36 commande CFTRECV,4-36 commande CFTSEND,4-5 CYCLE paramètre,4-5, 7-14 commande CFTPROT TYPE = PeSIT,5-37 commande CFTSEND,4-5 commande RECV,7-14 CYCLE paramètre,5-37 CYCTIME paramètre,4-6, 4-36 commande CFTRECV,4-36 commande CFTSEND,4-6

D DATA paramètre,6-27, 6-32 commande CFTASY,6-32 commande CFTX25,6-27 DEFAULT paramètre,3-4 commande CFTPARM,3-4

Index-5

Index Définition,6-1 d’un partenaire Voir Partenaires, commande CFTPART d’une liste de partenaires Voir Partenaires, commande CFTDEST DELETE commande,1-7, 7-22 paramètre,4-2, 4-6, 4-33, 4-36 commande CFTRECV,4-33, 4-36 commande CFTSEND,4-2, 4-6 DIALNO paramètre,6-28, 6-32 commande CFTASY,6-32 commande CFTX25,6-28 DIRECT paramètre,2-13, 4-66, 5-45, 7-22, 7-24, 7-26, 7-27, 7-29, 7-33 commande CFTETB,5-45 commande CFTXLATE,4-66 commande DELETE,7-22 commande END,7-33 commande HALT,7-24 commande KEEP,7-26 commande LISTCAT,2-13 commande START,7-27, 7-29 DIRNB paramètre,4-33, 4-36 commande CFTRECV,4-33, 4-36 DISCTC paramètre commande CFTPROT TYPE = PeSIT,5-37 DISCTC paramètre,5-37 DISCTD paramètre,5-24, 5-26, 5-29 commande CFTPROT,5-24, 5-26, 5-29 DISCTR paramètre,5-37 commande CFTPROT TYPE = PeSIT,5-37 DISCTS paramètre commande CFTPROT ETEBAC3,5-24 ODETTE,5-24 PeSIT profil CFT,5-24 PeSIT profil EXTERN,5-24 PeSIT profil SIT,5-24 Données,4-31 réception des Voir Environnement des transferts, commande CFTRECV statistiques Voir Enregistrement des données statistiques liste des Voir Commandes, CFTACCNT stockage des Voir Environnement des transferts, commande CFTRECV DURING paramètre,2-5 commande CONFIG,2-5 DYNAM parameter,5-24 CFTPROT command,5-24 DYNAM paramètre,5-25 commande CFTPROT,5-25

Index-6

E EBCDIC Voir Codes EERP,3-4, 6-2 EERP paramètre,5-32 commande CFTPROT,5-32 TYPE = ODETTE,5-32 Emission,4-1 de fichier,1-5 Voir aussi Commandes, associées aux transferts de fichier type,4-1 description Voir Environnement des transferts de message,1-5 Voir aussi Commandes, associées aux transferts END commande,1-7, 7-33 Enregistrement des données statistiques,3-28 Environnement des transferts commande CFTRECV,4-31 Etats des transferts,1-7 ETEBAC Voir Protocoles, de transfert ETEBAC3 format de la carte,5-43 Voir aussi Protocoles, de transfert EXEC paramètre,3-24, 3-31, 4-6, 4-36, 6-11 commande CFTACCNT,3-31 commande CFTDEST,6-11 commande CFTLOG,3-24 commande CFTRECV,4-36 commande CFTSEND,4-6 EXECR paramètre commande CFTPARM,3-5 EXECRE paramètre,3-5 EXECRF paramètre,3-5 commande CFTPARM,3-5 EXECRM paramètre,3-5 commande CFTPARM,3-5 EXECSE paramètre,3-6 commande CFTPARM,3-6 EXECSF paramètre,3-6 commande CFTPARM,3-6 EXECSFA paramètre,3-6 commande CFTPARM,3-6 EXECSM paramètre,3-7 commande CFTPARM,3-7 EXECSMA paramètre,3-7 commande CFTPARM,3-7 EXIT parameter,5-24 CFTPROT command,5-24 EXITA paramètre,5-25 commande CFTPROT,5-25 EXITE paramètre,5-25 commande CFTPROT,5-25 EXITEOT paramètre,3-7 commande CFTPARM,3-7 Extraction,2-9 Voir aussi Utilitaire CFTUTIL des données,2-9 des fichiers Paramètres et Partenaires,2-9

CFT V2.3

Manuel de référence

F FACIL paramètre,6-32 commande CFTASY,6-32 FACILITY paramètre,6-28 commande CFTX25,6-28 FACTION paramètre,4-7, 4-30, 4-37, 4-56 commande CFTRECV,4-37 MVS,4-38 VFM,4-56 VM,4-38 commande CFTSEND,4-7 VFM,4-30 FAST paramètre,8-1 commande SHUT,8-1 FBLKSIZE paramètre,1-4, 2-30, 2-38, 4-7, 4-38 commande CFTFILE,1-4, 2-30, 2-38, 4-7, 4-38 valeurs par défaut,1-4, 2-30, 2-38, 4-7, 4-38 FCODE paramètre,4-7, 4-66 commande CFTSEND,4-7 commande CFTXLATE,4-66 valeurs par défaut,4-66 FCOMP paramètre,4-56 commande CFTRECV VFM,4-56 FDATE paramètre,7-3, 7-4 commande SEND,7-3, 7-4 TYPE = FILE,7-3, 7-4 FDB paramètre,4-30, 4-56 commande CFTRECV VFM,4-56 commande CFTSEND,4-30 VFM,4-30 FDISP paramètre,4-3, 4-39 commande CFTRECV,4-39 commande CFTSEND,4-3 Fichier statistique Voir Transferts, fichier statistique Voir Transferts, fichier statistique Fichiers,2-9 copie de,2-33 off line,2-33 commande COPYFILE,2-33 création,2-28 commande CFTFILE,2-28 de suivi basculement manuel commande SWITCH,8-1 émission de,1-5 journaux,3-22, 8-1 Voir aussi Commandes, d’administration du moniteur CFT manipulation Voir Utilitaire CFTUTIL paramètres,2-9 utilitaire CFTUTIL,2-9 partenaires,2-9 utilitaire CFTUTIL,2-9 récepteurs,4-31

CFT V2.3

Fichiers (suite) réception de,1-5, 7-12 Voir aussi Commandes, associées aux transferts commande RECV Voir Commandes, associées aux transferts statistiques,8-1 Voir aussi Transferts, fichier statistique Voir aussi Commandes, d’administration du moniteur CFT suppression,2-28 commande CFTFILE,2-28 types,4-1 émission Voir Environnement des transferts description Voir Environnement des transferts liste d’identifiants,4-60 FILE paramètre,2-13, 2-41 commande LISTCAT,2-13 commande LISTCOM,2-41 FIRST paramètre,2-41, 2-42 commande LISTCOM,2-41, 2-42 FLRECL paramètre,4-8, 4-40 commande CFTRECV,4-40 UNIX,4-40 commande CFTSEND,4-8 FNAME paramètre,2-4, 2-30, 3-20, 3-24, 3-32, 4-9, 4-30, 4-41, 4-56, 4-67, 6-11 commande CFTACCNT,3-32 commande CFTCAT,3-20 commande CFTDEST,6-11 commande CFTFILE,2-30 commande CFTLOG,3-24 commande CFTRECV,4-41 VFM,4-56 commande CFTSEND,4-9 VFM,4-30 commande CFTXLATE,4-67 commande CONFIG,2-4 FNAMEABS paramètre,7-1, 7-4 commande SEND,7-1, 7-4 TYPE = FILE,7-1, 7-4 FOR paramètre,6-12 commande CFTDEST,6-12 FORCE paramètre,4-12, 4-42 commande CFTRECV,4-42 commande CFTSEND,4-12 FORG paramètre,4-13 commande CFTSEND,4-13 FOUT paramètre,2-10 commande CFTEXT,2-10 FPARM paramètre,2-10 commande CFTEXT,2-10 FPART paramètre,2-11 commande CFTEXT,2-11 FRECFM paramètre,4-43 commande CFTRECV,4-43 OS400,4-43 UNIX,4-43 VOS,4-43 VRX,4-43

Index-7

Index FREE1 paramètre,5-45 commande CFTETB,5-45 FREE2 paramètre,5-45 commande CFTETB,5-45 FSPACE paramètre,2-30, 4-13, 4-43 commande CFTFILE,2-30 valeurs par défaut,2-30 commande CFTRECV,4-43 commande CFTSEND,4-13 FSPACEX paramètre,2-31 commande CFTFILE,2-31 valeurs par défaut,2-31

G GATEWAY paramètre,5-13 commande CFTNET TYPE = SNA,5-13 Gestion,3-22 des fichiers journaux,3-22 commande CFTLOG Voir aussi Paramètres, de gestion, des fichiers journaux du catalogue Voir Paramètres, de gestion, du catalogue GFA paramètre,6-28 commande CFTX25,6-28 GROUP paramètre,6-3 commande CFTPART,6-3 GROUPID paramètre,4-3, 4-13, 4-33, 4-44 commande CFTRECV,4-33, 4-44 commande CFTSEND,4-3, 4-13

H HALT commande,1-7, 7-24 HIGPORT paramètre,5-15 commande CFTNET TYPE = TCP,5-15 HOST paramètre,5-15, 6-25 commande CFTNET TYPE = TCP,5-15 commande CFTTCP,6-25

I IBLKSIZE paramètre,2-34 commande COPYFILE,2-34 ICOMP paramètre,2-35 commande COPYFILE,2-35 ICT paramètre,2-35 commande COPYFILE,2-35 ID paramètre,2-10, 2-25, 2-27, 3-7, 3-17, 3-20, 3-25, 3-31, 4-14, 4-44, 4-61, 4-63, 4-67, 5-2, 5-25, 5-45, 6-3, 6-13, 6-15, 6-30, 6-32 commande CFTACCNT,3-31 commande CFTASY,6-32 commande CFTAUTH,4-61, 4-63 commande CFTCAT,3-20 commande CFTCOM,3-17 commande CFTDEST,6-13 commande CFTETB,5-45 commande CFTEXT,2-10

Index-8

ID paramètre (suite) commande CFTLOG,3-25 commande CFTLU62,6-30 commande CFTNET,5-2 commande CFTPARM,3-7 commande CFTPART,6-3 commande CFTPROT,5-25 commande CFTRECV,4-44 PeSIT profil CFT,4-46 PeSIT profil EXTERN,4-46 commande CFTSEND,4-14 commande CFTXLATE,4-67 commande CFTXXX,6-15 commande LISTPARM,2-25 commande LISTPART,2-27 IDA paramètre,2-14, 7-4, 7-8, 7-10, 7-16, 7-23, 7-24, 7-26, 7-27, 7-29, 7-34 commande DELETE,7-23 commande END,7-34 commande HALT,7-24 commande KEEP,7-26 commande LISTCAT,2-14 commande RECV,7-16 commande SEND,7-4, 7-8, 7-10 TYPE = FILE,7-4 TYPE = MESSAGE,7-8 TYPE = REPLY,7-10 commande START,7-27, 7-29 Identifiants,4-32, 7-4 de fichier type,4-60 commande CFTAUTH Voir Environnement des transferts de transfert,4-32 commande CFTRECV,4-32 liste,4-60 commande CFTAUTH,4-60 réseau,4-62 de fichier type,4-62 IDF paramètre,2-8, 2-9, 2-14, 4-61, 5-46, 6-3, 7-4, 7-16, 7-23, 7-24, 7-26, 7-28, 7-29, 7-34 Voir Fichiers, types commande CFTAUTH,4-61 commande CFTETB,5-46 commande CFTPART,6-3 commande DELETE,7-23 commande END,7-34 commande HALT,7-24 commande KEEP,7-26 commande KSTATE,2-8, 2-9 commande LISTCAT,2-14 commande RECV,7-16 commande SEND,7-4 TYPE = FILE,7-4 commande START,7-28, 7-29 IDM paramètre,7-8, 7-10 commande SEND,7-8, 7-10 TYPE = MESSAGE,7-8 TYPE = REPLY,7-10

CFT V2.3

Manuel de référence IDT paramètre,2-14, 7-10, 7-23, 7-25, 7-26, 7-28, 7-29, 7-34 commande DELETE,7-23 commande END,7-34 commande HALT,7-25 commande KEEP,7-26 commande LISTCAT,2-14 commande SEND,7-10 TYPE = REPLY,7-10 commande START,7-28, 7-29 IDTU paramètre,2-7, 2-9, 2-13, 2-14, 2-22, 7-22, 7-23, 7-24, 7-25, 7-26, 7-27, 7-28, 7-29, 7-30 commande DELETE,7-22, 7-23 commande HALT,7-24, 7-25 commande KEEP,7-26 commande KSTATE,2-8, 2-9 commande LISTCAT,2-13, 2-14 commande LISTCAT CONTENT = FULL,2-22 commande START,7-27, 7-28, 7-29, 7-30 IFNAME paramètre,2-35 commande COPYFILE,2-35 ILRECL paramètre,2-35 commande COPYFILE,2-35 OS2,2-35 UNIX,2-35 VOS,2-35 IMAXTIME paramètre,6-3, 6-15, 6-30 commande CFTLU62,6-30 commande CFTPART,6-3 commande CFTXXX,6-15 IMINTIME paramètre,6-3, 6-15, 6-30 commande CFTLU62,6-30 commande CFTPART,6-3 commande CFTXXX,6-15 IMPL paramètre,4-14, 7-4 commande CFTSEND,4-14 influence du paramètre pour commande SEND Voir Commandes, SEND INACT FORCE,7-36, 7-37 ID,7-36 MODE,7-36, 7-37 TYPE,7-36 Incidents Voir Journal de CFT INDEX paramètre,2-6 INDEX paramètre commande CLEARCMD,2-6 Informations,2-12 associées aux transferts,2-12, 2-16, 2-18 pour LISTCAT CONTENT = BRIEF,2-16, 2-18 pour LISTCAT CONTENT = FULL,2-20 visualisées Voir Informations, associées aux transferts Interruption de transfert commande SHUT,8-1 IPART paramètre,6-3 commande CFTPART,6-3

CFT V2.3

J Journal de CFT,3-22 Voir aussi Commandes, CFTLOG

K KEEP commande,1-7, 7-25, 7-26 KEY paramètre,3-8 commande CFTPARM,3-8 KSTATE commande,2-8

L LANGUAGE paramètre,3-31 commande CFTACCNT,3-31 LAST paramètre,2-42 commande LISTCOM,2-42 LENGTH paramètre,3-25 commande CFTLOG,3-25 LINEID paramètre,6-32 commande CFTASY,6-32 commande CFTNET TYPE = ASY,5-3, 5-4 LINEID paramètre,5-3, 5-4 LISTCAT commande,1-7, 2-12, 2-13, 2-18 Voir aussi Action sur les transferts CONTENT = BRIEF,2-18 CONTENT = FULL,2-20 LISTCOM commande,2-41 paramètres,2-41 syntaxe,2-41 Liste,4-60 d’identifiants,4-60 de fichiers types (IDF),4-60 commande CFTAUTH,4-60 LISTPARM commande,2-25 LISTPART commande,2-26, 2-27 paramètres,2-27 syntaxe,2-27 LOCK paramètre,2-31 commande CFTFILE,2-31 LOG paramètre,3-8 commande CFTPARM,3-8 LOGMODE paramètre,6-21, 6-23 commande CFTSNA,6-21, 6-23 LOWPORT paramètre,5-15 commande CFTNET TYPE = TCP,5-15 LU62 valeur,2-27, 2-28, 5-1 LUNAME paramètre,5-7, 5-12, 5-13, 6-21, 6-23, 6-30 commande CFTLU62,6-30 commande CFTNET TYPE = LU62,5-7 TYPE = SNA,5-12, 5-13 commande CFTSNA,6-21, 6-23

Index-9

Index

M MAC paramètre,2-32 commande CFTFILE,2-32 MACTION paramètre,4-33, 4-44 commande CFTRECV,4-33, 4-44 Mailbox Voir Boîte aux lettres Manipulation,2-28 de fichiers Voir Utilitaire CFTUTIL MAXCNX paramètre commande CFTNET,5-2 MAXCNX paramètre,5-2 MAXDATE paramètre,4-14, 4-44 commande CFTRECV,4-44 commande CFTSEND,4-14 MAXREC paramètre,3-25, 3-32 commande CFTACCNT,3-32 commande CFTLOG,3-25 MAXTASK paramètre,3-9 commande CFTPARM,3-9 MAXTIME paramètre,4-14, 4-45 commande CFTRECV,4-45 commande CFTSEND,4-14 MAXTRANS paramètre,3-9 commande CFTPARM,3-9 MEDIACOM paramètre,2-4 commande CONFIG,2-4 Médias,2-1, 2-2 de communication,2-2 commande CFTCOM,3-16 de données,2-1 de CFTUTIL,2-1 redéfinition,2-1 Message émission de,1-5 Voir aussi Commandes, associées aux transferts mécanisme d’émission d’un,7-11 MINDATE paramètre,4-15, 4-45 commande CFTRECV,4-45 commande CFTSEND,4-15 MINTIME paramètre,4-15, 4-45 commande CFTRECV,4-45 commande CFTSEND,4-15 MODE paramètre,2-32, 6-30, 6-32 commande CFTASY,6-32 commande CFTFILE,2-32 commande CFTLU62,6-30 MODENAME paramètre,6-31 commande CFTLU62,6-31 Modes,3-16 d’enregistrement des données statistiques Voir Commandes, CFTACCNT de communication,3-16 applications/moniteur,3-16 commande CFTCOM,3-16 Modification des paramètres Voir Paramètres, modification des

Index-10

MODIN paramètre,5-3, 5-4 commande CFTNET TYPE = ASY,5-3, 5-4 MODOUT paramètre,5-3, 5-4,6-32 commande CFTASY,6-32 commande CFTNET TYPE = ASY,5-3, 5-4 Moniteur CFT,8-1 commandes d’administration,8-1 MQUERY commande,7-35 MSG paramètre,2-9, 7-7, 7-11 commande SEND,7-8, 7-11 TYPE = MESSAGE,7-8, 7-11 commande WLOG,2-9 MULTART paramètre,5-37 commande CFTPROT TYPE = PeSIT,5-37 PeSIT profil SIT,5-37

N NAME paramètre,3-17 commande CFTCOM,3-17 NBLKSIZE paramètre,4-16 commande CFTSEND,4-16 PeSIT profil CFT,4-16 NBR paramètre,5-46 commande CFTETB,5-46 NCODE paramètre,4-16, 4-67 commande CFTSEND,4-16 commande CFTXLATE,4-67 NCOMP paramètre,4-46 commande CFTRECV,4-46 commande CFTSEND PeSIT profil CFT,4-17 PeSIT profil EXTERN,4-17 NET paramètre,3-10, 5-26 commande CFTPARM,3-10 commande CFTPROT,5-26 NETPFX paramètre,5-12, 5-21 commande CFTNET TYPE = LU62,5-7 TYPE = SNA,5-12 TYPE = SNA,5-11 TYPE = X25,5-21 NETPFX paramètre,5-7, 5-11 NFNAME paramètre,4-17, 7-16 commande CFTSEND,4-17 PeSIT profil CFT,4-17 commande RECV,7-16 &FPATH variables symboliques,7-16 &FREF variables symboliques,7-16 &FROOT variable symbolique,7-16 &FSUF variables symboliques,7-16 &FUNIT variables symboliques,7-16 NFVER paramètre,7-18 commande RECV,7-18 NIDF paramètre,4-63, 5-46 commande CFTAUTH,4-63 commande CFTETB,5-46

CFT V2.3

Manuel de référence NIDF paramètre, commande CFTIDF (suite) commande CFTIDF ETEBAC3,4-63 ODETTE,4-63 PeSIT,4-63 PeSIT E,4-63 PeSIT E CFT/CFT,4-63 NLRECL paramètre,4-18, 5-46 commande CFTETB,5-46 commande CFTSEND,4-18 ODETTE,4-18 NODE paramètre,6-16, 6-18 commande CFTDNA,6-16 commande CFTDSA,6-18 NOTIFY paramètre,3-25, 4-3, 4-33, 4-46 commande CFTLOG,3-25 commande CFTRECV,4-33, 4-46 commande CFTSEND,4-3 NPART paramètre,2-14, 3-10, 5-46 commande CFTETB,5-46 commande CFTPARM,3-10 commande LISTCAT,2-14 NRECFM paramètre commande CFTSEND ETEBAC3,4-21 ODETTE,4-20 NRPART paramètre,6-3, 6-4 commande CFTPART,6-3, 6-4 ETEBAC3,6-3, 6-4 ODETTE,6-3, 6-4 PeSIT,6-3, 6-4 NRPASSW paramètre,6-4 commande CFTPART,6-4 ETEBAC3,6-4 ODETTE,6-4 PeSIT,6-4 NSPACE paramètre commande CFTSEND ODETTE,4-21 PeSIT,4-21 NSPASSW paramètre,5-46, 6-4 commande CFTETB,5-46 commande CFTPART,6-4 ETEBAC3,6-4 ODETTE,6-4 PeSIT,6-4 NTYPE paramètre commande CFTSEND ODETTE,4-21

O OCOMP paramètre,2-37 commande COPYFILE,2-37 OCT paramètre,2-37 commande COPYFILE,2-37 ODETTE Voir Protocoles, de transfert

CFT V2.3

OFNAME paramètre,2-37 commande COPYFILE,2-37 OLRECL paramètre,2-37 commande COPYFILE,2-37 OS2,2-37 UNIX,2-37 VOS,2-37 OMAXTIME paramètre,6-5, 6-15, 6-30 commande CFTLU62,6-30 commande CFTPART,6-5 commande CFTXXX,6-15 OMINTIME paramètre,6-5, 6-15, 6-30 commande CFTPART,6-5 commande CFTXXX,6-15 OPERMSG paramètre,3-27, 4-3, 4-21, 4-33, 4-48 commande CFTLOG,3-27 commande CFTRECV,4-33, 4-48 commande CFTSEND,4-3, 4-21 ORECFM paramètre,2-38 commande COPYFILE,2-38 UNIX,2-38 OSPACE paramètre,2-38 commande COPYFILE,2-38 UNIX,2-38

P PACKETSZ paramètre,5-21 commande CFTNET TYPE = X25,5-21 PAD paramètre,5-33 commande CFTPROT,5-33 TYPE = ODETTE,5-33 PADNO paramètre,6-32 commande CFTASY,6-32 PADSET paramètre,6-32 commande CFTASY,6-32 commande CFTNET TYPE = ASY,5-3, 5-4 PADSET paramètre,5-3, 5-4 Parameters DYNAM,5-24 EXIT,5-24 Paramètres,2-4 ACB MVS,5-10 VM,5-10 ACB,5-10 ACCNT,3-3 AFNAME,3-23, 3-31 OS400,3-23, 3-24 APPCYCID,7-3, 7-14 APPOBJID,7-3, 7-14 associés à un fichier type Voir Environnement des transferts commande CFTRECV,4-31 émission à partir d’une base VFM,4-29 commande CFTSEND Voir Environnement des transferts

Index-11

Index Paramètres, associés à un fichier type (suite) réception dans une base VFM,4-55 commande CFTRECV Voir Environnement des transferts associés au fichier émis,4-4 commande CFTSEND Voir Environnement des transferts AX25MBX,5-19, 5-22 GCOS7,5-19, 5-22 GCOS8,5-19, 5-22 BUFSIZE,3-3 CACHE,3-20 CALL,5-2 CAT,3-3 CIPHER,2-30 CLASS,5-13, 5-20, 6-18, 6-20, 6-22, 6-27, 6-30, 6-32 MVS,6-20 MVS,5-10 OS400,5-11 OS400 en LU0,6-22 VM,6-20 VM,5-10 VMS,5-13, 6-22 CLASS,5-3, 5-4, 5-6, 5-7, 5-10, 5-11 CNXIN,6-14, 6-30 CNXINOUT,6-14, 6-30 CNXOUT,6-15, 6-30 COM,3-3 COMMAND,2-6 COMMENT,3-4, 6-2 communs facultatifs commande SEND TYPE = MESSAGE,7-9 CONCAT,5-36 CONFIG,6-32 CONFIG,5-3, 5-4 CONTENT,2-13, 2-41, 3-24 CPNAME,6-31 CREATE,2-34 CTLPASSW,3-4 CTO,5-36 CYCDATE,4-5, 4-36 CYCLE,4-5, 5-37, 7-14 CYCTIME,4-6, 4-36 d’identification,4-4 commande CFTRECV Voir Environnement des transferts commande CFTSEND Voir Environnement des transferts DATA,6-27, 6-32 de contrôle d’exécution,4-4 commande CFTRECV Voir Environnement des transferts commande CFTSEND Voir Environnement des transferts de gestion,3-19 des fichiers journaux,3-22 du catalogue,3-19 commande CFTCAT,3-19

Index-12

Paramètres (suite) de traitement des données,4-4 commande CFTRECV Voir Environnement des transferts commande CFTSEND Voir Environnement des transferts DEFAULT,3-4 DELETE,4-2, 4-6, 4-33, 4-36 DIALNO,6-28, 6-32 DIRECT,2-13, 4-66, 5-45, 7-22, 7-24, 7-26, 7-27, 729, 7-33 DIRNB,4-33, 4-36 DISCTC,5-37 DISCTD,5-24, 5-26, 5-29 protocoles,5-24 ETEBAC3,5-24 ODETTE,5-24 PeSIT profil CFT,5-24 PeSIT profil EXTERN,5-24 PeSIT profil SIT,5-24 valeurs par défaut,5-24 DISCTR,5-37 DISCTS valeurs par défaut,5-24 du fichier pour le partenaire,4-5 commande CFTSEND Voir Environnement des transferts DURING,2-5 DYNAM,5-25 EERP,5-32 EXEC,3-24, 3-31, 4-6, 4-36, 6-11, 8-2 variables symboliques,4-36 EXECRE,3-5 EXECRF,3-5 variables symboliques,3-5 EXECRM,3-5 variables symboliques,3-5 EXECSE,3-6 variables symboliques,3-6 EXECSF,3-6 variables symboliques,3-6 EXECSFA,3-6 variables symboliques,3-6 EXECSM,3-7 variables symboliques,3-7 EXECSMA,3-7 variables symboliques,3-7 EXITA,5-25 EXITE,5-25 EXITEOT,3-7 variables symboliques,3-7 FACIL,6-32 FACILITY,6-28 FACTION,4-7, 4-30, 4-37, 4-56 facultatifs,7-14, 7-26, 7-27, 7-29, 7-33, 8-1 commande END,7-33 commande KEEP,7-26 commande LISTCAT,2-13

CFT V2.3

Manuel de référence Paramètres, facultatifs (suite) commande RECV,7-14 commande START,7-27, 7-29 FAST,8-1 FBLKSIZE,1-4, 2-30, 2-38, 4-7, 4-38 FCODE,4-7, 4-66 FCOMP,4-56 FDATE,7-3, 7-4 FDB,4-30, 4-56 FDISP,4-3, 4-39 fichiers (généraux),4-34 commande CFTRECV Voir Environnement des transferts FILE,2-13, 2-41 FIRST,2-41, 2-42 FLRECL,4-8, 4-40 OS2,4-8 UNIX,4-8 VOS,4-8 FNAME,2-4, 2-30, 3-20, 3-24, 3-32, 4-9, 4-30, 4-41, 4-56, 4-67, 6-11 variables symboliques,4-41 FNAMEABS,7-1, 7-4 FOR,6-12 FORCE,4-12, 4-42 FORG,4-13 FOUT,2-10 FPARM,2-10 FPART,2-11 FPREFIX variables symboliques,6-2 FRECFM,4-43 OS400,4-13 UNIX,4-13 VOS,4-13 FREE1,5-45 FREE2,5-45 FSPACE,2-30, 4-13, 4-43 FSPACEX,2-31 GATEWAY,5-13 VMS,5-13 généraux,3-1 commande CFTPARM,3-1 d’environnement du moniteur commandes CFTPARM CFTCOM CFTCAT CFTACCNT CFTLOG,1-3 d’environnement du moniteur,1-3 GFA,6-28 GROUP,6-3 variables symboliques,6-3 GROUPID,4-3, 4-13, 4-33, 4-44 HIGPORT,5-15 HOST,5-15, 6-25 GUARDIAN,5-15 MVS,5-15 UNIX,5-15 VMS,5-15 IBLKSIZE,2-34 ICOMP,2-35

CFT V2.3

Paramètres (suite) ICT,2-35 ID,2-10, 2-25, 2-27, 3-7, 3-17, 3-20, 3-25, 3-31, 4-14, 4-44, 4-61, 4-63, 4-67, 5-25, 5-45, 6-3, 6-13, 6-15, 6-30, 6-32 PeSIT profil SIT,4-14 ID,5-2 IDA,2-14, 7-4, 7-8, 7-10, 7-16, 7-23, 7-24, 7-26, 7-27, 7-29, 7-34 IDF,2-8, 2-9 IDF,2-14, 4-61, 5-46, 6-3, 7-4, 7-16, 7-23, 7-24, 7-26, 7-28, 7-29, 7-34 IDM,7-8, 7-10 IDT,2-14, 7-10, 7-23, 7-25, 7-26, 7-28, 7-29, 7-34 IDTU,2-8, 2-9 IDTU,2-13, 2-14, 2-22, 7-22, 7-23, 7-24, 7-25, 7-26, 7-27, 7-28, 7-29, 7-30 IFNAME,2-35 ILRECL,2-35 IMAXTIME,6-3, 6-15, 6-30 IMINTIME,6-3, 6-15, 6-30 IMPL,4-14, 7-4 INDEX,2-6 IPART,6-3 KEY,3-8 LANGUAGE,3-31 LAST,2-42 LENGTH,3-25 LINEID,6-32 LINEID,5-3, 5-4 liste des commande LISTPARM,2-25 LOCK,2-31 LOG,3-8 LOGMODE,6-21, 6-23 LOWPORT,5-15 LUNAME,5-12, 5-13, 6-21, 6-23, 6-30 OS400,5-12, 6-23 VMS,5-13 LUNAME,5-7 MAC,2-32 MACTION,4-33, 4-44 MAXCNX,5-2 MAXDATE,4-14, 4-44 MAXREC,3-25, 3-32 MAXTASK,3-9 MAXTIME,4-14, 4-45 MAXTRANS,3-9 valeurs par défaut,3-9 MEDIACOM,2-4 MINDATE,4-15, 4-45 MINTIME,4-15, 4-45 MODE,2-32, 6-30, 6-32 MODENAME,6-31 modification des,1-2 MODIN,5-3, 5-4 MODOUT,6-32 MODOUT,5-3, 5-4 MSG,2-9 MSG,7-8, 7-11

Index-13

Index Paramètres (suite) MULTART,5-37 NAME,3-17 GCOS7,3-17 VM,3-17 NBLKSIZE,4-16 NBR,5-46 NCODE,4-16, 4-67 NCOMP,4-46 NET,3-10, 5-26 MVS,3-10 VM,3-10 VSE,3-10 NETPFX,5-12, 5-21 GUARDIAN,5-21 OS400,5-12 OS400,5-11 NETPFX,5-7, 5-11 NFNAME,4-17, 7-16 PeSIT profil CFT,7-16 NFVER,7-18 PeSIT profil CFT,7-18 VFM,7-18 NIDF,4-63, 5-46 NLRECL,4-18, 5-46 NODE,6-16, 6-18 VMS,6-16 NOTIFY,3-25, 4-3, 4-33, 4-46 MVS,4-20 valeurs par défaut,3-25 NPART,2-14, 3-10, 5-46 NRPART,6-3, 6-4 NRPASSW,6-4 NSPASSW,5-46, 6-4 NTYPE valeurs par défaut,B-1 PeSIT profil CFT,B-1 obligatoires commande LISTCAT,2-15 commande SEND TYPE = FILE,7-4 OCOMP,2-37 OCT,2-37 OFNAME,2-37 OLRECL,2-37 OMAXTIME,6-5, 6-15, 6-30 OMINTIME,6-5, 6-15, 6-30 OPERMSG,3-27, 4-3, 4-21, 4-33, 4-48 valeurs par défaut,3-27, 4-21, 4-48 ORECFM,2-38 OSPACE,2-38 PACKETSZ,5-21 MVS,5-21 OS400,5-21 PAD,5-33 PADNO,6-32 PADSET,5-3, 5-4,6-32 PARM,4-22, 5-46

Index-14

Paramètres (suite) PART,2-8, 2-9, 2-14, 2-25, 3-10, 4-63, 5-38, 6-13, 7-6, 7-9, 7-11, 7-19, 7-23, 7-25, 7-26, 7-28, 7-30, 7-34 PARTFNAM,3-10 OS400,3-10 PCVI,6-28 PCVO,6-28 PREFIX,6-2 PRI,4-22, 4-49 PROF,5-38 PROFILE MVS,5-10 VM,5-10 PROFILE,5-10 PROT,3-10, 6-5 PUNAME,5-12, 5-13 OS400,5-12 VMS,5-13 PUNAME,5-7 RAPPL,4-22, 4-49, 4-50, 4-51 RAUTH,6-5 RCHKW,5-39 RCOMP valeurs par défaut,5-26 RCREDIT,5-33 RCVALLER,3-10 RECNB,2-32 RECV MVS,5-10 VM,5-10 RECV,5-7, 5-10 réseaux,6-16 d’un partenaire,6-16 commande CFTDNA,6-16 VMS,6-16 commande CFTDSA,6-17 GCOS6,6-17 GCOS7,6-17 GCOS8,6-17 commande CFTSNA,6-19 MVS,6-19 OS2,6-19 OS400,6-19 VM,6-19 VMS,6-19 commande CFTTCP,6-25 GUARDIAN,6-25 MVS,6-25 UNIX,6-25 VMS,6-25 commande CFTX25,6-26 GCOS6,6-17 GCOS7,6-17 GCOS8,6-17 VMS,6-16 réseaux et protocoles,1-3 commandes CFTNET CFTPROT CFTETB,1-3 RESTART,5-27

CFT V2.3

Manuel de référence Paramètres (suite) RESYNC,5-33, 5-39, 5-41 RETRYM,6-15, 6-30 RETRYN,6-15, 6-30 RETRYW,6-16, 6-30 RH,3-20 RKERROR,3-21, 4-34, 4-49 RPACING,5-39 RRSUSIZE,5-33 RRUSIZE,5-39 RT,3-21 RTO,5-27 RUSER,4-23 RX,3-21 SAP,6-6 SAPPL,4-23, 4-24 SAUTH,6-8 SBMID GCOS7,6-18 SBMPROJ GCOS7,6-18, 6-19 SCHKW,5-39 SCOMP valeurs par défaut,5-29 SCREDIT,5-33 SECFNAME,3-11 SH,3-21 SNAME,5-47 SPACING,5-40 SPART,4-4, 4-24, 7-3, 7-6 SPEED,6-28, 6-32 SPEED,5-3, 5-4 SRUSIZE,5-34, 5-41 MVS,5-41 ST,3-21 STATE,2-15, 2-27, 4-24, 4-51, 7-23 SUSER,4-25 SWITCH,3-28 SX,3-21 SYST,6-8 TCP,5-34 TCYCLE,4-25, 7-20 TIMEP,2-6, 3-19, 3-21 TPNAME,5-7, 5-8,6-31 TRANTASK,3-11 valeurs par défaut,3-11 TRK,4-26, 4-52, 6-8, 7-7, 7-20 TRKPART,3-12 TRKRECV,3-12 TRKSEND,3-12 TYPE,2-5, 2-11, 2-15, 2-25, 2-27, 2-32, 3-17, 3-31, 4-57, 4-59, 4-64, 5-8, 5-30, 7-7, 7-9, 7-11, 8-2 = ASY,5-3 = LU62,5-7 UPDAT,3-21 USERCTRL,3-13 USERID,2-6, 2-7,4-26, 4-52 variables symboliques,4-26, 4-52 VER,5-47

CFT V2.3

Paramètres (suite) VERIFY,6-29 WAITRESP,3-13 valeurs par défaut,3-13 WAITTASK,3-14 MVS,3-14 VM,3-14 WFNAME,4-26 variables symboliques,4-26, 4-53 WSCAN,3-17, 3-22 XLATE,4-27, 4-54, 6-9 PARM paramètre,4-22, 5-46 commande CFTETB,5-46 commande CFTSEND,4-22 PeSIT profil CFT,4-22 PART paramètre,2-8, 2-9, 2-14, 2-25, 3-10, 4-63, 5-38, 6-13, 7-6, 7-9, 7-11, 7-19, 7-23, 7-25, 7-26, 7-28, 7-30, 7-34 commande CFTAUTH,4-63 commande CFTDEST,6-13 commande CFTPARM,3-10 commande CFTPROT,5-38 TYPE = PeSIT,5-38 commande DELETE,7-23 commande END,7-34 commande HALT,7-25 commande KEEP,7-26 commande KSTATE,2-8, 2-9 commande LISTCAT,2-14 commande LISTPARM,2-25 commande RECV,7-19 commande SEND,7-6, 7-9, 7-11 TYPE = FILE,7-6 TYPE = MESSAGE,7-9 TYPE = REPLY,7-11 commande START,7-28, 7-30 Partenaires,2-26, 7-35 commande CFTDEST,6-10 commande CFTDNA,6-16 VMS,6-16 commande CFTDSA,6-17 commande CFTPART,6-1 commande CFTSNA,6-19 MVS,6-19 OS2,6-19 OS400,6-19 VM,6-19 VMS,6-19 commande CFTTCP,6-25 commande CFTX25,6-26 commande CFTXXX,6-13 commandes CFTPART CFTDEST,1-3 définition réseau,6-13 commande CFTXXX,6-13 liste des,2-26, 6-10, 7-35 definition,6-10 commande CFTDEST,6-10

Index-15

Index Partenaires (suite) paramètres réseaux,1-3 commande CFTDNA,6-16 VMS,6-16 commande CFTDSA,6-17 GCOS6,6-17 GCOS7,6-17 GCOS8,6-17 commande CFTSNA,6-19 MVS,6-19 OS2,6-19 OS400,6-19 VM,6-19 VMS,6-19 commande CFTTCP,6-25 GUARDIAN,6-25 MVS,6-25 UNIX,6-25 VMS,6-25 commande CFTX25,6-26 commandes CFTX25 CFTTCP¨CFTSNA CFTDSA CFTDNA CFTNTX,1-3 réception de fichiers,7-12 commande RECV,7-12 PARTFNAM paramètre,3-10 commande CFTPARM,3-10 PCVI paramètre,6-28 commande CFTX25,6-28 PCVO paramètre,6-28 commande CFTX25,6-28 PeSIT Voir Protocoles, de transfert Plage horaire Voir Transferts, plage horaire autorisée PREFIX paramètre,6-2 commande CFTPART,6-2 PRI paramètre,4-22, 4-49 commande CFTRECV,4-49 commande CFTSEND,4-22 PROF paramètre,5-38 commande CFTPROT,5-38 TYPE = PeSIT,5-38 commande CFTPROT TYPE = PeSIT PeSIT profil CFT,5-38 PeSIT profil EXTERN,5-38 PeSIT profil SIT,5-38 PROFILE paramètre commande CFTNET TYPE = SNA,5-10 PROFILE paramètre,5-10 PROT paramètre,3-10, 6-5 commande CFTPARM,3-10 commande CFTPART,6-5 Protocoles de transfert Voir Commandes, de paramétrage commande CFTPROT,5-22 ETEBAC3 commande CFTPROT TYPE = ETEBAC,5-30 format de la carte,5-43 commande CFTETB,5-43

Index-16

Protocoles, de transfert (suite) ODETTE commande CFTPROT TYPE = ODETTE,5-31 PeSIT commande CFTPROT TYPE = PeSIT,5-34 TCP/IP,5-34 ETEBAC3,4-21 commande CFTETB,5-43 commande CFTIDF,4-63 paramètre NIDF,4-63 commande CFTPROT,5-22 paramètre DISCTD,5-24 paramètre DISCTS,5-24, 5-26 paramètre SCOMP,5-29 TYPE = ETEBAC,5-30 commande CFTRECV,4-35 paramètres fichiers (généraux),4-35 commande CFTSEND,4-21 paramètre NRECFM,4-21 ODETTE commande CFTIDF,4-63 paramètre NIDF,4-63 commande CFTPROT,5-22 paramètre DISCTD,5-24 paramètre DISCTS,5-24, 5-26 paramètre SCOMP,5-29 TYPE = ODETTE,5-31 commande CFTSEND paramètre NLRECL,4-18 paramètre NRECFM,4-20 paramètre NSPACE,4-21 paramètre NTYPE,4-21 PeSIT,4-14 commande CFTIDF,4-63 paramètre NIDF,4-63 commande CFTPROT TYPE = PeSIT,5-34 commande CFTSEND paramètre NSPACE,4-21 E CFT/CFT commande CFTSEND paramètre PARM,4-22 profil CFT,4-16 commande CFTPROT paramètre DISCTD,5-24 paramètre DISCTS,5-24, 5-26 paramètre SCOMP,5-29 commande CFTRECV paramètres fichiers (généraux),4-35 commande CFTSEND,4-16 paramètre NBLKSIZE,4-16 paramètre NCOMP,4-17 paramètre NFNAME,4-17 paramètre PARM,4-22 paramètre RAPPL,4-49, 4-50, 4-51, 4-52 paramètre RUSER,4-23, 4-50 paramètre SUSER,4-25, 4-51

CFT V2.3

Manuel de référence Protocoles, PeSIT (suite) profil EXTERN,4-17 commande CFTPROT paramètre DISCTD,5-24 paramètre DISCTS,5-24, 5-26 paramètre SCOMP,5-29 commande CFTRECV paramètres fichiers (généraux),4-35 commande CFTSEND,4-17 paramètre NCOMP,4-17 profil SIT,4-14 commande CFTIDF,4-62 commande CFTPROT,5-24 paramètre DISCTD,5-24 paramètre DISCTS,5-24, 5-26 paramètre SCOMP,5-29 commande CFTRECV paramètres fichiers (généraux),4-35 commande CFTSEND,4-14 paramètre ID,4-14 paramètre RAPPL,4-22, 4-49 paramètre RUSER,4-23, 4-50 paramètre SAPPL,4-24, 4-50 PeSIT D commande CFTPROT,5-22 PeSIT E commande CFTIDF,4-63 paramètre NIDF,4-63 commande CFTPROT,5-22 commande CFTSEND paramètre PARM,4-22 PeSIT E CFT/CFT commande CFTIDF,4-63 paramètre NIDF,4-63 PeSIT profil CFT commande CFTRECV,4-46 paramètre NCOMP,4-46 PeSIT profil EXTERN commande CFTRECV,4-46 paramètre NCOMP,4-46 Proxy,5-14 PUNAME paramètre,5-12, 5-13 commande CFTNET TYPE = LU62,5-7 commande CFTNET TYPE = SNA,5-12, 5-13 PUNAME paramètre,5-7 PURGE commande,2-6

R RAPPL paramètre,4-22, 4-49, 4-50, 4-51 commande CFTSEND,4-22, 4-49, 4-50, 4-51 PeSIT profil CFT,4-49, 4-50, 4-51, 4-52 RAUTH paramètre,6-5 commande CFTPART,6-5 RCHKW paramètre,5-39 commande CFTPROT TYPE = PeSIT,5-39

CFT V2.3

RCOMP paramètre commande CFTPROT ETEBAC3,5-26 ODETTE,5-26 PeSIT profil CFT,5-26 PeSIT profil EXTERN,5-26 PeSIT profil SIT,5-26 RCREDIT paramètre,5-33 commande CFTPROT,5-33 commande CFTPROT TYPE = ODETTE,5-33 RCVALLER paramètre,3-10 commande CFTPARM,3-10 Réception,1-5 de fichiers Voir Commandes, associées aux transferts RECNB paramètre,2-32 commande CFTFILE,2-32 RECV commande,7-12 PeSIT profil SIT,7-12 paramètre commande CFTNET TYPE = LU62,5-7 TYPE = SNA,5-10 paramètre,5-7, 5-10 RECV paramètre,5-7 Redémarrage,1-5 des transferts,1-5 Voir aussi Commandes, associées aux transferts Reprise,3-22 des transferts Voir Journal de CFT Réseaux,2-28 DNA,2-28 identifiants Voir Identifiants, réseau ressources Voir Ressources réseaux Réseaux commande CFTPROT,5-22 Ressource réseau déportée,5-14 Ressources réseaux commande CFTPROT,5-22 DECNET commande CFTNET TYPE = DNA,5-5 DECNET,5-5 DSA commande CFTNET TYPE = DSA,5-5 DSA,5-5 locales commande CFTNET,5-1 locales,5-1 SNA commande CFTNET TYPE = SNA,5-8 SNA,5-8 TCP,5-14 commande CFTNET TYPE = TCP,5-14 X25,5-18 commande CFTNET TYPE = X25,5-18 RESTART paramètre,5-27 commande CFTPROT,5-27

Index-17

Index RESYNC paramètre,5-33, 5-39, 5-41 commande CFTPROT,5-33, 5-39, 5-41 TYPE = ODETTE,5-33 TYPE = PeSIT,5-39, 5-41 PeSIT profil CFT,5-39, 5-41 PeSIT profil EXTERN,5-39, 5-41 RETRYM paramètre,6-15, 6-30 commande CFTLU62,6-30 commande CFTXXX,6-15 RETRYN paramètre,6-15, 6-30 commande CFTLU62,6-30 commande CFTXXX,6-15 RETRYW paramètre,6-16, 6-30 commande CFTLU62,6-30 commande CFTXXX,6-16 RH paramètre,3-20 commande CFTCAT,3-20 RKERROR paramètre,3-21, 4-34, 4-49 commande CFTCAT,3-21 commande CFTRECV,4-34 commande CFTSEND,4-49 RPACING paramètre,5-39 commande CFTPROT TYPE = PeSIT,5-39 RRSUSIZE paramètre,5-33 commande CFTPROT TYPE = ODETTE,5-33 TCP/IP,5-33 RRUSIZE paramètre,5-39 commande CFTPROT TYPE = PeSIT,5-39 TCP/IP,5-39 RT paramètre,3-21 commande CFTCAT,3-21 RTO paramètre,5-27 commande CFTPROT,5-27 RUSER paramètre,4-23 commande CFTSEND,4-23 PeSIT profil CFT,4-23, 4-50 RX paramètre,3-21 commande CFTCAT,3-21

S SAP paramètre,6-6 commande CFTPART,6-6 SAPPL paramètre,4-23, 4-24 commande CFTSEND,4-23, 4-24 SAUTH paramètre,6-8 commande CFTPART,6-8 SCHKW paramètre,5-39 commande CFTPROT TYPE = PeSIT,5-39 SCOMP paramètre commande CFTPROT ODETTE,5-29 PeSIT profil CFT,5-29 PeSIT profil EXTERN,5-29 PeSIT profil SIT,5-29 SCREDIT paramètre,5-33 commande CFTPROT TYPE = ODETTE,5-33 SECFNAME paramètre,3-11 commande CFTPARM,3-11

Index-18

SEGMENT paramètre commande CFTPROT TYPE = PeSIT PeSIT profil SIT,5-40 SEND commande,7-1 TYPE = FILE,7-1 TYPE = MESSAGE,7-7 PeSIT profil CFT,7-7 TYPE = REPLY,7-9 Services Voir Utilitaire CFTUTIL Session,3-22 début de Voir Journal de CFT fermeture de Voir Journal de CFT SH paramètre,3-21 commande CFTCAT,3-21 SHUT commande,1-8, 8-1 SNAME paramètre,5-47 commande CFTETB,5-47 SPACING paramètre,5-40 commande CFTPROT TYPE = PeSIT,5-40 SPART commande,7-3 SPART paramètre,4-4, 4-24, 7-6 commande CFTSEND,4-4, 4-24 commande SEND,7-3, 7-6 TYPE = FILE,7-6 SPEED paramètre,6-28, 6-32 commande CFTASY,6-32 commande CFTNET TYPE = ASY,5-3, 5-4 commande CFTX25,6-28 SPEED paramètre,5-3, 5-4 SRUSIZE paramètre,5-34, 5-41 commande CFTPROT,5-34, 5-41 TYPE = ODETTE,5-34 TCP/IP,5-34 TYPE = PeSIT,5-41 TCP/IP,5-41 SSERV paramètre commande CFTPROT TYPE = PeSIT PeSIT profil CFT,5-41 ST paramètre,3-21 commande CFTCAT,3-21 START commande,1-7, 7-27, 7-28, 7-29 STATE paramètre,2-15, 2-27, 4-24, 4-51, 7-23 commande CFTSEND,4-24, 4-51 commande DELETE,7-23 commande LISTCAT,2-15 commande LISTPART,2-27 valeurs prédéfinies,2-27 Statistiques,2-39 d’exécution Voir Utilitaire CFTUTIL commande COPYFILE Voir Utilitaire CFTUTIL enregistrement des données Voir Commandes, CFTACCNT Stockage des données reçues Voir Environnement des transferts, commande CFTRECV SUBMIT commande,1-7

CFT V2.3

Manuel de référence Suppression,1-5 d’un poste du catalogue,1-7 Voir aussi Action sur les transferts de postes du catalogue,1-5 Voir aussi Commandes, associées aux transferts SUSER paramètre,4-25 commande CFTSEND,4-25 PeSIT profil CFT,4-25, 4-51 Suspension,2-5 de CFTUTIL,2-5 de transferts,1-5 Voir aussi Commandes, associées aux transferts SWITCH commande,1-8, 8-1 SWITCH paramètre,3-28 commande CFTLOG,3-28 SX paramètre,3-21 commande CFTCAT,3-21 SYST paramètre,6-8 commande CFTPART,6-8 PeSIT profil CFT,6-8

T TCP paramètre,5-34 commande CFTPROT,5-34 TYPE = ODETTE,5-34 TCYCLE paramètre,4-25, 7-20 commande CFTSEND,4-25 commande RECV,7-20 TIMEP paramètre,2-6, 3-19, 3-21 commande CFTCAT,3-19, 3-21 commande PURGE,2-6 TPNAME paramètre,6-31 commande CFTLU62,6-31 commande CFTNET TYPE = LU62,5-7, 5-8 TPNAME paramètre,5-7, 5-8 Transcodage,4-64, C-1 table de émission et réception,4-66 commande CFTXLATE,4-66 paramètre DIRECT,4-66 pour l’émission,4-66 commande CFTXLATE,4-66 paramètre DIRECT,4-66 pour la réception,4-66 commande CFTXLATE,4-66 paramètre DIRECT,4-66 tables de,C-1 ASCII,C-1 EBCDIC,C-1 Transfert,2-12, 2-16, 2-18 acquittement de,7-9 actions sur les,7-22 catalogue,7-22 postes du,7-22 suppression,7-22 commande DELETE,7-22 commande DELETE,7-22 activation,1-6

CFT V2.3

Transfert (suite) activation d’un,1-6 activation d'un Voir aussi Action sur les transferts arrêt de,1-5, 7-24 Voir aussi Commandes, associées aux transferts commande HALT,7-24 bloqués,1-6 Voir aussi Action sur les transferts commandes associées aux,7-1 commandes CFTAUTH CFTIDF CFTXLATE CFTSEND CFTRECV,1-3 correctement terminés Voir Commandes, CFTACCNT début des Voir Journal de CFT déclarés exécutés,1-5 Voir aussi Commandes, associées aux transferts états des,1-7 commande LISTCAT,1-7 événements Voir Journal de CFT exécutés,7-33 Voir aussi Commandes, END déclaration de,7-33 commande END,7-33 fichier statistique structure,D-1, E-1, F-1 en langage C,D-1 en langage COBOL,D-2 fin des,1-6, 3-22 commande END,1-7 Voir aussi Action sur les transferts identifiant,4-32 informations associées aux,2-12, 2-16, 2-18 interruption,1-6, 8-1 Voir aussi Action sur les transferts plage horaire autorisée,4-32 réactivation,1-6 Voir aussi Action sur les transferts commande START,1-7 redémarrage des,1-5, 7-28 Voir aussi Commandes, associées aux transferts commande START,7-28 requêtes,1-6 suppression,1-6 Voir aussi Action sur les transferts suspendus,1-6 Voir aussi Action sur les transferts suspension de,1-5, 7-25 Voir aussi Commandes, associées aux transferts commande KEEP,7-25 transcodage,4-64 table de,4-64 TRANTASK paramètre,3-11 commande CFTPARM,3-11 TRK paramètre,7-7, 7-20 commande RECV,7-20 commande SEND,7-7 TYPE = FILE,7-7 TRK paramètre,4-26, 4-52, 6-8 commande CFTPART,6-8 commande CFTRECV,4-52 commande CFTSEND,4-26 TRKPART paramètre,3-12 commande CFTPARM,3-12

Index-19

Index TRKRECV paramètre,3-12 commande CFTPARM,3-12 TRKSEND paramètre,3-12 commande CFTPARM,3-12 TYPE paramètre,2-5, 2-11, 2-15, 2-25, 2-27, 2-32, 3-17, 3-31, 4-57, 4-59, 4-64, 5-30, 7-7, 7-9, 7-11, 8-2 commande CFTACCNT,3-31 commande CFTAUTH,4-64 commande CFTCOM,3-17 commande CFTEXIT,4-57, 4-59 commande CFTEXT,2-11 valeurs prédéfinies,2-11 commande CFTFILE,2-32 commande CFTNET TYPE = LU62,5-8 commande CFTPROT,5-30 ETEBAC3,5-30 commande CONFIG,2-5 commande LISTCAT,2-15 commande LISTPARM,2-25 valeurs prédéfinies,2-25 commande LISTPART,2-27 valeurs prédéfinies,2-27 commande SEND,7-7, 7-9, 7-11 TYPE = FILE,7-7 TYPE = MESSAGE,7-9 TYPE = REPLY,7-11 commande SWITCH,8-2 paramètre,5-8 TYPE = ASY paramètre commande CFTNET TYPE = ASY,5-3 TYPE = ASY paramètre,5-3 TYPE = LU62 paramètre commande CFTNET TYPE = LU62,5-7 TYPE = LU62 paramètre,5-7

U UPDAT paramètre,3-21 commande CFTCAT,3-21 USERCTRL paramètre,3-13 commande CFTPARM,3-13 USERID paramètre,2-6, 2-7 USERID paramètre,4-26, 4-52 commande CFTRECV,4-52 commande CFTSEND,4-26 commande CLEARCMD,2-6, 2-7 Utilitaire CFT spécificités GCOS8,2-29, 3-11 spécificités OS400,2-29, 3-10, 4-54 Utilitaire CFTUTIL Voir Commandes, de l’utilitaire CFTUTIL consultations et extractions,1-1 commandes CFTEXT LISTPARM LISTPART LISTCAT,1-1 manipulations de fichiers,1-1 commandes CFTFILE COPYFILE,1-1

Index-20

Utilitaire CFTUTIL (suite) services,1-1, 2-1 commande CONFIG,1-1

V Valeurs,2-27 ASY,2-27 ASY,5-1 LU62,2-27, 2-28 LU62,5-1 Variables symboliques,3-5 &BDATE,4-17, 4-27, 4-41, 4-53 &BDAY,4-17, 4-27, 4-41, 4-53 &BMONTH,4-17, 4-27, 4-41, 4-53 &BTIME,4-17, 4-27, 4-41, 4-53 &BYEAR,4-17, 4-27, 4-41, 4-53 &DIAGI,3-6 &DIAGP,3-6 &FACCNT,8-1 &FDATE,4-17, 4-27, 4-41, 4-53 &FDAY,4-17, 4-27, 4-41, 4-53 &FLOG,8-1 &FMONTH,4-17, 4-27, 4-41, 4-53 &FPATH,7-16 &FREF,7-16 &FROOT,7-16 &FSUF,7-16 &FTIME,4-17, 4-27, 4-41, 4-53 &FUNIT,7-16 &FYEAR,4-17, 4-27, 4-41, 4-53 &GROUP,3-7, 4-17, 4-27, 4-41, 4-53, 6-3 &IDA,4-17, 4-27, 4-41, 4-53 &IDF,3-5, 3-6, 4-17, 4-27, 4-36, 4-41, 4-53 &IDM,3-5, 3-7 &IDT,4-27, 4-41, 4-53, 4-56 &IDTU,4-41 &NFNAME,4-27, 4-41, 4-53 &NFVER,4-41 &NIDF,4-17, 4-27, 4-41, 4-53 &NPART,4-17, 4-27, 4-41, 4-53 &PARM,3-5, 3-6, 3-7, 4-17, 4-27, 4-41, 4-53 &PART,3-5, 3-6, 3-7, 4-17, 4-26, 4-27, 4-41, 4-53, 4-56 &RAPPL,3-5, 3-6, 3-7, 4-17, 4-27, 4-41, 4-53 &RPART,3-5, 3-6, 3-7, 4-17, 4-27, 4-41, 4-53 &RUSER,3-5, 3-6, 3-7, 4-17, 4-26, 4-27, 4-41, 4-53 &SAPPL,3-5, 3-6, 3-7, 4-17, 4-27, 4-41, 4-53 &SPART,3-5, 3-6, 3-7, 4-17, 4-27, 4-41, 4-53 &SUSER,3-5, 3-6, 3-7, 4-17, 4-26, 4-27, 4-41, 4-53 &USERID,3-5, 3-6, 3-7 VER paramètre,5-47 commande CFTETB,5-47 VERIFY commande CFTX25,6-29 paramètre,6-29 VFM,4-29, 4-55 Voir aussi Protocoles, PeSIT, profil CFT commande RECV Voir Protocoles, PeSIT, profil CFT

CFT V2.3

Manuel de référence VFM (suite) paramètres associés à un fichier type,4-29, 4-55 commande CFTRECV,4-55 commande CFTSEND,4-29

W WAIT commande,2-5 WAITRESP paramètre,3-13 commande CFTPARM,3-13 WAITTASK paramètre,3-14 commande CFTPARM,3-14 WFNAME paramètre,4-26 commande CFTSEND,4-26 WLOG commande,2-9 WSCAN paramètre,3-17, 3-22 commande CFTCAT,3-22 commande CFTCOM,3-17

X XLATE paramètre,4-27, 4-54, 6-9 commande CFTPART,6-9 commande CFTRECV,4-54 commande CFTSEND,4-27

CFT V2.3

Index-21