manuel de référence

��

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 oureproductions strictement réservées à l’usage privé du copiste et non destinées à une utilisationcollective”.

Toute reproduction totale ou partielle, toute transmission sous quelque forme ou par quel procédé que cesoit (électronique ou mécanique, photocopie ou enregistrement) et à toutes autres fins que l’usagepersonnel sans autorisation écrite d'Axway Software est strictement interdite. Cette représentation oureproduction constituerait donc une contrefaçon sanctionnée par les articles L.335-2 et suivants du Codede la propriété intellectuelle.

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

CFT V2.3 iii

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

Table des Matières

CFT V2.3iv

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

Manuel de référence

CFT V2.3 v

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

Table des Matières

CFT V2.3vi

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


CFT V2.3 vii

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

Table des Matières

CFT V2.3viii

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


CFT V2.3 ix

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

Table des Matières

CFT V2.3x

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


CFT V2.3 xi

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

Table des Matières

CFT V2.3xii

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

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

G. 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

CFT V2.3 xiii

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.3xiv

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


CFT V2.3 xv

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

Liste des figures, Liste des Tableaux

CFT V2.3xvi

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

CFT V2.3 xvii

Conventions typographiques utilisées dans leManuel 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éspar catégories,

Exemple :

CFTFILE[MODE = {CREATE | DELETE},]FNAME = filename,TYPE = {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 sontdonnés en police courrier.

Exemple :

CFTFILE TYPE = PARM,MODE = CREATE,FNAME = filename

Création d’un fichier Paramètres.

Conventions typographiques

CFT V2.3xviii

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 SPECIFICITES

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

Indication d'un ouplusieurs complémentsd'information relatifs à lavaleur indiquée où à unerestriction d'emploi

Précisions sur le domained'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 :

• sert à indiquer un nom physique de fichier,

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

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


CFT V2.3 xix

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 sontles suivantes :

Tableau 1. Conventions typographiques utilisées pour les valeurs des paramètres

Type Notation Exemple

Liste de valeurs possibles {valeur, valeur} {filename, string}

Choix {1 | 2} {CREATE | DELETE}

Champ numérique(valeur comprise entre a et b)

{a..b} {0..255}

Valeur par défaut soulignée {CREATE | DELETE}

{valeur | texte} à renseigner italique 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 c FTYPE = c

Valeur de type numérique : chaîne de caractèresnumériques

n FLRECL = n

Valeur de type chaîne de caractères : suite decaractères alphanumériques ou suite de caractèresentre quotes

string SAP = string

Si le paramètre est obligatoire :chaîne de longueur comprise entre 1 et ncaractères

Si le paramètre est facultatif :chaîne de longueur comprise entre 0 et ncaractères

stringn PUNAME = string10Chaîne comprise entre 1 et10 caractères

[COMMENT = string32]Chaîne comprise entre 0 et32 caractères

Chaîne de longueur comprise entre n et mcaractères

stringn..m LUNAME = string3..8Chaîne comprise entre 3 et 8caractères

Chaîne de n caractères (exactement) stringn KEY = string21Chaîne de 21 caractères

Valeur de type constante (prédéfinie) VALEUR TYPE = PESIT

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


CFT V2.3xx

Conventions typographiques utilis ées pour les valeurs concernant descaté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égoriesprédéfinies

Type Notation

Compression : valeur numérique de 0 à 15 liée à l’algorithme de compression cpr

Date : chaîne de 8 caractères numériques AAAAMMJJ

Nom de fichier, chaîne alphanumérique d’une longueur maximum de64 caractères

filename

Identifiant, chaîne de 1 à 8 caractères alphanumériques avec le premier caractèrealphabétique

identifier

Masque, chaîne de caractères spéciaux constituant un “masque” mask

Time : chaîne de 2 à 8 caractères numériques HHMMSS

Identifiant de transfert attribué par CFT 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 oude 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 ceparamè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 = {BINARY | EBCDIC | ASCII} Dft : OS


CFT V2.3 xxi

Conventions relatives aux sp écificit és dépendantes du protocole

Dans les listes indiquant la syntaxe des paramètres, les spécificitésdépendantes d’un ou de plusieurs protocoles sont notées de la manièregénérique suivante :

PROTOCOLE

Exemple :

[NSPACE = n,] PROTOCOLE

Dans la description détaillée d’un paramètre, le ou les protocoles concernés sont indiqués demaniè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

string8

string22

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

Exemple :

[NCODE = {voir le commentaire | BINARY | EBCDIC | ASCII}] Dft : PROTOCOLE

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

Exemple :

[DISCTS = n] Dft : PROFIL

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

PeSIT

ODETTE

ETEBAC


CFT V2.3xxii

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 duprotocole 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 deuxmoniteurs CFT (extension des fonctionnalités dans le PI 99).

ETEBAC3 Spécificité concernant le protocole ETEBAC3.

CFT V2.3 xxiii

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’utilitaireCFTUTIL, 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 lamise en oeuvre de CFT et l’ intégration des transferts de fichiers dans les chaînes de traitementapplicatives : 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èmed’exploitation sont signalés, lorsque nécessaire, par des encadrés (voir les “Conventionstypographiques” ).

La recherche d’une commande ou d’un paramètre est facilitée par la présence d’un index en fin dedocument.

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écritesdans un chapitre particulier. Ces conventions permettent de préciser la syntaxe employée dans ladescription 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, responsablesd’exploitation, développeurs) ayant besoin d’ informations détaillées, soit pour exploiter CFT, soitpour en assurer la complète intégration dans l’environnement considéré (environnement système-réseau, environnement applicatif).

La lecture du guide “ Concepts” de CFT ou la participation à une formation CFT est un atoutcomplémentaire, pour une bonne compréhension et un bon usage du présent document.

CFT 2.3 1-1

1. Les commandes

1.1. Les commandes propres à CFTUTIL

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

Tableau 4. Commandes propres à CFTUTIL

Catégorie Mot-clé Fonctionnalité

Services CLEARCMD Suppression d'une requête de transfert

CONFIG Désignation du média de communication et des

fichiers accédés par CFTUTIL

KSTATE Suspension d'un transfert

PURGE Suppression des enregistrements du catalogue

WAIT Suspension de l’exécution de CFTUTIL pour la

durée indiquée

WLOG Demande d'écriture dans le fichier LOG

Consultations et extractions CFTEXT Extraction des données des fichiers Paramètres et

Partenaires

LISTPARM Liste des paramètres CFT

LISTPART Liste des partenaires

LISTCAT Liste des postes du catalogue

Manipulations de fichiers CFTFILE Création ou suppression des fichiers CFT

COPYFILE 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 à ceuxqu’utilisent, au même moment, le moniteur CFT. Les fichiers accédés peuvent éventuellement êtresé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 desfichiers indexés PARAMETRES et PARTENAIRES.

Les commandes

CFT 2.31-2

Remarques :les produits CFT sont livrés avec des exemples de paramétrage sous forme de source interprétablepar CFTUTIL. En exploitation, on conserve généralement au moins une partie des commandes deparamé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 dansles commandes interprétées par CFTUTIL.

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

Tableau 5. Signification des mots-clés des commandes de paramétrage

Catégorie Mot-clé Signification

Environnement du moniteur CFTPARM Paramètres généraux d’environnement moniteur

CFTCOM Paramètres liés à la communication entre les

applications et le moniteur CFT

CFTCAT Paramètres de gestion du catalogue

CFTLOG Paramètres de gestion des fichiers journaux

CFTACCNT Mode d’enregistrement des données statistiques

Environnement des transferts CFTSEND Description des paramètres d’émission d’un

fichier type

CFTRECV Description des paramètres de réception d’un

fichier type

CFTEXIT Activation d’une tâche “exit”

CFTAUTH Liste d’identifiants de fichiers types (IDF)

autorisés

CFTIDF Correspondance entre identifiant réseau et

identifiant local d’un fichier type transféré

CFTXLATE Table de transcodage utilisée lors d’un transfert

Réseaux et protocoles CFTNET Ressources (locales) réseau

CFTPROT Protocole de transfert

CFTETB Format de la carte ETEBAC 3

Partenaires CFTPART Définition d’un partenaire

CFTDEST Définition d’une liste de partenaires

CFTX25 Paramètres réseau d’un partenaire X25

CFTTCP Paramètres réseau d’un partenaire TCP/IP

CFTSNA Paramètres réseau d’un partenaire SNA

CFTDSA Paramètres réseau d’un partenaire DSA (BULL)

CFTDNA Paramètres réseau d’un partenaire DNA (VAX)

CFTLU62 Paramètres réseau d’un partenaire LU62

CFTASY Paramètres réseau d’un partenaire asynchrone

1.2.2. Modification des paramètres

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


CFT 2.3 1-3

Le moniteur CFT doit être arrêté puis relancé, pour que les nouvelles valeurs soient prises encompte, 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 lemoniteur CFT (paramètres dynamiques), lors des nouveaux transferts à venir (éventuellement surla 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 CFTXXXsuivantes définissant les paramètres réseaux d’un partenaire :

- CFTX25,

- CFTTCP,

- CFTSNA,

- CFTDSA,

- CFTDNA,

- CFTLU62,

- CFTASY.

Les commandes

CFT 2.31-4

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 lacommande 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érenceavec le fonctionnement du moniteur CFT, dans la mesure où celui-ci est susceptible de lire, à toutmoment, 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 = identifier,MODE = {REPLACE | CREATE | DELETE},PARAMETRE = valeur

ID = 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 lesfichiers PARAMETRES ou PARTENAIRES :

• REPLACE : modifier le ou les enregistrements associés, ou les créer s’ils n’existentpas ; 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 lecas 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 nonspécifiés prennent les valeurs par défaut.

Le commentaire sur le paramètre MODE est commun à toutes les commandes de paramétrage etn’est pas repris dans les pages suivantes.


CFT 2.3 1-5

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 Emission de fichiers ou de messages

RECV Réception de fichiers

Actions sur les transferts DELETE Suppression de postes du catalogue

HALT Arrêt de transferts

KEEP Suspension de transferts

START Redémarrage de transferts

SUBMIT Soumission d’une procédure de fin de transfert

(transfert en état T)

END Déclaration de transferts exécutés

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, permettantla 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 decommunication 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 oul’é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 leCATALOGUE des transferts CFT.

Les commandes

CFT 2.31-6

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éceptionglobale).

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 oufacultatifs,

• 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 lechapitre “Les commandes de paramétrage de l’environnement des transferts” de cedocument.

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é.


CFT 2.3 1-7

Les commandes associées à ces actions sont indiquées dans le tableau suivant.

Tableau 7. Commandes de contrôle des transferts

Commande Action

DELETE Supprime un poste du catalogue

HALT Arrête un transfert et le met à l’état HOLD

KEEP Arrête un transfert et le met à l’état KEEP

START Réactive un transfert

SUBMIT Soumission d’une procédure de fin de transfert (transfert en état T)

END 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 (postesdu catalogue) sur lesquels portent ces commandes.

Les commandes modifient l’état des transferts concernés dans le catalogue CFT. Cet état peut êtreconsulté par la commande LISTCAT, avant d’effectuer la commande de contrôle et après sonexécution. La signification de ces états est indiquée dans le tableau suivant.

Tableau 8. Signification des états de transfert

Etat Signification

D DisponibleLe transfert est prêt à être activé. Il le sera dès que CFT pourra lui attribuer desressourcesUn 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

C En coursLe transfert est en cours d’exécution

H HoldTransfert 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 unedemande de réception (s’il s’agit d’un transfert en émission), issue du partenaire

K KeepLe 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)

T TerminéLes données ont été totalement transmises

X 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

Les commandes

CFT 2.31-8

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

Tableau 9. Transition d’état

Evénements

Etat

Gérés par moniteur

Activation Fin de Interruptiontransfert de transfert

Commandes

START HALT KEEP END

D C D H K

C T D, H ou K

(1)

H K

H D K

K D H

T X

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, permettantla 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 bieneffectué dans le média de communication de CFTUTIL.

Tableau 10. Signification des mots-clés des commandes d’administration

Mot-clé Signification

SHUT Arrêt de CFT

SWITCH Basculement manuel des fichiers de suivi

ABOUT Caractéristiques de la machine sur laquelle CFT est installé

CFT 2.3 2-1

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 travailleral’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, communicationavec 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 unautre média que ceux-ci. Dans ce cas, la commande CONFIG doit être utilisée avant de passer lesautres commandes traitées par CFTUTIL.

Les médias de données CFTUTIL, définis dans le guide “Concepts” de CFT, sont désignés danscette commande par le paramètre TYPE. En relation avec ce paramètre, deux catégories de médiasont à distinguer :

• les médias devant s’interfacer avec les médias utilisés par le moniteur CFT. Les donnéesassociées à ces médias permettent, à partir de CFTUTIL, de :

configurer et consulter les paramètres du moniteur CFT avec l’optionTYPE =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 lesmé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’optionTYPE = OUTPUT.

Pour TYPE = PARM, TYPE = PART et TYPE = CAT, les médias associés sont uniquement desfichiers. 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 fluxd’entrée ou de sortie de CFTUTIL, vers un fichier dont le nom est spécifié par le paramètreFNAME.

Si l’utilisateur modifie le nom du fichier d’entrée (TYPE = INPUT), les commandes de CFTUTILultérieures seront lues dans le nouveau média d’entrée mentionné.

Les commandes propres à l’utilitaire CFTUTIL

CFT 2.32-2

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 deconfiguration").

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 decommunication, 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, pardéfaut associé à ce système, sont indiqués dans le guide “Concepts” de CFT, au paragraphe“Médias du moniteur”.

Figure 1. Médias concernés par les commandes de CFTUTIL


CFT 2.3 2-3

Commandes

FICHIER_IN

TransfertsModifications

Médias de communication

Moniteur CFT

Configuration

Consultations

CFT

CFTUTILUtilitaire CFT

FICHIER_OUT

FICHIER Paramètres

FICHIER Partenaires

FICHIER Catalogue

Compte renduCONFIG TYPE = PARM

CONFIG TYPE = PART

CONFIG TYPE = CAT

CONFIG TYPE = COM

CONFIG TYPE = INPUT CONFIG TYPE = OUTPUT

Gestion


CFT 2.32-4

2.1.1.1. Syntaxe

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

CONFIGTYPE = COM,[MEDIACOM = {FILE | MBX | TCP},][FNAME = {filename | string}]

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 avoircorrespondance avec la valeur du paramètre NAME de la commande CFTCOM qui définit lemé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 estabsent 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.


CFT 2.3 2-5

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 Fichier catalogue

COM Média de communication

INPUT Fichier d’entrée des commandes

OUTPUT Fichier de sortie des comptes rendus

PARM Fichier paramètres

PART Fichier partenaires

2.1.1.3. Exemples pour TYPE = OUTPUT

CONFIG TYPE = OUTPUT,FNAME = <filename>

Cette commande redirige la sortie de CFTUTIL (utilisé lors desconsultations des commandes LISTPARM ou LISTPART, ...) vers lefichier de nom générique <filename> .

CONFIG TYPE = COM,MEDIACOM = FILE,FNAME = <filename>

Cette commande permet de définir le fichier de nom générique<filename > 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.32-6

2.1.3. PURGE - Purge du catalogue

Cette commande supprime les enregistrements ayant dépassé la période de rétention indiquée dansle paramétrage CFT. L’utilisateur fixe son heure de purge suivant ses besoins et l’activité de sonmoniteur CFT.

2.1.3.1. Syntaxe

PURGETIMEP = {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’engorgementdu 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 lecycle 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 decommunication. Elle génère une commande WLOG qui signale l'événement dans le fichier LOG.

2.1.4.1. Syntaxe

CLEARCMDCOMMAND = name,INDEX = n,USERID = string


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.


CFT 2.3 2-7

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 = $CFTCOMDATE = 15/01/2003 TIME = 16:07:03RECNB = 30RECORDS

-------------------------------------------------------------RECORD N 4 ACTIVE : YESCOMMAND-TYPE : SHUT USERID : user1

GROUPID :JOBNAME : JOBCFT

COMMANDE :fast=yes

-------------------------------------------------------------RECORD N 5 ACTIVE : YESCOMMAND-TYPE : SEND USERID : user1


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 etappartenant à USER1 va être supprimée du fichier de communication.


CFT 2.32-8

Liste des enregistrements du fichier de communication

CFTUTIL LISTCOM

FILE HEADER-------------------------------------------------------------

FILE = $CFTCOMDATE = 15/01/2003 TIME = 16:08:14RECNB = 30RECORDS

-------------------------------------------------------------RECORD N 4 ACTIVE : YESCOMMAND-TYPE : SHUT USERID : user1


COMMANDE :fast=yes




-------------------------------------------------------------RECORD N 7 ACTIVE : YESCOMMAND-TYPE : USERID : user1


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 moniteurdoit être arrêté avant de passer la commande puis relancé. Le transfert doit exister dans lecatalogue et être dans un des états suivants : transfert en cours ("C"), transfert disponible ("D") outransfert 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

KSTATEIDF = identifier,IDTU = string,PART = identifier


CFT 2.3 2-9


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

WLOGMSG = 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 fichiersParamètre et Partenaire.

Cette commande génère, en sortie, un texte des commandes de configuration permettant dereconstituer les données de ces fichiers.

L’usage d’une telle commande s’intègre dans une séquence d’“extraction” par CFTEXT desdonnées des fichiers Paramètres et Partenaires, puis “soumission” du fichier de configurationrésultant à CFTUTIL pour :

• reconstruire une configuration perdue ou endommagée,

• faciliter l’export d’une configuration de moniteur sur une autre machine,


CFT 2.32-10

• effectuer une montée de niveau du logiciel CFT lorsque celle-ci intègre une modificationdes 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 bienredé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 = {ALL | ACCNT | AUTH | CAT | COM | ETB | IDF | LOG | NET |

PARM | PART | PROT | RECV | SEND | XLATE | ASY | DNA | DSA | LU62 | SNA | TCP | X25},]

[ID = {* | identifier | mask},][FPARM = filename,][FPART = filename,][FOUT = filename]


[ID = {* | identifier | mask}]

Identifiant du paramètre à extraire.

La valeur de cet identifiant est celle de l’ID de la commande CFTxxxx correspondant auparamè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).


CFT 2.3 2-11

[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 Fichier

ALL Tous les types de paramètres des fichiers CFTPARM

et CFTPART

ACCNT Description des fichiers de statistiques CFTACCNT

AUTH Liste des fichiers autorisés CFTAUTH

CAT Définition du catalogue CFTCAT

COM Description des méthodes de communication avec le

moniteur CFT

CFTCOM

ETB Définition des cartes paramètre ETEBAC CFTETB

IDF Identifiant “réseau” de fichier CFTIDF

LOG Description des fichiers de journalisation CFTLOG

NET Description réseau CFTNET

PARM Paramètres généraux CFTPARM

PART Définition des partenaires CFTPART et CFT réseau

PROT Définition des protocoles CFTPROT

RECV Description des fichiers à recevoir CFTRECV

SEND Description des fichiers à émettre CFTSEND

XLATE Définition des tables de transcodage CFTXLATE

ASY Définition du partenaire asynchrone CFTASY

DNA Définition du partenaire DNA CFTDNA

DSA Définition du partenaire DSA CFTDSA

LU62 Définition du partenaire LU6.2 CFTLU62

SNA Définition du partenaire SNA CFTSNA

TCP Définition du partenaire TCP/IP CFTTCP

X25 Définition du partenaire X25 CFTX25

2.2.1.3. Exemples

Exemple 1 :

CFTEXT

Extraction de l’ensemble des données des fichiers, paramètresCFTPARM et partenaires CFTPART.


CFT 2.32-12

Exemple 2 :

CFTEXT TYPE = SEND,ID = FACT,FPARM = mycftparm

Extraction des données du fichier type à émettre (commandeCFTSEND) d’IDF = FACT, du fichier “ mycftparm ”.

Exemple 3 :

CFTEXT TYPE = RECV,ID = FACT*

Extraction des données des fichiers-types à recevoir (commandeCFTRECV) 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 à votreOS.

Exemple 4 :

CFTEXT TYPE = PART,ID = MAGA*

Extraction des données “partenaires” correspondant aux commandesCFTPART dont l’identifiant commence par les 4 lettres “MAGA”. Lenom du fichier Partenaires est celui par défaut indiqué, consultezle “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 lecompte rendu de l’exécution (erreur de syntaxe, pas d’informations associées, ...) sont écrits sur lasortie standard de la tâche.

Cette commande permet de restituer :

• d’une part les informations statiques des transferts associées aux paramètres descommandes 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, ...


CFT 2.3 2-13

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 cemanuel.

2.2.2.1. Syntaxe

LISTCAT

[TYPE = {ALL | FILE | MESSAGE | REPLY},]

[CONTENT = {BRIEF | FULL},]

[DIRECT = {BOTH | SEND | RECV},]

[FILE = filename,]

[IDA = {* | identifier},]

[IDTU = string,]

[IDF = {* | identifier},]

[IDT = {* | transid},]

[NPART = {identifier | mask},]

[PART = {* | identifier | mask},]

[STATE = {* | string}]


[CONTENT = {BRIEF | FULL}]

Permet d’obtenir une partie ou toutes les informations d’un poste du catalogue.


• 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.


• 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édiasde l’utilitaire” du guide “Concepts” de CFT).

Pour désigner le catalogue courant du moniteur, il est nécessaire de renseigner ce paramètreavec le nom du fichier fourni au paramètre FNAME de la commande CFTCAT.


CFT 2.32-14

[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}]


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]


[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énominationréseau,

• un masque : la sélection est générique et porte sur les transferts effectués avec ladé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 quele paramètre NPART est renseigné ou pas (voir les paragraphes suivants).

[PART = {* | identifier | mask}]

Identifiant du/des partenaire(s) des transferts sélectionnés.


• 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’identifiantcorrespond à ce masque,

• omise : la sélection concerne tous les partenaires. Cette option est identique à l’optionPART = *.

Si le paramètre NPART est renseigné, le paramètre PART est ignoré.


CFT 2.3 2-15

[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) serontaffichés s’ils remplissent les critères de sélection définis éventuellement par les autresparamètres.

2.2.2.3. Exemples

Exemple 1 :

LISTCAT TYPE = ALL,PART = SIEGE,STATE = DC

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

Exemple 2 :

LISTCAT TYPE = FILE,PART = PARIS5,DIRECT = SEND

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


CFT 2.32-16

2.2.2.4. Informations visualisées

Dans les exemples suivants, chaque champ visualisé est repéré par un chiffre qui renvoie aucommentaire 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 lacommande LISTCAT (p),

• le nombre de postes du catalogue restant libre (q) ainsi que le pourcentage d’espacerestant 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 DTSA File Transfer Diags Parm

(Network Name) Id. Id. CFT Prot.

______________ ____ _______ _______ ___ _______ _____________

xxxxxxxxxxxxxxxx xxxx xxxxxxxx xxxxxxxx xxx xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxx xxxxxxxx xxxxxxxx xxx xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxx xxxxxxxx xxxxxxxx xxx xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxx xxxxxxxx xxxxxxxx xxx xxxxxxxx xxxxxxxxxxxxxxx

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


CFT 2.3 2-17

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

2 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)

3 Identifiant de fichier (IDF) s’il s’agit d’une transmission de fichier ou identifiant du

message (IDM)

4 Identifiant de Transfert

Identifiant du transfert attribué par le moniteur (IDT)

5 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)

6 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

7 Champ PARM

Il est affiché sur une longueur de 24 caractères et donc éventuellement tronqué

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


CFT 2.32-18

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 5 6 7 8 9

Date = DD-MM-YYYY, Time = hh:mm

Partner DTSA File Transfer Records Diag Diag Applic.

Ident Ident Transmit Total Protocol Ident

_______ ____ ________ ________ ________ ________ ___ ________ ________

xxxxxxx xxxx xxxxxxxx xxxxxxxx nnnnnnnn nnnnnnnn nnn xxxxxxxx xxxxxxxxxxxxxxx xxxx xxxxxxxx xxxxxxxx nnnnnnnn nnnnnnnn nnn xxxxxxxx xxxxxxxx

xxxxxxx xxxx xxxxxxxx xxxxxxxx nnnnnnnn nnnnnnnn nnn xxxxxxxx xxxxxxxxxxxxxxx xxxx xxxxxxxx xxxxxxxx nnnnnnnn nnnnnnnn nnn xxxxxxxx xxxxxxxx

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


CFT 2.3 2-19

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


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)

2 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)

3 Identifiant du fichier (IDF) s’il s’agit d’une transmission de fichier ou identifiant du

message (IDM).

4 Identifiant du Transfert (IDT)

5 S’il s’agit d’un transfert :

• de fichier : nombre d’enregistrements à transmettre

• de message : texte du message tronqué à 21 caractères

6 S’il s’agit d’un transfert :

• de fichier : nombre d’enregistrements transmis

• de message : suite du texte du message tronqué à 21 caractères

7 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)

8 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

9 Identifiant de l'application (IDA) associée à ce transfert



CFT 2.32-20

2.2.2.4.3. Pour LISTCAT CONTENT = FULL

Figure 4. LISTCAT CONTENT = FULL

Transfer informations---------------------

1 Transfer id. IDT = xxxxxxxx2 Local transfer id. IDTU = xxxxxxxx

3 Direct DIRECT =4 Type TYPE =5 Priority PRI =

6 State diagnosis STATE =7 Local diagnosis DIAGI =8 Protocol diagnosis DIAGP =9 Complementary diagnosis DIAGC =

x-64-xx-64-xx-64-xx-63-x

10 Item type DIFTYP =11 For partner list : id. DEST =12 In progress LNUM =13 Remote transfer id. IDTD =14 Remote transfer state STATED =

15 Network file id. NIDF =16 File data base FDBNAME =

x-64-x17 File name FNAME =

x-64-x18 Temporary file name WFNAME =

x-64-x19 Local Select list SELFNAME =

x-64-x20 Remote file name NFNAME =

x-64-x21 File version NFVER =22 Application id. IDA =23 Private parameter PARM =

x-40-xx-40-x

24 Partner PART =25 Sender SPART =26 Receiver RPART =27 Intermediate partner IPART =28 Connection partner NPART =

Partner call time Command deposure"----------------- ----------------"

29 31 After TIMMC = Date DATED =30 32 Before TIMMAXC = Time TIMED =


CFT 2.3 2-21

Transfer validity Activation time"----------------- ---------------"

33 35 After MINDATE = Before CYCDATE =34 36 MINTIME = Time CYCTIME =37 39 Before MAXDATE = Each CYCLE =38 40 MAXTIME = Unit TCYCLE =

41 Next retry date NEXTDAT =42 Next retry hour NEXTTIM =

Transfer--------

43 45 Begin date DATEB = End date DATEE =44 46 Begin time TIMEB = End time TIMEE =

Connection retry Protocol"---------------- --------"

47 52 Current RETRY = Id. PROT =48 Max number RETRYN = Restart :"49 53 Max number RETRYM = Allowed (YES/NO) =50 54 Time between RETRYW = Current =51 Last dial nb DIALNUM =

Transmitted To transmit----------- -----------

55 57 Records NRECS = Records NREC =56 Bytes NCARS =

Read or Written---------------

58 Records FRECS =59 Bytes FCARS =

Synchronization---------------

60 Nb of checkpoints NCHKPT =61 Nb of resynchro. NRST =

62 User id. USERID =63 Group id. GROUPID =64 Origin owner transfer ORIGIN =65 Translation table XLATE =66 Exit id. EXIT =

67 Exita id. EXITA =

68 Exite id. EXITE =

69 Job name JOBNAME =

70 Sender user SUSER =71 Receiver user RUSER =72 Sender application SAPPL =

x-48-x73 Receiver application RAPPL =

x-48-x74 Comments MSG =


CFT 2.32-22

Le tableau suivant contient les commentaires associés aux différentes rubriques du LISTCAT[CONTENT = FULL].

Tableau 15. LISTCAT CONTENT = FULL - Commentaires des rubriques


1 Identifiant du transfert (IDT)

2 IDTU : compteur local de transfert

3 Sens du transfert : SEND/RECV

4 Type de la requête : FILE/MESSAGE/REPLY

5 Priorité de sélection de la demande du transfert

6 Définit l’état de la requête du transfert (voir le tableau en introduction de LISTCAT).

(DISPonible/CURRent/HOLD/KEEP/TERMinated/EXECuted)

7 Diagnostic interne CFT (DIAGI) résultant du transfert (numérique) (1)

8 Diagnostic au sens protocole applicatif (DIAGP) (2)

9 Diagnostic complémentaire (DIAGC)

10 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

11 Identifiant de la liste de diffusion/collecte (commande CFTDEST)

12 Nombre d’éléments activés ou non de la liste de diffusion/collecte

13 Si le partenaire acquitte le transfert : Identifiant du transfert de l’acquittement

14 Si le partenaire a acquitté le transfert : “ACK”

15 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)

16 Nom du fichier VFM transféré (FDBNAME)

17 Nom local du fichier transféré (FNAME)

18 Nom du fichier temporaire utilisé pour le transfert (WFNAME)

19 Nom du fichier de sélection dans le cas de la manipulation de groupe de fichiers

(SELFNAME)

20 Identifiant réseau du fichier (NFNAME)

21 Version du fichier transféré (NFVER)

22 Identifiant de l’application (IDA) associée à ce transfert

23 Paramètre privé documenté par l’utilisateur (PARM)

24 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

25 Identifiant du partenaire émetteur (SPART)

26 Identifiant du partenaire récepteur (RPART)

27 Identifiant du partenaire intermédiaire (paramètre IPART de CFTPART)

28 Partenaire de connexion (NPART)


CFT 2.3 2-23

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


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.

31 Date de dépôt de la commande

32 Heure de dépôt de la commande

33 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

34 Heure minimum de validité du transfert, pour le premier jour (MINDATE de la commande

SEND)

35 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

36 Heure limite supérieure d’activation du premier transfert d’un échéancier (paramètre

CYCTIME de la commande SEND)

37 Dernier jour de validité des transferts (MAXDATE de la commande SEND)

38 Heure maximum de validité du transfert, pour le dernier jour (MAXTIME de la commande

SEND)

39 Nombre d’unités définissant la période d’un cycle de transfert

40 Unité de la période du cycle de transfert :

• MIN Minutes

• DAY Jour

• MONTH Mois

41 Date de la prochaine tentative de transfert (NEXTDAT)

42 Heure de la prochaine tentative de transfert (NEXTTIM)

43 Date de début du transfert (DATEB)

44 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

45 Date de fin du transfert (DATEE)

46 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

47 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

48 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


49 Nombre total de tentatives de connexion restant à faire

Cette valeur évolue de RETRYM (commande CFTX25, ...) à 0


50 Espacement des tentatives de connexion (en minutes)

Cette valeur évolue de RETRYW (commande CFTX25, ...) à NNN



CFT 2.32-24

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


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


52 Identifiant du protocole applicatif utilisé avec le partenaire (paramètre ID de la commande

CFTPROT)

53 Indique si la relance est autorisée ou non pour ce transfert (ALLOWED)

54 Nombre de relances protocolaires effectuées pour ce transfert (CURRENT)

0 signifie pas de relance.

55 S’il s’agit d’une transmission de fichier : nombre d’enregistrements transmis (NRECS)

56 S’il s’agit d’une transmission de fichier : nombre de caractères transmis (NCARS)

57 S’il s’agit d’une transmission de fichier : nombre total d’enregistrements à transmettre

(NREC)

58 S’il s’agit d’une transmission de fichier : nombre d’enregistrements lus ou écrits (FRECS)

59 S’il s’agit d’une transmission de fichier : nombre de caractères lus ou écrits (FCARS)

60 Numéro du dernier point de synchronisation posé (NCHKPT)

61 Nombre de resynchronisations effectuées (NRST)

62 Identifiant de l’utilisateur demandeur, au sens du système d’exploitation (ce champ désigne

aussi le propriétaire du transfert) (USERID)

63 Identifiant du groupe auquel appartient l’utilisateur demandeur, au sens système

d’exploitation (GROUPID)

64 Origine du propriétaire du transfert (ORIGIN)

65 Identifiant de la commande CFTXLATE si utilisée (table de transcodage utilisée lors d’un

transfert)

66 Identifiant de la commande CFTEXIT si utilisée (il s’agit de l’EXIT fichier) (EXIT)

67 Identifiant de la commande CFTEXIT si utilisée (il s’agit de l’EXIT annuaire) (EXITA)

68 Identifiant de la commande CFTEXIT si utilisée (il s’agit de l’EXIT ETEBAC3) (EXITE)

69 Nom de la tâche au sens système d’exploitation (JOBNAME)

70 Identifiant de l’utilisateur émetteur du fichier (SUSER)

71 Identifiant de l’utilisateur récepteur du fichier (RUSER)

72 Identifiant de l’application émettrice du fichier (SAPPL)

73 Identifiant de l’application réceptrice du fichier (RAPPL)

74 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)



CFT 2.3 2-25

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 typeCFT****.

Le paramètre TYPE permet de sélectionner le type de commande.

En l’absence d’une précédente commande CONFIG TYPE = OUTPUT, le compte rendu del’exécution est écrit sur la sortie standard du programme CFTUTIL.

2.2.3.1. Syntaxe

LISTPARMTYPE = {ACCNT | ALL | AUTH | CAT | COM | ETB | IDF | LOG | NET |

PARM | PROT | RECV | SEND | XLATE},[ID = {* | identifier},][PART = identifier]


[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


Permet de limiter la recherche aux IDF définis dans les commandes CFTIDF, relatives à cepartenaire.

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

Définit le type de commande à sélectionner.


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

ALL Permet la consultation de tous les paramètres indiqués dans le fichier “PARAMETRES”

AUTH Permet la consultation des listes d’autorisation relatives aux fichiers

Ces listes sont paramétrées par les commandes CFTAUTH

CAT Permet la consultation des paramètres relatifs aux catalogues

Ces paramètres sont soumis lors des commandes CFTCAT


CFT 2.32-26

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


COM Permet la consultation des paramètres relatifs aux médias de communication

Ces paramètres sont soumis lors des commandes CFTCOM

ETB Permet la consultation des paramètres relatifs aux cartes ETEBAC 3

Ces paramètres sont soumis lors des commandes CFTETB

IDF Permet la consultation des identifiants “réseau” de fichiers

Les identifiants sont paramétrés par les commandes CFTIDF

LOG Permet la consultation des paramètres relatifs aux fichiers de journalisation

Ces paramètres sont soumis lors des commandes CFTLOG

NET 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é

PARM Permet la consultation des paramètres généraux

Ces paramètres sont soumis lors des commandes CFTPARM

PROT 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é

RECV Permet la consultation des paramètres relatifs aux fichiers à recevoir

Ces paramètres sont soumis lors des commandes CFTRECV

SEND Permet la consultation des paramètres relatifs aux fichiers à émettre

Ces paramètres sont soumis lors des commandes CFTSEND

XLATE Permet la consultation des tables de transcodage

Les tables de transcodage sont paramétrées par les commandes CFTXLATE

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 CFTSENDconfiguré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 lescritères de sélection cités dans la commande.

En l’absence d’une précédente commande CONFIG TYPE = OUTPUT, le compte rendu del’exécution est écrit sur la sortie standard du programme CFTUTIL.


CFT 2.3 2-27

2.2.4.1. Syntaxe

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


[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 lecaractère spécial “*” (joker).

Exemple :

ID = PART1 : pour le partenaire PART1 seulement,ID = IB* : pour tous les partenaires dont l’identifiant

commence par “IB”,ID = * : pour tous les partenaires.

[STATE = {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 : partenaire totalement inactif.

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

Définit le type de caractéristiques à lister.


Tableau 17. LISTPART TYPE - Valeurs prédéfinies


ALL Permet la consultation des caractéristiques (générales et réseaux) des partenaires

Paramètres du fichier “PARTENAIRES”

ASY (1) Permet la consultation des paramètres configurés dans la commande CFTASY :

paramètres réseau ASY associés à chaque partenaire

DEST Permet la consultation des paramètres configurés dans la commande CFTDEST :

concernent les listes de diffusion

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


CFT 2.32-28

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


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,

DSA (1) Permet la consultation des paramètres configurés dans la commande CFTDSA :

paramètres réseau DSA associés à chaque partenaire supportant DSA

LU62 (1) Permet la consultation des paramètres configurés dans la commande CFTLU62 :

paramètres réseau LU6.2 associés à chaque partenaire

PART Permet la consultation des paramètres configurés dans la commande CFTPART :

description des données générales relatives aux partenaires

SNA (1) Permet la consultation des paramètres configurés dans la commande CFTSNA :

paramètres réseau SNA associés à chaque partenaire supportant SNA

TCP (1) 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

X25 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

(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 dufichier PARTENAIRES.

Exemple 2 :

LISTPART TYPE = DEST

Permet de visualiser les listes de diffusion.

2.3 Manipulation de fichiers

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),


CFT 2.3 2-29

• les fichiers STATISTIQUES contenant des informations relatives aux transferts terminés(TYPE = ACCNT),

• les fichiers JOURNAUX permettant l’enregistrement des messages associés audé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 etles 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’activerdirectement, par exemple dans les procédures de basculement des fichiers de suivi (voirl’exemple fourni : membre B_EXECLOG).

VM Les fichiers VSAM du moniteur CFT sont créés/supprimés manuellement par la commande CMSAMSERV. Ils doivent être ensuite initialisés par la commandeCFTFILE 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 = {CREATE | DELETE},]FNAME = filename,

[ELSNAME= identifier] OS

TYPE = {ACCNT | CAT | COM | LOG | PARM | PART},[CIPHER = {NO | YES},][MAC = {NO | YES},]

SUIVANT TYPE

[RECNB = n,] OS

[FBLKSIZE = n,] OS

[FSPACEX = n,] OS

[FSPACE = n,] OS

LOCK = filename


CFT 2.32-30


[CIPHER = {NO | YES}]

Demande de chiffrement du fichier.

Ce paramètre concerne le fichier paramètre, le fichier partenaire et le fichier decommunication (TYPE = PARM, PART ou COM).

[FBLKSIZE = {voir le tableau | n }] {0..32768} Suivant TYPE OS

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 letype de fichier à créer.

Tableau 18. CFTFILE FBLKSIZE - Valeurs par défaut et OS concernés

OS PARM PART CAT COM LOG ACCNT

GCOS7 no no 3328 2052 no no

GCOS8 2048 1536 2048 2048 256 768

GUARDIAN no no no no no no

MVS no no no no 132 480

Netware no no no no no no

OS2 no no no no no no

OS400 0 0 0 0 0 0

UNIX no no no no no no

VM no no no no 132 480

VMS no no no no no no

VOS no no no no no no

VSE no no no no 132 480

Win95 no no no no no no

WinNT no no no no 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

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

OS


CFT 2.3 2-31

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


GCOS7 512 700 no no no no

GCOS8 200 200 no no 100 100

GUARDIAN 100 100 no no 2 2

MVS 50 100 no no 200 200

OS400 512 512 no no 512 512


VM 50 100 no no 200 200

VMS no no no no no no

VOS 0 0 no no 0 0

VSE 50 100 no no 200 200


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 lessystèmes. En effet, l’allocation primaire du fichier à créer est déduite de la valeur duparamètre RECNB (nombre d’enregistrements du fichier).

[FSPACEX = {voir le tableau | n }] {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 letype de fichier à créer.

Tableau 20. CFTFILE FSPACEX - Valeurs par défaut et OS concernés


GCOS7 no no no no no no

GCOS8 no no no no UNLIMITED 5000

GUARDIAN 100 100 no no 2 2

MVS 50 100 0 0 50 50

OS400 0 0 0 0 0 0


VM 50 100 0 0 50 50

VMS 0 0 0 0 no no

VOS 0 0 0 no 0 0

VSE 50 100 0 0 50 50


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 degérer la concurrence d’accès à ce fichier.

OS


CFT 2.32-32

[MAC = {NO | YES}]

Demande de scellement du fichier.

Ce paramètre concerne le fichier paramètre et le fichier partenaire (TYPE = PARM ouPART).

[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ésentssimultané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ètresRH, SH, RD, SD, ... de la commande CFTCAT, afin d’éviter une surcharge du fichier, qui setraduirait 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 Fichier statistique des transferts

CAT Fichier catalogue

COM Fichier de communication

LOG Fichier journal

PARM Fichier paramètres

PART Fichier partenaires

2.3.1.3. Exemple de paramétrage CFTFILE

CFTFILE TYPE = PARM,MODE = CREATE,FNAME = filename

Création d’un fichier Paramètres.


CFT 2.3 2-33

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 unformat 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’émissionpar CFT et de décompresser un fichier après réception.

2.3.2.1. Syntaxe

COPYFILE[CREATE = {‘ ’ | YES | NO},][ICT = {H | C},][ICOMP = {0 | cpr},]

[ICODE = {ASCII | EBCDIC},] Dft : OS

IFNAME = filename,

[ITYPE = c,] OS

[IBLKSIZE = n,][ILRECL = n,]

[IRECFM = {F | V | U},] OS

[OCT = {H | C},][OCOMP = {0 | cpr},]

[OCODE = {ASCII | EBCDIC},] Dft : OS

OFNAME = filename,

[OSPACE = {0 | n},] OS

[OTYPE = c,][OBLKSIZE = {valeur de IBLKSIZE | n},][OLRECL = {voir le commentaire | n},]

[ORECFM = { valeur de IRECFM | F | V | U },] 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.32-34

Tableau 22. COPYFILE - Paramètres

Catégorie de paramètre Paramètre concerné

Paramètres de contrôle d’exécution CREATE

Paramètres de traitement des données en entrée ICT, ICOMP, ICODE

Paramètres associés au fichier en entrée :

• nom physique,

• caractéristiques physiques (fichier global),

• caractéristiques physiques (enregistrements)

IFNAME

ITYPE

IRECFM, ILRECL, IBLKSIZE

Paramètres de traitement des données en sortie OCT, OCOMP, OCODE

Paramètres associés au fichier en sortie :

• nom physique,

• caractéristiques physiques (fichier global),

• caractéristiques physiques (enregistrements)

OFNAME

OSPACE, OTYPE

ORECFM, OLRECL, OBLKSIZE


[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, sicelui-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 auxdonné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} OS

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 OUI

GCOS8 OUI

GUARDIAN NON

MVS OUI

OS400 OUI

UNIX NON

VM NON

VMS NON

VOS NON

VSE OUI

WinNT NON


CFT 2.3 2-35

[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ésdans 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 êtrecompatible 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 longueurfournie.

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 dufichier en entrée.


CFT 2.32-36

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 binairesou variables (ITYPE = {B | V}).

VOS 2048.Lorsque IRECFM = F, il est conseillé de toujours spécifier ILRECL.LorsqueIRECFM = V, il faut spécifier ILRECL quand la taille d’enregistrement estsusceptible d’être supérieure à 2048.

[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 CFTcorrespondant à votre OS.Si le fichier d’entrée est compressé (ICOMP différent de 0), la valeur du paramètre IRECFMest 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.


[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 à celledu paramètre OLRECL.

Tableau 24. COPYFILE OBLKSIZE - OS concernés

OS OBLKSIZE

GCOS7 OUI

GCOS8 OUI

GUARDIAN NON

MVS OUI

OS400 NON

UNIX NON

VM NON

VMS NON

VOS NON

VSE OUI

WinNT NON


CFT 2.3 2-37

[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éesdans 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 êtrecompatible avec le type de la compression.

OFNAME = filename

Nom du fichier de sortie.

[OLRECL = {voir le commentaire | n}] {0..32768}


• 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 alorstronqué à 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 lacréation du fichier.

Valeurs par défaut :si le fichier de sortie :

• n’existe pas, valeur de ILRECL,

• existe :

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


CFT 2.32-38

- 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 binairesou 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 tailled’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 CFTcorrespondant à votre OS.Si le fichier de sortie est compressé (OCOMP différent de 0), la valeur du paramètreORECFM est forcée à V.

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

[OSPACE = {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 ; dansle cas contraire, elle est égale à 0.

UNIX VM Paramètre ineffectif.

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

Type du fichier de sortie.



CFT 2.3 2-39

2.3.2.3. Statistiques

L’utilitaire édite les statistiques de l’exécution.

Figure 5. Statistiques de l’exécution - Commande COPYFILE

COPYFILEInput file parameters :

(1) File name IFNAME =*xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

(2) File data code ICODE = xxxxx(3) File Compression type ICT = xxx(4) File Compression value ICOMP = nn(5) File Record Number = nnnnn(6) File size = nnnnn(6b) File size (truncated) = nnnnn

Output file parameters :(7) File name OFNAME =

*xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx(8) File Data code OCODE = xxxxx(9) File Compression type OCT = xxx(10) File Compression value OCOMP = nn(11) File size = nnnnn(11b) File size (padded) = nnnnn(12) Compression rate : nn %

(12b) Expansion rate : nn %


CFT 2.32-40

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 Nom complet du fichier en entrée

2 Codification des données du fichier en entrée

3 Type de compression du fichier en entrée :

• EXT (PeSIT hors SIT)

• CFT (PeSIT CFT à CFT)

4 Valeur de la compression du fichier en entrée

5 Nombre d’enregistrements à copier (fichier en entrée)

6 Taille du fichier en entrée en K octets (1)

6b Taille du fichier en entrée, en K octets, si ILRECL est inférieur à la taille réelle de

l’enregistrement (2)

7 Nom complet du fichier de sortie

8 Codification des données du fichier de sortie

9 Type de compression :

• EXT (PeSIT hors SIT)

• CFT (PeSIT CFT à CFT)

10 Valeur de la compression du fichier de sortie

11 Taille du fichier de sortie en K octets

11b Taille du fichier de sortie en K octets, si padding (OLRECL > ILRECL)

12 Taux de compression réalisé lors de la copie

12b Taux d’expansion réalisé lors de la copie

(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 = ASCII,IFNAME = filename1,ILRECL = 45,IRECFM = V,ICOMP = 0,OFNAME = filename2,OCODE = ASCII,OLRECL = 45,ORECFM = V,OCOMP = 15,OCT = C

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


CFT 2.3 2-41

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 soientchiffré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 = {voir le commentaire | filename},][CONTENT = {ACTIVE | FULL},][FIRST = {1 | n},][LAST = {nombre max d’enregistrements | n},][VERIFY = {NO | YES}]


[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 leparamè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 derenseigner ce paramètre avec la valeur du paramètre NAME de la commande CFTCOMTYPE=FILE.


CFT 2.32-42

[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 fichierdans le paramètre RECNB de la commande CFTFILE.

Le nombre maximum d’enregistrements est celui défini à la création du fichier dans leparamètre RECNB de la commande CFTFILE.

[VERIFY = {NO | YES}]

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

CFT V2.3 3-1

3. Les commandes de paramétrage del’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 encompte à l’exécution.

Généralement, l’utilisateur travaille avec une seule commande CFTPARM présente dans le fichierParamètres. Il peut toutefois y en avoir plusieurs, une seule étant sélectionnée au moment del’activation du moniteur, en précisant (en paramètre d’activation) la valeur de l’identifiant (ID) dela commande CFTPARM choisie (consultez le paragraphe “Activation” du manuel “ Concepts” deCFT).

Si ce paramètre d’activation n’est pas renseigné, le moniteur CFT cherche une commandeCFTPARM 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 detransfert” .

Par ailleurs, le paragraphe "Variables symboliques" du manuel “ Concepts” de CFT décrit l’usagequi peut être fait des variables symboliques, dans la dénomination et dans le corps de cesprocé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".

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

CFT V2.33-2

3.1.2. Syntaxe

CFTPARMCAT = identifier,COM = (identifier, identifier,...),ID = identifier,KEY = { string | #filename},NET = (identifier, identifier,.....),PART = identifier,PARTFNAM = filename,PROT = (identifier, identifier,....),[BUFSIZE = n,]

[COMMENT = string,] PROTOCOLE

[CTLPASSW = {NO | YES},][EXITEOT = identifier,][NPART = string,][DEFAULT = {DEFAUT | identifier},][ACCNT = identifier,][LOG = identifier,][EXECSE = filename,][EXECSM = filename,][EXECRM = filename,][EXECSF = filename,][EXECRF = filename,][EXECRE = filename,][EXECSFA = filename,][EXECSMA = filename,][MAXTRANS = {maximum supporté | n},][MAXTASK = {maximum supporté | n},][MODE = {REPLACE | CREATE | DELETE},][RCVALLER = {STOP | CONTINUE},][SECFNAME = filename,][TRANTASK = {maximum supporté | n},][TRKPART = {NO | ALL | SUMMARY},][TRKRECV = {NO | ALL | SUMMARY},][TRKSEND = {NO | ALL | SUMMARY },]

[USERCTRL = {NO | YES},] OS

[WAITRESP = n,]

[WAITTASK = {1441 | n}] OS


CFT V2.3 3-3

3.1.3. Paramètres

[ACCNT = identifier]

Identifiant de la commande de description de l’enregistrement des données statistiques destransferts (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 dumoniteur, 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ètresRRUSIZE et SRUSIZE des divers protocoles. Si cette valeur est inférieure, le moniteur forcecomme 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 chaquesystème.

Tableau 26. CFTPARM BUFSIZE - Tailles maximales et valeurs par défaut

OS Valeur maximale Valeur par défaut

GCOS7 4096 4096

GCOS8 32700 4096

GUARDIAN 4096 4096

MVS 32767 4104

OS400 32000 4096

UNIX 8192 4096

VM 32767 4104

VMS 8000 4096

VOS 4096 4096

VSE 32767 4104

WinNT 4096 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.33-4

[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 lorsd’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 lacommande CFTPROT est renseigné,

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

[DEFAULT = {DEFAUT | identifier}]

Identifiant par défaut (noté d’une façon générique <default>) des commandes CFTRECV,CFTSEND, CFTXLATE et CFTX25.

CFTRECV et CFTSEND ID = <default>

Ces commandes précisent les valeurs par défaut, complémentaires des paramètres descommandes RECV et SEND, lorsque l’IDF de la requête de transfert n’est pas définiexplicitement par une commande CFTRECV ou CFTSEND.Les commandes CFTRECV et CFTSEND ID = <default> sont obligatoires.

Attention : les caractéristiques des fichiers types par défaut (CFTSEND et CFTRECVd’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 = <default> peut concerner la réception de fichiersde tailles et de formats différents. Lorsque le protocole le permet, il est donc souhaitable queles valeurs des paramètres FSPACE, FRECFM, FORG (...) de cette commande ne soient pasrenseignées, afin que CFT prenne en compte les valeurs réelles du fichier reçu, transmises parle protocole (voir les possibilités de chaque protocole).

CFTXLATE ID = <default>

Cette commande précise les tables de transcodage par défaut, lorsque les commandesSEND/CFTSEND (ou RECV/CFTRECV) et CFTPART ne les désignent pas explicitement.La commande CFTXLATE ID = <default> est facultative ; en cas d’absence, ce sont lestables de transcodage internes au moniteur qui sont utilisées (voir leur description en annexe).

CFTX25 ID = <default>

Exploité par le moniteur pour les appels entrants (fonctionnement en mode serveur).Lorsqu’une description réseau X25 du partenaire, correspondant à la ressource sur laquellearrive l’appel est absente, le moniteur recherche la description “par défaut” :CFTX25 ID = <default>, ...

Cette commande ne fait pas apparaître les paramètres spécifiques à un partenaire, ni lesparamètres propres aux appels sortants (DIALNO, CNXOUT, RETRY*, O*TIME).


CFT V2.3 3-5

[EXECRE = filename]

Nom générique du fichier décrivant les procédures à exécuter, suite à un incident (Erreur) lorsd’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 CFTcorrespondant à 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.


• &IDF, &PARM,


• &RUSER, &SUSER, &USERID,

• &RAPPL, &SAPPL,

• &NIDF.


[EXECRM = filename]

Nom générique du fichier décrivant les procédures à exécuter en fin de réception d’unmessage.


• &IDM, &PARM,



• &RAPPL, &SAPPL.



CFT V2.33-6

[EXECSE = filename]

Nom générique du fichier décrivant les procédures à exécuter, suite à un incident (Erreur) lorsd’un transfert en émission, le transfert passant à l’état H ou K.


• &IDF, &PARM,



• &RAPPL, &SAPPL,

• &DIAGI, &DIAGP,

• &NIDF.


[EXECSF = filename]

Nom générique du fichier décrivant les procédures à exécuter en fin d’émission d’un fichier.


• &IDF, &PARM,



• &RAPPL, &SAPPL,

• &NIDF.


[EXECSFA = filename]

Nom générique du fichier décrivant les procédures à exécuter lors de la réception d’unacquittement (message de type REPLY), suite à l’émission d’un fichier.


• &IDF, &PARM,



• &RAPPL, &SAPPL.



CFT V2.3 3-7

[EXECSM = filename]

Nom générique du fichier décrivant les procédures à exécuter en fin d’émission d’unmessage.


• &IDM, &PARM,



• &RAPPL, &SAPPL.


[EXECSMA = filename]

Nom générique du fichier décrivant les procédures à exécuter lors de la réception d’unacquittement (message de type REPLY), suite à l’émission d’un message.


• &IDM, &PARM,



• &RAPPL, &SAPPL.

Le caractère ‘&’ désigne le caractère char_symb défini dans le “Guide d’exploitation” deCFT 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 pointantsur 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 lenom 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.33-8

KEY = { string33 | #filename}

Clé d’utilisation de CFT dont la valeur est fournie par SOPRA, ou bien nom d’un fichierd’indirection (précédé du caractère<file-symb> spécifique à chaque système) contenantl’ 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 fichierlogique. 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èrecolonne. Toute chaîne de caractères, séparée par au moins un blanc et suivant une clé, estconsidé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 estspécifique au système d’exploitation hôte du produit et limite l’usage de CFT à un nombremaximum de transferts simultanés (limite du paramètre MAXTRANS) ou à une optioncommerciale éventuelle. Par ailleurs, elle limite l’usage de CFT, suivant le type de clé qui estutilisé.

Cette clé peut être :

• de type “ CPU” .

Ce type est utilisé pour la protection liée à l’usage de logiciels complémentairesspécifiques. Cette clé a pour but essentiel de limiter l’utilisation du logiciel CFT auxmachines 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 delimiter la durée d’utilisation du logiciel CFT, jusqu’à une date spécifiée au moment ducalcul de cette clé,

• de type “ LIBELLE” .

Ce type est utilisable pour tous les environnements systèmes. Cette clé a pour but delimiter l’utilisation du logiciel CFT à un usage spécifique désigné par un intitulé. Parexemple : usage limité à l’entreprise cliente,

• de type “ IDF” .

Ce type est utilisé pour la protection liée à l’usage de logiciels complémentairesspécifiques.

[LOG = identifier]

Identifiant de la commande de description des fichiers de journalisation des événements dumoniteur (CFTLOG).

Si ce paramètre n’est pas renseigné, le moniteur CFT écrit les messages destinés à lajournalisation sur la sortie standard du moniteur.


CFT V2.3 3-9

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 4

GCOS8 30

GUARDIAN 2

MVS 64

OS400 32

UNIX 8

VM 64

VMS 8

VOS 10

VSE 64

WinNT 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 valeurfixe la limite physique du produit indépendamment de la limite fixée par la clef de protectionlogicielle.

Tableau 28. CFTPARM MAXTRANS - Nombre maximum

OS Valeur maximale supportée

GCOS7 32

GCOS8 90

GUARDIAN 20

MVS 240

OS400 32

UNIX 64

VM 16

VMS 32

VOS 200

VSE 16

WinNT 16


CFT V2.33-10

NET = (identifier, identifier,....)

Liste d’ identifiants des commandes de description des méthodes d’accès réseau et desressources réseau du moniteur (CFTNET).

Si le paramétrage décrit un nombre d’ identifiants supérieur au maximum autorisé, lacommande 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 etconsultez le “Guide d’exploitation” de CFT correspondant à votre OS.

MVS VM VSE Dans la liste NET = ( ... , ... ), l’ identifiant désignant la commande CFTNETTYPE = SNA, PROFILE = GATE, ... doit obligatoirement être indiqué avant lesidentifiants 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éreraau “ 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 destransferts.

PARTFNAM = filename

Nom du fichier Partenaire.

OS400 L’ emploi du nom logique “+CFTPART” est obligatoire, afin que CFT/400 Managerpuisse 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 fichierset les méthodes d’accès réseau.

Si le paramétrage décrit un nombre d’ identifiants supérieur au maximum autorisé, lacommande 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 etconsulter 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.


CFT V2.3 3-11

[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 unenouvelle tâche est créée, si possible.

Si le nombre de tâches d’accès fichier autorisé est atteint (MAXTASK), les transferts enparallèle supplémentaires (jusqu’à MAXTRANS) sont répartis d’une manière équilibrée surles 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âched’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 8

GCOS8 30

GUARDIAN 10

MVS 14

OS400 32

UNIX 8

VM 14

VMS 8

VOS 20

VSE 14

WinNT Sans objet

GCOS8 Exemple :MAXTRANS = 10,MAXTASK = 2,TRANTASK = 4,

Permet de créer 2 tâches d’accès fichier, gérant chacune4 transferts. Le 9ème et le 10ème transferts sont affectésaux tâches existantes. Le 11ème transfert en parallèle estmis en attente de libération de ressource.


CFT V2.33-12

[TRKPART = {NO | ALL | SUMMARY}]

Spécification du niveau de détail que CFT fournit à Sentinel sur les transferts. CFT envoie lesinformations 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}]






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}]






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.


CFT V2.3 3-13

[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 aufichier à 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 NON

GCOS8 NON

GUARDIAN NON

MVS OUI

OS400 NON

UNIX OUI

VM OUI

VMS OUI

VOS NON

VSE NON

WinNT NON

[WAITRESP = {voir le tableau | n}] {1..32767}

Délai en secondes (Time out) utilisé lors de la communication (interne) entre les différentestâches du moniteur.

Ce paramètre est exploité lors d’un échange synchrone de requêtes entre deux tâches dumoniteur. Au bout de “waitresp” secondes sans réponse, l’attente est interrompue. Unmessage “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 dumoniteur 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

OS Valeur par défaut

GCOS7 100

GCOS8 600

GUARDIAN 5

MVS 60

OS400 1000

UNIX 5


CFT V2.33-14

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


VM 60

VMS 30

VOS 100

VSE 60

WinNT 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 NON

GCOS8 OUI

GUARDIAN NON

MVS OUI

OS400 OUI

UNIX OUI

VM OUI

VMS OUI

VOS OUI

VSE OUI

WinNT 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éesle plus rapidement possible.

3.1.4. Exemple

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


CFT V2.3 3-15

CFTPARM ID = PARM1,KEY = ‘XXXXXXXXXXXXXXXXXXXXX’,NPART = MYCFT,BUFSIZE = 4096,DEFAULT = IDFDEF,TRANTASK = 1,MAXTRANS = 4,MAXTASK = 1,WAITRESP = 500,NET = (SNAGATE , X25LINE1),PROT = (PESITCFT , ETEBAC3),COM = COM1,CAT = CAT1,LOG = LOG1,EXECSF = <filename1>,EXECRF = <filename2>,EXECSE = <filename3>,EXECRE = <filename4> ,PARTFNAM = <filename5>

Dans cet exemple, parmi toutes les commandes soumises en entr ée deCFTUTIL, 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 (commandesCFTRECV et CFTSEND) doivent inclure, au minimum, deux commandesassoci é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 çondont CFT s ’ identifie aupr ès des partenaires distants, auront pourvaleur par d éfaut “ MYCFT”.

Le moniteur soumettra, en fin de transfert et selon le sens et letype de transfert, le fichier de commande obtenu par recopie ettraduction des variables symboliques, à partir des fichiers decommande point és par les param ètres suivants :

• EXECSF pour les actions faisant suite à é mission defichier,

• 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 lavaleur de ces param ètres, permettra de constituer le nom v éritabledu fichier.


CFT V2.33-16

3.2 CFTCOM - Modes de communication applications / moniteur CFT

La commande CFTCOM permet au moniteur d’ouvrir des médias de communication avec lesapplicatifs.

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 lemoniteur. 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 unfichier 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 lettresdéfinie par son nom logique.

• un média de communication synchrone s'appuyant sur un réseau TCP/IP (paramétrageTYPE = TCPIP).

Les médias de communication utilisables par système sont indiqués dans le Guide d’exploitationcorrespondant.

Il doit y avoir cohérence entre la déclaration du média de communication, utilisé par unprogramme 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 Il est nécessaire de définir 1 fichier de communication réservé aux applicationsBATCH/TSO, et 1 second fichier de communication réservé aux applicationsCICS (si besoin est).

WinNT Dans une exploitation “stand-alone” , les requêtes émises par les applicatifs Windows concernent le moniteur et dans ce cas, la méthode de communicationconseillée est la boîte aux lettres.Dans une exploitation en réseau local, les requêtes émises par les applicatifsWindows 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 = {REPLACE | CREATE | DELETE},]ID = identifier,TYPE = {FILE | MBX | TCPIP},

TYPE=FILE

NAME = filename,[WSCAN = {60 | n}]

TYPE=MBX

NAME = string


CFT V2.3 3-17

TYPE=TCPIP

PROTOCOL = {XHTTP | XHTTPS},HOST = string,PORT = numérique,[ADDRLIST = (string,string…),][DISCTS = 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 lamachine.

TYPE=MBX

NAME = string string 8

TOUS SYSTEMES SAUF - GCOS7

string 4 GCOS7

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

GCOS7 Nom normalisé “CFTi” avec i de 0 à 9.

VM “userid” de la machine virtuelle du moniteur.


CFT V2.33-18

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 adressesmaximum).

Si une valeur débute par le caractère #, elle désigne un fichier dans lequel chaque lignereprésente une adresse.

Tableau 33 CFTCOM ADDRLIST - Types d'adresses autorisées

Cas Format Traitement

1 ADDRLIST = 172.* Seuls les clients dont l’adresse IPcommence par 172 sont autorisés

2 ADDRLIST = *.axway Seuls les clients dont le nom de hostse termine par « .axway » sontautorisés

3 ADDRLIST = (172.23.160.81, 172.23.160.82) Seuls les clients dont l'adresse IPcomplète est indiquée sont autorisés

4 ADDRLIST = #FichierListe Le fichier contient la liste des adressesautorisées

[DISCTS = n]

Délai d'attente (en secondes) avant libération d'un canal ouvert par un client, en l'absence derequê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.


CFT V2.3 3-19

3.2.3. Exemples

TYPE=FILE

CFTCOM ID = IDCOM,TYPE = FILE,NAME = <filename> ,WSCAN = 120

TYPE=MBX

CFTCOM ID = IDCOM,TYPE = MBX,NAME = <mbxname>

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écifiqueindiqué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 depurge du catalogue peut se prolonger mais sans perturber de manière sensible les transferts.

3.3.1. Syntaxe

CFTCATFNAME = filename,ID = identifier,TIMEP = {23595999 | HHMMSSCC},[CACHE = n,][MODE = {REPLACE | CREATE | DELETE},][OPTIMIZE = [NONE | CACHE | MEMORY},][RH = {10 | n},][RKERROR = {KEEP | DELETE},][RT = {10 | n},][RX = {10 | n},][SH = {10 | n},][ST = {10 | n},][SX = {10 | n},][UPDAT = {1 | n},][WSCAN = {5 | n}]


CFT V2.33-20

3.3.2. Paramètres

[CACHE = {voir le commentaire | n}] {512..32000}

Paramètre de dimensionnement du buffer mémoire (cache) du moniteur, contenant lestransferts en attente de ressource.

Exprimé en nombre de postes du catalogue, chaque poste occupant 62 octets. Un bufferimportant 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 lacarte 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 parexemple), la mise à jour n'est pas garantie et le fichier peut se retrouver dans un étatincohérent. Dans un tel cas, utiliser l'utilitaire de migration en procédant de la façonsuivante :

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 auxtransferts 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.


CFT V2.3 3-21

RH = {10 | n}] {1..99}

Nombre de jours au bout desquels les postes catalogue des demandes de réception “nonterminé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 dernierqui 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) sontpurgés automatiquement.

[RX = {10 | n}] {1..99}

Nombre de jours au bout desquels les postes catalogue des réceptions dont la procédure de finde 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 “nonterminé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) sontpurgés automatiquement.

[SX = {10 | n}] {1..99}

Nombre de jours au bout desquels les postes catalogue des émissions terminées, dont laprocédure de fin d’émission s’est correctement exécutée (état SX), sont purgésautomatiquement.

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 renseignantTIMEP = 00000000. Cette opération est à utiliser avec précaution car, dans ce cas, aucunepurge 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 fichiercatalogue pendant un transfert.

Une mise à jour permet l’écriture sur disque du nombre d’enregistrements transmis etacquittés, pour le transfert concerné.


CFT V2.33-22

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 laconsommation 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 detransfert.

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 lesré ceptions interrompues, sont purg ées automatiquement au bout de7 jours ( état RH).

Les postes des émissions termin ées ( état ST) ainsi que les postesdes r éceptions termin ées ( état RT), sont purg és automatiquement aubout de trois jours. Les postes des émissions et des r éceptionstermin ées dont la proc édure de fin s ’ est bien ex écut ée ( états SXet RX), sont purg és automatiquement au bout de trois jours.

Le param ètre UPDAT n ’ est pas mentionn é ; il prend la valeur 1 (pardéfaut), ce qui se traduit par une mise à jour du fichiercatalogue à 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 cettecommande.

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.


CFT V2.3 3-23

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 à lalimite fixée par le paramètre MAXREC ou bien, selon les possibilités des OS, le fichierest 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 cecas, 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 videsuite au traitement du fichier journal.

Le basculement entraîne l’exécution de la procédure décrite par le paramètre EXEC de cettecommande. Typiquement, cette procédure peut exécuter une sauvegarde, la création d’un nouveaufichier 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 moniteurCFT (commande CFTFILE TYPE = LOG, ....).

3.4.1. Syntaxe

CFTLOGAFNAME = filename,ID = identifier,EXEC = filename,FNAME = filename,[CONTENT = {FULL | BRIEF},][LENGTH = {133 | n},][MAXREC = {0 | n},][MODE = {REPLACE | CREATE | DELETE},]

[NOTIFY = identifier,] OS

[OPERMSG = n,] OS

[SWITCH = {00000000 | time},]

3.4.2. Paramètres

AFNAME = filename

Nom du fichier journal “alterné”.

Il est déconseillé d’utiliser un nom logique.


CFT V2.33-24

[CONTENT = {FULL | BRIEF}]

Filtrage des messages écrits dans le fichier LOG actif.


• FULL : tous les messages sont édités.

• BRIEF : les messages suivants n’apparaissent plus dans la LOG (ce sont des messages decatégorie “ information système” - voir le paramètre OPERMSG de CFTLOG) :

CFTR12I &cmd TreatedCFTC07I PART=&part IDF=&idf IDT=&idt State=&state Deleted

- en mode demandeur :CFTT53I PART=&part IDF=&idf IDT=&idt Requester file selectedCFTT55I PART=&part IDF=&idf IDT=&idt Requester file openedCFTT51I PART=&part IDF=&idf IDT=&idt Requester session openedCFTT56I PART=&part IDF=&idf IDT=&idt Requester file closedCFTT54I PART=&part IDF=&idf IDT=&idt Requester file deselectCFTT52I PART=&part IDF=&idf IDT=&idt Requester session closed

- en mode serveur :CFTT51I PART=&part IDF=&idf IDT=&idt Server session openedCFTT53I PART=&part IDF=&idf IDT=&idt Server file createdCFTT55I PART=&part IDF=&idf IDT=&idt Server file openedCFTT56I PART=&part IDF=&idf IDT=&idt Server file closedCFTT54I PART=&part IDF=&idf IDT=&idt Server 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 startedCFTT58I PART=&part IDF=&idf IDT=&idt Requester transfer ended

• en mode serveur :

CFTT57I PART=&part IDF=&idf IDT=&idt Server transfer startedCFTT58I 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 dernierfichier journal utilisé avant basculement (fichier courant).

FNAME = filename

Nom du fichier journal.

Il convient de veiller à ce que le fichier <filename> existe et soit accessible ; dans le cascontraire, les informations sortiront tronquées sur la sortie standard CFTOUT et ne seront pasexploitables. Ceci est également valable lorsque le journal courant est le fichier défini parAFNAME.Il est déconseillé d’utiliser un nom logique.


CFT V2.3 3-25

ID = identifier

Identifiant de la commande CFTLOG.

[LENGTH = {133 | n}] {0..1024}

Taille des enregistrements du fichier journal.

La valeur de ce paramètre est fournie dans les exemples livrés. Cette valeur n’a pas à êtremodifiée.

[MAXREC = {0 | n}] {0..4294967295}

Nombre d’enregistrements inscrits dans le fichier journal, à partir duquel le basculementautomatique sera effectué.

MAXREC=0 signifie qu’ il n’y a pas de basculement automatique sur le nombred’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 moniteurCFT (l’écran de soumission, par exemple).

La valeur du paramètre NOTIFY doit être alors renseignée à ‘ ’ (8 caractèresblancs),

• 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 leformat “xxxxxxxx”.

Le tableau suivant indique les destinataires possibles suivant le système.

Tableau 34. CFTLOG NOTIFY - Destinataires possibles

OS Submitter du moniteur Console opérateur Utilisateur quelconque

GCOS7 OUI OUI OUI

GCOS8 OUI OUI NON

GUARDIAN OUI OUI OUI

MVS NON OUI OUI

OS400 OUI OUI OUI

UNIX OUI OUI OUI

VM NON OUI OUI

VMS NON OUI OUI

VOS OUI OUI OUI

VSE NON OUI NON

WinNT OUI NON NON


CFT V2.33-26

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 pourchaque système.

Tableau 35. CFTLOG NOTIFY - Valeurs par défaut

OS Valeur par défaut pour NOTIFY

GCOS7 OP

GCOS8 ‘ ’

GUARDIAN OPLOG

MVS OP

OS400 ‘ ’

UNIX ‘ ’

VM OP

VMS OP

VOS OP

VSE ‘ ’

WinNT ‘ ’

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 “ consoleopérateur ”

Caractèresinterpr étés

Messages dirigés vers

GCOS7 OP La console opérateur

GCOS8OP000001OP000002OP000003OP000004

La console opérateur désignée par un numéro :• console TY1• console TY2• console TY3• console TY4

GUARDIAN OP La console opérateur

MVS OP La (ou les) console(s) opérateur(s)

OS400 OP La “message-queue” QSYSOPR

UNIX OP La console opérateur

VM OP La machine opérateur

VMS OPxxxxxx La console système et le fichier LOG systèmepériphérique de sortie identifié par le lien “xxxxxx”présent dans le répertoire courant d’exécution dumoniteur

VOS OPouOPxxxxxx

La console système et le fichier LOG systèmepériphérique de sortie identifié par le lien “xxxxxx”présent dans le répertoire courant d’exécution dumoniteur

VSE OP La console opérateur

WinNT Sans objet


CFT V2.3 3-27

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

Dans le cas “ utilisateur” :

MVSLes messages CFT sont émis par SEND à destination du USERID TSO précisé ; dans cecas, 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, latâ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ébriquedes 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 Messages d’ information d’exploitation I

2 Messages d’ information système I

4 Messages d’attention d’exploitation W

7 Messages d’attention système W

16 Messages d’erreur d’exploitation E

32 Messages d’erreur système E

64 Messages d’erreur fatale d’exploitation F

128 Messages d’erreur fatale système F

Explications sur le contenu du tableau :les types I,W,E,F correspondent au type de message indiqué dans le journal (consultez leguide “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éespour chaque système.

Tableau 38. CFTLOG OPERMSG - Valeurs par défaut

OS Valeur par défaut pour OPERMSG

GCOS7 0

GCOS8 0

GUARDIAN 3

MVS 0

OS400 0

UNIX 3

VM 0


CFT V2.33-28

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


VMS 0

VOS 3

VSE 0

WinNT 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 fichiersjournaux à minuit.

Il convient de noter que les paramètres MAXREC et SWITCH peuvent être tous deuxrenseigné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 éduredéclench ée lors du basculement se trouve dans le fichier nomm é parle param ètre EXEC. La taille des enregistrements est la valeur pardéfaut, c ’ est- à-dire 133 caract ères. La valeur du param ètreOPERMSG permet de ne rediriger que les messages d ’ erreur versl’ 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 statistiquessur les transferts terminés correctement (état T ou X).Cette commande est prise en compte lorsque le paramètre ACCNT de la commande CFTPARMest renseigné.

CFT n’autorise qu’un seul identifiant de type CFTACCNT.


CFT V2.3 3-29

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 desdonnées et leur gestion (paramétrage TYPE = FILE). Ce mode est accessible sur TOUSLES SYSTEMES,

• l’ enregistrement des données sur les fichiers de l’utilitaire d’accounting du systèmed’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 letableau 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) 0

Sens du transfert 1

Type de transfert (Fichier, Message ou message de Réponse) 2

Identifiant du partenaire immédiat (PART) 3

Identifiant de l’émetteur (SPART) 12

Identifiant du récepteur (RPART) 21

Identifiant de l’applicatif utilisateur émetteur (SUSER) 30

Identifiant de l’applicatif utilisateur récepteur (RUSER) 46

Identifiant du fichier type (IDF) 62

Identifiant de l’application locale (IDA) 71

Identifiant du transfert (IDT) 80

Nombre d’enregistrements transmis 89

Nombre de caractères du fichier 100

Nombre de caractères émis sur la ligne 111

Date et heure de dépôt de la commande dans le catalogue 122

Date et heure de début de transfert 140

Date et heure de fin de transfert 158

Durée du transfert (en secondes) 176

Indicateur de liste de diffusion 183

Identifiant du protocole applicatif 184

Identifiant du propriétaire du transfert (USERID) 193

Identifiant du groupe (GROUPID) 209

Taux de compression des données en ligne 225

Taille (maxi) de l’enregistrement du fichier (FLRECL) 228

Format du fichier (FRECFM) 234

Code de la compression protocolaire (NCOMP) 235

Nom du fichier transmis (FNAME) 238


CFT V2.33-30

Tableau 39. CFTACCNT - Liste des rubriques (suite)

Rubrique Offset

Paramètre privé CFT (PARM) 303

Identifiant de l’applicatif émetteur (SAPPL) 384

Identifiant de l’applicatif récepteur (RAPPL) 433

Groupe du partenaire (GROUP) 482

Total 491

TYPE=FILE

Lorsque le fichier “statistique CFT” est plein, c’est-à-dire lorsque le nombre maximumd’enregistrements (paramètre MAXREC) a été atteint, le moniteur CFT effectue un basculementsur 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 manuellementle fichier statistique, à la demande.

Le moniteur CFT doit disposer, à son activation, d’au moins 1 fichier statistique vide. Si lepremier 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 basculementpour 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 Il faut renseigner le paramètre ACCID identifiant l’application CFT.

VM 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éesstatistiques sont tronquées à 255 caractères. Il est donc déconseillé d’utiliserTYPE = SYST pour VMS .


CFT V2.3 3-31

3.5.1. Syntaxe

CFTACCNT[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,[LANGUAGE = {COBOL | C},][TYPE = {FILE | SYST},]

TYPE=FILE

FNAME = filename,AFNAME = filename,[MAXREC = n,]EXEC = filename,[SWITCH = {00000000 | time}]

TYPE=SYST

ACCID = n 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” . EnCOBOL, 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écritspar 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 dernierfichier statistique utilisé avant basculement.


CFT V2.33-32

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 celleimposé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 statistiquealterné.

Lorsque ce paramètre n’est pas renseigné, il y a un basculement quotidien des fichiersstatistiques à 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/MVSdoit 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 = <filename1> ,AFNAME = <filename2>,MAXREC = 1000,EXEC = <filename3>

Cette commande d éfinit l ’ enregistrement des donn ées statistiquesdes transferts dans des fichiers propres à CFT. Elle d ésigne lesfichiers statistique et statistique altern é (param ètres FNAME etAFNAME). Les donn ées y sont enregistr ées aux fins d’êtreexploit ées par un programme applicatif écrit en langage C.

Le basculement a lieu manuellement (commande SWITCH) ou lorsque lenombre d ’ enregistrements statistiques est égal à 1000. Laproc édure d éclench ée lors d ’ un basculement se trouve dans lefichier d ésign é par le param ètre EXEC.


CFT V2.3 3-33

TYPE=SYST

CFTACCNT ID = ACCNT, TYPE = SYST, ACCID = n si GCOS7 MVS VM

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

CFT V2.3 4-1

4. Les commandes de paramétrage del’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 baseVFM, 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 etle déroulement des émissions.

Une commande CFTSEND (commande “défaut” exceptée) contrôle l’émission du fichier type demê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 permetd’honorer automatiquement des demandes de réception transmises à l’improviste par unpartenaire distant (mode serveur exclusivement).

Si l’on veut couvrir les deux cas, pour un fichier type (IDF) donné, il faut prévoir deuxcommandes 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 casde 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 lescommandes CFTSEND, en mettant la commande CFTSEND “défaut” soit en première, soit enderniè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 sontinvariantes d’un transfert à l’autre et que CFT ne peut pas retrouverautomatiquement.

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

CFT V2.34-2

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

- d’autre part, en tant que valeurs par défaut pour les caractéristiques “réseau” dufichier, 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 fichierpeut même être transmis - voir plus loin la définition du “mode ouvert” ).

Les caractéristiques physiques que CFT peut retrouver automatiquement pour le fichierlocal, peuvent être considérées comme des valeurs par défaut pour les paramètres deCFTSEND correspondants (exemple : longueur d’enregistrement locale : FLRECL),paramètres constituant eux-mêmes des valeurs par défaut pour les caractéristiquesréseau (exemple : longueur d’enregistrement transmise au correspondant : NLRECL).

Par ailleurs, lorsque le transfert est déclenché par une commande SEND localecomportant explicitement un ou plusieurs paramètres qui figurent également dans lacommande CFTSEND, suivant la valeur du paramètre FORCE :

- si FORCE = NO : ce sont ceux de la commande SEND qui priment sur ceux de lacommande 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 ceuxde 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

CFTSENDID = identifier,[COMMENT = string,][CYCDATE= date,][CYCLE = {0 | n},][CYCTIME = time,][DELETE = {NO | YES},][EXEC = filename,][EXECSUB = { LIST | FILE}][EXIT = identifier,][FACTION = {NONE | ERASE | DELETE},]

[FBLKSIZE = n,]OS


CFT V2.3 4-3

[FCODE = { ASCII | BINARY | EBCDIC},][FDISP = {SHARE | OLD},]²

[FKEYLEN = {0 | n},]PROTOCOLE

[FKEYPOS = {0 | n},]PROTOCOLE

[FLRECL = n,][FNAME = {filename | mask | dirname | #filename | #mask | #dirname},][FORCE = {NO | YES},]

[FORG = {SEQ | INDEXED | DIRECT},]OS

[FRECFM = {F | V | U},]OS

[FSPACE = n,]

[FTYPE = c,]OS

[GROUPID = string,][IMPL = {NO | YES},][MAXDATE = {voir commentaire | date},][MAXTIME= {23595999 | time},][MINDATE = {date système du jour | date},][MINTIME = {00000000 | time},][MODE = {REPLACE | CREATE | DELETE},]

[NBLKSIZE = n,]PROTOCOLE

[NCODE = {ASCII | BINARY | EBCDIC},]PROTOCOLE OS

[NCOMP = cpr,]PROTOCOLE

[NFNAME = { filename | *filename],]PROTOCOLE

[FKEYLEN = {0 | n},]PROTOCOLE

[FKEYPOS = {0 | n},]PROTOCOLE

[NLRECL = n,][NOTIFY = identifier,]

[NRECFM = {F | U | V},]

[NSPACE = n,]PROTOCOLE OS

[NTYPE = c,]PROTOCOLE OS

[OPERMSG = n,]

[PARM = string,]PROTOCOLE

[PRI = {128 | n},]

[RAPPL = string,]PROTOCOLE


CFT V2.34-4

[RUSER = string,]PROTOCOLE

[SAPPL = string,]PROTOCOLE

[SELFNAME = filename][STATE = {DISP | HOLD | KEEP},]

[SUSER = string,]PROTOCOLE

[TCYCLE = {DAY | MIN | MONTH},]

[TRK = {UNDEFINED | ALL | SUMMARY | NO},][USERID = {“userid du moniteur CFT” | string,][WFNAME = filename,][XLATE = 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 :

– 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 4-5

• 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/oucaractéristiques physiques de fichier - lorsque celles-ci sont prévues dans les unités demessage (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 auniveau de la commande CFTRECV et dans le “Guide d’exploitation” spécifiqueconcerné,

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



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 lavaleur par défaut de CYCDATE est MINDATE + TCYCLE*CYCLE ; sinon, cette valeur estCYCDATE = MINDATE.

Exemple :

si TCYCLE = DAY et CYCLE = 2, la valeur par défaut de CYCDATEest MINDATE + 2 jours.

CYCLE = {0 | n} {0..32767}

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


CFT V2.34-6

[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 deCYCTIME est : MINTIME + TCYCLE*CYCLE ; sinon, CYCTIME = MINTIME.

Exemple :

si TCYCLE = MIN et CYCLE =60, la valeur par d éfaut de CYCTIMEest MINTIME + 1 heure.

[DELETE = {NO | YES}]

Suppression automatique des postes du catalogue en état ‘T’ (terminé) pour l’ IDFcorrespondant.

Si l’utilisateur spécifie des procédures de fin de transfert (paramètres EXECSF et EXECRFde 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 despostes 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’enmettant 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 dansl’ ensemble des procédures associées, sont les mêmes que celles autorisées pour les procéduresde fin de transfert référencées dans CFTPARM (consultez le paragraphe “Variablessymboliques” 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 finde transfert,

• si le fichier n’existe pas, aucun traitement n’est exécuté en fin de transfert (même si leparamè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 commandeCFTPARM 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 enmilieu hétérogène :

• 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 4-7

[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 commanded’émission précise FACTION = DELETE, ce paramètre est ignoré. Aucun répertoire ou fichier nesera 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 lefichier à émettre. C’est alors cette valeur (réelle) qui sera prise en compte à l’activation dutransfert.

Tableau 40. CFTSEND FBLKSIZE - OS concernés

OS Utilisation

GCOS7 OUI

GCOS8 OUI

GUARDIAN NON

MVS OUI

OS400 NON

UNIX NON

VM NON

VMS NON

VOS NON

VSE OUI

WinNT 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 fonctiondu type (FTYPE) de fichier émis (si nécessaire, consultez le “Guide d’exploitation” CFTcorrespondant à 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 explicationsfournies au niveau du paramètre NCODE de la présente commande.


CFT V2.34-8

[FDISP = {SHARE | OLD}]

Option de partage du fichier :

• SHARE : accès partagé,

• OLD : accès exclusif.

[FKEYLEN = {0 | n}]

Longueur de la clé d’un fichier indexé.

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

[FKEYPOS = {0 | n}]

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


[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) desenregistrements de ce fichier,

• format indéfini (FRECFM = U) : longueur maximale (en octets) desenregistrements 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 cettefonctionnalité est supportée,

• certains systèmes, en remplacement de cette fonctionnalité, génèrent des longueursd’enregistrement implicites :

WinNTLongueur implicite = 512

UNIXLongueur implicite= 512 pour les fichiers texte (FTYPE=T, O ou X),= 4096 pour les fichiers binaires (FTYPE=B).

VOSLongueur implicite = 2048.FRECFM = F : toujours préciser FLRECL.FRECFM = V : préciser FLRECL quand la longueur d’enregistrement estsusceptible de dépasser 2048.

PeSIT E

PeSIT E


CFT V2.3 4-9

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

Nom du fichier local à émettre, nom de répertoire, nom de fichier d’ indirection, masque desé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 estprécédé du caractère <file-symb> spécifique à chaque système. Dans la plupart desenvironnements, 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 estd’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 SENDou 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 setrouve dans le fichier fourni

4 FNAME = {#mask | #dirname} Envoi d’un groupe de fichiers après sélection surle nom générique fourni (#mask)

Envoi de tous les fichiers contenus dans leré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 lessuivantes :

• &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.34-10

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êtedans le catalogue, ces variables ne peuvent donc être utilisées dans FNAME qu’en cas deSEND implicite.

Le caractère ‘&’ remplace ici le caractère char_symb spécifique à chaque systèmed’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’émissionimplicite (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étrageFNAME=&NFNAME), on est dans le mode de fonctionnement dit mode ouvert.

Emission d’un fichier à versions MVS VMS

Ce nom comporte une racine et un numéro de version. Suivant le cas, la traduction du nomrelatif en nom absolu s’effectue à des étapes différentes.

Tableau 42. CFTSEND FNAME - Fichier à versions

Commande Numéro de version Paramètre Traduction en nomabsolu

CFTSEND seulement à 0 ou -n IMPL=YES Au démarrage dutransfert

IMPL=NO Au dépôt de la requêtedans le catalogue

SEND – à 0 ou à -n

– cas particulier de MVS (1)FNAMEABS=YES Au dépôt de la requête

dans le catalogue

FNAMEABS=NO Au démarrage dutransfert

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 notationutilisée dans le JCL.

//ST1 EXEC PGM=USER

//DD1 DD DSN=FIC(+1)

//ST4 EXEC PGM=CFTX

SEND FNAME=FIC(+1)


CFT V2.3 4-11

VMS

L’ exemple de fichier à versions précédent est aussi applicable si la valeur de DSN et FNAMEest 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’émissionimplicite (CFTSEND IMPL=YES). Dans ce cas, il est possible d’émettre la version de fichierdemandé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épertoiredistant” dans le manuel ” Concepts”.

Cas 3 : envoi d’un groupe de fichiers dont la liste se trouve dans le fichier fourniFNAME =#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 <file-symb> spécifique à chaquesystème. Dans la plupart des environnements, c’est le ’#’ qui est utilisé (consultez le tableaudes valeurs spécifiques dans le ”Guide d’exploitation” de CFT correspondant à votre systèmed’exploitation).

Un poste catalogue est créé pour chaque fichier. Le transfert de chacun des fichiers s’effectueselon les mêmes modalités qu’un transfert en émission habituel.

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

Cas particulier :il est possible de renseigner une liste de répertoires à émettre dans le fichier d’ indirection. Lecritère de mise en œuvre de copie/concaténation pour chaque répertoire transmis est identiqueaux autres modes de transmission générique.

Il est fortement déconseillé de remplir un fichier d’ indirection avec un ensemble mixte defichiers et de répertoires.


CFT V2.34-12

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 nomgénérique ou du nom de répertoire. Suivant les systèmes d’exploitation, le mécanisme desé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 CFTPARTidentique au système local), les fichiers sélectionnés sont copiés et concaténés dans un fichierde travail (voir paramètre WFNAME) défini dans la commande d’émission. Deux postes sontcréé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 catalogueainsi qu’un poste de transfert pour chaque fichier sélectionné.

Pour une information complémentaire, consultez l’annexe “Emission d’un groupe defichiers” 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 etpar 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 à ceuxdéfinis dans la commande CFTSEND associée. Ainsi, si un paramètre n’est pasexplicitement renseigné dans SEND mais dans CFTSEND, c’est la valeur renseignéedans cette commande CFTSEND qui sera prise en compte,

• FORCE = YES :

les paramètres spécifiés dans CFTSEND sont prioritaires par rapport à ceux définisdans une commande SEND associée. Ainsi, si un paramètre n’est pas explicitementrenseigné dans CFTSEND mais dans SEND ou si la valeur renseignée dans CFTSENDest la valeur par défaut, c’est la valeur renseignée dans cette commande SEND qui seraprise en compte.Un message informera l’utilisateur que sa commande est partiellement prise en compte.


CFT V2.3 4-13

[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 fichiersd’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” CFTcorrespondant à 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écifiquecorrespondante.

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 deformat 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 dechaque transfert, la taille du fichier qu’ il va émettre (si nécessaire, vérifier dans le “Guided’exploitation” de CFT correspondant à votre OS que cette fonctionnalité est bien supportéepar 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 physiquementimplanté sur une autre machine que celle sur laquelle CFT s’exécute.


[GROUPID = string15]

Information complétant le USERID de la commande CFTSEND.


CFT V2.34-14

ID = identifier

Identifiant local de fichier type (IDF) à émettre.

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

[IMPL = {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 IMPLvalorisé à “YES” permet au moniteur CFT de mettre à disposition le fichier correspondant, engénérant automatiquement une requête d’émission. Ceci permet une mise à dispositionpermanente d’un fichier.

Attention : ce paramètre ne doit pas être égal à “YES” pour la description du fichier type pardé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 encompte de la commande. Cette valeur est alors exprimée en nombre de jours.

Exemple :

MAXDATE = +4 signifie que le dernier jour de validit é dutransfert est dans 4 jours par rapport à la date de priseen 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 encompte de la commande.


CFT V2.3 4-15

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 é dutransfert est l ’ heure de prise en compte de la commandeadditionn ée de 180 minutes.

Cette heure de prise en compte doit être inf érieure à 21heures.

MAXTIME ne doit pas être égal à MINTIME sauf si MAXDATE est renseigné et n’est pas ladate du jour.

[MINDATE = {date système du jour | date}] Pris en compte uniquement en mode demandeur

Premier jour de validité des transferts.



• ou dans les commandes SEND, d’une manière relative par rapport à la date de prise encompte de la commande. Cette valeur est alors exprimée en nombre de jours.

Exemple :

MINDATE = +2 signifie que le premier jour de validit é dutransfert est dans 2 jours par rapport à la date de priseen compte de la commande.


[MINTIME = {00000000 | time}] Pris en compte uniquement en mode demandeur

Heure minimum de validité du transfert, pour le premier jour.



• ou dans les commandes SEND, d’une manière relative par rapport à l’heure de prise encompte de la commande.

Dans ce cas, l’heure absolue correspondante doit être inférieure à 24 heures. La valeurindiquée est exprimée en minutes.

Exemple :

MINTIME = +30 signifie que l ’ heure minimum de validit é dutransfert est l ’ heure de prise en compte de la commandeadditionn ée de 30 minutes. Cette heure de prise en comptedoit être inf érieure à 23 h 30.

MINTIME ne doit pas être égal à MAXTIME sauf si MAXDATE est renseigné et n’est pas ladate du jour.


CFT V2.34-16

[NBLKSIZE = {valeur de FBLKSIZE | n}] PeSIT D profil CFT

PeSIT E CFT/CFT

Taille de bloc du fichier, au sens protocolaire. OS

Peut être utilisé pour un transfert vers un partenaire dont le système gère la notion de taille debloc (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, pourchaque 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 ; lecode (ASCII ou EBCDIC) de la machine du partenaire est alors déduit de la valeur duparamè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 enEBCDIC) :

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

- si NCODE est différent de FCODE, il y a toujours transcodage ASCII/EBCDIC ouEBCDIC/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 unparamè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 sontcodé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 lacommande CFTSEND, sont les mêmes que pour le paramètre SCOMP de la commandeCFTPROT. 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 (consultezl’ annexe “ Compression” pour des informations complémentaires).


CFT V2.3 4-17

PeSIT D profil CFT PeSIT D profil EXTERN

PeSIT E

Ce paramètre n’a lieu d’être utilisé qu’en cas detransferts en protocole PeSIT (avec le profil ou laversion indiquée), lorsque la valeur du paramètreSCOMP de la commande CFTPROT est excessivepour le fichier type considéré.

ODETTE Ce paramètre sert à inhiber éventuellement la

compression lors d’une émission consécutive à unephase de connexion, laquelle la compression a éténégociée à 1 (SCOMP et/ou RCOMP deCFTPROT à 1).

[NFNAME = { filename | *filename}] 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’utiliserou non le nom de fichier transmis.

Le nom du fichier physique peut :


• 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 nomphysique du fichier à recevoir (ce nom est défini à partir d’un paramétrage tel queFNAME=&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 fichierré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 lessuivantes :



• &SUSER, &RUSER,

• &SAPPL, &RAPPL,


• &NIDF,

• &BDATE, &BTIME, &BYEAR, &BMONTH, &BDAY.

Le caractère ’&’ remplace ici le caractère char_symb spécifique à chaque systèmed’exploitation (consultez le “ Guide d’exploitation” de CFT correspondant à votre OS).


CFT V2.34-18

Emission d’un fichier à versions MVS 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é.


[NKEYPOS = {valeur de FKEYPOS | n}] PeSIT E

Position (en octet) de la clé dans l’article d’un fichier indexé.


[NLRECL = {valeur de FLRECL | n}]


• 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 parNLRECL, 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 Dans le cadre du protocole ODETTE, consultez le “ Guide des protocoles” de CFT pourl’ usage particulier qui est fait de ce paramètre.


Définit la destination des messages associés à l’émission parmi les messages du journal, par lavaleur du paramètre OPERMSG.






CFT V2.3 4-19






Tableau 43. CFTSEND NOTIFY - Destinataires possibles

OS Submitter dumoniteur

Console opérateur Utilisateur quelconque

GCOS7 OUI OUI OUI

GCOS8 OUI OUI NON


MVS NON OUI OUI

OS400 OUI OUI OUI

UNIX OUI OUI OUI

VM NON OUI OUI

VMS NON OUI OUI

VOS OUI OUI OUI

VSE NON OUI NON

WinNT OUI NON NON



Tableau 44. CFTSEND NOTIFY - Valeurs par défaut


GCOS7 ‘ ’

GCOS8 ‘ ’

GUARDIAN OPLOG

MVS OP

OS400 ‘ ’

UNIX ‘ ’

VM OP

VMS OP

VOS ‘ ’

VSE ‘ ’

WinNT ‘ ’


Dans le cas “ console opérateur” , les choix possibles sont indiqués dans le tableau suivant.


CFT V2.34-20

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




GCOS7 OP Console opérateur

GCOS8OP000001OP000002OP000003OP000004

Console opérateur désignée par un numéro parmi :• console TY1• console TY2• console TY3• console TY4

GUARDIAN OP Console opérateur


OS400 OP “message-queue” QSYSOPR (2)

UNIX OP Console opérateur

VM OP Machine opérateur

VMS OP Console opérateur

VOS OPouOPxxxxxx

Console système et dans le fichier LOG systèmepériphérique de sortie identifié par le lien“xxxxxx” présent dans le répertoire courantd’exécution du moniteur

VSE OP Console opérateur

WinNT 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.


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, latâ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,


PeSIT D profil EXTERN

PeSIT profil ANY

PeSIT E

En protocole PeSIT profil SIT et EXTERN, la valeurNFRECFM = U n’est pas connue au sens protocolaireet est modifiée par le moniteur en NFRECFM = V.Cette valeur (U) est transmise sans modification enPeSIT D profil CFT ou en PeSIT E de CFT à CFT.

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


CFT V2.3 4-21

ETEBAC3Le protocole ETEBAC 3 permet de transféreruniquement des fichiers à enregistrements de longueurfixe.

PeSIT profil SITLa valeur NRECFM = U est reconnue maisuniquement de CFT à CFT.

[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

Type du fichier, au sens protocolaire. OS

Ce paramètre est exploité pour désigner le type du fichier récepteur du partenaire.

PeSIT D profil CFT PeSIT E CFT/CFT Valeur par défaut :

si ce paramètre n’est pas renseigné, CFT lui attribueune 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”.

ODETTE La valeur particulière NTYPE = T peut être utiliséepour demander l’émission d’un fichier en formattexte ODETTE. Consultez le “Guide des protocoles”de CFT pour l’usage particulier qui est fait de ceparamètre.



Il s’agit d’un sous-ensemble des messages du journal CFT, défini par la somme algébriquedes valeurs indiquées dans le tableau ci-après.











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


CFT V2.34-22


Tableau 47. CFTSEND OPERMSG - Valeurs par défaut


GCOS7 0

GCOS8 0

GUARDIAN 3

MVS 0

OS400 0

UNIX 3

VM 0

VMS 0

VOS 3

VSE 0

WinNT 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 unpartenaire donné.

[RAPPL = string]

string8 PeSIT D profil CFT

PeSIT E

string48 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 enrespectant 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 duprotocole 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 uncontrôle relatif à la taille maximum de 48 caractères (autorisé en PeSIT E entre deux CFT) esteffectif.


CFT V2.3 4-23

Remarque :en PeSIT E standard, la valeur du paramètre RAPPL est transporté dans le PI 04. Sa longueurmaximum est limitée par le standard à 8 caractères. Ce PI 04 contient cette valeur concaténéeavec celle du paramètre RUSER.

En PeSIT E entre 2 moniteurs CFT, si ce paramètre RAPPL a une valeur de longueursupérieure à 8 caractères, la valeur renseignée dans le PI04 étant tronquée à 8 caractères, cettevaleur est transportée dans le PI99.

PeSIT D profil CFTEn profil CFT, ce paramètre ne doit pas être renseignélorsque le moniteur partenaire est CFT/370 Version 1 ouun CFT/PC.

PeSIT E standard PeSIT E CFT/CFTCe paramètre peut être transmis et contrôlé par lepartenaire serveur/émetteur.

[RUSER = string]


PeSIT E


Identifiant de l’utilisateur récepteur du fichier.


Lors de la saisie de ce paramètre, il n’y a pas de contrôle de sa pertinence vis-à-vis duprotocole 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. Seulun 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 longueurmaximum 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 longueursupérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dansle PI 04 étant tronquée à 8 caractères.

PeSIT D profil CFTCe paramètre ne doit pas être renseigné, en profil CFTde PeSIT, lorsque le moniteur partenaire est CFT/370Version 1 ou un CFT/PC.

PeSIT E standard PeSIT E CFT/CFTCe paramètre peut être transmis et contrôlé par lepartenaire serveur/émetteur.

[SELFNAME = filename]

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


CFT V2.34-24

[SAPPL = string]


PeSIT profil SIT

PeSIT E


Identifiant de l’application émettrice du fichier.




Remarque :en PeSIT E standard, la valeur du paramètre SAPPL est transporté dans le PI 03. Sa longueurmaximum est limitée par le standard à 8 caractères. Ce PI 03 contient cette valeur concaténéeavec celle du paramètre SUSER.

En PeSIT E entre 2 moniteurs CFT, si ce paramètre SAPPL a une valeur de longueursupérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dansle PI 03 étant tronquée à 8 caractères.

PeSIT D profil CFT Ce paramètre ne doit pas être renseigné, en profil CFTde PeSIT, lorsque le moniteur partenaire est CFT/370Version 1 ou un CFT/PC.

PeSIT E standard PeSIT E CFT/CFT Ce paramètre peut être transmis et contrôlé par lepartenaire serveur/émetteur.

[SPART = 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 lavaleur 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 étatcorrespond à un transfert “ immédiat” (c’est-à-dire s’exécutant dès que possible, comptetenu 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 à untransfert 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’étatdisponible (‘D’ ),


CFT V2.3 4-25

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

[SUSER = string]


PeSIT E


Identifiant de l’utilisateur émetteur du fichier.




Remarque :en PeSIT E standard, la valeur du paramètre SUSER est transporté dans le PI 03. Sa longueurmaximum est limitée par le standard à 8 caractères. Ce PI 03 contient cette valeur concaténéeavec celle du paramètre SAPPL.

En PeSIT E entre 2 moniteurs CFT, si ce paramètre SUSER a une valeur de longueursupérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dansle PI 03 étant tronquée à 8 caractères.

PeSIT D profil CFT Ce paramètre ne doit pas être renseigné, en profil CFT de PeSIT, lorsque lemoniteur partenaire est CFT/370 Version 1 ou un CFT/PC.

PeSIT E standard

PeSIT E CFT/CFT

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

[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.34-26

[TRK = {"valeur de TRKSEND de CFTPART" | ALL | NO | SUMMARY | UNDEFINED}]


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,


• 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 pasrenseigné, 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 (SENDSTATE = HOLD), l’ identifiant du propriétaire du transfert est l’“ userid” système del’ 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 = filename] OS

VM Paramètre non pertinent.

Nom du fichier temporaire à utiliser lors de l’envoi d’un groupe de fichiers après unesé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 lamachine 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 “ Guided’exploitation” correspondant à votre OS.


CFT V2.3 4-27

La sélection des fichiers à émettre s’effectue à partir du nom fourni dans le paramètreFNAME. Le fichier temporaire contient alors les données à transmettre. Le transfert du fichiers’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 lacommande CFTPART),

• le protocole. PeSIT E CFT V222 à CFT V222

Les variables utilisables pour la constitution de la chaîne de caractères WFNAME sont lessuivantes :



• &SUSER, &RUSER,

• &SAPPL, &RAPPL,


• &NIDF, &NFNAME, &IDT,

• &BDATE, &BTIME, &BYEAR, &BMONTH, &BDAY.

Le caractère ’&’ remplace ici le caractère char_symb spécifique à chaque systèmed’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 à cefichier type.

La table de transcodage est définie par la commande CFTXLATE ID = xlate. La requête detransfert SEND permet de spécifier une autre table de transcodage que celle attachée aufichier type.

Consultez, dans le guide “ Concepts” de CFT, la partie "Transcodage” pour davantage deprécisions sur la mise en oeuvre des tables de transcodage.

4.1.2. Exemples

Exemple 1 :

CFTSEND MODE = REPLACE, ID = SNDIMPL, /* IDF émissions implicites */ IMPL = YES, FCODE = EBCDIC, /* Donn ées EBCDIC dans fichier */ FNAME = ’ JSTATI ’ /* de nom ... */


CFT V2.34-28

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 dansle catalogue.

Il s ’ agit du m écanisme d’émission implicite.Exemple 2 :CFTSEND MODE = REPLACE, ID = IDFDEF, /* IDF par d éfaut */ IMPL = NO, FCODE = ASCIICorrespond au cas d’émission de fichier lorsque la commande SENDsp écifie un IDF non explicit é par une commande CFTSEND. C ’ est ladescription du fichier type à é mettre “ par d éfaut ” . Il faut que lacommande CFTPARM pr écise :CFTPARM DEFAULT = IDFDEF, ...La commande SEND pr écisera le nom du fichier à é mettre (param ètreFNAME).

Exemple 3 :

CFTSEND MODE = CREATE,ID = STAT, /* Identifiant du fichier */FLRECL = 128, /* de longueur maxi 128 octets */FACTION = DELETE, /* Supprime apres emission */FCODE = ASCII, /* Codification fichier */MINDATE = 19920703, /* A partir du 03/07/92 */MINTIME = 1000, /* à 10h (Lundi) */MAXDATE = 19921231, /* Jusqu ’ au 31/12/92 */MAXTIME = 2000, /* à 20h */CYCLE = 7, /* Toutes les semaines */TCYCLE = DAY,

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


CFT V2.3 4-29

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 surles points suivants, par rapport au paramétrage de CFTSEND utilisé pour une émission de fichierphysique :

• 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, FSPACEsont 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 concernentuniquement 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[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,[IMPL = {NO | YES},][USERID = {“userid du moniteur CFT” | string},][FORCE = {NO | YES},]

[RAPPL = string,] PROTOCOLE

[SAPPL = string,] PROTOCOLE

[RUSER = string,] PROTOCOLE

[SUSER = string,] PROTOCOLE

[PARM = string,] PROTOCOLE

[STATE = {DISP | HOLD | KEEP},][PRI = {128 | n},][COMMENT = string,][EXEC = filename,][MINDATE = {date (système) du jour | date},][MAXDATE = date,][MINTIME = {00000000 | time},][MAXTIME = {23595999 | time},][CYCDATE = date,][CYCTIME = time,][CYCLE = {0 | n},][TCYCLE = {DAY | MIN | MONTH},]


CFT V2.34-30

[XLATE = identifier,] PROTOCOLE

[NCOMP = cpr,][EXIT = identifier,][FACTION = {NONE | DELETE | ERASE | ROTATE},][FNAME = filename,][FDB = filename,]

[NFNAME = filename,] PROTOCOLE

OS

[NTYPE = c,] PROTOCOLE

OS

[NBLKSIZE = n,] PROTOCOLE

OS

[NLRECL = n,]

[NRECFM = {F | U | V},] PROTOCOLE

OS

[NCODE = {ASCII | BINARY | EBCDIC}]


[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 fichierlogique 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 “sansversion” 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 - Manuelde référence” . Ces noms peuvent comporter des caractères joker (masque), désignant ainsi lepremier fichier logique dont le nom répond à ce masque.


CFT V2.3 4-31

4.1.3.3. Exemples

Exemple 1 :

CFTSEND ID = BANQUE,FDB = BASE1.VFM,FNAME = CFT.SEND.TEST(0),FACTION = ROTATE

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

Exemple 2 :

CFTSEND ID = BANQUE,FDB = BASE1.VFM,FNAME = CFT.*.TEST(0),

Demande d’émission du premier fichier logique appartenant à labase 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 etle stockage des données reçues.

Chaque commande CFTRECV - commande “défaut” exceptée - contrôle la réception du fichiertype de même identifiant (IDF correspondant à l’ ID de la commande CFTRECV). Quant à lacommande CFTRECV “défaut”, elle s’applique à tous les autres fichiers types (IDF necorrespondant à aucun ID de commande CFTRECV).

Pour plus de clarté, on regroupe usuellement dans un fichier source de paramétrage, toutes lescommandes CFTRECV et on met la commande CFTRECV “défaut” soit en première, soit enderniè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 longueurd’enregistrement) du fichier récepteur,

• les actions à effectuer localement, notamment :

- 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, ...


CFT V2.34-32

• 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 éventuelsparamètres accompagnant explicitement celle-ci priment sur ceux de la commandeCFTRECV si la valeur du paramètre FORCE est FORCE = NO (pour tous lesparamètres communs aux deux commandes, CFTRECV ne fournit que les valeurspar défaut à RECV),

– ils ne sont pas pris en compte s’ ils sont renseignés dans la commande CFTRECVet 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 elles-mêmes priment sur les éventuelles caractéristiques de fichier prévues par défaut dansles 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’unnouveau transfert, il est d’une manière générale impossible de prendre en compte denouvelles caractéristiques de fichier : le comportement “standard” de CFT consiste alorssimplement à 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 setrouve a priori dans un cas intermédiaire entre les deux cas précédents : de nouvellesvaleurs 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.


CFT V2.3 4-33

4.2.1.1. Syntaxe

CFTRECVID = identifier,[COMMENT = string,][CYCDATE = date,][CYCTIME = time,][DELETE = {NO | YES},][DIRNB = n,][EXEC = filename,][EXIT = identifier,][FACTION = {VERIFY | DELETE | ERASE},]

[FBLKSIZE = n,] OS

[FCODE = {ASCII | BINARY | EBCDIC},] Dft : OS

[FDISP = {BOTH | NEW | OLD},]

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

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

[FLRECL = n,][FNAME = filename,][FORCE = {NO | YES},]

[FORG = {SEQ | DIRECT | INDEXED},] OS

[FRECFM = {F | U | V},] OS

[FSPACE = n,]

[FTYPE = c,] OS

[GROUPID = string,]

[MACTION = { “ ” | REPLACE},] OS

[MAXDATE = {voir le commentaire | date},][MAXTIME = {23595999 | time},][MINDATE = {date système du jour | date},][MINTIME = {00000000 | time},][MODE = {REPLACE | CREATE | DELETE},]

[NCOMP = cpr,] PROTOCOLE

[NOTIFY = identifier,]

[OPERMSG = n,] OS

[PRI = {128 | n},]


CFT V2.34-34


[RKERROR = {“ ” | DELETE | KEEP},]



[STATE = {DISP | HOLD | KEEP}]


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

[WFNAME = filename,] 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 : FORCE,

• paramètres libres pour l’utilisateur CFTd’utilisation locale : 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) :

- 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 4-35

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 pourrontfréquemment être omis, en pratique, car les messages protocolaires transportent (ou permettent deretrouver) 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 DEFAUTdes paramètres Fxxxxx correspondants :

PeSIT E CFT/CFT

PeSIT D profil CFT

En protocole PeSIT E (CFT à CFT), ou D profil CFT (transfert entre2 moniteurs CFT), les paramètres FSPACE, FTYPE, BLKSIZE,FLRECL, FRECFM prennent par défaut les valeurs transmises par lepartenaire (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.

PeSIT E En PeSIT E, les paramètres FKEYLEN et FKEYPOS prennent pardéfaut les valeurs transmises par le partenaire (voir la commandeCFTSEND, paramètre NKEYLEN et NKEYPOS).

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.

ODETTE En protocole ODETTE, les valeurs par défaut des paramètres FRECFM,FLRECL et FSPACE sont déduites des paramètres ODETTE reçus.

ETEBAC3 En protocole ETEBAC 3, les seuls fichiers protocolairementtransférables sont de format fixe. En mode serveur récepteur, la tailled’enregistrement transmise dans la carte paramètre est prise commevaleur par défaut du paramètre FLRECL.

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



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.34-36

[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 lavaleur 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 CYCDATEest 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 deCYCTIME est : MINTIME + TCYCLE*CYCLE.Sinon, cette valeur est CYCTIME = MINTIME.

Exemple :

si TCYCLE = MIN et CYCLE = 60, la valeur par d éfaut de CYCTIMEest 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’ IDFcorrespondant.

Si l’utilisateur spécifie des procédures de fin transfert (paramètres EXECSF et EXECRF deCFTPARM), 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 despostes 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 lavariable symbolique &IDF au niveau du paramètre EXECRF de CFTPARM.


CFT V2.3 4-37

Les variables symboliques possibles dans “ filename” et dans la procédure associée, ou dansl’ ensemble des procédures associées, sont les mêmes que celles autorisées pour les procéduresde fin de transfert référencées dans CFTPARM (consultez le paragraphe “Variablessymboliques” 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 finde transfert,

• si ce fichier n’existe pas, aucun traitement n’est exécuté en fin de transfert (même si leparamè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 commandeCFTPARM 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 ceparamè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ètreFDISP, selon le tableau suivant.

Tableau 48. CFTRECV FACTION/FDISP - Actions possibles

FACTIONFDISP

ERASE DELETE VERIFY

NEW Inex : OKExst : NOK

Inex : OKExst : NOK

Inex : OKExst : NOK

OLD Inex : NOKExst : OK (Erase)

Inex : NOKExst : OK (Delete)

Inex : NOKExst : OK si videNOK sinon

BOTH Inex : OKExst : OK (Erase)

Inex : OKExst : OK (Delete)

Inex : OKExst : OK si videNOK sinon

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éesconvenir).


CFT V2.34-38

MVS Pour les fichiers VSAM, seul FACTION = ERASE est accepté.

VM FACTION = VERIFY (valeur par défaut) n’est pas supporté. Ce paramètre doit donc êtrerenseigné 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 dufichier récepteur : suivant les systèmes, il peut définir la taille des blocs sur disque et/ou lataille des buffers d’entrée/sortie fichier.

Tableau 49. CFTRECV FBLKSIZE - OS concernés

OS FBLKSIZE

GCOS7 OUI

GCOS8 OUI

GUARDIAN NON

MVS OUI

OS400 NON

UNIX NON

VM NON

VMS NON

VOS NON

VSE OUI

WinNT NON

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

• pour les fichiers en format fixe : cette valeur est égale au plus grandmultiple de FLRECL qui est inférieur à la constante (liée à la longueur depiste) définie à l’ installation (valeur par défaut : 19069), ou FLRECL siFLRECL 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 dansl’ environnement MVS (valeur par défaut : 19065), ou à FLRECL + 4 siFLRECL 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 valeurdu 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.


CFT V2.3 4-39

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 (deRECV 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, seulela 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. Siles 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 codeest soit :

• explicitement communiqué par l’émetteur (voir le paramètre NCODE de la commandeCFTSEND, dans le cas PeSIT CFT à CFT),

• déduit des règles protocolaires : par exemple, en cas de transfert en ETEBAC 3, ons’attend usuellement à recevoir des données codées en EBCDIC (pour des informationscomplé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 dumoniteur 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 : si le fichier n’existe pas, il sera créé.

[FKEYLEN = {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éepar 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 peutdévelopper un EXIT de type fichier ou écrire une procédure de fin de transfert pour exploitercette information récupérable par la variable symbolique &FKEYLEN.


CFT V2.34-40

[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éepar 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 peutdévelopper un EXIT de type fichier ou écrire une procédure de fin de transfert pour exploitercette information récupérable par la variable symbolique &FKEYPOS.

[FLRECL = n]


• 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 parFLRECL, est tronqué à la valeur de FLRECL.

Pour les enregistrements de FORMAT FIXE (FRECFM = F), si la taille des enregistrementsreç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 dufichier, ni par les paramètres locaux) :

WinNT 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 4-41

[FNAME = filename]

Nom du fichier physique récepteur (nom simple ou “pathname” complet) ou nom deré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 lacommande de réception RECV ou au niveau de la commande CFTRECV. Sauf en cas detransfert 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 autreorganisation, 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 lacré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 (lesniveaux de répertoires intermédiaires) susceptible d’être créée. Seuls les noms de sous-répertoires apparaissant à droite du caractère délimiteur seront créés.

Le nom du fichier peut :


• 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 lessuivantes :



• &SUSER, &RUSER,

• &SAPPL, &RAPPL,


• &NIDF, &IDTU, &IDT,


• &NFNAME,

• &NFVER.

Le caractère ‘&’ remplace ici le caractère char_symb spécifique à chaque systèmed’exploitation (consultez le “ Guide d’exploitation” de CFT correspondant à votre OS).


CFT V2.34-42

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

Cas particulier de la variable symbolique &NFNAMEPeSIT 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” deCFT, 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 etconcerne obligatoirement la version +1 du fichier récepteur (fonctionnement avec RENAMEobligatoire).

La traduction du nom relatif du fichier en nom absolu s’effectue en fin de transfert. Le fichiertemporaire 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 restrictionslié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 decopie/”concaténation” à l’émission (transfert d’un groupe de fichiers entresystèmes homogènes).

La réception des données transférées s’effectue sur le fichier temporaire définidans 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’ungroupe de fichiers” dans le guide “ Concepts” de CFT.


Détermination de la priorité de prise en compte des paramètres valorisés dans CFTRECV etpar 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 à ceuxdéfinis dans la commande CFTRECV associée. Ainsi, si un paramètre n’est pasexplicitement renseigné dans RECV mais dans CFTRECV, c’est la valeur renseignéedans cette commande CFTRECV qui sera prise en compte.


CFT V2.3 4-43

• FORCE = YES :

les paramètres spécifiés dans CFTRECV sont prioritaires par rapport à ceux définisdans une commande RECV associée. Ainsi, si un paramètre n’est pas explicitementrenseigné dans CFTRECV mais dans RECV ou si la valeur renseignée dans CFTRECVest la valeur par défaut, c’est la valeur renseignée dans cette commande RECV qui seraprise 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” CFTcorrespondant à votre OS.

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

Format des enregistrements du fichier récepteur :

• F : fixe,

• V : variable,


Les valeurs possibles par système sont indiquées dans le “Guide d’exploitation” de CFTcorrespondant à votre OS.

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


[FSPACE = n]

Taille du fichier récepteur, en K-octets (1 K-octet = 1024 octets).

Cette taille correspond usuellement à l’“ allocation primaire”.

UNIX Paramètre ineffectif.


CFT V2.34-44

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

Type du fichier récepteur.

Dans certaines configurations de type client/serveur, le fichier local peut être physiquementimplanté sur une autre machine que celle sur laquelle CFT s’exécute.


[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 : ellecorrespond à la description des fichiers reçus en tant que partenaire intermédiaire. Pour que lacommutation soit acceptée, il faut que la commande (CFTRECV ID = COMMUT) soitparamétrée explicitement sur le site de commutation. Dans le cas contraire, la commutationest refusée.

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

[MACTION ={ “ ” | 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 estignoré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.



• ou dans les commandes RECV, d’une manière relative par rapport à la date de prise encompte de la commande. Cette valeur est alors exprimée en nombre de jours.

Exemple :

MAXDATE = +4 signifie que le dernier jour de validit é dutransfert est dans 4 jours par rapport à la date de priseen 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.


CFT V2.3 4-45

[MAXTIME = {23595999 | time}] Pris en compte uniquement en mode demandeur

Heure maximum de validité du transfert, pour le dernier jour (MAXDATE).



• ou dans les commandes RECV, d’une manière relative par rapport à l’heure de prise encompte de la commande.


Exemple :MAXTIME = +180 signifie que l ’ heure maximum de validit é dutransfert est l ’ heure de prise en compte de la commandeadditionn ée de 180 minutes. Cette heure de prise en comptedoit être inf érieure à 21 h.

MAXTIME ne doit pas être égal à MINTIME sauf si MAXDATE est renseigné et n’est pas ladate du jour.

[MINDATE = {date système du jour | date}] Pris en compte uniquement en mode demandeur

Premier jour de validité des transferts.



• ou dans les commandes RECV, d’une manière relative par rapport à la date de prise encompte de la commande. Cette valeur est alors exprimée en nombre de jours.

Exemple :MINDATE = +2 signifie que le premier jour de validit é dutransfert est dans 2 jours par rapport à la date de priseen compte de la commande.


[MINTIME = {00000000 | time}] Pris en compte uniquement en mode demandeur

Heure minimum de validité du transfert, pour le premier jour (MINDATE).



• ou dans les commandes RECV, d’une manière relative par rapport à l’heure de prise encompte de la commande.


Exemple :MINTIME = +30 signifie que l ’ heure minimum de validit é dutransfert est l ’ heure de prise en compte de la commandeadditionn ée de 30 minutes.Cette heure de prise en compte doit être inf érieure à 23 h30. MINTIME ne doit pas être égal à MAXTIME sauf siMAXDATE est renseign é et n ’ est pas la date du jour.


CFT V2.34-46

[NCOMP = {voir le commentaire | cpr} ] PeSIT D profil CFT 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 CFTPROTest excessive pour le fichier type considéré.

Les valeurs autorisées, ainsi que les valeurs par défaut, pour le paramètre NCOMP de lacommande CFTRECV, sont les mêmes que pour le paramètre RCOMP de la commandeCFTPROT. 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.


Définit la destination des messages associés à l’émission parmi les messages du journal, par lavaleur du paramètre OPERMSG.










Tableau 50. CFTRECV NOTIFY - Destinataires possibles

OS Submitter dumoniteur

Consoleopérateur

Utilisateur quelconque

GCOS7 OUI OUI NON

GCOS8 NON OUI NON


MVS NON OUI OUI

OS400 OUI OUI OUI

UNIX OUI OUI OUI

VM NON OUI OUI

VMS NON OUI OUI

VOS OUI OUI OUI

VSE NON OUI NONWinNT OUI NON NON



CFT V2.3 4-47


Tableau 51. CFTRECV NOTIFY - Valeurs par défaut


GCOS7 OP

GCOS8 ‘ ’

GUARDIAN OPLOG

MVS OP

OS400 ‘ ’

UNIX ‘ ’

VM OP

VMS OP

VOS ‘ ’

VSE ‘ ’

WinNT ‘ ’


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»




GCOS7 OP La console opérateur

GCOS8

OP000001OP000002OP000003OP000004

La console opérateur désignée par un numéro :

• console TY1• console TY2• console TY3• console TY4

GUARDIAN OP La console opérateur


OS400 OP La “message-queue” QSYSOPR

UNIX OP La console opérateur

VM OP La machine opérateur

VMS OP La console système et le fichier LOG système périphérique desortie identifié par le lien “xxxxxx” présent dans le répertoirecourant d’exécution du moniteur

VOS OPouOPxxxxxx

La console système et dans le fichier LOG systèmepériphérique de sortie identifié par le lien “xxxxxx” présentdans le répertoire courant d’exécution du moniteur

VSE OP La console opérateur

WinNT Sans objet

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


CFT V2.34-48


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.



Il s’agit d’un sous-ensemble des messages du journal CFT, défini par la somme algébriquedes valeurs indiquées dans le tableau ci-après.











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


Tableau 54. CFTRECV OPERMSG - Valeurs par défaut


GCOS7 0

GCOS8 0

GUARDIAN 3

MVS 0

OS400 0

UNIX 3

VM 0

VMS 0

VOS 3

VSE 0

WinNT 0


CFT V2.3 4-49

[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éepour un partenaire donné.

[RAPPL = string]


PeSIT E


Identifiant de l’application réceptrice du fichier.


When the character string is between quotes, the value is considered case-sensitive and usedas is.


De plus la taille maximum permise par le protocole utilisé n’est pas contrôlée. Seul uncontrôle relatif à la taille maximum de 48 caractères (autorisé en PeSIT E entre deux CFT) esteffectif.

Remarque :en PeSIT E standard, la valeur du paramètre RAPPL est transporté dans le PI 04. Sa longueurmaximum est limitée par le standard à 8 caractères. Ce PI 04 contient cette valeur concaténéeavec celle du paramètre RUSER.

En PeSIT E entre 2 moniteurs CFT, si ce paramètre RAPPL a une valeur de longueursupérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dansle PI 04 étant tronquée à 8 caractères.


PeSIT E standard

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 lacommande CFTCAT qui va être prise en compte.


CFT V2.34-50

[RUSER = string]


PeSIT E


Identifiant de l’utilisateur récepteur du fichier.





Remarque :en PeSIT E standard, la valeur du paramètre RUSER est transporté dans le PI 04. Sa longueurmaximum est limitée par le standard à 8 caractères. Ce PI 04 contient cette valeur concaténéeavec celle du paramètre RAPPL.

En PeSIT E entre 2 moniteurs CFT, si ce paramètre RUSER a une valeur de longueursupérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dansle PI 04 étant tronquée à 8 caractères.


PeSIT E standard

PeSIT E CFT/CFT


[SAPPL = string]

string8 PeSIT profil SIT PeSIT D profil CFT

PeSIT E


Identifiant de l’application émettrice du fichier.





CFT V2.3 4-51


Remarque :en PeSIT E standard, la valeur du paramètre SAPPL est transporté dans le PI 03. Sa longueurmaximum est limitée par le standard à 8 caractères. Ce PI 03 contient cette valeur concaténéeavec celle du paramètre SUSER.

En PeSIT E entre 2 moniteurs CFT, si ce paramètre SAPPL a une valeur de longueursupérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dansle PI 03 étant tronquée à 8 caractères.


PeSIT E standard

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 étatcorrespond à un transfert “ immédiat” (c’est-à-dire s’exécutant dès que possible, comptetenu 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 à untransfert 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’étatdisponible (‘D’ ),

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

[SUSER = string]


PeSIT E


Identifiant de l’utilisateur émetteur du fichier.





CFT V2.34-52


Remarque :en PeSIT E standard, la valeur du paramètre SUSER est transporté dans le PI 03. Sa longueurmaximum est limitée par le standard à 8 caractères. Ce PI 03 contient cette valeur concaténéeavec celle du paramètre SAPPL.

En PeSIT E entre 2 moniteurs CFT, si ce paramètre SUSER a une valeur de longueursupérieure à 8 caractères, cette valeur est transportée dans le PI 99, la valeur renseignée dansle PI 03 étant tronquée à 8 caractères.


PeSIT E standard

PeSIT E CFT/CFT


[TRK = {"valeur de TRKRECV de CFTPART" | ALL | NO | SUMMARY |UNDEFINED}]





• 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.


[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 estl’“ userid” système du moniteur CFT serveur.

Remarque :pour les commandes RECV utilisées en demandeur récepteur, l’ identifiant du propriétaire dutransfert est l’“ userid” système de l’utilisateur ayant activé la commande.


CFT V2.3 4-53

La valeur de ce paramètre peut comporter les variables symboliques :

• &PART : valeur substituée par l’ identifiant local du partenaire du transfert (ID deCFTPART),

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

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

[WFNAME = filename] OS

VM 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ètreFNAME.

L’ emploi d’un fichier temporaire permet d’assurer l’ intégrité du fichier reçu : le fichierexploitable (par une application utilisateur par exemple) n’est disponible qu’à la fin dutransfert.

Le nom de ce fichier peut être composé des variables symboliques suivantes :




• &SUSER, &RUSER,

• &SAPPL, &RAPPL,


• &NIDF, &NFNAME,

• &IDT.

Le caractère ‘&’ remplace ici le caractère char_symb (consultez le “ Guide d’exploitation” deCFT 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 VMSCe 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 envoieun 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.34-54


Identifiant de la commande CFTXLATE définissant la table de transcodage utilisée pour lesréceptions.

La commande de transfert RECV permet de spécifier une autre table de transcodage que celleattachée au fichier type.

Consultez dans le manuel “ Concepts” de CFT, le paragraphe “ Transcodage” , pour desinformations complémentaires sur la mise en oeuvre des tables de transcodage.

4.2.1.4. Exemples

Exemple 1 :

CFTRECV MODE = REPLACE, ID = SRCFILES, /* IDF pour fichiers source */ FDISP = BOTH, /* Existe deja ou non */ FACTION = ERASE, /* Si existe Remis à blanc */

XLATE = ETOA /* 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 pourvaleur explicite “ SRCFILES”.Le moniteur dispose ainsi de valeurs par d éfaut pour la gestion dufichier r écepteur. Le param ètre FNAME n ’ est pas renseign é. Lemoniteur ne pourra donc fonctionner que si une commande RECVsp écifiant FNAME a été d épos ée (CFT est demandeur), ou si lepartenaire (CFT est serveur) a pr écis é le nom du fichier r écepteur(mode ouvert en r éception).

Exemple 2 :

CFTRECV MODE = REPLACE, ID = IDFDEF, /* IDF par d éfaut */ FDISP = BOTH, /* Existe deja ou non */ FACTION = DELETE, /* Si existe - supprim é */

FNAME = R&IDT /* Fichier selon valeur IDT */

Cette commande correspond au cas de r éception de donn ées pour tousles transferts dont l ’ identifiant (IDF) n ’ a pas de descriptionexplicite (commande CFTRECV).

C’ est la description du fichier type r écepteur “ par d éfaut ” . Ilfaut que la commande CFTPARM pr écise :CFTPARM DEFAULT = IDFDEF, ... CFT cr ée alors un fichier dont lenom contient l ’ identifiant (unique) du transfert.

OS400 Cette commande répond au cas général de réception d’un fichier “data-base”.


CFT V2.3 4-55

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èresur les points suivants, par rapport au paramétrage de CFTRECV utilisé pour une réception defichier 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 leproduit VFM,

• les paramètres FDISP, FORG, FTYPE et FBLKSIZE sont sans objet, leurs valeurs étantimposé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 concernentuniquement les spécificités VFM.

Pour les autres paramètres, voir dans ce même document les explications indiquées dans leparamétrage de CFTRECV utilisé pour une réception de fichier physique.

4.2.2.1. Syntaxe

CFTRECV[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,[USERID = {“ userid” du moniteur CFT | string},][FORCE = {NO | YES},][EXEC = filename, ][PRI = {128 | n},][COMMENT = string,][MINDATE = {date système du jour | date},][MAXDATE = date,]

[MINTIME = {00000000 | time},][MAXTIME = {23595999 | time},][CYCDATE = date,][CYCTIME = time,][XLATE = identifier,][NCOMP = cpr,] PROTOCOLE


[EXIT = identifier,][FNAME = filename,][FSPACE = n,][FLRECL = n,]



CFT V2.34-56

[FACTION = {CONCAT | DELETE | ERASE | VERIFY},][FDB = filename,][FCOMP = {0 | 15}]


[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 VFMsous 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 logiquetemporaire 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.


CFT V2.3 4-57

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 nel’ 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 = REPLACE, ID = IDFDEF, /* IDF par d éfaut */ FACTION = CONCAT, /* Ajout des donn ées */

FDB = BASE2.VFM, /* Nom base VFM */ FNAME = R&PART(0) /* Fichier selon valeur partenaire */

Description d ’ un fichier type en r éception sur une base VFM. Lesdonn ées re çues de chaque partenaire seront concat énées dans lefichier logique R<partenaire>(0).

4.3 CFTEXIT - Activation d ’une t âche “ exit ”

Cette commande décrit l’environnement de lancement d’une tâche d’EXIT et permet l’activationde cette tâche.

A une commande CFTEXIT correspond une tâche EXIT. Suivant le cas, cette commande estactivé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 typeETEBAC 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

CFTEXITID = identifier,TYPE = {FILE | ACCESS | ETEBAC | EXEC}][LANGUAGE = {COBOL | C},][MODE = {REPLACE | CREATE | DELETE},][PARM = string,][PROG = {CFTEXIT | string},][RESERV = {8192 | 1024 | n},][WAITTASK = {1441 | n}]


CFT V2.34-58

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éesexplicitées ci-dessous.

Tableau 55. CFTEXIT ID - Commande et paramètre associé à l’EXIT trait é

EXIT Commande Paramètre

De type annuaire CFTPROT EXITAEXIT

De type ETEBAC CFTPROT EXITEDe type fichier CFTSEND, SEND

CFTRECV, RECVEXIT

De type fin de transfert CFTPARM 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éesvia 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 cesmodules 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).


CFT V2.3 4-59

[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 informationsqu’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 1024 {0 ...1024}

De type fichier 8192 {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 = PAYE,EXIT = IDEXIT

CFTEXIT ID = IDEXIT,LANGUAGE = C,RESERV = 4000,PROG = FILEXEC

Exemple de paramétrage d’un EXIT de type annuaire :

CFTPROT ID = PSIDTH,TYPE = PESIT,EXIT = EXA


CFT V2.34-60

CFTEXIT ID = EXA,PARM = SAMPLE,LANGUAGE = C,PROG = MYEXA,TYPE = ACCESS

Exemple de paramétrage d’un EXIT de type ETEBAC 3 :

CFTPROT ID = PSIDTB,TYPE = ETEBAC,EXIT = ETB

CFTEXIT ID = ETB,PARM = SAMPLE,LANGUAGE = C,PROG = MYETB,TYPE = 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êmesautorisations 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éssimultanément.

4.4.1. Syntaxe

CFTAUTH[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,IDF = (identifier | mask, identifier | mask,...)

CFTAUTH[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,FNAME = filename


CFT V2.3 4-61

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 del’ 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 (ilest 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 cettecommande 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 cettecommande 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 sontconcernés par cette commande.


CFT V2.34-62

4.4.3. Exemple

CFTPART ID = IBM1,SAUTH = SIBM1,...

CFTPART ID = BULGC8,RAUTH = RBULGC8,...

CFTAUTH ID = SIBM1,IDF = (APLI1,APLI2,LISTE,CHQ*)

CFTAUTH ID = RBULGC8,FNAME = fic21

avec le fichier de nom fic21 contenant :idfdefidf1idf2idf3

Dans cet exemple, le CFT local ne peut émettre vers le partenaireIBM1 que les fichiers d ’ identifiants type APLI1, APLI2, LISTEainsi que ceux commen çant par les 3 lettres CHQ.

CFT ne peut recevoir du partenaire BULGC8 que les fichiersd’ 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 desidentifiants 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 fichierfourni par le (ou transmis au) partenaire.

La commande CFTIDF permet d’établir en local cette correspondance entre l’ IDF local et le NIDFtransmis ou reçu.

D’autres manières d’établir cette correspondance sont indiquées dans l’annexe “ CorrespondanceNIDF/IDF” du guide “ Concepts” de CFT. En particulier, il est indiqué la valeur par défaut prisepar 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.


CFT V2.3 4-63

4.5.1. Syntaxe

CFTIDF[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,PART = identifier,NIDF = string,TYPE = {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 auparamètre IDF de la commande SEND/RECV.

NIDF = string

string7 PeSIT D

string14 PeSIT E


string26 ODETTE

string28 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 CFTIDFcomportant 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, cetNIDF 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.34-64

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 A PARTENAIRE B

CFTIDF ID = FICHIER,PART = B,NIDF = FICHIER_SITE_A,TYPE = SEND

CFTIDF ID = FICHIERA,PART = A,NIDF = FICHIER_SITE_A,TYPE = REC V

Pour le partenaire A, l ’ identifiant local FICHIER correspond aunom r éseau FICHIER_SITE_A en émission vers le partenaire B.

Le partenaire B établit la correspondance entre le m êmeidentifiant r éseau et l ’ identifiant local FICHIERA, lors d ’ uneré 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 de256 caractères, dans lequel chaque caractère définit, par sa position et sa valeur, la correspondanceentre 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.


CFT V2.3 4-65

Par exemple : le caractère de valeur décimale 64 en position 32 correspond, dans une tableASCII - EBCDIC, au transcodage du caractère blanc ASCII (valeur 32) en caractère blancEBCDIC (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 tablede transcodage “émission” (FCODE vers NCODE) et si DIRECT = RECV (ou = BOTH), ilcontient 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 alphabetASCII différent (FCODE = ASCII et NCODE = ASCII).

Les valeurs des 2 tables internes de transcodage du moniteur CFT (ASCII -> EBCDIC etEBCDIC -> 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èresinvalides sont associés au caractère <DEL> de l’alphabet de destination (0x7f pour une tableEBCDIC 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[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,[DIRECT = {BOTH | RECV | SEND},]

[FCODE = {ASCII | EBCDIC},] Dft : OS

FNAME = filename,[NCODE = {ASCII | EBCDIC}]


CFT V2.34-66

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éationd’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é enalphabet “cible” , puis retranscodé de l’alphabet “cible” vers l’alphabet “source” , retrouve savaleur initiale), il faut que la table contienne 256 valeurs différentes.

Il n’est pas indispensable de respecter rigoureusement ce principe pour des applications detransfert 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


GCOS7 EBCDIC

GCOS8 ASCII

GUARDIAN ASCII

MVS EBCDIC

OS400 EBCDIC

UNIX ASCII

VM EBCDIC

VMS ASCII

VOS ASCII

VSE EBCDIC

WinNT ASCII


CFT V2.3 4-67

FNAME = filename

Nom du fichier contenant la description de la table de transcodage (1 article de 256caractères).

Ce fichier doit être d’organisation séquentielle. Des exemples de tel fichier sont fournis avecles différents produits (consultez le “ Guide d’exploitation” de CFT correspondant à votreOS).

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 deDIRECT, FCODE ou NCODE sont différentes.

[NCODE = {ASCII | EBCDIC}]

Code des données transmises sur le réseau.

4.6.4. Exemple

CFTXLATE ID = DEFAUT,DIRECT = BOTH,FCODE = ASCII,NCODE = EBCDIC,FNAME = ATOE

CFTPARM ...,DEFAULT = DEFAUT,

Les tables de transcodage internes du moniteur CFT (identifiantDEFAUT) 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 - enré ception, d ’ EBCDIC vers ASCII. La table ASCII vers EBCDIC estdéfinie dans le fichier ATOE et la table EBCDIC vers ASCII en seradéduite automatiquement.

CFT V2.3 5-1

5. Les commandes de paramétrage des réseauxet protocoles

5.1 CFTNET - Ressources (locales) réseau

Une commande CFTNET :

• définit une ressource réseau : celle-ci, pour le moniteur CFT, est une entité au travers delaquelle 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ôledes mécanismes d’établissement des connexions par exemple,

• des paramètres décrivant les caractéristiques de l’environnement réseau définies par lesystè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 logicielssystè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 del’environnement est trop complexe ou trop spécifique, on préfère regrouper les paramètrescorrespondants 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ètresdont 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 ensuitedé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 à jourdes paramètres, peut différer dans certains environnements de celui effectué lors de l’exécution deCFT. Lorsque CFT détecte un nombre excessif de CFTNET, le message suivant apparaît :

CFTP16F CFTNET id for CFTPARM id_Not loading in memory

Les commandes de paramétrage des réseaux et protocoles

CFT V2.35-2

5.1.1. CFTNET - Commande “générique”

La description faite dans ce paragraphe ne correspond pas à une commande réelle de CFT. Elle faitl’ 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 = {INOUT | IN | OUT},][MODE = {REPLACE | CREATE | DELETE},]ID = identifier,[MAXCNX = {32 | n},][TYPE = {X25 | DNA | DSA | SNA | TCP | LU62 | ASY},]

... Définition de la ressource réseau (spécifique). OS


[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 ressourceréseau.

Cette valeur doit être cohérente avec le paramètre MAXTRANS de CFTPARM ainsi qu’avecl’ environnement réseau concerné. Par exemple : cohérence avec le nombre de voies logiquesdisponibles (exemple : sur TRANSPAC).

MVS VSE Sur X25 : cohérence avec la définition du noeud commuté VTAM.

[TYPE = {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 La ressource correspond à un APPLID de VTAM.


CFT V2.3 5-3

• TCP : ressource d’accès au réseau TCP/IP,

• X25 : ressource d’accès à une liaison X25 publique (TRANSPAC par exemple) ou à uneliaison 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 communicationasynchrone.

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 desliaisons 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 deprotocole (CFTPROT).

Certains paramètres sont communs à toutes les commandes CFTNET. Ils ne sont pas explicitésdans 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

CFTNETID = identifier,TYPE = ASY,[CLASS = {1 | n},][CONFIG = string,]CALL = {INOUT | IN | OUT},MAXCNX = 1,[MODE = {REPLACE | CREATE | DELETE},]LINEID = string,[MODOUT = string,][MODIN = string,][SPEED = {2400 | n},][PADSET = string]


CFT V2.35-4


[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 lemodem et/ou le PAD spécifiques (par exemple, temps d’attente avant le BREAK ou moded’é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 surle paramétrage de la commande.

LINEID = { string1..32}

Identifiant de la ressource asynchrone caractérisant le port de communication (chaîne decaractè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 lavaleur 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 enmode tempo, avec un tempo de 0,15 secondes.

[SPEED = {2400 | n}]

Vitesse de la transmission en bits/seconde.


CFT V2.3 5-5

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éseauDECNET.

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 CFTNETgénérique.

5.1.3.1. Syntaxe

CFTNET[CALL = {INOUT | IN | OUT},][MODE = {REPLACE | CREATE | DELETE},]

ID = identifier,[MAXCNX = {32 | n},]TYPE = DNA

5.1.3.2. Exemple

CFTNET MODE = CREATE,ID = DECNET,TYPE = DNA,MAXCNX = 6,CALL = 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éseauDSA.

Il ne peut exister qu’une seule ressource de type DSA.



CFT V2.35-6

5.1.4.1. Syntaxe

CFTNET[CALL = {INOUT | IN | OUT},][MODE = {REPLACE | CREATE | DELETE},]

ID = identifier,[MAXCNX = {32 | n},]TYPE = DSA,[CLASS = {1 | n},]

[TSAP = string,] OS

[NSAP = string] OS


[CLASS = {1 | n}] {1..32}


5.1.4.3. Exemple

CFTNET MODE = REPLACE,/* Ressource DSA - Toujours unique*/ID = DSAINIOUT,TYPE = DSA,CALL = INOUT,CLASS = 1,MAXCNX = 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èsLU6.2.

Certains paramètres sont communs à toutes les commandes CFTNET. Ils ne sont pas explicitésdans ce paragraphe mais sont décrits dans le paragraphe la “commande CFTNET générique”.


CFT V2.3 5-7

5.1.5.1. Syntaxe

CFTNETID = identifier,TYPE = LU62,[CLASS = {1 | n},][CALL = {INOUT | IN | OUT},][MAXCNX = {32 | n},][MODE = {REPLACE | CREATE | DELETE},]LUNAME = string,

NETPFX = string, OS

PUNAME = string, OS

[RECV = {2 | n},] OS

TPNAME = string OS


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’ellessoient utilisables indifféremment pour l’établissement de liaisons avec des partenaires (voir leparagraphe “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.35-8

TPNAME = string1..16 OS2 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 estprésenté ci-dessous :

CFTNET id = net1lu62 ,type = lu62 ,luname = lumvs2 ,maxcnx = 6 ,class = 5 ,call = inout ,mode = 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éseauSNA.

Le tableau suivant indique le nombre maximal de commandes CFTNET TYPE = SNA gérées parsystème en précisant, s’ il y a lieu, le type de LU concerné.

Tableau 58. CFTNET TYPE = SNA - Nombre maximum de commandes

OS Nombre maximum decommandes en LU0

Nombre maximum decommandes en LU2

Nombre maximum decommandes en LU0 ou LU2confondus

MVS 16

OS400 16 16 16

VM 16

VMS 16 Non supporté

VSE 16

Le nombre total de commandes CFTNET (tous types confondus) est indiqué en introduction deCFTNET.

Par ressource ou plus précisément par type de ressource, il ne peut y avoir qu’une définition deprotocole (CFTPROT).



CFT V2.3 5-9

5.1.6.1. Syntaxe g énérale

CFTNET[CALL = {INOUT | IN | OUT},][MODE = {REPLACE | CREATE | DELETE},]ID = identifier,[MAXCNX = {32 | n},]TYPE = SNA,[CLASS = 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 desautres 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 LUNAME PUNAME GATEWAY NETPFX LOCADR ACB RECV

MVS (OUI) (OUI) (OUI)

OS400 OUI OUI (OUI) OUI

VM (OUI) (OUI) (OUI)

VMS (OUI) OUI OUI OUI (OUI) (OUI)

VOS OUI

VSE (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.35-10

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 = (ACQ)PARSESS = YESACBNAME = 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}


Cette notion permet de regrouper des ressources de même type, de manière à ce qu’ellessoient utilisables indifféremment pour l’établissement de liaisons avec des partenaires (voir leparagraphe “ 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ètresCLASS 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éfiniAVANT 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.


CFT V2.3 5-11

5.1.6.3. Exemples

Exemple 1 :

CFTNET MODE = replace ,ID = idnet1 , /* Ressource SNA */ACB = CFTAPPL1,CALL = INOUT ,CLASS = 21 ,TYPE = SNA

La commande CFTNET ID=IDNET1, définit une ressource SNA pour destransferts de fichiers.

Exemple 2 :

CFTNET MODE = replace ,ID = idnet2 ,ACB = CFTAPPL2,CALL = INOUT ,PROFILE = GATE , /* Ress. SNA pour X25 NPSI*/TYPE = SNA

La commande CFTNET ID=IDNET2, définit une ressource SNA pourcommuniquer avec X25 NPSI. Dans ce cas, le paramètre CLASS n’a pasde sens. Cette ressource implique l’existence d’une ressourceCFTNET 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}



[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 laLU correspondante.


CFT V2.35-12

LUNAME = string3..8

Ce paramètre fournit le nom de la première LU du groupe de LUs consécutives composantcette 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 LUssortantes au niveau de la description de l’unité est mis à la valeur “ INCONNU”, pour toutesles 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ééspour CFT/OS400 et utilisés par les programmes. Il constitue, en outre, la donnée decomparaison à ajouter dans un poste de routage du sous-système dans lequel CFT/OS400 vas’exécuter.

PUNAME = string10

Nom du contrôleur (*CTLD) attaché à une ligne de communication (*LIND) et constituantune PU utilisée par CFT/OS400 ou d’autres applicatifs (255 unités au total peuvent êtreattachées sur un même contrôleur).

5.1.6.5. Exemple

CFTNET MODE = REPLACE, ID=LU0LINE0,TYPE = SNA,CLASS = 1,MAXCNX = 2, /* simult. virtual circuits */NETPFX = CF1, /* objects & jobs name-prefix*/PUNAME = CTLLU0, /* ctlid attached(line name) */LOCADR = 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 SNApour VMS/SNA ou une passerelle pouvant, elle, supporter plusieurs lignes SNA. A chaque ligneest associé un circuit référencé par un nom (pu_name : SNA-0 pour VMS/SNA, LC-0 par exemplepour un Gateway) et, le cas échéant, un nom de passerelle (gateway). Chaque ligne peutrepré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 uneLU secondaire. Il y aura donc 1 seul transfert CFT par LU.


CFT V2.3 5-13

[CLASS = {1 | n}] {1..32}



[GATEWAY = string]

Nom de la passerelle SNA (SNA/Gateway) permettant d’assurer la connexion du réseauDECnet 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 cetteressource.

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ètredoit ê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 = CREATE,ID = SNA01,TYPE = SNA,PUNAME = SNA-0,LUNAME = 10,MAXCNX = 4,CLASS = 1,CALL = INOUT

Cette commande d écrit la ressource SNA, impl ément ée à partir dulogiciel VMS/SNA r ésidant sur la machine (il n ’ y a pas deréfé rence à un “ gateway ” ). Le VAX est connu comme PU : SNA-0. 4 LUsont associ ées à cette PU : SNA-0.10, ... SNA-0.13.


CFT V2.35-14

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 produitVOS PSSNA pour communiquer en SNA LU0. L’ interface entre CFT et PSSNA est assurée pardes secondary session descriptor.

[CLASS = {1 | n}] {1 .. 32}


Cette notion permet de regrouper des ressources de même type, de manière à ce qu’ellessoient 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 dubind.

Des règles de nommage du nom des secondary session descriptor permettent de placer laressource en attente du bind, sur un ou plusieurs secondary session descriptor. Un secondarysession 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 secondarysession 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 = REPLACE,ID = NETSNA,TYPE = SNA,CLASS = 1,MAXCNX = 10,LUNAME = in_PU0HOST_01

Cette commande d éfinit une ressource r éseau SNA LU0. Le moniteurva placer le secondary session descriptor dans PU0HOST_01 enattente du bind et va rechercher 9 autres secondary sessiondescriptor, suffix és _02 à _0A pour les placer en attente d ’ unbind.

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éthoded’accès TCP/IP - ressource Internet.

Il ne peut exister qu’une seule ressource locale de type TCP/IP. Cependant, il est possible dedéfinir une ressource déportée de type proxy, permettant d'accéder à un autre réseau ; cetteressource étant liée à la ressource locale.



CFT V2.3 5-15

5.1.7.1. Syntaxe

CFTNET[CALL = {INOUT | IN | OUT},][MODE = {REPLACE | CREATE | DELETE},]ID = identifier,[MAXCNX = {32 | n},]TYPE = TCP,[LOWPORT= {5000 | n},][HIGHPORT= {65535 | n},]HOST = string


[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 lefichier “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 = CREATE,ID = TCP00,TYPE = TCP,HOST = localhost,MAXCNX = 6,CALL = INOUT

Définit une ressource sur le noeud “ LOCALHOST” , qui correspond àla d éclaration TCP/IP du noeud local. 6 connexions simultan éespourront être ouvertes. Cette ressource accepte les connexionsdans les 2 sens.


CFT V2.35-16

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èglegénérale, la ressource qui permet d’accéder à ce réseau est locale à la machine. Un proxy permetd’accéder à un réseau de télécommunications à travers un autre réseau. Il est considéré comme uneressource 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 ressourcelocale),

• une commande CFTNET qui décrit l’accès au deuxième réseau (à travers une ressourcedé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, lesparamètres sont dépendants du type de la ressource.

5.1.8.1. Syntaxe

CFTNETID = identifier,TYPE = TCP,INET = identifier,PROTOCOL = SOCKS4,HOST = (string, string, …),PORT = (string, string, …),[USER = string,][MAXCNX = {32,n},][MODE = {REPLACE | CREATE | DELETE},]


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).


CFT V2.3 5-17

HOST = (string1..64, string1..64, …)

Adresse(s) dans le premier réseau du ou des proxy (jusqu’à 4 proxy sur un même premierré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, laposition 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 commandeCFTPARM (nombre maximum de transferts simultanés) et d’autre part avec le paramètreMAXCNX 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 souslequel s’exécute CFT.

5.1.8.3. Exemple

/** * DEFINITION DU RESEAU INTRANET **/

CFTNET id = INTRANET,mode = REPLACE,call = INOUT,maxcnx = 16,host = adresse_locale,type = TCP

/** * DEFINITION DU RESEAU INTERNET * A TRAVERS UN PROXY **/

CFTNET id = INTERNET,mode = REPLACE,maxcnx = 8,type = TCP,user = nom_utilisateur,inet = INTRANET,protocol = SOCKS4,host = adresse_proxy,port = port_ecoute_proxy


CFT V2.35-18

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ésdans ce paragraphe mais sont décrits dans le paragraphe “La commande CFTNET générique”.

5.1.9.1. Syntaxe

CFTNET[CALL = {INOUT | IN | OUT},][MODE = {REPLACE | CREATE | DELETE},]ID = identifier,[MAXCNX = {32 | n,][TYPE = X25,][CLASS = {1 | n},][ADDR = string,]

OS

[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= X25dépendent du système utilisé.

Le tableau suivant indique lesquels de ces paramètres sont utilisables pour un système donné.


CFT V2.3 5-19

Tableau 60. CFTNET TYPE = X25 - Emploi des paramètres

OS ADDR PACKETSZ PACKETW NET NET

PGM PFX

LINEID SPEED MAXLCH

MINLCH

CTLR AX25NODE

AX25MBX

GCOS7 OUI (OUI)

GCOS8 OUI (OUI)


MVS OUI OUI OUI

OS400 (OUI) (OUI) OUI OUI (OUI) OUI

UNIX OUI OUI

VM OUI OUI OUI

VMS OUI

VOS (OUI) OUI

VSE OUI OUI OUI

WinNT 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

Les commandes CFTNET TYPE=X25 seront précédées d’une commandeCFTNET TYPE=SNA, PROFILE=GATE afin que CFT puisse dialoguer avecX25 NPSI.

GCOS7 GCOS8Le triplet AX25NODE, AX25MBX, LINEID doit être unique pour chaque commandeCFTNET.

UNIXDans 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

string6 GUARDIAN Sous-adresse commune aux SU (Sub-Units) référencées par ce CFTNET(obligatoire).

n VOS Numéro d’extension facultatif pourl’écoute d’appels entrants.

[AX25MBX = { ‘ ’ | 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.35-20

[CLASS = {1 | n}] {1..32}



[CTLR = string8] OS

Nom du contrôleur de communication.

[LINEID = string] (longueur : voirle tableau)

OS

Décrit la ressource physique locale.

Le tableau suivant indique, pour chaque système d’exploitation où l’emploi de ce paramètreest pertinent, le nombre de caractères maximum à renseigner ainsi que la signification de ceparamètre spécifique à ce système d’exploitation.

Tableau 61. CFTNET TYPE = X25 LINEID - Valeurs du paramètre

OSNombremaximum decaractères

Signification de la valeur LINEID

GCOS7 4 Abonnement à sélectionner par AX25 lors des appels sortantsCorrespond à un objet “NS” du contrôleur de communicationsDATANET

GCOS8 4 Abonnement à sélectionner par AX25 lors des appels sortantsCorrespond à un objet “NS” du contrôleur de communicationsDATANET

GUARDIAN 8 Nom physique de la ligne X25 tel que défini lors del’ installation de celle-ci. Exemple : LINEID=$X25

MVS 8 Nom de la ‘LU MCH’ de la ligne X25 supportée par cetteressource

OS400 10 Nom physique de la ligne X25, tel que défini lors del’ installation de celle-ciSe référer au nom de “port” affiché par la commandeWRKHDWPRD

UNIX 32 Nom de l’exécutable initialisant cette ressourceL’ appellation est dépendante du type de la machine (se référerau guide spécifique)

VM 8 Nom de la ‘LU MCH’ de la ligne X25 supportée par cetteressource

VMS 32 Composé :

• du nom du réseau tel que connu de PSI (par exempleTRANSPAC)

• du caractère séparateur “%”

• du No de DTE local (par exemple un numéro Transpac)

VOS 32 Nom de gateway identifiant la ligne

VSE 8 Nom de la ‘LU MCH’ de la ligne X25 supportée par cetteressource

WinNT 32 Voir OS2


CFT V2.3 5-21

[MAXLCH = {valeur de MAXCNX | n}]{1..32}

OS400

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 = {1 | n}]{0..512}

OS400

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éésautomatiquement par l’ interface réseau de CFT(lignes, contrôleurs, unités, fichiers ICF ...).Le choix de ces trois caractères est libre, pourautant qu’on ne contrevienne pas aux règles denommage de l’AS/400.On pourra par exemple utiliser : NETPFX=CF1pour un premier moniteur, NETPFX=CF2 pour unsecond, ou NETPFX=CFT pour tous les deux.

[NETPGM = string32] Utilisé parcertains systèmes UNIX

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.


[SPEED = {9600 | n}]{300..65536}

OS400

Vitesse de la ligne de l’abonnement, en Bps.



CFT V2.35-22

5.1.9.3. Exemple

GCOS7 GCOS8

CFTNET MODE = REPLACE,CALL = INOUT,ID = X25INOUT,MAXCNX = 8,TYPE = X25,CLASS = 1,AX25NODE = DN01,AX25MBX = AX25,LINEID = LX25

GCOS7 Le param étrage serveur de communicationcorrespondant est du type :SC DN01 LOC -ADDR ...MB AX25 AX25NS LX25 X25 -LL LX25 -NBVC 8 -CALL 175nnnnnnNR NRNS SX25 -NS LX25

5.2 CFTPROT - Protocole de transfert

Une commande CFTPROT permet de :

• choisir un protocole (PeSIT, ODETTE, ETEBAC 3) et une manière d’utiliser ceprotocole (avec ou sans compression, avec ou sans possibilité de relance, avec ou sansutilisation de SSL, ...),

• préciser certains paramètres liés à l’utilisation des ressources réseau pour les échangesprotocolaires (voir notamment le mécanisme de sélection du protocole lors desconnexions - 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 pasnormalisé.

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 dedonnées utilisés sont supportés par le moniteur local et le moniteur du partenaire concerné et s’ iln’y a pas d’ incompatibilité dans les choix d’utilisation (par exemple, profil de PeSIT, options duprotocole, ...).

Pour CFT, l’association entre un partenaire et les protocoles CFT utilisables est assurée par leparamètre PROT de la commande CFTPART.


CFT V2.3 5-23

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 à jourdes paramètres, peut différer dans certains environnements de celui effectué lors de l’exécution deCFT. 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éfinirl’ ensemble des options de tous les protocoles de transfert de fichiers supportés. Certains de cesparamètres sont communs à tous les protocoles ; d’autres paramètres n’ont de sens que pour unprotocole 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 leparagraphe "CFTPROT - commande générique",

• les paramètres spécifiques, regroupés par types de protocole, sont décrits ensuite dans lesparagraphes "CFTPROT TYPE = xxx". Le paramètre TYPE pouvant prendre l’une desvaleurs xxx suivantes : ETEBAC, ODETTE, PeSIT,

• le paramètre permettant d'associer un protocole au profil de sécurité (SSL) est décrit dansle "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 nes’applique pas forcément lorsqu’ il y a enchaînement (dans la même connexion) de transferts desens 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 faitl’ 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’unecommande CFTPROT par commande CFTNET.

5.2.1.1. Syntaxe

CFTPROT

[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,NET = identifier,

SAP = string, OS

[DISCTD = n,] Dft: PROTOCOLE

[DISCTS = n,] Dft: PROTOCOLE

[RESTART = {5 | n},][RTO = {260 | n},]


CFT V2.35-24

[SCOMP = cpr,] Dft: PROTOCOLE

[RCOMP = cpr,] Dft: PROTOCOLE

[SRIN = {BOTH | NONE | RECEIVER | SENDER},][SROUT = {BOTH | NONE | RECEIVER | SENDER},][IDF = string,]TYPE = {PESIT | ETEBAC | ODETTE},

[EXITA = identifier,] [EXITE = identifier,] [DYNAM = identifier]

. . . Paramètres spécifiques suivant le protocole.


[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 detransfert vers le partenaire, en mode demandeur.

La session établie pour un transfert reste active pendant DISCTD secondes après la fin de cetransfert.

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 240

PeSIT D profil EXTERN 120

PeSIT D profil CFT 20

PeSIT E (profil ANY) 120

ODETTE 20

ETEBAC3 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 detransfert du partenaire, en mode serveur.

La session établie pour un transfert reste active pendant DISCTS secondes après la fin de cetransfert. Si au bout de ce délai, aucun nouveau transfert n’est reçu, la connexion est libéréepar FPDU ABORT.


La valeur par défaut (en secondes) dépend du protocole et est indiquée au tableau suivant.


CFT V2.3 5-25

Tableau 63. CFTPROT DISCTS - Valeurs par défaut

Protocole Valeur par défaut de DISCTS

PeSIT profil SIT 285



PeSIT E (profil ANY) 165

ODETTE 65

ETEBAC3 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 CFTPARTmodèle.Pour des raisons de sécurit é, ce paramètre doit être utilisé conjointement à un EXIT de typeannuaire.

[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.

WinNTPour un protocole de communication s’appuyant sur un réseau X25 accédé par une cartenon IBM, la valeur de ce paramètre ID peut être renseignée par une chaîne de caractèresquelconques.

[IDF = 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=<mask> .


CFT V2.35-26


• 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 êtreinférieure ou égale à 64 caractères.

Voir la définition d’un “substring” d’ une variable symbolique au chapitre “ Variablesymbolique” du guide “ Concepts” de CFT.Exemple :

pour un NIDF re çu de 19 caract ères, IDF peut prendre lavaleur : 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 pourlongueur :

- 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éseauutilisée pour les échanges protocolaires).

S’il y a plusieurs ressources (CFTNET) du même type et de la même classe que la ressourceréférencée par ce paramètre NET, les caractéristiques de protocole décrites par cettecommande CFTPROT sont en fait associées à l’ensemble de ces ressources (et non passeulement à celle qui est référencée par NET) : toutes ces ressources peuvent être utiliséespour les échanges protocolaires. Toutes sont concernées (en cas d’appel entrant) par la valeurdu paramètre SAP de cette commande CFTPROT.

Remarque :pour les protocoles définis sur une ressource SNA, il ne peut y avoir plusieurs commandesCFTPROT faisant référence à la même commande CFTNET de type SNA (en SNA, la notionde 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.


CFT V2.3 5-27

Tableau 64. CFTPROT RCOMP - Valeurs par défaut

Protocole Valeur par défaut de RCOMP

PeSIT profil SIT Non pertinent


PeSIT profil CFT 15

PeSIT E (standard) 10

PeSIT E (CFT/CFT) 15

ODETTE 1

ETEBAC3 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 avecle site distant.

[RTO = {260 | n}] {0..3600}

Temporisation (exprimée en secondes) de surveillance réseau hors phase deconnexion/déconnexion/rupture protocolaire.

Correspond au délai d’attente d’une réponse à une FPDU avant déconnexion (READ TIMEOUT).


SAP = string (longueur :voir le tableau)

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 connexionentrantes destinées à ce protocole de communication.

Le SAP qu’un partenaire demandeur fournit lors de sa demande de connexion est retrouvé parle CFT local qui en déduit le protocole à utiliser. Chaque commande CFTPROT dans uneclasse 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, lepremier caractère doit être “#” (dièse) (par exemple : #31 sera compris comme caractèreASCII ‘1’ ).

La valeur du SAP est fonction des protocoles d’échange de données utilisés par chaqueméthode d’accès.


CFT V2.35-28

Tableau 65. FTPROT SAP - Valeurs du paramètre

Méthoded’accès

Taille encaractères

Définition et Commentaires

DNA 1 à 8 OBJET Decnet

DSA

GCOS7

GCOS8

1 à 8

5 à 12

“Mailbox” DSA appelable par le correspondant distant

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)

SNA - Sans objet. Ne doit pas être préciséLe protocole entrant est automatiquement sélectionné à partir dela ressource réseau (LU ou groupe de LU)

TCP/IP 1 à 15 Numéro du port d’écoute local sur lequel le moniteur estappelable, 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

Noms logiques conseillés : cft-0, cft-1, cft-2, cft-3, cft-4, cft-5,cft-6, cft-7 (1)

X25saufGCOS7

et GCOS8

1 à 15 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 leroutage des appels entrants (consultez le “ Guide d’exploitation”de CFT correspondant à votre OS)

X25GCOS7

GCOS8

1 à 8

5 à 12

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’ ilest demandeur

(1) : ces numéros et noms logiques de ports sont des noms et numéros officiellement réservéspar SOPRA auprès de l’ IANA (Internet Assigned Numbers Authority).


CFT V2.3 5-29

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/MVSpour 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 transfertssimultanément avec un CFT V1 en utilisant les User Data pour transporter le SAP. Ceci estune 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 Version1 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 aurapar exemple le paramétrage suivant :

CFTPROT ID = prot1, ...CFTPROT ID = prot2, ...CFTPROT ID = prot3, ...

CFTPART ID = cft370,PROT = (prot1, prot2, prot3),SAP = (sap1 , sap2 , sap3), ...

Le passage d’un protocole à l’autre est automatique lorsque la connexion au précédentest 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 avecun MCH de NPSI défini avec SUBADDR = YES.

WinNT Les couches X25 ATLANTIS ne savent pas orienter les appels entrantsvers plusieurs utilisateurs en fonction des données utilisateurs (“user data” ) despaquets d’appels.

VMS Les SAP numériques X25 (sous-adresse) sont gérés sous VMS sans tenir comptedes zéros sur la gauche. Par exemple : CFTPROT SAP = 05,... et CFTPROTSAP = 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 E (standard) 10

PeSIT E (CFT/CFT) 15

ODETTE 1

ETEBAC3 Utilisable hors norme

Pour plus de précision (valeurs utilisables ...), consultez l’annexe “ Compression”.


CFT V2.35-30

[SRIN = {BOTH | NONE | RECEIVER | SENDER}]

Contrôle le sens des transferts autorisés pour le moniteur CFT lorsqu’ il est serveur (accepteurde la connexion protocolaire).

Les valeurs possibles sont les suivantes :

• SENDER : seules les émissions (de fichiers ou de messages) sont acceptées ; lesré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 ; lesré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.

ETEBACTYPE = 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 transfertETEBAC 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 cettecarte 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èsune interruption de transfert.

Pour une explication détaillée des contraintes et spécificités liées à l’utilisation de ce protocoleparticulier, consultez le “ Guide des protocoles” de CFT.


CFT V2.3 5-31

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éanmoinsdonnée ci-après.

5.2.2.1. Syntaxe

CFTPROTMODE = {REPLACE |CREATE | DELETE},ID = identifier,NET = identifier,

SAP = string, OS

[DISCTD = n,][DISCTS = n,][RESTART = {5 | n},][RTO = {260 | n},][SCOMP = cpr,][RCOMP = cpr,][SRIN = {BOTH | NONE | RECEIVER | SENDER},][SROUT = {BOTH | NONE | RECEIVER | SENDER},][IDF = string,]TYPE = ETEBAC,[EXITE = identifier,]DYNAM = identifier,][RRUSIZE = {4056 | n},][SRUSIZE = {4056 | n}]


[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 desnégociations protocolaires concernant :

• le “crédit”,

• la compression des données,

• la logique spéciale.


CFT V2.35-32

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”. CFTsimule 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 correspondau point d’ interruption de l’émission, tel qu’ il l ’avait détecté. Le point de reprise négocié par unCFT récepteur, correspond toujours à un message de crédit précédemment émis par lui (sauf en casde reprise en début de fichier).

Pour une explication détaillée des contraintes et spécificités liées à l’utilisation de ce protocoleparticulier, consultez le “ Guide des protocoles” de CFT.

5.2.3.1. Syntaxe

CFTPROT

[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,NET = identifier,

SAP = string, OS

[DISCTD = n,][DISCTS = n,][RESTART = {5 | n},][RTO = {260 | n},][SCOMP = cpr,][RCOMP = cpr,][SRIN = {BOTH | NONE | RECEIVER | SENDER},][SROUT = {BOTH | NONE | RECEIVER | SENDER },][IDF = string,]

TYPE = ODETTE, [EXIT = identifier,] [EXITA = identifier,] [DYNAM = identifier,] [RESYNC = {NO | YES},]

[PAD = {NO | YES},][RRUSIZE = {2048 | n},][SRUSIZE = {2048 | n},][RCREDIT = {4 | n},][SCREDIT = {4 | n},][EERP = {91 | 86},][TCP = {CFT | OFTP}]


[EERP = {91 | 86}]

Permet d’ interpréter, suivant la version du protocole, la valeur des champs ORIGINATOR etDESTINATOR 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.


CFT V2.3 5-33

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 auré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 bouten 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 “ logiquespé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ètreSCREDIT) 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 descorrespondants 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 pluspetite 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 estdemandeur.

CFT aura l’autorisation d’émettre un nombre de messages protocolaires “DATA” égal aurésultat de la négociation (effectuée lors de l’établissement de la session protocolaire), avantd’attendre un nouveau “crédit” envoyé par le serveur.


CFT V2.35-34

[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 pluspetite valeur étant retenue comme taille des NSDU émis.


MVS VM VSE 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.

[TCP = {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 fichierstransférés ne sont pas opérationnels avec tous les fichiers supportés ; les transferts reprennent alorsen début de fichier, après une interruption de transfert (consultez le “ Guide d’exploitation” de CFTcorrespondant à 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 deces variantes. Pour plus de clarté, ces paramètres spécifiques sont regroupés ci-dessous suivant laou 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 deces 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.


CFT V2.3 5-35

5.2.4.1. Syntaxe

CFTPROT[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,NET = identifier,

SAP = string,OS

[DISCTD = n,]Dft : PROFIL

[DISCTS = n,]Dft : PROFIL

[RESTART = {5 | n},][RTO = {260 | n},]

[SCOMP = cpr,]Dft : PROFIL

[RCOMP = cpr,] Dft : PROFIL

[SRIN = {BOTH | NONE | RECEIVER | SENDER},][SROUT = {BOTH | NONE | RECEIVER | SENDER},][IDF = string,]

TYPE = PESIT, [EXIT = identifier,] [EXITA = identifier,] [DYNAM = identifier,]

[RRUSIZE = n,][SRUSIZE = n,][DISCTC = {90 | n},][DISCTR = {45 | n},][SPACING = {36 | n},][RPACING = {36 | n},][SCHKW = {2 | n},][RCHKW = {2 | n},]

[MULTART = {NO | YES},] PROFIL

[CONCAT = {NO | YES},] PROFIL

[SEGMENT = {NO | YES},] PROFIL

[PROF = {CFT | ANY | EXTERN | SIT | DMZ},]

PROF = DMZ

[PART = (identifier, identifier, …),][CYCLE = {0 | n},][CTO = n]

PROF = EXTERN

[RESYNC = {NO | YES},][SSERV = identifier]

PROF = CFT


CFT V2.35-36

[RESYNC = {NO | YES},][SSERV = identifier,][REVERSE = {NO | YES},][PAD = {NO | YES}]

PROF = ANY

[RESYNC = {NO | YES},][REVERSE = {NO | YES},][PAD = {NO | YES},][LOGON = {YES | NO}]


[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 partenairesupporte 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 ceparamètre.

S’il y a contrôle d’erreur (PAD = YES) :

• en mode émetteur, CFT inhibe la concaténation des FPDU. CONCAT est implicitementforcé 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 enfonction :

• 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éeindiquée.


CFT V2.3 5-37

[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èsl’émission d’une FPDU CONNECT.


[DISCTR = {45 | n}] {0..3600}

Temporisation d’attente de déconnexion réseau. Délai d’attente (en secondes) de la coupurede connexion par le site partenaire, après avoir émis une demande “abort” (FPDU ABORT).


[LOGON = {YES | NO}] Uniquementen mode demandeur

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 24octets composé de :

- octet 1 à 8 : ‘PESIT ’ (PeSIT suivi de 3 caractères blancs) (correspondant auprotocole 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 ounon 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 partenairesupporte 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 lavaleur de ce paramètre.


CFT V2.35-38

[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 auchoix 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 deparole 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 plusieursFPDU de données, ni regrouper plusieurs articles émis dans une même FPDU dedonné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, lepartenaire 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) duprotocole 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, touten restant conformes au standard PeSIT E. Ces fonctionnalités sont basées surl’ 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, CFTou ANY (correspondant aux profils “Hors SIT”) : en effet, le moniteur CFT en mode serveurs’adapte automatiquement au profil “Hors SIT” proposé par le partenaire demandeur.


CFT V2.3 5-39

[RCHKW = {2 | n}] {0..12}

Taille de la fenêtre d’anticipation de l’acquittement des points de synchronisation enré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 phased’échange des données).

Cette option est négociée avec le partenaire lors de la connexion : si pour l’un descorrespondants 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 surdétection d’une erreur de CRC (PAD=YES).

[REVERSE = {NO |YES}] Uniquement en mode demandeur PeSIT D profil CFT PeSIT E

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 pluspetite 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 desynchronisation.

[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 pluspetite 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.35-40

L’émetteur dispose d’une fenêtre d’acquittement dont la valeur est négociée en phase deconnexion avec la valeur RCHKW du partenaire. Cette fenêtre permet d’émettre les donnéesen anticipation sur les acquittements. SCHKW=0 signifie qu’ il n’y pas d’acquittement depoints de synchronisation.

Sur réseau LU6.2, toute valeur non nulle sera forcée à 1 lors de la négociation protocolaire.

[SEGMENT = {NO | YES}] Uniquementen mode émetteur

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 taillemaximum d’une NSDU diminué de 6 octets. Ceci concerne les FPDU de données etnon les autres FPDU protocolaires.Rappelons que la taille des NSDU à l’émission est négociée à l’aide du paramètreSRUSIZE 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 estemployée conjointement avec l’option CONCAT = YES. Elle n’est pas exclusive avecl’ 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 moniteursupportant 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 (find’article).

Face à un moniteur CFT, à partir la version V210, elle peut toujours être adoptée. En effet, enmode récepteur, ce moniteur accepte les FPDU d’articles segmentés quelle que soit la valeurlocale du paramètre SEGMENT.

Remarque :la valeur SEGMENT = YES est conseillée pour optimiser les transferts entre deux moniteursV2.1.0 ou supérieur. Si un moniteur est en version V2.0, SEGMENT doit être renseigné à NOcar 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 pluspetite valeur sera retenue comme intervalle entre les points de synchronisation. La valeur 0signifie 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’ tousles ‘n Koctets’ de données transmises (‘n’ étant la valeur d’ intervalle la plus petite négociéeen 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’ interruptiondu transfert, un point de reprise pour une relance ultérieure.


CFT V2.3 5-41

[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 pluspetite 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 desegmentation est mise en oeuvre.


MVS VM VSEEn 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.

[SSERV = {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 appelsentrants.

PeSIT D profil EXTERNEn profil Extern, la valeur par défaut est : SSERV = ‘PESIT ’.Cette valeur est normalisée.

PeSIT D profil CFTEn profil CFT, la valeur par défaut est : SSERV = ‘CFTPSITX’.Cette valeur ne convient qu’en méthode d’accès X25. Avec les autresméthodes d’accès réseau, on emploie usuellement les valeurssuivantes : en SNA LU-0 : CFTPSITS, en SNA 3270 : CFTPSIT2, enPAD : CFTPSITP.

Face à CFT 370/V1, on fait correspondre cette valeur à la valeur deRSERV configurée dans la V1.Face à CFT/PC, on fait correspondre cette valeur au paramétrage(Login type) de CFT/PC.

PeSIT profil ANYLa 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 contenudu message qui contient alors la valeur “PESIT.

Rappelons qu’en profil SIT, la valeur par défaut est : SSERV = ‘ ’ . Dans ce profil, ceparamètre est sans effet. En effet, en profil SIT, il n’y a pas de message de Logon.


CFT V2.35-42

5.2.4.3. Exemples

PeSIT profil SIT

CFTPROT ID = PSITIN, /* Protocole PSITIN*/TYPE = PESIT, PROF=SIT, /* PeSIT SIT */NET = ACCEPTOR,SCOMP = 0, /* Pas de compression*/RCOMP = 0, /* en profil SIT*/CONCAT = YES

Protocole PeSIT, profil SIT, associ é au protocole d’échange dedonn ées et aux ressources r éseau d éfinies par la commande CFTNETID=ACCEPTOR.

Les temporisations seront les valeurs par d éfaut ( consultezl’ annexe “La compression” de ce document ). Chaque FPDU contient unseul enregistrement de fichier (MULTART=NO). Il n ’ y aura pas decompression en ligne.

PeSIT D profil EXTERN

CFTPROT ID = PSITEXT,TYPE = PESIT,NET = xx,PROF = EXTERN,CONCAT = YES,MULTART = YES,SEGMENT = NO

PeSIT D profil CFT

CFTPROT ID = PSITCFT,TYPE = PESIT,NET = yy,PROF = CFT,CONCAT = YES,MULTART = YES,SEGMENT = YES

PeSIT E

CFTPROT ID = PSITE,TYPE = PESIT,NET = zz,PROF = ANY,CONCAT = YES,MULTART = YES,SEGMENT = YES


CFT V2.3 5-43

5.3 CFTETB - Format de la carte ETEBAC 3

La commande CFTETB est nécessaire si le paramétrage de CFT contient une commandeCFTPROT de type ETEBAC 3.

Cette commande permet de créer, modifier ou supprimer, suivant les caractéristiques relatives autransfert (identification du ou des partenaires ...), le format de la carte paramètre utilisée pour cetransfert.

Rappelons qu’en ETEBAC 3, une carte paramètre est échangée entre les correspondants, lors del’établissement de la connexion, ce qui permet de s’accorder en particulier sur le format desdonné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 correspondanteCFTSEND/SEND ou CFTRECV/RECV).

Ceci aussi bien en émission (DIRECT = SEND) qu’en réception (DIRECT = RECV). Dans cemode, 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ériqueutilisée en émission,

• et/ou la carte CFTETB ID=ALL, DIRECT = RECV, ... permettant de décrire la cartegé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 celleutilisée en réception :

CFTETB ID = ALL,DIRECT = SEND,...

CFTETB ID = ALL,DIRECT = RECV,...


CFT V2.35-44

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 estimposé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 sensde transmission,

• de trois octets réservés,

• en cinquième position (position numérotée à 4) : de quatre octets indiquant la longueurd’enregistrement du fichier à transmettre.

Le contenu des autres champs n’est pas imposé par la norme, leur signification est définieconventionnellement 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. Lavaleur 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 carteparamètre (valeur par défaut). Comme une carte paramètre a une longueur totale de 80caractères et que 8 caractères sont obligatoires en en-tête de carte, la somme deslongueurs des champs “ len” des paramètres facultatifs utilisés ne peut dépasser 72caractères (en protocole ETEBAC 3). Si le nombre de caractères affecté à un champ estinférieur à celui indiqué dans le champ “ len” , ce champ est complété dans la carte pardes caractères “blancs” EBCDIC (x40).

Il convient de noter que le moniteur CFT laisse la possibilité, en cinquième position dela carte, de ne pas indiquer de longueur d’enregistrement ou d’ indiquer une longueurd’enregistrement supérieure à quatre octets. Ceci n’est pas protocolaire ETEBAC 3mais 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èresarbitraires, é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 del’ exploitation du moniteur CFT, en protocole ETEBAC.


CFT V2.3 5-45

5.3.3. Syntaxe

CFTETB[MODE = {REPLACE | CREATE | DELETE},]

DIRECT = {RECV | SEND},ID = identifier,[IDF = { “ ” | identifier},]NLRECL = {pos, 255 | len},[SNAME = {pos, 255 | len},][NSPASSW = {pos, 255 | len},][NIDF = { pos, 255 | len},][VER = {pos, 255 | len},][NPART = {pos, 255 | len},][NBR = {pos, 255 | len},][PARM = {pos, 255 | len},][FREE1 = {pos, 255 | len,content},][FREE2 = {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 carteparamètre.

Le champ “content” permet de définir une chaîne de caractères arbitraires, échangées entre lespartenaires mais non exploitées par le moniteur CFT. Cette chaîne doit avoir une longueurinfé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 carteparamètre.

Le champ “content” permet de définir une chaîne de caractères arbitraires, échangées entre lespartenaires mais non exploitées par le moniteur CFT. Cette chaîne doit avoir une longueurinfé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 partenaireconcerné,

• soit, si cette description n’existe pas, de la description CFTETB ID = ALL.


CFT V2.35-46

En mode serveur, c’est toujours la description CFTETB ID = ALL qui permet de décoder lacarte 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 lesfichiers 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 fichiertype 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 = ‘ ’ qui permet dedécoder la carte paramètre reçue.

Il est donc nécessaire, pour fonctionner en mode serveur, de disposer des descriptionssuivantes :

CFTETB DIRECT = SEND, ID = ALL, IDF = ‘ ’CFTETB DIRECT = RECV, ID = ALL, IDF = ‘ ’

[NBR = {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. Lemoniteur 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).


CFT V2.3 5-47

[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, contenudans 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 MODE = REPLACE,DIRECT = RECV,ID = ALL,NLRECL = (4,4),NSPASSW = (8,8),FREE1 = (16,12, ’ MESSAGE #1 ’ ),FREE2 = (28,24, ’ MESSAGE DE BIENVENUE No2’ ),NPART = (52,18)

CFT V2.3 6-1

6. Les commandes de paramétrage despartenaires

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/identifiantle 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é detransport",

• 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 dedé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

CFTPARTID = identifier,SAP = (string, string, ....),[COMMENT = string,][COMMUT = {YES | NO | SERVER | PART},][FPREFIX = string,][GROUP = identifier,][IDF = identifier,][IMAXTIME = {23595999 | time},][IMINTIME = {00000000 | time},][IPART = identifier,][MODE = {REPLACE | CREATE | DELETE},]

[NRPART = string,] PROTOCOLE

[NRPASSW = string,] PROTOCOLE

[NSPART = string,] PROTOCOLE

Les commandes de paramétrage des partenaires

CFT V2.36-2

[NSPASSW = string,] PROTOCOLE

[OMAXTIME = {23595999 | time},][OMINTIME = {00000000 | time},][PROT = (identifier | mask, identifier | mask, ...),][RAUTH = {* | identifier},][SAUTH = {* | identifier},][STATE = {ACTIVEBOTH | ACTIVEREQ | ACTIVESERV | NOACTIVE}][SYST = GCOS7 | GCOS8 | GUARD | UNIX | VMS | VOS | MVS | VM |

VSE | OS400 | WINNT |WIN3X},][TRK = {UNDEFINED | ALL | NO | SUMMARY},][XLATE = identifier]

6.1.2. Paramètres


Commentaire local associé au partenaire.

Non exploité lors des transferts, excepté pour le protocole ODETTE. Peut être consulté (parexemple par la commande LISTPART). On peut donc l’utiliser pour associer localement unlibellé 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 lacommande CFTPROT qui sera valide pour tout partenaire rattaché à ce protocole.

[COMMUT = {YES | NO | SERVER | PART}] Uniquement sur un site de commutation

Type de commutation supporté pour ce partenaire.

Les types suivants sont possibles :

• YES : correspond à la “commutation store and forward”,

• SERVER : correspond à la “commutation par serveur RVA”,

• NO : la commutation est refusée pour ce partenaire,

• PART : la commutation est forcée en mode serveur si le destinataire renseigné dans le paramètre IPART n'est pas le destinataire final.

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 à laréception (CFTSEND ou SEND, CFTRECV ou RECV), ce nom de fichier est concaténé aunom spécifié dans le paramètre FNAME.


CFT V2.3 6-3

[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ètreDEFAULT 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 lepartenaire (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êmeNRPART et des NSPART différents, l’utilisation de ces commandes étant strictement limitéeau mode demandeur (voir le mécanisme dans l’annexe “Partenaire à même valeur deNRPART” 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écritdans 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 appelsentrants.


CFT V2.36-4

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ètreNSPART de la commande CFTPART décrivant le moniteur CFT local.

Remarque :

ODETTE En mode serveur, il est possible d’avoir plusieurs commandes CFTPART comportant unNRPART identique. Pour cela, il faut spécifier IMINTIME = IMAXTIME.

[NRPASSW = 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 sitelocal.

Le partenaire doit présenter ce mot de passe au moniteur CFT local, lors de la phase deconnexion. De son côté, ce partenaire (s’ il s’agit d’un moniteur CFT V2) doit déclarer ce motde passe comme paramètre NSPASSW de la commande CFTPART décrivant le moniteurCFT local.

[NSPART = {valeur du paramètre NPART de CFTPARM | string}]

string8

string24

string25

string28

PeSIT profil SIT

PeSIT D profil EXTERN PeSIT D profil CFT

PeSIT E

ODETTE

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 descriptionCFTPART telle que le paramètre NRPART associé corresponde à cette valeur.

[NSPASSW = string]

string8

string8

string22

PeSIT

ODETTE

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 CFTPARTcorrespondant.


CFT V2.3 6-5

[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 lemoniteur CFT (appels sortants).

Une fourchette de durée nulle signifie que le moniteur CFT ne peut appeler directement lepartenaire ; il met alors en oeuvre le mécanisme de commutation en appelant le siteintermédiaire (paramètre IPART).

PROT = (identifier | mask, identifier | mask,..)

Liste des protocoles de communication (identifiants ID de CFTPROT) autorisés pourcommuniquer 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 cestransferts 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 moniteuracceptera 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éfinisau niveau du moniteur,

• dans le second exemple, par tous les protocoles commençantpar les lettres “prot”.

[RAUTH = {* | identifier} ]

Identifiant (paramètre ID) de la commande CFTAUTH désignant une liste d’ IDF autoriséspour 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 nonautorisés (voir la commande CFTAUTH).


CFT V2.36-6

SAP = (string, string, ...) longueur : voir le tableau ci-dessous

Valeurs des SAPs distants (service access points) associés à chacun des protocoles définis parle paramètre PROT.

Vers un autre moniteur que le moniteur CFT V2, l’emploi de cette informationcomplémentaire est à étudier au cas par cas.

Vers un moniteur CFT V2, ce paramètre est exploité pour désigner le protocole auprès dumoniteur CFT V2 partenaire. En d’autres termes, le “sap” est une informationcomplémentaire permettant d’atteindre un sous-ensemble applicatif distant (un protocole dansle cas de CFT) et non pas seulement un moniteur.

Chacune des valeurs du paramètre représente le “sap” associé au protocole de communicationdont 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, lepremier caractère doit être “#” (dièse) (par exemple : #31 sera compris comme caractèreASCII ‘1’ ).

Le nombre maximum de SAPs est égal au nombre maximum de protocoles (voir le tableau duparamè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.


CFT V2.3 6-7

Tableau 67. CFTPART SAP - Valeurs du paramètre

Méthoded’accès

Taille encaractères(alphanum)

Définition et Commentaires

DNA 1 à 6 OBJET Decnet

DSA

GCOS7

GCOS8

1 à 8

1 à 8

“Mailbox” (nom de la boîte aux lettres DSA) de l’applicationmoniteur distant

“Mailbox” (nom de la boîte aux lettres DSA) de l’applicationmoniteur distant telle que définie dans la ”Workstation” de cetteapplication

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 Numéro du port sur lequel le moniteur partenaire est à l’écoute etqui peut avoir comme valeur :

• un numéro en clair correspondant au numéro réel utilisé par lepartenaire distant au niveau du protocoleNumé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 etconfiguré dans le fichier SERVICES, si celui-ci existeNoms 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 nomlogique du port défini dans la base de données “SERVICES”, lacohérence entre les 2 bases doit être assurée

X25 saufGCOS7 etGCOS8

1 à 15 Valeur véhiculée dans le paquet d’appels sortant sous la forme :

• de sous adresse (subaddr) dont la valeur doit être numérique etqui 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 devaleurs) est significatif pour le routage des appels entrants(consultez le “ Guide d’exploitation” de CFT correspondant à votreOS)

(1) : ces numéros et noms logiques de ports sont des noms et numéros officiellement réservéspar SOPRA auprès de l’ IANA (Internet Assigned Numbers Authority).


CFT V2.36-8

[SAUTH = {* | identifier}]

Identifiant (paramètre ID) de la commande CFTAUTH désignant une liste d’ IDF autoriséspour 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 nonautorisé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èmed’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 duparamètre FCODE de la commande CFTXLATE),

• dans ce profil et lorsque le partenaire est récepteur, dedéclarer au moniteur CFT V2 partenaire le “ type” de cefichier, au sens de son système d’exploitation (paramètreNTYPE).

PeSIT D profil CFT PeSIT E CFT/CFT

[TRK = {UNDEFINED | ALL | NO | SUMMARY}]






• UNDEFINED : les options de suivi sont définies dans le paramètre TRKPART de la commande CFTPARM.



CFT V2.3 6-9


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= <xlate>.

Si ce paramètre n’est pas renseigné, les tables de transcodage peuvent également êtreprécisées dans les commandes SEND/CFTSEND (ou RECV/CFTRECV). Si ces tables n’ysont pas renseignées, la commande CFTXLATE ID=<default> les précise par défaut. En casd’absence de cette commande, ce sont les tables de transcodage internes au moniteur qui sontutilisé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 = RECPAR5, /* Les fichiers autoris és à recevoir --> voir CFTAUTH */

NRPART = BULLDPS, /* Nom et mot de passe que le */NRPASSW = 44NTS, /* partenaire pr ésente à la connexion */NSPART = LOCALCFT,/* Nom et mot de passe que CFT pr ésente */NSPASSW = 75P015, /* au partenaire à la connexion */IMINTIME = 0700, /* Ne peut appeler qu ’ entre */IMAXTIME = 0900, /* 7 et 9 heures */

OMINTIME = 1000, /* Ne peut être appel é qu ’ entre */OMAXTIME = 1200, /* 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 émettren’ importe quel IDF vers le moniteur CFT local, alors qu ’ il n ’ estautoris é à recevoir que les fichiers auxquels on a attribu é un IDFfigurant dans la liste RECPAR5 d éfinie par une commande CFTAUTH.

Le param ètre SYST n’étant pas pr écis é, le moniteur consid ère queson partenaire est la m ême machine.

Il n ’ y a donc pas de conversion de code des donn ées, et pas detraduction des types de fichier émis.


CFT V2.36-10

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 departenaires, 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 localjouant 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 leparamètre FNAME.

Ces deux méthodes sont exclusives : le paramètre PART et le paramètre FNAME ne peuvent êtreutilisé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’estpas 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 danscette 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 (sidiffusion) 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, laprocédure traitant les incidents de transfert (paramètre EXECSE ou EXECRE de CFTPARM) estalors exécutée. L’enregistrement associé à ce transfert prend l’état correspondant à celui del’ incident. L’enregistrement associé au SEND ou RECV reste, dans ce cas (au moins un transferten incident), à l’état K.


CFT V2.3 6-11

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 = {REPLACE | CREATE | DELETE},][EXEC = {DEST | PART},]ID = identifier,PART = (identifier, identifier, ...),[FOR = {BOTH | COMMUT | LOCAL}]

CFTDEST[MODE = {REPLACE | CREATE | DELETE},][EXEC = {DEST | PART},]ID = identifier,FNAME = filename,[FOR = {BOTH | COMMUT | LOCAL}]

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’enregistrementgénérique. Par exemple, la variable &PART est substituée par l’ identifiant de lacommande 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 aussisoumise. 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 commandeCFTDEST.

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éfinitiond’un partenaire n’empêchera pas la diffusion ou la collecte vers les partenaires définis ; seulsles partenaires non décrits ne seront pas servis.


CFT V2.36-12

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 premierscaractè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 uncommentaire,

• un identifiant peut être indifféremment saisi en caractères majuscules ou minuscules (ilest transformé en majuscules),

• le fichier peut contenir des enregistrements de longueur nulle.

Exemple de fichier :

Identifiantcorrespondant

1---5--8--10-------20 (Colonnes)

part_a Ceci est un commentaire ’ PART_A’

PART 1 ’ PART 1’

PART2 ’ PART2’

PARTENAIRE ’ 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 êtreutilisé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 :


• &PART, &RPART, &SPART, &NPART, &GROUP,

• &SUSER, &RUSER,

• &SAPPL, &RAPPL,


• &NIDF,

• &NFNAME, &NFVER.

[FOR = {BOTH | COMMUT | LOCAL}]

Contrôle de l’exploitation de la liste des partenaires.

La valeur renseignée peut être :

• LOCAL : la liste des partenaires est exploitée en local pour la diffusion (émission) oula 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 6-13

Ce moniteur reçoit un fichier (ou un message) avec comme nom réseau de destinatairela valeur de l’ identifiant de cette commande CFTDEST (il n’existe pas de partenaireidentifié par le nom réseau reçu). Ce fichier (ou ce message) sera alors diffusé vers lespartenaires de cette liste de diffusion ainsi définie,

• 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 dessites distants dont il est le site intermédiaire,

- en réception : collecte de fichiers (ou de messages).

ID = identifier

Identifiant de la liste de partenaires.

Cet identifiant doit être unique. Il n’est pas possible de spécifier plusieurs commandesCFTDEST avec le même ID.

PART = (identifier, identifier, ...)

Liste explicite des identifiants des différents partenaires (correspondants chacun à une valeurdu 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 oucollecte).

6.3 CFTXXX - Définition r éseau des partenaires

Les commandes de type CFTxxx permettent, chacune pour un type de réseau donné, de définir lesparamè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 AccessPoint) 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écifiquessuivantes. Leur description n’est donc par reprise par la suite.


CFT V2.36-14

6.3.1. Syntaxe

CFTxxx[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,

[IMINTIME = {00000000 | time},][IMAXTIME = {23595999 | time},][OMINTIME = {00000000 | time},][OMAXTIME = {23595999 | time},]

[RETRYM = {12 | n},][RETRYN = {6 | n},][RETRYW = {7 | n},]

[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 (modeserveur).

La valeur maximale supportée pour chaque système est indiquée dans le commentaire duparamè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 cepartenaire.

Le tableau suivant indique la valeur maximale supportée pour chaque système.

Tableau 68. CFTXXX CNXINOUT - Nombre maximum de sessions

OS Maximum supporté

GCOS7 32

GCOS7 90

GUARDIAN 20

MVS 240

OS400 32

UNIX 48

VM 16

VMS 32

VOS 200

VSE 16

WinNT 16


CFT V2.3 6-15

[CNXOUT = {2 | n}] {0..voir le tableau}

Nombre maximum de sessions pour les connexions sortantes avec ce partenaire (modedemandeur).

La valeur maximale supportée pour chaque système est indiquée dans le commentaire duparamè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 "Guidedes 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 laconfiguration réseau par défaut d’un partenaire appelant (fonctionnement en modeSERVEUR donc si le partenaire est uniquement DEMANDEUR). Dans ce cas, les paramètresspé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 venantde 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 cepartenaire 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 dereconnexion.

[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 etmultiplie RETRYW par deux puis recommence la séquence à concurrence du nombre totalprévu (RETRYM).


CFT V2.36-16

[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 uneconnexion 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 desparamètres licites est néanmoins donnée ci-après, les paramètres communs étant rappelés en débutde liste.

6.3.3.1. Syntaxe

CFTDNA[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,[IMINTIME = {00000000 | time},][IMAXTIME = {23595999 | time},][OMINTIME = {00000000 | time},][OMAXTIME = {23595999 | time},][RETRYM = {12 | n},][RETRYN = {6 | n},][RETRYW = {7 | n},][CNXOUT = {2 | n},][CNXIN = {2 | n},][CNXINOUT = {2 | n},]NODE = string

6.3.3.2. Paramètre

NODE = string6

Identifiant Decnet de la machine distante (Nom de nœud Decnet).


CFT V2.3 6-17

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 estconnu 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 uneconnexion 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 desparamètres licites est néanmoins donnée ci-après, les paramètres communs étant rappelés en débutde 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 pardéfaut 1).

Ces deux paramètres identifient en effet de manière unique un accès DSA.

6.3.4.1. Syntaxe

CFTDSA[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,[IMINTIME = {00000000 | time},][IMAXTIME = {23595999 | time},][OMINTIME = {00000000 | time},][OMAXTIME = {23595999 | time},][RETRYM = {12 | n},][RETRYN = {6 | n},][RETRYW = {7 | n},][CNXOUT = {2 | n},][CNXIN = {2 | n},][CNXINOUT = {2 | n},][CLASS = {1 | n},]NODE = (string, string, ...),

SBMID = string, OS

SBMPROJ = string, OS

PIDNODE = string OS


CFT V2.36-18


[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 cepartenaire et dans le paramètre TSAP de la commande CFTNET TYPE = DSAcorrespondante.

Un partenaire peut correspondre à plusieurs “noeuds” DSA, qui seront adresséssuccessivement en cas d’échec de connexion avec les précédents. Le nombre maximum denoeuds possibles est de 4.

SBMID = string GCOS7

Permet le contrôle d’ identification du “submitter ID”.

GCOS7 Ce paramètre est facultatif.Lors des appels sortants DSA, si ce paramètre n’est pas renseigné, la lettre de connexionDSA transporte l’“ID ” du “submitter” de CFT pour l’exécution en cours.

SBMPROJ = 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 connexionDSA 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 demandesde connexion sortantes (il n’y a pas ici l’équivalent du paramètre VERIFY de la commandeCFTX25). Ce sont des informations transportées dans les lettres de connexion DSA etvérifi ées par GCOS7, lors des demandes de connexion entrantes : contrôle d’accès défini dansle fichier de configuration réseau.

6.3.4.3. Exemple

CFTDSA MODE = CREATE, /* Point d ’ acc ès DSA au */ID = PARIS5, /* partenaire PARIS5 */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 */NODE = PARI, /* Noeud DSA */PIDNODE = HT02


CFT V2.3 6-19

Le partenaire PARIS5 est connu comme noeud DSA. Pas de classepr é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 lesvaleurs par d éfaut, soit :

• 6 tentatives espac ées de 7 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 noeudDSA 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 lescommunications sur réseau SNA.

Seuls les paramètres spécifiques à la commande CFTSNA sont détaillés. La liste exhaustive desparamè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 dumoniteur CFT/370 version 1 est le niveau 160.



• mais également le paramètre CLASS (si sa valeur est différente de la valeur pardé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 = {REPLACE | CREATE | DELETE},]ID = identifier,[IMINTIME = {00000000 | time},][IMAXTIME = {23595999 | time},][OMINTIME = {00000000 | time},][OMAXTIME = {23595999 | time},][RETRYM = {12 | n},][RETRYN = {6 | n},][RETRYW = {7 | n},][CNXOUT = {2 | n},][CNXIN = {2 | n},]


CFT V2.36-20

[CNXINOUT = {2 | n},][CLASS = n,]

LUNAME = string, OS

= (string,string...), OS

[LOGMODE = string,] OS

Le paramètre CLASS est utilisé sur tous les systèmes. Par contre, l’emploi et la signification desautres 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 OUI (OUI)

OS400 OUI (OUI)

VM OUI (OUI)

VMS OUI (OUI) (OUI)

VOS OUI

VSE 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 lepartenaire.

Cette valeur de classe est définie dans la commande CFTNET correspondant à la méthoded’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 ceCFTSNA à partir du protocole imposé par CFTPART (ce mécanisme permettant d’associerplusieurs CFTSNA à un CFTPART).


CFT V2.3 6-21

[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 laLU à VTAM (paramètre DLOGMOD). Il est recommandé de préciser un nom de LOGMODEbasé sur les exemples fournis avec la procédure d’ installation de CFT. La “ logmode” pardé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, quelque 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 unré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 desessions parallèles sur une LU.

Ces valeurs comportent des “*” pour désigner une suite de noms de LU.

Syntaxe : <luname>* ou <luname>**

<luname>* La liste des LU, de <luname>x à <luname>9<luname>** La liste des LU, de <luname>xx à <luname>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.36-22

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 enpremier (au maximum 1296 possibilités, il est déconseillé de permettre un nombre siimportant).

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 lepartenaire.


Ce paramètre sera exploité lors d’une demande de connexion sortante, pour sélectionner ceCFTSNA à partir du protocole imposé par CFTPART (ce mécanisme permettant d’associerplusieurs CFTSNA à un CFTPART).


CFT V2.3 6-23

[LOGMODE = string8]

Chaîne de caractères représentant une ‘LOGMODE’ utilisée sur le host partenaire (définiedans VTAM).

Identifie l’entrée dans le “Logtable” sur le “host” , en précisant les caractéristiques de lasession.

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 (nomAPPL).

OS400 C’est le logon APPLID envoyé par l’AS/400 pour établir une session LU0 avec le Host.

VOS 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 avecce partenaire.

CFTSNA ID = PART1, /* partenaire PART1 */CLASS = 2,LUNAME = xxxxx,LOGMODE = CFT2LOG

Cette commande d éfinit le mode d ’ acc ès SNA LU0 au partenairePARIS5. Le nom de la logmode est celui d éfini au niveau duhost 370.

CFTSNA MODE = CREATE, /* Point d ’ acc ès SNA au */ID = PARIS5, /* partenaire PARIS5 */LUNAME = CFT, /* Nom d ’ ACB du CFT distant */CLASS = 1,IMINTIME = 2200, /* Peut appeler et être appel é */OMINTIME = 2200, /* de 22 à 24 heures */CNXOUT = 1, /* Autorise 1 appel sortant */CNXIN = 1, /* 1 appel entrant */CNXINOUT = 1 /* 1 seule session SNA */


CFT V2.36-24

Cette commande d éfinit le mode d ’ acc ès SNA LU2 au partenairePARIS5. 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 = x,LUNAME = ....,DATA = .....,....

Pour LU0 :CFTSNA ID = ...,

CLASS = y,LUNAME = ....,DATA = .....,LOGMODE = .....,....

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 laconnexion se fera selon le mode “ CFT400” qui correspond, dans ladéfinition de la MODETAB, à une LU0.Cinq sessions simultan ées sont possibles.

VMS

CFTSNA MODE = CREATE, /* Point d ’ acc ès SNA au */ID = PARIS5, /* partenaire PARIS5 */LUNAME = CFT, /* Nom APPL distant */LOGMODE = CFTVAX, /* Entree dans LOGTABLE */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 */


CFT V2.3 6-25

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 laconnexion se fera selon le mode “ CFTVAX” , qui correspond, dans ladé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 uneconnexion 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 desparamètres licites est néanmoins donnée ci-après.

6.3.6.1. Syntaxe

CFTTCP[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,[IMINTIME = {00000000 | time},][IMAXTIME = {23595999 | time},][OMINTIME = {00000000 | time},][OMAXTIME = {23595999 | time},][RETRYM = {12 | n},][RETRYN = {6 | n},][RETRYW = {7 | n},][CNXOUT = {2 | n},][CNXIN = {2 | n},][CNXINOUT = {2 | n},]HOST = (string, string, …)


HOST = string32

HOST = (string64, string64, …)

Adresse IP ou liste d’adresses IP du correspondant avec lequel l’utilisateur désire entrer ensession. 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 :

• 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 lefichier “base de données” correspondant (HOST), fourni avec tout package TCP/IP.


CFT V2.36-26

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 aumnémonique SUN3.

Les tentatives de connexion (relances) s ’ espaceront dans le tempsselon l ’ algorithme suivant :


• 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 uneliaison sur X25 public ou X25 privé.

Il peut y avoir plusieurs commandes CFTX25 par partenaire, mais une seule commande pour unpartenaire et une classe donnée.



• mais également le paramètre CLASS (si sa valeur est différente de la valeur pardé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 despartenaires X25. CFT/MVS permet également la communication avec despartenaires X25, avec une définition de réseau de type CFTSNA, s’appuyant sur lafonction PCNE de X25/NPSI.

Seuls les paramètres spécifiques à la commande CFTX25 sont détaillés. La liste exhaustive desparamètres licites est néanmoins donnée ci-après.


CFT V2.3 6-27

6.3.7.1. Syntaxe

CFTX25[MODE = {REPLACE | CREATE | DELETE},]ID = identifier,[IMINTIME = {00000000 | time},][IMAXTIME = {23595999 | time},][OMINTIME = {00000000 | time},][OMAXTIME = {23595999 | time},][RETRYM = {12 | n},][RETRYN = {6 | n},][RETRYW = {7 | n},][CNXOUT = {2 | n},][CNXIN = {2 | n},][CNXINOUT = {2 | n},][CLASS = {1 | n},]DIALNO = (n, n, .....),[PCVI = {YES | NO},][PCVO = {NO | YES},][SPEED = n,][GFA = (n, n, .....),][FACILITY = string,][DATA = string,][VERIFY = {0 | n}]


[CLASS = {1 | n}] {1..32)

Classe de la (ou des) ressource(s) locale(s) X25 permettant d’établir la liaison avec lepartenaire.


Ce paramètre sera exploité lors d’une demande de connexion sortante, pour sélectionner ceCFTX25 à partir du protocole imposé par CFTPART (ce mécanisme permettant d’associerplusieurs 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 commandeCFTPART est sous forme de sous-adresse. Il ne doit pas être renseigné si le paramètre SAPde la commande CFTPART est sous forme de “user data” . Dans ce cas, les “user data” sontrenseignés par la valeur de ce paramètre SAP.


CFT V2.36-28

DIALNO = (n, n, ...)

Numéro ou liste de numéros d’appel X25 du correspondant avec lequel on désire entrer ensession.

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 doitse limiter à l’adresse X25, et ne pas être étendu avec une sous-adresse. Dans ce cas, la sous-adresse sera renseignée par la valeur du paramètre SAP de la commande CFTPART, pour leprotocole choisi.

[FACILITY = string64]

Chaîne de caractères alphanumériques donnant la représentation hexadécimale du “champfacilités” X25.

Ce champ est ajouté aux facilités déduites des paramètres SPEED, PCVI, PCVO et GFA. Lacohé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 listeest 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 ducircuit virtuel sera celle de l’abonnement ou de la ligne X25.


CFT V2.3 6-29

[VERIFY = {0 | n}]

Option de vérification du numéro (DIALNO) du partenaire lors de la demande de connexionentrante (les “n” premiers chiffres du numéro appelant seront contrôlés).

Cette option peut être activée lorsqu’en protocole PeSIT un partenaire demandeurimpose à CFT un changement d’ identifiant d’un transfert à l’autre, sur le même circuitvirtuel.

Si VERIFY = 0, il n’y a pas de vérification.

6.3.7.3. Exemple

CFTX25 MODE = CREATE, /* point d ’ acc ès X25 */ID = PARIS5, /* au partenaire PARIS5 */CLASS = 1, /* 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 partenairesont les valeurs par d éfaut, soit 2 pour les appels entrants, 2pour 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 lechamp “ user data ” ne sera pas renseign é (SAP sous forme desous-adresse),

• Le champ “ user data ” sera renseign é (SAP sous forme de“ user data ” ).

Les param ètres IMINTIME, IMAXTIME, OMINTIME et OMAXTIME ne sontpas renseign és. Il n ’ y a donc pas d ’ autre contrainte horaire pourles appels de type X25 que celles d écrites éventuellement pour cepartenaire dans la commande CFTPART. Les valeurs par d éfaut desparam ètres PCVI et PCVO sont affect ées au partenaire, qui peutdonc appeler le CFT local en PCV, mais que le CFT local ne peutpas appeler en PCV.

Les tentatives de connexion (relances) s ’ espaceront dans le tempsselon l ’ algorithme :


• 2 tentatives espac ées de 4 minutes.

PeSIT


CFT V2.36-30

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 uneconnexion LU6.2.

Seuls les paramètres spécifiques à la commande CFTLU62 sont détaillés. La liste exhaustive desparamètres licites est néanmoins donnée ci-après.

6.3.8.1. Syntaxe

CFTLU62ID = identifier,[CLASS = {1 | n},][CNXIN = {2 | n},][CNXINOUT = {2 | n},][CNXOUT = {2 | n},][IMINTIME = {0000000 | time},][IMAXTIME = {23595999 | time},][OMINTIME = {0000000 | time},][OMAXTIME = {23595999 | time},][RETRYM = {12 | n},][RETRYN = {6 | n},][RETRYW = {7 | n},][MODE = {REPLACE | CREATE | DELETE},]

NETWKID = string, OS

CPNAME = string, OS

LUNAME = string,TPNAME = string,MODENAME = string


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’ellessoient 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.


CFT V2.3 6-31

MODENAME = string1..8

Nom du MODE. Le mode contient des paramètres décrivant les règles de gestion de lasession (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.36-32

CFTLU62 id = as400 ,luname = luas400 ,class = 6 ,tpname = l62hdx.cftpgm ,modename = cft2appc ,cnxin = 2 ,cnxinout = 4 ,cnxout = 2 ,mode = 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 X25ainsi 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 sontexplicitement précisés ici, ils priment sur les paramètres indiqués dans la commande CFTNET.

6.3.9.1. Syntaxe

CFTASYID = identifier,CLASS = {1 | n},MODE = {CREATE | REPLACE | DELETE},DIALNO = string,[PADNO = string,][MODOUT = string,][SPEED = {2400 | n},][PADSET = string,][DATA = string,][FACIL = string,][CONFIG = string,]LINEID = string


CLASS = {1 | n} {1..32}


[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 lepartenaire.

Ce fichier de configuration, s’ il est précisé, prévaut sur le fichier indiqué dans la commandeCFTNET ou, à défaut, sur le fichier interne.


CFT V2.3 6-33

[DATA = string1...32]

Chaîne de caractères représentant les données utilisateur émises dans les DATA deconnexion.

DIALNO = string {1...32}

Numéro du partenaire.

Ce numéro peut avoir les formes suivantes :

• <n° RTC> pour une liaison synchrone de bout en bout,

• <n° X25> 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 “champfacilité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 decaractè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, impulsionnelleou 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.36-34

[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 lavaleur 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 enmode tempo, avec un tempo de 0,15 secondes.

[SPEED = {2400 | n}]

Vitesse de la transmission en bits/seconde.

CFT V2.3 7-1

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 oubien 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 deréférencer les caractéristiques du partenaire (définies dans la commande CFTPART) ou la liste departenaires (définie dans la commande CFTDEST).

Les relations entre la commande SEND et les commandes CFTSEND, CFTPART et CFTDESTsont indiquées dans l’annexe “Schémas de chaînage des commandes” du guide “Concepts” deCFT.

Lors d’une émission d’un fichier, CFT crée un poste dans le catalogue. Ce poste (visualisable parla commande LISTCAT) est identifié de façon unique, pour un moniteur donné, par les valeurs desparamètres IDT (IDentifiant de Transfert) et PART. Les émissions effectuées lors d’une diffusionsont 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, lesinformations qu’ il peut obtenir sur le fichier réel (à transmettre), au moment de l’activation dutransfert (valeur par défaut des paramètres FTYPE, FORG, FLRECL, FRECFM).

7.1.1.1. Syntaxe

SENDIDF = identifier,PART = identifier,

[APPCYCID = identifier,],[APPOBJID = name,][FDATE = date,][FNAMEABS = {YES | NO},][FTIME = time,][IDA = identifier,][NIDF = string,][TRK = {UNDEFINED | ALL | NO | SUMMARY},][TYPE = FILE,]

Les commandes associées aux transferts

CFT V2.37-2

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},]

[FACTION = {NONE | DELETE | ERASE | ROTATE},] VFM

[FBLKSIZE = n,] OS

[FCODE = {BINARY | ASCII | EBCDIC},]

[FDB = filename,] VFM

[FKEYLEN = {0 | n},] PROTOCOLE

[FKEYPOS = {0 | n},] PROTOCOLE

[FLRECL = n,] OS

[FNAME = filename,]



[FSPACE = n,]

[FTYPE = c,] OS

[MAXDATE = date,][MAXTIME = {23595999 | time},][MINDATE = {date système du jour | date},][MINTIME = {00000000 | time},]

[NBLKSIZE = n,] PROTOCOLE OS

[NCODE = {BINARY | ASCII | EBCDIC},]

[NCOMP = cpr,]PROTOCOLE


[NKEYLEN = {0 | n},] PROTOCOLE

[NKEYPOS = {0 | n},] PROTOCOLE

[NLRECL = n,]

[NRECFM = {F | U | V},] PROTOCOLE OS


CFT V2.3 7-3

[NSPACE = n,] PROTOCOLE

[NTYPE = c,] PROTOCOLE OS

[PARM = string,] PROTOCOLE

[PRI = {128 | n},]




[SELFNAME = filename][SPART = string,][STATE = {DISP | HOLD | KEEP},]


[TCYCLE = {DAY | MIN | MONTH},][XLATE = identifier,]


APPCYCID = identifier {1…250}

Identifiant du cycle de traitement (ensemble d’occurrences de suivi concernant un seultransfert).

Ce paramètre n'est utilisable qu'à partir de la version CFT V2.3.1.

APPOBJID = name {1…50}

Nom de l’objet suivi.

Dans Sentinel, un objet suivi est un objet de base de données qui décrit des évènementsapplicatifs.


• 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.


[FDATE = date] PeSIT ODETTE

Date associée au fichier lors du transfert.

Véhiculé par le protocole.


CFT V2.37-4

[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 dufichier.

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] PeSIT ODETTE

Heure associée au fichier lors du transfert.

Véhiculé par le protocole.

ODETTE La valeur par défaut est calculée par rapport à l’ identifiant de transfert local.

[IDA = identifier]


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 à lavaleur de cet IDF :

CFTSEND ID = <idf>,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 commandeCFTSEND ID = <default>.

Cet identifiant peut être un critère de recherche du poste catalogue associé à ce transfert (voirla commande LISTCAT).


CFT V2.3 7-5

Remarque :si la commande CFTSEND a été configurée pour pouvoir répondre à une demande detransfert issue du partenaire (émission implicite) :

CFTSEND ID = <valeur de l’ IDF du SEND implicite>,IMPL = YES,...

Il est nécessaire, pour pouvoir effectuer un SEND explicite en assurant la cohérence destransferts, de configurer une autre commande CFTSEND de même ID (égal à l’IDF de ceSEND) mais avec IMPL= NO .

CFTSEND ID = <valeur de l’ IDF du SEND explicite>,IMPL = NO,...

NIDF = string Utilisable en mode demandeur-émetteuret serveur-émetteur (STATE = HOLD)

string28

string14

string7

string26

string28

PeSIT E CFT/CFT

PeSIT E

PeSIT D

ODETTE

ETEBAC3

Identifiant “réseau” du fichier.

Si ce paramètre est utilisé, il prime sur le paramètre NIDF de la commande CFTIDFcorrespondante.

Par défaut (pas de paramètre NIDF, ni de commande CFTIDF correspondante), l’ identifiant“réseau” est égal à l’identifiant local (NIDF = IDF).



CFT V2.37-6

PART = identifier

Identifiant du partenaire de transfert.

Cet identifiant désigne soit :

• un partenaire décrit par la commande :

CFTPART ID = <valeur de ce paramètre PART>, ...

• une liste de partenaires décrite par la commande :

CFTDEST ID = <valeur de ce paramètre PART>,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 CFTlocal va se présenter à son partenaire.

Usuellement, la valeur de ce paramètre est égale à l’ identifiant (paramètre ID) d’unecommande CFTPART. Le NSPART envoyé sera celui défini dans cette commande. Dans cecas, 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 commutationRVA : lors de l’activation de la commande SEND vers le site destinataire, l’utilisation de ceparamètre SPART permet, en effet, de forcer le NSPART envoyé à celui de l’émetteurINITIAL 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_PART2le NSPART envoy é est égal au NSPART de la commandeCFTPART ID = ID_PART2 soit : NSPART = PART2 .


CFT V2.3 7-7







• UNDEFINED : les options de suivi sont définies dans le paramètre TRK de la commandeCFTSEND.


[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 constitutiond’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 le2 d écembre 1993, l ’ heure 10 Heures 00 minute 00 seconde 00centi è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, tousles jours entre 10h00 et 10h30, pendant la p ériode qui couvre toutle 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 unpartenaire désigné.

La longueur maximum de ce message est de :

• 80 caractères en PeSIT D profil CFT,

• 512 caractères en PeSIT E.


CFT V2.37-8

7.1.2.1. Syntaxe

SENDIDM = identifier,MSG = string,PART = identifier,TYPE = MESSAGE,[IDA = identifier,]

FACULTATIFS COMMUNS A CFTSEND

[RAPPL = string,][SAPPL = string,][RUSER = string,][SUSER = string,][EXEC = filename,][PRI = pri,][MINDATE = date,][MAXDATE = date,][MINTIME = time,][MAXTIME = time,][CYCDATE = date,][CYCTIME = time,][CYCLE = {0 | n},][TCYCLE = {DAY | MIN | MONTH}]


[IDA = identifier]


Cet identifiant peut être un critère de recherche du poste catalogue associé à ce transfert (voirla 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

string512

PeSIT D profil CFT

PeSIT E

Texte émis vers le partenaire.

Ce texte pourra comporter des espaces. Dans ce cas, il devra être inclus entre simples quotes(‘ ’ ).


CFT V2.3 7-9

PART = identifier

Identifiant du partenaire pour ce transfert.




• une liste de partenaires décrits dans la commande :


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 commandeCFTSEND, pertinent pour l’émission d’un message. Il n’ inclut aucun des paramètres relatifs auxfichiers.

Exemple

SEND TYPE = MESSAGE, PART = SIEGE, IDM = ANDRE,MSG = ‘ ANDRE : rappeler PIERRE ’

Emission d ’ un message d ’ identifiant ANDRE :

• vers le partenaire SIEGE si la commande CFTPART ID = SIEGEest d éfinie,

• sinon, vers la liste de partenaires (identifi ée parSIEGE) :

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 cesprotocoles.

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 dumessage. 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 detransfert à acquitter. Cette fonctionnalité pourra être exploitée, par exemple, en fin de traitementd’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 ayantservi pour ce transfert. L’acquittement d’un transfert est une notion protocolaire.


CFT V2.37-10

7.1.3.1. Syntaxe

SENDIDM = identifier,IDT = transid,MSG = string,PART = identifier,TYPE = REPLY,[IDA = identifier,]

FACULTATIFS COMMUNS A CFTSEND

[EXEC = filename,][PRI = pri]


[IDA = identifier]



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 étatRT 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 deréception d’un fichier (cas d’utilisation la plus fréquente), on utilisera pour renseigner lavaleur de ce paramètre IDT la variable symbolique &IDT, permettant de récupérerl’ identifiant du transfert associé au fichier reçu.


CFT V2.3 7-11

MSG = string

string80

string512

PeSIT D profil CFT ODETTE

PeSIT E

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édurede fin de réception, l’utilisateur pourra renseigner ce paramètre en utilisant la variablesymbolique &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 cetransfert, le SITE B émet le message “ Fichier PAYE bien re çu” versle partenaire PART, en utilisant la variable &PART du transfertd’ origine. L ’ identifiant de transfert à acquitter (IDT) estrenseign é par la variable symbolique &IDT.

Figure 6. Mécanisme d’émission d’un message de réponse

Lancement d ’une commande SEND TYPE = REPLY :

SEND TYPE = REPLY, PART = &PART,IDM = MES2, IDT = &IDT,MSG = ‘Fichier PAYE bien reçu’

SITE A SITE B

SEND PART = SITEB, IDF = PAYEIDT=A0112102

Fin de Transfert

Transfert

IDT = A0112102

Réception du message deréponse au transfert identifié par :PART = SITEB, IDT = A0112102


CFT V2.37-12

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 partenairedé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 OUI NON NON

ODETTE NON OUI NON

PeSIT D profil EXTERN OUI NON NON

PeSIT D profil CFT OUI OUI OUI

PeSIT E (standard) OUI NON NON

PESIT E CFT/CFT OUI OUI OUI

Les caractéristiques de cette demande de réception peuvent être précisées dans la commandeRECV elle-même ou bien dans la commande CFTRECV, dont l’ ID est égal à la valeur duparamè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 RECVpermet de référencer les caractéristiques du partenaire (définies dans la commande CFTPART), oula liste de partenaires (définie dans la commande CFTDEST).

Les relations entre la commande RECV et les commandes CFTRECV, CFTPART et CFTDESTsont indiquées dans l’annexe “ Schémas de chaînage des commandes” du guide “Concepts” deCFT.

Lors d’une réception d’un fichier, CFT crée un poste dans le catalogue. Ce poste (voir lacommande LISTCAT) est identifié de façon unique, pour un moniteur donné, par les valeurs desparamètres IDT (IDentifiant de Transfert) et PART. Les réceptions effectuées lors d’une collectesont identifiées avec la même valeur d’ IDT, mais avec des valeurs de PART différentes.


CFT V2.3 7-13

7.1.4.1. Syntaxe

RECVPART = identifier,IDF = { identifier | mask},

[APPCYCID = identifier,][APPOBJID = name,][CYCLE = {0 | n},]

[FILE = {FIRST | ALL},] PROTOCOLE

[IDA = identifier,]


[NIDF = string,][NFVER = {0 | n},][TCYCLE = {DAY | MIN | MONTH},][TRK = {UNDEFINED | ALL | NO | SUMMARY},]

PARAMETRES FACULTATIFS COMMUNS A CFTRECV

[COMMENT = string,][CYCDATE = date,][CYCTIME = time,][DIRNB = n,][EXEC = filename,][EXIT = identifier,]

[FACTION = {VERIFY | DELETE | ERASE},] VFM

[FACTION = {CONCAT | DELETE | ERASE | VERIFY},] VFM

[FBLKSIZE = n,] OS


[FCOMP = {0 | 15},] VFM

[FDB = filename,] VFM

[FDISP = {BOTH | NEW | OLD},]

[FKEYLEN = {0 | n},] PROTOCOLE

[FKEYPOS = {0 | n},]

[FLRECL = n,] OS

[FNAME = filename,]

[FRECFM = {F | U | V },] PROTOCOLE



CFT V2.37-14

[FSPACE = n,]

[FTYPE = c,] OS

[MACTION = { “ ” | REPLACE},]

[MAXDATE = {voir le commentaire | n},][MAXTIME = {23595999 | time},][MINDATE = {date système du jour | date},][MINTIME = {00000000 | time},]

[NCOMP = cpr,] PROTOCOLE

[PRI = {128 | n},][WFNAME = filename,][XLATE = identifier,]


[APPCYCID = identifier] {1…250}

Identifiant du cycle de traitement (ensemble d’occurrences de suivi concernant un seultransfert).


[APPOBJID = name] {1…50}

Nom de l’objet suivi.

Dans Sentinel, un objet suivi est un objet de base de données qui décrit des évènementsapplicatifs.


• 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.


[CYCLE= {0 | n}]

Nombre d’unités définissant la période du cycle de transfert (voir paramètre TCYCLEci-après).


CFT V2.3 7-15

[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 = <valeur correspondant à l’IDF envoyé par le demandeur>,

IMPL = NO,...

avec commande SEND STATE = HOLD sur ce fichier,

– en émission implicite uniquement si l’ IDF est un “ identifier” (sans masque), avecle paramétrage associé suivant :CFTSEND ID = <valeur correspondant à l’IDF envoyé par le demandeur>,

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 ; ellepermet de retrouver la description (CFTRECV) du fichier type récepteur.Après chaque transfert, le demandeur/récepteur demande à recevoir le fichier suivanten 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écanismeprotocolaire,

• côté serveur/émetteur, ces fichiers en attente doivent être en émission bloquée, avec leparamétrage associé suivant :

CFTSEND ID = <valeur correspondant à l’IDF envoyé par le demandeur>,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éspar 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 dutransfert, concernant le premier fichier en attente d’émission.


CFT V2.37-16

[IDA = identifier]



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 ouplusieurs IDF explicites.

ODETTE Seule la valeur IDF = * est pertinente.

[NFNAME = 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.





• &SUSER, &RUSER,

• &SAPPL, &RAPPL,


• &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) peutentraî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 desous-arborescences apparaissant à droite du caractère délimiteur seront créés.


CFT V2.3 7-17

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 = <valeur correspondant à l’IDF du RECV demandeur>,

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 = <valeur correspondant à l’IDF du RECV demandeur>,IMPL = YES,FNAME = &NFNAME,...

MVS VMS Si le fichier indiqué est un fichier à versions, la version à émettre est laversion 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 lapartie gauche du nom doit exister.

Voir, pour plus de détails sur les mécanismes mis en oeuvre, l’annexe “Localisation desfichiers 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éduitdu NFNAME reçu.


CFT V2.37-18

Figure 7. Exemple de paramétrage

CFTRECV ID = IDF1 , FNAME = X, ...

RECV IDF = IDF1 , PART = ... NFNAME = <dir>/<filelist>

CFTSEND IDF = IDF1 , IMPL = YES, FNAME = &NFNAME

Fichier X Répertoire <dir>

1 enregistrement = 1 entrée de <dir>

[NFVER = {0 | n}] VFM PeSIT profil ANY PeSIT profil CFT

Numéro de version du fichier émis, s’ il s’agit d’un fichier GDG.

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 baseVFM 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ètreNFVER. 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é.


CFT V2.3 7-19

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ètreNFVER.

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 defichier à traiter (normal ou à versions).Voir les exemples pour une meilleure compréhension.

NIDF = string Utilisable uniquement en mode demandeur-récepteur(pour un IDF explicite)

string28

string14

string8

string26

string28

PeSIT E CFT/CFT

PeSIT E

PeSIT D

ODETTE

ETEBAC3

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 CFTIDFcorrespondante.

Par défaut (pas de paramètre NIDF, ni de commande CFTIDF correspondante), l’ identifiant“réseau” est égal à l’identifiant local (NIDF = IDF).


PART = identifier

Identifiant du partenaire (serveur émetteur distant) associé à ce transfert.




• une liste de partenaires décrite par la commande :


(ou FNAME = filename).


CFT V2.37-20

[TCYCLE = {DAY | MIN | MONTH}]

Unité de la période du cycle de transfert :

• DAY : jour,

• MIN : minute,

• MONTH : mois.







• UNDEFINED : les options de suivi sont définies dans le paramètre TRK de la commandeCFTRECV.


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, entre8h00 et 8h30.


CFT V2.3 7-21

VFM

Mode ouvert, émission implicite :

RECV PART = SIEGE,IDF = STAT,NFNAME = FICSTAT,NFVER = 1

CFTSEND IMPL = YES,FNAME = &NFNAME (-&NFVER),FDB = . . .

Demande de r éception de la version -n du fichier logique STAT. Lacommande CFTSEND, c ôté é metteur, pr écise que le fichier émis estun fichier logique (param ètre FDB). Le demandeur r écepteur d ésigneexplicitement le fichier à recevoir (NFNAME).

Mode ferm é :

RECV PART = SIEGE,IDF = STAT,NFVER = n

CFTSEND IMPL = YES,FNAME = &PART.&IDF.MVT (-&NFVER),FDB = . . .

Demande de r éception de la version -n du fichier STAT. La commandeCFTSEND, c ôté é metteur, pr écise que le fichier émis est un fichierlogique (param ètre FDB).

GDG

Mode ouvert, émission implicite :

RECV PART = SIEGE,IDF = STAT,NFNAME = FICSTAT,NFVER = 1

CFTSEND IMPL = YES,FNAME = &NFNAME (-&NFVER)

Demande de r éception de la version -1 du fichier FICSTAT. Ledemandeur r écepteur d ésigne explicitement le fichier à recevoir(NFNAME).

Mode ferm é :

RECV PART = SIEGE,IDF = STAT,NFVER = n

CFTSEND IMPL = YES,FNAME = &PART.&IDF.MVT (-&NFVER)

Demande de r éception de la version -n du fichier &PART.&IDF.MVT.


CFT V2.37-22

VFM

GDG

Le num éro de version n ’ est pas pr écis é.

RECV PART = SIEGE,IDF = STAT

CFTSEND ID = STAT,IMPL = YES,FNAME = &PART.&IDF.MVT(-&NFVER)

Le num éro de version par d éfaut sera 0 (z éro). L’émetteursé 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 encours 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 estautomatiquement détruit.

7.2.1.1. Syntaxe

DELETEPART = {identifier | mask},

[DIRECT = {BOTH | RECV | SEND},][IDT = {* | transid},][IDF = identifier,][IDA = identifier,][IDTU = string,][STATE = {* | C | D | H | K | T | X}]



Sens de transmission des requêtes concernées.


• 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 7-23

[IDA = identifier]


Plusieurs postes catalogue peuvent être associés à un même IDA. Pas de valeur par défaut.

[IDF = identifier]


Plusieurs postes catalogue peuvent être associés à un même IDF. Pas de valeur par défaut.

[IDT = { * | transid}]


Il identifie un transfert pour un partenaire et un sens donnés. La valeur ‘* ’ signifie que l’on nesouhaite pas effectuer de sélection sur le paramètre IDT (valeur par défaut).

[IDTU = string8]


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 cepartenaire,

• un masque (mask) : la commande concerne les transferts avec les partenaires dontl’ 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 cechapitre.

La valeur par défaut * signifie que l’on ne souhaite pas effectuer de sélection sur l’état detransfert (consultez le chapitre “Actions et phases successives à un transfert” dans le guide“Concepts” de CFT).

7.2.1.3. Exemples

Exemple 1DELETE PART = SIE??

Suppression de tous les transferts (IDT = * par d éfaut) enémission et en r éception (DIRECT = BOTH par d éfaut), pour lespartenaires dont l ’ identifiant commence par “ SIE ” et comprend, entout, 5 caract ères.

Exemple 2DELETE 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 partenaireSIEGE.


CFT V2.37-24

7.2.2. HALT - Arr êt de transferts

Cette commande permet la suspension d’un ou de tous les transferts en émission et/ou enré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). Ilspourront ê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, ousimplement en début de fichier.

7.2.2.1. Syntaxe

HALTPART= {identifier | mask},

[DIRECT = {BOTH | RECV | SEND},][IDT = {* | transid},][IDF = identifier,][IDA = identifier,][IDTU = string]





• 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]



[IDF = identifier]




CFT V2.3 7-25



Il identifie un transfert pour un partenaire donné. La valeur ‘* ’ signifie que l’on ne souhaitepas effectuer de sélection sur le paramètre IDT (valeur par défaut).

[IDTU = string8]




La valeur associée de ce paramètre peut être :



7.2.2.3. Exemples

Exemple 1HALT PART = *

Arr êt de tous les transferts (IDT = * par d éfaut) en émission etré ception (DIRECT = BOTH par d éfaut), pour tous les partenaires.

Exemple 2HALT PART = SIEGE, IDF = COMPTA, DIRECT = SEND

Arr êt du transfert en émission du fichier type COMPTA pour lepartenaire 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 avecle ou les partenaires sélectionnés.

La suspension se distingue de l’ interruption (HALT) par le fait que seule une interventionmanuelle 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 desuspension et, selon le protocole utilisé, autorise la reprise du transfert au dernier point desynchronisation posé avant interruption, ou simplement en début de fichier.


CFT V2.37-26

7.2.3.1. Syntaxe

KEEPPART = {identifier | mask},

[DIRECT = {BOTH | RECV | SEND},][IDT = {* | transid},][IDF = identifier,][IDA = identifier,][IDTU = string]


[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]



[IDF = identifier]






[IDTU = string8]








CFT V2.3 7-27

7.2.3.3. Exemples

Exemple 1KEEP PART = PARIS2

Suspension de tous les transferts (IDT = * par d éfaut) en émissionet r éception (DIRECT = BOTH par d éfaut) avec le partenaire PARIS2.

Exemple 2KEEP PART = PARIS*, IDF = PAYE, DIRECT = RECV

Suspension de la r éception du fichier PAYE provenant d ’ unpartenaire 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

RESUMEPART= {identifier | mask},

[DIRECT = {BOTH |RECV | SEND},][IDT = {* | transid},][IDF = identifier,][IDA = identifier,][IDTU = string]




• 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]




CFT V2.37-28

[IDF = identifier]






[IDTU = string8]







7.2.4.3. Exemples

Exemple 1RESUME PART = PARIS5

Remise à disposition de tous les transferts en mode serveur avecle partenaire PARIS5.

Exemple 2RESUME PART = PARIS5, IDF = PAYERemise à disposition des transferts en mode serveur avec lepartenaire 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 cettecommande ; ces transferts seront donc relancés effectivement après scrutation du catalogue et siles ressources nécessaires sont disponibles.

Remarque :

ODETTE 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. Poureffectuer la reprise des transferts, il faut activer une nouvelle commande RECV.


CFT V2.3 7-29

7.2.5.1. Syntaxe

STARTPART= {identifier | mask},

[DIRECT = {BOTH |RECV | SEND},][IDT = {* | transid},][IDF = identifier,][IDA = identifier,][IDTU = string][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 surune requête n'ayant pas encore atteint l'heure minimale d'exécution.

[IDA = identifier]



[IDF = identifier]







CFT V2.37-30

[IDTU = string8]







7.2.5.3. Exemples

Exemple 1START PART = PARIS5

Redémarrage de tous les transferts (IDT = * par d éfaut) enémission et r éception (DIRECT = BOTH par d éfaut) avec lepartenaire PARIS5.

Exemple 2START PART = PARIS5, IDF = PAYE, DIRECT = RECV

Redémarrage des transferts en r éception pour l ’ IDF PAYE provenantdu 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 transfertsé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 (defichier ou de message) est en état T.

Cette commande n’a aucun effet sur les transferts appartenant à une liste de diffusion même siceux-ci sont en état T. En revanche, elle peut être appliquée sur le transfert générique (dont lePART est égal à l’identifiant de la liste de diffusion) lorsqu’ il est à l’état T.

7.2.6.1. Syntaxe

SUBMITPART = {identifier | mask},

[DIRECT = {BOTH | RECV | SEND},][IDT = {* | transid},][IDF = identifier,][IDA = identifier,][EXEC = filename]


CFT V2.3 7-31






• 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 lesens 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éspré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 leparamètre EXEC* correspondant.

• dans les traitements de la procédure à exécuter.

La liste des variables symboliques est indiquée dans le paragraphe “Variablessymboliques” du guide “Concepts” de CFT.

[IDA = identifier]


Plusieurs postes catalogue peuvent être associés à un même IDA.

Pas de valeur par défaut.

[IDF = identifier]


Plusieurs postes catalogue peuvent être associés à un même IDF.

Pas de valeur par défaut.


CFT V2.37-32



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 (valeurpar défaut).




• un identifiant : la commande concerne seulement les transferts avec ce partenaire,

• un masque : la commande concerne les transferts avec les partenaires dont l’ identifiantcorrespond à 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 transfertsé lectionn é par la commande SUBMIT. Ceci permet la substitutiondes variables symboliques éventuellement utilis ées dans laproc édure soumise.

7.2.6.3.2. Liste de diffusion

CFTDEST ID = liste,PART = (part1, part2, part3)

CFTPART ID = part1,...



CFTSEND PART=liste, IDF=myfile, EXEC=myprog


CFT V2.3 7-33

La proc édure myprog est ex écut ée UNE FOIS quand l ’ ensemble destransferts est termin é.

Le catalogue avant l ’ ex écution de la proc édure de fin de transfertse 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 LISTE MYFILE (transfert générique)

SFT PART1 MYFILE

SFT PART2 MYFILE

SFT PART3 MYFILE

Il sera possible de soumettre à nouveau la proc édure de fin detransfert 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 (parexemple 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 (émissioncomme 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 etpasseront à l’état X (état exécuté).

7.2.7.1. Syntaxe

ENDPART = {identifier | mask},

[DIRECT = {BOTH | RECV | SEND},][IDT = {* | transid},][IDF = identifier,][IDA = identifier]








CFT V2.37-34

[IDA = identifier]



[IDF = identifier]











7.2.7.3. Exemples

Exemple 1END 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 dontl’ identifiant local (IDA) est X32451 et relatifs au fichier typed’ identifiant (IDF) TEST.

Exemple 2END PART = SIEGE, IDT = A0110503

Mise à l’état ex écut é du transfert d ’ identifiant (IDT) A0110503relatif au partenaire (PART) SIEGE. Ce transfert peut être enémission ou en r éception (DIRECT=BOTH par d éfaut).


CFT V2.3 7-35

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

MQUERYNAME = {CAT | COMMAND}


NAME = {CAT | COMMAND}

Nom du composant à interroger.

Ce paramètre peut prendre les valeurs suivantes :

• CAT : interrogation du cache catalogue,

• COMMAND : interrogation du cache de commandes.

7.3.1.3. Exemples

Interrogation du cache catalogue

MQUERY NAME=CATLe r ésultat d ’ une interrogation du cache catalogue (requ êtes detransferts 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 lalimite des 15 premi ères.CFTI24I *** 4 REQUEST(S) INTO TRANSFER CACHE (SIZE=512)CFTI24I *** D=2000/11/02 T=18:00:00.01 PART=PPANYX1 IDF=1 IDT=D1015401CFTI24I *** D=2000/11/02 T=18:00:00.02 PART=PPANYX1 IDF=1 IDT=D1015402CFTI24I *** D=2000/11/02 T=18:00:00.03 PART=PPANYX1 IDF=1 IDT=D1015403CFTI24I *** D=2000/11/02 T=18:00:00.03 PART=PPANYX1 IDF=1 IDT=D1015404CFTR12I MQUERY Treated for USER userid

Interrogation du cache de commande

MQUERY NAME=COMMANDLe r ésultat d ’ une interrogation du cache de commandes donne lecompte-rendu suivant:CFTI20I *** 2 COMMAND(S) INTO CACHECFTI20I *** DATE=02/11/2000 TIME= 22:00:00.00 SWITCH LOGCFTI20I *** DATE=03/11/2000 TIME= 00:00:00.00 SWITCH ACCOUNTCFTR12I MQUERY Treated for USER userid


CFT V2.37-36

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 commandeCFTPART.

Attention : elle ne peut donc agir sur les partenaires dont la définition a été fournie ou modifiée parun EXIT annuaire.

Un partenaire désactivé par la commande INACT ne peut être réactivé que par une commandeACT.

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 lasession est déjà ouverte.

Les transferts interrompus par une commande INACT avec le paramètre FORCE=YES seretrouvent en état H avec un code diagnostic 121 et un code diagnostic protocolaire OPER.

7.4.1.1. Syntaxe

INACT[TYPE = PART,]ID = identifier,[MODE = {BOTH | REQUESTER | SERVER},][FORCE = {NO | YES}]


[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 ouméta-caractères.


CFT V2.3 7-37

[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, suivid’une commande INACT MODE=REQUESTER, ne signifie pas que le partenaire est inactifpour les deux modes, mais seulement pour le mode REQUESTER (dernière commandepassé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.


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 parun 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 [TYPE = PART,]ID = identifier,[MODE = {BOTH | REQUESTER | SERVER}]


CFT V2.37-38


[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 oumé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, suivied’une commande ACT MODE=REQUESTER, ne signifie pas que le partenaire est actif pourles 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 :

• 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-1

8. Les commandes d’administration du moniteurCFT

8.1. SHUT - Arrêt de CFT

Demande d’arrêt du moniteur CFT, avec interruption des transferts en cours ou en laissant lestransferts 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’estinitialisé.

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 lacommande 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. Lesnoms de ces fichiers sont accessibles par les variables symboliques :

• &FLOG pour le nom du fichier journal avant basculement,

• &FACCNT pour le nom du fichier statistique avant basculement.

Les commandes d’administration du moniteur CFT

CFT V2.38-2

Il est essentiel qu’à la fin du traitement effectué par cette procédure, ces fichiers (utilisés avantbasculement) 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 auxfichiers statistiques :

• TYPE = LOG.

La commande SWITCH provoque l’arrêt de l’écriture des messages sur le fichierjournal en cours, le basculement de l’écriture sur l’autre fichier journal et l’exécutionde 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 fichierstatistique en cours, le basculement de l’écriture sur l’autre fichier statistique etl’ exécution de la procédure décrite par le paramètre EXEC de la commandeCFTACCNT.

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 moniteurCFT est installé.

8.3.1. Syntaxe

ABOUT[COMMENT = string32]

8.3.2. Paramètre


Commentaire libre.

Ce commentaire est affiché et peut être utilisé pour indiquer une information spécifique(exemple : nom du client, ...).


CFT V2.3 8-3

8.3.3. Informations affich ées

Cette commande affiche les informations suivantes :

About <comment>CFT informations : * product = <Nom du produit> * version = <No de version> * level = <Etat technique>

* upgrade = <corrections>

Host informations : * model = <Modèle> * cpuid = <No CPU>

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 CLIENTCFT informations : * product = CFT/OS2 * version = 2.2.0 * level = 061-177-xxxx

Host informations : * model = KERNEL * cpuid = 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 cadred'une optimisation paramétrée dans la carte CFTCAT, via le paramètre OPTIMIZE (voir lesfonctionnalité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 = CAT,][NAME = valeur]

Les commandes d’administration du moniteur CFT

CFT V2.38-4

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 carteCFTCAT.

CFT V2.3 A-1

A. La compression

A.1. La compression

La compression est liée au protocole. Certains protocoles supportent un ou plusieurs types decompression, 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 Utilisable hors norme

ODETTE OUI

PeSIT D profil CFT OUI

PeSIT D profil Extern OUI

PeSIT E OUI


A.1.1. Compression en protocole PeSIT “hors SIT”

En protocole PeSIT, quatre types de compression peuvent être utilisés, décrits dans le tableausuivant.

Tableau 73. Protocole PeSIT - Types de compression

Type de compression Valeur CFT

Compression d’une suite de caractères “espace” EBCDIC 01

Compression d’une suite de caractères identiques (compression horizontale) 02

Compactage de caractèresCe compactage ne s’applique qu’à des caractères EBCDIC(chiffres convertis en BCD, caractère “espace”)

04

Compression verticale, par rapport aux caractères de l’enregistrement précédent 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 seracompressée sur 2 octets.Mais en PeSIT D profil CFT et en PeSIT E entre deux moniteurs CFT, une suite de 2 à 31caractères identiques sera compressée sur 2 octets et une suite de 32 à 287 caractères identiquessera 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.

La compression

CFT V2.3A-2

Définition de la compression verticale (08) :il s’agit de la compression par comparaison d’articles consécutifs. Le premier article n’est jamaiscompressé. A partir du deuxième, une comparaison est effectuée par rapport à l’article précédentpour repérer des chaînes de caractères identiques. Deux chaînes de caractères sont considéréescomme identiques si elles contiennent la même série de caractères et si elles sont situées à la mêmeposition de l’enregistrement.

La valeur de la compression ‘cpr’ est le résultat de la somme des divers types de compressionsouhaité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 duGSIT, soit au maximum à une compression des caractères identiques (y compris lesblancs) et une compression verticale,

• toutes les valeurs de 0 à 15 en protocole PeSIT D profil CFT et en PeSIT E entre deuxCFT : ‘cpr’ est le résultat d’un “et logique” entre les valeurs des types de compressionchoisis.

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 lacommande CFTSEND (ou CFTRECV), par rapport à la compression autorisée du protocole par leparamè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 à bitentre les valeurs précisées dans les commandes CFTPROT, CFTSEND/CFTRECV etSEND/RECV.

Exemple :

en profil CFT :

- CFTPROT RCOMP = 13, ... (1101 soit 1+4+8)

- CFTSEND/CFTRECV .... , (1111 soit 1+2+4+8) (la valeur par défaut est 15)

- 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 lepartenaire,au début du transfert.

De plus, la compression est négociée entre les partenaires, et celle effectivement utilisée lors dutransfert correspondra aux types de compression prévus par les deux partenaires.


CFT V2.3 A-3

Par exemple, si un partenaire demande une compression horizontale et l’autre partenaire unecompression verticale, aucune compression ne sera effectuée lors des transferts. Par contre, si unpartenaire demande une compression horizontale et une compression verticale et que l’autrepartenaire souhaite une compression verticale, les transferts se feront en utilisant la compressionverticale.

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 Dprofil Extern

PeSIT Dprofil 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 lavaleur du paramètre SCOMP/RCOMP de la commande CFTPROT. Les paramètres SCOMP etRCOMP comportent une valeur par défaut qui est 1.

Le paramètre NCOMP agit uniquement en émission (SEND) et sert à inhiber éventuellement lacompression, lors de cette émission, si elle avait négociée à 1 (SCOMP / RCOMP à 1) lors de laphase 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 decompression normalisée). Entre deux moniteurs CFT, il est néanmoins possible d’appliquer unecompression en ligne, à condition que les deux partenaires appliquent la même valeur decompression, car aucune négociation n’est réalisée. Les valeurs référençant les algorithmes decompression utilisables, sont les mêmes que celles définies pour PeSIT D profil CFT (0 à 15).

CFT V2.3 B-1

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 :

• le type du fichier local (valeur du FTYPE),

• le système destinataire (indiqué dans le paramétrage local de l’émetteur :CFTPART SYST =).

NTYPE émis par défaut

CFT V2.3B-2

Tableau 75. CFTSEND/SEND - Valeur du NTYPE pour les systèmes émetteurs etdestinataires

NTYPE implicitement envoyé vers (SYST =) :

GCOS7 GCOS8 WinNT OS400 UNIX VMS Autres

Emetteur FTYPElocal

GCOS7 B B

S S B B

GCOS8 B B P

B B P

0 0 B B P

1 1 B B P

2 2 B B P

6 6 T E T P

7 7 T E T P

A A T E T P

T T B B PWinNT T T E T P

OS400 B B

D B D B

E 6 T E T P

S B S B

Z B Z B

UNIX B B B P

T T E T P

V V B P

X X E T P

O T E O P

VMS P B B P

F T E T F

L T E T L

R T E T R

C B B C

Autres B B P

CFT V2.3 C-1

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

00 00 00

01 01 01

02 02 02

03 03 03

04 04 37

05 05 2D

06 06 2E

07 07 2F

08 08 16

09 09 05

10 0A 25

11 0B 0B

12 0C 0C

13 0D 0D

14 0E 0E

15 0F 0F

16 10 10

17 11 11

18 12 12

19 13 13

20 14 3C

21 15 3D

22 16 32

23 17 26

24 18 18

25 19 19

26 1A 3F

27 1B 27

28 1C 1C

29 1D 1D

30 1E 1E

31 1F 1F

SP 32 20 40

! 33 21 5A

Transcodage : tables internes, exemples

CFT V2.3C-2

Tableau 76. Correspondances ASCII / EBCDIC (suite)


” 34 22 7F

# 35 23 7B

$ 36 24 5B

% 37 25 6C

& 38 26 50

’ 39 27 7D

( 40 28 4D

) 41 29 5D

* 42 2A 5C

+ 43 2B 4E

, 44 2C 6B

- 45 2D 60

. 46 2E 4B

/ 47 2F 61

0 48 30 F0

1 49 31 F1

2 50 32 F2

3 51 33 F3

4 52 34 F4

5 53 35 F5

6 54 36 F6

7 55 37 F7

8 56 38 F8

9 57 39 F9

: 58 3A 7A

; 59 3B 5E

< 60 3C 4C

= 61 3D 7E

> 62 3E 6E

? 63 3F 6F

@ 64 40 7C

A 65 41 C1

B 66 42 C2

C 67 43 C3

D 68 44 C4

E 69 45 C5

F 70 46 C6

G 71 47 C7

H 72 48 C8

I 73 49 C9

J 74 4A D1

K 75 4B D2

L 76 4C D3

M 77 4D D4

N 78 4E D5


CFT V2.3 C-3



O 79 4F D6

P 80 50 D7

Q 81 51 D8

R 82 52 D9

S 83 53 E2

T 84 54 E3

U 85 55 E4

V 86 56 E5

W 87 57 E6

X 88 58 E7

Y 89 59 E8

Z 90 5A E9

[ 91 5B AD

\ 92 5C E0

] 93 5D BD

^ 94 5E 5F

_ 95 5F 6D

‘ 96 60 79

a 97 61 81

b 98 62 82

c 99 63 83

d 100 64 84

e 101 65 85

f 102 66 86

g 103 67 87

h 104 68 88

i 105 69 89

j 106 6A 91

k 107 6B 92

l 108 6C 93

m 109 6D 94

n 110 6E 95

o 111 6F 96

p 112 70 97

q 113 71 98

r 114 72 99

s 115 73 A2

t 116 74 A3

u 117 75 A4

v 118 76 A5

w 119 77 A6

x 120 78 A7

y 121 79 A8

z 122 7A A9


CFT V2.3C-4



{ 123 7B C0

| 124 7C 6A

} 125 7D D0

~ 126 7E A1

<DEL> 127 7F 07

128 80 80

ü 129 81 DC

é 130 82 08

â 131 83 42

ä 132 84 15

à 133 85 04

134 86 17

ç 135 87 1A

ê 136 88 52

ë 137 89 53

è 138 8A 0A

ï 139 8B 57

î 140 8C 56

141 8D 8D

142 8E 8E

143 8F 8F

144 90 90

145 91 1B

146 92 20

ô 147 93 CB

ö 148 94 21

149 95 22

û 150 96 DB

ù 151 97 09

152 98 23

153 99 24

154 9A 28

155 9B 4A

156 9C 9C

157 9D 9D

158 9E 9E

159 AF 9F

160 A0 A0

161 A1 29

162 A2 2A

163 A3 2B

164 A4 2C

165 A5 30

166 A6 31


CFT V2.3 C-5



167 A7 33

168 A8 34

169 A9 35

170 AA AA

171 AB 36

172 AC 38

173 AD 39

174 AE AE

175 AF AF

176 B0 B0

177 B1 B1

178 B2 B2

179 B3 FA

180 B4 B4

181 B5 B5

182 B6 B6

183 B7 B7

184 B8 B8

185 B9 B9

186 BA BA

187 BB 3A

188 BC 3B

189 BD 3E

190 BE BE

191 BF BC

192 C0 AB

193 C1 41

194 C2 43

195 C3 44

196 C4 BF

197 C5 45

198 C6 46

199 C7 47

200 C8 48

201 C9 49

202 CA CA

203 CB 4F

204 CC CC

205 CD CD

206 CE CE

207 CF CF

208 D0 51

209 D1 54

210 D2 55

211 D3 58


CFT V2.3C-6



212 D4 59

213 D5 06

214 D6 62

215 D7 63

216 D8 64

217 D9 BB

218 DA AC

219 DB 65

220 DC 66

221 DD DD

222 DE DE

223 DF DF

224 E0 67

225 E1 E1

226 E2 68

227 E3 69

228 E4 70

229 E5 71

230 E6 72

231 E7 73

232 E8 74

233 E9 75

234 EA EA

235 EB EB

236 EC EC

237 ED ED

238 EE EE

239 EF EF

240 F0 76

241 F1 77

242 F2 78

243 F3 14

244 F4 8A

245 F5 8B

246 F6 8C

247 F7 9A

248 F8 9B

249 F9 B3

250 FA DA

251 FB FB

252 FC FC

253 FD FD

254 FE FE

255 FF FF


CFT V2.3 C-7

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

00010203372d2e2f1605250b0c0d0e0f101112133c3d322618193f271c1d1e1f405a7f7b5b6c507d4d5d5c4e6b604b61f0f1f2f3f4f5f6f7f8f97a5e4c7e6e6f7cc1c2c3c4c5c6c7c8c9d1d2d3d4d5d6d7d8d9e2e3e4e5e6e7e8e9ade0bd5f6d79818283848586878889919293949596979899a2a3a4a5a6a7a8a9c06ad0a11480dc08421504171a52530a57568d8e8f901b20cb2122db092324284a9c9d9e9fa0292a2b2c3031333435aa363839aeafb0b1b2fab4b5b6b7b8b9ba3a3b3ebebcab414344bf4546474849ca4fcccdcecf515455585906626364bbac6566dddedf67e16869707172737475eaebecedeeef767778078a8b8c9a9bb3dafbfcfdfeff

00...0F10...1F20...2F30...3F40...4F50...5F60...6F70...7F80...8F90...9FA0...AFB0...BFC0...CFD0...DFE0...EFF0...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

000102038509d5f382978a0b0c0d0e0f101112137f840886181987911c1d1e1f92949598990a171b9aa1a2a3a4050607a5a616a7a8a9ab04acadbbbc1415bd1a20c183c2c3c5c6c7c8c99b2e3c282bcb26d08889d1d28c8bd3d421242a293b5e2d2fd6d7d8dbdce0e2e37c2c255f3e3fe4e5e6e7e8e9f0f1f2603a2340273d2280616263646566676869f4f5f68d8e8f906a6b6c6d6e6f707172f7f89c9d9e9fa07e737475767778797aaac0da5baeafb0b1b2f9b4b5b6b7b8b9bad9bf5dbec47b414243444546474849ca93cccdcecf7d4a4b4c4d4e4f505152fa9681dddedf5ce1535455565758595aeaebecedeeef30313233343536373839b3fbfcfdfeff



CFT V2.3C-8

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, enignorant les autres caractères (07 correspond au caractère <DEL> en EBCDIC, 7f correspond aucaractère <DEL> 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

0707070707070707070725070c0d070707070707070707070707070707070707405a7f7b5b6c507d4d5d5c4e6b604b61f0f1f2f3f4f5f6f7f8f97a5e4c7e6e6f7cc1c2c3c4c5c6c7c8c9d1d2d3d4d5d6d7d8d9e2e3e4e5e6e7e8e9ade0bd5f6d79818283848586878889919293949596979899a2a3a4a5a6a7a8a9c06ad0a1070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707070707


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

7f7f7f7f7f7f7f7f7f7f7f7f0c0d7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f0a7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f207f7f7f7f7f7f7f7f7f7f2e3c282b7f267f7f7f7f7f7f7f7f7f21242a293b5e2d2f7f7f7f7f7f7f7f7f7c2c255f3e3f7f7f7f7f7f7f7f7f7f603a2340273d227f6162636465666768697f7f7f7f7f7f7f6a6b6c6d6e6f7071727f7f7f7f7f7f7f7e737475767778797a7f7f7f5b7f7f7f7f7f7f7f7f7f7f7f7f7f7f7f5d7f7f7b4142434445464748497f7f7f7f7f7f7d4a4b4c4d4e4f5051527f7f7f7f7f7f5c7f535455565758595a7f7f7f7f7f7f303132333435363738397f7f7f7f7f7f


CFT V2.3 D-1

D. Fichier statistique des transferts : structures

D.1. Le fichier statistique des transferts

D.1.1. Structure des données en langage Ctypedef struct{ char mode ; /* S ou R ( Server or Requester ) */ char direct ; /* S ou R ( Send or Receive ) */ char type ; /* F ou M ou R ( File or MSG or Reply) */ /* */ char part[8+1] ; /* Partner */ char spart[8+1] ; /* File sender partner */ char rpart[8+1] ; /* File receiver partner */ char suser[15+1] ; /* File sender user */ char ruser[15+1] ; /* File receiver user */ char idf[8+1] ; /* Logic File Identifier */ char ida[8+1] ; /* Application identifier (local id.) */ char idt[8+1] ; /* Transfer Identifier */ char nbr[10+1] ; /* Transmitted records */ char fbyte[10+1] ; /* Transmitted user data (before compr.) */ char nbyte[10+1] ; /* Transmitted user data (after compr.) */ char dated[8+1] ; /* Date command catalog AAAAMMJJ */ char timed[8+1] ; /* Time command catalog HHMMSSCC */ char dateb[8+1] ; /* Date begin transfer AAAAMMJJ */ char timeb[8+1] ; /* Time begin transfer HHMMSSCC */ char datee[8+1] ; /* Date end transfer AAAAMMJJ */ char timee[8+1] ; /* Time end transfer HHMMSSCC */ char ttime[6+1] ; /* Transfer Time (en sec) */ char diftyp ; /* Transfer type : */ /* N : Single transfer */ /* D : Member of diffusion list */ char prot[8+1] ; /* Protocol Identifier (cf ID for CFTPROT) */ char userid[15+1] ; /* User Identifier */ char groupid[15+1]; /* Group Identifier */ char crate[2+1] ; /* Rate Compression */ /* nn : value */ /* 00 : cf NCOMP */ char flrecl[5+1] ; /* Record Size */ char frecfm ; /* File record format */ /* (cf FRECFM for CFTSEND or CFTRECV */ char ncomp[2+1] ; /* Compression */ char fname[64+1] ; /* File Name */ char parm[80+1] ; /* Private parameter */ char sappl[48+1] ; /* File appl sender */ char rappl[48+1] ; /* File appl receiver */ char group[8+1] ; /* Partner Group */

} mgrcnT;

Fichier statistique des transferts : structures

CFT V2.3D-2

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 *


CFT V2.3 D-3

05 S-TIMEB PIC X(08). 05 FILLER PIC X.* DATE END TRANSFER AAAAMMJJ * 05 S-DATEE PIC X(08). 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.* 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 STAT-CONTROL-BLOCK.

Fichier statistique des transferts : structures

CFT V2.3D-4

* 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 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 * 05 S_TIMEB PIC X(08). 05 FILLER PIC X.* DATE END TRANSFER AAAAMMJJ * 05 S_DATEE PIC X(08).


CFT V2.3 D-5

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 E-1

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é pourredimensionner 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 F-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 (unparamè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 lemoniteur 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ètrePROTOCOL 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 laquelles’exécute le moniteur à joindre (localhost pour une communication interne à la machineuniquement),

• le champ port désigne le port d’écoute du moniteur à joindre.

Structure du fichier de configuration

CFT V2.3F-2

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 locallibre 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ésSOCKS4 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 COMMUNICATIONTYPE=FILENAME=$CFTCOM

; CFT APIs CONFIGURATION FILE; TCP/IP COMMUNICATIONTYPE=TCPNAME=xhttp://localhost:5001LOWPORT=5000HIGHPORT=5050PROXY=socks4://proxy:8080

CFT V2.3 G-1

G. Fichier de configuration de l'API de suiviSentinel

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 etSEND/RECV.

Le fichier de configuration est analysé au démarrage du moniteur et les paramètres qui ne lui sontpas 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 dumoniteur.

Le fichier de configuration est un fichier de type texte. Il contient des lignes de paramètres (unparamè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.

Fichier de configuration de l'API de suivi Sentinel

CFT V2.3G-2

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 serveurSentinel.

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 duparamètre ou de sa valeur, la classe XFB.Log n’est pas suivie


CFT V2.3 G-3

XFB.Transfer = { ALL| NO | SUMMARY}

Activation du suivi de la classe XFB.Transfer.

Ce paramètre indique :

• NO pas de suivi,

• ALL si le suivi doit être complet avec notification à chaque changement d'étatdu transfert,

• 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 duparamè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 TRKUTILPRODUCTNAME=API-SCRIPT# Chemin complet des fichiers modèles de message au format# XMLTRKMODELDIR=c:\cft231\xml# Nom du fichier modèle des messages au format XMLTRKMODELEVENT=trkevent.xml# Nom du fichier modèle des « Cycle Link » au format XMLTRKMODELLINK=trklinkcycle.xml# Adresse IP du Serveur SentinelTRKIPADDR=127.0.0.0# Numéro de port du Serveur SentinelTRKIPPORT=13039# Chemin et nom du fichier tamponTRKTNAME=trktam.txt# Adresse locale du moniteur XFBTRKLOCALADDR=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 Index-1

Index

&&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

&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

AABOUT commande,8-2ACB paramètre

commande CFTNET TYPE = SNA,5-10ACB paramètre,5-10ACCNT paramètre,3-3

commande CFTPARM,3-3Acquittement de transfert,7-9ACT

ID,7-37, 7-38MODE,7-37, 7-38TYPE,7-37, 7-38

Action sur les transferts,7-22Activation

d’un transfert,1-6AFNAME paramètre,3-23, 3-31

commande CFTACCNT,3-31commande CFTLOG,3-23

APPCYCID paramètre,7-3, 7-14commande RECV,7-14commande SEND

TYPE = FILE,7-3APPCYCID paramètre

commande SEND,7-3APPOBJID paramètre,7-3, 7-14

commande RECV,7-14commande SEND,7-3

TYPE = FILE,7-3Arrêt,1-7

d’un transfert,1-7commande HALT,1-7 Voir aussi Action sur les

transfertsde CFT

commande SHUT,8-1ASCII Voir CodesASY valeur,2-27ASY valeur,5-1AX25MBX paramètre,5-19, 5-22

commande CFTNET TYPE = X25,5-19, 5-22

BBasculement

des fichiers de suivicommande SWITCH,8-1

Boîte aux lettres Voir Communication, par boîte auxlettres (mailbox)

BUFSIZE paramètre,3-3commande CFTPARM,3-3

GCOS8,3-3valeurs par défaut,3-3

Index

CFT V2.3Index-2

CCACHE paramètre,3-20

commande CFTCAT,3-20CALL paramètre

commande CFTNET,5-2CALL paramètre,5-2Caractéristiques,4-35

de la machinecommande ABOUT,8-2

des fichiers,4-35généraux,4-35

valeurs par défaut,4-35commande CFTRECV,4-35

CAT paramètre,3-3commande CFTPARM,3-3

Catalogue,2-12CFT,1-5gestion du,3-19postes du,2-12

listes,2-12suppression,1-5, 1-7

commande DELETE,1-7CFTACCNT commande,3-28, 8-2CFTASY commande,1-3, 6-32CFTAUTH commande,4-60CFTCAT commande,3-19CFTCATAL,E-1, F-1CFTCOM commande,3-16CFTDEST commande,6-10CFTDNA commande,1-3, 6-16

VMS,6-16CFTDSA commande,1-3, 6-17

GCOS6,6-17GCOS7,6-17GCOS8,6-17

CFTEXIT commande,4-57CFTEXT commande,2-9CFTFILE commande,2-28

paramètres,2-30syntaxe,2-29

CFTIDF commande,4-62CFTLOG commande,3-22, 8-2CFTLU62 commande,1-3, 6-30CFTNET commande

générique,5-2TYPE = ASY,5-3TYPE = DNA,5-5TYPE = DSA,5-5TYPE = LU62,5-7TYPE = SNA,5-8TYPE = TCP,5-14TYPE = X25,5-18

CFTNET commande,5-1, 5-2CFTPARM commande,3-1CFTPART commande,6-1

STATE,6-8CFTPROT command,5-23

CFTPROT commande,5-22, 5-23générique,5-23TYPE = ETEBAC,5-30TYPE = ODETTE,5-31TYPE = PeSIT,5-34

CFTRECV commande,4-31NOTIFY,4-46paramètres,4-35syntaxe,4-33

CFTSEND commande,4-1, 4-2CFTSNA commande,1-3, 6-19

MVS,6-19OS2,6-19OS400,6-19VM,6-19VMS,6-19

CFTTCP commande,1-3, 6-25GUARDIAN,6-25MVS,6-25UNIX,6-25VMS,6-25

CFTUTIL Voir Commandes, de l’utilitaire CFTUTILCFTX25 commande,1-3, 6-26CFTXLATE commande,4-64CFTXXX commande,6-13CIPHER paramètre,2-30

commande CFTFILE,2-30valeurs par défaut,2-30

CLASS paramètre,5-13, 5-20, 6-18, 6-20, 6-22, 6-27,6-30, 6-32commande CFTASY,6-32commande CFTDSA,6-18commande CFTLU62,6-30commande CFTNET

TYPE = ASY,5-3, 5-4TYPE = DSA,5-6TYPE = LU62,5-7TYPE = SNA,5-13TYPE = SNA,5-10, 5-11TYPE = X25,5-20

commande CFTSNA,6-20, 6-22commande CFTX25,6-27

CLASS paramètre,5-3, 5-4, 5-6, 5-7, 5-10, 5-11Clé,3-8

de type CPU,3-8de type DATE,3-8de type IDF,3-8de type LIBELLE,3-8

CLEARCMD commande,2-6CNXIN paramètre,6-14, 6-30

commande CFTLU62,6-30commande CFTXXX,6-14

CNXINOUT paramètre,6-14, 6-30commande CFTLU62,6-30commande CFTXXX,6-14

CNXOUT paramètre,6-15, 6-30commande CFTLU62,6-30commande CFTXXX,6-15


CFT V2.3 Index-3

Codes,4-64ASCII,4-64EBCDIC,4-64

COM paramètre,3-3commande CFTPARM,3-3

COMMAND paramètre,2-6COMMAND paramètre

commande CLEARCMD,2-6Commandes,1-1

ABOUT,8-2ACT,7-37


associées aux transferts,7-1contrôle syntaxique,7-1fichier,7-1

émission,7-1commande SEND TYPE = FILE,7-1

réception,7-12message,7-7, 7-9

émission,7-7, 7-9commande SEND TYPE = MESSAGE,7-7commande SEND TYPE = REPLY,7-9de réponse,7-9

commande SEND TYPE = REPLY,7-9syntaxe,1-6

CFTACCNT,3-28, 8-2EXEC paramètre,8-2paramètres,3-31syntaxe,3-31

CFTASY,1-3, 6-32CFTAUTH,4-60


CFTCAT,3-19paramètres,3-20syntaxe,3-19

CFTCOM,3-16MVS,3-16paramètres,3-17syntaxe,3-16Win3.1,3-16WinNT,3-16

CFTDEST,6-10paramètres,6-11syntaxe,6-11

CFTDNA,1-3, 6-16paramètres,6-16syntaxe,6-16VMS,6-16

CFTDSA,1-3, 6-17GCOS6,6-17GCOS7,6-17GCOS8,6-17paramètres,6-18syntaxe,6-17

Commandes (suite)CFTETB,5-43


CFTEXIT,4-57CFTEXT,2-9


CFTFILE,2-28GCOS8,2-31OS400,2-29

CFTIDF,4-62paramètres,4-63syntaxe,4-63

CFTLOG,3-22, 8-2EXEC paramètre,8-2paramètres,3-23syntaxe,3-23

CFTLU62,1-3, 6-30CFTNET

ASY valeur,5-1LU62 valeur,5-1paramètres,5-2syntaxe,5-2TYPE = ASY,5-3TYPE = DNA

syntaxe,5-5TYPE = DNA,5-5TYPE = DSA

GCOS6,5-5GCOS7,5-5GCOS8,5-5paramètres,5-6syntaxe,5-6

TYPE = DSA,5-5TYPE = LU62,5-7TYPE = SNA

MVS,5-8OS2,5-8OS400,5-8paramètres

côté HOSTMVS,5-10VM,5-10

côté HOST,5-10côté PU type2

OS400,5-11VMS,5-12

paramètres,5-10syntaxe,5-9VMS,5-8

TYPE = SNA,5-8TYPE = TCP,5-14

GUARDIAN,5-14MVS,5-14paramètre,5-15syntaxe,5-15UNIX,5-14VMS,5-14

Index

CFT V2.3Index-4

Commandes, CFTNET (suite)TYPE = X25,5-18

GCOS7,5-19GCOS8,5-19paramètres,5-18syntaxe,5-18

CFTNET,5-1, 5-2CFTPARM,3-1


CFTPART,6-1paramètres,6-2syntaxe,6-1

CFTPROT,5-22, 5-23paramètres,5-24TYPE = ETEBAC,5-30


TYPE = ODETTE,5-31paramètres,5-32

TYPE = PeSIT,5-34paramètres,5-36syntaxe,5-35

CFTRECV,4-31base VFM,4-55


CFTSEND,4-1, 4-2base VFM,4-29



CFTSNA,1-3, 6-19MVS,6-19OS2,6-19OS400,6-19paramètres,6-20

côté HOST,6-20côté PU T2,6-22

syntaxe,6-19VM,6-19VMS,6-19

CFTTCP,1-3, 6-25GUARDIAN,6-25MVS,6-25paramètres,6-25syntaxe,6-25UNIX,6-25VMS,6-25

CFTX25,1-3, 6-26paramètres,6-27syntaxe,6-27

CFTXLATE,4-64paramètres,4-66syntaxe,4-65

CFTXXX,6-13paramètres,6-14syntaxe,6-14

Commandes (suite)CLEARCMD,2-6

exemple,2-7paramètres,2-6syntaxe,2-6, 2-8

CONFIG,2-1paramètres,2-4syntaxe,2-4

contrôle syntaxique,1-5 Voir aussi Commandes,associées aux transferts

COPYFILE,2-33statistiques d’exécution,2-39

d’administration du moniteur CFT,8-1commande ABOUT,8-2commande SHUT,8-1commande SWITCH,8-1

d’exploitation du moniteur CFT Voir Commandes,d’administration du moniteur CFT

de l’utilitaire CFTUTIL,1-1CFTEXT,1-1CFTFILE,1-1CONFIG,1-1COPYFILE,1-1LISTCAT,1-1LISTPARM,1-1LISTPART,1-1WAIT,1-1

de paramétrage,3-1, 4-1, 6-1liste,3-1, 4-1, 6-1liste,5-1syntaxe,1-4

de paramétrage,5-1DELETE,1-7, 7-22


END,1-7, 7-33paramètres,7-33syntaxe,7-33

HALT,1-7, 7-24paramètres,7-24syntaxe,7-24

INACT,7-36paramètres,7-36syntaxe,7-36

KEEP,1-7, 7-25, 7-26paramètres,7-26syntaxe,7-26

KSTATE,2-8paramètres,2-9

LISTCAT,1-7, 2-12, 2-13 Voir aussi Action sur lestransfertsparamètres,2-13syntaxe,2-13

LISTCOM,2-41LISTPARM,2-25



CFT V2.3 Index-5

Commandes (suite)LISTPART,2-26, 2-27

ASY valeur,2-27LU62 valeur,2-27, 2-28

MQUERY,7-35paramètres,7-35syntaxe,7-35

PURGE,2-6RECV,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-16PeSIT profil SIT,7-12syntaxe,7-13

SEND,7-1réponse,7-9TYPE = FILE,7-1

syntaxe,7-1TYPE = MESSAGE,7-7

paramètres,7-8PeSIT profil CFT,7-7syntaxe,7-8

TYPE = REPLY,7-9paramètres,7-10syntaxe,7-10

SHUT,1-8, 8-1paramètres,8-1syntaxe,8-1

START,1-7, 7-27, 7-28, 7-29paramètres,7-27, 7-29syntaxe,7-27, 7-29

SUBMIT,1-7SWITCH,1-8, 8-1


WAIT,2-5paramètres,2-5syntaxe,2-5

WLOG,2-9paramètres,2-9syntaxe,2-9

COMMENT paramètre,3-4, 6-2commande CFTPARM,3-4commande CFTPART,6-2

Communicationmédia de,1-8 Voir aussi Commandes,

d’administration du moniteur CFTmodes de,3-16

applications/moniteur,3-16par boîte aux lettres (mailbox),2-4

Compression,A-1ETEBAC3,A-3ODETTE,A-3PeSIT,A-1

CONCAT paramètre, 5-36commande CFTPROT TYPE = PeSIT,5-36

PeSIT profil SIT,5-36

CONFIGcommande,2-1paramètre

commande CFTNET TYPE = ASY,5-3paramètre,5-3

CONFIG paramètre,6-32commande CFTASY,6-32commande CFTNET TYPE = ASY,5-4

CONFIG paramètre,5-4Consultation Voir Utilitaire CFTUTILCONTENT

paramètre,2-13, 2-41commande LISTCAT,2-13commande LISTCOM,2-41

CONTENT paramètre,3-24commande CFTLOG,3-24

Contrôle,1-6des transferts,1-6 Voir aussi Action sur les transfertssyntaxique des commandes,1-8 Voir aussi

Commandes, d’administration du moniteur CFTConventions typographiques,xvii

description des commandes,xviidescription des paramètres,xvii

spécificités,xx, xxi, xxiivaleurs,xix, xx

Copie de fichier Voir Fichiers, copie deCOPYFILE commande,2-33


CPNAME paramètre,6-31commande CFTLU62,6-31

CREATE paramètre,2-34commande COPYFILE,2-34

CTLPASSW paramètre,3-4commande CFTPARM,3-4

CTO paramètrecommande CFTPROT TYPE = PeSIT,5-36

CTO paramètre,5-36CYCDATE paramètre,4-5, 4-36

commande CFTRECV,4-36commande CFTSEND,4-5

CYCLE paramètre,4-5, 7-14commande CFTPROT TYPE = PeSIT,5-37commande CFTSEND,4-5commande RECV,7-14

CYCLE paramètre,5-37CYCTIME paramètre,4-6, 4-36


DDATA paramètre,6-27, 6-32

commande CFTASY,6-32commande CFTX25,6-27

DEFAULT paramètre,3-4commande CFTPARM,3-4

Index

CFT V2.3Index-6

Définition,6-1d’un partenaire Voir Partenaires, commande

CFTPARTd’une liste de partenaires Voir Partenaires, commande

CFTDESTDELETE

commande,1-7, 7-22paramètre,4-2, 4-6, 4-33, 4-36

commande CFTRECV,4-33, 4-36commande CFTSEND,4-2, 4-6

DIALNO paramètre,6-28, 6-32commande CFTASY,6-32commande CFTX25,6-28

DIRECT paramètre,2-13, 4-66, 5-45, 7-22, 7-24, 7-26,7-27, 7-29, 7-33commande CFTETB,5-45commande CFTXLATE,4-66commande DELETE,7-22commande END,7-33commande HALT,7-24commande KEEP,7-26commande LISTCAT,2-13commande START,7-27, 7-29

DIRNB paramètre,4-33, 4-36commande CFTRECV,4-33, 4-36

DISCTC paramètrecommande CFTPROT TYPE = PeSIT,5-37

DISCTC paramètre,5-37DISCTD paramètre,5-24, 5-26, 5-29

commande CFTPROT,5-24, 5-26, 5-29DISCTR paramètre,5-37

commande CFTPROT TYPE = PeSIT,5-37DISCTS paramètre

commande CFTPROTETEBAC3,5-24ODETTE,5-24PeSIT profil CFT,5-24PeSIT profil EXTERN,5-24PeSIT profil SIT,5-24

Données,4-31réception des Voir Environnement des transferts,

commande CFTRECVstatistiques Voir Enregistrement des données

statistiquesliste des Voir Commandes, CFTACCNT

stockage des Voir Environnement des transferts,commande CFTRECV

DURING paramètre,2-5commande CONFIG,2-5

DYNAM parameter,5-24CFTPROT command,5-24

DYNAM paramètre,5-25commande CFTPROT,5-25

EEBCDIC Voir CodesEERP,3-4, 6-2EERP paramètre,5-32

commande CFTPROT,5-32TYPE = ODETTE,5-32

Emission,4-1de fichier,1-5 Voir aussi Commandes, associées aux

transfertsde fichier type,4-1

description Voir Environnement des transfertsde message,1-5 Voir aussi Commandes, associées aux

transfertsEND commande,1-7, 7-33Enregistrement des données statistiques,3-28Environnement des transferts

commande CFTRECV,4-31Etats des transferts,1-7ETEBAC Voir Protocoles, de transfertETEBAC3

format de la carte,5-43 Voir aussi Protocoles, detransfert

EXEC paramètre,3-24, 3-31, 4-6, 4-36, 6-11commande CFTACCNT,3-31commande CFTDEST,6-11commande CFTLOG,3-24commande CFTRECV,4-36commande CFTSEND,4-6

EXECR paramètrecommande CFTPARM,3-5

EXECRE paramètre,3-5EXECRF paramètre,3-5

commande CFTPARM,3-5EXECRM paramètre,3-5

commande CFTPARM,3-5EXECSE paramètre,3-6

commande CFTPARM,3-6EXECSF paramètre,3-6

commande CFTPARM,3-6EXECSFA paramètre,3-6

commande CFTPARM,3-6EXECSM paramètre,3-7

commande CFTPARM,3-7EXECSMA paramètre,3-7

commande CFTPARM,3-7EXIT parameter,5-24

CFTPROT command,5-24EXITA paramètre,5-25

commande CFTPROT,5-25EXITE paramètre,5-25

commande CFTPROT,5-25EXITEOT paramètre,3-7

commande CFTPARM,3-7Extraction,2-9 Voir aussi Utilitaire CFTUTIL

des données,2-9des fichiers Paramètres et Partenaires,2-9


CFT V2.3 Index-7

FFACIL paramètre,6-32

commande CFTASY,6-32FACILITY paramètre,6-28

commande CFTX25,6-28FACTION paramètre,4-7, 4-30, 4-37, 4-56

commande CFTRECV,4-37MVS,4-38VFM,4-56VM,4-38

commande CFTSEND,4-7VFM,4-30

FAST paramètre,8-1commande SHUT,8-1

FBLKSIZE paramètre,1-4, 2-30, 2-38, 4-7, 4-38commande CFTFILE,1-4, 2-30, 2-38, 4-7, 4-38

valeurs par défaut,1-4, 2-30, 2-38, 4-7, 4-38FCODE paramètre,4-7, 4-66

commande CFTSEND,4-7commande CFTXLATE,4-66

valeurs par défaut,4-66FCOMP paramètre,4-56

commande CFTRECVVFM,4-56

FDATE paramètre,7-3, 7-4commande SEND,7-3, 7-4

TYPE = FILE,7-3, 7-4FDB paramètre,4-30, 4-56

commande CFTRECVVFM,4-56

commande CFTSEND,4-30VFM,4-30

FDISP paramètre,4-3, 4-39commande CFTRECV,4-39commande CFTSEND,4-3

Fichier statistique Voir Transferts, fichier statistiqueVoir Transferts, fichier statistique

Fichiers,2-9copie de,2-33

off line,2-33commande COPYFILE,2-33

création,2-28commande CFTFILE,2-28

de suivibasculement manuel

commande SWITCH,8-1émission de,1-5journaux,3-22, 8-1 Voir aussi Commandes,

d’administration du moniteur CFTmanipulation Voir Utilitaire CFTUTILparamètres,2-9

utilitaire CFTUTIL,2-9partenaires,2-9

utilitaire CFTUTIL,2-9récepteurs,4-31

Fichiers (suite)réception de,1-5, 7-12 Voir aussi Commandes,

associées aux transfertscommande RECV Voir Commandes, associées aux

transfertsstatistiques,8-1 Voir aussi Transferts, fichier

statistique Voir aussi Commandes,d’administration du moniteur CFT

suppression,2-28commande CFTFILE,2-28

types,4-1émission Voir Environnement des transferts

description Voir Environnement des transfertsliste d’ identifiants,4-60

FILE paramètre,2-13, 2-41commande LISTCAT,2-13commande LISTCOM,2-41

FIRST paramètre,2-41, 2-42commande LISTCOM,2-41, 2-42

FLRECL paramètre,4-8, 4-40commande CFTRECV,4-40

UNIX,4-40commande 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-11commande CFTACCNT,3-32commande CFTCAT,3-20commande CFTDEST,6-11commande CFTFILE,2-30commande CFTLOG,3-24commande CFTRECV,4-41

VFM,4-56commande CFTSEND,4-9

VFM,4-30commande CFTXLATE,4-67commande CONFIG,2-4

FNAMEABS paramètre,7-1, 7-4commande SEND,7-1, 7-4

TYPE = FILE,7-1, 7-4FOR paramètre,6-12

commande CFTDEST,6-12FORCE paramètre,4-12, 4-42


FORG paramètre,4-13commande CFTSEND,4-13

FOUT paramètre,2-10commande CFTEXT,2-10

FPARM paramètre,2-10commande CFTEXT,2-10

FPART paramètre,2-11commande CFTEXT,2-11

FRECFM paramètre,4-43commande CFTRECV,4-43

OS400,4-43UNIX,4-43VOS,4-43VRX,4-43

Index

CFT V2.3Index-8

FREE1 paramètre,5-45commande CFTETB,5-45

FREE2 paramètre,5-45commande CFTETB,5-45

FSPACE paramètre,2-30, 4-13, 4-43commande CFTFILE,2-30

valeurs par défaut,2-30commande CFTRECV,4-43commande CFTSEND,4-13

FSPACEX paramètre,2-31commande CFTFILE,2-31

valeurs par défaut,2-31

GGATEWAY paramètre,5-13

commande CFTNET TYPE = SNA,5-13Gestion,3-22

des fichiers journaux,3-22commande CFTLOG Voir aussi Paramètres, de

gestion, des fichiers journauxdu catalogue Voir Paramètres, de gestion, du

catalogueGFA paramètre,6-28

commande CFTX25,6-28GROUP paramètre,6-3

commande CFTPART,6-3GROUPID paramètre,4-3, 4-13, 4-33, 4-44

commande CFTRECV,4-33, 4-44commande CFTSEND,4-3, 4-13

HHALT commande,1-7, 7-24HIGPORT paramètre,5-15

commande CFTNET TYPE = TCP,5-15HOST paramètre,5-15, 6-25

commande CFTNET TYPE = TCP,5-15commande CFTTCP,6-25

IIBLKSIZE paramètre,2-34

commande COPYFILE,2-34ICOMP paramètre,2-35

commande COPYFILE,2-35ICT paramètre,2-35

commande COPYFILE,2-35ID 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-32commande CFTACCNT,3-31commande CFTASY,6-32commande CFTAUTH,4-61, 4-63commande CFTCAT,3-20commande CFTCOM,3-17commande CFTDEST,6-13commande CFTETB,5-45commande CFTEXT,2-10

ID paramètre (suite)commande CFTLOG,3-25commande CFTLU62,6-30commande CFTNET,5-2commande CFTPARM,3-7commande CFTPART,6-3commande CFTPROT,5-25commande CFTRECV,4-44

PeSIT profil CFT,4-46PeSIT profil EXTERN,4-46

commande CFTSEND,4-14commande CFTXLATE,4-67commande CFTXXX,6-15commande LISTPARM,2-25commande 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-34commande DELETE,7-23commande END,7-34commande HALT,7-24commande KEEP,7-26commande LISTCAT,2-14commande RECV,7-16commande SEND,7-4, 7-8, 7-10

TYPE = FILE,7-4TYPE = MESSAGE,7-8TYPE = REPLY,7-10

commande START,7-27, 7-29Identifiants,4-32, 7-4

de fichier type,4-60commande CFTAUTH Voir Environnement des

transfertsde transfert,4-32

commande CFTRECV,4-32liste,4-60

commande CFTAUTH,4-60réseau,4-62

de fichier type,4-62IDF 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, typescommande CFTAUTH,4-61commande CFTETB,5-46commande CFTPART,6-3commande DELETE,7-23commande END,7-34commande HALT,7-24commande KEEP,7-26commande KSTATE,2-8, 2-9commande LISTCAT,2-14commande RECV,7-16commande SEND,7-4

TYPE = FILE,7-4commande START,7-28, 7-29

IDM paramètre,7-8, 7-10commande SEND,7-8, 7-10

TYPE = MESSAGE,7-8TYPE = REPLY,7-10


CFT V2.3 Index-9

IDT paramètre,2-14, 7-10, 7-23, 7-25, 7-26, 7-28, 7-29,7-34commande DELETE,7-23commande END,7-34commande HALT,7-25commande KEEP,7-26commande LISTCAT,2-14commande SEND,7-10

TYPE = REPLY,7-10commande 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-30commande DELETE,7-22, 7-23commande HALT,7-24, 7-25commande KEEP,7-26commande KSTATE,2-8, 2-9commande LISTCAT,2-13, 2-14commande LISTCAT CONTENT = FULL,2-22commande START,7-27, 7-28, 7-29, 7-30

IFNAME paramètre,2-35commande COPYFILE,2-35

ILRECL paramètre,2-35commande COPYFILE,2-35

OS2,2-35UNIX,2-35VOS,2-35

IMAXTIME paramètre,6-3, 6-15, 6-30commande CFTLU62,6-30commande CFTPART,6-3commande CFTXXX,6-15

IMINTIME paramètre,6-3, 6-15, 6-30commande CFTLU62,6-30commande CFTPART,6-3commande CFTXXX,6-15

IMPL paramètre,4-14, 7-4commande CFTSEND,4-14influence du paramètre pour commande SEND Voir

Commandes, SENDINACT

FORCE,7-36, 7-37ID,7-36MODE,7-36, 7-37TYPE,7-36

Incidents Voir Journal de CFTINDEX paramètre,2-6INDEX paramètre

commande CLEARCMD,2-6Informations,2-12

associées aux transferts,2-12, 2-16, 2-18pour LISTCAT CONTENT = BRIEF,2-16, 2-18pour LISTCAT CONTENT = FULL,2-20

visualisées Voir Informations, associées aux transfertsInterruption de transfert

commande SHUT,8-1IPART paramètre,6-3

commande CFTPART,6-3

JJournal de CFT,3-22 Voir aussi Commandes, CFTLOG

KKEEP commande,1-7, 7-25, 7-26KEY paramètre,3-8

commande CFTPARM,3-8KSTATE commande,2-8

LLANGUAGE paramètre,3-31

commande CFTACCNT,3-31LAST paramètre,2-42

commande LISTCOM,2-42LENGTH paramètre,3-25

commande CFTLOG,3-25LINEID paramètre,6-32

commande CFTASY,6-32commande CFTNET TYPE = ASY,5-3, 5-4

LINEID paramètre,5-3, 5-4LISTCAT commande,1-7, 2-12, 2-13, 2-18 Voir aussi

Action sur les transfertsCONTENT = BRIEF,2-18CONTENT = FULL,2-20

LISTCOM commande,2-41paramètres,2-41syntaxe,2-41

Liste,4-60d’identifiants,4-60

de fichiers types (IDF),4-60commande CFTAUTH,4-60

LISTPARM commande,2-25LISTPART commande,2-26, 2-27


LOCK paramètre,2-31commande CFTFILE,2-31

LOG paramètre,3-8commande CFTPARM,3-8

LOGMODE paramètre,6-21, 6-23commande CFTSNA,6-21, 6-23

LOWPORT paramètre,5-15commande CFTNET TYPE = TCP,5-15

LU62 valeur,2-27, 2-28, 5-1LUNAME paramètre,5-7, 5-12, 5-13, 6-21, 6-23, 6-30

commande CFTLU62,6-30commande CFTNET

TYPE = LU62,5-7TYPE = SNA,5-12, 5-13

commande CFTSNA,6-21, 6-23

Index

CFT V2.3Index-10

MMAC paramètre,2-32

commande CFTFILE,2-32MACTION paramètre,4-33, 4-44

commande CFTRECV,4-33, 4-44Mailbox Voir Boîte aux lettresManipulation,2-28

de fichiers Voir Utilitaire CFTUTILMAXCNX paramètre

commande CFTNET,5-2MAXCNX paramètre,5-2MAXDATE paramètre,4-14, 4-44


MAXREC paramètre,3-25, 3-32commande CFTACCNT,3-32commande CFTLOG,3-25

MAXTASK paramètre,3-9commande CFTPARM,3-9

MAXTIME paramètre,4-14, 4-45commande CFTRECV,4-45commande CFTSEND,4-14

MAXTRANS paramètre,3-9commande CFTPARM,3-9

MEDIACOM paramètre,2-4commande CONFIG,2-4

Médias,2-1, 2-2de communication,2-2

commande CFTCOM,3-16de données,2-1

de CFTUTIL,2-1redéfinition,2-1

Messageémission de,1-5 Voir aussi Commandes, associées

aux transfertsmécanisme d’émission d’un,7-11

MINDATE paramètre,4-15, 4-45commande CFTRECV,4-45commande CFTSEND,4-15

MINTIME paramètre,4-15, 4-45commande CFTRECV,4-45commande CFTSEND,4-15

MODE paramètre,2-32, 6-30, 6-32commande CFTASY,6-32commande CFTFILE,2-32commande CFTLU62,6-30

MODENAME paramètre,6-31commande CFTLU62,6-31

Modes,3-16d’enregistrement des données statistiques Voir

Commandes, CFTACCNTde communication,3-16

applications/moniteur,3-16commande CFTCOM,3-16

Modification des paramètres Voir Paramètres,modification des

MODIN paramètre,5-3, 5-4commande CFTNET TYPE = ASY,5-3, 5-4

MODOUT paramètre,5-3, 5-4,6-32commande CFTASY,6-32commande CFTNET TYPE = ASY,5-3, 5-4

Moniteur CFT,8-1commandes d’administration,8-1

MQUERY commande,7-35MSG paramètre,2-9, 7-7, 7-11

commande SEND,7-8, 7-11TYPE = MESSAGE,7-8, 7-11

commande WLOG,2-9MULTART paramètre,5-37

commande CFTPROT TYPE = PeSIT,5-37PeSIT profil SIT,5-37

NNAME paramètre,3-17

commande CFTCOM,3-17NBLKSIZE paramètre,4-16

commande CFTSEND,4-16PeSIT profil CFT,4-16

NBR paramètre,5-46commande CFTETB,5-46

NCODE paramètre,4-16, 4-67commande CFTSEND,4-16commande CFTXLATE,4-67

NCOMP paramètre,4-46commande CFTRECV,4-46commande CFTSEND

PeSIT profil CFT,4-17PeSIT profil EXTERN,4-17

NET paramètre,3-10, 5-26commande CFTPARM,3-10commande CFTPROT,5-26

NETPFX paramètre,5-12, 5-21commande CFTNET

TYPE = LU62,5-7TYPE = SNA,5-12TYPE = SNA,5-11TYPE = X25,5-21

NETPFX paramètre,5-7, 5-11NFNAME paramètre,4-17, 7-16

commande CFTSEND,4-17PeSIT 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-18commande RECV,7-18

NIDF paramètre,4-63, 5-46commande CFTAUTH,4-63commande CFTETB,5-46


CFT V2.3 Index-11

NIDF paramètre, commande CFTIDF (suite)commande CFTIDF

ETEBAC3,4-63ODETTE,4-63PeSIT,4-63PeSIT E,4-63PeSIT E CFT/CFT,4-63

NLRECL paramètre,4-18, 5-46commande CFTETB,5-46commande CFTSEND,4-18

ODETTE,4-18NODE paramètre,6-16, 6-18

commande CFTDNA,6-16commande CFTDSA,6-18

NOTIFY paramètre,3-25, 4-3, 4-33, 4-46commande CFTLOG,3-25commande CFTRECV,4-33, 4-46commande CFTSEND,4-3

NPART paramètre,2-14, 3-10, 5-46commande CFTETB,5-46commande CFTPARM,3-10commande LISTCAT,2-14

NRECFM paramètrecommande CFTSEND

ETEBAC3,4-21ODETTE,4-20

NRPART paramètre,6-3, 6-4commande CFTPART,6-3, 6-4

ETEBAC3,6-3, 6-4ODETTE,6-3, 6-4PeSIT,6-3, 6-4

NRPASSW paramètre,6-4commande CFTPART,6-4

ETEBAC3,6-4ODETTE,6-4PeSIT,6-4

NSPACE paramètrecommande CFTSEND

ODETTE,4-21PeSIT,4-21

NSPASSW paramètre,5-46, 6-4commande CFTETB,5-46commande CFTPART,6-4

ETEBAC3,6-4ODETTE,6-4PeSIT,6-4

NTYPE paramètrecommande CFTSEND

ODETTE,4-21

OOCOMP paramètre,2-37

commande COPYFILE,2-37OCT paramètre,2-37

commande COPYFILE,2-37ODETTE Voir Protocoles, de transfert

OFNAME paramètre,2-37commande COPYFILE,2-37

OLRECL paramètre,2-37commande COPYFILE,2-37

OS2,2-37UNIX,2-37VOS,2-37

OMAXTIME paramètre,6-5, 6-15, 6-30commande CFTLU62,6-30commande CFTPART,6-5commande CFTXXX,6-15

OMINTIME paramètre,6-5, 6-15, 6-30commande CFTPART,6-5commande CFTXXX,6-15

OPERMSG paramètre,3-27, 4-3, 4-21, 4-33, 4-48commande CFTLOG,3-27commande CFTRECV,4-33, 4-48commande CFTSEND,4-3, 4-21

ORECFM paramètre,2-38commande COPYFILE,2-38

UNIX,2-38OSPACE paramètre,2-38

commande COPYFILE,2-38UNIX,2-38

PPACKETSZ paramètre,5-21

commande CFTNET TYPE = X25,5-21PAD paramètre,5-33


PADNO paramètre,6-32commande CFTASY,6-32

PADSET paramètre,6-32commande CFTASY,6-32commande CFTNET TYPE = ASY,5-3, 5-4

PADSET paramètre,5-3, 5-4Parameters

DYNAM,5-24EXIT,5-24

Paramètres,2-4ACB

MVS,5-10VM,5-10

ACB,5-10ACCNT,3-3AFNAME,3-23, 3-31

OS400,3-23, 3-24APPCYCID,7-3, 7-14APPOBJID,7-3, 7-14associés à un fichier type Voir Environnement des

transfertscommande CFTRECV,4-31émission à partir d’une base VFM,4-29

commande CFTSEND Voir Environnement destransferts

Index

CFT V2.3Index-12

Paramètres, associés à un fichier type (suite)réception dans une base VFM,4-55

commande CFTRECV Voir Environnement destransferts

associés au fichier émis,4-4commande CFTSEND Voir Environnement des

transfertsAX25MBX,5-19, 5-22

GCOS7,5-19, 5-22GCOS8,5-19, 5-22

BUFSIZE,3-3CACHE,3-20CALL,5-2CAT,3-3CIPHER,2-30CLASS,5-13, 5-20, 6-18, 6-20, 6-22, 6-27, 6-30, 6-32

MVS,6-20MVS,5-10OS400,5-11OS400 en LU0,6-22VM,6-20VM,5-10VMS,5-13, 6-22

CLASS,5-3, 5-4, 5-6, 5-7, 5-10, 5-11CNXIN,6-14, 6-30CNXINOUT,6-14, 6-30CNXOUT,6-15, 6-30COM,3-3COMMAND,2-6COMMENT,3-4, 6-2communs facultatifs

commande SEND TYPE = MESSAGE,7-9CONCAT,5-36CONFIG,6-32CONFIG,5-3, 5-4CONTENT,2-13, 2-41, 3-24CPNAME,6-31CREATE,2-34CTLPASSW,3-4CTO,5-36CYCDATE,4-5, 4-36CYCLE,4-5, 5-37, 7-14CYCTIME,4-6, 4-36d’identification,4-4



DATA,6-27, 6-32de contrôle d’exécution,4-4



de gestion,3-19des fichiers journaux,3-22du catalogue,3-19

commande CFTCAT,3-19

Paramètres (suite)de traitement des données,4-4



DEFAULT,3-4DELETE,4-2, 4-6, 4-33, 4-36DIALNO,6-28, 6-32DIRECT,2-13, 4-66, 5-45, 7-22, 7-24, 7-26, 7-27, 7-

29, 7-33DIRNB,4-33, 4-36DISCTC,5-37DISCTD,5-24, 5-26, 5-29

protocoles,5-24ETEBAC3,5-24ODETTE,5-24PeSIT profil CFT,5-24PeSIT profil EXTERN,5-24PeSIT profil SIT,5-24

valeurs par défaut,5-24DISCTR,5-37DISCTS

valeurs par défaut,5-24du fichier pour le partenaire,4-5


DURING,2-5DYNAM,5-25EERP,5-32EXEC,3-24, 3-31, 4-6, 4-36, 6-11, 8-2

variables symboliques,4-36EXECRE,3-5EXECRF,3-5

variables symboliques,3-5EXECRM,3-5

variables symboliques,3-5EXECSE,3-6

variables symboliques,3-6EXECSF,3-6

variables symboliques,3-6EXECSFA,3-6

variables symboliques,3-6EXECSM,3-7

variables symboliques,3-7EXECSMA,3-7

variables symboliques,3-7EXITA,5-25EXITE,5-25EXITEOT,3-7

variables symboliques,3-7FACIL,6-32FACILITY,6-28FACTION,4-7, 4-30, 4-37, 4-56facultatifs,7-14, 7-26, 7-27, 7-29, 7-33, 8-1

commande END,7-33commande KEEP,7-26commande LISTCAT,2-13


CFT V2.3 Index-13

Paramètres, facultatifs (suite)commande RECV,7-14commande START,7-27, 7-29

FAST,8-1FBLKSIZE,1-4, 2-30, 2-38, 4-7, 4-38FCODE,4-7, 4-66FCOMP,4-56FDATE,7-3, 7-4FDB,4-30, 4-56FDISP,4-3, 4-39fichiers (généraux),4-34


FILE,2-13, 2-41FIRST,2-41, 2-42FLRECL,4-8, 4-40

OS2,4-8UNIX,4-8VOS,4-8

FNAME,2-4, 2-30, 3-20, 3-24, 3-32, 4-9, 4-30, 4-41,4-56, 4-67, 6-11variables symboliques,4-41

FNAMEABS,7-1, 7-4FOR,6-12FORCE,4-12, 4-42FORG,4-13FOUT,2-10FPARM,2-10FPART,2-11FPREFIX

variables symboliques,6-2FRECFM,4-43

OS400,4-13UNIX,4-13VOS,4-13

FREE1,5-45FREE2,5-45FSPACE,2-30, 4-13, 4-43FSPACEX,2-31GATEWAY,5-13

VMS,5-13généraux,3-1

commande CFTPARM,3-1d’environnement du moniteur

commandes CFTPARM CFTCOM CFTCATCFTACCNT CFTLOG,1-3

d’environnement du moniteur,1-3GFA,6-28GROUP,6-3

variables symboliques,6-3GROUPID,4-3, 4-13, 4-33, 4-44HIGPORT,5-15HOST,5-15, 6-25

GUARDIAN,5-15MVS,5-15UNIX,5-15VMS,5-15

IBLKSIZE,2-34ICOMP,2-35

Paramètres (suite)ICT,2-35ID,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-32PeSIT profil SIT,4-14

ID,5-2IDA,2-14, 7-4, 7-8, 7-10, 7-16, 7-23, 7-24, 7-26, 7-27,

7-29, 7-34IDF,2-8, 2-9IDF,2-14, 4-61, 5-46, 6-3, 7-4, 7-16, 7-23, 7-24, 7-26,

7-28, 7-29, 7-34IDM,7-8, 7-10IDT,2-14, 7-10, 7-23, 7-25, 7-26, 7-28, 7-29, 7-34IDTU,2-8, 2-9IDTU,2-13, 2-14, 2-22, 7-22, 7-23, 7-24, 7-25, 7-26,

7-27, 7-28, 7-29, 7-30IFNAME,2-35ILRECL,2-35IMAXTIME,6-3, 6-15, 6-30IMINTIME,6-3, 6-15, 6-30IMPL,4-14, 7-4INDEX,2-6IPART,6-3KEY,3-8LANGUAGE,3-31LAST,2-42LENGTH,3-25LINEID,6-32LINEID,5-3, 5-4liste des commande LISTPARM,2-25LOCK,2-31LOG,3-8LOGMODE,6-21, 6-23LOWPORT,5-15LUNAME,5-12, 5-13, 6-21, 6-23, 6-30

OS400,5-12, 6-23VMS,5-13

LUNAME,5-7MAC,2-32MACTION,4-33, 4-44MAXCNX,5-2MAXDATE,4-14, 4-44MAXREC,3-25, 3-32MAXTASK,3-9MAXTIME,4-14, 4-45MAXTRANS,3-9

valeurs par défaut,3-9MEDIACOM,2-4MINDATE,4-15, 4-45MINTIME,4-15, 4-45MODE,2-32, 6-30, 6-32MODENAME,6-31modification des,1-2MODIN,5-3, 5-4MODOUT,6-32MODOUT,5-3, 5-4MSG,2-9MSG,7-8, 7-11

Index

CFT V2.3Index-14

Paramètres (suite)MULTART,5-37NAME,3-17

GCOS7,3-17VM,3-17

NBLKSIZE,4-16NBR,5-46NCODE,4-16, 4-67NCOMP,4-46NET,3-10, 5-26

MVS,3-10VM,3-10VSE,3-10

NETPFX,5-12, 5-21GUARDIAN,5-21OS400,5-12OS400,5-11

NETPFX,5-7, 5-11NFNAME,4-17, 7-16

PeSIT profil CFT,7-16NFVER,7-18

PeSIT profil CFT,7-18VFM,7-18

NIDF,4-63, 5-46NLRECL,4-18, 5-46NODE,6-16, 6-18

VMS,6-16NOTIFY,3-25, 4-3, 4-33, 4-46

MVS,4-20valeurs par défaut,3-25

NPART,2-14, 3-10, 5-46NRPART,6-3, 6-4NRPASSW,6-4NSPASSW,5-46, 6-4NTYPE

valeurs par défaut,B-1PeSIT profil CFT,B-1

obligatoirescommande LISTCAT,2-15commande SEND TYPE = FILE,7-4

OCOMP,2-37OCT,2-37OFNAME,2-37OLRECL,2-37OMAXTIME,6-5, 6-15, 6-30OMINTIME,6-5, 6-15, 6-30OPERMSG,3-27, 4-3, 4-21, 4-33, 4-48

valeurs par défaut,3-27, 4-21, 4-48ORECFM,2-38OSPACE,2-38PACKETSZ,5-21

MVS,5-21OS400,5-21

PAD,5-33PADNO,6-32PADSET,5-3, 5-4,6-32PARM,4-22, 5-46

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-10OS400,3-10

PCVI,6-28PCVO,6-28PREFIX,6-2PRI,4-22, 4-49PROF,5-38PROFILE

MVS,5-10VM,5-10

PROFILE,5-10PROT,3-10, 6-5PUNAME,5-12, 5-13

OS400,5-12VMS,5-13

PUNAME,5-7RAPPL,4-22, 4-49, 4-50, 4-51RAUTH,6-5RCHKW,5-39RCOMP

valeurs par défaut,5-26RCREDIT,5-33RCVALLER,3-10RECNB,2-32RECV

MVS,5-10VM,5-10

RECV,5-7, 5-10réseaux,6-16

d’un partenaire,6-16commande CFTDNA,6-16

VMS,6-16commande CFTDSA,6-17

GCOS6,6-17GCOS7,6-17GCOS8,6-17

commande CFTSNA,6-19MVS,6-19OS2,6-19OS400,6-19VM,6-19VMS,6-19

commande CFTTCP,6-25GUARDIAN,6-25MVS,6-25UNIX,6-25VMS,6-25

commande CFTX25,6-26GCOS6,6-17GCOS7,6-17GCOS8,6-17

VMS,6-16réseaux et protocoles,1-3

commandes CFTNET CFTPROT CFTETB,1-3RESTART,5-27


CFT V2.3 Index-15

Paramètres (suite)RESYNC,5-33, 5-39, 5-41RETRYM,6-15, 6-30RETRYN,6-15, 6-30RETRYW,6-16, 6-30RH,3-20RKERROR,3-21, 4-34, 4-49RPACING,5-39RRSUSIZE,5-33RRUSIZE,5-39RT,3-21RTO,5-27RUSER,4-23RX,3-21SAP,6-6SAPPL,4-23, 4-24SAUTH,6-8SBMID

GCOS7,6-18SBMPROJ

GCOS7,6-18, 6-19SCHKW,5-39SCOMP

valeurs par défaut,5-29SCREDIT,5-33SECFNAME,3-11SH,3-21SNAME,5-47SPACING,5-40SPART,4-4, 4-24, 7-3, 7-6SPEED,6-28, 6-32SPEED,5-3, 5-4SRUSIZE,5-34, 5-41

MVS,5-41ST,3-21STATE,2-15, 2-27, 4-24, 4-51, 7-23SUSER,4-25SWITCH,3-28SX,3-21SYST,6-8TCP,5-34TCYCLE,4-25, 7-20TIMEP,2-6, 3-19, 3-21TPNAME,5-7, 5-8,6-31TRANTASK,3-11

valeurs par défaut,3-11TRK,4-26, 4-52, 6-8, 7-7, 7-20TRKPART,3-12TRKRECV,3-12TRKSEND,3-12TYPE,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-21USERCTRL,3-13USERID,2-6, 2-7,4-26, 4-52

variables symboliques,4-26, 4-52VER,5-47

Paramètres (suite)VERIFY,6-29WAITRESP,3-13

valeurs par défaut,3-13WAITTASK,3-14

MVS,3-14VM,3-14

WFNAME,4-26variables symboliques,4-26, 4-53

WSCAN,3-17, 3-22XLATE,4-27, 4-54, 6-9

PARM paramètre,4-22, 5-46commande CFTETB,5-46commande CFTSEND,4-22

PeSIT profil CFT,4-22PART 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-34commande CFTAUTH,4-63commande CFTDEST,6-13commande CFTPARM,3-10commande CFTPROT,5-38

TYPE = PeSIT,5-38commande DELETE,7-23commande END,7-34commande HALT,7-25commande KEEP,7-26commande KSTATE,2-8, 2-9commande LISTCAT,2-14commande LISTPARM,2-25commande RECV,7-19commande SEND,7-6, 7-9, 7-11


commande START,7-28, 7-30Partenaires,2-26, 7-35

commande CFTDEST,6-10commande CFTDNA,6-16

VMS,6-16commande CFTDSA,6-17commande CFTPART,6-1commande CFTSNA,6-19

MVS,6-19OS2,6-19OS400,6-19VM,6-19VMS,6-19

commande CFTTCP,6-25commande CFTX25,6-26commande CFTXXX,6-13commandes CFTPART CFTDEST,1-3définition réseau,6-13

commande CFTXXX,6-13liste des,2-26, 6-10, 7-35

definition,6-10commande CFTDEST,6-10

Index

CFT V2.3Index-16

Partenaires (suite)paramètres réseaux,1-3

commande CFTDNA,6-16VMS,6-16

commande CFTDSA,6-17GCOS6,6-17GCOS7,6-17GCOS8,6-17

commande CFTSNA,6-19MVS,6-19OS2,6-19OS400,6-19VM,6-19VMS,6-19

commande CFTTCP,6-25GUARDIAN,6-25MVS,6-25UNIX,6-25VMS,6-25

commande CFTX25,6-26commandes CFTX25 CFTTCP¨CFTSNA CFTDSA

CFTDNA CFTNTX,1-3réception de fichiers,7-12

commande RECV,7-12PARTFNAM paramètre,3-10

commande CFTPARM,3-10PCVI paramètre,6-28

commande CFTX25,6-28PCVO paramètre,6-28

commande CFTX25,6-28PeSIT Voir Protocoles, de transfertPlage horaire Voir Transferts, plage horaire autoriséePREFIX paramètre,6-2

commande CFTPART,6-2PRI paramètre,4-22, 4-49


PROF paramètre,5-38commande CFTPROT,5-38

TYPE = PeSIT,5-38commande CFTPROT TYPE = PeSIT

PeSIT profil CFT,5-38PeSIT profil EXTERN,5-38PeSIT profil SIT,5-38

PROFILE paramètrecommande CFTNET TYPE = SNA,5-10

PROFILE paramètre,5-10PROT paramètre,3-10, 6-5

commande CFTPARM,3-10commande CFTPART,6-5

Protocolesde transfert Voir Commandes, de paramétrage

commande CFTPROT,5-22ETEBAC3

commande CFTPROT TYPE = ETEBAC,5-30format de la carte,5-43

commande CFTETB,5-43

Protocoles, de transfert (suite)ODETTE

commande CFTPROT TYPE = ODETTE,5-31PeSIT

commande CFTPROT TYPE = PeSIT,5-34TCP/IP,5-34

ETEBAC3,4-21commande CFTETB,5-43commande CFTIDF,4-63

paramètre NIDF,4-63commande CFTPROT,5-22

paramètre DISCTD,5-24paramètre DISCTS,5-24, 5-26paramètre SCOMP,5-29TYPE = ETEBAC,5-30

commande CFTRECV,4-35paramètres fichiers (généraux),4-35

commande CFTSEND,4-21paramètre NRECFM,4-21

ODETTEcommande CFTIDF,4-63

paramètre NIDF,4-63commande CFTPROT,5-22

paramètre DISCTD,5-24paramètre DISCTS,5-24, 5-26paramètre SCOMP,5-29TYPE = ODETTE,5-31

commande CFTSENDparamètre NLRECL,4-18paramètre NRECFM,4-20paramètre NSPACE,4-21paramètre NTYPE,4-21

PeSIT,4-14commande CFTIDF,4-63

paramètre NIDF,4-63commande CFTPROT TYPE = PeSIT,5-34commande CFTSEND

paramètre NSPACE,4-21E CFT/CFT

commande CFTSENDparamètre PARM,4-22

profil CFT,4-16commande CFTPROT

paramètre DISCTD,5-24paramètre DISCTS,5-24, 5-26paramètre SCOMP,5-29

commande CFTRECVparamètres fichiers (généraux),4-35

commande CFTSEND,4-16paramètre NBLKSIZE,4-16paramètre NCOMP,4-17paramètre NFNAME,4-17paramètre PARM,4-22paramètre RAPPL,4-49, 4-50, 4-51, 4-52paramètre RUSER,4-23, 4-50paramètre SUSER,4-25, 4-51


CFT V2.3 Index-17

Protocoles, PeSIT (suite)profil EXTERN,4-17

commande CFTPROTparamètre DISCTD,5-24paramètre DISCTS,5-24, 5-26paramètre SCOMP,5-29


commande CFTSEND,4-17paramètre NCOMP,4-17

profil SIT,4-14commande CFTIDF,4-62commande CFTPROT,5-24

paramètre DISCTD,5-24paramètre DISCTS,5-24, 5-26paramètre SCOMP,5-29


commande CFTSEND,4-14paramètre ID,4-14paramètre RAPPL,4-22, 4-49paramètre RUSER,4-23, 4-50paramètre SAPPL,4-24, 4-50

PeSIT Dcommande CFTPROT,5-22

PeSIT Ecommande CFTIDF,4-63

paramètre NIDF,4-63commande CFTPROT,5-22commande CFTSEND

paramètre PARM,4-22PeSIT E CFT/CFT

commande CFTIDF,4-63paramètre NIDF,4-63

PeSIT profil CFTcommande CFTRECV,4-46

paramètre NCOMP,4-46PeSIT profil EXTERN

commande CFTRECV,4-46paramètre NCOMP,4-46

Proxy,5-14PUNAME paramètre,5-12, 5-13

commande CFTNET TYPE = LU62,5-7commande CFTNET TYPE = SNA,5-12, 5-13

PUNAME paramètre,5-7PURGE commande,2-6

RRAPPL paramètre,4-22, 4-49, 4-50, 4-51

commande CFTSEND,4-22, 4-49, 4-50, 4-51PeSIT profil CFT,4-49, 4-50, 4-51, 4-52

RAUTH paramètre,6-5commande CFTPART,6-5

RCHKW paramètre,5-39commande CFTPROT TYPE = PeSIT,5-39

RCOMP paramètrecommande CFTPROT

ETEBAC3,5-26ODETTE,5-26PeSIT profil CFT,5-26PeSIT profil EXTERN,5-26PeSIT profil SIT,5-26

RCREDIT paramètre,5-33commande CFTPROT,5-33commande CFTPROT TYPE = ODETTE,5-33

RCVALLER paramètre,3-10commande CFTPARM,3-10

Réception,1-5de fichiers Voir Commandes, associées aux transferts

RECNB paramètre,2-32commande CFTFILE,2-32

RECVcommande,7-12

PeSIT profil SIT,7-12paramètre

commande CFTNETTYPE = LU62,5-7TYPE = SNA,5-10

paramètre,5-7, 5-10RECV

paramètre,5-7Redémarrage,1-5

des transferts,1-5 Voir aussi Commandes, associéesaux transferts

Reprise,3-22des transferts Voir Journal de CFT

Réseaux,2-28DNA,2-28identifiants Voir Identifiants, réseauressources Voir Ressources réseaux

Réseaux commande CFTPROT,5-22Ressource réseau déportée,5-14Ressources réseaux

commande CFTPROT,5-22DECNET

commande CFTNET TYPE = DNA,5-5DECNET,5-5DSA

commande CFTNET TYPE = DSA,5-5DSA,5-5locales

commande CFTNET,5-1locales,5-1SNA

commande CFTNET TYPE = SNA,5-8SNA,5-8TCP,5-14

commande CFTNET TYPE = TCP,5-14X25,5-18

commande CFTNET TYPE = X25,5-18RESTART paramètre,5-27

commande CFTPROT,5-27

Index

CFT V2.3Index-18

RESYNC paramètre,5-33, 5-39, 5-41commande CFTPROT,5-33, 5-39, 5-41

TYPE = ODETTE,5-33TYPE = PeSIT,5-39, 5-41

PeSIT profil CFT,5-39, 5-41PeSIT profil EXTERN,5-39, 5-41

RETRYM paramètre,6-15, 6-30commande CFTLU62,6-30commande CFTXXX,6-15

RETRYN paramètre,6-15, 6-30commande CFTLU62,6-30commande CFTXXX,6-15

RETRYW paramètre,6-16, 6-30commande CFTLU62,6-30commande CFTXXX,6-16

RH paramètre,3-20commande CFTCAT,3-20

RKERROR paramètre,3-21, 4-34, 4-49commande CFTCAT,3-21commande CFTRECV,4-34commande CFTSEND,4-49

RPACING paramètre,5-39commande CFTPROT TYPE = PeSIT,5-39

RRSUSIZE paramètre,5-33commande CFTPROT TYPE = ODETTE,5-33

TCP/IP,5-33RRUSIZE paramètre,5-39

commande CFTPROT TYPE = PeSIT,5-39TCP/IP,5-39

RT paramètre,3-21commande CFTCAT,3-21

RTO paramètre,5-27commande CFTPROT,5-27

RUSER paramètre,4-23commande CFTSEND,4-23

PeSIT profil CFT,4-23, 4-50RX paramètre,3-21

commande CFTCAT,3-21

SSAP paramètre,6-6

commande CFTPART,6-6SAPPL paramètre,4-23, 4-24

commande CFTSEND,4-23, 4-24SAUTH paramètre,6-8

commande CFTPART,6-8SCHKW paramètre,5-39

commande CFTPROT TYPE = PeSIT,5-39SCOMP paramètre

commande CFTPROTODETTE,5-29PeSIT profil CFT,5-29PeSIT profil EXTERN,5-29PeSIT profil SIT,5-29

SCREDIT paramètre,5-33commande CFTPROT TYPE = ODETTE,5-33

SECFNAME paramètre,3-11commande CFTPARM,3-11

SEGMENT paramètrecommande CFTPROT TYPE = PeSIT

PeSIT profil SIT,5-40SEND commande,7-1

TYPE = FILE,7-1TYPE = MESSAGE,7-7

PeSIT profil CFT,7-7TYPE = REPLY,7-9

Services Voir Utilitaire CFTUTILSession,3-22

début de Voir Journal de CFTfermeture de Voir Journal de CFT

SH paramètre,3-21commande CFTCAT,3-21

SHUT commande,1-8, 8-1SNAME paramètre,5-47

commande CFTETB,5-47SPACING paramètre,5-40

commande CFTPROT TYPE = PeSIT,5-40SPART commande,7-3SPART paramètre,4-4, 4-24, 7-6

commande CFTSEND,4-4, 4-24commande SEND,7-3, 7-6

TYPE = FILE,7-6SPEED paramètre,6-28, 6-32

commande CFTASY,6-32commande CFTNET

TYPE = ASY,5-3, 5-4commande CFTX25,6-28

SPEED paramètre,5-3, 5-4SRUSIZE paramètre,5-34, 5-41

commande CFTPROT,5-34, 5-41TYPE = ODETTE,5-34

TCP/IP,5-34TYPE = PeSIT,5-41

TCP/IP,5-41SSERV paramètre

commande CFTPROT TYPE = PeSITPeSIT profil CFT,5-41

ST paramètre,3-21commande CFTCAT,3-21

START commande,1-7, 7-27, 7-28, 7-29STATE paramètre,2-15, 2-27, 4-24, 4-51, 7-23

commande CFTSEND,4-24, 4-51commande DELETE,7-23commande LISTCAT,2-15commande LISTPART,2-27

valeurs prédéfinies,2-27Statistiques,2-39

d’exécution Voir Utilitaire CFTUTILcommande COPYFILE Voir Utilitaire CFTUTIL

enregistrement des données Voir Commandes,CFTACCNT

Stockage des données reçues Voir Environnement destransferts, commande CFTRECV

SUBMIT commande,1-7


CFT V2.3 Index-19

Suppression,1-5d’un poste du catalogue,1-7 Voir aussi Action sur les

transfertsde postes du catalogue,1-5 Voir aussi Commandes,

associées aux transfertsSUSER paramètre,4-25

commande CFTSEND,4-25PeSIT profil CFT,4-25, 4-51

Suspension,2-5de CFTUTIL,2-5de transferts,1-5 Voir aussi Commandes, associées

aux transfertsSWITCH commande,1-8, 8-1SWITCH paramètre,3-28

commande CFTLOG,3-28SX paramètre,3-21

commande CFTCAT,3-21SYST paramètre,6-8

commande CFTPART,6-8PeSIT profil CFT,6-8

TTCP paramètre,5-34


TCYCLE paramètre,4-25, 7-20commande CFTSEND,4-25commande RECV,7-20

TIMEP paramètre,2-6, 3-19, 3-21commande CFTCAT,3-19, 3-21commande PURGE,2-6

TPNAME paramètre,6-31commande CFTLU62,6-31commande CFTNET TYPE = LU62,5-7, 5-8

TPNAME paramètre,5-7, 5-8Transcodage,4-64, C-1

table deémission et réception,4-66

commande CFTXLATE,4-66paramètre DIRECT,4-66

pour l’émission,4-66commande CFTXLATE,4-66

paramètre DIRECT,4-66pour la réception,4-66

commande CFTXLATE,4-66paramètre DIRECT,4-66

tables de,C-1ASCII,C-1EBCDIC,C-1

Transfert,2-12, 2-16, 2-18acquittement de,7-9actions sur les,7-22

catalogue,7-22postes du,7-22

suppression,7-22commande DELETE,7-22

commande DELETE,7-22activation,1-6

Transfert (suite)activation d’un,1-6activation d'un Voir aussi Action sur les transfertsarrêt de,1-5, 7-24 Voir aussi Commandes, associées

aux transfertscommande HALT,7-24

bloqués,1-6 Voir aussi Action sur les transfertscommandes associées aux,7-1commandes CFTAUTH CFTIDF CFTXLATE

CFTSEND CFTRECV,1-3correctement terminés Voir Commandes,

CFTACCNTdébut des Voir Journal de CFTdé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 CFTexécutés,7-33 Voir aussi Commandes, END

déclaration de,7-33commande END,7-33

fichier statistiquestructure,D-1, E-1, F-1

en langage C,D-1en langage COBOL,D-2

fin des,1-6, 3-22commande END,1-7 Voir aussi Action sur les

transfertsidentifiant,4-32informations associées aux,2-12, 2-16, 2-18interruption,1-6, 8-1 Voir aussi Action sur les

transfertsplage horaire autorisée,4-32réactivation,1-6 Voir aussi Action sur les transferts

commande START,1-7redémarrage des,1-5, 7-28 Voir aussi Commandes,

associées aux transfertscommande START,7-28

requêtes,1-6suppression,1-6 Voir aussi Action sur les transferts

suspendus,1-6 Voir aussi Action sur les transfertssuspension de,1-5, 7-25 Voir aussi Commandes,

associées aux transfertscommande KEEP,7-25

transcodage,4-64table de,4-64

TRANTASK paramètre,3-11commande CFTPARM,3-11

TRKparamètre,7-7, 7-20

commande RECV,7-20commande SEND,7-7

TYPE = FILE,7-7TRK paramètre,4-26, 4-52, 6-8

commande CFTPART,6-8commande CFTRECV,4-52commande CFTSEND,4-26

TRKPART paramètre,3-12commande CFTPARM,3-12

Index

CFT V2.3Index-20

TRKRECV paramètre,3-12commande CFTPARM,3-12

TRKSEND paramètre,3-12commande CFTPARM,3-12

TYPEparamè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-2commande CFTACCNT,3-31commande CFTAUTH,4-64commande CFTCOM,3-17commande CFTEXIT,4-57, 4-59commande CFTEXT,2-11

valeurs prédéfinies,2-11commande CFTFILE,2-32commande CFTNET

TYPE = LU62,5-8commande CFTPROT,5-30

ETEBAC3,5-30commande CONFIG,2-5commande LISTCAT,2-15commande LISTPARM,2-25

valeurs prédéfinies,2-25commande LISTPART,2-27

valeurs prédéfinies,2-27commande SEND,7-7, 7-9, 7-11


commande SWITCH,8-2paramètre,5-8

TYPE = ASY paramètrecommande CFTNET TYPE = ASY,5-3

TYPE = ASY paramètre,5-3TYPE = LU62 paramètre

commande CFTNET TYPE = LU62,5-7TYPE = LU62 paramètre,5-7

UUPDAT paramètre,3-21

commande CFTCAT,3-21USERCTRL paramètre,3-13

commande CFTPARM,3-13USERID paramètre,2-6, 2-7USERID paramètre,4-26, 4-52

commande CFTRECV,4-52commande CFTSEND,4-26commande CLEARCMD,2-6, 2-7

UtilitaireCFT

spécificités GCOS8,2-29, 3-11spécificités OS400,2-29, 3-10, 4-54

Utilitaire CFTUTIL Voir Commandes, de l’utilitaireCFTUTILconsultations et extractions,1-1

commandes CFTEXT LISTPARM LISTPARTLISTCAT,1-1

manipulations de fichiers,1-1commandes CFTFILE COPYFILE,1-1

Utilitaire CFTUTIL (suite)services,1-1, 2-1

commande CONFIG,1-1

VValeurs,2-27

ASY,2-27ASY,5-1LU62,2-27, 2-28LU62,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-47commande CFTETB,5-47

VERIFYcommande CFTX25,6-29paramètre,6-29

VFM,4-29, 4-55 Voir aussi Protocoles,PeSIT, profil CFTcommande RECV Voir Protocoles, PeSIT, profil CFT


CFT V2.3 Index-21

VFM (suite)paramètres associés à un fichier type,4-29, 4-55


WWAIT commande,2-5WAITRESP paramètre,3-13

commande CFTPARM,3-13WAITTASK paramètre,3-14

commande CFTPARM,3-14WFNAME paramètre,4-26

commande CFTSEND,4-26WLOG commande,2-9WSCAN paramètre,3-17, 3-22

commande CFTCAT,3-22commande CFTCOM,3-17

XXLATE paramètre,4-27, 4-54, 6-9

commande CFTPART,6-9commande CFTRECV,4-54commande CFTSEND,4-27

manuel de référence

Documents