Sunteți pe pagina 1din 233

Manuel de rfrence

XFB Monitor CFT


Version 2.4

Documentation

DD MM YYYY

Copyright Axway Software, 2007 Tous droits rservs. Ce document dcrit le logiciel suivant, dit par Axway : XFB Monitor CFT Toute reproduction totale ou partielle, toute transmission sous quelque forme ou par quelque procd que ce soit (lectronique ou mcanique, photocopie ou enregistrement) de ce document sans autorisation crite pralable d'Axway Software est strictement interdite. Ce document, mis disposition dans un but de documentation uniquement, peut tre sujet de profondes modifications. Les informations et descriptions disponibles dans ce document ne reprsentent ni ne rflchissent pas ncessairement avec exactitude l'tat courant ou futur des fonctionnalits du produit. Axway se rserve le droit de modifier ce document, le produit qui y est dcrit ou les deux. Ces modifications seront prises en compte dans les versions futures de ce document. Axway Software ne garantit pas que ce document soit exempt de toute erreur. Axway Software reconnat les droits des dtenteurs des marques commerciales cites dans ce document.

Table des matires

Conventions syntaxiques et typographiques 1.1 1.2 1.3 1.4 Conventions syntaxiques Conventions typographiques Variables symboliques Nom de fichier, utilisation
1.4.1 Utilisation du paramtre FNAME

1-1 1-1 1-1 1-1 1-2


1-2

Liste syntaxique des commandes de CFT 2.1 Commandes CFT

2-1 2-1 3-1 3-1


3-1 3-2

Les variables symboliques 3.1 Utilisation des variables symboliques


3.1.1 Syntaxe des variables symboliques 3.1.2 Liste des variables symboliques

Les paramtres de CFT 4.1 4.2 Prsentation Liste des paramtres

4-1 4-1 4-1 5-1 5-1 5-1 5-2


5-2

Les objets CFT 5.1 5.2 5.3 5.4 A propos de la configuration du moniteur CFT distant Configuration du moniteur CFT local Objets de configuration initiale de CFT
5.3.1 Icnes des objets de CFT

Objets de configuration actuelle de l'interface GUI

5-3 6-1 6-1


6-2

Dfinition de lenvironnement du moniteur 6.1 6.2 6.3 6.4 Mode denregistrement des donnes statistiques - CFTACCNT
6.1.1 Mode d'enregistrement TYPE

Attributs du catalogue
6.2.1 Fonctions du catalogue de l'interface graphique

6-3
6-4

Mdias de communication - CFTCOM


6.3.1 Mdias des fichiers de service de CFT

6-4
6-5

Carte ETEBAC3 - CFTETB


6.4.1 Caractristiques du transfert ETEBAC

6-9
6-9

Manuel de rfrence

Table des matires

ii

6.4.2 Format des cartes de paramtrage 6.4.3 Dfinition des paramtres ETEBAC3 actuels

6-10 6-10

6.5 6.6

Tches exit - CFTEXIT Paramtrage des journaux - CFTLOG


6.6.1 Enregistrement des dtails du transfert 6.6.2 Bascule entre les fichiers journaux

6-11 6-11
6-12 6-12

6.7

Ressources rseau - CFTNET


6.7.1 Qu'est-ce qu'une ressource rseau locale ? 6.7.2 Comment fonctionne l'objet CFTNET ?

6-13
6-13 6-14

6.8

Protocoles de transfert CFTPROT


6.8.1 Qu'est-ce-que l'objet CFTPROT ? 6.8.2 Transferts par le biais d'un proxy et du protocole SOCKS

6-14
6-14 6-15

6.9 6.10 7

Dfinition des paramtres gnraux - CFTPARM


6.9.1 Comment fonctionne l'objet CFTPARM ?

6-1
6-1

Bascule entre les fichiers journaux - CFTLOG

6-2 7-1 7-1 7-1 7-2 7-3


7-3 7-4 7-5 7-5

Cration des partenaires Listes de diffusion 7.1 7.2 7.3 7.4 A propos de CFTDEST Collecte Dfinition d'une liste de partenaires Concepts de diffusion
7.4.1 7.4.2 7.4.3 7.4.4 Diffusion en utilisant un site de commutation Notations spcifiques la diffusion Processus de diffusion Acquittement d'une liste de diffusion

7.5

Dfinition des partenaires - CFTPART


7.5.1 Paramtres de configuration associs 7.5.2 Partenaire ayant la mme valeur NRPART

7-1
7-1 7-1

7.6

Paramtrage par dfaut du rseau - CFTxxx


7.6.1 7.6.2 7.6.3 7.6.4 7.6.5 CFTDNA - Paramtres rseau dun partenaire DNA CFTSNA - Paramtres rseau dun partenaire SNA CFTTCP - Paramtres rseau dun partenaire TCP/IP CFTX25 - Paramtres rseaux dun partenaire X25 CFTLU62 - Paramtres rseau dun partenaire LU62

7-2
7-3 7-3 7-3 7-3 7-4

7.7

Exemples de diffusion
7.7.1 Diffusion simple 7.7.2 Diffusion personnalise 7.7.3 Diffusion composite

7-4
7-4 7-5 7-6

Transfert de fichiers 8.1 8.2 Cration de listes dhabilitation - CFTAUTH Modle d'association virtuelle de fichiers - CFTIDF

8-1 8-1 8-1

Manuel de rfrence

Tables des matires

iii

8.3

Cration du modle RECV par dfaut


8.3.1 8.3.2 8.3.3 8.3.4 Rsum des paramtres du fichier de rception Rception d'un fichier A propos de l'objet CFTRECV par dfaut Paramtres associs un fichier type

8-2
8-2 8-3 8-4 8-4

8.4

Cration du modle SEND par dfaut - CFTSEND


8.4.1 Paramtrage de la commande CFTSEND 8.4.2 A propos des paramtres SEND par dfaut 8.4.3 Emission d'un fichier

8-5
8-6 8-7 8-8

8.5

Tables de transcodage - CFTXLATE


8.5.1 Transcodage 8.5.2 Phase de transfert de donnes

8-8
8-8 8-9

8.6 8.7

Scurit des changes SSL - CFTSSL Excution des scripts - CFTCRON


8.7.1 Paramtrage dun CRONJOB 8.7.2 tats de transfert

8-11 8-12
8-12 8-13

8.8

Commutation
8.8.1 8.8.2 8.8.3 8.8.4 Commutation de secours Commutation intentionnelle Commutation VAN intentionnelle Commutation force

8-13
8-13 8-15 8-16 8-17

8.9

Transferts implicites
8.9.1 Transfert en lecture avec mission implicite 8.9.2 Transfert en lecture avec mission implicite en mode ferm 8.9.3 Transfert en lecture avec mission implicite en mode ouvert

8-18
8-18 8-19 8-20

8.10

Gestion des fichiers de CFT


8.10.1 mission d'un fichier 8.10.2 Rception de fichiers 8.10.3 Stockage des donnes 8.10.4 Allocation dynamique de l'espace disque ct rcepteur 8.10.5 Cration implicite de rpertoires

8-23
8-23 8-23 8-24 8-25 8-26

8.11

Fichiers types et fichiers physiques


8.11.1 Types de modes de transfert 8.11.2 Qu'est-ce qu'un identifiant de fichier type ? 8.11.3 Emplacements des fichiers 8.11.4 Fichiers logiques VFM 8.11.5 Requte pour transfrer plusieurs fichiers physiques 8.11.6 Rception d'un groupe de fichiers ayant le mme IDF en mode rcepteur/demandeur 8.11.7 Emission d'un groupe de fichiers ayant le mme IDF en mode metteur 8.11.8 Consultation d'un rpertoire distant 8.11.9 Requte pour recevoir plusieurs fichiers types 8.11.10 IDF gnrique 8.11.11 Rception slective 8.11.12 Rceptions globales 8.11.13 Protection de l'identifiant de fichier type

8-26
8-26 8-27 8-30 8-31 8-31 8-31 8-32 8-32 8-33 8-34 8-34 8-35 8-36

Manuel de rfrence

Tables des matires

iv

1 Conventions syntaxiques et typographiques

1.1 Conventions syntaxiques


La syntaxe des commandes CFT utilise les conventions gnrales suivantes : les paramtres obligatoires prcdent les paramtres facultatifs ; la valeur par dfaut d'un paramtre est place devant les autres valeurs possibles dans la liste associe ce paramtre.

1.2 Conventions typographiques


Les conventions typographiques utilises respectent les rgles suivantes : [ { | ___ , ] } les paramtres ou les valeurs facultatifs sont affichs entre crochets ; les options ou les valeurs des paramtres sont affiches entre accolades ; la barre verticale est utilise comme sparateur dans une liste numrique de valeurs de paramtres ; les valeurs par dfaut des paramtres sont soulignes ; la virgule est utilise comme sparateur dans une liste de valeurs de paramtre.

1.3 Variables symboliques


La syntaxe des variables symboliques suivantes est valable dans un environnement CFT : &VAR &+VAR &nVAR: &p.VAR &p.nVAR &(-string_prefix) (+string_suffix) (=string_alternate)p.nVAR

Manuel de rfrence

Conventions syntaxiques et typographiques

1-1

1.4 Nom de fichier, utilisation


Ce nom est un nom de fichier physique complet. Il peut : soit tre cr de manire dynamique partir de variables symboliques, soit correspondre au nom d'un fichier de version.

1.4.1

Utilisation du paramtre FNAME


Les conventions de noms de fichiers sont les suivantes : filename Transfre un fichier dont le nom est spcifi par un nom de fichier ; mask Le terme mask (masque) signifie que le nom de fichier inclut au moins un caractre gnrique (* ou ?). Envoie un fichier qui rpertorie tous les fichiers correspondant au masque ; dirname Envoie un fichier qui rpertorie le contenu du rpertoire ; #filename Envoie le fichier correspondant chaque nom de fichier rpertori dans le fichier ; #mask Envoie le fichier correspondant chaque nom de fichier correspondant au masque ; #dirname Envoie le fichier correspondant chaque fichier existant dans le rpertoire ; Remarque : dans un environnement UNIX, utilisez le symbole @ la place du symbole #. Type de notation
Type Compression : valeur numrique de 0 15 lie lalgorithme de compression Date : chane de 8 caractres numriques Nom de fichier : chane alphanumrique dune longueur maximum de 64 caractres Identifiant : chane de 1 8 caractres alphanumriques avec le premier caractre alphabtique Masque : chane de caractres spciaux constituant un masque Time : chane de 2 8 caractres numriques Identifiant de transfert attribu par CFT Notation cpr AAAAMMJJ filename identifier mask HHMMSS transid

Manuel de rfrence

Conventions syntaxiques et typographiques

1-2

2 Liste syntaxique des commandes de CFT

Toutes les commandes de CFT sont listes ci-aprs dans l'ordre alphabtique. Chaque commande est prsente avec les paramtres possibles et les valeurs par dfaut. Cliquez sur le lien Concepts pour obtenir des informations gnrales sur les commandes.

2.1 Commandes CFT


ABOUT
Affiche des informations sur le produit/host. [COMMENT = string] [TYPE = {ALL|HOST|CFT}]

ACT
Ractive un partenaire. ID = identifier [TYPE = {PART|TRK|}] [MODE = {BOTH|REQUESTER|SERVER}]

CFTACCNT
Dfinit les enregistrements statistiques des transferts. CFTACCNT TYPE = FILE TYPE = FILE FNAME = filename ID = identifier [AFNAME = filename] [COMMENT = string] [EXEC = filename] [LANGUAGE = {COBOL|C}] [MAXREC = {0|n}] [MODE = {REPLACE|CREATE|DELETE}] [SWITCH = {00000000|time}] [FORMAT = {V23|23|V24|24}] CFTACCNT TYPE = SYST TYPE = SYST ACCID = n

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-1

ID = identifier [ LANGUAGE = { COBOL | C } ] [ MODE = { REPLACE | CREATE | DELETE } ]

CFTAPPL
Dfinit le propritaire d'un transfert. CFTAPPL MODE = REPLACE ID = identifier USERID = string [ COMMENT = string ] [ GROUPID = string ] [ MODE = { REPLACE | CREATE | DELETE } ] CFTAPPL MODE = DELETE ID = identifier USERID = string DIRECT = { BOTH | [ COMMENT = string [ GROUPID = string [ MODE = { REPLACE

SEND | RECV } ] ] | CREATE | DELETE } ]

CFTAUTH
Dfinit une liste de modles autoriss. FNAME = filename ID = identifier [ COMMENT = string ] [ MODE = { REPLACE | CREATE | DELETE } ] Ou : IDF = (identifier | mask, identifier | mask, ) ID = identifier [ COMMENT = string ] [ MODE = { REPLACE | CREATE | DELETE } ]

CFTCAT
Dfinit les attributs du catalogue. FNAME = filename ID = identifier [ COMMENT = string ] [ MODE = { REPLACE | CREATE | DELETE } ] [ RH = { 10 | n } ] [ RKERROR = { KEEP | DELETE } ] [ RT = { 10 | n } ] [ RX = { 10 | n } ] [ SH = { 10 | n } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-2

[ [ [ [ [ [ [ [ [ [

ST = { 10 | n } ] SX = { 10 | n } ] TIMEP = { 23595999 | HHMMSSCC } ] TLVCEXEC = { n } ] TLVCLEAR = { TLVWARN-10 | n } ] TLVWEXEC = { n } ] TLVWRATE = { 60 | n } ] TLVWARN = { 80 | n } ] UPDAT = { 256 | n } ] WSCAN = { 5 | n } ]

CFTCOM
Dfinit les paramtres relatifs la communication entre les applications et CFT. CFTCOM TYPE = FILE TYPE = FILE ID = identifier NAME = filename [ COMMENT = string ] [ MODE = { REPLACE | CREATE | DELETE } ] [ WSCAN = { 60 | n } ] CFTCOM TYPE = MBX ID = identifier NAME = string [ COMMENT = string ] [ MODE = { REPLACE | CREATE | DELETE } ] CFTCOM TYPE = TCPIP ID = identifier HOST = string PORT = number PROTOCOL = { XHTTP | XHTTPS } [ ADDRLIST = ( string, string, ...) ] [ CERFIL = ( string, string, ...) ] [ CERPASSW = string ] [ COMMENT = string ] [ MODE = { REPLACE | CREATE | DELETE } ]

CFTCRON
Dfinit les travaux cron de CFT. CFTCRON ID = identifier CRONTAB = string EXEC = filename TIME = { string | @shutdown | @startup } [ PARM = string ] [ COMMENT = string ] [ TYPE = { EXEC | CFTUTIL } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-3

[ USERID = { CFT server "userid" | string } ]

CFTDEST
Dfinition d'une liste de partenaires. CFTDEST FNAME ID = identifier FNAME = filename [ EXEC = { DEST | PART } ] [ COMMENT = string ] [ FOR = { BOTH | COMMUT | LOCAL } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ NOPART = { ABORT | CONTINUE | IGNORE } ] CFTDEST PART ID = identifier PART = (identifier, identifier, ...) [ EXEC = { DEST | PART } ] [ COMMENT = string ] [ FOR = { BOTH | COMMUT | LOCAL } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ NOPART = { ABORT | CONTINUE | IGNORE } ]

CFTDNA ID = identifier
Paramtres rseau d'un partenaire DNA (VAX). NODE = string [ CNXIN = { 2 | n } ] [ CNXINOUT = { 2 | n } ] [ CNXOUT = { 2 | n } ] [ IMAXTIME = { 23595999 | time } ] [ IMINTIME = { 0 | time } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ OMAXTIME = { 23595999 | time } ] [ OMINTIME = { 0 | time } ] [ RETRYM = { 12 | n } ] [ RETRYN = { 6 | n } ] [ RETRYW = { 7 | n } ]

CFTETB DIRECT = { SEND | RECV }


Format de carte ETEBAC3. ID = identifier NLRECL = ( pos { 255 | len } ) [ COMMENT = string ] [ FREE1 = ( pos { 255 | len }, 'content' ) ] [ FREE2 = ( pos { 255 | len }, 'content' ) ] [ IDF = { ' ' | identifier } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-4

[ [ [ [ [ [ [ [

MODE = { REPLACE | CREATE | DELETE } ] NBR = ( pos, { 255 | len } ) ] NIDF = ( pos, { 255 | len } ) ] NPART = ( pos, { 255 | len } ) ] NSPASSW = ( pos, { 255 | len } ) ] PARM = ( pos, { 255 | len } ) ] SNAME = ( pos, { 255 | len } ) ] VER = ( pos, { 255 | len } ) ]

CFTEXIT
Activation d'une tche de sortie. CFTEXIT TYPE = FILE ID = identifier TYPE = FILE [ COMMENT = string ] [ FORMAT = { V23 | 23 | V24 | 24 } ] [ LANGUAGE = { COBOL | C } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ PARM = string ] [ PROG = { CFTEXIT | string } ] [ RESERV = { 16384 | n } ] [ WAITTASK = { 1441 | n } ] CFTEXIT TYPE = { ACCESS | ETEBAC | EXEC } ID = identifier TYPE = { ACCESS | ETEBAC | EXEC } [ COMMENT = string ] [ FORMAT = { V23 | 23 | V24 | 24} ] [ LANGUAGE = { COBOL | C } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ PARM = string ] [ PROG = { CFTEXIT | string } ] [ RESERV = { 1024 | n } ] [ WAITTASK = { 1441 | n } ]

CFTEXT
Extrait les donnes des fichiers paramtres et partenaires. [ TYPE = { ALL | ACCNT | APPL | AUTH | CAT | COM | CRON | DEST | DNA | EXIT | IDF | LOG | LU62 | NET | PARM | PART | PROT | RECV | SEND | SSL | SNA | TCP | X25 | XLATE } ] [ FOUT = filename ] [ FPARM = filename ] [ FPART = filename ] [ ID = { * | identifier | mask } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-5

CFTFILE { PARM | PART }


Cre ou supprime des fichiers CFT. TYPE = { PARM | PART } FNAME = filename [ HABFNAME = filename ] [ CIPHER = { NO | YES } ] [ FBLKSIZE = { 0 |n } ] [ FSPACE = n ] [ FSPACEX = n ] [ MAC = { NO | YES } ] [ MODE = { CREATE | REPLACE | DELETE } ]

CFTFILE { CAT | COM }


TYPE = { CAT | COM } FNAME = filename [ RECNB = n ] [ CIPHER = { NO | YES } ] [ FBLKSIZE = { 0 |n } ] [ FSPACE = { 0 | n } ] [ FSPACEX = { 0 | n } ] [ HABFNAME = filename ] [ MODE = { CREATE | REPLACE | DELETE } ]

CFTFILE { ACCNT | LOG }


TYPE = { ACCNT | LOG } FNAME = filename [ FBLKSIZE = 0 | n ] [ FSPACE = 0 |n ] [ FSPACEX = 0 |n ] [ MODE = { CREATE | REPLACE | DELETE } ]

CFTIDF ID = identifier
Correspondance entre l'identifiant rseau et l'identifiant local d'un fichier type transfr. NIDF = string PART = identifier TYPE = { RECV | SEND } [ COMMENT = string ] [ MODE = { REPLACE | CREATE | DELETE } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-6

CFTLOG FNAME = filename


Paramtres de gestion du fichier journal. ID = identifier [ AFNAME = filename ] [ COMMENT = string ] [ CONTENT = { FULL | BRIEF } ] [ EXEC = filename ] [ FORMAT = { V23 | 23 | V24 | 24 } ] [ LENGTH = { 160 | n } ] [ MAXREC = { 0 | n } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ NOTIFY = identifier ] [ OPERMSG = n ] [ SWITCH = { 00000000 | time } ]

CFTLU62 CPNAME = string


Paramtres rseau d'un partenaire LU62. ID = identifier LUNAME = string MODENAME = string TPNAME = string [ CLASS = { 1 | n } ] [ CNXIN = { 2 | n } ] [ CNXINOUT = { 2 | n } ] [ CNXOUT = { 2 | n } ] [ COMMENT = string ] [ DATA = string ] [ IMAXTIME = { 23595999 | time } ] [ IMINTIME = { 0 | time } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ NETWKID = { ‘ ‘ | string } ] [ OMAXTIME = { 23595999 | time } ] [ OMINTIME = { 0 | time } ] [ RETRYM = { 12 | n } ] [ RETRYN = { 6 | n } ] [ RETRYW = { 7 | n } ]

CFTNET
Ressources rseau locales. CFTNET TYPE = DNA ID = identifier [ CALL = { INOUT | IN | OUT } ] [ MAXCNX = { 32 | n } ] [ MODE = { REPLACE | CREATE | DELETE } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-7

CFTNET TYPE = LU62 LUNAME = string TPNAME = string ID = identifier [ CALL = { INOUT | IN | OUT } ] [ CLASS = { 1 | n } ] [ MAXCNX = { 32 | n } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ NETPFX = string ] [ PROFILE = { OLD | NEW } ] [ RECV = { 2 | n } ] [ SRCHOST= { hostname1 | n} ] CFTNET TYPE = SNA ID = identifier LUNAME = string [ ACB = string ] [ COMMENT = string ] [ CALL = { INOUT | IN | OUT } ] [ CLASS = { 1 | n } ] [ LUTYPO = string ] [ MAXCNX = { 32 | n } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ PROFILE = { SNA | GATE } ] [ RECV = { 2 | n } ] CFTNET TYPE = TCP HOST = { string | INADDR_ANY } ID = { identifier | *identifier } [ CALL = { INOUT | IN | OUT } ] [ CLASS = { 1 | n } ] [ MAXCNX = { 32 | n } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ SRCHOST= { hostname1 | n} ] [ SRCPORTS= (string, string, ...string) ] PROTOCOL = GENERIC HOST = string ID = identifier INET = identifier PORT = n [ CALL = { INOUT | IN | OUT } ] [ CLASS = { 1 | n } ] [ MAXCNX = { 32 | n } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ LOWPORT = { 5000 |n } ] [ HIGHPORT = { 65535 |n } ] [ PARM = string ] [ SRCHOST= { hostname1 | n} ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-8

PROTOCOL = SOCKS4 HOST = string ID = identifier INET = identifier PORT = n [ CALL = { INOUT | IN | OUT } ] [ CLASS = { 1 | n } ] [ HIGHPORT = { 65535 |n } ] [ LOWPORT = { 5000 |n } ] [ MAXCNX = { 32 | n } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ SRCHOST= { hostname1 | n} ] [ USER = string ] CFTNET TYPE = X25 ID = identifier [ ADDR = string ] [ AX25MBX = string ] [ AX25NODE = string ] [ CALL = { INOUT | IN | OUT } ] [ CLASS = { 1 | n } ] [ COMMENT = string ] [ CTLR = string ] [ LINEID = string ] [ MAXLCH = n ] [ MINLCH = n ] [ NETPFX = string ] [ NETPGM = string ] [ PACKETSZ = { 128 |n } ] [ PACKETW = { 3 | n } ] [ PROFILE = { X25 | RNIS } ] [ MAXCNX = { 32 | n } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ SPEED = { 9600 | n } ] [ SRCHOST= { hostname1 | n} ]

CFTPARM
Paramtres gnraux de l'environnement du moniteur. CAT = identifier COM = ( identifier , identifier , ...) ID = identifier KEY = {string | #filename } NET = ( identifier , identifier ,...) PART = identifier PARTFNAM = filename PROT = ( identifier , identifier , ...) [ ACCNT = identifier ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-9

[ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [

BUFSIZE = { 4096 | n } ] COMMENT = string ] CRONTABS = (crontab, crontab, ) ] DEFAULT = { DEFAUT | identifier } ] EXECRE = filename ] EXECRF = filename ] EXECRM = filename ] EXECSE = filename ] EXECSF = filename ] EXECSFA = filename ] EXECSM = filename ] EXECSMA = filename ] EXITEOT = identifier ] FBUFSIZE = { 0 |65535 } ] LENAPPL = { 32 | 1 } ] LOG = identifier ] MAXTASK = { 1 | n } ] MAXTRANS = { 128 | 1 } ] MODE = { REPLACE | CREATE | DELETE } ] NPART = string ] PKIFNAME = string ] PKIPASSW = { PKIPASSW | string } ] RCVALLER = { STOP | CONTINUE } ] SECFNAME = filename ] SSLMTASK = { 1 | n } ] SSLTTASK = {128 | n } ] SSLWTASK = { 1441 |n } ] SSLWRESP = { 60 | n } ] TRACE = string ] TRANTASK = { 1 | n } ] TRKPART = { UNDEFINED | ALL | SUMMARY | NO } ] TRKRECV = { UNDEFINED | ALL | SUMMARY | NO } ] TRKSEND = { UNDEFINED | ALL | SUMMARY | NO } ] USERCTRL = { NO | YES } ] WAITRESP = { 60 | n } ] WAITTASK = { 1441 | n } ]

CFTPART ID = identifier
Dfinition des paramtres du partenaire. PROT = { (identifier | mask , identifier | mask , .... ) } [ COMMENT = string ] [ COMMUT = { YES | NO | SERVER } ] [ CTRLPART = { IGNORE | ALL | RPART | SPART } ] [ FPREFIX = string ] [ GROUP = identifier ] [ IDF = identifier ] [ IMAXTIME = { 23595999 | time } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-10

[ IMINTIME = { 0 | time } ] [ IPART = identifier ] [ MODE = { REPLACE | CREATE | DELETE } ] [ NRPART = string ] [ NRPASSW = string ] [ NSPART = string ] [ NSPASSW = string ] [ OMAXTIME = { 23595999 | time } ] [ OMINTIME = { 0 | time } ] [ RAUTH = { * | identifier } ] [ SAP = (string, string, ) ] [ SAUTH = { * | identifier } ] [ SSL = identifier ] [ STATE = {ACTIVEBOTH | ACTIVEREQ | ACTIVESERV | NOACTIVE } ] [ SYST = { ‘‘ | GCOS7 | GCOS8 | GUARD | MSDOS | MVS | NETW | OS2 | OS400 | UNIX | VM | VMS | VOS | VSE | WINNT | WIN3X | WIN95 | BS2000 } ] [ TRK = { UNDEFINED | ALL | SUMMARY | NO } ] [ XLATE = identifier ]

CFTPROT
Protocole de transfert. CFTPROT TYPE = ETEBAC ID = identifier NET = identifier [ COMMENT = string ] [ DISCTD = { 20 | n } ] [ DISCTS = { 65 | n } ] [ DYNAM = identifier ] [ EXITA = string ] [ EXITE = identifier ] [ IDF = string ] [ MODE = { REPLACE | CREATE | DELETE } ] [ RCOMP = cpr ] [ RESTART = { 5 | n } ] [ RRUSIZE = { 4056 | n } ] [ REVERSE = { YES | NO } ] [ RTO = { 260 | n } ] [ SAP = string ] [ SCOMP = cpr ] [ SRIN = { BOTH | NONE | RECEIVER | SENDER } ] [ SROUT = { BOTH | NONE | RECEIVER | SENDER } ] [ SRUSIZE = { 4056 | n } ] [ SSL = identifier ] [ VERSION = { 1 | 2 } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-11

CFTPROT TYPE = ODETTE ID = identifier NET = identifier [ DISCTD = { 20 | n } ] [ DISCTS = { 65 | n } ] [ DYNAM = identifier ] [ EERP = { 91 | 86 } ] [ EXITA = identifier ] [ IDF = string ] [ MODE = { REPLACE | CREATE | DELETE } ] [ PAD = { NO | YES } ] [ RCOMP = { 0 | 1 } ] [ RCREDIT = { 4 | n } ] [ RESTART = { 5 | n } ] [ RESYNC = { NO | YES } ] [ REVERSE = { YES | NO } ] [ RRUSIZE = { 2048 | n } ] [ RTO = { 260 | n } ] [ SAP = string ] [ SCOMP = { 0 | 1 } ] [ SCREDIT = { 4 | n } ] [ SRIN = { BOTH | NONE | RECEIVER | SENDER } ] [ SROUT = { BOTH | NONE | RECEIVER | SENDER } ] [ SRUSIZE = { 2048 | n } ] [ SSL = identifier ] [ TCP = { CFT | OFTP} ] CFTPROT TYPE = PESIT PROF = ANY ID = identifier NET = identifier [ CONCAT = { NO | YES } ] [ DISCTC = { 90 | n } ] [ DISCTD = { 120 | n } ] [ DISCTR = { 45 | n } ] [ DISCTS = { 165 |n } ] [ DYNAM = identifier ] [ EXITA = identifier ] [ HIDE99 = { NO | YES } ] [ IDF = string ] [ LOGON = { YES | NO } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ MULTART = { NO | YES } ] [ PAD = { NO | YES } ] [ RCHKW = { 2 | n } ] [ RCOMP = { 10 |cpr } ] [ RESTART = { 5 | n } ] [ RESYNC = { NO | YES } ] [ REVERSE = { NO | YES } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-12

[ [ [ [ [ [ [ [ [ [ [ [ [

RPACING = { 36 | n } ] RRUSIZE = { 4056 |n } ] RTO = { 260 | n } ] SAP = string ] SCHKW = { 2 | n } ] SCOMP = { 10 | cpr } ] SEGMENT = { NO | YES } ] SPACING = { 36 | n } ] SRIN = { BOTH | NONE | RECEIVER | SENDER } ] SROUT = { BOTH | NONE | RECEIVER | SENDER } ] SRUSIZE = { 4056 | n } ] SSERV = { PESIT | string } ] SSL = identifier ]

CFTPROT TYPE = PESIT PROF = CFT ID = identifier NET = identifier [ CONCAT = { NO | YES } ] [ DISCTC = { 90 | n } ] [ DISCTD = { 20 | n } ] [ DISCTR = { 45 | n } ] [ DISCTS = { 65 | n } ] [ DYNAM = identifier ] [ EXITA = identifier ] [ HIDE99 = { NO |YES } ] [ IDF = string ] [ MODE = { REPLACE | CREATE | DELETE } ] [ MULTART = { NO | YES } ] [ PAD = { NO | YES } ] [ RCHKW = { 2 | n } ] [ RCOMP = { 15 | cpr } ] [ RESTART = { 5 | n } ] [ RESYNC = { NO | YES } ] [ REVERSE = { NO | YES } ] [ RPACING = { 36 | n } ] [ RRUSIZE = { 4056 | n } ] [ RSERV = string ] [ RTO = { 260 | n } ] [ SAP = string ] [ SCHKW = { 2 | n } ] [ SCOMP = { 15 | cpr } ] [ SEGMENT = { NO | YES } ] [ SPACING = { 36 | n } ] [ SRIN = { BOTH | NONE | RECEIVER | SENDER } ] [ SROUT = { BOTH | NONE | RECEIVER | SENDER } ] [ SRUSIZE = { 4056 |n } ] [ SSERV = { CFTPSITX | string } ] [ SSL = identifier ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-13

CFTPROT TYPE = PESIT PROF = EXTERN ID = identifier NET = identifier [ CONCAT = { NO | YES } ] [ DISCTC = { 90 | n } ] [ DISCTD = { 120 | n } ] [ DISCTR = { 45 | n } ] [ DISCTS = { 165 | n } ] [ DYNAM = identifier ] [ EXITA = identifier ] [ HIDE99 = { NO |YES } ] [ IDF = string ] [ MODE = { REPLACE | CREATE | DELETE } ] [ LOGON = { YES | NO } ] [ MULTART = { NO | YES } ] [ RCHKW = { 2 | n } ] [ RCOMP = { 10 | n } ] [ RESTART = { 5 | n } ] [ RESYNC = { NO | YES } ] [ REVERSE = { YES | NO } ] [ RPACING = { 36 | n } ] [ RRUSIZE = { 4056 | n } ] [ RTO = { 260 | n } ] [ SAP = string ] [ SCHKW = { 2 | n } ] [ SCOMP = { 10 | n } ] [ SEGMENT = { NO | YES } ] [ SPACING = { 36 | n } ] [ SRIN = { BOTH | NONE | RECEIVER | SENDER } ] [ SROUT = { BOTH | NONE | RECEIVER | SENDER } ] [ SRUSIZE = { 4056 | n } ] [ SSERV = { PESIT | string } ] [ SSL = identifier ] CFTPROT TYPE = PESIT PROF = SIT ID = identifier NET = identifier [ CONCAT = { NO | YES } ] [ DISCTC = { 90 | n } ] [ DISCTD = { 240 | n } ] [ DISCTR = { 45 | n } ] [ DISCTS = { 285 | n } ] [ DYNAM = identifier ] [ EXITA = identifier ] [ IDF = string ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-14

[ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [

MODE = { REPLACE | CREATE | DELETE } ] MULTART = { NO | YES } ] RCHKW = { 2 | n } ] RCOMP = { 0 | n } ] RESTART = { 5 | n } ] RESYNC = { NO | YES } ] REVERSE = { NO | string } ] RPACING = { 36 | n } ] RRUSIZE = { 4050 | n } ] RTO = { 260 | n } ] SAP = string ] SCHKW = { 2 | n } ] SCOMP = { 0 | n } ] SEGMENT = { NO | YES } ] SPACING = { 36 | n } ] SRIN = { BOTH | NONE | RECEIVER | SENDER } ] SROUT = { BOTH | NONE | RECEIVER | SENDER } ] SRUSIZE = { 4050 | n } ] SSL = identifier ]

CFTPROT TYPE = PESIT PROF = DMZ ID = identifier NET = identifier [ CONCAT = { NO | YES } ] [ CTO = { 1 | n } ] [ CYCLE = { 10 | n } ] [ DISCTC = { 90 | n } ] [ DISCTD = { 120 | n } ] [ DISCTR = { 45 | n } ] [ DISCTS = { 65 | n } ] [ DYNAM = identifier ] [ EXITA = identifier ] [ IDF = string ] [ LOGON = { YES | NO } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ MULTART = { NO | YES } ] [ PAD = { NO | YES } ] [ PART = ( identifier, identifier, ) ] [ RCHKW = { 2 | n } ] [ RCOMP = { 10 | cpr } ] [ RESTART = { 5 | n } ] [ RESYNC = { NO | YES } ] [ REVERSE = { NO | YES } ] [ RPACING = { 36 | n } ] [ RRUSIZE = n ] [ RTO = { 260 | n } ] [ SAP = string ] [ SCHKW = { 2 | n } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-15

[ [ [ [ [ [ [ [

SCOMP = { 10 | cpr } ] SEGMENT = { NO | YES } ] SPACING = { 36 | n }] SRIN = { BOTH | NONE | RECEIVER | SENDER } ] SROUT = { BOTH | NONE | RECEIVER | SENDER } ] SSERV = { PESIT | string } ] SSL = identifier ] TURN = { FILE | MESSAGE } ]

CFTRECV ID= identifier


Description des paramtres de rception de fichier type. [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ COMMENT = string ] CYCDATE = { 0 | date } ] CYCTIME = { 0 | time } ] DELETE = { NO | YES } ] DIRNB = { 0 | n } ] EXEC = filename ] EXIT = identifier ] FACC = { ‘ ‘ | character } ] FACTION = { ‘ ‘ |DELETE | ERASE | VERIFY | CONCAT } ] FBLKSIZE = { 0 | n } ] FCHECK = { NO | YES } ] FCODE = { ‘ ‘ |BINARY | EBCDIC | ASCII } ] FDB = filename ] FDISP = { BOTH | NEW | OLD } ] FKEYLEN = { 0 | n } ] FKEYPOS = { 0 | n } ] FLRECL = { 0 | n } ] FNAME = filename ] FORCE = { NO | YES } ] FORG = { SEQ | DIRECT | INDEXED | PART } ] FRECFM = { ‘ ‘ |F | V | U } ] FSPACE = { 0 | n } ] FTYPE = { ‘ ‘ | character } ] GROUPID = string ] MACTION = { ' ' | REPLACE } ] MAXDATE = { 99991231 | date } ] MAXTIME = { 23595999 | time } ] MINDATE = { 10000101 | date } ] MINTIME = { 0 | time } ] MODE = { REPLACE | CREATE | DELETE } ] NCOMP = { 0 | 15 } ] NETBAND = { 1...16} ] NOTIFY = string ] OPERMSG = { 0 | 255 } ] PRI = { 128 | n } ] RAPPL = string ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-16

[ [ [ [ [ [ [ [ [

RKERROR = { ' ' | DELETE | KEEP } ] RUSER = string ] SAPPL = string ] STATE = { DISP | HOLD | KEEP } ] SUSER = string ] TRK = { UNDEFINED | ALL | SUMMARY | NO } ] USERID = { CFT server"userid" | string } ] WFNAME = filename ] XLATE = identifier ]

CFTSEND ID= identifier


Description des paramtres d'mission de fichier type. [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ ] [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ COMMENT = string ] CYCDATE = { 0 | date } ] CYCLE = { 0 | n } ] CYCTIME = { 0 | time } ] DELETE = { NO | YES } ] EXEC = filename ] EXECSUB = { LIST | FILE } ] EXIT = identifier ] FACC = { ‘ ‘ | character } ] FACTION = { NONE | DELETE | ERASE | ROTATE} ] FBLKSIZE = { 0 | n } ] FCODE = { ‘ ‘ |ASCII | BINARY | EBCDIC } ] FCOMP = { 0 | 15 } ] FDB = filename ] FDISP = { SHR | OLD | CHECK } ] FKEYLEN = { 0 | n } ] FKEYPOS = { 0 | n } ] FLRECL = { 0 | n } ] FNAME = { filename | mask | dirname | #filename | #mask | #dirname } FORCE = { NO | YES } ] FORG = { SEQ | DIRECT | INDEXED | PART } ] FRECFM = { ‘ ‘ | F | U | V } ] FSPACE = { 0 | n } ] FTYPE = { ‘ ‘ | character } ] GROUPID = string ] IMPL = { NO | YES } ] LOCMBX = string ] MAXDATE = { 99991231 | date } ] MAXTIME = { 23595999 | time } ] MINDATE = { 10000101| date } ] MINTIME = { 0 | time } ] MODE = { REPLACE | CREATE | DELETE } ] NBLKSIZE = { 0 | n } ] NCODE = { ‘ ‘ |ASCII | BINARY | EBCDIC } ] NCOMP = { 0 | 15 } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-17

[ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [

NETBAND = { 1...16} ] NFNAME = { filename | *filename } ] NKEYLEN = { 0 | n } ] NKEYPOS = { 0| n } ] NLRECL = { 0 | n } ] NOTIFY = string ] NRECFM = { ‘ ‘ | F | U | V } ] NSPACE = { 0 | n } ] NTYPE = character ] OPERMSG = { 0 | 255 } ] PARM = string ] PRI = { 128 | n } ] RAPPL = string ] RUSER = string ] SAPPL = string ] SELFNAME = filename ] SPART = string ] STATE = { DISP | HOLD | KEEP } ] SUSER = string ] TCYCLE = { DAY | MIN | MONTH } ] TRK = { UNDEFINED | ALL | SUMMARY | NO } ] USERID = { CFT server "userid" | string } ] WFNAME = filename ] XLATE = identifier ]

CFTSNA ID = identifier
Paramtres rseau d'un partenaire SNA. LUNAME = string [ CLASS = { 1 | n } ] [ COMMENT = string ] [ CNXIN = { 2 | n } ] [ CNXINOUT = { 2 | n } ] [ CNXOUT = { 2 | n } ] [ DATA = string ] [ IMAXTIME = { 23595999 | time } ] [ IMINTIME = { 0 | time } ] [ LOGMODE = string ] [ MODE = { REPLACE | CREATE | DELETE } ] [ OMAXTIME = { 23595999 | time } ] [ OMINTIME = { 0 | time } ] [ RETRYM = { 12 | n } ] [ RETRYN = { 6 | n } ] [ RETRYW = { 7 | n } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-18

CFTSSL ID = identifier
Fichiers de scurit. CIPHLIST = ( number, number, ) DIRECT = { CLIENT | SERVER } [ CACHE = { NO | YES } ] [ CERFNAME = string ] [ COMMENT = string ] [ DEPTH = { 10 | n } ] [ DNISSUER = ( string, string, ) ] [ DNUSER = { ( string, string, ) | ( string, *OP, string ) } ] [ INTERCID = string ] [ KEYEXT = { VERIFY | NONE } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ PARM = string ] [ ROOTCID = ( string, string, ) ] [ TRACE = { 0 | n } ] [ USERCID = string ] [ VERIFY = { REQUIRED | OPTIONAL } ] [ VERSION = { TLSV1 | SSLV3 } ] Remarque : *OP Vous pouvez configurer CFT pour accepter ou rejeter les connexions SSL sur la base des oprateurs logiques utiliss avec le DN du certificat. Pour plus d'informations, voir la description dtaille du paramtre dnuser.

CFTTCP
Paramtres rseau d'un partenaire TCP/IP. HOST = string ID = identifier [ CLASS = { 1 | n } ] [ CNXIN = { 2 | n } ] [ CNXINOUT = { 2 | n } ] [ CNXOUT = { 2 | n } ] [ IMAXTIME = { 23595999 | time } ] [ IMINTIME = { 0 | time } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ OMAXTIME = { 23595999 | time } ] [ OMINTIME = { 0 | time } ] [ RETRYM = { 12 | n } ] [ RETRYN = { 6 | n } ] [ RETRYW = { 7 | n } ] [ VERIFY = { 0 | n } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-19

CFTXLATE FNAME = filename


Table de traduction utilise pendant un transfert. ID = identifier [ COMMENT = string ] [ DIRECT = { BOTH | RECV | SEND } ] [ FCODE = { ' ' | ASCII | EBCDIC } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ NCODE = { ' ' | ASCII | EBCDIC } ]

CFTX25 DIALNO = (n , n , ... )


Paramtres rseau d'un partenaire X25. ID = identifier [ CLASS = { 1 | n } ] [ CNXIN = { 2 | n } ] [ CNXINOUT = { 2 | n } ] [ CNXOUT = { 2 | n } ] [ COMMENT = string ] [ DATA = string ] [ FACILITY = string ] [ GFA = string ] [ IMAXTIME = { 23595999 | time } ] [ IMINTIME = { 0 | time } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ OMAXTIME = { 23595999 | time } ] [ OMINTIME = { 0 | time } ] [ PCVI = { YES | NO } ] [ PCVO = { NO |YES } ] [ RETRYM = { 12 | n } ] [ RETRYN = { 6 | n } ] [ RETRYW = { 7 | n } ] [ SPEED = { 0 | n } ] [ VERIFY = { 0 | n } ]

CLEARCMD COMMAND = string


Supprime une demande de transfert. USERID = string INDEX = number

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-20

CONFIG
Dsignation du mdia de communication et des fichiers auxquels accde CFTUTIL. CONFIG TYPE = { CAT | INPUT | OUTPUT | PARM | PART } FNAME = filename CONFIG TYPE = COM MEDIACOM = FILE FNAME = filename CONFIG TYPE = COM MEDIACOM = MBX FNAME = string CONFIG TYPE = COM MEDIACOM = TCPIP FNAME = string [ HIGHPORT = { 65535 | n } ] [ LOWPORT = { 5000 | n } ] [ PROXY = string ] [ ROOTCERT = string ] [ TIMEOUT = 60 | n ]

COPYFILE IFNAME = filename


Copie des fichiers avec une option de compression ou de dcompression hors ligne. OFNAME = filename [ CREATE = { ‘ ‘ | YES | NO [ IBLKSIZE = { 0 | n } ] [ ICODE = { ASCII | EBCDIC } ] [ ICOMP = { 0 | n } ] [ ICT = { H | C } ] [ ILRECL = { 0 | n } ] [ IRECFM = { F | V | U } ] [ ITYPE = { ‘ ‘ | character [ OBLKSIZE = { 0 |n } ] [ OCODE = { ASCII | EBCDIC } ] [ OCOMP = { 0 | 15 } ] [ OCT = { H | C } ] [ OLRECL = { 0 |n } ] [ ORECFM = { valeur IRECFM | F | V| U } [ OSPACE = { 0 | n } ] [ OTYPE = { ‘ ‘ | character } ]

} ]

] } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-21

DELETE PART = { identifier | mask }


Supprime un poste catalogue. [ [ [ [ [ [ [ [ BLKNUM = { 0 | n } ] DIRECT = { BOTH | RECV | SEND } ] FORCE = { YES | NO } ] IDA = identifier ] IDF = identifier ] IDT = { * | transid } ] IDTU = string ] STATE = { * | C | D | H | K | T | X } ]

DISPLAY [ CONTENT = { listcat | identifier }]


Rpertorie les modles XML personnaliss qui mettent en forme l'affichage de la sortie. [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ DIRECT = { BOTH | RECV | SEND } ] EMPTY = { ANY | string } ] FILE = filename ] FMODEL = string ] HELP = { NONE | FIELDS | MODELS | COMMAND } ] IDA = string ] IDF = string ] IDT = string ] IDTU = string ] MODE = { ANY | COLUMN | LINE } ] NA = { ANY | string } ] NPART = string ] PART = string ] STATE = { * | character } ] TYPE = { * | FILE | MESSAGE | REPLY | ALL } ]

END PART = { identifier | mask }


Dfinit un transfert termin. [ [ [ [ [ [ [ [ BLKNUM = { 0 | n } ] DIRECT = { BOTH | RECV | SEND } ] FORCE = { NO | YES } ] IDA = identifier ] IDF = identifier ] IDT = { * | transid } ] IDTU = string ] STATE = string ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-22

HALT PART = { identifier | mask }


Arrte immdiatement le transfert. [ [ [ [ [ [ [ BLKNUM = { 0 | n } ] DIRECT = { BOTH | RECV | SEND } ] FORCE = { YES | NO } ] IDA = identifier ] IDF = identifier ] IDT = { * | transid } ] IDTU = string ]

INACT ID = identifier
Dsactivation des partenaires. [ MODE = { BOTH | REQUESTER| SERVER } ] [ FORCE = { NO | YES } ] [ TYPE = PART | TRK | ]

KEEP PART = { identifier | mask }


Interrompt le transfert. [ [ [ [ [ [ [ [ BLKNUM = 0 | n ] DIRECT = { BOTH | RECV | SEND } ] FORCE = { YES | NO } ] IDA = identifier ] IDF = identifier ] IDT = { * | transid } ] IDTU = string ] STATE = string ]

KSTATE IDF = identifier


Interrompt un transfert. IDTU = identifiant du compteur de transfert local PART = identifiant du partenaire

LISTCAT TYPE = { ALL | FILE | MESSAGE | REPLY }


Rpertorie les postes catalogue. [ [ [ [ [ [ [ [ CONTENT = { BRIEF | FULL | DEBUG | EXTEND | COMMUT | STAT } ] DIRECT = { BOTH | RECV | SEND } ] FILE = filename ] IDA = { * | identifier } ] IDF = { * | identifier } ] IDT = { * | transid } ] IDTU = string ] NPART = { identifier | mask } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-23

[ PART = { * | identifier | mask } ] [ STATE = { * | string } ]

LISTCOM
Rpertorie le contenu d'un mdia de communication. [ [ [ [ [ CONTENT = { ACTIVE | FULL } ] FILE = filename ] FIRST = { 0 | n } ] LAST = { 0 | nombre max. d'enregistrements } ] VERIFY = { NO | YES } ]

LISTPARM
Rpertorie les paramtres de CFT. [ ID = { * | identifier } ] [ CONTENT = { FULL | BRIEF } ] [ PART = identifier ] [ TYPE = { ACCNT | ALL | APPL | AUTH | CAT | COM | CRON | EXIT | IDF | LOG | NET | PARM | PROT | RECV | SEND | SSL | XLATE } ]

LISTPART
Rpertorie les partenaires. [ ID = { * |identifier } ] [ CONTENT = { FULL | BRIEF } ] [ TYPE = { ALL | DEST | DNA | LU62 | PART | SNA | TCP | X25 } ]

MQUERY
Dtermine l'heure de l'action suivante. [ [ [ [ OBJECT = { CACHE | SYSTEM } ] CMD = string ] CONTENT = { BRIEF | FULL | STAT } ] NAME = { CAT | COMMAND | CRON | DMZ | STAT } ]

PURGE
Supprime des enregistrements du catalogue. [ TIMEP = { 23595999 | time } ]

RECONFIG
Recharge la table CRON de CFT. [ TYPE = { CRON } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-24

RECV IDF = { identifier | mask }


Requte de transfert en rception. PART = identifier [ APPCYCID = string ] [ APPOBJID = string ] [ COMMENT = string ] [ CYCDATE = date ] [ CYCLE = { 0 | n } ] [ CYCTIME = time ] [ DIRNB = n ] [ EXEC = filename ] [ EXIT = identifier ] [ FACC = { ‘ ‘ | character } ] [ FACTION = { ‘ ‘ |CONCAT | DELETE | ERASE | VERIFY } ] [ FBLKSIZE = n ] [ FCODE = { BINARY | EBCDIC | ASCII } ] [ FCOMP = { 0 | n } ] [ FDATE = { 0 | date } ] [ FDB = filename ] [ FDISP = { BOTH | NEW | OLD } ] [ FILE = { FIRST | ALL } ] [ FKEYLEN = { 0 | n } ] [ FKEYPOS = { 0 | n } ] [ FLRECL = n ] [ FNAME = filename ] [ FORG = { SEQ | DIRECT | INDEXED | PART } ] [ FRECFM = { ‘ ‘ | F | V | U } ] [ FSPACE = n ] [ FTIME = { 0 | time } ] [ FTYPE = { ‘ ‘ | character } ] [ IDA = identifier ] [ MACTION = { ' ' | REPLACE } ] [ MAXDATE = { 99991231 | date } ] [ MAXTIME = { 23595999 | time } ] [ MINDATE = { current system date | date } ] [ MINTIME = { 0 | time } ] [ MODE = { REPLACE | CREATE | DELETE } ] [ NCOMP = { 0 | n } ] [ NETBAND = { 1...16} ] [ NFNAME = filename ] [ NFVER = { 0 | 255 } ] [ NIDF = string ] [ PARM = string ] [ PRI = { 128 | n } ] [ RAPPL = string ] [ RUSER = string ] [ SAPPL = string ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-25

[ [ [ [ [ [

STATE = { DISP | HOLD | KEEP } ] SUSER = string ] TCYCLE = { DAY | MIN | MONTH } ] TRK = { UNDEFINED | ALL | SUMMARY | NO } ] WFNAME = filename ] XLATE = identifier ]

RESUME
Rcupre, en mode serveur, une demande d'mission groupe. PART = string [ DIRECT = { SEND |RECV | BOTH } ] [ BLKNUM = { 0 | n } ] [ FORCE = { NO | YES } ] [ IDA = string ] [ IDF = string ] [ IDT = string ] [ IDTU = string ] [ STATE = string ]

SEND
Requte de transfert en mission. TYPE = FILE IDF = identifier PART = identifier [ APPCYCID = string ] [ APPOBJID = string ] [ COMMENT = string ] [ CYCDATE = date ] [ CYCLE = { 0 | n } ] [ CYCTIME = time ] [ EXEC = filename ] [ EXECSUB = { LIST | FILE } ] [ EXIT = identifier ] [ FACC = { ‘ ‘ | character } ] [ FACTION = { NONE | DELETE | ERASE | ROTATE } ] [ FBLKSIZE = n ] [ FCODE = { ASCII | BINARY | EBCDIC } ] [ FDATE = date ] [ FDB = filename ] [ FDISP = { SHR | OLD | CHECK } ] [ FKEYLEN = { 0 | n } ] [ FKEYPOS = { 0 | n } ] [ FLRECL = n ] [ FNAME = { filename | mask | dirname | #filename | #mask | #dirname } ] [ FNAMEABS = { YES | NO } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-26

[ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [

FORG = { SEQ | DIRECT | INDEXED } ] FRECFM = { ‘ ‘ | F | U | V FSPACE = n ] FTIME = time ] FTYPE = { ‘ ‘ | character IDA = identifier ] IPART = identifier ] MAXDATE = { 99991231 | date } ] MAXTIME = { 23595999 | time } ] MINDATE = { current system date | date MINTIME = { 0 | time } ] NBLKSIZE = n ] NCODE = { ASCII | BINARY | EBCDIC } ] NCOMP = { 0 | n } ] NETBAND = { 1...16} ] NFNAME = filename ] NIDF = string ] NKEYLEN = { 0 | n } ] NKEYPOS = { 0 | n }] NLRECL = n ] NRECFM = { ‘ ‘ | F | U | V NSPACE = { FSPACE value | n } ] NTYPE = { ' ' | character } ] PARM = string ] PRI = { 128 | n } ] RAPPL = string ] RUSER = string ] SAPPL = string ] SELFNAME = filename ] SPART = identifier ] STATE = { DISP | HOLD | KEEP } ] SUSER = string ] TCYCLE = { DAY | MIN | MONTH } ] TRK = { UNDEFINED | ALL | SUMMARY | NO XLATE = identifier ]

} ]

} ]

} ]

} ]

SEND TYPE = MESSAGE IDM = identifier MSG = string PART = identifier [ APPCYCID = string ] [ APPOBJID = string ] [ CYCDATE = date ] [ CYCLE = { 0 | n } ] [ CYCTIME = time ] [ EXEC = filename ] [ IDA = identifier ] [ IPART = identifier ] [ MAXDATE = { 99991231 | date

} ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-27

[ [ [ [ [ [ [ [ [ [ [ [

MAXTIME = { 23595999 | time } ] MINDATE = { current system date | date } ] MINTIME = { 0 | time } ] PRI = pri ] RAPPL = string ] RUSER = string ] SAPPL = string ] SPART = identifier ] STATE = { DISP | HOLD | KEEP } ] SUSER = string ] TCYCLE = { DAY | MIN | MONTH } ] TRK = { UNDEFINED | ALL | SUMMARY | NO } ]

SEND TYPE = REPLY IDM = identifier IDT = transid MSG = string PART = identifier [ APPCYCID = string ] [ APPOBJID = string ] [ CYCDATE = date ] [ CYCTIME = time ] [ IPART = string ] [ MAXDATE = { 99991231 | date } ] [ MAXTIME = { 23595999 | time } ] [ MINDATE = { current system date | date } ] [ MINTIME = { 0 | time } ] [ PRI = pri ] [ RAPPL = string ] [ RUSER = string ] [ SAPPL = string ] [ SUSER = string ] [ TCYCLE = { DAY | MIN | MONTH } ] [ TRK = { UNDEFINED | ALL | SUMMARY | NO } ]

SHUT
Arrte le serveur CFT. [ FAST = { NO | YES | KILL } ]

START
Relance les transferts. PART = { identifier | mask } [ BLKNUM = { 0 | n } ] [ DIRECT = { BOTH | RECV | SEND } ] [ FORCE = YES | NO ] [ IDA = identifier ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-28

[ [ [ [

IDF = identifier ] IDT = { * | transid } ] IDTU = string ] STATE = string ]

SUBMIT
Soumet la procdure de fin de transfert (script). PART = { identifier | mask } [ BLKNUM = { 0 | n } ] [ DIRECT = { BOTH | RECV | SEND } ] [ EXEC = filename ] [ IDA = identifier ] [ IDF = identifier ] [ IDT = { * | transid } ] [ IDTU = string ] [ STATE = T ]

SWAITCAT
Permet d'attendre la mise jour de l'tat d'un transfert. SELECT = expression [ STATES = string ] [ TIMEOUT = integer ]

SWITCH
Bascule manuellement les fichiers LOG ou ACCNT. [ TYPE = { LOG | ACCNT } ]

TURN
Donne la main au moniteur. PART = identifier [ CTO = { 1 | n } ] [ CYCLE = { 10 | n } ] [ MODE = { START | CREATE | ACT | INACT } ] [ TURN = { FILE | MESSAGE } ]

WAIT
Interrompt l'excution de CFTUTIL pendant la dure indique. *Dure en secondes [ DURING = { 0 | n } ] [ TIME = { 0 | 23595999 } ]

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-29

WLOG
Requte d'criture dans le journal. MSG = string

Manuel de rfrence

Liste syntaxique des commandes de CFT

2-30

3 Les variables symboliques

Une variable symbolique reprsente un lment de donnes de transfert dont la valeur n'est pas connue au moment de la dfinition des paramtres de CFT, mais uniquement lors de l'excution du transfert. Par exemple, avant un transfert, l'identifiant de transfert IDT n'est pas connu ; la variable symbolique &IDT peut donc tre utilise pour faire rfrence la valeur. Les variables symboliques peuvent tre utilises dans la dfinition des valeurs de certains paramtres des commandes et fichiers de procdure associs aux transferts. Il est possible d'appliquer une mme commande CFTSEND plusieurs fichiers en utilisant les variables symboliques dans le paramtre FNAME. La vritable valeur du paramtre est substitue la variable symbolique au moment de l'excution.

3.1 Utilisation des variables symboliques


Les variables symboliques peuvent tre utilises : pour assigner une valeur aux paramtres des commandes de paramtrage ou de transfert ; dans les oprations de traitement dfinies par l'utilisateur dans les procdures associes aux transferts.

3.1.1

Syntaxe des variables symboliques


Une variable symbolique utilise la syntaxe suivante : un caractre spcial la premire position (extrme gauche) ; ventuellement, le caractre + ou - pour indiquer que la variable doit tre convertie en majuscules ou en minuscules ; ventuellement, une chane de caractres utiliser comme prfixe (chane_prfixe), d'une chane de caractres utiliser comme suffixe (+chane_suffixe) et/ou d'une chane de caractres utiliser comme valeur de substitution (=autre_chane) ; ventuellement, une formule numrique avec une syntaxe n, p. ou p.n ; enfin, en dernire position, une chane de caractres reprsentant l'identifiant de la variable remplacer. Le caractre spcial utilis dans ce document est le caractre &. Pour dterminer quel est le caractre spcial <char_symb> utilis par votre systme, reportez-vous au Guide d'exploitation CFT correspondant votre systme d'exploitation. Les identifiants qui peuvent tre utiliss dans la syntaxe d'une variable symbolique sont indiqus dans la liste des variables symboliques ci-aprs. Dans cette section, la notation VAR a t adopte pour dsigner un identifiant. Le mcanisme de substitution employ pour attribuer une valeur la variable symbolique en utilisant la valeur de l'identifiant VAR dpend de la formule qui apparat aprs le caractre &.

Manuel de rfrence

Les variables symboliques

3-1

3.1.2

Liste des variables symboliques


Le tableau suivant rpertorie toutes les variables symboliques disponibles en utilisant la syntaxe &VAR.
Domaine PARTNERS Variable symbolique &CFTNAME &PART &GROUP &GROUPID &SPART &RPART &IPART &NPART Valeur de substitution correspondante Nom du CFT (PART pour CFTPARM) Nom du partenaire (ID de CFTPART) Groupe auquel le partenaire appartient Identifiant de groupe local Nom du partenaire metteur Nom du partenaire rcepteur Nom du partenaire intermdiaire Nom rseau du partenaire qui met les donnes (NSPART ou NRPART selon la direction du transfert) Nom de l'utilisateur metteur Nom de l'utilisateur rcepteur Identifiant de l'utilisateur local Commentaire indiqu dans CFTSEND/SEND ou CFTRECV/RECV Utilisateur notifi lors du transfer Nom de l'application mettrice Nom de l'application rceptrice Identifiant d'application Paramtre Contenu P199 (protocole PeSIT E) Identifiant de transfert Identifiant de protocole de transfert Compteur de transfert local Compteur pour la soumission des procdures de fin de transfert, des procdures d'erreur et des procdures soumises par SUBMIT. Ce compteur a une longueur de 4 caractres ; il est donc r-initialis 1 aprs 9999 Valeur du code de diagnostic interne Valeur du code de diagnostic de protocole

USER

&SUSER &RUSER &USERID &COMMENT &NOTIFY

APPLICATIONS

&SAPPL &RAPPL &IDA &PARM &PI99

TRANSFER

&IDT &NIDT &IDTU &NSUB

&DIAGI &DIAGP

Manuel de rfrence

Les variables symboliques

3-2

Domaine

Variable symbolique &COMP &NBT &PRI &QQ &SELFNAME &FCODE &TRTYPE &NCODE

Valeur de substitution correspondante Compression ngocie pour le transfert Nombre d'octets transfrs Priorit de CFT pour le transfert (de 0 255) Numro du jour de l'anne associ l'identifiant de transfert Nom du fichier de slection de transfert gnrique Code pour les donnes dans le fichier de rception Disponible la fin du transfert pour dsigner FILE, MESSAGE ou REPLY Code pour les donnes envoyes sur le rseau Identifiant de fichier type (nom logique) Nom local de fichier physique Longueur (reue) de la cl du fichier index sur le site de l'metteur Position (reue) de la cl du fichier index sur le site de l'metteur Nom de volume du fichier physique (unit) Classe d'unit de fichier physique Nombre d'enregistrements du fichier Numro de bloc du catalogue Identifiant de la table de transcodage utilise Identifiant rseau de fichier type Nom rseau de fichier physique Nom de disque Racine (nom de fichier rel) du fichier metteur Prfixe (chemin de fichier) du fichier metteur Suffixe associ au nom de fichier du fichier metteur Nom de la base de donnes VFM Nombre d'octets de fichier transfrs Chemin local du fichier reu

FILE

&IDF &FNAME &FKEYLEN &FKEYPOS &UNIT &UNITC &NBR &BLKNUM &XLATE &NIDF &NFNAME &FUNIT &FUNITC &FROOT &FPATH &FSUF &FDB &NBC &PATH

Manuel de rfrence

Les variables symboliques

3-3

Domaine

Variable symbolique &ROOT &SUF

Valeur de substitution correspondante Racine locale pour le fichier reu Suffixe de fichier local pour le fichier reu Identifiant de message Texte de message Date associe au fichier Heure associe au fichier Anne associe au fichier Mois associ au fichier Jour associ au fichier Date d'entre du catalogue Heure d'entre du catalogue Anne d'entre du catalogue Mois d'entre du catalogue Jour d'entre du catalogue Date de dbut du transfert Heure de dbut du transfert Anne de dbut du transfert Mois de dbut du transfert Jour de dbut du transfert Date de fin du transfert Heure de fin du transfert Anne de fin du transfert Mois de fin du transfert Jour de fin du transfert Longueur du transfert (en secondes) Type de travail soumis par CFT Nom du dernier fichier journal utilis par CFT Nom du dernier fichier de statistiques utilis par CFT Nom du catalogue utilis par CFT

MESSAGES

&IDM &MSG

DATE et HEURE associes un FICHIER

&FDATE &FTIME &FYEAR &FMONTH &FDAY

DATE et HEURE associes un CATALOGUE

&CDATE &CTIME &CYEAR &CMONTH &CDAY

DATE et HEURE associes un TRANSFERT

&BDATE &BTIME &BYEAR &BMONTH &BDAY &EDATE &ETIME &EYEAR &EMONTH &EDAY &TT

SORTIE DE CONTRLE

&CFTEVENT &FLOG &FACCNT &FCAT

Manuel de rfrence

Les variables symboliques

3-4

Domaine SUIVI (disponible uniquement pour la version 2.3.1) SSL

Variable symbolique &XFRCYCID &XFROBJID &SSL

Valeur de substitution correspondante Identifiant de cycle de traitement (ensemble d'instances suivies concernant un seul transfert) Nom d'objet suivi Indique si la session pendant laquelle le transfert a eu lieu tait scurise (1) ou non (0) Mode de la session SSL pendant laquelle le transfert a eu lieu Rgle d'authentification (A : Anonyme / S : Serveur / B : Les deux) Squence de chiffrement SSL Identifiant de profil SSL Paramtre Parm du paramtre utilisateur SSL de la commande CFTSSL Identifiant du certificat de l'autorit qui a sign le certificat prsent par le partenaire distant Champ CN (Common Name) du certificat de l'utilisateur distant Identifiant du certificat d'utilisateur utilis localement pour l'authentification par le partenaire distant Nom physique du fichier dans lequel la chane du certificat prsente par l'utilisateur distant a t enregistre Date systme Heure systme Numro du jour de l'anne associ la date systme Jour de la semaine (dimanche = 0, 6 = samedi) Nom du CFT (paramtre CFTPARM PART) Type de travail soumis par CFT

&SSLMODE

&SSLAUTH &SSLCIPH &SSLPROF &SSLPARM &SSLRMCA

&SSLRMCN &SSLUSER

&SSLCFNAM

SYSTEME

&SYSDATE &SYSTIME &SYSQQ &SYSDAY

MONITEUR

&CFTNAME &CFTEVENT

Manuel de rfrence

Les variables symboliques

3-5

Remarque : les formats des variables symboliques pour les dates sont les suivants :
o o o o o

Pour Pour Pour Pour Pour

l'heure : HHMMSSCC la date complte : AAAAMMJJ l'anne : AA le mois : MM le jour : JJ

Manuel de rfrence

Les variables symboliques

3-6

4 Les paramtres de CFT

Les paramtres de CFT sont rpertoris dans l'ordre alphabtique l'intrieur de ce chapitre.

4.1 Prsentation
Certains paramtres ont des valeurs diffrentes selon l'objet. Les dfinitions et les valeurs des paramtres sont rpertories par noms d'objet (le cas chant). La rubrique consacre chaque paramtre affiche le format de la ligne de commande, une dfinition, les limitations et les valeurs par dfaut, le cas chant. Exemple :

Acb

paramtre
commande dans laquelle le paramtre est utilis format du paramtre, o la valeur souligne est la valeur par dfaut

CFTNET

[ACB = {ID value for this CFTNET | string}]

La ressource identifie dans la mthode d'accs. La valeur par dfaut est dfinie par la valeur d'identification de l'objet CFTNET. dfinition du paramtre

4.2 Liste des paramtres


acb
CFTNET [ACB = {ID value for this CFTNET|string}] La ressource identifie dans la mthode d'accs. La valeur par dfaut est dfinie par la valeur d'identification de cet objet CFTNET. Utilis lorsque TYPE = SNA

accid
CFTACCNT Utilis lorsque TYPE=SYST ACCID = n Enregistrements des identifiants de fichiers du systme statistique : MVS Valeur par dfaut : 128 ; Cette donne est crite dans SMF. Le programme CFT/MVS doit tre autoris (APF) ; VM La machine virtuelle CFT doit avoir l'option DIRECTORY ACCOUNT ;

Manuel de rfrence

Les paramtres de CFT

4-1

VSE L'option statistique doit tre dfinie dans POWER ; VMS Paramtre non applicable. La valeur par dfaut est 128. Les donnes sont ensuite crites dans SMF. Le programme CFT doit avoir un accs en criture.

accnt
CFTPARM [ACCNT = identifier] Identifiant de la commande de description de l'enregistrement des donnes statistiques des transferts (CFTACCNT).

addr
CFTNET [ADDR = string] string8 string6 N VOS GUARDIAN Sous-adresse commune aux SU (sous-units) rfrences par ce CFTNET Obligatoire. Numro d'extension facultatif pour le suivi des appels entrants.

addrlist
CFTCOM [addrlist = {string 1...64, string 1...64}] Utilisez ce champ pour dfinir une liste des adresses autorises que vous pouvez utiliser pour vous connecter au mdia de communication. Vous pouvez entrer : une liste explicite d'adresses (jusqu' 16 adresses de 1 64 caractres) ; un nom de fichier prcd du caractre # . Ce fichier contient une liste d'adresses. Le nombre d'adresses n'est pas limit. Respectez les rgles suivantes lors de la gnration de ce fichier. TCI/IP uniquement.

afname
CFTLOG AFNAME = filename Nom du fichier journal de substitution. N'utilisez pas de noms logiques. CFTACCNT AFNAME = filename Nom du fichier statistique de substitution.

Manuel de rfrence

Les paramtres de CFT

4-2

appcycid
RECV, SEND [appcycid = string 249] Identifiant. Identifiant de cycle de traitement - ensemble d'instances suivies concernant un seul transfert.

appobjid
SEND, RECV [appobjid = string] Nom d'objet suivi. Dans Synchrony Sentinel, un objet suivi est un objet de base de donnes qui dcrit les vnements de l'application. Ce paramtre peut prendre les valeurs suivantes : XFB.Transfer Cet objet suivi dcrit les transferts des fichiers et messages de CFT ; XFB.Log Cet objet suivi dcrit le contenu des fichiers journaux de CFT.

blknum
DELETE, DISPLAY, HALT, START, RESUME, SUBMIT, KEEP, END [BLKNUM = {0|n}] {0 ... 192000} Numro de bloc. Si les valeurs '*' ou ' ' sont utilises, tous les transferts sont slectionns, quel que soit le bloc auquel ils appartiennent.

bufsize
CFTPARM [BUFSIZE = n] {512..voir ci-dessous} Taille du tampon interne du moniteur utilise pour changer des donnes entre les tches du moniteur, exprime en caractres (octets). Une taille importante favorise les performances, mais utilise davantage de mmoire. Entrez la taille du tampon interne du moniteur utilise pour changer des donnes entre les tches du moniteur : 4096 : valeur par dfaut pour UNIX et Windows ; 36608 : valeur par dfaut pour MVS ; toute autre valeur de : 512 65535 pour Windows ; o 512 65535 pour UNIX ; o 512 65535 pour MVS. Si cette valeur n'est pas suprieure ou gale la valeur maximale des paramtres rrusize et srusize, le moniteur dfinit ce champ sur la valeur maximale de rrusize et srusize.
o

Une valeur bufsize leve amliore les performances, mais utilise davantage de mmoire.

Manuel de rfrence

Les paramtres de CFT

4-3

La valeur de BUFSIZE doit tre suprieure ou gale au maximum des valeurs des paramtres RRUSIZE et SRUSIZE des diffrents protocoles. Si cette valeur est infrieure, le moniteur dfinit la valeur BUFSIZE sur la plus leve des valeurs des paramtres RRUSIZE et SRUSIZE.

cache
CFTCAT [CACHE = n] {1..32000} Paramtre de taille pour le tampon d'antmmoire du moniteur contenant les transferts en attente de ressources. Exprim sous la forme d'un nombre de postes catalogue, chaque poste ayant une longueur de 62 octets. Un tampon de grande taille permet de limiter les accs au fichier catalogue. La valeur par dfaut de ce paramtre est 512. L'antmmoire est tendue automatiquement par blocs d'une taille correspondant la valeur initiale. CFTSSL [CACHE = NO|YES]

call
CFTNET [call = {inout|in|out}] Direction d'appel possible par le biais de cette ressource rseau. Vous avez le choix entre les valeurs suivantes : INOUT (valeur par dfaut) ; IN ; OUT.

cat
CFTPARM CAT = identifier Identifiant de la commande dcrivant la gestion du fichier catalogue, CFTCAT.

cerfil
CFTCOM TYPE = TCPIP [CERFIL = ( string, string, ...)]

cerpassw
CFTCOM TYPE = TCPIP [CERPASSW = string]

Manuel de rfrence

Les paramtres de CFT

4-4

check
PKICER [check = {YES|NO}] Pour PKIUTIL, contrle du certificat pendant une importation.

cipher
[CIPHER = {NO|YES}] CFTFILE Requte de chiffrage de fichier. Ce paramtre concerne le fichier de paramtrage, le fichier du partenaire et le fichier de communication (TYPE = PARM, PART ou COM).

class
CFTNET, CFTLU62, CFTX25, CFTSNA [CLASS = n] {1..32} Classe de la ressource locale utilise pour tablir une connexion avec un partenaire. Classe associe cette ressource rseau. Ce concept est employ pour regrouper des ressources du mme type, afin qu'elles puissent tre utilises indiffremment pour tablir des connexions avec des partenaires (voir Ressources rseau et protocoles). CFTSNA MVS, VM, VSE Le paramtre est omis si PROFILE = GATE [CLASS = {1|n}] {1 .. 32} Classe de la ressource locale SNA utilise pour tablir la connexion avec le partenaire. La valeur de cette classe est dfinie dans la commande CFTNET correspondant la mthode d'accs au rseau utilise pour communiquer avec le partenaire. Ce paramtre est trait pendant une requte de connexion sortante, pour slectionner ce CFTSNA sur la base du protocole impos par CFTPART (ce mcanisme permet d'associer plusieurs commandes CFTSNA une commande CFTPART). CFTTCP [CLASS = {1|n}] {1 .. 32} Classe logique de la liaison physique. Le maximum, dpendant du systme, est gal NM_MAX_CLASS. Les valeurs maximales recommandes sont les suivantes : Windows NT 64 ; UNIX 8 ; MVS 32.

Manuel de rfrence

Les paramtres de CFT

4-5

cnxin
CFTX25, CFTTCP, CFTLU62, CFTDNA, CFTDSA, CFTSNA, CFTASY [cnxin = {2|n}] Nombre maximum de sessions pour les connexions entrantes.

cnxinout
CFTX25, CFTTCP, CFTLU62, CFTDNA, CFTDSA, CFTSNA, CFTASY [cnxout = {2|n}] Nombre maximum de sessions de communication. CFTxxx Le tableau suivant indique la valeur maximale prise en charge pour chaque systme. CFTXXX CNXINOUT - Nombre maximum de sessions
Systme d'exploitation GCOS7 GCOS8 GUARDIAN MVS Netware OS2 OS400 UNIX VM VMS VOS VSE Win95 WinNT Maximum pris en charge 32 90 20 240 16 16 32 48 16 32 200 16 16 16

cnxout
CFTX25, CFTTCP, CFTLU62, CFTDNA, CFTDSA, CFTSNA, CFTASY [cnxout = {2 | n }] Nombre maximum de sessions pour les connexions sortantes.

Manuel de rfrence

Les paramtres de CFT

4-6

com
CFTPARM COM = (identifier, identifier,...) Liste des identifiants des commandes de description des mdias de communication (CFTCOM). Le nombre maximum d'identifiants pris en charge est fix 4.

comment
ABOUT, SEND, RECV, CFTPART [COMMENT = string80 characters] Commentaire libre. Ce commentaire est affich et peut tre utilis pour indiquer un lment d'information spcifique (nom du client, etc.). CFTSEND, CFTRECV, SEND, RECV [COMMENT = string160] Saisissez une description en texte libre pour le transfert en rception. Vous pouvez entrer jusqu' 160 caractres alphanumriques. Le contenu de ce champ : n'est pas analys ni utilis pendant les transferts ; peut tre interrog localement l'aide de la commande LISTCAT CONTENT=FULL ; est restaur l'aide de la variable symbolique &COMMENT. CFTACCNT, CFTEXIT, CFTIDF, CFTLOG, CFTAUTH, CDTCAT, CFTCOM, CFTDEST, CFTETB [COMMENT = string80 characters] CFTX25, CFTXLATE, CFTPARM, CFTPART, CFTAPPL, CFTPROT, CFTTCP [COMMENT = string80 characters]

commut
CFTPART [COMMUT = {YES|NO|SERVER|PART}] Applicable uniquement pour un site de commutation (Store and Forward) Type de commutation pris en charge pour ce partenaire. Les types suivants sont possibles : YES : correspond la commutation Store and Forward ; SERVER : correspond la commutation serveur VAN ; NO : la commutation est refuse pour ce partenaire ; PART : le mode commutation est forc en mode serveur si le destinataire spcifi dans le paramtre IPART n'est pas le rcepteur final.

Manuel de rfrence

Les paramtres de CFT

4-7

compression
Deux champs sont affichs : icomp - Compresse les donnes du fichier d'entre. ict - Type de compression des donnes du fichier d'entre. Entrez :
o o

C : compression de CFT CFT ; H : compression PeSIT non-SIT.

concat
CFTPROT [concat = { YES|NO }] Gre le remplissage d'un message rseau (NSDU) pendant la phase d'change des donnes du fichier, autorisant le regroupement de deux FPDU dans la mme entit de donnes. S'il n'existe aucune dtection d'erreurs (PAD = NO) : en mode metteur, CONCAT = YES est recommand si le partenaire prend en charge la concatnation ; Profil SIT CONCAT = YES est OBLIGATOIRE ;

en mode rcepteur, CFT accepte les FPDU concatns, quelle que soit la valeur de ce paramtre. Si la dtection d'erreurs est excute (PAD = YES) : en mode metteur, CFT interdit la concatnation des FPDU ; CONCAT est dfini de manire implicite sur NO par CFT ; en mode rcepteur, CFT refuse la rception des FPDU concatns.

content
CFTLOG [CONTENT = {FULL|BRIEF}] Les messages crits dans le fichier journal actif sont filtrs. Les valeurs possibles sont les suivantes : FULL : tous les messages sont imprims BRIEF : les messages suivants n'apparaissent plus dans le fichier journal (ces messages appartiennent la catgorie informations systme - voir le paramtre OPERMSG de CFTLOG) : CFTR12I &cmd Treated CFTC07I PART=&part IDF=&idf IDT=&idt State=&state Deleted
o

en mode CFTT53I CFTT55I CFTT51I CFTT56I CFTT54I CFTT52I en mode CFTT51I CFTT53I

demandeur : PART=&part IDF=&idf PART=&part IDF=&idf PART=&part IDF=&idf PART=&part IDF=&idf PART=&part IDF=&idf PART=&part IDF=&idf serveur : PART=&part IDF=&idf PART=&part IDF=&idf

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

Requester Requester Requester Requester Requester Requester

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

IDT=&idt Server session opened IDT=&idt Server file created

Manuel de rfrence

Les paramtres de CFT

4-8

CFTT55I PART=&part IDF=&idf IDT=&idt Server file opened CFTT56I PART=&part IDF=&idf IDT=&idt Server file closed CFTT54I PART=&part IDF=&idf IDT=&idt Server file deselect Tous les messages d'erreur ou d'avertissement sont imprims. Pour un transfert sans incident, le fichier journal contiendra les deux messages suivants : en mode demandeur : CFTT57I PART=&part IDF=&idf IDT=&idt Requester transfer started CFTT58I PART=&part IDF=&idf IDT=&idt Requester transfer ended en mode serveur : CFTT57I PART=&part IDF=&idf IDT=&idt Server transfer started CFTT58I PART=&part IDF=&idf IDT=&idt Server transfer ended LISTCAT [CONTENT = {BRIEF|FULL|DEBUG|EXTEND}] Utilis pour obtenir une partie ou l'intgralit des informations d'un poste catalogue. Les valeurs possibles sont les suivantes : BRIEF : les informations les plus importantes concernant les transferts slectionns sont affiches (une ligne par transfert) ; EXTEND : les informations concernant la scurit, les exits et les procdures de fin de transfert, ainsi que les informations de type BRIEF sont affiches (une ligne par transfert) ; FULL : toutes les informations concernant chaque transfert sont affiches ; DEBUG. LISTCOM [CONTENT = {ACTIVE|FULL }] Utilis pour obtenir une partie ou l'intgralit des informations d'un poste catalogue. LISTPARM, LISTPART [CONTENT = {FULL|BRIEF}] Utilis pour obtenir une partie ou l'intgralit des informations. MQUERY [CONTENT = { BRIEF|FULL|STAT}] Utilis pour obtenir une partie ou l'intgralit des informations. DISPLAY [CONTENT = listcat]

cpname
CFTLU62 [cpname = string 1...8] Nom du point de contrle du noeud priphrique de type 2.1 dont dpend l'unit logique (LU). Applicable uniquement pour OS400 et UNIX.

Manuel de rfrence

Les paramtres de CFT

4-9

ctlr
[CTLR = string8] OS Nom du contrleur de communication.

cto
CFTPROT Odette (OFTP) Dure minimale (en minutes) de la session (dure du cycle). A la fin d'un transfert, le dlai d'attente pour un nouveau transfert est recalcul en fonction des lments suivants : heure d'ouverture de la session ; heure actuelle ; dlai d'attente avant la dconnexion (DISCTS pour le protocole) ; dure de la session (CTO). La session est libre si aucun transfert n'a t dclench par le partenaire distant pendant la dure indique.

ctrlpart
CFTPART [CTRLPART = {IGNORE|ALL|RPART|SPART}] Ce paramtre optionnel ne concerne que le mode serveur. Lorsqu'un transfert est lanc par un partenaire distant, CFT contrle toujours sont identit. Si l'expditeur distant n'est pas l'expditeur initial (mode commutation), CFT peut choisir de contrler l'identit de l'expditeur initial selon le paramtre CTRLPART. IGNORE (Valeur par dfaut) : aucun contrle de l'identit de l'expditeur distant ; ALL : contrle de l'identit de l'expditeur distant. Si le partenaire est inconnu, le transfert est refus avec un message ; RPART ; SPART. CFTT15E NPART=&part _ Not found

cycdate
CFTRECV, RECV, CFTSEND, SEND [CYCDATE = {voir commentaire|date}] Date finale suprieure pour l'activation du premier transfert d'un cycle. Si l'intervalle est quotidien ou suprieur (TCYCLE = DAY ou TCYCLE = MONTH), la valeur par dfaut de CYCDATE est alors MINDATE + TCYCLE*CYCLE ; sinon, cette valeur est CYCDATE = MINDATE. Exemple : si TCYCLE = DAY et CYCLE = 2, la valeur par dfaut de CYDATE est MINDATE + 2 jours. Le paramtre cycdate fait partie des dfinitions de CFTSEND et CFTRECV. Utilisez le paramtre cycdate pour dfinir une demande de transfert cyclique. Spcifiez le dernier jour pour activer le cycle de transferts diffrs.

Manuel de rfrence

Les paramtres de CFT

4-10

Si l'intervalle est exprim en : Jours ou mois (TCYCLE = DAY ou TCYCLE = MONTH), la valeur par dfaut est : CYCDATE = MINDATE + TCYCLE * CYCLE Minutes (TCYCLE = MIN), la valeur par dfaut est : CYCDATE = MINDATE

cycle
CFTSEND, SEND, CFTRECV, RECV CYCLE = {0|n} {0..32767} Nombre d'units dfinissant a priode du cycle de transfert. Utilisez ce champ pour dfinir le cycle d'activation des transferts. Entrez la priode de temps correspondant au dlai d'attente avant l'activation du transfert suivant. Cette priode peut tre exprime en minutes, jours ou mois, comme spcifi dans le champ tcycle. Entrez l'une des valeurs suivantes : 0 (valeur par dfaut) ; n'importe quelle autre valeur comprise entre 0 et 32767. CFTPROT [CYCLE = {10|n}] {1..32767} Le paramtre cycle fait partie de la dfinition de CFT. Il est disponible uniquement pour PeSIT DMZ. Il vous permet de dfinir la priodicit pour la cration d'une session de protocole. TURN [CYCLE = {10|n}] {1..32767}

cyctime
CFTSEND, SEND, CFTRECV, RECV [CYCTIME = {voir commentaire|time}] Le paramtre cyctime fait partie de la dfinition de CFTSEND et CFTRECV. Utilisez le paramtre cyctime pour dfinir une demande de transfert cyclique. Une demande de transfert cyclique est une demande de rptition du transfert. La priode (temps entre deux activations de transfert) est dfinie par les paramtres cycle et tcycle dans l'objet CFTSEND. Cette priode peut tre exprime en minutes, jours ou mois. La plage temporelle de validit pour cette requte est dfinie par les paramtres mindate/mintime et maxdate/maxtime, et correspond la dure totale pendant laquelle les transferts sont priodiquement rpts. Pour achever la configuration de ce paramtre, entrez l'heure d'activation initiale pour le cycle des transferts diffrs. Si l'intervalle est exprim en : jours ou mois (tcycle = day ou tycycle = month), la valeur par dfaut est cyctime = mintime minutes (tycycle = min), la valeur par dfaut est cyctime = mintime + tcycle * cycle Heure limite suprieure pour l'activation du premier transfert d'un cycle.

Manuel de rfrence

Les paramtres de CFT

4-11

Pour les transferts suivants, la date/heure finale est calcule comme suit : CYCDATE.CYCTIME + CYCLE * TCYCLE (valeur de la priode). Si l'intervalle est exprim en minutes (TCYCLE = MIN), la valeur par dfaut de CYCTIME est alors : MINTIME + TCYCLE*CYCLE ; sinon, CYCTIME = MINTIME. Exemple : si TCYCLE = MIN et CYCLE = 60, la valeur par dfaut de CYCTIME est MINTIME + 1 heure.

data
CFTX25, CFTLU62, CFTTCP, [DATA = string {1...32}] Donnes utilisateur dans le paquet d'appel X.25.

default
CFTPARM Vous pouvez ventuellement entrer un identifiant par dfaut dans les objets CFTRECV, CFTSEND, CFTXLATE, CFTX25 et CFTAPPL. La valeur par dfaut est DEFAULT. Identifiant par dfaut (indiqu de manire gnrique par <defaut>) des commandes CFTRECV, CFTSEND, CFTXLATE et CFTX25. CFTRECV et CFTSEND ID = <default> Ces commandes spcifient les valeurs par dfaut complmentaires des paramtres des commandes RECV et SEND, lorsque l'ID de la requte de transfert n'est pas dfini explicitement par une commande CFTRECV ou CFTSEND. Les commandes CFTRECV et CFTSEND ID = <defaut> sont obligatoires. Remarque : les caractristiques des fichiers types par dfaut (CFTSEND et CFTRECV avec un identifiant par dfaut), contrairement celles des autres fichiers types, sont charges en mmoire l'initialisation de CFT. Ces caractristiques sont par consquent des paramtres STATIQUES. L'utilisation de la commande CFTRECV ID = <defaut> peut impliquer la rception de fichiers de tailles et de formats diffrents. Lorsque le protocole le permet, il est donc prfrable que les valeurs des paramtres FSPACE, FRECFM, FORG (etc.) de cette commande ne soient pas dfinies, CFT prenant alors en compte les valeurs relles du fichier reu, telles qu'elles sont transfres par le protocole (voir les fonctions de chaque protocole). CFTXLATE ID = <defaut> Cette commande spcifie les tables de transcodage par dfaut, lorsqu'elles ne sont pas dsignes de manire explicite par les commandes SEND/CFTSEND (ou RECV/CFTRECV) et CFTPART. La commande CFTXLATE ID = <defaut> est facultative ; si elle n'est pas incluse, les tables de transcodage internes du moniteur sont utilises (voir leur description dans l'annexe). CFTX25 ID = <defaut> Utilis par le moniteur pour les appels entrants (fonctionnement en mode serveur).

Manuel de rfrence

Les paramtres de CFT

4-12

En l'absence d'une description du rseau X.25 partenaire correspondant la ressource sur laquelle arrive l'appel, le moniteur recherche la description par dfaut : CFTX25 ID = <defaut>, ... cette commande n'affiche pas les paramtres spcifiques un partenaire ni les paramtres spcifiques tous les appels sortants (DIALNO, CNXOUT, RETRY*, O*TIME).

delete
CFTRECV, CFTSEND [DELETE = {NO | YES}] Suppression automatique des postes du catalogue l'tat T (termin) pour l'IDF correspondant. Si l'utilisateur spcifie des procdures de fin de transfert (paramtres EXECSF et EXECRF de CFTPARM), les postes du catalogue ne sont supprims qu'aprs l'excution de ces procdures. Si la commutation (Store and Forward) des fichiers est demande (via le paramtrage de CFT), aucun des postes du catalogue associs des transferts termins n'est supprim. Slectionnez l'une des valeurs suivantes : NO (valeur par dfaut) ; YES (suppression automatique).

diagi
Code de diagnostic interne.

diagp
Code de diagnostic du protocole.

dialno
CFTX25 dialno = {n, n, ...} Numro d'appel X.25 ou liste des numros du partenaire avec lequel une session doit tre tablie. Cette liste peut contenir jusqu' 4 numros. Notez que si le SAP est attendu par le moniteur du partenaire en tant que sous-adresse, ce partenaire doit tre limit l'adresse X.25 et ne doit pas tre tendu avec une sousadresse. Dans ce cas, la sous-adresse est dfinie par la valeur du paramtre SAP de l'objet CFTPART pour le protocole slectionn.

direct
SUBMIT, DELETE, END, HALT, KEEP, START, CFTXLATE, CFTETB, LISTCAT [DIRECT = {BOTH|SEND|RECV} ] Direction de transfert des requtes en question. Les valeurs possibles sont les suivantes : BOTH - Les transferts en mission et en rception sont tous deux pris en compte (par dfaut, sauf pour CFTETB) ; RECV - Limite l'action aux transferts en rception ;

Manuel de rfrence

Les paramtres de CFT

4-13

SEND - Limite l'action aux transferts en mission. DISPLAY, CFTAPPL, RESUME [DIRECT = {CLIENT|SERVER} ] CFTSSL [DIRECT = {CLIENT|SERVER} ] CFTETB [DIRECT = {SEND|RECV} ]

dirnb
CFTRECV, RECV [DIRNB = n] uniquement pour MVS Nombre de blocs de rpertoire utiliss pour crer un rpertoire.

disctc
CFTPROT [disctc = { 90|0...3600}] Dlai d'attente d'une rponse la requte de connexion du protocole (FPDU Connect). Entrez une valeur comprise entre 0 et 3600.

disctd
CFTPROT [DISCTD = {voir le tableau ci-aprs | n}] {0..3600} ] Dlai d'attente, en secondes, avant la dconnexion, en l'absence d'une nouvelle requte de transfert au partenaire, en mode demandeur. La session tablie pour un transfert reste active pendant DISCTD secondes aprs la fin de ce transfert. Si la valeur est 0, le dlai d'attente est infini. La valeur par dfaut, en secondes, dpend du protocole ; elle est indique dans le tableau suivant. CFTPROT DISCTD - Valeurs par dfaut
Protocole PeSIT Profil SIT PeSIT D Profil EXTERN PeSIT D Profil CFT PeSIT E Profil ANY 120 20 120 Valeur par dfaut de DISCTD 240

Manuel de rfrence

Les paramtres de CFT

4-14

Protocole ODETTE ETEBAC3

Valeur par dfaut de DISCTD 20 20

disctr
CFTPROT [disctr = 45 | n } ] {0...3600} Dlai d'attente de dconnexion du rseau. Dlai d'attente en secondes pour le partenaire dans la connexion avant la dconnexion, aprs l'mission d'une requte ABORT.

discts
CFTPROT [DISCTS = {voir le tableau ci-dessous|n}] {0..3600} Dlai d'attente (en secondes) avant la dconnexion, en l'absence d'une nouvelle requte de transfert du partenaire, en mode serveur. La session tablie pour un transfert reste active pendant DISCTS secondes aprs la fin de ce transfert. Si, la fin de ce dlai, aucun nouveau transfert n'a t reu, la connexion est libre par la FPDU ABORT. Si la valeur est 0, le dlai d'attente est illimit. La valeur par dfaut (en secondes) dpend du protocole ; elle est indique dans le tableau suivant. CFTPROT DISCTS - Valeurs par dfaut
Protocole PeSIT profil SIT PeSIT D profil EXTERN PeSIT D profil CFT PeSIT E (profil ANY) ODETTE ETEBAC3 Valeur par dfaut de DISCTS 285 165 65 165 65 65

dnuser
CFTSSL dnuser='(string1, string2)' Entrez des chanes limites chacune 512 octets. Un contrle est effectu comme suit : dnuser='C=FR/O= SOPRA/ OU=RDM-XFB', signifie que le DN du certificat distant doit contenir cette chane ; dnuser='C=UK,O=SOPRA' signifie que le DN du certificat distant doit contenir la chane 'C=UK' OU 'O=SOPRA' ;

Manuel de rfrence

Les paramtres de CFT

4-15

en outre, vous pouvez configurer CFT pour accepter ou rejeter les connexions SSL sur la base des oprateurs logiques utiliss avec le DN du certificat : dnuser='(string1 Op string2)' signifie que le DN du certificat distant doit contenir chane1 Op chane2, o Op dsigne l'oprateur binaire OR ou AND ; o dnuser='( string1 Op ! string2)' signifie que le DN du certificat distant doit contenir chane1 Op NOT(string2), o Op dsigne l'oprateur binaire OR ou AND. Notez que les diffrents attributs de la chane dnuser ou dnissuer sont spars par le caractre '/'.
o

during
[DURING = {0|n}] {0..65535} Dure en secondes pendant laquelle CFTUTIL est dsactiv.

dynam
CFTPROT [dynam = string 1...32] Identifiant de partenaire dynamique, de 32 caractres, en mode serveur. La valeur de cet identifiant correspond la valeur du paramtre ID de la commande CFTPART type et excute des contrles supplmentaires. Pour des raisons de scurit, ce paramtre doit tre utilis en combinaison avec un EXIT de type annuaire. EERP Utilis pour interprter la valeur des champs ORIGINATOR et DESTINATOR contenus dans le message EERP, selon la version du protocole. Le service EERP (End to End ResPonse) gnre un message intitul EERP. Ce message informe l'metteur du fichier que les donnes envoyes sont arrives correctement. La premire version du protocole (1986) spcifie que : le champ ORIGINATOR du protocole correspond l'metteur du fichier ; le champ DESTINATOR du protocole correspond au rcepteur du fichier. La seconde version (1991) spcifie que : le champ ORIGINATOR du protocole correspond l'metteur EERP (c'est--dire au rcepteur du fichier) ; le champ DESTINATOR du protocole correspond au rcepteur EERP (c'est--dire l'metteur du fichier). Remarque : vous devez contrler la cohrence des valeurs personnalises d'un bout l'autre. En effet, si l'metteur et le rcepteur ont des versions diffrentes, l'acquittement du transfert n'est pas possible.

exec
CFTSEND, CFTRECV, SEND, RECV [EXEC = filename]...{string 512} Spcifiez le nom du fichier qui dcrit la procdure la fin du transfert.

Manuel de rfrence

Les paramtres de CFT

4-16

Ce nom peut inclure les variables symboliques suivantes : &IDF, &PARM &PART, &RPART, &SPART, &GROUP &RUSER, &SUSER, &USERID &RAPPL, &SAPPL &NIDF Nom gnrique du fichier dcrivant les procdures excuter la fin du transfert. Permet d'associer cette procdure un identifiant de fichier type (IDF), au lieu d'inclure la variable symbolique &IDF au niveau du paramtre EXECSF ou XECRF de CFTPARM. Les variables symboliques qui sont possibles dans filename et dans la procdure associe (ou dans l'ensemble de procdures associ) sont les mmes que celles autorises pour les procdures de fin de transfert auxquelles il est fait rfrence dans CFTPARM (voir les Variables symboliques). Si ce paramtre EXEC est dfini et : si le fichier correspondant filename existe, la procdure associe est soumise la fin du transfert ; si le fichier n'existe pas, aucun traitement n'est excut la fin du transfert (mme si le paramtre EXECSF de la commande CFTPARM est dfini). Si ce paramtre EXEC n'est pas dfini, le paramtre EXECSF ou EXECRF de la commande CFTPARM est pris en compte. CFTLOG [EXEC = filename] {string 64} Nom de la procdure excuter lors du basculement vers l'autre fichier journal. Cette procdure peut accder la variable symbolique &FLOG, qui contient le nom du dernier fichier journal utilis avant le basculement (fichier courant). CFTACCNT [EXEC = filename] {string 64} Nom de la procdure excuter lorsque CFT bascule vers l'autre fichier statistique. Cette procdure peut accder la variable symbolique &FACCNT, qui contient le nom du dernier fichier statistique utilis avant le basculement. CFTDEST [EXEC = {DEST|PART}] Fin du mode soumission de la procdure de transfert : DEST : la fin de la procdure de transfert est soumise lorsque tous les transferts sont termins. Les variables symboliques sont remplaces conformment l'enregistrement gnrique. Par exemple, la variable &PART est remplace par l'identifiant de la commande CFTDEST. PART : une procdure de fin de transfert est soumise pour chaque transfert termin. Les variables symboliques sont remplaces conformment l'enregistrement courant. Par exemple, la variable &PART est remplace par l'identifiant du paramtre de transfert.

Manuel de rfrence

Les paramtres de CFT

4-17

Lorsque tous les transferts sont termins, une procdure de fin de transfert est soumise. Les variables symboliques sont remplaces conformment l'enregistrement gnrique. Par exemple, la variable &PART est remplace par l'identifiant de la commande CFTDEST. SUBMIT [EXEC = filename]

execre
CFTPARM [EXECRE = filename] {string 64} Spcifiez le nom du fichier dcrivant les procdures excuter aprs une erreur de rception de fichier. Nom gnrique du fichier dcrivant les procdures excuter aprs un incident (erreur) survenu pendant un transfert en rception, le transfert passant l'tat H ou K. Ce nom peut inclure les variables symboliques suivantes : &IDF, &PARM &PART, &RPART, &SPART, &GROUP &RUSER, &SUSER &RAPPL, &SAPPL &DIAGI, &DIAGP &NIDF Le caractre & dsigne le caractre char_symb dfini dans le Guide d'exploitation de CFT correspondant votre systme d'exploitation.

execrf
CFTPARM [EXECRF = filename] {string 64} Nom gnrique du fichier dcrivant les procdures excuter la fin de la rception d'un fichier. Nom gnrique du fichier dcrivant les procdures excuter la fin de la rception d'un fichier. Ce nom peut inclure les variables symboliques suivantes : &IDF, &PARM &PART, &RPART, &SPART, &GROUP &RUSER, &SUSER, &USERID &RAPPL, &SAPPL &NIDF Le caractre & dsigne le caractre char_symb dfini dans le Guide d'exploitation de CFT correspondant votre systme d'exploitation.

Manuel de rfrence

Les paramtres de CFT

4-18

execrm
CFTPARM [EXECRM = filename] {string 64} Nom gnrique du fichier dcrivant les procdures excuter la fin de la rception d'un message. Ce nom peut inclure les variables symboliques suivantes : &IDM, &PARM &PART, &RPART, &SPART, &GROUP &RUSER, &SUSER, &USERID &RAPPL, &SAPPL Le caractre & dsigne le caractre char_symb dfini dans le Guide d'exploitation de CFT correspondant votre systme d'exploitation La procdure excuter normalement la fin de la rception d'un message.

execse
CFTPARM [EXECSE = filename] {string 64} Nom gnrique du fichier dcrivant les procdures excuter aprs un incident (erreur) survenu pendant un transfert en mission, le transfert passant l'tat H ou K. Ce nom peut inclure les variables symboliques suivantes : &IDF, &PARM &PART, &RPART, &SPART, &GROUP &RUSER, &SUSER, &USERID &RAPPL, &SAPPL &DIAGI, &DIAGP &NIDF Le caractre & dsigne le caractre char_symb dfini dans le Guide d'exploitation de CFT correspondant votre systme d'exploitation.

execsf
CFTPARM [EXECRM = filename] {string 64} Nom gnrique du fichier dcrivant les procdures excuter la fin de l'mission d'un fichier. Ce nom peut inclure les variables symboliques suivantes : &IDF, &PARM &PART, &RPART, &SPART, &GROUP &RUSER, &SUSER, &USERID &RAPPL, &SAPPL &NIDF

Manuel de rfrence

Les paramtres de CFT

4-19

Le caractre & dsigne le caractre char_symb dfini dans le Guide d'exploitation de CFT correspondant votre systme d'exploitation.

execsfa
CFTPARM [EXECSFA = filename] {string 64} Nom gnrique du fichier dcrivant les procdures excuter la rception d'un acquittement (message de type REPLY). Ce nom peut inclure les variables symboliques suivantes : &IDF, &PARM &PART, &RPART, &SPART, &GROUP &RUSER, &SUSER, &USERID &RAPPL, &SAPPL Le caractre & dsigne le caractre char_symb dfini dans le Guide d'exploitation de CFT correspondant votre systme d'exploitation. Procdure excuter la rception d'un acquittement suite une opration d'mission de fichier.

execsm
CFTPARM [EXECSM = filename] {string 64} Nom gnrique du fichier dcrivant les procdures excuter la fin de l'mission d'un message. Ce nom peut inclure les variables symboliques suivantes : &IDM, &PARM &PART, &RPART, &SPART, &GROUP &RUSER, &SUSER, &USERID &RAPPL, &SAPPL Le caractre & dsigne le caractre char_symb dfini dans le Guide d'exploitation de CFT correspondant votre systme d'exploitation.

execsma
CFTPARM [EXECSMA = filename] {string 64} Nom gnrique du fichier dcrivant les procdures excuter la rception d'un acquittement (rponse) suite l'envoi d'un fichier.

execsub
CFTSEND, SEND [EXECSUB = {LIST|FILE}] Soumission de la procdure de fin de transfert pendant l'mission d'un groupe de fichiers dans un environnement htrogne : LIST : bascule pour la procdure de fin de transfert sur la demande gnrique la

Manuel de rfrence

Les paramtres de CFT

4-20

fin de tous les transferts sur la liste ; FILE : bascule pour la procdure de fin de transfert pour chaque requte sur la liste et sur la requte gnrique.

exit
[EXIT = identifier] CFTSEND, SEND, RECV Identifiant de la commande CFTEXIT associe ce transfert. Utilis pour activer une tche utilisateur EXIT de type fichier. La valeur de ce paramtre peut tre gale la variable symbolique &IDF.

exita
CFTPROT [EXITA = identifier] Identifiant (32 caractres) dcrivant l'EXIT de type annuaire. La valeur de cet identifiant correspond la valeur du paramtre CFTEXIT ID. L'identifiant peut contenir la variable symbolique &NPART.

exite
CFTPROT [EXITE = identifier] Identifiant (32 caractres) dcrivant l'EXIT de type ETEBAC3. La valeur de cet identifiant correspond la valeur du paramtre CFTEXIT ID. L'identifiant peut contenir la variable symbolique &PART.

exiteot
CFTPARM [EXITEOT = identifier] Identifiant d'EXIT de 32 caractres. Pour activer une tche EXIT de type fin de fichier, l'identifiant d'EXIT que vous utilisez doit dsigner un objet CFTEXIT. Vous pouvez utiliser une variable symbolique comme identifiant d'un EXIT de type fin de fichier : EXITEOT = (&NPART, &PART, &IDF &GROUP ou &IDA), o NPART est le nom rseau du partenaire distant (seuls les huit premiers chiffres sont pris en compte) ; PART est l'identifiant du partenaire local ; IDF est l'identifiant du fichier ou du message ; GROUP dsigne le groupe de partenaires ; IDA est l'identifiant de l'application locale.

Manuel de rfrence

Les paramtres de CFT

4-21

facility
CFTX25 [FACILITY = string 64] Chane de caractres alphanumriques qui donne la reprsentation hexadcimale du champ FACILITY X.25. Ce champ est ajout aux installations dclares dans les paramtres SPEED, PCV1, PCV0 et GFA. La cohrence de la valeur de ce paramtre est contrle par rapport la norme X.25. La valeur de ce paramtre doit tre mise entre guillemets (" ").

faction
CFTSEND, SEND [FACTION = {NONE | DELETE | ERASE | ROTATE }] Action sur le fichier aprs un transfert en mission : ERASE : efface le contenu du fichier aprs le transfert (repre Fin de fichier au dbut du fichier) ; DELETE : supprime le fichier aprs le transfert ; NONE : aucune action sur ce fichier la fin du transfert ; ROTATE : cette valeur s'applique uniquement un fichier logique de base de donnes VFM. Remarque : pour l'mission d'un rpertoire ou d'un groupe de fichiers, ce paramtre est ignor s'il est dfini sur DELETE. Ni les rpertoires ni les fichiers ne sont supprims aprs un transfert gnrique. CFTSEND pour un fichier d'mission type d'une base VFM [FACTION = {ERASE|DELETE|NONE|ROTATE}] Action aprs le transfert du fichier : ERASE : le fichier est effac (rinitialis) aprs le transfert (EOF au dbut du fichier) ; DELETE : le fichier est supprim aprs le transfert ; NONE : aucune action sur ce fichier la fin du transfert ; ROTATE : cette valeur s'applique uniquement un fichier logique de base de donnes VFM. Une nouvelle version vide du fichier logique est cre aprs le transfert d'une version 0 du fichier logique. La version transfre devient la version -1 du fichier. Remarque : si la rotation de la version est demande sur un numro de version ou une version -n du fichier envoyer, la requte de transfert est refuse. CFTRECV pour un fichier de rception type d'une base VFM [FACTION = {CONCAT|DELETE|ERASE|VERIFY}] Action excuter avant la rception du fichier. Cette action s'applique au fichier rcepteur lorsqu'il existe dj avant le transfert. Les actions sont les suivantes : CONCAT : concatner les donnes. Les donnes reues sont ajoutes aux donnes du fichier logique existant.

Manuel de rfrence

Les paramtres de CFT

4-22

Si le fichier logique FNAME : existe dj, les donnes reues sont lies aux donnes du fichier FNAME ; n'existe pas, le fichier logique est cr ; ERASE : le fichier est effac (rinitialis) ;
o o

DELETE : le fichier est supprim ; VERIFY : vrifier que le fichier est vide. CFTRECV, RECV [= {VERIFY|DELETE|ERASE|CONCAT}] Action sur le fichier avant un transfert en rception. Si un fichier rcepteur de mme nom existe dj, le moniteur excute l'une des actions suivantes en fonction de la valeur de ce paramtre : ERASE : effacer le contenu du fichier ; DELETE : supprimer le fichier ; VERIFY : vrifier que le fichier est vide ; CONCAT : concatner les donnes. Le moniteur ragit aux diffrentes situations possibles en fonction de la valeur du paramtre FDISP, comme indiqu dans le tableau suivant : OK signifie que le transfert est accept ; NOK signifie que le transfert est refus ; Abs signifie que le fichier rcepteur n'existe pas encore ; Pres signifie que le fichier rcepteur existe dj (ses caractristiques sont supposes appropries).
FACTION FDISP NEW OLD ERASE Abs : OK Pres : NOK Abs : NOK Pres : OK (Effacer) Abs : OK Pres : OK (Effacer) DELETE Abs : OK Pres : NOK Abs : NOK Pres : OK (Supprimer) Abs : OK Pres : OK (Supprimer) VERIFY Abs : OK Pres : NOK Abs : NOK Pres : OK si vide NOK sinon Abs : OK Pres : OK si vide NOK sinon

BOTH

MVS VM

Pour les fichiers VSAM, seul FACTION = ERASE est accept. FACTION = VERIFY (valeur par dfaut) n'est pas pris en charge. Ce paramtre doit donc tre dfini de manire explicite avec l'une des valeurs ERASE ou DELETE.

fast
SHUT [FAST = {NO|YES|KILL}] Type d'arrt : YES : arrt immdiat de CFT. Tous les transferts en cours sont interrompus et passage l'tat D. Aucun transfert en attente n'est activ ; NO : CFT termine tous les transferts en cours et s'arrte.

Manuel de rfrence

Les paramtres de CFT

4-23

Aucun nouveau transfert n'est initialis ; KILL : un arrt immdiate de CFT a lieu, mais sans mise jour des tats de transfert.

fblksize
CFTFILE [FBLKSIZE = {voir le tableau ci-dessous|n}] {0...32768} Selon TYPE/SYSTEME D'EXPLOITATON Dfinit la taille de bloc du fichier crer (en octets). Le tableau ci-dessous indique, pour chaque systme, la valeur par dfaut prise en charge en fonction du type de fichier crer. Dans ce tableau, lorsque la valeur par dfaut de la taille de bloc du fichier crer est no , il n'est pas ncessaire de dfinir le paramtre FBLKSIZE.
Tableau FBLKSIZE Systme dexploitation GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE Windows PARM non 2048 non non 0 non non non non non non PART non 1536 non non 0 non non non non non non CAT 3328 2048 non non 0 non non non non non non COM 2052 2048 non non 0 non non non non non non LOG non 256 non 1028 0 non 132 non non 132 non ACCNT non 768 non 482 0 non 480 non non 480 non

CFTRECV, RECV [FBLKSIZE = n] {0..62563} Ce paramtre dont la valeur est dfinie en octets contrle le facteur de groupage des enregistrements du fichier rcepteur : selon le systme, il dfinit la taille de bloc du disque et/ou la taille du tampon d'entre/sortie du fichier.
Systme GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS FBLKSIZE utilis OUI OUI NON OUI NON NON NON NON NON

Manuel de rfrence

Les paramtres de CFT

4-24

Systme VSE Windows

FBLKSIZE utilis OUI NON

MVS

Pour les protocoles autres que PeSIT, profil CFT, si ce paramtre n'est pas dfini, sa valeur est paramtre comme suit : pour les fichiers de format fixe : cette valeur est gale au plus grand multiple de FLRECL infrieur la constante (lie la longueur de piste) dfinie l'installation (valeur par dfaut : 19069) ou FLRECL si FLRECL est suprieur cette constante ; pour les fichiers de format variable : cette valeur est gale la constante (lie la longueur de piste) dfinie l'installation sur le moniteur CFT dans l'environnement MVS (valeur par dfaut : 19065) ou FLRECL + 4 si FLRECL est suprieur cette constante ; pour les fichiers de format indfini : cette valeur est gale 32760.

CFTSEND, SEND [FBULKSIZ = n] {0...65536} Taille de bloc du fichier envoy. Normalement, vous n'avez pas besoin de dfinir ce paramtre, car CFT est capable de rechercher la valeur pour le fichier envoyer. Cette valeur relle est ensuite prise en compte lors de l'activation du transfert.
Systme GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE Windows FBLKSIZE utilis OUI OUI NON OUI NON NON NON NON NON OUI NON

fcheck
CFTRECV FCHECK = {NO|YES} Ce paramtre vous permet de refuser un transfert entrant si les attributs du fichier local ne correspondent pas aux attributs du fichier virtuel. NO (valeur par dfaut) - Le comportement de CFT reste inchang et aucun contrle n'est effectu. Si la longueur et le format de l'enregistrement du fichier virtuel ne correspondent pas aux attributs FLRECL et FRECFM, l'enregistrement est tronqu ou complt ; YES - Un contrle de l'enregistrement est ralis. Les attributs FLRECL et FRECFM

Manuel de rfrence

Les paramtres de CFT

4-25

sont compars avec la longueur et le format de l'enregistrement du fichier virtuel. Si les attributs ne concident pas, le transfert est refus.

fcode
CFTXLATE Code des donnes du fichier envoy. Le tableau suivant indique la valeur par dfaut prise en charge pour chaque systme d'exploitation.
Systme dexploitation GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE Windows Valeur par dfaut EBCDIC ASCII ASCII EBCDIC EBCDIC ASCII EBCDIC ASCII ASCII EBCDIC ASCII

CFTRECV, RECV [FCODE = {selon FTYPE|ASCII|BINARY|EBCDIC}] Code des donnes du fichier rcepteur (codes de donnes local). Valeurs par dfaut : Dans le protocole PeSIT (except pour le profil SIT), si le code des donnes reues du rseau est BINARY, la valeur par dfaut de FCODE (dtermin de manire dynamique chaque transfert) est BINARY. Sinon, la valeur par dfaut de FCODE (dtermin de manire dynamique chaque transfert) est gale la valeur du code natif du systme rcepteur. La valeur par dfaut de FCODE ne dpend pas du type de fichier reu du rseau. La traduction effectue la rception dpend des lments suivants : code local (valeur explicite ou implicite du paramtre FCODE) ; code rseau (code des donnes reues du rseau) ; prsence d'une table de traduction externe si besoin est. Notez qu'une table de traduction externe est prise en compte : si elle correspond au code local et au code rseau ; et si l'identifiant (ID) de la commande CFTXLATE est rfrenc par un paramtre XLATE (de la commande RECV, CFTRECV ou CFTPART) ou est gal l'identifiant (ID) par dfaut de CFTPARM. A chaque transfert en rception : si les donnes reues sont en ASCII et les donnes locales en EBCDIC, ou inversement, le transcodage est toujours excut : traduction en fonction d'une table externe ou, par dfaut, en fonction de la table interne de CFT ; si les donnes reues et les donnes locales ont le mme, ASCII ou EBCDIC, une

Manuel de rfrence

Les paramtres de CFT

4-26

table externe est requise pour excuter une traduction. CFT ne possde pas de table interne ASCII/ASCII ou EBCDIC/EBCDIC. Si les donnes reues et/ou les donnes locales sont binaires, aucune traduction n'est excute. Le code des donnes reues n'est pas dtect par un examen des donnes. Le code est : soit communiqu de manire explicite par l'metteur (voir paramtre NCODE de la commande CFTSEND, pour PeSIT CFT CFT) ; soit dduit des rgles du protocole : par exemple, pour un transfert selon le protocole ETEBAC3, les donnes reues sont gnralement attendues codes en EBCDIC. CFTSEND, SEND [FCODE = {ASCII|BINARY|EBCDIC}] Code des donnes envoyer. La valeur par dfaut, dtermine en fonction des caractristiques de chaque transfert, dpend du type (FTYPE) du fichier envoy (voir le guide d'utilisation spcifique votre systme d'exploitation). La dtection automatique du FTYPE de l'metteur, si besoin est, remplace en partie la dtection automatique du code. Pour l'effet de FCODE sur la traduction ralise pendant le transfert en envoi : voir les explications donnes au niveau du paramtre NCODE de la commande prsente.

fcomp
CFTRECV, RECV [FCOMP = {0|15}] Dfinit la compression (VFM) des donnes dans le fichier rcepteur logique. 2 valeurs sont possibles : 0 : pas de compression ; 15 : compression en fonction de l'algorithme spcifique VFM. Si FCODE ou NCODE est gal BINARY, les donnes sont stockes dans la base VFM dans un format non compress, quelle que soit la valeur du paramtre FCOMP.

fdb
CFTRECV, CFTSEND, RECV, SEND [FDB = filename] {string 64} Nom de la base VFM (fichier DATA) contenant le fichier rcepteur logique. Lorsque la valeur du paramtre est entre guillemets, elle devient sensible la casse.

fdisp
CFTRECV, RECV [FDISP = {NEW|OLD|BOTH}] Indicateur de contrle de prsence du fichier rcepteur, utilis pour dterminer l'action du moniteur CFT : NEW : le fichier doit tre cr par CFT. Le transfert est refus si ce fichier existe dj ; OLD : le fichier doit dj exister ;

Manuel de rfrence

Les paramtres de CFT

4-27

BOTH : si le fichier n'existe pas, il sera cr. CFTSEND, SEND [FDISP = {SHR|OLD|CHECK}] Option de partage de fichier : SHR : accs partag, ce qui signifie qu'un fichier peut tre transfr simultanment pour deux partenaires ; OLD : accs exclusif, ce qui signifie qu'un fichier peut tre transfr vers un seul partenaire ; CHECK : si le fichier est modifi pendant un transfert, le transfert est interrompu.

fkeylen
CFTSEND, CFTRECV, SEND, RECV [FKEYLEN = {0|n}] Pour un rcepteur : La valeur par dfaut est la valeur reue du protocole (PI 38) qui est prsente si elle a t dfinie par le demandeur. Si cette valeur est absente, la valeur par dfaut est alors gale 0. Le moniteur roit le fichier sous forme d'enregistrements squentiels. Le client a la possibilit de dvelopper un EXIT de type fichier ou d'crire une procdure de fin de transfert pour utiliser ces informations qui peuvent tre rcupres par la variable symbolique &FKEYLEN. Pour un rcepteur : Le moniteur envoie ces informations, transportes par le protocole dans le PI 38, mais ne les utilise pas. Le fichier index est transfr sous forme d'enregistrements squentiels. { 0...32767} PeSIT E Longueur de cl (en octets) d'un fichier index.

fkeypos
CFTSEND, CFTRECV, SEND, RECV [FKEYPOS = {0|n}] {0...32767} Position de la cl (en octets), par rapport 0, dans les enregistrements d'un fichier index. Pour le rcepteur : La valeur par dfaut est la valeur reue du protocole (PI 39) qui est prsente si elle a t dfinie par le demandeur. Si cette valeur est absente, la valeur par dfaut est alors gale 0. Le moniteur roit le fichier sous forme d'enregistrements squentiels. Le client a la possibilit de dvelopper un EXIT de type fichier ou d'crire une procdure de fin de transfert pour utiliser ces informations qui peuvent tre rcupres par la variable symbolique &FKEYPOS. Pour l'metteur : Le moniteur envoie ces informations, transportes par le protocole dans le PI 39, mais ne les utilise pas. Le fichier index est transfr sous forme d'enregistrements squentiels.

Manuel de rfrence

Les paramtres de CFT

4-28

flrecl
CFTRECV, RECV [FLRECL = {0|n}] {0...32767} Pour les enregistrements de : format fixe (FRECFM = F) : longueur (en octets) des enregistrements du fichier rcepteur ; format variable (FRECFM = V) : longueur maximale (en octets) des enregistrements de ce fichier ; format indfini (FRECFM = U) : longueur maximale (en octets) des enregistrements de ce fichier. Pendant un transfert en rception, tout enregistrement PLUS LONG que celui dclar par FLRECL est tronqu la valeur de FLRECL. Pour les enregistrements de format fixe (FRECFM = F), si la taille des enregistrements reus est INFRIEURE la longueur d'enregistrement du fichier, ces enregistrements sont complts jusqu' la valeur nominale : par des zros binaires (x00) lorsque les donnes locales sont dclares en binaire (FCODE = BINARY) ; par des espaces lorsque les donnes locales sont dclares comme alphanumriques, avec :
o o

FCODE = ASCII : le caractre espace est alors gal x20 ; FCODE = EBCDIC : le caractre espace est alors gal x40 (hexadcimal).

Longueurs d'enregistrement par dfaut mises en oeuvre sur certains systmes, longueur prise en compte si les informations correspondantes ne sont fournies ni par l'metteur du fichier ni par les paramtres locaux :
Systme Windows UNIX VOS Valeur par dfaut 512 512 pour les fichiers texte (FTYPE = T, X ou O) 4096 pour les fichiers binaires (FTYPE=B) 2048

CFTSEND, SEND [FLRECL = { 0|n}] {0...32767} Pour les enregistrements de : format fixe (FRECFM = F) : longueur (en octets) des enregistrements du fichier local envoyer ; format variable (FRECFM = V) : longueur maximale (en octets) des enregistrements de ce fichier ; format indfini (FRECFM = U) : longueur maximale (en octets) des enregistrements de ce fichier. L'utilisation de FLRECL est facultative : les Guides d'exploitation spcifiques prcisent si cette fonction est prise en charge pour chaque systme ; certains systmes gnrent des longueurs d'enregistrement implicites la place de cette fonction :

Manuel de rfrence

Les paramtres de CFT

4-29

Systme Windows UNIX VOS

Longueur implicite 512 512 pour les fichiers texte (FTYPE = T, X ou O) 4096 pour les fichiers binaires (FTYPE=B) 2048 FRECFM = F : toujours spcifier FLRECL. FRECFM = V : spcifier FLRECL lorsque la longueur d'enregistrement risque de dpasser 2048

fname
CFTACCNT [FNAME = filename] un nom physique ; un nom logique. CFTAUTH [FNAME = filename] string 512 Nom du fichier dans lequel les utilisateurs autoriss ou bloqus sont dfinis. Saisissez le nom du fichier (512 caractres maximum) dans lequel vous avez dfini la liste des identifiants de fichier type. Le nombre d'identifiants dans cette liste n'est pas limit. Crez le fichier l'aide des rgles suivantes : un enregistrement de ce fichier ne peut contenir qu'un seul idf ; la taille de l'enregistrement est limite 80 caractres ; un idf doit commencer dans la premire colonne et seuls les 8 premiers caractres de l'enregistrement sont pris en compte ; les caractres aprs la 8e colonne sont ignors ; l'identifiant peut tre tap en majuscules ou un minuscules ; le fichier peut contenir des enregistrements de longueur zro. Vous ne pouvez pas complter ce champ si vous avez slectionn le bouton idf. CFTCAT [FNAME = filename] string 64 Nom du fichier catalogue. Les fichiers service, comme Catalog et Log, les fichiers VFM sur les plates-formes z/OS, etc. utilisent un type de valeur de 64 caractres. Ce nom peut tre : un nom de fichier physique ; un nom logique. CFTCOM [FNAME = filename ] CFTFILE [FNAME = filename ] {string 64} {string 64} string 64 Nom du fichier statistique. Ce nom peut tre :

Manuel de rfrence

Les paramtres de CFT

4-30

CONFIG [FNAME = filename ] COPYFILE [FNAME = filename ] CFTDEST [FNAME = filename] {512 caractres } Nom du fichier dans lequel est dfinie la liste des identifiants des diffrents partenaires, chacun correspondant une valeur du paramtre ID d'un objet CFTPART. Le nombre d'identifiants dans cette liste n'est pas limit. L'existence de chaque partenaire est contrle au moment du transfert. Si un partenaire n'est pas dfini, cela n'empche pas les fichiers d'tre diffuss vers les partenaires dfinis ou collects auprs de ces derniers ; seuls les partenaires non dcrits ne sont pas desservis. Pour gnrer ce fichier, les rgles suivantes doivent tre respectes : un enregistrement de ce fichier ne peut contenir qu'un seul identifiant de partenaire ; la taille d'un enregistrement est limite 80 caractres ; un identifiant de partenaire doit commencer dans la premire colonne et seuls les 8 premiers caractres de l'enregistrement sont pris en compte ; tous les caractres aprs la 8e colonne sont ignors et considrs comme un commentaire ; un identifiant peut tre tap indiffremment en majuscules ou en minuscules (il est converti en majuscules) ; le fichier peut contenir des enregistrements de longueur zro. Exemple de fichier : Corresponding identifier 1---5--8--10-------20 (Columns) part_a This is a comment &rsquo;PART_A&rsquo; PART 1 &rsquo;PART 1&rsquo; PART2 &rsquo; PART2&rsquo; partnerone &rsquo;PARTNERO&rsquo; Le moniteur ne contrle pas les droits d'accs du demandeur du transfert en ce qui concerne ce fichier. Si FOR=COMMUT (diffusion par un site intermdiaire) : La variable symbolique &SPART, identifiant rseau du partenaire metteur, peut tre utilise pour construire le nom du fichier (valeur du paramtre FNAME). Cela permet d'tablir une distinction entre les listes dfinies pour les diffrents sites metteurs. Les variables symboliques suivantes peuvent tre utilises : &FDATE, &FTIME, &FYEAR, &FMONTH, &FDAY &PART, &RPART, &SPART, &NPART, &GROUP &SUSER, &RUSER &SAPPL, &RAPPL &IDF, &PARM, &IDA {string 512} {string 64}

Manuel de rfrence

Les paramtres de CFT

4-31

&NIDF &NFNAME, &NFVER CFTRECV, RECV [FNAME = filename] {1...512} Nom du fichier rcepteur physique, nom de fichier ou nom de chemin complet du rpertoire. Lorsque la valeur du paramtre est entre guillemets, elle devient sensible la casse. Dans la configuration serveur rcepteur, l'utilisation de ce paramtre est obligatoire. Dans la configuration demandeur rcepteur, le nom de fichier peut tre dfini dans la commande de rception RECV ou dans l'objet CFTRECV. Except dans le cas de transferts improviss, l'utilisateur doit opter de prfrence pour la seconde solution. Vous pouvez dfinir le nom de fichier : soit dans la commande de rception ; soit dans l'objet CFTRECV (mthode recommande).
Pour recevoir... un fichier une version d'un fichier un groupe de fichiers concatns Entrez... un nom de fichier physique complet un nom de fichier avec une racine et un numro de version un nom de rpertoire

Cas spcifique de l'utilisation du nom de fichier complet Le nom de chemin complet inclut les noms des rpertoires, ou toute autre organisation spcifique l'environnement concern, utiliss pour regrouper les fichiers : bibliothque, catalogue, PDS, etc. Suivant l'environnement concern, l'utilisation d'un nom de chemin complet peut conduire la cration implicite d'une structure de chemin intgrale ou partielle. Un caractre spcifique, dpendant du systme d'exploitation, dlimite le chemin crer (rpertoires intermdiaires). Seuls les noms des sous-rpertoires qui apparaissent droite du caractre de dlimitation sont crs. Le nom de fichier peut : tre attribu de manire dynamique avec des variables symboliques ; correspondre au nom d'un fichier avec des versions (GDG, par exemple). Utilisation de variables symboliques Pour former la chane de caractres FNAME, vous pouvez utiliser les variables suivantes : &FDATE, &FTIME, &FYEAR, &FMONTH, &FDAY &SPART, &RPART, &PART, &IPART, &NPART, &GROUP &SUSER, &RUSER &SAPPL, &RAPPL &IDF, &PARM, &IDA &NIDF, &IDTU, &IDT &BDATE, &BTIME, &BYEAR, &BMONTH, &BDAY &NFNAME

Manuel de rfrence

Les paramtres de CFT

4-32

&NFVER Le caractre & utilis ici remplace le caractre char_symb spcifique chaque systme d'exploitation. Reportez-vous au Guide d'exploitation de Transfert CFT qui correspond votre systme d'exploitation. PeSIT E CFT/CFT Les variables &FUNIT, &FUNITC, &FPATH, &FROOT et &FSUF sont utilises de telle sorte que le paramtre FNAME donne le chemin complet dsignant le fichier crire. PeSIT D profil CFT, PeSIT E

Cas spcifique de la variable symbolique &NFNAME CFT/CFT)

L'utilisation de &NFNAME est valable uniquement si le moniteur est un serveur rcepteur. Cette variable n'est utilise que dans le mode ouvert. Rception d'un fichier avec versions MVS, VMS

Ce nom inclut une racine et un numro de version. Le fichier est reu comme le fichier temporaire dfini dans le paramtre WFNAME et doit concerner la version du fichier rcepteur + 1 (opration obligatoire avec RENAME). Le nom de fichier relatif est converti en un nom de fichier absolu la fin du transfert. Le fichier temporaire est ensuite renomm avec le nom dfini par FNAME. Remarque : lorsqu'un fichier temporaire est utilis, le paramtre WFNAME, des restrictions peuvent s'appliquer en rapport avec le systme d'exploitation. Sur les systmes IBM et GCOS7, par exemple, le type d'unit ne doit pas apparatre dans le nom du fichier FNAME. Rception d'un groupe de fichiers copis/concatns. Ce nom doit correspondre un nom de rpertoire si une opration de copie/concatnation est excute lors de l'mission des fichiers (transfert d'un groupe fichiers entre des systmes du mme type). Les donnes reues sont stockes dans le fichier temporaire spcifi dans le paramtre WFNAME. Les fichiers sont ensuite dconcatns dans le rpertoire spcifi par FNAME. CFTRECV partir d'une base VFM Nom du fichier logique de base de donnes de rception (FDB). Lorsque la valeur du paramtre est entre guillemets, elle devient sensible la casse. Remarque : le moniteur CFT utilise comme enveloppe de rception un fichier temporaire logique de la mme base VFM, dont le nom est : CFT.RECV.TEMP.&PART.&IDT o : &PART correspond l'identifiant local du partenaire ; &IDT correspond l'identifiant du transfert. Remarque : ce fichier temporaire ne doit pas tre accessible en lecture ni en criture. Ce fichier est protg par la mthode d'accs VFM pendant le transfert, mais n'est plus protg si le transfert est interrompu. A la fin du transfert, les donnes sont rellement affectes au fichier FNAME.

PeSIT E profil CFT/CFT

Manuel de rfrence

Les paramtres de CFT

4-33

CFTSEND, SEND [FNAME = {filename|mask|dirname|#filename|#mask|#dirname}] {string 512} Nom du fichier, rpertoire, fichier d'indirection, masque de slection ou rpertoire de slection local mettre. La longueur maximale d'une valeur de type nom de fichier est de 512 caractres. Ce changement n'affecte que le nom du fichier transfr (par exemple, le paramtre FNAME de la commande SEND). Cette longueur de nom de fichier ne concerne pas les fichiers de service ni les fichiers VFM. Lorsque la valeur du paramtre est entre guillemets, elle devient sensible la casse. Le nom du fichier d'indirection, du masque de slection ou du rpertoire de slection est prcd du caractre <file-symb> spcifique chaque systme. Dans la plupart des environnements, le caractre # est utilis. Reportez-vous au tableau des valeurs spcifiques du Guide d'exploitation de CFT qui correspond votre systme d'exploitation. Dans le mode d'exploitation serveur metteur avec mission implicite, l'utilisation du paramtre FNAME est obligatoire dans CFTSEND. Dans le mode d'exploitation demandeur metteur ou mode serveur metteur avec une mise en attente de la requte d'mission, le nom de fichier peut tre dfini dans la requte de transfert en mission (commande SEND ou appel CFTAPI) plutt que dans la commande CFTSEND. CFTSEND partir d'une base VFM Nom du fichier de base de donnes logique (FDB) mettre. La syntaxe des noms des fichiers logiques est dcrite dans la rubrique Utilitaire VFM. Ces noms peuvent inclure des caractres gnriques (un masque), dsignant ainsi le premier fichier logique dont le nom correspond ce masque. CFTLOG [FNAME = filename] Nom du fichier journal. Vrifiez que le fichier <filename> existe et qu'il est accessible ; sinon, les informations seront tronques sur la sortie CFTOUT standard et ne pourront pas tre utilises. Cela vaut galement lorsque le fichier journal courant est le fichier dfini par AFNAME. N'utilisez pas de noms logiques. CFTXLATE [FNAME = filename] {string 512} Nom du fichier contenant la description de la table de transcodage (1 enregistrement de 256 caractres). Ce fichier doit avoir une organisation squentielle. Des exemples de ces fichiers sont proposs avec les diffrents produits. Reportez-vous au Guide d'exploitation spcifique au systme. {string 64}

Manuel de rfrence

Les paramtres de CFT

4-34

force
CFTRECV [FORCE = {NO|YES}] Dtermine la priorit des paramtres dfinis dans CFTRECV par rapport ceux dfinis dans une commande RECV associe. NO : Les paramtres spcifis dans la commande RECV sont prioritaires sur ceux dfinis dans l'objet CFTRECV associ. Si, donc, un paramtre n'est pas dfini de manire explicite dans une commande RECV, mais l'est dans un objet CFTRECV, la valeur dfinie dans l'objet CFTRECV est prise en compte ; YES : Les paramtres spcifis dans la commande CFTRECV sont prioritaires sur ceux dfinis dans une commande RECV associe. Donc, si un paramtre n'est pas dfini de manire explicite dans un objet CFTRECV, mais l'est dans une commande RECV, ou si la valeur dfinie dans CFTRECV est la valeur par dfaut, la valeur dfinie dans la commande RECV est prise en compte. Un message informe les utilisateurs que leur commande a t partiellement prise en compte. CFTSEND [FORCE = {NO|YES}] Dtermine la priorit des paramtres dfinis dans CFTSEND par rapport ceux dfinis dans une commande SEND associe. NO : Les paramtres spcifis dans la commande SEND sont prioritaires sur ceux dfinis dans l'objet CFTSEND associ. Si, donc, un paramtre n'est pas dfini de manire explicite dans une commande SEND, mais l'est dans un objet CFTSEND, la valeur dfinie dans l'objet CFTSEND est prise en compte ; YES : Les paramtres spcifis dans la commande CFTSEND sont prioritaires sur ceux dfinis dans une commande SEND associe. Si, donc, un paramtre n'est pas dfini de manire explicite dans un objet CFTSEND, mais l'est dans une commande SEND, ou si la valeur dfinie dans CFTSEND est la valeur par dfaut, la valeur dfinie dans la commande SEND est prise en compte. Un message informe les utilisateurs que leur commande a t partiellement prise en compte. CFTRECV, CFTSEND Le tableau suivant rsume le traitement effectu par CFT sur un objet CFTRECV ou CFTSEND avec le paramtre FORCE dfini sur YES. Paramtres, valeurs par dfaut et traitement (FORCE = YES)
Paramtre EXEC, PARM, SAPPL, RAPPL, SUSER, RUSER, COMMENT, NFNAME, EXIT, WFNAME, SELFNAME, NOTIFY, USERID, GROUPID, XLATE, SPART Valeur par dfaut Chane vide Traitement lorsque FORCE = YES Si le paramtre n'est pas dfini ou est dfini sur une valeur en blanc, il peut tre annul pour une commande SEND/RECV. Si le paramtre est dfini sur une valeur relle, il ne peut pas tre annul pour une commande SEND/RECV. Si le paramtre est dfini sur <NULL> (nouveau mot cl rserv), il ne peut pas tre annul pour une commande SEND/RECV. Cela signifie que le paramtre est vide

Manuel de rfrence

Les paramtres de CFT

4-35

Paramtre FNAME

Valeur par dfaut Chane vide

Traitement lorsque FORCE = YES Si le paramtre n'est pas dfini, il doit tre annul pour une commande SEND/RECV (sinon le transfert chouera). Si le paramtre est dfini sur une valeur relle, il ne peut pas tre annul pour une commande SEND/RECV. Si le paramtre n'est pas dfini, il peut tre annul pour une commande SEND/RECV. Si le paramtre est dfini sur une valeur relle, il ne peut pas tre annul pour une commande SEND/RECV. Si le paramtre n'est pas dfini, il peut tre annul pour une commande SEND/RECV. Si le paramtre est dfini sur une valeur relle, il ne peut pas tre annul pour une commande SEND/RECV. Si le paramtre n'est pas dfini ou est dfini sur une valeur nulle, il peut tre annul pour une commande SEND/RECV. Si le paramtre est dfini sur une valeur relle, il ne peut pas tre annul pour une commande SEND/RECV.

FCODE, FRECFM, NCODE, NRECFM FTYPE, NTYPE, FACC

Caractre blanc

Caractre nul

FBLKSIZE, FKEYLEN, FKEYPOS, FLRECL, FSPACE, NBLKSIZE, NKEYLEN, NKEYPOS, NLRECL FORG SEQ PRI 128 STATE DISP FACTION NONE FDISP SHR NCOMP

Valeur nulle

Le paramtre ne peut pas tre annul Le paramtre ne peut pas tre annul Le paramtre ne peut pas tre annul Le paramtre ne peut pas tre annul 15 Si le paramtre n'est pas dfini ou est dfini sur la valeur 15, il peut tre annul pour une commande SEND/RECV. Sinon, il ne peut pas tre annul pour une commande SEND/RECV. Le paramtre ne peut pas tre annul Le paramtre ne peut pas tre annul Le paramtre ne peut pas tre annul Le paramtre ne peut pas tre annul <os dep.> LIST Le paramtre ne peut pas tre annul Le paramtre ne peut pas tre annul

DELETE TRK TCYCLECYCLE DAY0 OPERMSG EXECSUB

NON U non dfini

INACT, DELETE, END, HALT, KEEP, START, RESUME [FORCE = {NO|YES}] START [FORCE = {NO | YES}] Indique si une requte non excute pendant cette plage temporelle a t relance : NO : aucune action n'est excute (valeur par dfaut) ; YES : la requte est relance immdiatement si vous avez : soit un code de diagnostic (diagi) 302 ; soit une requte cyclique l'tat D. Le temps d'excution maximum pour une requte relance est 23595999.
o o

Manuel de rfrence

Les paramtres de CFT

4-36

Remarque : indpendamment de la valeur du paramtre FORCE, une commande START n'a pas d'incidence sur une requte qui n'a pas encore atteint le temps d'excution minimum.

for
CFTDEST Choisir parmi : BOTH (valeur par dfaut) : sur un moniteur local avec les fonctions LOCAL et COMMUT ; COMMUT : sur un moniteur local qui sert de site intermdiaire. Le moniteur reoit un fichier ou un message dont l'identifiant dans l'objet CFTDEST est dfini sur le nom rseau du destinataire. Il diffuse ensuite le fichier ou le message tous les partenaires de la liste ; LOCAL : sur un moniteur local, pour mettre (diffuser) ou recevoir (collecter) un fichier ou un message.

forg
CFTRECV, RECV, CFTSEND, SEND [FORG = {SEQ|DIRECT|INDEXED}] Organisation du fichier transfrer : SEQ : squentiel ; INDEXED : index ; DIRECT : accs direct (relatif). Avec certains systmes d'exploitation, le mcanisme de rception squentiel peut autoriser le chargement des donnes dans un fichier d'organisation non squentiel (normalement prexistant). Selon le cas, l'utilisation explicite de paramtres tels que FTYPE, FKEYLEN, FKEYPOS et FORG peut tre requise. Pour plus d'informations, reportez-vous au Guide d'exploitation Transfert CFT qui correspond votre systme d'exploitation.

format
CFTLOG [FORMAT = V23|V24] Paramtre facultatif. Indique le format des messages de journal. V23 (Valeur par dfaut) : La longueur de l'identifiant est tronque 8 caractres ; V24 : L'identifiant est affich en entier. La longueur de l'identifiant peut atteindre 32 caractres. Certains messages lis un transfert incluent la valeur IDTU (identifiant de compteur de transfert local). CFTACCNT [FORMAT = V23|V24] Paramtre facultatif. Le paramtre FORMAT indique s'il faut utiliser l'ancienne structure d'enregistrement (valeurs V23 pour des raisons de compatibilit) ou si la nouvelle structure (valeurs V24) doit tre applique. V23 (Valeur par dfaut) ; V24.

Manuel de rfrence

Les paramtres de CFT

4-37

CFTEXIT [FORMAT = V23|V24] Paramtre facultatif. Indique le format de la zone de communication. V23 (Valeur par dfaut) : la zone de communication entre CFT et la sortie de l'utilisateur reste la mme ; V24 : la zone de communication prend en compte la longueur du nouvel identifiant. Par exemple, la longueur de Part passe de 8 32, et la longueur de Filename de 64 512.

fout
DISPLAY [FOUT = file_name] Ce paramtre dfinit le fichier auquel la sortie de commande est envoye. Le nom du fichier reprsente le fichier o la commande DISPLAY redirige le message.

fparm
CFTEXT [FPARM = filename]

fpart
CFTEXT [FPARM = filename]

fprefix
CFTPART [FPREFIX = string1..512] Prfixe de nom de fichier. Ce paramtre est utilis pour associer un nom de fichier un partenaire. Pendant une opration d'mission ou de rception (CFTSEND ou SEND, CFTRECV ou RECV), cette valeur est concatne avec le nom spcifi dans le paramtre FNAME.

frecfm
CFTRECV, CFTSEND, SEND, RECV [FRECFM = {voir le Guide d'utilisation spcifique la plate-forme|F|U|V}] Format d'enregistrement du fichier rcepteur : F : fixe ; V : variable ; U : indfini. Les valeurs possibles pour chaque systme sont indiques dans le Guide d'utilisation correspondant.

Manuel de rfrence

Les paramtres de CFT

4-38

Rception : OS400, UNIX La notion de format variable est spcifique CFT et ne correspond pas une ralit pour les systmes indiqus. Un fichier rcepteur de format variable ne peut donc pas tre interprt directement par une application, car il contient des informations de contrle. En l'absence de spcification contraire, FRECFM = V n'est pas utilis. La notion de format variable est spcifique CFT et ne correspond pas une ralit pour les systmes indiqus. Le moniteur CFT peut ainsi mettre un fichier au format variable si ce fichier est gnr par une commande COPYFILE ou a dj t reu par CFT (Store and Forward, par exemple). En l'absence de spcification contraire, FRECFM = V n'est pas utilis.

Emission : OS400, UNIX

MVS Si ce paramtre n'est pas dfini, la valeur par dfaut est U.

free1
CFTETB [FREE1 = {pos, 255|len, content}] Position (pos), longueur (len) et contenu (content) du premier champ libre sur la carte de paramtrage. Le champ content est utilis pour dfinir une chane de caractres arbitraire change entre les partenaires, mais non traite par le moniteur CFT. La longueur de cette chane ne doit pas dpasser la longueur indique dans le champ len.

free2
CFTETB [FREE2 = {pos, 255|len, content}] Position (pos), longueur (len) et contenu (content) du second champ libre sur la carte de paramtrage. Le champ content est utilis pour dfinir une chane de caractres arbitraire change entre les partenaires, mais non traite par le moniteur CFT. La longueur de cette chane ne doit pas dpasser la longueur indique dans le champ long.

fspace
CFTRECV, RECV [FSPACE = {0|n}] Taille du fichier rcepteur, en kilo-octets (1 kilo-octet = 1024 octets). Cette taille correspond gnralement l'affectation principale. UNIX Paramtre non applicable

Manuel de rfrence

Les paramtres de CFT

4-39

CFTSEND, SEND [FSPACE = {0|n} Taille du fichier envoyer, en kilo-octets (1 kilo-octet = 1024 octets). En rgle gnral, il n'est pas ncessaire de dfinir ce paramtre, car chaque transfert, CFT rcupre automatiquement la taille du fichier qu'il va envoyer (si ncessaire, vrifiez dans le Guide d'exploitation que cette fonction est prise en charge par le systme en question). CFTFILE [FSPACE = {voir tableau|n}] {0..65536} Selon TYPE/SYSTME D'EXPLOITATON Affectation principale du fichier crer, exprime en kilo-octets (1024). Pour TYPE = COM et TYPE = CAT, ce paramtre ne doit pas tre dfini pour tout systme. L'affectation principale du fichier crer est dduite de la valeur du paramtre RECNB (nombre d'enregistrements dans le fichier). Le tableau ci-dessous indique, pour chaque systme, la valeur par dfaut prise en charge en fonction du type de fichier crer. Dans ce tableau, lorsque la valeur par dfaut de l'affectation principale du fichier crer est non , il n'est pas ncessaire de dfinir le paramtre FSPACE.
Tableau FSPACE Systme dexploitation GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE Windows PARM 512 200 100 50 512 non 50 non 0 50 non PART 700 200 100 100 512 non 100 non 0 100 non CAT non non non non non non non non non non non COM non non non non non non non non non non non LOG non 100 2 200 512 non 200 non 0 200 non ACCNT non 100 2 200 512 non 200 non 0 200 non

fspacex
CFTFILE [FSPACEX = {voir le tableau ci-dessous | n}] {0..65536}

Manuel de rfrence

Les paramtres de CFT

4-40

Selon TYPE/SYSTME D'EXPLOITATON Affectation secondaire du fichier crer, exprime en kilo-octets (1024). Le tableau ci-dessous indique, pour chaque systme, la valeur par dfaut prise en charge en fonction du type de fichier crer. Dans ce tableau, lorsque la valeur par dfaut de l'affectation secondaire du fichier crer est non , il n'est pas ncessaire de dfinir le paramtre FSPACEX.
Tableau FSPACEX Systme dexploitation GCOS7 GCOS7 GUARDIAN MVS Netware OS2 OS400 UNIX VM VMS VOS VSE Win95 WinNT PARM non non 100 50 non non 0 non 50 non 0 50 non non PART non non 100 100 non non 0 non 100 non 0 100 non non CAT non non non 0 non non 0 non 0 non 0 0 non non COM non non non 0 non non 0 non 0 non non 0 non non LOG non ILLIMITE 2 50 non non 0 non 50 non 0 50 non non ACCNT non 5000 2 50 non non 0 non 50 non 0 50 non non

CFTSEND, CFTRECV

ftype
Type de fichier rcepteur. Dans certaines configurations client/serveur, le fichier local peut tre prsent physiquement sur un autre ordinateur que celui sur lequel CFT est excut. Reportez-vous au Guide d'exploitation CFT correspondant votre systme d'exploitation. CFTRECV, CFTSEND [FTYPE = {voir "Guide d'exploitation" | c}] OS Type du fichier rcepteur. Dans certaines configurations de type client/serveur, le fichier local peut tre prsent physiquement sur un ordinateur autre que celui sur lequel CFT est excut. Reportez-vous au Guide d'exploitation CFT correspondant votre systme d'exploitation.

Manuel de rfrence

Les paramtres de CFT

4-41

gateway
CFTNET, TYPE= SNA [GATEWAY = string] Nom de la passerelle SNA utilise pour connecter le rseau DECnet au rseau SNA lorsque cette option matrielle est choisie. CFTX25 [GFA = (n, n, ...)] Numro de groupe ferm d'usagers (CUG) ou liste de numros. Un numro CUG, selon sa position dans la liste, est associ un numro d'appel X.25 (paramtre DIALNO de la mme commande). Cette liste peut contenir jusqu' 4 numros.

group
CFTPART [GROUP = identifier] Groupe auquel appartient le partenaire. Ce paramtre est employ pour dfinir localement la variable symbolique &GROUP. Cette variable symbolique peut tre utilise pour nommer un fichier (FNAME = &GROUP) ou une procdure de fin de transfert (par exemple, EXEC = &GROUP).

groupid
CFTRECV, CFTSEND [GROUPID = string32] Information pour complter USERID. Entrez un identifiant de groupe comportant jusqu' 32 caractres alphanumriques pour l'utilisateur. La valeur entre dpend du systme d'exploitation. CFTAPPL [GROUPID = string32] Information pour complter USERID.

habfname
CFTFILE (TYPE = PARM, PART, COM, CAT) [HABFNAME = fname] {STRING 64} Nom du fichier d'initialisation du systme de scurit. Pour que la scurit du systme soit active, ce paramtre doit tre dfini pour le fichier de paramtrage, le fichier de dfinition des partenaires et le fichier catalogue.

Manuel de rfrence

Les paramtres de CFT

4-42

hide99
CFTPROT [HIDE99 = {YES|NO}] Nouveau paramtre optionnel disponible uniquement pour la description du protocole PeSIT (TYPE=PESIT) en utilisant le profil ANY (PROFIL=ANY/CFT). NO (Valeur par dfaut) : aucune information n'est cache dans PI99 (code PI de message libre) ; YES : masque les informations prives transportes par le protocole (chemin local physique du fichier).

highport
CFTNET, TYPE = TCP [HIGHPORT = {65535|n}] Dfinit la limite suprieure pour la plage des ports sortants (valeur incluse). Valeurs possibles : 1 65535 ; La valeur par dfaut est 65535. Voir aussi LOWPORT. CONFIG, TYPE=COM, MEDIACOM=TCPIP [HIGHPORT = {65535|n}]

host
CFTNET, TYPE = TCP [HOST = string64] Adresse IP rseau de la ressource locale. Vous pouvez entrer jusqu' 64 caractres alphanumriques par adresse, qui peut tre soit une adresse IP relle en notation pointe (par exemple : 192.9.200.10) ; soit un nom logique HOSTNAME associ l'adresse IP relle et configur dans le fichier de base de donnes correspondant (HOST) fourni avec tout module TCP/IP. Adresses des proxies dans le premier rseau - jusqu' quatre proxies dans le mme premier rseau. Une adresse peut tre exprime sous la forme d'une adresse IP (format numrique nnn.nnn.nnn.nnn) ou d'un nom d'hte. Si plusieurs adresses sont indiques, CFT quilibre la charge entre elles, en fonction du nombre de connexions dj tablies. CFTCOM, TYPE = TCPIP [HOST = string64] Adresse IP rseau de la ressource locale. CFTTCP, TYPE = TCP [HOST = string64] Adresse IP rseau de la ressource locale.

Manuel de rfrence

Les paramtres de CFT

4-43

iblksize
COPYFILE [IBLKSIZE = {taille de bloc du fichier d'entre|n}] {0...65535} Dfinit la taille de bloc du fichier d'entre en octets. La valeur doit tre suprieure la valeur du paramtre ilrecl. Le tableau indique, pour chaque systme rpertori, si le paramtre iblksize est utilis.
Systme dexploitation GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE Windows IBLKSIZE OUI OUI NON OUI OUI NON NON NON NON OUI NON

icode
COPYFILE [ICODE = ASCII, EBCDIC] Paramtre COPYFILE qui code les donnes du fichier d'entre.

icomp
COPYFILE [ICOMP = {0|cpr},] Compresse les donnes du fichier d'entre. La valeur 0 signifie qu'il n'y a pas de compression. Les valeurs possibles (cpr) sont indiques dans Compression.

ict
COPYFILE [ICT = {H|C},] Type de compression des donnes du fichier d'entre : C : compression de CFT CFT ; H : compression PeSIT non-SIT.

Manuel de rfrence

Les paramtres de CFT

4-44

Ce paramtre est significatif uniquement si la valeur de ICOMP est diffrente de 0. La valeur de ICOMP doit tre compatible avec le type de compression.

id
Identifiant. La longueur maximale d'une valeur de type identifiant est de 32 caractres. Cela vaut pour toutes les commandes de CFT. CFTAUTH [ID = identifier] Identifiant de liste d'autorisations. Si la valeur identifier commence par les caractres NOT, les IDF dsigns par cette commande sont bloqus pour le partenaire correspondant ; les autres IDF sont autoriss. Si la valeur identifier ne commence pas par les caractres NOT, les IDF dsigns par cette commande sont autoriss pour le partenaire correspondant ; les autres IDF sont bloqus. L'utilisation d'une liste d'autorisations ncessite que l'id soit dfini dans les mots cls CFTPART SAUTH ou RAUTH. CFTCAT [ID = identifier] Identifiant pour l'objet CFTCAT. CFTDEST [ID = identifier] Identifiant de la liste des partenaires. Cet identifiant doit tre unique. Vous ne pouvez pas avoir plusieurs CFTDEST avec le mme ID. CFTETB [ID = identifier] Identifiant local du paramtre ETEBAC. Il doit tre identique l'identifiant de la commande CFTPART qui l'utilisera. La valeur conventionnelle ALL dsigne tous les partenaires . En mode demandeur, la carte de paramtrage comprend : soit la description CFTETB a le mme ID que l'identifiant du partenaire concern ; soit, si cette description n'existe pas, la description CFTETB ID = ALL. En mode serveur, la description CFTETB ID = ALL est toujours utilise pour dcoder la carte de paramtrage reue (le partenaire est actuellement non connu). CFTEXIT [ID = identifier] Voir le tableau des identifiants ci-dessous Identifiant de commande (32 caractres).

Manuel de rfrence

Les paramtres de CFT

4-45

Table des identifiants d'Exit La valeur de l'identifiant correspond l'identifiant dans les commandes connexes rpertories ci-aprs.
Type d'EXIT Annuaire ETEBAC Fichier Fin de fichier Commande CFTPROT CFTPROT CFTSEND, SEND, CFTRECV, RECV CFTPARM Paramtre EXITA EXIT EXITE EXIT EXITEOT

CFTPARM [ID = identifier] Identifiant de la commande CFTPARM. Cette valeur, transmise comme paramtre d'activation, dcrit une configuration du moniteur. Exemple : CFTMAIN parm1 Le moniteur est dmarr avec CFTPARM id = parm1. Si aucune valeur n'est utilise, le moniteur utilise la valeur par dfaut 'IDPARM0'. CFTPART [ID = identifier] Identifiant du partenaire local. CFTPROT [ID = identifier] Identifiant de la commande CFTPROT. Pour tre utilis, ce nom doit tre rfrenc dans les valeurs prises par le paramtre CFTPARM PROT. CFTLOG [ID = identifier] Identifiant de la commande CFTLOG. CFTXLATE [ID = identifier] Identifiant de la table de transcodage. Plusieurs commandes CFTXLATE peuvent avoir le mme identifiant, si les valeurs de DIRECT, FCODE ou NCODE sont diffrentes. CFTRECV [ID = identifier] Identifiant de fichier type local (IDF) La valeur COMMUT de ce paramtre prend une signification particulire pour CFT : elle correspond la description des fichiers reus en tant que partenaire intermdiaire.

Manuel de rfrence

Les paramtres de CFT

4-46

Pour que le mode commutation (Store and Forward) soit accept, la commande (CFTRECV ID = COMMUT) doit tre personnalise de manire explicite sur le site de commutation. Sinon, le mode commutation est refus. PeSIT profil SIT Pour PeSIT profil SIT, l'identifiant du fichier type est soumis la contrainte de format (Fnnnnn). [POUR PLUS DE DETAILS : Protocoles : PeSIT ]

CFTSEND [ID = identifier] Identifiant local du fichier type (IDF) envoyer. PeSIT profil SIT Dans le protocole PeSIT avec le profil SIT, l'identifiant du fichier type est soumis la contrainte de format (Fnnnnn) [FOR DETAILS: Protocoles : PeSIT ]

Network id
Identifiant de ressource rseau. Les noms SNA et X.25 ne sont pas autoriss. CFTACCNT, CFTCOM, CFTIDF, CFTLU62, CFTNET, CFTTCP, CFTTRACE, CFTAPPL, CFTSSL, CFTX25, CFTEXT, LISTPARM, LISTPART [ID = identifier]

ida
SEND, RECV, LISTCAT, END, START, SUBMIT, KEEP, HALT, DELETE, DISPLAY, RESUME [IDA = identifier] Identifiant de transfert local assign par l'utilisateur ou l'application de l'utilisateur. Cet identifiant peut tre un critre de recherche pour le poste catalogue associ ce transfert (voir la commande LISTCAT). Plusieurs postes catalogue peuvent tre associs un IDA donn. Ce paramtre a une longueur maximale de 64 caractres.

idf
END, START, KEEP, HALT, SUBMIT, DELETE, LISTCAT, DISPLAY, RESUME, KSTATE [IDF = identifier] Identifiant de type de fichier. Plusieurs postes catalogue peuvent tre associs un IDF donn. Il n'existe pas de valeur par dfaut. Si un ensemble de transferts est slectionn, les transferts sont traits par lots de 20 toutes les 5 secondes. CFTAUTH [IDF = {identifier|mask, identifier|mask} ] Liste d'IDF autoriss ou bloqus. Spcifiez une liste comprenant jusqu' 200 identifiants de fichiers types.

Manuel de rfrence

Les paramtres de CFT

4-47

La valeur associe chacun de ces idf peut tre : un identifiant de fichier explicite ; un masque. CFTETB [IDF = identifier] Identifiant local du fichier type associ ce format de carte (ID de CFTSEND/ CFTRECV). Si ce paramtre n'est pas dfini (valeur par dfaut = 8 caractres blancs), la carte convient pour tous les fichiers types. En mode demandeur, la carte de paramtrage comprend : soit une description de CFTETB, o l'IDF est gal l'identifiant de fichier type de la requte de transfert ; soit la description CFTETB IDF = si la description ci-dessus n'existe pas. En mode serveur, la description CFTETB IDF = est toujours utilise pour dcoder la carte de paramtrage reue Les descriptions suivantes sont donc requises pour le fonctionnement en mode serveur : CFTETB CFTETB CFTPART [IDF = identifier] Identifiant de 32 caractres par dfaut du fichier pour le partenaire. Ce partenaire permet de dsigner un nom gnrique pour chaque partenaire lorsque l'IDF dans l'objet n'existe pas dans la base des paramtres. Ce nom, valide pour les transferts en mission (SEND) et les transferts en rception (RECV), est prioritaire sur le paramtre DEFAULT de l'objet CFTPARM. CFTPROT [IDF = string64] Utilis pour attribuer un IDF un fichier lors de la rception d'un NIDF dont la longueur excde 8 caractres. Ce paramtre peut tre utilis en : mode serveur (metteur ou rcepteur) ; mode demandeur rcepteur suite l'activation d'une commande RECV IDF=<mask>. La valeur de ce paramtre peut tre : explicite : dans ce cas, la chane de caractres autorise ne doit pas dpasser 8 caractres ; obtenue partir d'une ou plusieurs sous-chanes de la variable symbolique &NIDF (correspondant au NIDF reu) ; la longueur de la chane de caractres ne doit pas compter plus de 64 caractres. Voir la dfinition d'une sous-chane d'une variable symbolique dans la section Variables symboliques du guide Concepts de CFT. DIRECT DIRECT = = SEND, RECV, ID ID = = ALL, ALL, IDF IDF = =

Manuel de rfrence

Les paramtres de CFT

4-48

Exemple : Pour un NIDF reu contenant 19 caractres, IDF peut prendre la valeur : IDF=&2.3NIDF&12.5NIDF. La longueur de la chane ne doit pas dpasser 64 caractres. La longueur de la chane ne doit pas dpasser 8 caractres aprs la substitution des variables. Dans l'exemple ci-dessus, la longueur de la valeur IDF est : avant substitution : 17 caractres ; aprs substitution : 8 caractres. SEND IDF = identifier RECV IDF = {identifier|mask} CFTNET [IDF = string32]

idm
CFTSEND, SEND [IDM = identifier] {string 33} Identifiant de message. Cet identifiant ne correspond pas un modle dfini par un objet CFTSEND comme dans le cas du paramtre IDF de la commande SEND TYPE = FILE, ou TYPE = REPLY. La valeur de cet identifiant n'est pas limite. Cet identifiant peut tre un critre de recherche pour le poste catalogue associ ce transfert. Plusieurs postes catalogue peuvent tre associs un IDM donn.

idt
HALT, END, KEEP, SUBMIT, START, DELETE, LISTCAT, DISPLAY, RESUME [IDT = { *|transid}] Identifiant de transfert. Identifie un transfert pour un partenaire et un sens de transfert donns. La valeur '*' signifie qu'aucune slection n'est requise sur le paramtre IDT (valeur par dfaut). SEND TYPE = REPLY [IDT = transid] Lors de l'envoi de rponses, cet identifiant correspond l'IDT de transfert d'origine et, par consquent, au poste catalogue correspondant ( l'tat RT ou RX, dans le catalogue). Sa valeur est une chane de 8 caractres, dfinie comme suit : une lettre pour le MOIS (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) ;

Manuel de rfrence

Les paramtres de CFT

4-49

un chiffre pour les DIXIEMES DE SECONDE (0 5). Pour une commande d'mission de rponse, utilise par une procdure de fin de rception de fichier (occurrence la plus courante), la variable symbolique &IDT permet de dfinir la valeur de ce paramtre IDT afin de rcuprer l'identifiant de transfert associ au fichier reu.

idtu
HALT, RESUME, LISTCAT, START, KEEP, DELETE, SUBMIT, END, DISPLAY, KSTATE [IDTU = * |string8] Identifiant du catalogue. Il s'agit d'une rfrence locale unique d'un transfert. Entrez une chane de 8 caractres qui peut tre un masque.

ifname
COPYFILE [IFNAME = filename] {string 512} Nom du fichier d'entre copier.

iform
PKICER IFORM = {PKCS12|DER|PEM|PKCST} Format du certificat importer. Utilis dans l'outil PKIUTIL.

ikform
PKICER IKFORM = {PKCS8|DER|PEM} Utilis dans l'outil PKIUTIL. Format de la cl prive importer.

ikname
PKICER IKNAME = filename Utilis dans l'outil PKIUTIL. Fichier partir duquel la cl prive associe un certificat d'utilisateur doit tre importe ou mise jour.

ikpassw
PKICER IKPASSW = {string64|filename} Utilis dans l'outil PKIUTIL. Mot de passe de protection du fichier source. Ce mot de passe doit tre spcifi pour les formats de cl prive crypte PKCS#8 et de certificat PKCS#12. Il peut tre spcifi par une valeur ou une rfrence un fichier. Si le mot de passe est une rfrence un fichier, le premier enregistrement du fichier est le mot de passe. Le nom de fichier doit tre prcd d'un signe #.

Manuel de rfrence

Les paramtres de CFT

4-50

ilrecl
COPYFILE [ILRECL = {voir le commentaire|n}] {0..32768} Pour les enregistrements de : format fixe (IFRECFM = F) : taille d'enregistrement du fichier d'entre ; format variable (IFRECFM = V) : taille d'enregistrement maximale. ILRECL est exprim en octets. Si ILRECL est infrieur la longueur d'enregistrement relle et si : le fichier d'entre est compress, le traitement est interrompu ; le fichier d'entre n'est pas compress, l'enregistrement est tronqu la longueur spcifie. Si ILRECL est suprieur la longueur relle de l'enregistrement crire et si : le fichier est dans un format fixe (IRECFM = F), l'enregistrement est complt avec des espaces , c'est--dire en fonction de la valeur du paramtre ICODE : x20 si ICODE = ASCII ; o x40 si ICODE = EBCDIC ; le fichier n'est pas dans un format fixe, ce paramtre est ignor.
o

Valeurs par dfaut : pour les systmes qui grent le concept d'enregistrement de fichier : taille relle des enregistrements du fichier d'entre. Pour les systmes ci-dessous qui ne grent pas ce concept : UNIX, WinNT 512 pour les fichiers texte (ITYPE = T, X ou O). 4096 pour les fichiers binaires ou de variables (ITYPE = {B | V}). 2048. Lorsque IRECFM = F, il est recommand de toujours spcifier ILRECL. Lorsque IRECFM = V, ILRECL doit toujours tre spcifi lorsque la taille d'enregistrement risque d'tre suprieure 2048.

VOS

imaxtime
CFTPART, CFTLU62, CFTX25, CFTTCP, CFTASY, CFTSNA [IMAXTIME = {23595999|time}] Heure maximale de la plage temporelle autorise pour les appels arrivant sur ce type de rseau, ou avec un partenaire s'il est dfini dans CFTPART, au-del de laquelle le partenaire ne peut plus tre appel.

Manuel de rfrence

Les paramtres de CFT

4-51

imintime
CFTPART, CFTLU62, CFTX25, CFTTCP, CFTASY, CFTSNA [IMINTIME = {0|time}] Heure minimale de la plage temporelle autorise pour les appels arrivant sur ce type de rseau, ou avec un partenaire s'il est dfini dans CFTPART, avant laquelle le partenaire ne peut pas tre appel.

impl
CFTSEND [IMPL = {NO|YES}] Emission implicite. Lorsque CFT fonctionne en mode serveur metteur et qu'aucune commande SEND (state=HOLD) n'est entre dans le catalogue pour cet identifiant de fichier, le paramtre IMPL dfini sur YES autorise le moniteur CFT rendre le fichier correspondant disponible en gnrant automatiquement une requte d'mission. Le fichier devient ainsi disponible en permanence. Pour la description du fichier type par dfaut, ce paramtre doit tre dfini sur NO. Vous pouvez dfinir deux objets CFTSEND avec le mme ID, avec impl = NO pour l'un et impl = YES pour l'autre. Procdez ainsi lorsque l'IDF doit tre utilis pour l'mission implicite plutt que pour l'envoi implicite.

iname
PKICER [INAME = filename] Utilis dans l'outil PKIUTIL. Fichier source contenant le certificat importer ou mettre jour. Ce paramtre n'est pas autoris en mode DELETE (suppression).

inet
CFTNET, TYPE = TCP INET = {string 8} Identifiant de la commande CFTNET dfinissant l'accs au premier rseau.

ipart
CFTPART [IPART = identifier] Identifiant local d'un partenaire intermdiaire. La valeur identifier doit correspondre au paramtre ID d'un objet CFTPART. Ce paramtre est impliqu dans le mcanisme de commutation ou de sauvegarde des fichiers. SEND [IPART = identifier]

Manuel de rfrence

Les paramtres de CFT

4-52

irecfm
COPYFILE [IRECFM = {voir le Guide d'exploitation spcifique|F|V|U}] OS Les valeurs possibles pour chaque systme d'exploitation sont indiques dans le Guide d'exploitation correspondant votre systme d'exploitation. Si le fichier d'entre est compress (ICOMP diffrent de 0), la valeur du paramtre IRECFM est force V. OS400, UNIX Le concept de format variable est spcifique CFT et n'est pas valable pour les systmes indiqus.

Reportez-vous au Guide d'exploitation CFT qui correspond votre systme d'exploitation.

itype
COPYFILE ITYPE = { ' '|character} PKICER de l'outil PKIUTIL, le type du fichier d'entre, qui dpend du systme d'exploitation. Les types de certificat sont les suivants : All - le certificat n'est pas contrl ; User - certificat utilisateur ; Root - certificat d'autorit racine ; Inter - certificat d'autorit intermdiaire.

key
CFTPARM KEY = {string 80} Cl utilisateur de CFT. Vous pouvez entrer jusqu' 80 caractres. Cette cl peut tre : CPU : pour limiter l'utilisation du logiciel aux ordinateurs caractriss par un numro de modle et un numro de srie ; DATE : pour limiter l'utilisation du logiciel une priode donne ; LABEL (ou texte) : pour limiter l'utilisation du logiciel un objet spcifique dsign par une tiquette. Entrez l'un des lments suivants entre guillemets : cl utilisateur fournie par Axway ; nom du fichier d'indirection qui contient l'ensemble de cls associ au moniteur CFT. Cl utilisateur de CFT, dont la valeur est fournie par Axway, ou nom du fichier d'indirection (prcd du caractre <file-symb> spcifique chaque systme) contenant l'ensemble de cls associ au moniteur. La valeur du paramtre doit tre dfinie entre guillemets simples (). Cette cl est associe aux conditions contractuelles d'utilisation du logiciel. Elle est spcifique au systme d'exploitation hte du produit et limite l'utilisation de CFT un

Manuel de rfrence

Les paramtres de CFT

4-53

nombre maximum de transferts simultans (limite du paramtre MAXTRANS) ou une option commerciale le cas chant. La cl limite galement l'utilisation de CFT, suivant le type de cl utilis. La cl peut correspondre l'un des types suivants : CPU Ce type de cl sert la protection en rapport avec l'utilisation d'un logiciel supplmentaire spcifique. Son rle principal est de limiter l'utilisation du logiciel CFT aux ordinateurs caractriss par un numro de MODLE et un numro de SRIE. DATE Ce type de cl peut tre utilis pour tous les environnements systme. Le rle de cette cl consiste limiter le temps d'utilisation du logiciel CFT jusqu' une date spcifie au moment du calcul de la cl. LABEL Ce type de cl peut tre utilis pour tous les environnements systme. Le rle de cette cl consiste limiter l'utilisation du logiciel CFT un objet spcifique dsign par une tiquette. Par exemple : utilisation limite l'entreprise du client.

Keyext

language
CFTEXIT, CFTACCNT [LANGUAGE = {COBOL|C}] Choisissez le langage de programmation de l'application qui utilise les donnes statistiques dans la liste droulante. COBOL (valeur par dfaut) : si ncessaire, les donnes sont compltes avec des blancs ; C : si ncessaire, les champs de donnes sont complts avec des zros binaires.

lenappl
CFTPARM [LENAPPL = {32|n}] {1...32} Longueur prendre en compte lors de la comparaison de l'identifiant du fichier/message (IDF ou IDM) avec l'identifiant d'une commande CFTAPPL. Voir Affectation d'un propritaire un transfert :CFTAPPL pour plus d'informations. Entrez la longueur d'identifiant utiliser lors de la comparaison de l'identifiant du fichier/message (idf ou idm) avec l'identifiant d'un objet CFTAPPL : 32 (valeur par dfaut) ; une valeur comprise entre 1 et 32.

length
CFTLOG [LENGTH = {160|n}] {0..1024} Taille des enregistrements du fichier journal. En gnral, cette valeur ne doit pas tre modifie.

Manuel de rfrence

Les paramtres de CFT

4-54

lineid
CFTNET [LINEID = string 33] Dcrit la ressource physique locale. Utilisez ce champ pour spcifier l'identifiant de la ressource asynchrone qui caractrise le port de communication. Entrez une chane comportant jusqu' 32 caractres. La longueur de la chane entre dpend du rseau et du systme d'exploitation. Le tableau suivant indique, pour chaque systme d'exploitation qui utilise le paramtre, le nombre maximum de caractres dfinir et la signification du paramtre. CFTNET TYPE = X25 LINEID - Valeurs des paramtres
Systme dexploitation GCOS7 Nombre maximum de caractres 4 Signification de la valeur LINEID

Abonnement slectionner par AX25 pour les appels sortants Correspond un objet "NS" du contrleur de communications DATANET Abonnement slectionner par AX25 pour les appels sortants Correspond un objet "NS" du contrleur de communications DATANET Nom physique de la ligne X25 dfini pendant l'installation Exemple : LINEID=$X25 Nom de la MCH LU de la ligne X25 prise en charge par cette ressource Voir OS2 Nom du fichier excutable initialisant cette ressource Le nom dpend du type d'ordinateur (voir le guide spcifique) Nom de la MCH LU de la ligne X25 prise en charge par cette ressource Constitu des lments suivants : nom rseau tel qu'il est connu par PSI (par exemple TRANSPAC) ; caractre de sparation % ; n de l'quipement terminal de traitement de donnes (un numro Transpac, par exemple).

GCOS8

GUARDIAN MVS Netware UNIX

8 8 32 32

VM VMS

8 32

VOS VSE Windows

32 8 32

Nom de la passerelle identifiant la ligne Nom de la MCH LU de la ligne X25 prise en charge par cette ressource Constitue des lments suivants : caractres X25 ; caractre de sparation / ; un identifiant supplmentaire avec une signification diffrente selon X25.

Manuel de rfrence

Les paramtres de CFT

4-55

locadr
CFTNET [LOCADR = {00|string2}] Adresse rseau locale, exprime en hexadcimal, de la premire unit logique (LU) du groupe. Remarque : sur le host, ce paramtre est exprim en dcimal dans la dfinition VTAM de l'unit logique (LU) correspondante.

log
CFTPARM [LOG = identifier] Identifiant de la commande de description du journal des vnements du moniteur (CFTLOG). Si ce paramtre n'est pas dfini, le moniteur CFT crit les messages de journalisation dans la sortie standard du moniteur.

logmode
CFTSNA [LOGMODE = string8] Nom d'un mode de journalisation.

logon
CFTPRO [LOGON = {YES|NO}] Utilisation de la phase de prconnexion. Disponible en mode demandeur uniquement. Yes : cette phase est utilise. Le demandeur envoie un message ; No : cette phase n'est pas utilise. Aucun message n'est envoy.

lowport
CFTNET [LOWPORT = {5000|n}] TCP/IP uniquement. Dfinit la limite infrieure pour la plage des ports sortants (valeur incluse). valeurs possibles : 0 65535. La valeur 0 permet au systme de slectionner le numro du port sortant ; la valeur par dfaut est 5000. Voir aussi HIGHPORT. CONFIG TYPE=COM, MEDIACOM=TCPIP [LOWPORT = {5000|n}]

Manuel de rfrence

Les paramtres de CFT

4-56

mac
CFTFILE Requte d'authentification de fichier. Ce paramtre concerne le fichier de paramtrage et le fichier du partenaire (TYPE = PARM or PART).

maction
CFTRECV, RECV [ MACTION = {' '|replace}] Action sur les fichiers transfrs par copie au moment de la cration. : si les fichiers existent dj dans le rpertoire de rception, la copie de ces fichiers est ignore ; REPLACE : si les fichiers existent dj dans le rpertoire, ils seront remplacs.

maxcnx
CFTNET [MAXCNX = {32|n}] {0..MAXTRANS value} Nombre maximum de connexions simultanes que CFT accepte d'tablir sur une ressource rseau donne. entrez une valeur comprise entre 0 et la valeur MAXTRANS ; la valeur par dfaut est 32. Cette valeur doit tre cohrente avec le paramtre MAXTRANS (dans les rseaux X.25) de CFTPARM et avec l'environnement rseau concern. Par exemple : cohrence avec le nombre de voies logiques disponibles. MVS, VSE Sur X25 : cohrence avec la dfinition de noeud de commutation VTAM.

maxdate
CFTRECV, RECV [MAXDATE = {voir commentaire|date}] Uniquement en mode demandeur Date finale de validit du transfert. La valeur date peut tre exprime : de manire explicite (date absolue) ; ou, dans les commandes RECV, par rapport la date laquelle la commande est prise en compte. Cette valeur est alors exprime en nombre de jour. Exemple : MAXDATE = +4 signifie que la date finale de validit du transfert correspond la date laquelle la commande est prise en compte plus 4 jours. La valeur par dfaut est attribue par le moniteur en fonction du contexte du transfert.

Manuel de rfrence

Les paramtres de CFT

4-57

CFTSEND, SEND [MAXDATE = {voir commentaire|date}] En mode demandeur uniquement Date finale de validit du transfert. En mode initiateur uniquement Spcifie le dernier jour de la plage temporelle pour l'activation des transferts diffrs. Il peut tre exprim : de manire explicite (date absolue) ; par rapport la date laquelle la commande est prise en compte. Cette valeur est alors exprime en nombre de jour. La valeur par dfaut est attribue par le moniteur en fonction du contexte du transfert. si MAXTIME est suprieur MINTIME MAXDATE = MINDATE ; si MAXTIME est infrieur MINTIME MAXDATE = MINDATE+1 ; si MAXTIME est omis MAXDATE = 99991231. Exemple : MAXDATE = +4 signifie que la date finale de validit du transfert correspond 4 jours aprs la date laquelle la commande est prise en compte.

maxrec
CFTACCNT [MAXREC = n] Nombre maximum d'enregistrements du fichier statistique. Si ce paramtre n'est pas dfini, la seule limite connue du moniteur CFT est celle impose par le gestionnaire de fichiers du systme d'exploitation. CFTLOG [MAXREC = {0|n}] {0...32767} Nombre d'enregistrements crits dans le fichier journal partir desquels la bascule automatique sera excute. MAXREC=0 signifie qu'il n'existe aucune bascule automatique dpendant du nombre d'enregistrements dans le fichier.

maxtask
CFTPARM MAXTASK = {maximum supported|n} {1..voir tableau ci-dessous} Entrez le nombre de tches d'accs aux fichiers autorises Windows : bien que le champ ne soit pas affich, il est dfini sur 1. Nombre de tches d'accs aux fichiers autorises.

Manuel de rfrence

Les paramtres de CFT

4-58

Le tableau suivant indique le nombre maximum pris en charge pour chaque systme.
Systme dexploitation GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE Windows Nombre maximum 4 30 2 240 32 8 64 8 10 64 1

maxtime
CFTRECV, CFTSEND, SEND, RECV [MAXTIME = {23595999|time}] Pris en compte uniquement en mode demandeur Heure limite de validit du transfert pour la date finale (MAXDATE). La valeur time peut tre exprime : de manire explicite (heure absolue) ; ou, dans les commandes RECV ou SEND, par rapport l'heure laquelle la commande est prise en compte. Dans ce cas, l'heure absolue correspondante doit tre infrieure 24 heures. La valeur indique est exprime en minutes Exemple : MAXTIME = +180 signifie que l'heure limite de validit du transfert est l'heure laquelle la commande est prise en compte plus 180 minutes. Cette heure d'acceptation doit tre infrieure 21 heures. MAXTIME ne doit pas tre gal MINTIME, sauf si MAXDATE est dfini et ne correspond pas la date courante.

maxtrans
CFTPARM [MAXTRANS = {n}] Nombre maximum de transferts simultans autoriss pour la session : 16 : valeur par dfaut pour Windows ; 64 : valeur par dfaut pour UNIX ; 240 : valeur par dfaut pour MVS ; toute autre valeur :
o o

1 128 pour Windows ; 1 256 pour UNIX ;

Manuel de rfrence

Les paramtres de CFT

4-59

1 240 pour MVS.

Cette valeur dfinit la limite physique pour le produit, indpendamment de la limite dfinie par la cl de protection logicielle.

mediacom
CONFIG TYPE = COM [MEDIACOM = {FILE|MBX|TCPIP|UNDF}] Dfinit le type du mdia de communication si ce mdia est pertinent pour le systme. Les valeurs possibles sont les suivantes : FILE pour les communications de type fichier ; MBX pour les communications de type bote aux lettres ; TCPIP pour les communications synchrones prises en charge par TCP/IP ; UNDF le media de communication est dfini dans le fichier qui est dclar dans le paramtre FNAME.

mindate
CFTRECV, CFTSEND, SEND, RECV Pris en compte uniquement en mode demandeur [MINDATE = {current system date|date}] Date de validit minimale du transfert. La valeur date peut tre exprime : de manire explicite (date absolue) ; ou, dans les commandes RECV ou SEND, par rapport la date laquelle la commande est prise en compte. Cette valeur est alors exprime en nombre de jour. Exemple : MINDATE = +2 signifie que la date de validit initiale du transfert quivaut la date laquelle la commande est prise en compte plus 2 jours.

minlch
CFTNET [MINLCH = {1|n}] {0..512} OS400 Numro de la premire voie logique utiliser.

mintime
CFTSEND, CFTRECV, RECV, SEND En mode demandeur [MINTIME = {00000000|time}] Heure de validit initiale du transfert, partir du premier jour (MINDATE). La valeur time peut tre exprime : de manire explicite (heure absolue) ; ou, dans les commandes RECV ou SEND, par rapport l'heure laquelle la commande est prise en compte.

Manuel de rfrence

Les paramtres de CFT

4-60

Dans ce cas, l'heure absolue correspondante doit tre infrieure 24 heures. La valeur indique est exprime en minutes. Exemple : MINTIME = +30 signifie que l'heure de validit initiale du transfert est l'heure laquelle la commande est prise en compte plus 30 minutes. Cette heure d'acceptation doit tre infrieure 23h30. MINTIME ne doit pas tre gal MAXTIME, sauf si MAXDATE est dfini et ne correspond pas la date courante. Exemple : MINTIME = +30 signifie que l'heure de validit initiale du transfert est l'heure laquelle la commande est prise en compte plus 30 minutes. Cette heure d'acceptation doit tre infrieure 23h30. MINTIME ne doit pas tre gal MAXTIME, sauf si MAXDATE est dfini et ne correspond pas la date courante.

mode
Toutes les commandes CFT* [MODE = {REPLACE|CREATE|DELETE}] Action excuter dans la base de paramtres ou de partenaires. Ce paramtre s'applique toutes les commandes qui ont une incidence sur les bases CFT. Valeurs possibles : REPLACE (Valeur par dfaut) ; CREATE ; DELETE. * CFTACCNT, CFTAUTH, CFTCAT, CFTCOM, CFTDEST, CFTEXIT, CFTFILE, CFTIDF, CFTLOG, CFTLU62, CFTNET, CFTPARM, CFTPART, CFTPROT, CFTRECV, CFTSEND, CFTTCP, CFTTRACE, CFTX25, CFTXLATE. DISPLAY [MODE = {ANY|COLUMN LINE}] TURN [MODE = {START|CREATE|ACT|INACT}] INACT, ACT [MODE = {BOTH|REQUESTER|SERVER}] Mode ractiver : BOTH ; REQUESTER ; SERVER. Vous pouvez utiliser les raccourcis B, R et S la place des mots cls. Remarque : Le paramtre MODE est absolu. Si vous excutez ACT MODE=SERVER, suivi de ACT MODE=REQUESTER, le partenaire ne sera pas ractiv dans les deux modes, mais uniquement en mode demandeur (correspondant la commande la plus rcente).

Manuel de rfrence

Les paramtres de CFT

4-61

Le paramtre STATE de la commande CFTPART est dfini sur : ACTIVEBOTH aprs l'excution de ACT MODE=BOTH ; ACTIVESERV aprs l'excution de ACT MODE=REQUESTER ; ACTIVEREQ aprs l'excution de ACT MODE=SERVER.

modname
CFTLU62 MODENAME = { STRING 1...8} Nom du mode utilis dans les sessions LU62.

modin
CFTNET [MODIN = {string1...32}] Chane d'initialisation de modem Hayes pour les connexions entrantes (mode serveur).

modout
CFTNET Mode initiateur uniquement [MODOUT = {string1...32}] Chane d'initialisation de modem Hayes pour les connexions sortantes.

msg
SEND [msg = string 4096] Message textuel envoy au partenaire. Chane : string80 PeSIT D profil CFT ; string512 PeSIT E. Ce texte peut inclure des espaces. Il doit tre mis entre guillemets simples ( ). WLOG [MSG = string255] Message d'information crire dans le fichier journal.

multart
CFTPROT [MULTART = {NO|YES}] Option permettant de regrouper plusieurs enregistrements des fichiers mis dans une FPDU. YES : en mode metteur, yes est recommand si le partenaire prend en charge les FPDU multi-enregistrements. En mode rcepteur, CFT accepte les FPDU multienregistrements, quelle que soit la valeur de ce paramtre ;

Manuel de rfrence

Les paramtres de CFT

4-62

NO : est la valeur par dfaut. Une FPDU ne contient qu'un seul enregistrement. Applicable uniquement en mode metteur. Remarque : pour PeSIT profil SIT, cette valeur doit tre dfinie sur NO.

name
MQUERY, Objet = cache NAME = {CAT|COMMAND|DMZ|STAT} Nom du composant interroger. Ce paramtre peut tre dfini sur : CAT : interrogation du cache du catalogue ; COMMAND : interrogation du cache des commandes ; DMZ ; STAT. CFTCOM, TYPE = FILE NAME = {filename} string 64 Il s'agit du nom de fichier de communication.

nblksize
CFTSEND, SEND [NBLKSIZE = {value of FBLKSIZE|n}] Taille de bloc de fichier, en termes de protocole. Peut tre utilis pour transfrer un fichier vers un partenaire dont le systme gre le concept de taille de bloc (la liste de ces systmes est indique dans le paramtre FBLKSIZE). MVS uniquement - PeSIT D CFT, PeSIT E CFT/CFT Utilisez ce champ pour dfinir la taille de bloc du fichier. Assurez-vous que le partenaire prend en charge le concept de taille de bloc. Entrez l'une des valeurs suivantes : la valeur de fblksize (voir l'onglet spcifique MVS) ; n'importe quelle autre valeur comprise entre 0 et 65535.

nbr
CFTETB [NBR = {pos, 255|len}] Ce champ indique la position (pos) et la longueur (len), dans la carte ETEBAC, du champ nombre d'enregistrements du fichier mettre.

ncode
CFTSEND, SEND [NCODE = {voir commentaire|ASCII|BINARY|EBCDIC}] Tous les profils de PeSIT sauf SIT Code de donnes rseau utiliser pour les transferts en mission.

Manuel de rfrence

Les paramtres de CFT

4-63

Bien qu'il n'existe pas de valeur par dfaut pour ce champ, il peut, pour chaque transfert, prendre implicitement l'une des valeurs suivantes : BINARY if FCODE=BINARY ; ASCII ou EBCDIC, suivant le code de l'ordinateur partenaire dduit du champ syst. En outre, avec les paramtres FCODE et XLATE, NCODE dtermine le transcodage effectuer pendant un transfert en mission. Que les valeurs soient dtermines de manire explicite ou implicite : si FCODE ou NCODE est gal BINARY, aucun transcodage n'est effectu ; sinon (les donnes locales et les donnes en ligne sont supposes avoir un codage ASCII ou EBCDIC) :
o

si NCODE est gal FCODE, le transcodage ASCII/ASCII ou EBCDIC/EBCDIC ne peut tre effectu qu'avec une table de transcodage externe (voir l'utilisation du paramtre XLATE) ; si NCODE n'est pas FCODE, le transcodage ASCII/EBCDIC ou EBCDIC/ASCII est toujours effectu, au moyen d'une table de transcodage externe ou de la table de transcodage interne de CFT.

C'est uniquement dans le protocole PeSIT (si le profil n'est pas SIT) que CFT peut mettre un paramtre protocolaire code de donnes (un indicateur) ; ce paramtre correspond alors NCODE. Pour les autres protocoles, le partenaire rcepteur prsuppose que les donnes sont codes conformment aux conventions protocolaires. Dans ETEBAC3, par exemple, il s'attend recevoir des donnes EBCDIC. Pour plus d'informations, voir Protocoles. CFTXLATE [NCODE = {ASCII|EBCDIC}] Code de donnes envoy sur le rseau. A propos du transcodage pendant un transfert : Si un transcodage des donnes est requis, la table de transcodage dfinie par CFTXLATE sera utilise. Le transcodage s'effectue de FCODE vers NCODE pour l'metteur et de NCODE vers FCODE pour le rcepteur.

ncomp
CFTSEND, CFTRECV, SEND, RECV [NCOMP = {voir commentaire|cpr}] PeSIT D profil CFT, PeSIT profil EXTERN, PeSIT E Compression des donnes en ligne demande. Ce paramtre est utilis lorsque la valeur du paramtre SCOMP ou RCOMP de l'objet CFTPROT est excessif pour le fichier type considr. Les valeurs autorises et les valeurs par dfaut pour le paramtre NCOMP sont les mmes que pour le paramtre SCOMP ou RCOMP de l'objet CFTPROT. Pour un transfert, la combinaison des valeurs prises pour ces deux paramtres sert de base la ngociation protocolaire de la compression des donnes en ligne.

Manuel de rfrence

Les paramtres de CFT

4-64

PeSIT D profil CFT PeSIT D profil EXTERN PeSIT E ODETTE

Ce paramtre ne doit tre utilis que pour les transferts avec le protocole PeSIT (avec la version ou le profil indiqu lorsque la valeur du paramtre SCOMP de la commande CFTPROT est excessif pour le fichier type considr). Ce paramtre permet, si ncessaire, de bloquer la compression pour un transfert en mission la suite d'une phase de connexion o la compression a t ngocie 1 (paramtres SCOMP et/ou RCOMP de CFTPROT dfinis sur 1).

net
CFTPROT [NET = {identifier}] Identifiant faisant rfrence une commande CFTNET. S'il existe plusieurs objets CTNET ayant le mme type et appartenant la mme classe que le CFTNET indiqu, l'objet CFTPROT est alors associ tous les objets CFTNET. Ces derniers peuvent tous tre utiliss pour ce protocole et pour les appels entrants. Le SAP peut tre desservi pour chacun d'entre eux. CFTPARM [NET = {id, id, ...}] Liste d'identifiants des objets CFTNET pouvant tre utiliss par le moniteur CFT. Pour plus d'informations, reportez-vous la dfinition de la commande CFTNET et au Guide d'exploitation de CFT qui correspond votre systme d'exploitation. MVS : Dans la liste NET = ( ... , ... ), l'identifiant dsignant la commande CFTNET TYPE = SNA, PROFILE = GATE, ... doit tre indiqu avant les identifiants qui dsignent les commandes CFTNET TYPE = X25, ...

netband
CFTSEND, CFTRECV [NETBAND = { 1...16}] La plage des ports sortants est contrle par le paramtre SRCPORTS de l'objet CFTNET. Il est possible de dfinir au maximum 16 plages de ports pour ce paramtre. Slectionne la plage de ports sortants : 1 slectionne la premire plage le cas chant (par dfaut) ; n slectionne la nime plage, si cette plage existe, ou la dernire plage. Exemples : Dans le cas de SRCPORTS=(6000-6009,6010-6019,6020-6030) Si NETBAND = 3, la troisime valeur est utilise comme plage de ports sortants.

Manuel de rfrence

Les paramtres de CFT

4-65

netpfx
CFTNET Pour OS/400 uniquement [NETPFX = {CF1|string3}] Prfixe pour les objets du rseau o valeur = chane3. Ce prfixe est utilis pour nommer les objets du rseau crs pour CFT/OS400 et utiliss par des programmes selon des rgles syntaxiques spcifiques. Il constitue galement l'lment de donnes de comparaison ajouter l'entre de routage du sous-systme sur lequel CFT/OS400 sera excut.

netpgm
CFTNET [NETPGM = string32] UNIX Nom du fichier excutable initialisant la ressource X25. Utilis par certains systmes UNIX. Valeur = string 32

netwkid
CFTLU62 [NETWKID = {string 1...8 }] Nom rseau auquel l'unit logique (LU) distante est rattache.

nfname
CFTSEND, SEND, RECV [NFNAME = {filename|*filename}] PeSIT D profil CFT, PeSIT E CFT/CFT Nom du fichier physique sur le site partenaire rcepteur. Si le nom de fichier est prcd d'un astrisque (*), le rcepteur peut choisir de conserver le nom courant transmis ou de renommer le fichier. Le nom de fichier peut tre cr partir de variables symboliques ou correspondre au nom d'un fichier avec versions. Le fichier est transfr si les conditions suivantes sont remplies : le partenaire rcepteur autorise le site metteur (demandeur ou serveur) dfinir le nom physique du fichier recevoir (ce nom est dfini partir de paramtrages tels que FNAME=&NFNAME) ; le fichier dsign par NFNAME existe ou peut tre cr l'extrmit rceptrice ; le numro de version du fichier GDG correspond celui du fichier rcepteur + 1. Pour plus d'informations sur les mcanismes concerns, voir la rubrique Emplacement des fichiers physiques. Utilisation des variables symboliques MVS, VMS {string 512}

Manuel de rfrence

Les paramtres de CFT

4-66

Pour former la chane de caractres FNAME, vous pouvez utiliser les variables suivantes : &FDATE, &FTIME, &FYEAR, &FMONTH, &FDAY &SPART, &RPART, &PART, &NPART, &GROUP &SUSER, &RUSER &SAPPL, &RAPPL &IDF, &PARM, &IDA &NIDF &BDATE, &BTIME, &BYEAR, &BMONTH, &BDAY Le caractre & remplace ici le caractre char_symb spcifique chaque systme d'exploitation (voir le Guide d'exploitation de CFT correspondant votre systme d'exploitation). mission d'un fichier avec versions MVS, VMS

Ce nom inclut une racine et un numro de version.

nfver
RECV NFVER = {0|n} Version du fichier transfr. Numro de version du fichier logique mis, dans le cas d'un fichier VFM. Numro de version du fichier mis, dans le cas d'un fichier GDG. Les valeurs reprsentent les versions suivantes : 0: version 0 du fichier (par dfaut) ; n : version -n du fichier. VFM Cas 1 : NFVER est utilis avec NFNAME (mode ouvert avec mission implicite depuis l'extrmit serveur metteur). FNAME = &FNAME (-&NFVER). Dans ces conditions, le partenaire met le fichier logique NFNAME (-NFVER) de la base VFM dsigne dans ses paramtrages par le paramtre FDB. Cas 2 : NFVER est utilis seul (mode ferm avec mission implicite depuis l'extrmit serveur metteur). FNAME = &PART.&IDF (-&NFVER). Le partenaire met la version du fichier logique &PART.&IDF indique dans le paramtre NFVER. Le paramtre FDB indique la base VFM contenant le fichier logique. GDG Cas 1 : NFVER est utilis avec NFNAME (mode ouvert avec mission implicite depuis l'extrmit serveur metteur). Exemple : MVS FNAME = &FNAME (-&NFVER).

Manuel de rfrence

Les paramtres de CFT

4-67

Le partenaire met le fichier GDG avec la racine et le numro de version indiqus. Cas 2 : NFVER est utilis seul (mode ferm avec mission implicite depuis l'extrmit serveur metteur). Exemple : MVS FNAME = &TEST.GDG (-&NFVER). Le partenaire met la version du fichier logique &PART.&IDF indique dans le paramtre NFVER. Remarque : si NFVER n'est pas dfini, la valeur par dfaut est 0. Il est donc recommand de dfinir une commande d'mission (CFTSEND) pour chaque type de fichier traiter (normal ou avec versions).

nidf
CFTETB [NIDF = (pos, {255|len})] Position (pos) et longueur (len) du champ identifiant rseau du fichier type dans la carte ETEBAC. CFTIDF [NIDF = string] Identifiant rseau IDF. Cette valeur est transfre dans le rseau. SEND, RECV [NIDF = string] Identifiant rseau.

nkeylen
CFTSEND, SEND PeSIT E [NKEYLEN = {FKEYLEN value|n}] Longueur (en octets) de la cl d'un fichier index. Le moniteur envoie ces informations, transportes par le protocole dans le PI 38, mais ne les utilise pas. Le fichier index est transfr sous forme d'enregistrements squentiels.

nkeypos
CFTSEND, SEND NKEYPOS = {FKEYPOS value|n}] PeSIT E Emplacement (en octets) de la cl dans les enregistrements d'un fichier index. Le moniteur envoie ces informations, transportes par le protocole dans le PI 39, mais ne les utilise pas. Le fichier index est transfr sous forme d'enregistrements squentiels.

Manuel de rfrence

Les paramtres de CFT

4-68

nlrecl
CFTETB NLRECL = {pos, 255|len} Cette valeur indique, dans la carte ETEBAC3, la position (pos) et la longueur (len) du champ longueur d'enregistrement pour le fichier envoyer. Pour la conformit avec la norme ETEBAC3, pos doit tre gal 4 et len 4. CFT permet de dfinir diffrentes valeurs si besoin est. CFTSEND, SEND [NLRECL = {FLRECL value|n}] Pour les enregistrements de : format fixe (FRECFM = F) : taille en octets des enregistrements du fichier rcepteur ; format variable (FRECFM = V) : taille maximale en octets des enregistrements. Lorsqu'un fichier est mis, tout enregistrement envoy dont la taille est suprieure la taille dclare par NLRECL est tronqu la valeur de NLRECL. Pour les enregistrements de format fixe (FRECFM=F), si la taille des enregistrements envoyer est infrieure la valeur de NLRECL, ces enregistrements sont complts jusqu' la valeur de NLRECL : par des zros binaires (x00) lorsque les donnes locales sont dclares comme binaires FCODE = BINARY ; par des espaces lorsque les donnes locales sont dclares comme alphanumriques avec :
o o

CODE = ASCII : le caractre espace est alors gal x20 ; CODE = EBCDIC : le caractre espace est alors gal x40 (hexadcimal).

ODETTE : pour l'utilisation particulire de ce paramtre avec le protocole ODETTE, reportez-vous au Guide protocolaire de CFT.

node
CFTDNA [NODE = {string6}]

notify
CFTLOG, CFTSEND, CFTRECV, SEND, RECV NOTIFY = {string see below} Dfinit la destination des messages oprateur slectionns comme suit en fonction de la valeur du paramtre OPERMSG : tous les messages du fichier journal si le paramtre est dfini dans l'objet CFTLOG ; pour tous les messages de transfert avec l'IDF si le paramtre est dfini dans CFTSEND ou CFTRECV ; pour tous les messages d'un transfert qui a t demand avec la commande si le paramtre est utilis dans SEND ou RECV. La valeur de ce paramtre est une chane de 8 caractres aligns gauche.

Manuel de rfrence

Les paramtres de CFT

4-69

La destination de ces messages peut tre, en fonction du systme : le moniteur CFT metteur correspondant la sortie standard associe un moniteur CFT (l'cran de soumission, par exemple). La valeur du paramtre NOTIFY doit alors tre dfinie sur (8 caractres blancs) ; une console oprateur. La valeur du paramtre NOTIFY doit commencer par les 2 caractres OP ; un utilisateur d'ordinateur. La valeur du paramtre NOTIFY indique l'identifiant du systme utilisateur dans le format xxxxxxxx . Le tableau suivant indique les destinataires possibles pour chaque systme concern : YES indique que le type de destinataire correspondant existe ; NO indique que le type de destinataire correspondant n'existe pas.
Systme dexploitation GCOS7 GCOS8 GUARDIAN MVS Netware OS2 OS400 UNIX VM VMS VOS VSE Windows Moniteur metteur OUI OUI OUI NON OUI OUI OUI OUI NON NON OUI NON OUI Console oprateur OUI OUI OUI OUI NON NON OUI OUI OUI OUI OUI OUI NON Tout utilisateur OUI NON OUI OUI NON NON OUI OUI OUI OUI OUI NON NON

Le tableau suivant indique, pour chaque systme, les valeurs par dfaut du paramtre NOTIY prises en charge. La valeur correspond 7 caractres blancs.
Systme dexploitation GCOS7 GCOS7 GUARDIAN MVS Netware OS2 OS400 UNIX VM VMS VOS VSE Windows Valeurs par dfaut pour NOTIFY OP OPLOG OP OP OP OP

Manuel de rfrence

Les paramtres de CFT

4-70

Le tableau suivant indique les choix possibles dans la console oprateur. Si OP est indiqu pour les caractres interprts, seuls ces deux caractres (OP) sont interprts ; les caractres suivants ne sont pas significatifs.
Systme d'exploitation de la console oprateur GCOS7 GCOS7 OP000001 OP000002 OP000003 OP000004 GUARDIAN MVS Netware OS2 OS400 UNIX VM VMS OP OP Non applicable Non applicable OP OP OP Opxxxxxx File d'attente de messages QSYSOPR Console oprateur Ordinateur de l'oprateur Console du systme et fichier journal du systme priphrique de sortie identifi par le lien xxxxxx prsent dans le rpertoire d'excution courant du moniteur Console du systme et fichier journal du systme priphrique de sortie identifi par le lien xxxxxx prsent dans le rpertoire d'excution courant du moniteur Console oprateur Caractres interprts OP Messages envoys :

Console oprateur Console oprateur dsigne par un numro : Console TY1 ; Console TY2 ; Console TY3 ; Console TY4. Console oprateur Console(s) oprateur

VOS

OP ou OPxxxxxx OP Non applicable

VSE Windows

Pour l'utilisateur : MVS Les messages de CFT sont envoys par SEND au TSO USERID spcifi ; dans ce cas, le programme moniteur CFT doit tre autoris (APF). Les messages sont envoys l'utilisateur VMS dsign par son nom VMS. Dans ce cas, la tche moniteur CFT doit avoir le privilge OPER. Les messages sont envoys par MSGNOH ou MSG en fonction des privilges accords.

VMS VM

nopart
CFTDEST [NOPART = {abort|continue|ignore}] Ne remplissez pas ce champ si vous avez rempli le champ fname.

Manuel de rfrence

Les paramtres de CFT

4-71

Dfinissez les actions excuter lorsqu'un partenaire dans la liste des partenaires est introuvable. Les options sont les suivantes : abort (par dfaut) ; continue : pour afficher un message d'information et poursuivre le traitement ; ignore : pour poursuivre le traitement sans message d'information.

npart
LISTCAT [NPART = {identifier|mask}] Nom rseau du partenaire de transfert. La valeur de ce paramtre peut tre : un identifiant : la slection se rapporte aux transferts effectus avec ce nom rseau ; un masque : la slection est gnrique et se rapporte aux transferts effectus avec l'identifiant rseau dont le nom correspond ce masque ; omise : la slection est effectue en fonction des critres indiqus dans le paramtre PART. DISPLAY [NPART = {string}] CFTETB [NPART = {pos, 255|len}] Position (pos) et longueur (len) du champ identifiant de rseau du partenaire dans la carte ETEBAC3. Indique le champ de stockage du paramtre NRPART (de CFTPART) d'un CFT demandeur. CFTPART, NRPART [NRPART = {ID value|string}] PeSIT profil SIT string8 PeSIT D profil EXTERN, PeSIT D profil CFT string24 PeSIT E string25 ODETTE string28 ETEBAC3 Nom rseau par dfaut pour le site local. Il s'agit de la valeur par dfaut pour le paramtre NPART de l'objet CFTPART. Le partenaire distant doit utiliser ce nom pour s'identifier sur le moniteur CFT local pendant la phase de connexion. Sur le site distant, cette valeur correspond au paramtre NSPART de l'objet CFTPART utilis dans le transfert. ODETTE : en mode serveur, il peut exister plusieurs objets CFTPART avec le mme NRPART. Pour ce faire, IMINTIME = IMAXTIME doit tre spcifi.

Manuel de rfrence

Les paramtres de CFT

4-72

nrpassw
CFTPART [NRPASSW = string] string8 string8 string22 PeSITE ODETTE ETEBAC3

Mot de passe d'ouverture de session de partenaire, autorisant un contrle des droits d'accs au site local. Le partenaire distant doit soumettre ce mot de passe pour s'identifier sur le moniteur CFT local pendant la phase de connexion. Du ct du partenaire distant, ce mot de passe doit tre dclar comme paramtre NSPASSW de l'objet CFTPART utilis dans le transfert.

nrecfm
CFTSEND, SEND [NRECFM = {FRECFM value|F|U|V}] F : fixe ; V : variable ; U : indfini. PeSIT D profil ETERN PeSIT profil ANY PeSIT E ODETTE ETEBAC3 PeSIT profil SIT Dans le protocole PeSIT avec les profils SIT et EXTERN, la valeur NFRECFM = U n'est pas connue dans les termes du protocole et elle est transforme en NFRECFM = V par le moniteur. Cette valeur (U) est envoye sans modification dans PeSIT D profil CFT ou dans PeSIT E de CFT CFT. Pour l'utilisation particulire de ce paramtre avec le protocole ODETTE, reportez-vous au Guide protocolaire de CFT. Le protocole ETEBAC3 sert uniquement au transfert de fichiers avec des enregistrements de longueur fixe. La valeur NRECFM = U n'est reconnue qu'entre deux moniteurs CFT. ODETTE, PeSIT, OS Format d'enregistrement du fichier dfini en termes protocolaires :

nsdu

nspace
CFTSEND, SEND [NSPACE = {FSPACEvalue|n}] ODETTE, PeSIT Taille de fichier, en termes de protocole, exprim comme un nombre de blocs de 1 kilooctet (1024 caractres).

Manuel de rfrence

Les paramtres de CFT

4-73

nspart
CFTPART [NSPART = {valeur du paramtre NPART de CFTPARM|string}] string8 PeSIT profil SIT, PeSIT D profil CFT, PeSIT D profil EXTERN string24 PeSIT E string25 ODETTE string28 ETEBAC3 Identifiant rseau par lequel le moniteur CFT local s'identifie sur son partenaire. Le partenaire distant doit rcuprer la description de CFTPART de telle sorte que le paramtre NRPART associ corresponde cette valeur.

nspassw
CFTETB [NSPASSW = {pos, 255|len}] Position (pos) et longueur (len) du champ password du demandeur. Indique le champ de stockage du paramtre NSPASSW (de CFTPART). Le partenaire distant vrifie que la valeur reue est gale la valeur du paramtre NRPASSW document dans la description du CFTPART correspondant. CFTPART [NSPASSW = string] string8 PeSIT, ODETTE string22 ETEBAC Le partenaire distant vrifie que la valeur reue est gale la valeur du paramtre NRPASSW document dans la description du CFTPART correspondant.

ntype
CFTSEND, SEND [NTYPE = {voir commentaire|c}] ODETTE, PeSIT D profil CFT, PeSIT E CFT/CFT, OS Type de fichier, en termes de protocole. Ce paramtre est utilis pour dsigner le type de fichier rcepteur du partenaire. Valeur par dfaut Si ce paramtre n'est pas dfini, CFT attribue une valeur par dfaut en fonction du : type de fichier local (paramtre FTYPE) ; systme d'exploitation du destinataire du transfert (paramtre SYST de CFTPART). Les valeurs par dfaut sont indiques dans NTYPE sent by default. ODETTE La valeur spcifique NTYPE = T peut tre utilise pour demander l'mission d'un fichier dans le format texte ODETTE. Voir Gestion des protocoles.

PeSIT D profil CFT PeSIT E CFT/CFT

Manuel de rfrence

Les paramtres de CFT

4-74

oblksize
COPYFILE [OBLKSIZE = {IBLKSIZE value|n}] Taille de bloc du fichier de sortie en octets. La valeur doit tre suprieure la valeur du paramtre OLRECL. Le tableau suivant indique pour chaque systme si le paramtre doit tre dfini.
Systme dexploitation GCOS7 GCOS7 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE Windows OBLKSIZE OUI OUI NON OUI NON NON NON NON NON OUI NON

ocode
COPYFILE [OCODE = {code interne dtermin par le systme|ASCII|EBCDIC}] Codes de donnes du fichier de sortie.

ocomp
COPYFILE [OCOMP = {0|cpr}] Compresse les donnes du fichier d'entre. La valeur 0 signifie qu'il n'y a pas de compression. Les valeurs possibles (cpr) sont indiques dans Compression.

oct
COPYFILE [OCT = {H|C},] Type de compression des donnes du fichier de sortie : C : compression CFT CFT ; H : compression PeSIT non-SIT. Ce paramtre est significatif uniquement si la valeur de OCOMP est diffrente de 0. La valeur de OCOMP doit tre compatible avec le type de compression.

Manuel de rfrence

Les paramtres de CFT

4-75

olrecl
COPYFILE [OLRECL = {voir commentaire|n}] {0..32768} Longueur d'enregistrement du fichier de sortie. Pour les formats d'enregistrement suivants, OLRECL est exprim en octets : format fixe (OFRECFM = F) : longueur d'enregistrement du fichier de sortie ; format variable (FRECFM = V) : longueur d'enregistrement maximale. Si OLRECL est : infrieur la longueur relle de l'enregistrement crire, l'enregistrement est tronqu la longueur spcifie ; suprieur la longueur relle de l'enregistrement crire et si : le fichier est dans un format fixe (ORECFM = F), l'enregistrement est complt avec des espaces , c'est--dire en fonction de la valeur du paramtre OCODE : x20 si OCODE = ASCII, x40 si OCODE = EBCDIC ; fichier de format non fixe. Ce paramtre n'est significatif qu' la cration du fichier. Valeurs par dfaut : si le fichier de sortie n'existe pas : valeur de ILRECL ; si le fichier de sortie existe :
o

pour les systmes qui grent le concept d'enregistrement de fichier : taille relle des enregistrements du fichier d'entre ; pour les systmes ci-dessous qui ne grent pas ce concept : WinNT UNIX 512. 512 pour les fichiers texte (OTYPE = T, X ou O). 4096 pour les fichiers binaires ou de variables (OTYPE = {B | V}). La valeur par dfaut est 2048 octets. VOS Lorsque ORECFM=F, il est recommand de toujours spcifier OLRECL. Lorsque ORECFM=V, OLRECL doit toujours tre spcifi lorsque la taille d'enregistrement risque d'tre suprieure 2048.

omaxtime
CFTLU62, CFTX25, CFTTCP, CFTSNA [OMAXTIME = {23595999|time}] Plage temporelle autorise pour les appels arrivant sur ce type de rseau. Heure maximale aprs laquelle le partenaire ne peut plus tre appel sur ce type de rseau. CFTPART [OMAXTIME = {23595999|time}] Heure maximale de la plage temporelle autorise pour les appels reus par le partenaire.

Manuel de rfrence

Les paramtres de CFT

4-76

omintime
CFTLU62, CFTX25, CFTTCP [OMINTIME = {00000000|N}] Plage temporelle autorise pour les appels arrivant sur ce type de rseau. Heure minimale avant laquelle le partenaire ne peut plus tre appel sur ce type de rseau. Heure minimale de la plage temporelle autorise pour les appels sur ce type de rseau ou par le partenaire s'il est dfini, aprs laquelle le partenaire ne peut plus passer d'appel sur ce type de rseau. CFTPART [OMINTIME = { 0|N}] Heure minimale de la plage temporelle autorise pour les appels reus par un partenaire.

opermsg
CFTRECV, CFTSEND, CFTLOG [OPERMSG = {voir tableau|n}] {0..255} Dfinit les catgories de messages prvues pour l'oprateur. Tous les messages sont galement crits dans le fichier journal. Les catgories de messages prvues pour l'oprateur. Les messages d'appel sont crits dans le fichier journal. Il s'agit d'un sous-ensemble des messages de journalisation de CFT dfini par la somme algbrique des valeurs indiques dans le tableau suivant.
Valeur 1 2 4 8 16 32 64 128 Catgorie de message Message d'information - fonctionnement Message d'information - systme Messages d'attention - fonctionnement Messages d'attention - systme Messages d'erreur - fonctionnement Messages d'erreur - systme Messages d'erreur bloquante - fonctionnement Messages d'erreur bloquante - systme Type I I W W E E F F

Les types I, W, E, F correspondent au type de message indiqu dans le fichier journal (voir le Guide Diagnostic, codes et messages de CFT). La valeur 0 signifie qu'aucun message n'est renvoy l'oprateur. Le tableau suivant indique, pour chaque systme, les valeurs par dfaut du paramtre OPERMSG.
Systme dexploitation GCOS7 GCOS8 GUARDIAN MVS Valeur par dfaut de OPERMSG 0 0 3 0

Manuel de rfrence

Les paramtres de CFT

4-77

Systme dexploitation OS400 UNIX VM VMS VOS VSE Windows

Valeur par dfaut de OPERMSG 0 3 0 0 3 0 0

orecfm
COPYILE [ORECFM = {IRECFM value|F|V|U}] Format d'enregistrement de sortie : F : fixe ; V : variable ; U : indfini. Les valeurs possibles pour chaque systme sont indiques dans le Guide d'utilisation correspondant. Si le fichier d'entre est compress (OCOMP diffrent de 0), la valeur du paramtre ORECFM est force V. UNIX, VM La valeur U conserve pour la compatibilit avec les prcdentes versions. Elle a la mme signification que ORECFM=V.

ospace
COPYFILE [OSPACE = {0|n}] {0..4294967295} Espace rserver pour le fichier de sortie, en kilo-octets (1 kilo-octet = 1024 octets). Si le fichier de sortie existe dj, la valeur par dfaut est la valeur de ce fichier existant ; sinon, cette valeur est 0. UNIX, VM Paramtre ignor.

otype
COPYFILE [OTYPE = {voir le Guide dexploitation|c}] OS Type du fichier de sortie. Reportez-vous au Guide d'exploitation de CFT qui correspond votre systme d'exploitation.

packetsz
CFTNET, TYPE = X25

Manuel de rfrence

Les paramtres de CFT

4-78

[PACKETSZ = {128|n}] Taille de paquet d'abonnement X.25, exprime sous la forme d'un nombre d'octets. cette valeur doit correspondre celle de votre abonnement X.25 ; la valeur par dfaut est 128.

packetw
CFTNET, TYPE = X25

[PACKETW = {3|n}] {1..15} MVS, OS400, VM, VSE Taille de la fentre d'abonnement X.25, exprime sous la forme d'un nombre de paquets. cette valeur doit correspondre celle de votre abonnement X.25 ; la valeur par dfaut est 3.

pad
CFTPROT [PAD = {NO|YES}] Spcifique PeSIT Option pour l'utilisation du contrle de redondance cyclique (CRC). Utilisable en mode demandeur uniquement : la valeur par dfaut est No. Odette Option appliquant une 'logique spciale' aux tampons d'change de donnes. Si l'option est dfinie sur NO pour l'un des partenaires, sa 'logique spciale' n'est pas applique. la valeur par dfaut est No.

parm
CFTETB [PARM = pos, {255|len}] Indique le champ de stockage de PARM (pour CFTSEND). CFTEXIT [PARM = {string64}] Utilisez ce champ pour transmettre des informations du moniteur aux programmes EXIT de l'utilisateur. Vous pouvez entrer jusqu' 64 caractres alphanumriques de texte libre. CFTSEND, SEND, RECV [PARM = string513] PeSIT D profil CFT, PeSIT E CFT/CFT, PeSIT Message utilisateur envoy au partenaire avec le transfert du fichier. La valeur de ce paramtre est accessible par l'intermdiaire de la variable symbolique &PARM.

Manuel de rfrence

Les paramtres de CFT

4-79

CFTNET, TYPE = TCP [PARM = { string }] CFTSSL [PARM = {string64}]

part
Entrez l'identifiant local du site o le moniteur est en cours d'excution. Ce paramtre est utilis dans le catalogue titre d'information uniquement. CFTDEST PART = (identifier, identifier, ...) Liste explicite des identifiants des diffrents partenaires (chacun correspondant une valeur du paramtre ID d'une commande CFTPART). Le nombre maximum d'identifiants dans cette liste est limit 200. Si aucun partenaire n'est dfini dans CFTPART, aucun transfert (diffusion ou collecte) n'est excut. LISTPARM [PART = identifier] Fou TYPE = IDF Identifiant du partenaire. Utilis pour limiter la recherche aux IDF dfinis dans les commandes CFTIDF relatives ce partenaire. LISTCAT [PART = {identifier|mask}] Identifiant du (des) partenaire(s) pour les transferts slectionns. La valeur de ce paramtre peut tre : un identifiant : la slection se rapporte uniquement aux transferts effectus avec ce partenaire ; un masque : la slection se rapporte uniquement aux transferts avec les partenaires dont l'identifiant correspond ce masque ; omise : la slection se rapporte tous les partenaires. Cette option est la mme que l'option PART = * Si le partenaire NPART est dfini, le paramtre PART est ignor. SEND, RECV [PART = identifier] Id du partenaire responsabe du transfert. Lors de l'envoi d'une rponse, cet identifiant dsigne l'metteur du fichier. Si la commande est utilise dans une procdure de fin de rception, l'utilisateur peut dfinir ce paramtre l'aide de la variable symbolique PART=&PART.

Manuel de rfrence

Les paramtres de CFT

4-80

Cet identifiant dsigne : soit un partenaire dcrit par la commande : ID = <valeur du paramtre PART>, ... ou une liste de partenaires dcrits par la commande : CFTPART CFTDEST ID = <valeur du paramtre PART>, PART = (identifier, identifier . . .) CFTIDF [PART = identifier] Identifiant local du partenaire pour lequel la correspondance IDF/NIDF est valide. Ce paramtre est un lment d'information qui apparat dans le catalogue. CFTPARM [PART = identifier] Identifiant local, identifiant le site sur lequel CFT est excut. La mme valeur que celle du paramtre CFTPART ID. RESUME, DELETE, HALT, KEEP, START, END, SUBMIT PART = { identifier|mask} Identifiant du partenaire. La valeur associe de ce paramtre peut tre : un identifiant : la commande concerne uniquement les transferts avec ce site partenaire ; un masque : la commande concerne les transferts avec les sites partenaires dont les identifiants correspondent ce masque. DISPLAY [PART = string] KSTATE [PART = partner identifier] CFTIDF [PART = identifier] TURN [PART = identifier] CFTPROT (DMZ) [PART = {identifier, identifier,...}]

Manuel de rfrence

Les paramtres de CFT

4-81

partfnam
CFTPARM [PARTFNAME = filename] Nom du fichier de partenaire qui est cr par CFTFILE lorsque TYPE=PART et qui est utilis avec CFTPARM.

PCVI
CFTX25 [PCVI = {YES|NO}] Le partenaire peut appeler en PCV (PCVI=YES) et demander que les frais soient la charge du destinataire.

PCVO
CFTX25 [PCVO = {NO|YES}] Le partenaire est appel en PCV (PCVO=YES) : les frais de communication seront sa charge.

pkifname
CFTPARM [PKIFNAME = filename] Nom de la base de donnes de certificats locale dans laquelle l'opration doit tre excute. Dans chaque systme d'exploitation, un nom par dfaut est attribu la base de donnes de certificats locale. Le nom de fichier logique &CFTPKU peut tre utilis.

pkipassw
CFTPARM [PKIPASSW = string 1...64] Mot de passe de cryptage de la cl prive dans la base de certificats locale. Le mot de passe peut tre spcifi de deux manires : soit avec une valeur : la valeur attribue au paramtre est utilise directement comme mot de passe ; soit par rfrence un fichier : la valeur attribue au paramtre est le nom d'un fichier dont le premier enregistrement contient le mot de passe. A ce titre, le nom du fichier doit tre prcd d'un #. Exemple : PKIPASSW=#mon_fichier, o le mot de passe est spcifi dans le fichier mon_fichier. Le premier enregistrement doit contenir le mot de passe dans un format en texte en clair. Le mot de passe n'est pas enregistr dans la base de donnes de certificats locale. Il est fortement recommand d'utiliser le mme mot de passe pour toutes les cls prives. Le mme mot de passe doit tre dclar dans la configuration, afin que le moniteur ait accs aux cls prives.

Manuel de rfrence

Les paramtres de CFT

4-82

port
CFTNET TYPE = TCP, protocole=SOCKS4

PORT = (string1..64, string1..64, ) Port l'coute du proxy/des proxies dans le premier rseau. Un port l'coute peut tre exprim soit dans un format numrique (entre 1 et 65535) soit sous forme de nom service. Vous devez dclarer le mme nombre de ports en tant qu'htes, car la position du port l'coute dans la liste correspond l'adresse d'hte situe la mme position. CFTCOM, TYPE = TCPIP

PORT = number

pri
CFTSEND, SEND, CFTRECV, RECV [PRI = {128|n}] {0..255}] Priorit de slection de la requte. La valeur maximale du paramtre PRI est 255. Le moniteur CFT slectionne d'abord les requtes de transfert avec la priorit la plus haute pour un partenaire donn. 128 (valeur par dfaut) ; toute autre valeur comprise entre 0 et 255 (priorit la plus haute).

prof
CFTPROT [PROF = {SIT|CFT|EXTERN|ANY|DMZ}] PeSIT D ou E profil protocolaire. Les options de profil sont les suivantes : profil SIT : le protocole PeSIT est alors utilis dans les contexte du rseau SIT. Il est identique dans les versions D et E de PeSIT. Il assure la gestion des points de synchronisation, mais ne gre pas :
o

la segmentation : la valeur du paramtre SEGMENT doit tre dfinie sur NO (SEGMENT = NO) ; ni les multi-enregistrements la valeur du paramtre MULTART doit tre dfinie sur NO (MULTART = NO). Remarque : un metteur dans le profil PeSIT SIT ne peut pas segmenter un enregistrement envoy dans plusieurs FPDU de donnes ni grouper plusieurs enregistrements envoys dans la mme FPDU de donnes ;

ni la compression : les paramtres RCOMP et SCOMP ne sont pas applicables ; o ni les requtes de transfert en rception ; profil EXTERN : correspond la dfinition non-SIT (externe vers rseau SIT) normalise du protocole PeSIT version D ;
o

profil CFT : le protocole PeSIT version D est utilis en dehors du contexte du rseau SIT, le partenaire ayant galement un moniteur CFT. Son niveau de fonctionnalit est suprieur aux spcifications de PeSIT D profil EXTERN ;

Manuel de rfrence

Les paramtres de CFT

4-83

profil ANY : correspond la dfinition non-SIT (externe vers rseau SIT) normalise du protocole PeSIT version E. Ce profil inclut en standard les fonctions du profil CFT. Il propose des fonctions supplmentaires entre les deux moniteurs CFT V2.2, tout en prservant la conformit la norme PeSIT E. Ces fonctions sont bases sur l'utilisation du PI 99 (PI libre). Remarque : en mode serveur, le paramtre PROF peut prendre les valeurs EXTERN, CFT ou ANY (correspondant aux profils non-SIT ) : en effet, en mode serveur, le moniteur CFT s'adapte automatiquement au profil non-SIT propos par le partenaire demandeur.

profile
CFTNET [PROFILE = GATE] Profil spcifique la ressource SNA. Ce profil GATE signifie que la ressource SNA est ddie X.25. Les valeurs des paramtres CLASS et CALL sont sans signification et doivent tre omis. Une seule ressource SNA est autorise. Remarque : dans la liste des identifiants dfinis dans le paramtre NET de la commande CFTPARM, l'identifiant de la ressource CFTNET TYPE = SNA PROFILE = GATE doit tre dfni AVANT l'identifiant de la ressource CFTNET TYPE = X25 correspondante. CFTNET, TYPE = LU62 [PROFILE = {OLD|NEW}] Profil spcifique la ressource SNA. CFTNET, TYPE = X25 [PROFILE = {X25|RNIS}] Profil spcifique la ressource SNA.

prog
CFTEXIT [PROG = {CFTEXIT|string (1 512)}] Entrez le nom du module excutable qui correspond la tche EXIT activer. Ce module comprend une interface fournie avec le produit CFT et rattache au programme utilisateur. Pour faciliter l'identification des modules associs, les noms de module suivants sont recommands : CFTEXA pour un EXIT de type annuaire ; CFTEXE pour un EXIT de type fin de fichier ; CFTEX3 pour un EXIT de type ETEBAC ; CFTEXF pour un EXIT de type fichier. Si vous dfinissez plusieurs EXIT, vous pouvez ajouter deux caractres au nom pour attribuer un numro squentiel (par exemple : CFTEXA01).

Manuel de rfrence

Les paramtres de CFT

4-84

prot
CFTPART PROT = (identifier|mask, identifier|mask,..) Liste des protocoles de communication (identifiants CFTPROT ID) autoriss pour communiquer avec ce partenaire. Le nombre maximum de protocoles pris en charge est fix 4. Pour les transferts simultans avec ce partenaire, le moniteur CFT exige que tous les transferts obissent au mme protocole. La valeur du paramtre PROT peut inclure des caractres gnriques (masque). Cette syntaxe n'est utilise qu'en mode serveur. Cela signifie que le moniteur acceptera n'importe quel protocole dont l'identifiant correspond la valeur gnrique dfinie de cette manire. Exemple 1 : PROT = (prot1 , *) Exemple 2 : PROT = (prot1 , prot?) Le caractre ? dsigne le caractre char_mak dfini dans le Guide d'exploitation de CFT correspondant votre systme d'exploitation. 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 dfinis au niveau du moniteur ; dans le second exemple, par tous les protocoles qui commencent par les lettres prot . CFTPARM PROT = (identifier, identifier,..)

protocol
CFTNET, TYPE + TCP PROTOCOL = {' '|socks4} Dfinit le proxy de la ressource rseau TCP distante utilis pour accder au second rseau. SOCKS4 est le seul protocole de dialogue pour proxy pris en charge pour CFTNET. CFTCOM, TYPE=TCPIP PROTOCOL =string

puname
CFTNET, TYPE= SNA [PUNAME = string10] Nom du contrleur (*CTLD) rattach une ligne de communication (*LIND) et formant une unit physique (PU) utilise par CFT/OS400 ou d'autres applications (au total, 255 units peuvent tre rattaches un contrleur donn).

Manuel de rfrence

Les paramtres de CFT

4-85

Exemple : CFTNET MODE TYPE = CLASS = MAXCNX = NETPFX = PUNAME = LOCADR = = REPLACE, ID=LU0LINE0, SNA, 1, 2, /* circuits virtuels simult. */ CF1, /* prfixe nom objet et travail */ CTLLU0, /* ctlid associ (nom de ligne) */ 11 /* adresse locale */

rappl
CFTSEND, CFTRECV, SEND, RECV [RAPPL = string] string48 string....8 PeSIT E CFT/CFT PeSIT D profil CFT, PeSIT E

Identifiant de l'application rceptrice du fichier. Si la chane de caractres est place entre guillemets doubles (" "), la valeur est considre comme sensible la casse et utilise en l'tat. Le moniteur ne vrifie pas : le protocole utiliser pour le transfert. Si le protocole utilis est PeSIT D profil Extern, ETEBAC3 ou ODETTE, ce paramtre n'est pas envoy ; la taille maximale autorise par le protocole. Un seul contrle de la taille maximale de 48 caractres est effectu. PeSIT E ou PeSIT E CFT/CFT Dans PeSIT E standard ou PeSIT E CFT/CFT, le partenaire rpondeur/metteur peut envoyer et contrler ce champ. Dans PeSIT E standard, cette valeur est transporte dans le PI 04. Sa longueur maximale est limite par le format standard 8 caractres. Le PI 04 contient cette valeur concatne avec la valeur du champ ruser. Dans PeSIT E CFT/CFT, si la valeur de ce champ a une longueur suprieure 8 caractres, elle est transporte dans le PI 99. La valeur indique dans le PI 04 est tronque huit caractres.

rauth
CFTPART [RAUTH = {*|identifier}] Identifiant (paramtre ID) de la commande CFTAUTH dsignant une liste d'IDF autoriss pour les transferts en rception avec ce partenaire. Lorsque RAUTH est dfini avec *, tous les IDF peuvent tre utiliss avec le mme partenaire. Si l'ID commence par NOT, cet ID n'est as autoris pour ce partenaire.

rchkw
CFTPROT [RCHKW = {2|n}] Nombre maximum de points de synchronisation non acquitts qui sont autoriss par le rcepteur et ngocis pendant la phase de connexion. La valeur 0 signifie qu'il n'y a pas d'attente pour l'acquittement.

Manuel de rfrence

Les paramtres de CFT

4-86

La valeur 1 signifie qu'un transfert est en semi-duplex.

rcomp
CFTPROT [RCOMP = {cpr}] Compression maximale autorise pour la rception d'un fichier. Cette valeur peut tre comprise entre 0 et 15. Cette compression est ngocie entre l'metteur et le rcepteur. Une valeur de gale zro signifie l'absence de compression. CFTPROT RCOMP - Valeurs par dfaut
Protocole PeSIT profil SIT PeSIT D profil EXTERN PeSIT Profil CFT PeSIT E (standard) PeSIT E (CFT/CFT) ODETTE ETEBAC3 Valeur par dfaut de RCOMP Non applicable 10 15 10 15 1 Utilisable hors standard

Voir aussi scomp. Pour plus d'informations (valeurs utilisables, etc.), voir la rubrique Compression.

rcredit
CFTPROT [RCREDIT = {4|n}] {1...999} Protocole Odette Valeur du crdit propose par CFT lorsqu'il est en mode serveur. Entrez une valeur comprise entre 1 et 999. La valeur par dfaut est 4. Cette valeur est ngocie avec la valeur propose par le demandeur (voir le paramtre SCREDIT) lorsque la session de protocole est tablie.

rcvaller
CFTPARM [RCVALLER = {STOP|CONTINUE}] Action excuter si une erreur survient la rception des fichiers disponibles (avec l'option FILE= ALL).

recnb
CFTFILE, TYPE=COM [RECNB = {200|1...|00000}] Nombre d'enregistrements dans le fichier. TYPE=COM or TYPE=CAT

Manuel de rfrence

Les paramtres de CFT

4-87

Si TYPE = COM, ce paramtre est obligatoire. TYPE=CAT [RECNB = {100|1...|00000}] Nombre d'enregistrements dans le fichier. Si TYPE = CAT, cette valeur est facultative et doit correspondre au nombre maximum de postes de transfert prsents simultanment dans le catalogue. La valeur par dfaut est 100. Dans la mesure o la taille de fichier n'est pas extensible, l'oprateur doit personnaliser les valeurs des paramtres RH, SH, RT, ST, etc. de l'objet CFTCAT, afin d'viter une surcharge du fichier, ce qui entranerait un refus de prise en compte des nouvelles requtes de transfert.

recv
CFTNET [RECV = {2|n}] {1..9} MVS, VM, VSE Nombre de paramtres Receive any RPL pour cette ressource. En gnral, la valeur par dfaut ne doit pas tre modifie.

reserv
CFTEXIT [RESERV = {8192|1024|n}] {0..8192} {0..1024} Taille de l'espace de travail rserv au programme EXIT de l'utilisateur. Entrez la taille en octets. Ce champ s'applique uniquement aux EXIT suivants : annuaire :
o o

plage {0 1024} ; valeur par dfaut1024 ; plage {0 8192} ; valeur par dfaut8192.

fichier :
o o

Cette zone n'est pas utilise par l'interface de CFT. Vous pouvez l'utiliser pour enregistrer les informations que vous considrez comme ncessaires au traitement relatif votre programme. Ce paramtre ne s'applique pas aux tches ETEBAC EXIT ou de type fin de fichier.

restart
CFTPROT [RESTART = {5|n}] {0..32767} En mode demandeur Nombre maximum de tentatives de relance d'un transfert. Une tentative est prise en compte ds que la connexion physique au site distant est tablie correctement.

Manuel de rfrence

Les paramtres de CFT

4-88

resync
CFTPROT [RESYNC = {NO|YES}] Option pour la resynchronisation dynamique des changes pendant le transfert, sans interruption de la phase d'change de donnes, ngocie pendant la phase de connexion. Entre 2 CFT, la synchronisation n'est possible que pour les erreurs de contrle de redondance cyclique (CRC) o PAD=YES.

retrym
CFTTCP, CFTX25, CFTLU62 [RETRYM = {12|0...32767}] Utilisez ce champ pour spcifier le nombre maximum de tentatives de reconnexion. 12 (valeur par dfaut) ; n'importe quelle autre valeur comprise entre 0 et 32767. Si vous entrez 0 et si la connexion initiale choue, aucune tentative de reconnexion n'est effectue.

retryn
CFTTCP, CFTX25, CFTLU62 [RETRYN = {6|n}] Utilisez ce champ pour spcifier le nombre de tentatives de reconnexion effectuer avec un intervalle de retryw entre les tentatives. 6 (valeur par dfaut) ; n'importe quelle autre valeur comprise entre 0 et 32767. Lorsque retryn tentatives ont t effectues sans succs, CFT divise retryn par deux et multiplie retryw par deux, puis recommence la squence ; l'opration se rpte le nombre de fois spcifi par retrym. Exemple : si retryw = 1, retryn = 8, retrym = 20 Dans cet exemple, les tentatives de connexion ont lieu de la faon suivante : huit tentatives intervalles d'1 minute ; quatre tentatives intervalles de deux minutes ; deux tentatives intervalles de quatre minutes ; une tentative aprs un intervalle de huit minutes ; cinq tentatives intervalles de seize minutes.

retryw
CFTLU62, CFTTCP, CFTX25 [RETRYW = {7|N}] Intervalle (exprim en minutes) entre les tentatives de reconnexion. 7 (valeur par dfaut) ; n'importe quelle autre valeur comprise entre 0 et 32767.

Manuel de rfrence

Les paramtres de CFT

4-89

reverse
CFTPROT REVERSE = {NO|YES} Option permettant de rutiliser une connexion pour effectuer deux transferts l'un aprs l'autre dans des sens diffrents. Utilisable en mode demandeur uniquement.

rh
CFTCAT [RH = {10|n}] {1..99} Dlai (nombre de jours) l'issue duquel les postes catalogue pour les requtes de rception non termines (tat D, C, H ou K) sont automatiquement purgs.

rkerror
CFTCAT, CFTRECV [RKERROR = {KEEP|DELETE}] Action excuter si un transfert s'arrte suite une erreur de cration du fichier de rception (mode serveur) : KEEP : le transfert reste dans le catalogue ; DELETE : le transfert est supprim du catalogue. Si le paramtre RKERROR est galement dfini dans la commande CFTRECV, la commande CFTRECV est prioritaire

rootcid
PKICER (outil PKIUTIL) [ROOTCID = string 8] Ce paramtre est obligatoire pour les modes DELETE (suppression d'un certificat de la base de donnes) et REPLACE (mise jour d'un certificat). Il indique l'identifiant de l'autorit du certificat supprimer ou mettre jour. Ce paramtre doit mme tre indiqu pour un certificat d'autorit. Dans ce cas, les paramtres ID et ROOTCID ont la mme valeur.

rpacing
CFTPROT [RPACING = {36|N}] {0...32767} Taille interne, en kilo-octets, entre les deux points de synchronisation pour le rcepteur. Cette valeur est ngocie avec l'espacement de l'metteur. La valeur 0 signifie qu'il n'existe aucun point de synchronisation.

rrusize
CFTPROT [RRUSIZE = {4056|n}] {254...4096} Taille maximale des NSDU (Network Service Data Units, units de donnes du service rseau) reues. Ce paramtre n'est pas ngoci. Il prend gnralement la valeur par dfaut.

Manuel de rfrence

Les paramtres de CFT

4-90

rt
CFTCAT [RT = {10|n}] {1..99} Dlai (nombre de jours) aprs lequel les postes catalogue des transferts en rception termins (tat RT) sont automatiquement purgs.

rto
CFTPROT [RTO = {260|n}] {0..3600} Dlai de suivi du rseau (exprim en secondes), l'exclusion de la phase de connexion/dconnexion/interruption du protocole. Correspond au dlai d'attente d'une rponse une FPDU avant la dconnexion (READ TIME OUT). Si la valeur est 0, le dlai d'attente est infini.

ruser
CFTRECV, CFTSEND, RECV, SEND [RUSER = string] string8 PeSIT D profil CFT, PeSIT E string28 PeSIT E CFT/CFT Identifiant d'un utilisateur rcepteur de fichier. Lorsque ce paramtre est entr, sa pertinence quant au protocole utiliser pour le transfert n'est pas contrle : si le protocole utilis est PeSIT D profil Extern, PeSIT profil SIT, ETEBAC3, ODETTE, ce paramtre n'est pas envoy. La taille maximale admise par le protocole n'est pas contrle. Seul un contrle concernant la taille maximale de 28 caractres (autorise dans PeSIT E entre deux moniteurs CFT) est effectu. Remarque : dans PeSIT E standard, la valeur du paramtre RUSER est transporte dans le PI 04. Sa longueur maximale est limite par le format standard 8 caractres. Ce PI 04 contient cette valeur concatne avec la valeur du paramtre RAPPL. Dans PeSIT E entre 2 moniteurs CFT, si la valeur de ce paramtre RUSER a plus de 8 caractres, cette valeur est transporte dans le PI 99, la valeur dfinie dans le PI 04 tant tronque 8 caractres. PeSIT D profil CFT PeSIT E standard PeSIT E CFT/CFT Voir aussi SUSER. Dans le profil CFT, ce paramtre ne doit pas tre dfini lorsque le moniteur partenaire est un CFT/370 Version 1 ou un CFT/PC. Ce paramtre peut tre envoy et contrl par le partenaire serveur/metteur.

Manuel de rfrence

Les paramtres de CFT

4-91

rx
CFTCAT [RX = {10|n}] {1..99} Dlai (nombre de jours) aprs lequel les postes catalogue des transferts en rception pour lesquels la procdure de fin de rception est excute correctement (tat RX) sont automatiquement purgs.

sap
CFTPROT [SAP = string32] Nom du SAP (point d'accs au service) local associ ce protocole. Il permet d'identifier le point d'accs o sont places les requtes de connexion entrantes pour ce protocole de communication. La valeur du SAP dpend des protocoles d'change de donnes utiliss par chaque mthode d'accs. Le SAP fourni par un partenaire demandeur lorsqu'il cre sa requte de connexion est rcupr par le CFT local, qui s'en sert pour dduire le protocole utiliser. Chaque commande CFTPROT dans une classe de ressource donne doit inclure son SAP spcifique. La valeur de ce paramtre peut tre exprime dans un format hexadcimal. Dans ce cas, le premier caractre doit tre # (signe indiquant un numro) (exemple : #31 est interprt comme le caractre ASCII 1). Si le paramtre SAP n'est pas dfini sur une valeur pour un protocole donn, ce protocole n'est disponible qu'en mode demandeur. CFTPROT SAP - Valeurs du paramtre
Mthode d'accs DNA SNA Taille en caractres 18 Dfinition et commentaires OBJECT Decnet Non applicable. Ne doit pas forcment tre spcifi Le protocole entrant est automatiquement slectionn partir de la ressource rseau (LU ou groupe de LU) Numro du port de suivi local sur lequel le moniteur peut tre appel, exprim sous la forme : du numro rel utilis par TCP/IP :
o o

TCP/IP

1 15

des numros autoriss : entre 1025 et 65535 numros recommands : 1761, 1762, 1763, 1764, 1765, 1766, 1767, 1768 (1)

nom logique associ au numro utilis par TCP/IP et configur dans le fichier SERVICES (si ce fichier existe) noms logiques recommands : cft-0, cft-1, cft-2, cft-3, cft-4, cft-5, cft-6, cft-7 (1)

Manuel de rfrence

Les paramtres de CFT

4-92

Mthode d'accs X25 l'exception de GCOS7 et de GCOS8

Taille en caractres 1 15

Dfinition et commentaires Valeur achemine dans le paquet d'appel entrant sous la forme : d'une sous-adresse (Subaddr), dont la valeur doit alors tre numrique et qui sera convertie en majuscules. Les valeurs interprtes doivent tre en MAJUSCULES (par exemple, SAP=33) donnes utilisateur, dont le format peut tre hexadcimal (par exemple, SAP=#3132, 12 ASCII) ou alphanumrique (par exemple, SAP=ABC, SAP=X25) Cas spcial pour OS400 : dans les donnes utilisateur, seul le premier caractre (limit certaines plages de valeurs) est significatif pour le routage des appels entrants (voir le Guide d'exploitation de CFT spcifique votre systme d'exploitation)

X25 GCOS7

Constitu des lments suivants : 18 rfrence de la bote aux lettres CFT locale caractre de sparation facultatif : (facultatif) sous-adresse facultative de l'appelant, que CFT peut dfinir lorsqu'il est demandeur dans le paquet d'appel (facultatif) Constitu des lments suivants : rfrence de la bote aux lettres CFT locale nom de contrle de session locale (1 4 caractres, complts par des espaces droite si ncessaire) nom de la de la bote aux lettres CFT locale (1 8 caractres) caractre de sparation facultatif : sous-adresse facultative de l'appelant (0 5 caractres), que CFT peut dfinir lorsqu'il est demandeur dans le paquet d'appel

GCOS8

5 12

(1) : ces numros et noms de ports logiques ont t officiellement rservs par Axway auprs de l'IANA (Internet Assigned Numbers Authority). Les remarques suivantes concernent la mthode d'accs X25 : si l'appelant est un hte IBM : voir les remarques dans le Guide d'exploitation de CFT/MVS concernant l'utilisation des sous-adresses et des donnes utilisateur dans X25. En ce qui concerne la compatibilit CFT V1/V2, CFT V2 ne peut pas excuter plusieurs transferts simultanment avec un CFT V1 utilisant les donnes utilisateur pour acheminer le SAP. Il s'agit d'une limitation de CFT V1 pour IBM/370. Pour contourner cette limitation, vous devez : dclarer autant de partenaires (CFTPART et CFTX25) correspondant CFT version 1 que le nombre de connexions simultanes tablir ; ou dclarer autant de protocoles (CFTPROT) que le nombre de connexions simultanes possibles. Chacun de ces protocoles peut alors accder au partenaire CFT version 1. Le paramtrage suivant sera alors obtenu, par exemple : CFTPROT CFTPROT CFTPROT ID ID ID = prot1, = prot2, = prot3,

Manuel de rfrence

Les paramtres de CFT

4-93

CFTPART PROT SAP

ID = cft370, = (prot1, prot2, prot3), = (sap1 , sap2 , sap3),

Le passage d'un protocole un autre est automatique lorsque la connexion au protocole prcdent est refuse, aprs la squence de nouvelle tentative ; ou tre en mode SAPTYP = SUBADDR. Cette restriction n'existe pas dans ce mode. Il est donc ncessaire, l'extrmit V1, d'utiliser un MCH de NPSI dfini avec SUBADDR = YES. WinNT Les couches ATLANTIS X25 ne sont pas capables de diriger les appels entrants vers plusieurs utilisateurs en fonction des donnes utilisateur des paquets d'appel. Les SAP numriques X25 (sous-adresses) sont grs sous VMS sans prise en compte des zros gauche. Par exemple : CFTPROT SAP = 05, et CFTPROT SAP = 5, sont considrs comme identiques par VMS ; ou utiliser un SAP dcimal qui est dfini comme sous-adresse (subaddr)

VMS

CFTPART [SAP = (string, string, string, ...)] Valeurs des SAP (points d'accs au service) distants associs chacun des protocoles dfinis par le paramtre PROT. Pour les transferts vers un moniteur autre que le moniteur CFT, l'utilisation de ces informations supplmentaires doit tre examine au cas pas cas. Pour les transferts vers un moniteur CFT, ce paramtre est utilis pour dsigner le protocole appliqu au moniteur CFT partenaire. En d'autres termes, le sap est un lment d'information supplmentaire pour joindre un sous-ensemble applicatif distant (un protocole dans le cas de CFT), et non seulement un moniteur. Chaque valeur du paramtre reprsente le sap associ au protocole de communication, dont l'identifiant correspond dans le paramtre 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 paramtre peut tre exprime dans un format hexadcimal. Dans ce cas, le premier caractre doit tre # (signe indiquant un numro) (exemple : #31 est interprt comme le caractre ASCII '1'). Le nombre maximum de SAP est gal au nombre maximum de protocoles (voir le tableau concernant le paramtre PROT). La valeur de ce paramtre est spcifique chaque protocole d'change de donnes et chaque systme (selon e cas), comme indiqu dans le tableau suivant.

Manuel de rfrence

Les paramtres de CFT

4-94

CFTPART SAP - Valeurs du paramtre


Mthode d'accs DNA LU6.2 SNA Taille en caractres (alphanum.) 16 OBJECT Decnet Non applicable, ne doit pas forcment tre spcifi. Le protocole du partenaire est dtermin par l'unit logique (LU) appele Non applicable, ne doit pas forcment tre spcifi Le protocole du partenaire est dtermin par l'unit logique (LU) appele 1 15 Numro du port sur lequel le moniteur partenaire est l'coute La valeur de ce numro peut tre : un numro en clair correspondant au numro rel utilis par le partenaire au niveau du protocole TCP/IP Numros autoriss : entre 1025 et 65535 (valeurs limites non comprises) Numros recommands : entre : 1761, 1762, 1763, 1764, 1765, 1766, 1767, 1768 (1) nom logique associ au numro utilis par TCP/IP et configur dans le fichier SERVICES, si ce fichier existe Noms logiques recommands : cft-0, cft-1, cft-2, cft-3, cft-4, cft-5, cft-6, cft-7 (1) Remarque : si les commandes de paramtrage des partenaires local et distant (respectivement, CFTPART et CFTPROT) utilisent le nom logique du port dfini dans la base de donnes SERVICES , la cohrence des deux bases doit tre garantie X25 l'exception de GCOS7 et GCOS8 1 15 Valeur achemine dans le paquet d'appel sortant sous la forme : d'une sous-adresse (subaddr), la valeur doit alors tre numrique et en majuscules Exemple : SAP=33 donnes utilisateur, dont le format peut tre hexadcimal (par exemple, SAP=#3132, 12 ASCII) ou alphanumrique (par exemple, SAP=ABC, SAP=X25) Exception pour OS400 : dans les donnes utilisateur, seul le premier caractre (limit certaines plages de valeurs) est significatif pour le routage des appels entrants. Dfinition et commentaires

TCP/IP

(1) : ces numros et noms de ports logiques ont t officiellement rservs par SOPRA auprs de l'IANA (Internet Assigned Numbers Authority).

sappl
CFTSEND, SEND, RECV [SAPPL = string] string8 string48 PeSIT D profil CFT, PeSIT profil SIT, PeSIT E PeSIT E CFT/CFT

Identifiant de l'application mettrice du fichier. Suivant le profil protocolaire, il s'agit : d'une chane de huit caractres pour PeSIT D CFT, PeSIT E, PeSIT SIT ; d'une chane de 48 caractres pour PeSIT E CFT/CFT. Si la chane de caractres est place entre guillemets doubles (" "), la valeur est considre comme sensible la casse et utilise en l'tat.

Manuel de rfrence

Les paramtres de CFT

4-95

Le moniteur ne vrifie pas : la pertinence en ce qui concerne le protocole utiliser pour le transfert. Si le protocole utilis est PeSIT D profil Extern, ETEBAC3 ou ODETTE, ce paramtre n'est pas envoy ; la taille maximale autorise par le protocole. Un seul contrle relatif la taille maximale de 48 caractres est effectu. PeSIT Dans PeSIT E standard ou PeSIT E CFT/CFT, le partenaire rpondeur/metteur peut envoyer et contrler ce champ. Dans PeSIT E standard, cette valeur est transporte dans le PI 03. Sa longueur maximale est limite par le format standard 8 caractres. Le PI 03 contient cette valeur concatne avec la valeur du champ suser. Dans PeSIT E CFT/CFT, si la valeur de ce champ a une longueur suprieure 8 caractres, elle est transporte dans le PI 99. La valeur indique dans le PI 03 est tronque huit caractres.

sauth
CFTPART [SAUTH = {*|identifiant}] Identifiant (paramtre ID) de la commande CFTAUTH dsignant une liste d'IDF autoriss pour les transferts en envoi vers ce partenaire. Si vous tapez *, tous les fichiers types (tous les IDF) peuvent tre utiliss. Si l'ID commence par NOT, l'ID n'est pas autoris pour ce partenaire.

schkw
CFTPROT [SCHKW = {2|n}] {0...12} Une valeur comprise entre 0 et 12 qui reprsente le nombre maximum de points de synchronisation non acquitts. Cette valeur est ngocie avec le partenaire rcepteur. Taille de la fentre d'anticipation d'acquittement du mode SEND pour les points de synchronisation, exprime sous la forme d'un nombre de points de synchronisation non acquitts. La valeur est ngocie pendant la phase de connexion avec la valeur RCHKW du partenaire. Cette fentre est utilise pour envoyer les donnes avant la rception des acquittements. SCHKW=0 signifie que les points de synchronisation ne sont pas acquitts. Sur les rseaux LU6.2, toutes les valeurs non nulles seront forces 1 pendant la ngociation protocolaire.

scomp
CFTPROT [SCOMP = {voir tableau | cpr}] Compression maximale autorise pour l'mission d'un fichier. rcomp//scomp = 0 (pas de compression) ; rcomp//scomp = 1 (compression d'une chane de caractres blancs) ; rcomp//scomp = 2 (compression d'une chane de caractres identiques) ; rcomp//scomp = 4 (compression de caractres) ;

Manuel de rfrence

Les paramtres de CFT

4-96

rcomp//scomp = 8 (compression verticale) ; rcomp//scomp = 15 (toutes compressions). Cette compression est ngocie entre l'metteur et le rcepteur. CFTPROT SCOMP - Valeurs par dfaut
Protocole PeSIT profil SIT PeSIT D profil EXTERN PeSIT D profil CFT PeSIT E (standard) PeSIT E (CFT/CFT) ODETTE ETEBAC3 Valeur par dfaut de SCOMP Non applicable 10 15 10 15 1 Utilisable hors standard

scope
LISTUCONF SCOPE= INSTANCE|SET|ALL|*

scredit
CFTPROT [RCREDIT = {4|n}] {1...999} Protocole Odette Valeur du crdit (exprime comme un nombre de messages DATA ) propose par CFT lorsqu'il est demandeur. Entrez une valeur comprise entre 1 et 999. La valeur par dfaut est 4. CFT est autoris envoyer un nombre de messages protocolaires DATA gal au rsultat de la ngociation (effectue l'tablissement de la session de protocole) avant d'attendre l'envoi d'un nouveau crdit par le serveur.

secfname
CFTPARM [SECFNAME = filename] Nom de fichier. Nom du fichier de scurit interne de CFT.

segment
CFTPROT [SEGMENT = {NO|YES}] Uniquement en mode metteur Profile Option permettant de segmenter des enregistrements de fichier en plusieurs FPDU. NO : segmentation si ncessaire . Mis en oeuvre automatiquement lorsqu'un enregistrement transfrer dpasse la taille maximale d'une NSDU moins 6 octets. Cela concerne les FPDU de donnes, et non les autres FPDU de protocole. N'oubliez pas que la taille des NSDU envoyes est ngocie avec le paramtre

Manuel de rfrence

Les paramtres de CFT

4-97

SRUSIZE de CFTPROT ; YES : segmentation systmatique . Mis en oeuvre par le moniteur pour complter une unit de donnes (NSDU). Cette option concerne donc toutes les tailles d'enregistrement. Cette option est efficace uniquement si elle est associe avec l'option CONCAT = YES. Elle n'exclut pas l'option MULTART = YES. Profil SIT La valeur SEGMENT = YES est BLOQUEE dans le profil SIT.

Cette option n'est pas ngocie. Pour les autres profils, elle ne peut tre adopte (SEGMENT = YES) qu'avec un moniteur qui prend en charge la concatnation des FPDU DTF (enregistrement complet) et DTFDA (dbut d'enregistrement), DTFMA (milieu d'enregistrement) ou DTFFA (fin d'enregistrement) dans une certaine unit de donnes (NSDU). Cette option peut toujours tre adopte avec un moniteur CFT, partir de la version 2.1.0. En effet, en mode rcepteur, ce moniteur accepte les FPDU des enregistrements segments indpendamment de la valeur locale du paramtre SEGMENT.

selfname
CFTSEND, SEND [SELFNAME = filename] {string512} Nom du fichier qui contient la liste des fichiers slectionns pour l'mission.

sh
CFTCAT [SH = {10|n}] {1..99} Dlai (nombre de jours) l'issue duquel les postes catalogue pour les requtes d'mission non termines (tat D, C, H ou K) sont automatiquement purgs.

share
CFTCAT [SHARE = {NO|YES}] {1...1441} L'option SHARE = NO est prise en charge par dfaut par tous les systmes. Le catalogue n'est accessible que pour une seule activit de CFT. L'option SHARE = YES permet de partager le fichier catalogue entre plusieurs activits de CFT. Plusieurs activits de CFT peuvent ainsi oprer sur le mme catalogue. Cela est surtout utilis dans certains environnements, pour augmenter le nombre de transferts parallles pris en charge. Dans ce cas (partage du catalogue), le paramtre CACHE n'est pas applicable. Afin de rduire la frquence des accs au fichier catalogue, il est alors recommand d'utiliser une valeur leve pour le paramtre UPDAT, ou encore UPDAT=0 (voir plus loin dans ce chapitre). Attention : le partage du catalogue entrane une surcharge non ngligeable lie la gestion des conflits d'accs. Par consquent, il est recommand de ne pas dfinir ce paramtre sur YES si cela n'est pas absolument ncessaire.

Manuel de rfrence

Les paramtres de CFT

4-98

SHARE = YES - Systmes d'exploitation concerns


Systme dexploitation GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM VMS VOS VSE Windows SHARE = YES OUI OUI NON NON NON OUI NON OUI NON NON NON

sname
CFTETB [SNAME = {pos, 255|len}] Position (pos) et longueur (len) du champ identifiant du demandeur dans la carte ETEBAC. Indique le champ de stockage du paramtre NSPART (pour CFTPART).

spacing
CFTPROT [SPACING = {36|n}] {0..32767} Intervalle entre les points de synchronisation envoys (en kilo-octets). Ce paramtre est ngoci avec le partenaire (paramtre RPACING dans le cas du moniteur CFT) ; la plus petite valeur est slectionne comme intervalle entre les points de synchronisation. La valeur 0 signifie qu'il n'existe aucun point de synchronisation. Pendant un transfert, les deux partenaires PeSIT prennent un "point de synchronisation" chaque fois que l'metteur envoie une FPDU SYN . Une FPDU SYN est mise pour chaque "n kilo-octets" de donnes mis (o "n" est la plus petite valeur d'intervalle ngocie dans la phase de connexion - entre SPACING et RPACING dans le cas des moniteurs CFT). Chaque point de synchronisation acquitt peut constituer un point de reprise pour un redmarrage ultrieur dans le cas o un transfert est interrompu.

Manuel de rfrence

Les paramtres de CFT

4-99

spart
CFTSEND, SEND [SPART = string32] Dsignation du rseau par laquelle le moniteur CFT local s'identifie sur son partenaire. Si le paramtre NSPART de l'objet CFTPART associ SEND n'est pas dfini, la valeur SPART sera prise en compte. En mode demandeur, SPART = string8. La valeur de ce paramtre est gnralement gale l'identifiant (paramtre ID de l'objet CFTPART). Dans ce cas, le paramtre NSPART qui est envoy est celui dfini dans l'objet CFTPART. Il peut ce titre dpasser 8 caractres. Si l'objet CFTPART n'existe pas, le paramtre NSPART par dfaut est gal la valeur du paramtre SPART et ne dpasse donc pas 8 caractres. Ce mcanisme est utilis en particulier sur le site intermdiaire assurant la commutation VAN : lorsque la commande SEND est active pour un transfert vers le site de destination, ce paramtre SPART est en fait utilis pour dfinir le paramtre NSPART envoy sur la valeur de l'metteur INITIAL du fichier.

speed
CFTNET TYPE = X.25, CFTX25 [SPEED = {9600|n}] {300..65536} Vitesse de la ligne d'abonn en bit/s. Cette valeur DOIT correspondre aux caractristiques de votre abonnement X25 : la vitesse du circuit virtuel est la vitesse de l'abonnement X.25 ou de la ligne X.25 ; la valeur par dfaut est 9600. OS400

srchost
CFTNET [SRCHOST = {hostname1|64}] Ce paramtre est utilis uniquement pour les appels sortants sur cette ressource. Si une valeur (adresse IP ou nom d'hte local) est affecte, cette valeur est utilise pour slectionner l'interface sur laquelle l'appel sortant aura lieu. Exemple : CFTPROT ID = PANY, SAP = 1761....NET=ANY CFTNET ID=ANY, HOST = INADDR_ANY, SRCHOST= mon.adresse.net O my.address.net est utilis pour l'appel sortant.

srcports
CFTNET [SRCPORTS = {str15, str15, ... str15}] La liste des ports peut contenir jusqu' 16 instances de str15.

Manuel de rfrence

Les paramtres de CFT

4-100

Les dfinitions des ports sortants sont les suivantes : par dfaut (5000 - 65535). Exemples : cet exemple dfinit 3 plages de ports sortants : SRCPORTS=(6000-6009,6010-6019,6020-6030) ; Slection des ports du systme d'exploitation : SRCPORTS= () ; 1 plage de ports est encore possible : SRCPORTS=(6000-6030).

srin
CFTPROT [SRIN = {BOTH|NONE|SENDER|RECEIVER}] Mode serveur uniquement Slectionnez le sens des transferts (fichiers ou messages) autoris pour ce protocole sur le moniteur CFT : SENDER : transferts en envoi uniquement ; RECEIVER : transferts en rception uniquement ; BOTH (valeur par dfaut) : transferts en envoi et en rception ; NONE : pas de transferts.

srout
CFTPROT [SROUT = {BOTH|NONE|SENDER|RECEIVER}] Mode demandeur uniquement Slectionnez le sens des transferts (fichiers ou messages) autoris pour ce protocole sur le moniteur CFT : SENDER : transferts en envoi uniquement ; RECEIVER : transferts en rception uniquement ; BOTH (valeur par dfaut) : transferts en envoi et en rception ; NONE : pas de transferts.

srusize
CFTPROT [SRUSIZE = {4050|n}] {254..32767} Taille maximale des NSDU envoyes. Ce paramtre est ngoci avec le partenaire (paramtre rrusize s'il s'agit d'un moniteur CFT), la plus petite valeur tant adopte en tant que taille de la NSDU envoye. Pour transfrer un enregistrement dont la longueur dpasse SRUSIZE - 6, l'opration de segmentation est mise en oeuvre. Voir les Protocoles de CFT pour optimiser la dfinition de la valeur de ce paramtre. MVS, VM, VSE : pour une connexion X25/NPSI, la valeur maximale de SRUSIZE est gale la valeur X25.PIU configure dans le NCP (ou l'quivalent) moins (-) 6 octets.

Manuel de rfrence

Les paramtres de CFT

4-101

sserv
CFTPROT [SSERV = {voir tableau ci-dessous| identifier}] PeSIT D profil CFT, PeSIT D profil EXTERN Identifie le service (ou la variante du protocole) requis du partenaire entrant. Sa valeur est achemine dans le message LOGON du protocole PeSIT. Ce paramtre doit tre spcifi uniquement pour le profil CFT ou le profil Extern qui s'applique, dans certains cas spcifiques. Certains produits, comme indiqu ci-aprs, utilisent ce paramtre comme slecteur de protocole pour les appels entrants. Dtails du paramtre sserv
PeSIT D profil EXTERN PeSIT D profil CFT Dans le profil EXERN, la valeur par dfaut est : SSERV = PESIT . Cette valeur est normalise. Dans le profil CFT, la valeur par dfaut est : SSERV = CFTPSITX. Cette valeur convient uniquement avec une mthode d'accs X25. Avec les autres mthodes d'accs au rseau, les valeurs suivantes sont gnralement utilises : dans SNA LU-0 : CFTPSITS, dans SNA 3270 : CFTPSIT2, dans PAD : CFTPSITP. Avec CFT 370/V1, cette valeur est mise en correspondance avec la valeur RSERV configure dans V1. Avec CFT/PC, cette valeur est mise en correspondance avec le paramtrage (type de connexion) de CFT/PC. La valeur SSERV = GSIT est utilise en mode demandeur pour les changes via TCP/IP. L'utilisation de cette valeur de paramtre n'a aucune incidence sur le message qui contient la valeur PeSIT . La valeur par dfaut est : SSERV = car ce paramtre est inoprant. Dans le profil SIT, il n'existe pas de message de connexion.

PeSIT profil ANY

PeSIT PROFIL SIT

SSL
CFTPROT [SSL = identifier] Identifiant pour l'objet CFTSSL qui sert de profils de scurit. En mode demandeur, cette valeur est utilise comme profil de scurit par dfaut. En mode serveur, CFT refuse de dmarrer s'il ne trouve pas l'objet CFTSSL qui correspond l'identifiant spcifi ici. CFTPART [SSL = identifier] Identifiant pour la commande CFTSSL qui sert de profils de scurit en mode client ou qui spcifie d'autres contrles en mode serveur.

Manuel de rfrence

Les paramtres de CFT

4-102

sslmtask
CFTPARM [SSLMTASK = n] {1...16} Nombre maximum de tches SSL qui peuvent s'excuter simultanment dans un moniteur CFT. 1 : valeur par dfaut pour UNIX et Windows ; 16 : valeur par dfaut pour MVS.

sslttask
CFTPARM [SSLTTASK = n].. Nombre maximum de sessions rseau simultanes garanties par une tche SSL. Audessus de cette valeur, une nouvelle tche est cre, si besoin est. Si le nombre maximum de tches SSL est atteint (valeur sslmtask), les autres sessions sont rparties de faon gale entre toutes les tches SSL. Entrez l'une des valeurs suivantes : 16 : valeur par dfaut pour UNIX ; 128 : valeur par dfaut pour Windows ; 16 : valeur par dfaut pour MVS ; toute autre valeur :
o o o

1 to 16 pour UNIX ; 1 128 pour Windows ; 1 16 pour MVS.

sslwresp
CFTPARM [SSLWRESP = { 60 | n }] {1...32767 } Le dlai, en secondes, accord une tche SSL pour dmarrer et renvoyer son tat d'initialisation : 5 : valeur par dfaut pour UNIX ; 60 : valeur par dfaut pour MVS et Windows ; n'importe quelle autre valeur comprise entre 1 et 32767. Si aucun tat n'est retourn dans ce dlai, CFT considre que la tche n'a pas pu tre initialise et reporte le transfert en mode demandeur ou ferme la connexion rseau en mode serveur.

sslwtask
CFTPARM [SSLWTASK = {1441|n}]... {1...1441} Dfinissez le dlai d'inactivit, en minutes, de la tche SSL. Au-del de ce dlai, la tche est arrte. Une tche SSL est considre comme inactive si elle ne gre plus aucune session. 1441 : valeur par dfaut. Cette valeur rend la tche permanente ; n'importe quelle autre valeur comprise entre 1 et 1441.

Manuel de rfrence

Les paramtres de CFT

4-103

st
CFTCAT [ST = {10|n}] {1..99} Dlai (nombre de jours) aprs lequel les postes catalogue des transferts en envoi termins (tat ST) sont automatiquement purgs.

state
CFTRECV, CFTSEND, RECV, SEND [STATE = {DISP|HOLD|KEEP}] Dfinit l'tat de la requte de transfert : DISP : la requte est enregistre l'tat D ( disposition) dans le catalogue ; cet tat correspond un transfert immdiat (c'est--dire excut ds que possible, les contraintes en matire de plage temporelle et de transfert parallle tant donnes, etc.) ; HOLD : la requte est enregistre l'tat H dans le catalogue ; cet tat correspond un transfert diffr. Le transfert est excut ultrieurement : soit l'acceptation d'une requte de rception distance ; soit la suite d'une commande START locale ayant fait pass ce transfert l'tat disponible (D) ; KEEP : la requte est enregistre l'tat K dans le catalogue ; cet tat correspond un transfert diffr. Le transfert peut seulement tre excut ultrieurement aprs tre pass l'tat disponible la suite d'une commande START locale.
o o

LISTCAT, DELETE, START, KEEP, HALT, RESUME, SUBMIT, END, DISPLAY [STATE = {*|C|CDHKTX}] Slectionnez l'un des tats de transfert suivants : * C CDHKTX CFTPART [STATE = string] Etat du partenaire : ACTIVEBOTH (par dfaut) - partenaire actif dans tous les modes ; ACTIVEREQ - partenaire actif en mode requte uniquement ; ACTIVESERV - partenaire actif en mode serveur uniquement ; NOACTIVE - partenaire inactif. PKICER (outil PKIUTIL) State dsigne l'tat d'un certificat import. Si ce dernier est activ, il peut tre utilis par CFT. Les options sont les suivantes : Act - activ ; Inact - dsactiv.

Manuel de rfrence

Les paramtres de CFT

4-104

suser
CFTRECV, CFTSEND, SEND, RECV [SUSER = string] string8 string28 PeSIT D profil CFT, PeSIT E PeSIT E CFT/CFT

Identifiant de l'utilisateur metteur du fichier. Lorsque ce paramtre est entr, sa pertinence quant au protocole utiliser pour le transfert n'est pas contrle : si le protocole utilis est PeSIT D profil Extern, PeSIT profil SIT, ETEBAC3, ODETTE, ce paramtre n'est pas envoy. La taille maximale admise par le protocole n'est pas contrle. Seul un contrle concernant la taille maximale de 28 caractres (autorise dans PeSIT E entre deux moniteurs CFT) est effectu. Remarque : dans PeSIT E standard, la valeur du paramtre SUSER est transporte dans le PI 03. Sa longueur maximale est limite par le format standard 8 caractres. Ce PI 03 contient cette valeur concatne avec la valeur du paramtre SAPPL. Dans PeSIT E entre 2 moniteurs CFT, si la valeur de ce paramtre SUSER a plus de 8 caractres, cette valeur est transporte dans le PI 99, la valeur dfinie dans le PI 03 tant tronque 8 caractres. PeSIT D profil CFT PeSIT E standard PeSIT E CFT/CFT Voir aussi RUSER. Dans le profil CFT de PeSIT, ce paramtre ne doit pas tre dfini lorsque le moniteur partenaire est un CFT/370 Version 1 ou un CFT/PC. Ce paramtre peut tre envoy et contrl par le partenaire serveur/metteur.

switch
CFTACCNT [SWITCH = {00000000|time}] Heure laquelle le moniteur CFT bascule automatiquement vers le fichier statistique secondaire. 000000 (valeur par dfaut) ; toute autre valeur au format HHMMSS. Lorsque ce paramtre n'est pas dfini, CFT bascule d'un fichier statistique l'autre chaque jour minuit. CFTLOG [SWITCH = {00000000|time}] Heure laquelle le moniteur bascule automatiquement sur le fichier journal altern : 000000 (valeur par dfaut) ; toute autre valeur au format HHMMSS. Lorsque ce paramtre n'est pas dfini, CFT bascule d'un fichier journal l'autre chaque jour minuit.

Manuel de rfrence

Les paramtres de CFT

4-105

Si vous dfinissez une valeur pour le champ maxrec et pour le champ de bascule, CFT bascule automatiquement d'un fichier journal l'autre : chaque jour l'heure indique ; en fonction du nombre d'enregistrements dans le fichier.

sx
CFTCAT [SX = {10|n}] {1..99} Dlai (nombre de jours) aprs lequel les postes catalogue des transferts en mission termins pour lesquels la procdure de fin de transfert en mission a t excute correctement (tat SX) sont automatiquement purgs.

syst
CFTPART [SYST = string] Dfinit le systme d'exploitation pour le site partenaire. Choisissez le systme d'exploitation appropri qui prend en charge le moniteur partenaire dans la liste suivante : GCOS7, GCOS8, GUARD, MSDOS, MVS, OS400, UNIX, VM, VMS, VOS, VSE, WINNT, WIN3X.

tcycle
CFTSEND, RECV, SEND [TCYCLE = {DAY|MIN|MONTH}] Unit de la priode du cycle de transfert. Cette unit peut tre : DAY : jour ; MIN : minute ; MONTH : mois.

time timep
CFTCAT TIMEP = {23595999|HHMMSSCC} Heure de purge quotidienne choisie par l'utilisateur. L'utilisateur peut programmer une purge cyclique automatique du catalogue. L'heure de purge par dfaut est fixe minuit. Remarque : vous pouvez dsactiver compltement la purge en dfinissant TIMEP = 00000000. Utilisez cette option avec prudence car aucune purge automatique n'est excute ( l'heure slectionne ou minuit). PURGE [TIMEP = {23595999 | HHMMSSCC} Heure de purge slectionne par l'utilisateur. Remarque : vous pouvez dsactiver la purge suivante en spcifiant TIMEP = 00000000.

Manuel de rfrence

Les paramtres de CFT

4-106

Excutez cette opration avec prudence, en raison des risques de surcharge du catalogue qui peuvent provoquer une baisse des performances et un dpassement de capacit. Si la purge suivante fait partie d'un cycle (voir le paramtre CFTCAT TIMEP), c'est l'ensemble du cycle qui est supprim, et pas uniquement l'occurrence suivante de ce cycle.

tlvclear tlvcexec tlvwarn


0 signifie qu'aucune alerte ne sera mise.

tlvwexec tlvwrate tpname


CFTNET, CFTLU62 [TPNAME = string ] SNA LU6.2 uniquement Nom de la conversation en attente de transaction sur le site local. Entrez une chane comportant jusqu' 16 caractres pour spcifier le nom de la transaction dclenche sur le site distant.

trantask
CFTPARM [TRANTASK = 1|n] Si le nombre de tches d'accs aux fichiers autorises est atteint (MAXTASK), d'autres transferts en parallle (jusqu' MAXTRANS) sont rpartis de manire gale entre les tches d'accs les moins charges. Le nombre maximum de transferts en parallle (arrondi la prochaine unit suprieure) qu'une tche d'accs aux fichiers peut avoir grer est : valeur MAXTRANS / valeur MAXTASK Le mcanisme gr de cette faon par l'intermdiaire du paramtre TRANTASK opre uniquement lorsque la valeur MAXTRANS/MAXTASK est suprieure ou gale la valeur TRANTASK. C'est--dire MAXTASK * TRANTASK / MAXTRANS. Le tableau suivant indique la valeur maximale prise en charge pour chaque systme.
Systme dexploitation GCOS7 GCOS8 GUARDIAN MVS OS400 UNIX VM Valeur minimale 8 30 10 14 32 8 14

Manuel de rfrence

Les paramtres de CFT

4-107

Systme dexploitation VMS VOS VSE Windows

Valeur minimale 8 20 14 Non applicable

GCOS8 Exemple : MAXTRANS = 10, MAXTASK = 2, TRANTASK = 4, Cre 2 tches d'accs aux fichiers, chacune traitant 4 transferts. Les neuvime et dixime transferts sont affects aux tches existantes. Le onzime transfert concurrent est mis en attente jusqu' ce que des ressources deviennent disponibles.

trk
CFTRECV, CFTSEND, RECV, SEND [TRK = {"value of TRKOR of CFTPARM"|ALL|NO|SUMMARY|UNDEFINED}] Spcification de la quantit d'informations fournies par CFT au produit Synchrony Sentinel propos des transferts. CFT envoie des informations dtailles sur les transferts sous la forme d'instances suivies. Ce paramtre peut prendre les valeurs suivantes : NO : le moniteur n'envoie jamais d'instances suivies Synchrony Sentinel ; ALL : pour chaque tape du processus de transfert, le moniteur envoie une instance suivie Synchrony Sentinel ; SUMMARY : pour les tapes initiale et finale de chaque processus de transfert, le moniteur envoie une instance suivie Synchrony Sentinel ; UNDEFINED : les options de suivi sont dfinies dans le paramtre TRK de la commande CFTPART. CFTPART, CFTPARM TRKPART [TRK = {TRKSEND of CFTPART|ALL|NO|SUMMARY|UNDEFINED}] Spcification de la quantit d'informations fournies par CFT Sentinel propos des transferts avec un partenaire. CFT envoie des informations dtailles sur les transferts sous la forme d'instances suivies. Ce paramtre peut prendre les valeurs suivantes : NO : le moniteur n'envoie jamais d'instances suivies Sentinel ; ALL : pour chaque tape du processus de transfert, le moniteur envoie une instance suivie Sentinel ; SUMMARY : pour les tapes initiale et finale de chaque processus de transfert, le moniteur envoie une instance suivie Sentinel ; UNDEFINED : les options de suivi sont dfinies dans le paramtre TRK de la commande CFTPART.

Manuel de rfrence

Les paramtres de CFT

4-108

trkpart
CFTPARM [TRK = { UNDEFINED|ALL|NO|SUMMARY}] Valeur par dfaut qui spcifie les informations que CFT doit fournir Synchrony Sentinel propos des transferts avec un partenaire qui n'a pas de valeur trk dfinie. Slectionnez l'une des options suivantes : NO : le moniteur n'envoie jamais d'instances suivies Synchrony Sentinel. Valeur par dfaut ; ALL : pour chaque tape du processus de transfert, le moniteur envoie une instance suivie Synchrony Sentinel ; SUMMARY : pour les tapes initiale et finale de chaque processus de transfert, le moniteur envoie une instance suivie Synchrony Sentinel.

trkrecv
CFTPARM [TRKRECV = { UNDEFINED|ALL|NO|SUMMARY}] Spcifications concernant les transferts via CFTRECV pour lesquels la valeur trk n'est pas dfinie. Slectionnez l'une des options suivantes : NO (valeur par dfaut) : le moniteur n'envoie jamais d'instances suivies Sentinel ; ALL : pour chaque tape du processus de transfert, le moniteur envoie une instance suivie Synchrony Sentinel ; SUMMARY : pour les tapes initiale et finale de chaque processus de transfert, le moniteur envoie une instance suivie Synchrony Sentinel.

trksend
CFTPARM [TRKSEND = {UNDEFINED|ALL|NO|SUMMARY}] Spcifications concernant les transferts via CFTSEND pour lesquels la valeur trk n'est pas dfinie. Slectionnez l'une des options suivantes : NO (valeur par dfaut) : le moniteur n'envoie jamais d'instances suivies Synchrony Sentinel ; ALL : pour chaque tape du processus de transfert, le moniteur envoie une instance suivie Synchrony Sentinel ; SUMMARY : pour les tapes initiale et finale de chaque processus de transfert, le moniteur envoie une instance suivie Synchrony Sentinel.

updat
CFTCAT [UPDAT = {256|n}] {0..32767} Nombre de points de synchronisation entre deux mises jour conscutives du fichier catalogue pendant un transfert.

Manuel de rfrence

Les paramtres de CFT

4-109

UPDAT permet d'crire sur le disque le nombre d'enregistrements mis et acquitts pour un transfert donn. Par exemple : 0 signifie que le fichier catalogue n'est pas mis jour pendant le transfert ; 1 signifie que le fichier catalogue est mis jour chaque point de synchronisation. Remarque : pour certains systmes, l'augmentation de ce nombre de mises jour risque de provoquer une augmentation de la charge de l'UC et des E/S, et une dgradation des dbits de transfert.

user
CFTNET, TYPE = TCP, PROTOCOL = SOCKS4 USER = {string} {string 1...28} Nom d'utilisateur transmis dans la demande de connexion adresse au proxy. Ce paramtre est sensible la casse. Par dfaut, ce paramtre est dfini sur le nom d'utilisateur sous lequel CFT est excut.

userctrl
CFTPARM [USERCTRL = {NO|YES}] Utilisez ce champ pour dfinir l'option de contrle d'accs au fichier. Si elle est slectionne, le moniteur vrifie les droits d'accs de l'utilisateur sur le fichier transfrer. Sinon, le moniteur n'effectue aucune vrification. Windows : ce champ n'est pas pris en charge. CFTPARM USERCTRL - Systmes d'exploitation pris en charge
Systme dexploitation GCOS7 GCOS8 GUARDIAN MVS Netware OS2 OS400 UNIX VM VMS VOS VSE Win95 WinNT USERCTRL NON NON NON OUI NON NON NON OUI OUI OUI NON NON NON NON

Manuel de rfrence

Les paramtres de CFT

4-110

userid
CFTRECV, CFTSEND [USERID = {"CFT monitor userid"|string32}] Identifiant du propritaire du transfert. Ce paramtre est utilis en mode serveur pour dfinir le propritaire du transfert associ un objet CFTRECV ou un objet CFTSEND IMPL = YES. Si ce paramtre n'est pas dfini, sa valeur par dfaut est l'identifiant utilisateur (userid) du moniteur CFT serveur. Ce champ peut inclure une ou plusieurs des variables symboliques suivantes : &PART : valeur remplace par l'identifiant local du partenaire de transfert (CFTPART id) ; &SUSER : valeur remplace par le paramtre SUSER envoy entre deux moniteurs CFT (protocoles PeSIT D profil CFT et PeSIT E) ; &RUSER : valeur remplace par le paramtre ruser envoy entre deux moniteurs CFT (protocoles PeSIT D profil CFT et PeSIT E). Remarque : si une commande SEND ou RECV est utilise pour le transfert, l'identifiant du propritaire du transfert est l'identifiant de l'utilisateur (userid) qui a activ la commande. CFTAPPL, CLEARCMD USERID = {string}

value
UCONFSET VALUE =STRING 512

verify
LISTCOM [VERIFY = {YES|NO}] Requte de vrification de la validit de chaque enregistrement dans le fichier au moment o il est list ou affich. CFTX25, CFTTCP [VERIFY = {0|n}] Option pour vrifier le numro du partenaire (DIALNO) sur une requte de connexion entrante (les n premiers chiffres du numro de l'appelant sont contrls). Si VERIFY = 0, aucune vrification n'est effectue. CFTSSL [VERIFY = {REQUIRED|OPTIONAL}]

Manuel de rfrence

Les paramtres de CFT

4-111

waitresp
CFTPARM [WAITRESP = {1...32767}] Temporisation, en secondes, pour la communication interne entre les tches du moniteur : 100 : valeur par dfaut pour UNIX ; 60 : valeur par dfaut pour MVS et Windows ; n'importe quelle autre valeur comprise entre 1 et 32767. Ce paramtre est utilis pour un change synchrone de requtes entre deux tches du moniteur pendant la phase d'initialisation. Aprs waitresp secondes sans rponse, la temporisation est interrompue. Un message CFTS09 est crit dans le journal et l'initialisation du moniteur CFT s'arrte. Pendant la phase d'initialisation, ce paramtre vrifie le dlai autoris pour le dmarrage de chacune des tches du moniteur CFT. Au cas o la valeur est insuffisante (cas d'un ordinateur avec une charge leve).

waittask
CFTPARM [WAITTASK = {1441|n}] 1 : minimum autoris ; 1441 : valeur par dfaut, qui rend la tche permanente ; toute autre valeur comprise entre 1 et 1441 (au-dessus de cette valeur, la tche est arrte). MVS : la valeur recommande est waittask=1. Les tches non utilises sont alors limines le plus vite possible. Windows : la valeur recommande est 1441. CFTEXIT [WAITTASK = {1441|n}] {1..1441} Dlai d'inactivit (en minutes) de la tche EXIT. Au-del de cette valeur, cette tche est dsactive, c'est--dire dcharge de la mmoire. La tche est permanente si cette valeur est gale 1441. Ce paramtre ne s'applique qu'aux tches EXIT. {1...1441} Dlai d'inactivit, en minutes, de la tche d'accs au fichier :

wfname
CFTRECV, RECV [WFNAME = filename] {STRING512} OS MVS {String 248} Paramtre VMS non applicable Nom du fichier temporaire utilis pendant le transfert. Le fichier est renomm l'issue du transfert avec le nom dfini par le paramtre FNAME.

Manuel de rfrence

Les paramtres de CFT

4-112

Lorsque la valeur du paramtre est entre guillemets, elle devient sensible la casse. Un fichier temporaire est utilis pour assurer l'intgrit du fichier reu : le fichier qui peut tre utilis (par une application utilisateur, par exemple) n'est disponible qu' la fin du transfert. Le nom de ce fichier peut inclure les variables symboliques suivantes : &FDATE, &FTIME, &FYEAR, &FMONTH, &FDAY &SPART, &RPART, &PART, &NPART, &GROUP &SUSER, &RUSER &SAPPL, &RAPPL &IDF, &PARM, &IDA &NIDF, &NFNAME, &IDT &BDATE, &BTIME, &BYEAR, &BMONTH, &BDAY Le caractre & utilis ici remplace le caractre char_symb spcifique chaque systme d'exploitation. Reportez-vous au Guide d'exploitation CFT qui correspond votre systme d'exploitation. L'utilisateur doit s'assurer que le nom attribu est unique et qu'il n'existe aucun problme de conflit d'accs. Ce paramtre peut tre utilis pour la commutation (Store and Forward) (commande CFTRECV ID = COMMUT). Ce paramtre est obligatoire si le fichier rcepteur est un fichier de version (notamment pour le fonctionnement en mode ouvert et MVS, VMS lorsque l'metteur envoie un NFNAME correspondant un nom GDG). Ce paramtre est obligatoire lorsqu'une opration de copie/concatnation est excute pendant l'mission, le transfert d'un groupe de fichiers en mode PeSIT CFT/CFT. CFTSEND, SEND [WFNAME = filename] {STRING 512} MVS {String 248} Paramtre VMS non applicable Nom du fichier temporaire utilis pour mettre un groupe de fichiers slectionns en fonction du nom gnrique spcifi dans FNAME. Ce fichier est utilis uniquement lorsqu'un traitement supplmentaire est requis sur la machine cible. Une fois mis, il est supprim. Exemple : MVS - procdure IEBCOPY pour fichiers partitionns (PDS) Pour plus d'informations sur le fichier et sa structure, reportez-vous au Guide d'exploitation spcifique votre systme d'exploitation. Les fichiers envoyer sont slectionns en fonction du nom spcifi dans le paramtre FNAME. Le fichier temporaire contient alors les donnes envoyer. Le fichier est transfr de la mme manire qu'un fichier squentiel. Cette procdure ne peut tre utilise que pour : des transferts entre des systmes du mme type (mme valeur du paramtre SYST dans la commande CFTPART) ; le protocole suivant : PeSIT CFT CFT. OS

Manuel de rfrence

Les paramtres de CFT

4-113

Les variables suivantes peuvent tre utilises pour former la chane de caractres WFNAME : &FDATE, &FTIME, &FYEAR, &FMONTH, &FDAY &SPART, &RPART, &PART, &NPART, &GROUP &SUSER, &RUSER &SAPPL, &RAPPL &IDF, &PARM, &IDA &NIDF, &NFNAME, &IDT &BDATE, &BTIME, &BYEAR, &BMONTH, &BDAY Le caractre & utilis ici remplace le caractre char_symb spcifique chaque systme d'exploitation. Reportez-vous au Guide d'exploitation de Transfert CFT qui correspond votre systme d'exploitation. Pour viter les problmes de conflit d'accs, assurez-vous que le nom attribu est unique.

wscan
CFTCOM [WSCAN = {60|n}] {1..3600} Entrez la frquence (en secondes) laquelle le moniteur analyse le fichier de communication : 60 (valeur par dfaut) ; toute autre valeur. CFTCAT [WSCAN = {5|n}] {1.0,60} Si SHARE = YES : dure (en minutes) contrlant la priodicit de l'analyse du fichier catalogue. Dtermine l'heure spcifique laquelle un transfert est lanc (ou relanc) ; Si SHARE=NO : contrle indirectement le dlai entre deux tentatives de relancement d'un transfert.

xlate
CFTRECV, RECV, CFTPART, SEND, CFTSEND [XLATE = identifier] Identifiant de l'objet CFTXLATE dfinissant la table de transcodage utilise pour les transferts.

Manuel de rfrence

Les paramtres de CFT

4-114

5 Les objets CFT

Ce chapitre dcrit la mthode pour dfinir et modifier les objets de configuration de CFT en utilisant l'interface utilisateur graphique : configuration du moniteur CFT local ; objets de la configuration initiale de CFT ; objets de la configuration actuelle de l'interface GUI.

5.1 A propos de la configuration du moniteur CFT distant


Pour le dmarrage initial de CFT, vous devez dfinir chacun des fichiers de configuration initiale avant de pouvoir effectuer un transfert. Cette configuration pourra ensuite tre modifie ou complte en utilisant l'interface de ligne de commande ou l'interface GUI. Vous pouvez configurer dynamiquement CFT partir de l'une ou l'autre des interfaces utilisateur pendant que le produit est en cours d'excution. Vous pouvez utiliser des commandes telles que CFTSEND, CFTRECV, CFTAUTH, CFTIDF, et CFTLATE pour configurer et surveiller les transferts de fichiers.

5.2 Configuration du moniteur CFT local


Cette section dcrit l'utilisation des objets de configuration initiale dans Copilot pour CFT. L'environnement initial dsigne les paramtres qui sont initialement dfinis pour CFT au dmarrage, et qui constituent le paramtrage standard de CFT. Cette rubrique prsente les icnes et commandes de la fentre principale de cette interface. L'environnement d'excution, c'est--dire la configuration initiale de CFT, regroupe les paramtres utiliss par CFT au dmarrage. Si vous modifiez ces paramtres, vous devez arrter et redmarrer le moniteur afin que celui-ci les prenne en compte. Si vous ne redmarrez pas CFT, un point d'exclamation rouge apparat aprs Configuration initiale situ dans le volet gauche, pour indiquer que les modifications ne sont pas mises jour. Il est noter que vous pouvez crer plusieurs configurations initiales. La configuration actuellement utilise (IDPARM0, par exemple) est classe d'aprs son ID, aprs le dossier Configuration initiale dans le gestionnaire d'objets (volet gauche) selon le format suivant : Configuration initiale : IDPARM0 Copilot vous permet d'diter d'autres configurations actuellement disponibles sur votre CFT.

Manuel de rfrence

Les objets CFT

5-1

5.3 Objets de configuration initiale de CFT


Copilot pour CFT permet de grer un moniteur distance dans un environnement de type Windows, en utilisant des commandes telles que CFTLOG, CFTCOM et CFTPARM pour configurer et surveiller les transferts de fichiers. Le moniteur dispose d'un ensemble d'outils, CFTSEND et CFTRECV, pour configurer les transferts de fichiers ainsi que pour consigner les vnements dans un ensemble de fichiers internes du journal et du catalogue. CFT fournit un ensemble d'objets spcifiques pour : l'environnement initial (Initial) ; l'environnement dynamique (Ongoing). Les onglets situs sous la barre d'outils dans la fentre Copilot pour Windows sont rpertoris ci-dessous. Les objets facultatifs, non configurs, apparaissent sous forme de noeuds oranges.

5.3.1

Icnes des objets de CFT


Icne Nom et description de la commande CFTACCNT L'objet CFTACCNT dfinit le mode d'enregistrement des donnes statistiques pour les transferts correctement termins. CFTCAT Un objet CFTCAT forme une partie de la dfinition du moniteur CFT. Il dcrit la mthode de gestion du catalogue : mode de consultation des fichiers, dure de conservation avant purge, etc. Le catalogue enregistre toutes les informations relatives aux requtes de transfert. CFTCOM L'objet CFTCOM forme une partie de la dfinition du moniteur CFT (onglet CFT Configuration). Il dfinit le mdia de communication entre les programmes d'utilisateurs et le moniteur CFT. CFTETB L'objet CFTETB est spcifique au protocole ETEBAC3. Il dcrit la carte de paramtrage associe au partenaire, le sens de transfert et le fichier type, en mission et en rception. CFTEXIT Un objet CFTEXIT dcrit l'environnement et l'activation d'une tche EXIT. Chaque objet CFTEXIT est associ une tche EXIT. CFTLOG Un objet CFTLOG forme une partie de la dfinition du moniteur CFT. Il dfinit les fichiers journaux du moniteur CFT. Le moniteur enregistre les vnements importants se produisant pendant un transfert, tels que : le dbut d'une session ; le dbut du transfert ; les points de redmarrage ; la fin du transfert ; la fermeture de la session ; les incidents.

Manuel de rfrence

Les objets CFT

5-2

Icne

Nom et description de la commande CFTNET L'objet CFTNET dfinit les ressources rseau. Il dfinit galement l'accs un rseau de tlcommunications ainsi que les ressources permettant d'accder ce rseau. Les paramtres dfinis dans cet objet varient selon la situation physique de la ressource (locale ou distante). CFTPARM L'objet CFTPARM forme une partie de la dfinition du moniteur CFT. Il vous permet de : spcifier les paramtres de commande globale des oprations du moniteur CFT ; slectionner les autres commandes de paramtrage qui doivent tre prises en compte pendant l'excution. Les paramtres qui dfinissent l'environnement CFT concernent en particulier : les constantes de dimensionnement ; les pointeurs de renvoi vers d'autres paramtres ; les actions de fin de transfert ; la clef d'activation du produit. CFTPROT L'objet CFTPROT permet de dfinir un protocole et de spcifier certains paramtres lis aux ressources rseau utilises pour un change protocolaire donn. CFTRECV L'objet CFTRECV dfinit : le nom et les caractristiques physiques locales du fichier recevoir ; les actions excuter localement pendant et aprs le transfert (transcodage, compression, appel d'un EXIT d'utilisateur, d'une procdure de fin de transfert, etc.) ; une plage temporelle autorise et l'utilisateur par dfaut associ aux transferts. CFTSEND L'objet CFTSEND dfinit : le nom et les caractristiques physiques locales du fichier envoyer ; les caractristiques rseau du fichier envoyer au partenaire ; les actions excuter localement pendant et aprs le transfert (transcodage, compression, appel d'un EXIT d'utilisateur, d'une procdure de fin de transfert, etc.) ; une plage temporelle autorise et l'utilisateur par dfaut associ aux transferts. CRONTABS slectionns La fonction CRONJOB de CFT Transfer vous permet de programmer l'excution de certains travaux des dates et heures prdtermines.

5.4 Objets de configuration actuelle de l'interface GUI


L'environnement de transfert de fichiers de CFT, c'est--dire la configuration actuelle, regroupe l'ensemble des paramtres et des fichiers utiliss par CFT. Vous pouvez modifier ces paramtres sans arrter CFT.

Manuel de rfrence

Les objets CFT

5-3

Le tableau suivant prsente les objets de configuration dynamique (Ongoing).


Icne Nom et fonction de la commande Liste d'autorisations L'objet CFTAUTH dfinit une liste d'identifiants de fichiers types pour chaque partenaire et chaque sens de transfert. Tous les identifiants de la liste ont les mmes droits ou restrictions de transfert. Carte ETEBAC3 L'objet CFTETB permet de crer, modifier ou supprimer le format de la carte de paramtrage utilise pour le transfert, en fonction des caractristiques de transfert. Liste de diffusion des partenaires L'objet CFTDEST dfinit une liste de partenaires pour des oprations de distribution/collecte. La liste des partenaires peut tre dcrite : explicitement en utilisant un paramtre de type liste ; en utilisant un fichier dans lequel la liste est enregistre. Identifiant de fichier rseau Un objet CFTIDF dfinit un identifiant de rseau pour un partenaire spcifique et un sens de transfert lorsque les partenaires ne peuvent pas s'accorder sur des identifiants de fichiers communs. CFTIDF est utilis pour tous les protocoles sauf PeSIT profil SIT. Partenaire L'objet CFTPART dfinit les caractristiques de chaque partenaire par rapport au rseau, aux protocoles, aux transferts et aux tats de transfert. Fichier modle de rception L'objet CFTRECV dfinit : le nom et les caractristiques physiques locales du fichier recevoir ; les actions excuter localement pendant et aprs le transfert (transcodage, compression, appel d'un EXIT utilisateur, d'une procdure de fin de transfert, etc.) ; une plage temporelle autorise et l'utilisateur par dfaut associ aux transferts. Fichier modle d'mission L'objet CFTSEND dfinit : le nom et les caractristiques physiques locales du fichier envoyer ; les caractristiques rseau du fichier envoyer au partenaire ; les actions excuter localement pendant et aprs le transfert (transcodage, compression, appel d'un EXIT utilisateur, d'une procdure de fin de transfert, etc.) ; une plage temporelle autorise et l'utilisateur par dfaut associ aux transferts. Fichier modle d'mission implicite Utilisez CFTISEND pour effectuer un transfert en utilisant le mcanisme d'mission implicite. Dans cet objet, CFTISEND est fix IMPLICIT= YES afin qu'il traite automatiquement les requtes de rception envoyes sans avertissement d'un partenaire distant (mode serveur exclusivement). Conversion de jeux de caractres Un objet CFTXLATE dfinit une table de transcodage utiliser entre deux ordinateurs qui utilisent diffrents jeux de caractres. Chaque table est cre en utilisant un fichier qui contient un seul enregistrement 256 caractres. Par sa position et sa valeur, chaque caractre contenu dans cet enregistrement dfinit la correspondance entre les deux jeux de caractres.

Manuel de rfrence

Les objets CFT

5-4

Icne

Nom et fonction de la commande CRONJOBS La fonction CRONJOB de CFT vous permet de programmer l'excution de certains travaux des dates et heures prdtermines.

Manuel de rfrence

Les objets CFT

5-5

6 Dfinition de lenvironnement du moniteur

6.1 Mode denregistrement des donnes statistiques - CFTACCNT


L'objet CFTACCNT dfinit le mode d'enregistrement des donnes statistiques sur les transferts correctement termins (c'est--dire l'tat T ou X). Vous pouvez supprimer l'objet CFTACCNT de la configuration de CFT. Dans ce cas, l'objet apparat en gris dans le gestionnaire d'objets (volet gauche de l'interface graphique). Deux modes d'enregistrement sont disponibles : l'enregistrement de donnes dans des fichiers CFT. Lorsque le fichier primaire est plein, le CFT bascule sur un fichier altern ; l'enregistrement de donnes dans les fichiers de l'utilitaire de statistiques du systme d'exploitation. En plus de l'objet CFTACCNT, vous devez dfinir le paramtre CFT ACCNT de l'objet CFTPARM afin que le mode statistiques fonctionne. Cette commande est prise en compte lorsque le paramtre ACCNT de la commande CFTPARM est dfini. CFT n'autorise qu'un seul identifiant pour le type CFTACCNT. Selon le systme, deux modes d'enregistrement peuvent tre utiliss : l'enregistrement de donnes dans des fichiers du moniteur CFT La commande CFTACCNT dfinit les noms des fichiers recevant les donnes et leur gestion TYPE = FILE. Ce mode est disponible sur TOUS LES SYSTMES ; l'enregistrement de donnes dans les fichiers de l'utilitaire statistiques du systme d'exploitation avec le paramtrage TYPE = SYST. Ce mode est uniquement disponible sur les systmes GCOS7, MVS, VM et VSE. Pour chaque transfert termin, le CFT enregistre les informations du tableau suivant. Liste des en-ttes CFTACCNT
En-ttes Mode de transfert (serveur ou demandeur) Sens du transfert Type de transfert (fichier, message ou message de rponse) Identifiant du partenaire (PART) Identifiant de l'metteur (SPART) Identifiant du rcepteur (RPART) Identifiant de l'application utilisateur mettrice (SUSER) Identifiant de l'application utilisateur rceptrice (RUSER) Dcalage 0 1 2 3 12 21 30 46

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-1

En-ttes Identifiant de fichier type (IDF) Identifiant d'application locale (IDA) Identifiant de transfert (IDT) Nombre d'enregistrements envoys Nombre de caractres du fichier Nombre de caractres envoys sur la ligne Date et heure de saisie de la commande dans le catalogue Date et heure de dbut du transfert Date et heure de fin du transfert Dure du transfert (en secondes) Indicateur de liste de diffusion Identifiant de protocole applicatif Identifiant du propritaire du transfert (USERID) Identifiant du groupe (GROUPID) Taux de compression des donnes en mode ligne Taille maximale d'enregistrement du fichier (FLRECL) Format de fichier (FRECFM) Code de compression protocolaire (NCOMP) Nom du fichier envoy (FNAME) Paramtre priv de CFT (PARM) Identifiant de l'application mettrice (SAPPL) Identifiant de l'application rceptrice (RAPPL) Groupe du partenaire (GROUP) Total

Dcalage 62 71 80 89 100 111 122 140 158 176 183 184 193 209 225 228 234 235 238 303 384 433 482 491

6.1.1

Mode d'enregistrement TYPE


Cette section dcrit les paramtres dfinir pour dclarer le type de mode d'enregistrement. Comme dcrit prcdemment, vous pouvez choisir de sauvegarder les informations enregistres dans un fichier ou sur le systme. Le paramtre TYPE vous permet de dclarer la destination de sauvegarde des informations de transfert.

6.1.1.1 Enregistrement dans un fichier (TYPE = FILE) Si vous fixez le paramtre Type File dans l'objet CFTACCNT, vous devez dfinir les paramtres suivants : afname exec fname maxrec switch Le fichier statistique de CFT est plein lorsque le nombre maximal d'enregistrements (paramtre MAXREC) a t atteint. CFT bascule alors sur un fichier altern et excute la procdure dfinie par le paramtre EXEC.

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-2

La commande SWITCH vous permet galement de basculer manuellement sur le fichier statistiques lorsque vous le souhaitez. Au moment de l'activation de CFT, il doit exister au moins 1 fichier statistiques vide. Si le premier fichier dsign par FNAME n'est pas vide, CFT bascule sur le second fichier AFNAME. La procdure associe cette bascule peut de nouveau gnrer un fichier vide. Avant l'activation de CFT, les fichiers statistiques doivent tre crs avec la commande CFTFILE TYPE = ACCNT. Lorsque vous arrtez CFT avec la commande SHUT, la procdure de bascule est galement excute afin de vider le dernier fichier statistiques en cours de traitement. 6.1.1.2 Enregistrement sur le systme (TYPE = SYST) Si vous fixez le paramtre Type SYST dans l'objet CFTACCNT, vous devez galement dfinir le paramtre ACCID. La commande CFTACCNT se rfre l'application CFT par le biais de l'utilitaire. GCOS7, MVS, VM VM Le paramtre ACCID qui identifie l'application CFT doit tre dfini. L'enregistrement statistiques est scind en 8 cartes ACCOUNT. Les donnes sont de type USER dans le compte CFT. Etant donn la structure des enregistrements du systme statistique de VMS, les donnes statistiques sont tronques 255 caractres. Il est donc dconseill d'utiliser TYPE = SYST pour VMS.

VMS

6.2 Attributs du catalogue


Le catalogue affiche la liste de tous les transferts CFT. Le fichier catalogue contient les donnes de contrle associes aux transferts. Pour chaque transfert, il existe un enregistrement qui correspond un indicateur d'tat. Chaque jour, des enregistrements sont stocks dans le catalogue. Le catalogue peut tre paramtr pour supprimer les enregistrements qui dpassent une certaine limite, ou pour purger son contenu un moment pr-dfini. L'opration de purge peut tre dclenche minuit (valeur par dfaut) ou une heure spcifique. Le catalogue est purg par lots de 10 postes. Entre chaque lot, le moniteur traite tous les vnements de transfert en cours. Par consquent, si l'activit de transfert est intense, la purge du catalogue peut tre tendue mais elle n'a pas d'impact considrable sur les transferts. Les fonctions du catalogue peuvent galement inclure une mthode pour rcuprer des informations sur le moniteur qui utilise le catalogue. Pour chaque paramtre PARM, il existe une commande CFTCAT associe.

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-3

6.2.1

Fonctions du catalogue de l'interface graphique


Le catalogue de l'interface graphique affiche la liste de tous les transferts CFT et offre les fonctions supplmentaires suivantes : Personnalisation du catalogue CFT et des filtres de journaux pour rpertorier et afficher les transferts en fonction de proprits spcifiques Comparaison des transferts Enregistrement des informations de transfert dans un fichier Rafrachissement immdiat en cliquant avec le bouton droit sur le dossier Monitoring (volet gauche) pour rafrachir le journal et le catalogue Codification des transferts par couleur afin de distinguer les diffrents tats Slection dans la liste de filtres pr-dfinis Clonage des transferts Affichage de diagnostics Affichage de tous les dtails du transfert Edition des paramtres CFTIDF, XLATE et PROT

6.3 Mdias de communication - CFTCOM


Dans toute cette section, vous devrez vous reporter au Guide d'exploitation de CFT qui correspond votre systme d'exploitation afin d'obtenir des dtails spcifiques votre systme. L'objet CFTCOM dfinit les mdias de communication qui sont utiliss par CFT. Vous pouvez dfinir autant d'objets CFTCOM que ncessaire. Selon le systme, vous pouvez configurer en tant que mdia de communication : un ou plusieurs fichiers partags : les requtes sont consultes dans le fichier qui est priodiquement examin par le moniteur ; une bote aux lettres ; un mdia de communication synchrone pris en charge par le rseau TCP/IP. MVS : Si ncessaire, vous devez dfinir un fichier de communication pour les applications BATCH/TSO et un autre pour les applications CICS. WinNT : dans une configuration autonome, la mthode de communication recommande est la bote aux lettres. Sur un LAN, les requtes d'applications Windows concernant un moniteur qui n'est pas sur le mme ordinateur peuvent uniquement tre faites par le biais d'un fichier. L'objet CFTCOM permet CFT d'ouvrir le mdia communiquant avec les applications. Selon le systme, il est possible d'utiliser un ou plusieurs des mdias suivants : un ou plusieurs fichiers partags (paramtrage TYPE = FILE) Les requtes sont saisies dans ce(s) fichier(s) qui est(sont) priodiquement parcouru(s) par le moniteur. Pour le dpt des requtes, la prsence du moniteur n'est pas requise, sauf si ces requtes saturent le fichier. Une commande CFTCOM dfinit alors un fichier de communication et la frquence laquelle celui-ci est lu par le moniteur ; une bote aux lettres CFT (paramtrage TYPE = MBX) La commande CFTCOM permet au moniteur de se connecter une bote aux lettres

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-4

dfinie par son nom logique ; un mdia de communication synchrone pris en charge par le rseau TCP/IP (paramtre TYPE= TCPIP). La dclaration du mdia de communication utilis par un programme applicatif demandeur doit tre compatible avec le mdia ouvert par le moniteur : commande CONFIG TYPE = COM, ... de l'utilitaire CFTUTIL ; fonction COM des interfaces de programmation ; option 7 (caractristique du moniteur). Il est ncessaire de dfinir un fichier de communication pour les applications BATCH/TSO et un autre pour les applications CICS (si requis). Dans une configuration d'exploitation "autonome", les requtes des applications Windows 3 CFT concernent le moniteur et, dans ce cas, la mthode de communication recommande est la bote aux lettres. Dans une configuration LAN, les requtes des applications Windows concernent un CFT qui n'est pas sur le mme ordinateur. Dans ce cas, seul un fichier peut servir de mdia de communication.

MVS, VSE

WinNT

6.3.1

Mdias des fichiers de service de CFT


Un mdia CFT dsigne un support de donnes quelconque ou un moyen de communication local utilis par CFT. On distingue les mdias : auxquels accde CFT ; auxquels accde l'utilitaire CFT ; utiliss par les fonctions interactives ; utiliss par l'interface de programmation.

6.3.1.1 Dfinitions Les termes suivants sont utiliss dans CFT : un FICHIER PHYSIQUE dcrit le nom et l'emplacement physique d'un mdia de type fichier ; si le nom du fichier commence par un caractre rserv, dsign par char-file - , il s'agit d'un nom logique interprt par CFT ; une BOITE AUX LETTRES dsigne un support de communication inter-tche (qui n'est pas un fichier) non limit des tches CFT seules. Ce concept s'applique uniquement certains systmes ; CFTIN et CFTOUT dsigne une entre/sortie de tche standard ; un mdia synchrone TCP dsigne un canal de communication. Les noms du mdia CFT peuvent tre configurs pour les lments suivants : interface de programmation (nom de catalogue, nom du moyen de communication avec CFT) : par les services OPEN et COM ; CFT : objets CFTPARM, CFTCOM, CFTCAT, CFTLOG et CFTACCNT (le nom du fichier de paramtrage ne peut pas tre chang) ; utilitaire CFT : commande CONFIG ; fonctions interactives : la fonction de personnalisation est utilise pour dfinir les

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-5

noms du fichier de paramtrage, du fichier de partenaires, du fichier catalogue et des fichiers journaux, ainsi que le mdia de communication CFT. 6.3.1.2 Mdias CFT Le nom du fichier de paramtrage ne peut pas tre chang. Ce nom est le point d'ancrage contenant toutes les donnes dfinies par le paramtrage, et en particulier les noms des autres fichiers et mdias. Cependant, vous pouvez tablir une correspondance entre ce nom logique et un nom physique dans le flux de commandes d'activation du moniteur. Les noms des autres mdias CFT sont dfinis par paramtrage, bien que des valeurs par dfaut soient dfinies pour CFT. Mdias CFT par type d'objet et de paramtre
Objet CFTCAT CFTCOM CFTLOG CFTACCNT CFTPARM CFTXLATE CFTDEST CFTAUTH CFTPARM CFTLOG CFTACCNT Paramtre FNAME FNAME FNAME AFNAME FNAME AFNAME PARTFNAM FNAME FNAME FNAME EXEC ... EXEC EXEC Type de fichier dcrit Fichier catalogue Mdia de communication Fichiers journaux Fichiers statistiques Fichier de partenaires Fichier contenant la description d'une table de transcodage Fichier contenant une liste de partenaires Fichier contenant une liste d'IDF autoriss ou interdits Procdures de fin de transfert Procdure de bascule entre les journaux Procdure de bascule entre les fichiers statistiques

Selon le systme, CFT prend en charge les mdias de communication suivants : fichier d'organisation directe (relatif) ; bote aux lettres ; mdia synchrone TCP. Pour un mdia de communication bas sur TCP/IP : nom d'hte ; nom du fichier de configuration. 6.3.1.3 Mdias de l'utilitaire : CFTUTIL Utilisez la commande CONFIG de l'utilitaire CFTUTIL pour dfinir les noms des mdias de communication, en vous reportant au tableau ci-dessous :
Paramtre TYPE de la commande CONFIG PARM PART CAT COM INPUT OUTPUT Type de fichier dcrit Fichier de paramtrage Fichier de partenaires Fichier catalogue Mdia de communication Mdia d'entre de donnes Mdia de sortie de donnes

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-6

Par dfaut, en l'absence de la commande CONFIG, les mdias auxquels l'utilitaire peut accder sont dfinis dans le Guide d'exploitation de CFT appropri. Selon le systme d'exploitation, les noms de mdias peuvent tre des fichiers physiques ou des fichiers logiques. Selon le systme, l'utilitaire CFTUTIL prend en charge les mdias de communication suivants : fichier d'organisation directe (relatif) ; bote aux lettres ; mdia synchrone TCP. Pour un mdia de communication bas sur TCP/IP : nom d'hte ; nom du fichier de configuration. 6.3.1.4 Mdias d'interface de programmation L'interface de programmation fournit les services suivants : accs au catalogue des transferts ; transmission des commandes CFT. Les tableaux suivants rpertorient les noms de mdias par service, pour les applications en Cobol et en langage C. Nom de mdias par service dans l'interface en langage COBOL
Service CFTI CFTU Commande OPEN COM Paramtre D-CAT D-COM Type de fichier dcrit Fichier catalogue Mdia de communication CFT

Noms de mdias par service dans l'interface en langage C


Service cftai cftaix cftau Commande OPEN OPEN COM Paramtre cat cat param Type de fichier dcrit Fichier catalogue Fichier catalogue Mdia de communication CFT

Les noms par dfaut des mdias auxquels accde l'interface de programmation, le fichier CATALOGUE et le mdia de COMMUNICATION sont dfinis dans le Guide d'exploitation de CFT correspondant votre systme d'exploitation. Selon le systme, l'interface de programmation prend en charge les mdias de communication suivants : fichier d'organisation directe ; bote aux lettres (nom par dfaut : MBXCFT) ; mdia synchrone TCP. Dans le cas d'un mdia de communication bas sur TCP/IP : nom d'hte ; nom du fichier de configuration.

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-7

6.3.1.5 Mdias de fonctions interactives Les mdias de fonctions interactives sont dfinis par la fonction de personnalisation de ce composant. Le tableau suivant indique, pour chaque champ, le type de fichier dcrit.
Champ Parm Part Cat Log1 Log2 Com Mdia de communication du moniteur Type de fichier dcrit Fichier de paramtrage Fichier de partenaires Fichiers catalogue Fichiers journaux

Si cette fonction n'est pas active, les mdias accessibles sont ceux dfinis lors de l'installation du produit. Selon le systme, les fonctions interactives prennent en charge les mdias de communication suivants : fichier d'organisation directe ; bote aux lettres (nom par dfaut : MBXCFT) ; mdia synchrone TCP. Pour un mdia de communication bas sur TCP/IP : nom d'hte ; nom du fichier de configuration. 6.3.1.6 Caractristiques des mdias de communication Pour la communication par fichier : le moniteur CFT peut tre inactif au moment o les commandes qui lui sont affectes sont mises, dans les limites de taille de fichier. Les commandes sont prises en compte au moment o le moniteur est activ, si une commande CFTCOM se rapportant ce fichier de communication a t dfinie. Un fichier de communication peut tre cr par la commande CFTFILE ; pour la communication par bote aux lettres : GCOS7, VOS, GCOS8 : La communication n'est possible que si le moniteur est prsent. MVS : Ces communications permettent de soumettre toutes les commandes CFT, mme si ce dernier est absent. VMS : La communication n'est possible que si le moniteur est prsent. Ce mcanisme permet aux utilisateurs d'un groupe autre que le groupe CFT de soumettre des commandes CFT ; pour les mdias synchrones TCP : la communication n'est possible que si CFT est prsent. Pour rcuprer les valeurs IDT et IDTU du transfert, vous pouvez utiliser les variables %_CAT_IDT% et %_CAT_IDTU%. Exemple : SEND PART = PART1 IDF = TEST1

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-8

puis LISTCAT IDT = %_CAT_IDT%

6.4 Carte ETEBAC3 - CFTETB


L'objet CFTETB doit tre dfini si le paramtrage de CFT contient un objet CFTPROT de type ETEBAC3. L'objet ETEBAC permet de crer, de modifier ou de supprimer le format de la carte de paramtrage utilise pour le transfert, en fonction des caractristiques du transfert (identification des partenaires, etc.). En ETEBAC3, une carte de paramtrage est change entre les partenaires au moment o la connexion est tablie. Les partenaires peuvent ainsi s'accorder sur le format des donnes changes.

6.4.1

Caractristiques du transfert ETEBAC


En mode demandeur, l'objet CFTETB peut dsigner : un partenaire qui est dfini par CFTPART ; un identifiant de fichier type qui est dfini dans la commande de transfert CFTSEND/SEND or CFTRECV/RECV correspondante. Cette rgle s'applique aux transferts en mission (DIRECT = SEND) et en rception (DIRECT = RECV). Dans ce mode, les commandes gnriques CFTETB ID = ALL, o ALL dsigne "tous les partenaires", sont galement utilises. En mode serveur, seules les commandes gnriques CFTETB ID=ALL sont prises en compte, par exemple : CFTETB ID = ALL, DIRECT = SEND, ... et/ou CFTETB ID=ALL, DIRECT = RECV, ... pour dcrire la carte gnrique pour les transferts en mission ; pour dcrire la carte gnrique pour les transferts en rception.

Dans les deux modes, vous devez spcifier au moins ces deux commandes pour dcrire une carte gnrique utilise pour les transferts en mission, et une autre pour les transferts en rception : CFTETB ID = ALL, DIRECT = SEND, . . . CFTETB ID = ALL, DIRECT = RECV, . . .

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-9

6.4.2

Format des cartes de paramtrage


Une carte de paramtrage a une longueur totale de 80 caractres au format EBCDIC. Son en-tte est impose par le standard ETEBAC3 et comporte : en premire position (numrote 0) : un octet indiquant le sens du transfert ; trois octets rservs ; en cinquime position (numrote 4) : quatre octets indiquant la longueur d'enregistrement du fichier envoyer. Le contenu des autres champs n'est soumis aucune obligation. Il est dfini par convention entre les partenaires. Les valeurs des paramtres de la commande CFTETB dcrivant le format de la carte de paramtrage sont indiques ci-dessous sous la forme : parameter = {pos, 255 | len} or parameter = {pos, 255 | len | content} o : pos : dfinit la position dans la carte de paramtrage du champ dcrit par ce paramtre. La valeur de "pos" est le nombre de caractres qui prcdent ce champ dans la carte de paramtrage et elle est positive ; len : dfinit la longueur sous forme de nombre de caractres dans ce champ. La valeur 255 (valeur par dfaut) indique que le paramtre concern est absent de la carte de paramtrage. Comme la longueur totale de la carte de paramtrage est de 80 caractres et que 8 caractres sont obligatoires dans l'en-tte, la somme des longueurs des champs "long" des paramtres facultatifs utiliss ne peut pas dpasser 60 caractres dans le protocole ETEBAC3. Si le nombre de caractres affects un champ est infrieur au nombre indiqu dans le champ long, ce champ est complt par des caractres blancs EBCDIC (x40). Dans la cinquime position de la carte, CFT peut ne pas indiquer de longueur d'enregistrement ou peut indiquer une longueur d'enregistrement suprieure 4 octets. Cette possibilit n'est pas offerte par le protocole ETEBAC3, mais peut tre utilise par les partenaires qui ont adopt une convention ; content : dfinit le contenu du champ sous la forme de chanes de caractres arbitraires changes entre les partenaires mais non traites par CFT.

6.4.3

Dfinition des paramtres ETEBAC3 actuels


L'objet ETEBAC permet de dcrire le protocole de transfert ETEBAC3. La carte de paramtrage est envoye lorsque la connexion est tablie, et est accepte et/ou refuse. Vous pouvez utiliser l'objet CFTETB de manire dynamique pour dfinir la position, la longueur et le contenu de la carte de paramtrage. Utilisez la fentre Ongoing CFTETB (dans l'interface utilisateur graphique) ou l'interface en mode ligne de commande pour dfinir un nouveau paramtrage de carte ETEBAC pour un transfert en mission ou en rception.

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-10

6.4.3.1 Dfinition des objets SEND et RECV de ETEBAC3 La carte de paramtrage est envoye lorsque la connexion est tablie, et est accepte et/ou refuse. Dfinissez la carte ETEBAC par dfaut dans l'objet CFTETB Recv. Remarque : Certains objets par dfaut ne peuvent pas tre supprims (y compris CFTETB). Ces objets par dfaut, CFTSEND, CFTRECV et CFTET, ne peuvent pas tre supprims s'ils sont utiliss par une autre configuration.

6.5 Tches exit - CFTEXIT


Un objet CFTEXIT dcrit l'environnement et l'activation d'une tche exit. Chaque objet CFTEXIT est associ une tche exit. Vous pouvez dfinir autant d'objets CFTEXIT que ncessaire. Il existe une tche EXIT pour chaque objet CFTEXIT : exit de type fichier : la fonction est excute diffrentes tapes de transfert d'un fichier ; exit de type ETEBAC3 : lorsque le protocole ETEBAC3 est utilis, la fonction est excute au dbut du transfert ; exit de type annuaire : la fonction est excute pendant la phase de connexion protocolaire ; exit de type fin de fichier : la fonction est excute la fin d'un transfert. Le nombre maximal de tches EXIT simultanment actives dpend du systme d'exploitation. MVS Windows UNIX : 99 : 128 : 15

6.6 Paramtrage des journaux - CFTLOG


Un objet CFTLOG dfinit les dclarations des fichiers journaux du moniteur. CFT enregistre les vnements importants se produisant pendant un transfert, tels que : le dbut d'une session ; le dbut du transfert ; les points de redmarrage ; la fin du transfert ; la fermeture de la session ; les incidents. CFT utilise un fichier primaire et un fichier altern. La bascule entre ces fichiers est effectue dans l'un des trois cas suivants : lorsque le fichier actuel est plein, lorsque le nombre d'enregistrements dpasse la limite fixe dans l'objet, ou au moment indiqu dans le champ de bascule. CFT excute alors la procdure dfinie dans le champ exec.

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-11

L'objet CFTLOG peut tre dfinitivement supprim de la configuration. Une fois que l'objet CFTLOG est dsactiv, il apparat en gris dans la structure arborescente affiche dans le volet gauche, ainsi que tous les filtres de journaux. Pour plus d'informations, reportez-vous Suppression de l'objet CFTLOG. Pour un paramtre PARM donn, il existe un objet CFTLOG associ ce paramtre. La valeur du paramtre LOG de la commande CFTPARM doit correspondre la valeur du paramtre ID pour cette commande.

6.6.1

Enregistrement des dtails du transfert


Lorsqu'un transfert a lieu, un message dcrivant cet vnement est cr et il est : consign dans un journal ; envoy un oprateur ou vous-mme, selon le systme. Le numro du message envoy cet oprateur est dfini par le paramtre OPERMSG de l'objet CFTLOG. Vous pouvez galement rediriger les messages de transfert vers la console d'un autre utilisateur en dclarant les lments suivants dans l'objet CFTSEND : le nom d'utilisateur dans le paramtre NOTIFY ; la catgorie des messages rediriger dans le paramtre USERMSG. Lorsque vous activez l'objet CFTLOG, CFT enregistre les messages d'vnements de transfert dans le fichier journal (LOG). CFT ferme ce fichier dans les cas suivants : CFT est arrt par la commande SHUT ; le nombre maximal d'enregistrements (MAXREC) est atteint ; une commande SWITCH dfinie dans l'objet CFTLOG est envoye. Le cas chant, les messages d'vnements de transfert sont consigns dans un fichier altern (ALOG). A l'heure programme ou lors de la prochaine action programme, le fichier ALOG est ferm et CFT recommence enregistrer dans le fichier LOG. Le fichier LOG doit tre vide pour que CFT recommence enregistrer dans ce fichier.

6.6.2

Bascule entre les fichiers journaux


CFT peut basculer sur un autre fichier au moyen de l'un des 5 vnements suivants : l'ordonnancement quotidien dfini par le paramtre SWITCH ; la commande SWITCH TYPE=LOG ; le nombre d'enregistrements consigns dans le fichier journal actuel dpasse la limite fixe par le paramtre MAXREC ou, selon les possibilits du systme d'exploitation, le fichier est plein ; CFT est arrt par la commande SHUT ; CFT est activ. CFT ne peut pas ouvrir un fichier journal qui n'est pas vide au dmarrage. Si le fichier n'est pas vide, CFT tente automatiquement de basculer sur le fichier journal altern. Il est important que la procdure associe la bascule rgnre un fichier vide aprs le traitement du fichier journal. La bascule entrane l'excution de la procdure dcrite par le paramtre EXEC de cette commande. Cette procdure consiste gnralement enregistrer un fichier, crer un nouveau fichier vide portant le mme nom et imprimer le fichier enregistr si ncessaire.

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-12

Les fichiers journaux doivent tre crs par des oprations avant que CFT soit activ (commande CFTFILE TYPE = LOG).

6.7 Ressources rseau - CFTNET


6.7.1

Qu'est-ce qu'une ressource rseau locale ?


L'objet de dfinition des ressources locales dans l'interface GUI correspond l'objet CFTNET dans les oprations en mode ligne de commande. L'objet CFTNET : dfinit une ressource rseau qui, pour CFT, est une entit permettant d'tablir des connexions ; transmet CFT un ensemble d'informations requises pour accder au rseau du type indiqu (X25, SNA, TCP/IP, etc.) par le biais d'une ressource. Cet objet inclut : des paramtres utiliss pour grer les fonctions internes du moniteur CFT (contrle des mcanismes pour tablir des connexions, par exemple) ; des paramtres dcrivant les caractristiques de l'environnement rseau dfinies par le systme d'exploitation local ; des paramtres utiliss pour tablir des connexions entre :
o

des paramtres systme qui peuvent se rfrer un ou plusieurs composants logiciels du systme (pilotes utiliss au niveau des cartes, par exemple) ; le moniteur CFT.

Lorsque, pour un systme ou un type de rseau donn, la description de l'environnement s'avre trop complexe ou trop spcifique, il est recommand de regrouper les paramtres correspondants dans un fichier de configuration spar (ou programme d'initialisation) qui est ensuite rfrenc par l'objet CFTNET. Certains des paramtres dcrits ci-dessous ne sont soumis aucune restriction d'utilisation, alors que d'autres sont uniquement utiliss par un systme et/ou une mthode d'accs au rseau spcifique. Les paramtres dont la signification est commune tous les rseaux sont dcrits au paragraphe Commande gnrique CFTNET. Les paramtres spcifiques, regroups par type de rseau, sont ensuite dcrits dans la rubrique CFTNET TYPE = xxx. Le paramtre TYPE peut prendre l'une des valeurs xxx suivantes : DNA (DECnet) ; SNA ; TCP/IP ; X.25 ; LU62. Remarque : dans certains environnements, le contrle du nombre maximal d'objets CFTNET, qui est effectu pendant la phase de mise jour des paramtres, peut diffrer du contrle effectu pendant l'excution de CFT. Lorsque CFT dtecte un nombre d'objets CFTNET excessif, le message suivant apparat : CFTP16F CFTNET id for CFTPARM id_Not loading in memory

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-13

6.7.2

Comment fonctionne l'objet CFTNET ?


CFTNET est la dclaration qui permet de dfinir les ressources rseau locales de CFT. CFTNET transmet galement CFT les informations requises pour accder au rseau requis pour le type indiqu. Les objets CFTNET dfinissent les paramtres rseau pour les partenaires appartenant un groupe spcifique. Ces informations incluent : l'emplacement du moniteur partenaire dans le rseau ; les plages temporelles pour les appels effectus sur le rseau ; les mcanismes de tentative de reconnexion ; le nombre maximal de connexions avec chaque partenaire.

6.8 Protocoles de transfert CFTPROT


Pour que des ordinateurs transfrent des fichiers, il est ncessaire de dfinir un ensemble de rgles. L'objet CFTPROT dfinit ces rgles de transfert, ou des protocoles de transfert de fichiers. Les protocoles de transfert incluent : PeSIT ; Odette ; ETEBAC3.

6.8.1

Qu'est-ce-que l'objet CFTPROT ?


L'objet CFTPROT dfinit des valeurs pour effectuer un transfert avec un partenaire possible. Le protocole de transfert (PeSIT, Odette ou ETEBAC3) et le protocole d'change de donnes (DNA, LU6.2, SNA, TCP/IP ou X.25) que vous utilisez doivent tre pris en charge par le moniteur local et par le moniteur du partenaire concern. Utilisez l'objet CFTPROT pour : choisir un protocole (PeSIT, ODETTE ou ETEBAC3) et une mthode d'utilisation de ce protocole (avec ou sans compression, avec ou sans possibilit de reprise, etc.) ; spcifier certains paramtres associs l'utilisation de ressources rseau pour des changes protocolaires, tels que le mcanisme de slection du protocole de connexion (paramtre SAP). Les mthodes d'accs ou les protocoles d'change de donnes installs sont : X.25 sur tous les systmes ; DNA, SNA, TCP/IP et LU6.2, selon le systme.

TCP/IP peut uniquement tre utilis entre deux moniteurs CFT. L'utilisation des protocoles d'change de donnes dans un rseau SNA n'est pas standardise. Les protocoles de transfert suivants sont installs : PeSIT D (profils SIT, External et CFT) ; PeSIT E (TOUT profil) ; ETEBAC3 ; ODETTE.

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-14

Un transfert avec un partenaire est possible si le protocole de transfert et le protocole d'change de donnes utiliss sont pris en charge par le moniteur local et par le moniteur du partenaire concern, et s'il n'existe aucune incompatibilit dans les choix d'exploitation (par exemple, profil PeSIT, options protocolaires, etc.). Pour CFT, l'association entre un partenaire et les protocoles CFT qui peuvent tre utiliss est dfinie par le paramtre PROT de l'objet CFTPART. Le nombre maximal d'objets CFTPROT grs par le moniteur est de 32. Le protocole pris en charge est spcifi par le paramtre TYPE. L'objet CFTPROT contient un ensemble de paramtres utiliss pour dfinir toutes les options de tous les protocoles de transfert pris en charge. Certains de ces paramtres sont communs tous les protocoles, tandis que d'autres sont spcifiques un protocole et donc un TYPE donn. L'objet CFTPROT dfinit les lments suivants : les paramtres qui sont communs tous les protocoles, dcrits dans l'objet CFTPROT ; les paramtres spcifiques, regroups par types de protocole, dcrits dans CFTPROT TYPE = xxx. Le paramtre TYPE peut prendre l'une des valeurs suivantes : ETEBAC, ODETTE ou PeSIT ; Le paramtre permettant d'associer un protocole un profil de scurit (SSL), dcrit dans Scurit du transport. Remarque : en gnral, les paramtres commenant par S contrlent les transferts en mission, tandis que ceux commenant par R contrlent les transferts en rception. Cette rgle ne s'applique pas ncessairement lorsque des transferts dans diffrents sens sont effectus la suite pendant la mme connexion.

6.8.2

Transferts par le biais d'un proxy et du protocole SOCKS


Un proxy est un programme faisant office d'intermdiaire entre un client et un serveur. Il est notamment utilis pour interconnecter deux rseaux par le biais d'un seul point. Le protocole SOCKS est indpendant du protocole applicatif et permet de relayer une session TCP par le biais d'un proxy. Cette indpendance signifie que ce protocole peut relayer les protocoles de transfert de fichiers PeSIT et ODETTE avec ou sans SSL, par exemple. Cette section dcrit les concepts lis au proxy et au protocole SOCKS : connexion application dans CFT rsolution de l'adresse codes d'erreur

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-15

Architecture du protocole SOCKS

CFT prend en charge les versions 4 et 4A du protocole SOCKS. Cette rubrique fournit une brve explication du protocole SOCKS. 6.8.2.1 Connexion Dans la version 4 du protocole SOCKS, un client ouvre une session dans le proxy et lui envoie une requte de connexion indiquant l'adresse IP du serveur (version 4) ou le nom d'hte (version 4A), le numro du port d'coute du serveur et un nom d'utilisateur. Le proxy vrifie la requte de connexion, puis l'excute ou la rejette. Une rponse indiquant l'tat de la requte (le serveur est connect, la connexion au serveur a chou, l'utilisateur n'est pas autoris se connecter, etc.) est envoye au client. Lorsque la connexion est correctement tablie entre le proxy et le serveur, le client et le serveur sont connects par le biais du proxy et peuvent effectuer des changes de donnes transparents (PeSIT, etc.). Une requte de connexion doit avoir le format suivant : Version 4 +--+--+--+--+--+--+--+--+--+--+....+--+ |V |C |PORT | @IP | USERID |0 | +--+--+--+--+--+--+--+--+--+--+....+--+ Version 4A +--+--+--+--+--+--+--+--+--+--+....+--+--+--+....+--+ |V |C |PORT | 0.0.0.n | USERID |0 | HOST NAME|0 | +--+--+--+--+--+--+--+--+--+--+....+--+--+--+....+--+

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-16

Une requte de connexion est cre par les champs suivants : champ V (version) : il doit tre fix la valeur binaire 4 ; champ C (commande) : il doit tre fix la valeur binaire 1 ; champ PORT (numro de port du serveur atteindre) : le numro de port est exprim en binaire sur une longueur de 2 octets (le plus significatif suivi du moins significatif) ; champ @IP (adresse IP du serveur atteindre) : l'adresse IP est exprime en binaire sur une longueur de 4 octets ; champ USERID (nom d'utilisateur) : le nom d'utilisateur est termin par un octet nul ; champ HOST NAME (nom d'hte) : le nom d'hte est uniquement pris en charge dans la version 4A ; il est particulirement utile si le client ne peut pas rsoudre un nom d'hte de serveur dans une adresse IP ; le champ @IP field (adresse IP du serveur atteindre) doit alors tre exprim au format 0.0.0.n, n tant non nul (une telle adresse est non valide). La rponse la requte de connexion doit avoir le format suivant : Versions 4 et 4A +--+--+--+--+--+--+--+--+ |V |S |PORT | @IP | +--+--+--+--+--+--+--+--+ Une rponse une requte de connexion a exactement une longueur de 8 octets. Elle inclut les champs suivants : champ V (version) : il doit tre fix la valeur binaire 0 ; champ S (tat) indiquant un code d'excution de requte : 90 (0x5A) : la connexion au serveur est tablie ; o 91 (0x5B) : la connexion au serveur est rejete ; o 92 (0x5C) et 93 (0x5D) : le proxy rejette la requte de connexion ; champs PORT et @IP : ces deux champs sont ignors.
o

Le proxy ferme la connexion au client ds qu'il a inform ce dernier que la connexion au serveur a t refuse. Sinon (code 90), le client et le serveur sont connects par le biais du proxy et peuvent effectuer des changes de donnes d'applications. 6.8.2.2 Application dans CFT La commande CFTNET pour un proxy est statique. Pour appliquer des modifications, CFT doit tre arrt, les nouveaux paramtres interprts (CFTUTIL) et CFT redmarr. Au moins un protocole de transfert de fichiers (commande CFTPROT) doit tre dclar pour la commande CFTNET dcrivant un accs par le biais d'un proxy. Pour ces protocoles, CFT accepte uniquement les appels sortants. Les protocoles (commandes CFTPROT) et les rseaux (commandes CFTNET) doivent tre dclars dans la commande CFTPARM appliquer par CFT.

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-17

Transferts de fichiers par le biais d'un proxy

6.8.2.3 Rsolution de l'adresse Si l'adresse du partenaire distant est exprime sous forme d'adresse IP numrique, CFT met une requte de connexion SOCKS4 vers un proxy. Si cette adresse est exprime sous forme de nom d'hte, CFT tente de rsoudre l'adresse en interrogeant le rpertoire (fichier, htes, rpertoire DNS, etc., en fonction de la configuration de la pile IP du systme). Si l'adresse est rsolue, une adresse IP associe au nom d'hte est retourne et CFT met une requte de connexion SOCKS4. Dans le cas contraire, CFT met une requte de connexion SOCKS4A 6.8.2.4 Codes d'erreur CFT ragit aux codes d'erreur provenant d'un proxy de la manire suivante : 91 (0x5B) : CFT effectue une autre tentative de transfert ; le dlai et les tentatives de transfert dpendent des paramtres RETRYW, RETRYN et RETRYM de la commande CFTTCP dfinissant les caractristiques rseau du partenaire distant ; 92 (0x5C), 93 (0x5D) et autres codes : CFT place le transfert en attente (tat K) ; l'oprateur doit excuter une action (commande START) pour reprendre le transfert.

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-18

6.9 Dfinition des paramtres gnraux - CFTPARM


L'objet de dfinition des paramtres gnraux dans l'interface GUI correspond l'objet CFTPARM dans les oprations en mode ligne de commande. L'objet CFTPARM dfinit des paramtres gnraux qui : spcifient les paramtres de commande globale des oprations du moniteur CFT ; slectionnent les autres commandes de paramtrage prises en compte pendant l'excution. Vous pouvez crer plusieurs objets CFTPARM, mais vous ne pouvez en slectionner qu'un seul pour le dmarrage du moniteur. Seuls les objets associs CFTNET, CFTCOM et CFTPROT sont rpertoris pour un paramtre PARM donn. Si vous changez les paramtres COM, NET, PROT ou CAT correspondants, vous modifiez galement ce paramtre PARM spcifique. L'environnement CFT est dfini par les paramtres suivants : les constantes de dimensionnement ; l'emplacements des fichiers ; les actions de fin de transfert ; la clef d'activation du produit. CFTPARM est un objet de configuration initiale. Ces paramtres sont configurs au dmarrage de CFT et ne peuvent pas tre modifis dynamiquement. Si vous modifiez des valeurs de CFTPARM, ces changements ne seront pris en compte qu'aprs arrt et redmarrage de CFT. L'utilisateur travaille gnralement avec un seul objet CFTPARM dans le fichier de paramtrage. Cependant, ce fichier peut contenir plusieurs commandes de ce type, une seule d'entre elles tant slectionne au moment de l'activation du moniteur, en spcifiant, en tant que paramtre d'activation, la valeur de l'identifiant (ID) de la commande CFTPARM slectionne. Si ce paramtre d'activation n'est pas dfini, CFT recherche une commande CFTPARM ID = IDPARM0 (numro 0). Ces paramtres sont dfinis au dmarrage de CFT et ne peuvent pas tre modifis dynamiquement. La section Procdures de fin de transfert dtaille l'utilisation des paramtres EXECSE, EXECSF, etc.

6.9.1

Comment fonctionne l'objet CFTPARM ?


CFTPARM est l'objet matre qui permet de rfrencer les autres objets de configuration. Cette opration est effectue en utilisant la mme valeur pour : l'identifiant de la commande rfrence (paramtre ID) et le paramtre CFTPARM rfrenant cette commande. La valeur du paramtre CAT (objet CFTPARM, par exemple) dsigne l'identifiant de l'objet CFTCAT qui dcrit le fichier CATALOGUE de transfert.

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-1

CFTPARM - Dfinition des paramtres d'environnement gnraux

Il existe galement des relations entre la valeur du paramtre NET de l'objet CFTPARM et les valeurs du paramtre NET de l'objet CFTPROT et du paramtre ID de l'objet CFTNET.

6.10 Bascule entre les fichiers journaux - CFTLOG


Lorsqu'un fichier journal est plein ou lorsque certains critres d'enregistrement sont satisfaits, le fichier journal bascule du fichier actuel au fichier altern. A chaque bascule d'un fichier de suivi, CFT excute la procdure dfinie par le paramtre EXEC de l'objet CFTLOG. Lorsque vous activez CFT, au moins un des fichiers LOG doit tre vide. Le fichier vide est celui qui a t dsign en tant que fichier journal pour la session du moniteur. Le fichier ouvert par CFT pour recevoir les messages doit tre vide. Cette procdure doit gnrer un fichier LOG ou ALOG vide pour la bascule suivante. Les variables symboliques &SYSTIME, &SYSDATE, &FLOG, accessibles partir de la procdure de bascule, permettent de localiser le nom du dernier fichier journal utilis par CFT. Une procdure de bascule typique consiste : enregistrer, imprimer ou utiliser le fichier journal actuel (LOG ou ALOG) ; crer un nouveau fichier journal vide (LOG ou ALOG). Au moment o la bascule est effectue, CFT ferme le fichier actuel et ouvre le fichier altern pour y enregistrer des donnes. Si ce fichier n'est pas vide, l'enregistrement est alors automatiquement effectu sur un oprateur. CFT vrifie l'existence du fichier de procdure de bascule associ, c'est--dire la valeur du paramtre EXEC de la commande CFTLOG, copie le fichier de commande dans un fichier rserv en remplaant si ncessaire la variable symbolique &FLOG, puis transmet ce fichier pour excution.

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-2

Selon le systme, le fichier rserv peut tre un fichier temporaire dont le nom est gnr par CFT. Reportez-vous au Guide d'exploitation de CFT qui correspond votre systme d'exploitation.

Manuel de rfrence

Dfinition de lenvironnement du moniteur

6-3

7 Cration des partenaires Listes de diffusion

7.1 A propos de CFTDEST


L'objet CFTDEST gre la liste des partenaires pour les oprations de distribution et de collecte. La liste des partenaires peut tre dcrite : explicitement en utilisant un paramtre de type liste ; en utilisant un fichier dans lequel la liste est enregistre. Ces deux mthodes sont mutuellement exclusives. Un partenaire figurant dans une liste ne peut pas tre lui-mme une liste de diffusion. Le moniteur cre les lments suivants dans le catalogue : un poste gnrique associ la commande de transfert ; un poste pour chaque partenaire figurant dans la liste. Aucune vrification n'est effectue entre le nombre de postes et le nombre de partenaires figurant dans la liste.

7.2

Collecte
Les fichiers provenant de plusieurs partenaires peuvent tre collects par le biais d'une seule commande RECV se rfrant une liste de partenaires associs cette collecte. Cette liste est dfinie dans l'objet CFTDEST. La figure suivante dcrit les relations tablir pour effectuer cette collecte.

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-1

7.3

Dfinition d'une liste de partenaires


L'objet CFTDEST permet de dsigner un pseudo-partenaire en se rfrant une liste de partenaires, afin d'excuter l'opration suivante en une seule commande : diffusion d'un fichier (ou d'un message) plusieurs partenaires. La diffusion peut tre active : par une commande SEND locale ou par une commande SEND mise par un partenaire distant, le moniteur local faisant office de site intermdiaire ou une collecte de fichier (ou de message) provenant de plusieurs partenaires. La collecte est active par une commande RECV locale. La liste des partenaires peut tre dcrite : explicitement en utilisant le paramtre PART ou dans un fichier dans lequel cette liste est enregistre, o le nom du fichier est dfini par le paramtre FNAME. Ces deux mthodes sont exclusives : les paramtres PART et FNAME ne peuvent pas tre utiliss en mme temps. Un partenaire dsign dans cette liste ne peut pas tre lui-mme une liste de diffusion : les partenaires rcursifs ne sont pas autoriss. Les enregistrements crs dans le catalogue sont : l'enregistrement associ la commande SEND ou RECV ; les enregistrements associs aux transferts vers chaque partenaire de la liste. Lorsqu'un poste de catalogue est gnr, le nombre de postes disponibles dans ce catalogue n'est pas contrl par rapport au nombre total de partenaires figurant dans la liste. Aprs un transfert correct vers un partenaire, l'enregistrement associ dans le catalogue passe l'tat T. Une fois que TOUS les transferts correspondant chacun des partenaires dcrits dans cette liste ont t CORRECTEMENT termins, l'enregistrement associ la commande SEND ou RECV passe alors l'tat T. Une procdure de fin de transfert peut tre excute condition qu'elle ait t dfinie : dans le paramtre EXEC de la commande SEND ou RECV l'initiative du transfert ou (si ce paramtre EXEC n'est pas dfini) dans le paramtre EXECSF (pour une diffusion) ou EXECRF (pour une collecte) de la commande CFTPARM associe. Le paramtre EXEC de la commande CFTDEST indique le mode de soumission de la procdure : lorsque tous les transferts sont termins (valeur par dfaut) ; la fin de chaque transfert et lorsque tous les transferts sont termins.

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-2

Si un incident se produit pendant un transfert correspondant l'un des partenaires dfinis dans cette liste, la procdure de traitement des incidents de transfert (paramtre EXECSE ou EXECRE de la commande CFTPARM) est alors excute. L'enregistrement associ ce transfert est fix l'tat correspondant celui de l'incident. Dans ce cas (un incident pendant au moins un transfert), l'enregistrement associ la commande SEND ou RECV reste l'tat K. Le nombre maximal de commandes CFTDEST gres est de 200.

7.4
7.4.1

Concepts de diffusion
Diffusion en utilisant un site de commutation
Un fichier peut tre envoy plusieurs partenaires par le biais d'une seule commande SEND se rfrant une liste de diffusion dfinie dans l'objet CFTDEST. La figure ci-dessous dcrit les relations tablir. Dfinition d'une liste de partenaires

Remarque : la liste de diffusion peut tre dcrite dans un fichier. Dans ce cas, le nom de ce fichier est indiqu dans le paramtre FNAME de la commande CFTDEST. Les paramtres correspondants doivent tre dcrits en utilisant la commande CFTPART, comme dans le cas o la liste est explicite. La figure suivante indique le paramtrage effectu pour atteindre un partenaire sur une liste de diffusion, par une commutation intentionnelle. La diffusion aux deux autres partenaires est ralise par connexion directe.

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-3

Diffusion par le biais d'un site de commutation

7.4.2

Notations spcifiques la diffusion


Pour diffuser un fichier partir d'un site de commutation, les conditions suivantes doivent tre satisfaites : l'metteur initial dfinit un partenaire virtuel ayant un ID correspondant celui de la commande CFTDEST gre sur le site de commutation. Les valeurs des paramtres OMINTIME et OMAXTIME de la commande CFTPART sont fixes zro pour forcer le routage des transferts vers le site de commutation (IPART du partenaire intermdiaire : ID_B). Un fichier diffuser partir du site de

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-4

commutation est envoy par la commande SEND PART=ID_CD ... ; le noeud de commutation doit avoir une commande CFTDEST dont l'identifiant (ID=ID_CD) est le nom de rseau de la liste de diffusion indique par le partenaire initial (SEND PART=ID_CD) ; l'objet CFTDEST doit respecter la syntaxe impose par CFT (paramtres FOR=COMMUT) ; les rcepteurs finaux C et D connaissent l'metteur initial du fichier (CFTPART ID=ID_A, ...) et le partenaire de commutation B ; les connexions tablies entre les partenaires doivent tre compatibles en chacun des noeuds du rseau (CFTPART ID=...).

7.4.3

Processus de diffusion
Sur le site de commutation, lors du transfert effectif du fichier diffuser, CFT n'active aucune procdure de fin de transfert ou d'erreur. L'IDF de transfert est fix la valeur COMMUT : une commande CFTRECV ID = COMMUT doit donc tre dfinie sur le site car le transfert est enregistr dans le catalogue sous l'identifiant de fichier IDF = COMMUT. Si le code de donnes transfr (NCODE) est diffrent de celui du site de commutation (par exemple, NCODE = EBCDIC et code interne ASCII sur l'ordinateur de commutation), les donnes ne sont pas traduites sur l'ordinateur de commutation (en mode commutation, les donnes sont uniquement traduites de bout en bout et non pas d'ordinateur ordinateur). Lorsque tous les transferts ont t correctement termins, le transfert gnrique (virtuel) associ la diffusion (poste dsign dans le catalogue par un code DIAGP gal DIFFUS) passe l'tat T. Le cas chant, CFT active la procdure de fin de transfert associe ce transfert gnrique (voir paragraphe Diffusion). Contrairement un transfert simple en mode commutation, le fichier cr sur le site intermdiaire n'est pas supprim. Cette suppression peut tre traite par la procdure de fin de transfert car la variable &DIAGP est utilise pour dterminer si le transfert est une diffusion (DIAGP = DIFFUS). Sur le site rcepteur final : CFT reoit les mmes paramtres applicatifs que ceux dfinis pour un transfert simple en mode commutation. Le site de commutation n'a aucun impact sur le mode de transfert (ouvert ou ferm). A la fin de la rception d'un fichier ou d'un message, un message d'acquittement (SEND TYPE = REPLY) peut tre envoy l'metteur initial (voir ci-dessous). Sur le site metteur initial et sur les sites rcepteurs finaux : Des procdures de fin de transfert ou d'erreur peuvent tre dclenches pendant un transfert. Les variables symboliques typiques pour ces types de procdures peuvent tre utilises.

7.4.4

Acquittement d'une liste de diffusion


Les notations ci-dessous sont utilises dans l'exemple de paramtrage reprsent sur la figure suivante. Pour acquitter un transfert de fichier ou de message en mode commutation, le(s) partenaire(s) final(aux) envoie(nt) un message TYPE=REPLY au partenaire initial (les valeurs nulles des paramtres OMINTIME et OMAXTIME de la commande CFTPART associe forcent le routage de la rponse via le partenaire intermdiaire B IPART=B).

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-5

Pour acquitter une liste de diffusion, les conditions suivantes doivent alors tre satisfaites pour acheminer l'acquittement jusqu'au partenaire initial : les connexions tablies entre les partenaires doivent tre compatibles en chacun des noeuds du rseau (CFTPART ID=...) ; au niveau du noeud de commutation, tous les enregistrements de catalogue correspondants la diffusion prcdente sont prsents ; au niveau du noeud de commutation, tous les enregistrements de catalogue correspondants la diffusion prcdente indiquent que les partenaires de rception ont correctement reu le fichier ou message (tat de transfert SFT). Si ces conditions sont remplies, l'metteur initial du fichier ou message reoit un seul message d'acquittement. Le message provient arbitrairement du dernier partenaire final qui a envoy un message de rponse. Mcanisme d'acquittement d'une liste de diffusion

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-6

7.5 Dfinition des partenaires - CFTPART


Pour CFT, un partenaire est une entit logique (banque, gouvernement ou partenaire commercial) qui peut tre la source ou la destination d'un change de donnes. Un partenaire correspond gnralement un moniteur de transfert de fichiers distant. La commande CFTPART dcrit les caractristiques de chaque partenaire : relatives l'environnement de rseau/protocole en dfinissant :
o

les protocoles CFT qui peuvent tre utiliss avec ce partenaire et le SAP associ, le slecteur protocolaire et diffrentes valeurs ; l'identification du rseau (nom du rseau, mot de passe) connue du partenaire et identifiant ce dernier ; l'identification des partenaires intermdiaires en cas de connexion indirecte ; le mode de transfert ; la table de transcodage associe au partenaire ; le type de systme d'exploitation de l'ordinateur partenaire qui permettra de dduire les types de fichiers ou le code de donnes du partenaire ; les priodes d'appel autorises (vers/depuis le partenaire) ; la liste des identifiants de fichiers autoriss pour les transferts en mission et en rception ; l'tat du partenaire (actif ou inactif, en mode demandeur ou serveur).

relatives aux transferts raliss en dfinissant :


o o o

o o

7.5.1

Paramtres de configuration associs


Certains paramtres servent rfrencer des commandes de configuration associes ce partenaire, concernant : la commande de rseau CFTxxx (exemple : CFTX25) ; la commande protocolaire CFTPROT ; la commande de contrle d'autorisation CFTAUTH : paramtre SAUTH pour le transfert en mission ; paramtre RAUTH pour le transfert en rception ; la commande de table de transcodage CFTXLATE.
o o

Plusieurs protocoles et commandes de rseau CFTxxx (plusieurs commandes CFTX25 par exemple) peuvent tre associs un partenaire spcifique.

7.5.2

Partenaire ayant la mme valeur NRPART


Cette fonction est uniquement disponible en mode DEMANDEUR avec les protocoles PeSIT, ETEBAC 3 et OFTP (ODETTE). En mode demandeur, CFT permet de s'identifier en utilisant diffrentes identifications relatives un partenaire distant spcifique : utilisation de diffrentes valeurs de NSPART, en association avec un NRPART donn. Cette fonction est utilise si les paramtres IMINTIME et IMAXTIME ont la mme valeur. La plage temporelle dfinie pour les appels entrants est nulle, en empchant ainsi l'utilisation du mode SERVEUR. Toute tentative de transfert en mode SERVEUR en utilisant la valeur NSPART ainsi dfinie chouera.

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-1

Exemple de paramtrage de la fonction d'identification de demandeurs multiples Les commandes suivantes rcapitulent le paramtrage permattant d'accder un ordinateur B. Ces paramtres peuvent tre utiliss pour les modes serveur et demandeur. Cet exemple de rsum des paramtres est suivi d'un schma sur la fonction des identificateurs multiples. CFTPART ID = ID_B, NSPART = A, NRPART = B,... (IMINTIME et IMAXTIME par dfaut)

Utilisable en mode demandeur uniquement : CFTPART ID = ID_B_1, IMINTIME = 0, IMAXTIME = 0, NSPART = A1,... NRPART = B,... CFTPART ID = ID_B_2, IMINTIME = 0, IMAXTIME = 0, NSPART = A2,... NRPART = B,... Le schma suivant indique le paramtrage rsultant pour le demandeur A et le serveur B. Il est noter que vous devez d'abord crer un objet CFTPART avec un ID_B pour que l'exemple ci-dessous fonctionne.

Il est possible d'accder un ordinateur ayant cette configuration en mode SERVEUR si un seul objet CFTPART a t paramtr avec une valeur IMINTIME diffrente de la valeur IMAXTIME. Le serveur ne connat qu'un seul paramtre NRPART pour accder un demandeur dfini.

7.6 Paramtrage par dfaut du rseau - CFTxxx


Les commandes de type CFTxxx dfinissent les paramtres des partenaires pour un type de rseau spcifique : emplacement dans le rseau du moniteur partenaire sur l'ordinateur hte.

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-2

Les informations supplmentaires concernant le point d'accs au service (SAP) sont spcifies dans l'objet CFTPART associ ; plages temporelles pour les appels par le biais de ce rseau ; mcanismes de tentative de reconnexion ; nombre maximal de connexions simultanes avec ce partenaire, dans chaque sens.

7.6.1

CFTDNA - Paramtres rseau dun partenaire DNA


La commande CFTDNA permet de dfinir les paramtres rseau associs un partenaire pour une connexion Decnet. Il ne peut y avoir quune seule commande CFTDNA par partenaire. Seuls les paramtres spcifiques la commande CFTDNA sont dtaills. La liste exhaustive des paramtres licites est nanmoins donne ci-aprs, les paramtres communs tant rappels en dbut de liste.

7.6.2

CFTSNA - Paramtres rseau dun partenaire SNA


La commande CFTSNA permet de dfinir les paramtres rseau associs un partenaire pour les communications sur rseau SNA. Seuls les paramtres spcifiques la commande CFTSNA sont dtaills. La liste exhaustive des paramtres licites est nanmoins donne ci-aprs. Plusieurs sessions peuvent tre ouvertes avec le partenaire. Pour communiquer entre les moniteurs CFTV2 et CFT/370 version 1, la version minimum du moniteur CFT/370 version 1 est le niveau 160. En mode DELETE, les paramtres suivants doivent tre renseigns : le paramtre ID ; mais galement le paramtre CLASS (si sa valeur est diffrente de la valeur par dfaut 1). Ces deux paramtres identifient en effet de manire unique un accs SNA.

7.6.3

CFTTCP - Paramtres rseau dun partenaire TCP/IP


La commande CFTTCP permet de dfinir les paramtres rseau associs un partenaire pour une connexion TCP/IP. Il ne peut y avoir quune commande CFTTCP par partenaire.

7.6.4

CFTX25 - Paramtres rseaux dun partenaire X25


Cette commande est utilisable sur TOUS les systmes. La commande CFTX25 permet de dfinir les paramtres rseau associs un partenaire pour une liaison sur X25 public ou X25 priv. Il peut y avoir plusieurs commandes CFTX25 par partenaire, mais une seule commande pour un partenaire et une classe donne. En mode DELETE, les paramtres suivants doivent tre renseigns : le paramtre ID ; mais galement le paramtre CLASS (si sa valeur est diffrente de la valeur par dfaut 1). Ces deux paramtres identifient en effet de manire unique un accs X25.

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-3

7.6.5

CFTLU62 - Paramtres rseau dun partenaire LU62


La commande CFTLU62 permet de dfinir les paramtres rseau associs un partenaire pour une connexion LU6.2.

7.7 Exemples de diffusion


7.7.1

Diffusion simple
Un site A souhaite contrler la diffusion de l'un de ses fichiers par l'intermdiaire d'un site B. Exemple de diffusion simple

Phase 1 Le site A transmet au site B la liste des partenaires (C1, C2, ..., Cn) auxquels le fichier doit tre diffus (LIST_B) : SEND PART=ID_B, FNAME=LIST_B, ... Le site B reoit ce fichier en tant que LIST grce la commande : CFTRECV ID=..., FNAME=LIST. Phase 2 Le site A envoie le fichier diffuser un partenaire virtuel C : SEND PART=ID_C, FNAME=FILE_TO_broad, ... Le partenaire C ne peut pas tre atteint directement, mais uniquement par l'intermdiaire du site B. Sur le site A : CFTPART ID=ID_C, ..., IMINTIME=0, IMAXTIME=0, IPART=ID_B Le fichier FILE_TO_broad est donc reu par le site B qui tente de le transmettre C (C est une liste de diffusion). Sur le site B : CFTDEST ID=C, FNAME=LIST, FOR=COMMUT Le fichier FILE_TO_broad est donc envoy tous les partenaires figurant dans la liste.

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-4

7.7.2

Diffusion personnalise
Les sites A peuvent tre multiples (par exemple, un seul site de distribution et plusieurs sites de production). Chaque site de production dsigne une liste de diffusion diffrente. Exemple de diffusion personnalise

Phase 1 : Chaque site Ap envoie sa liste de diffusion au site B : SEND PART=ID_B, FNAME=LIST_B, ... Le site B reoit le fichier LIST en tant que LIST_Ap grce la commande : CFTRECV ID=..., FNAME=LIST_&PART Phase 2 : Chaque site Ap envoie un partenaire virtuel C le fichier diffuser (comme pour la diffusion simple). Le site B envoie le fichier dans la liste associe la commande : Sur le site B : CFTDEST ID=C, FNAME=LIST_&SPART, FOR=COMMUT

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-5

7.7.3

Diffusion composite
Il peut galement y avoir plusieurs sites B (par exemple, un seul site de production et plusieurs sites de distribution). Exemple de diffusion composite

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-6

Phase 1 : Le site A diffuse les listes de diffusion Cp1, Cp2, ..., Cpn aux partenaires directs Bn : SEND PART=ID_B, FNAME=LIST_&PART, ... o B est la liste des partenaires Bn : CFTDEST ID=ID_B, PART=(ID_B1, ID_B2, ..., ID_Bn), FOR=LOCAL Chaque Bp reoit le fichier LIST en tant que "LIST" grce la commande : CFTRECV ID=..., FNAME=LIST Phase 2 : Le site A envoie chaque partenaire virtuel Cp le fichier diffuser : SEND PART=ID_C1, FNAME=FILE_TO_broad, ... SEND PART=ID_C2, FNAME=FILE_TO_broad, ... SEND PART=ID_Cp, FNAME=FILE_TO_broad, ... Le fichier peut galement tre personnalis en utilisant des variables symboliques. Un fichier diffrent peut donc tre envoy chaque site de diffusion. Chaque commande CFTPART ID=ID_Cp dsigne Bp en tant que partenaire intermdiaire. Sur chaque site Bp : CFTDEST ID=Cp, FNAME=LIST, FOR=COMMUT

Manuel de rfrence

Cration des partenaires Listes de diffusion

7-7

8 Transfert de fichiers

8.1 Cration de listes dhabilitation - CFTAUTH


L'objet CFTAUTH est une liste des identifiants de fichiers autoriss qui dfinit l'autorisation d'accs des utilisateurs pour chaque partenaire. Une liste d'mission ou de rception peut tre associe chaque partenaire. La liste des partenaires peut tre dcrite : en utilisant un paramtre de type liste IDF ou en utilisant un fichier dans lequel cette liste est enregistre (paramtre FNAME). Ces deux mthodes sont mutuellement exclusives. Vous ne pouvez pas utiliser simultanment les paramtres IDF et FNAME. Vous pouvez dfinir la liste des identifiants de fichiers (IDF) qui est soumise aux mmes autorisations ou restrictions de transfert. Vous pouvez associer chaque partenaire : une liste d'mission ou une liste de rception. L'identifiant de la liste d'mission est dfini par la valeur du paramtre SAUTH de la commande CFTPART. L'identifiant de la liste de rception est dfini par la valeur du paramtre RAUTH de la commande CFTPART.

8.2 Modle d'association virtuelle de fichiers - CFTIDF


Un objet CFTIDF dfinit un identifiant de rseau pour un partenaire spcifique, et un sens de transfert lorsque les partenaires ne peuvent pas s'accorder sur des identifiants de fichiers communs. L'objet CFTIDF est utilis pour configurer localement cette correspondance entre le paramtre IDF local et le paramtre NIDF envoy ou reu. Pour tous les protocoles SAUF le procotole PeSIT profil SIT Si, en raison de contraintes d'exploitation, les partenaires ne peuvent pas s'accorder sur des identifiants de fichiers communs, le concept d'identifiant de rseau (NIDF) peut tre utilis pour concilier, pour un partenaire et un sens de transfert spcifiques, l'identifiant local (IDF) et l'identifiant de fichier fourni par le partenaire (ou envoy celui-ci). Les autres mthodes pour tablir cette correspondance sont indiques dans la section Correspondance NIDF/IDF. La valeur par dfaut prise par NDIF (envoy en mode

Manuel de rfrence

Transfert de fichiers

8-1

demandeur) ou par IDF (trouv en utilisant le NIDF reu en mode serveur) et affecte en l'absence de cette commande, est indique. En mode SUPPRESSION, seuls les paramtres ID, TYPE et PART sont obligatoires.

8.3 Cration du modle RECV par dfaut


8.3.1

Rsum des paramtres du fichier de rception


Cette section rpertorie les paramtres et la syntaxe requis pour crer un transfert de fichier de rception par dfaut en utilisant l'interface en ligne de commande. Certains paramtres peuvent tre classs en catgories : paramtres d'identification :
o o

gnraux : ID, USERID, GROUPID ; spcifiques au protocole PeSIT (PeSIT D profil CFT ou PeSIT E) : RUSER, SUSER ;

protection des paramtres configurs : FORCE ; paramtres libres configurs localement par l'utilisateur de CFT : COMMENT, OPERMSG, DELETE, NOTIFY ; paramtres de contrle d'excution :
o o o

gnraux : PRI ; utilisateur : EXEC, EXIT ; gestion de cycle : MINDATE, CYCTIME ;

paramtres de traitement de donnes NCOMP, XLATE, FCODE ; paramtres de fichiers (gnraux) :


o o o o

gestion de fichiers : FACTION, FDISP ; nom physique : FNAME, WFNAME ; caractristiques physiques (fichier global) : FSPACE, FORG, FTYPE ; caractristiques physiques (enregistrements) : FRECFM, FLRECL, FBLKSIZE, FKEYLEN, FKEYPOS.

Utilisation des paramtres dfinissant les caractristiques du fichier : plusieurs des paramtres dfinissant les caractristiques du fichier rcepteur peuvent souvent tre omis dans la pratique car les messages protocolaires transportent (ou permettent de localiser) les indications relatives aux caractristiques de fichier communiques par l'metteur. Pour un transfert donn, ces valeurs protocolaires sont les valeurs DEFAULT des paramtres Fxxxxx correspondants : PeSIT E CFT/CFT PeSIT D profil CFT En PeSIT E (CFT CFT) ou en PeSIT D profil CFT (transfert entre 2 moniteurs CFT), les valeurs par dfaut prises par les paramtres FSPACE, FTYPE, FBLKSIZE, FLRECL et FRECFM sont les valeurs transmises par le partenaire (voir paramtres NSPACE, NTYPE, NBLKSIZE, NLRECL et NRECFM de l'objet CFTSEND). Pour l'exploitation en mode ouvert, le paramtre FNAME peut galement hriter de la valeur du paramtre NFNAME du partenaire.

Manuel de rfrence

Transfert de fichiers

8-2

PeSIT E

En PeSIT E, les valeurs par dfaut prises par les paramtres FKEYLEN et FKEYPOS sont les valeurs transmises par le partenaire (voir paramtres NKEYLEN et NKEYPOS de l'objet CFTSEND). En PeSIT D profil EXTERN, les informations de "longueur de fichier", de "format d'enregistrement" et de "longueur d'enregistrement" envoyes par le protocole sont prises comme les valeurs par dfaut des paramtres FSPACE, FRECFM et FLRECL. En PeSIT profil SIT, les informations de "longueur de fichier", de "format d'enregistrement" et de "longueur d'enregistrement" envoyes par le protocole sont prises comme les valeurs par dfaut des paramtres FSPACE, FRECFM et FLRECL. En protocole ODETTE, les valeurs par dfaut des paramtres FSPACE, FRECFM et FLRECL sont dduites des paramtres ODETTE reus. En protocole ETEBAC3, seuls les fichiers ayant un format fixe peuvent tre transfrs par le biais du protocole. En mode serveur/rcepteur, la taille d'enregistrement envoye dans la carte de paramtrage est prise comme la valeur par dfaut du paramtre FLRECL.

PeSIT D profil EXTERN

PeSIT profil SIT

ODETTE

ETEBAC3

8.3.2

Rception d'un fichier


La figure ci-dessous montre les relations gnrales entre une commande RECV d'utilisateur et les commandes de paramtrage CFTPART et CFTRECV, dans le contexte d'un transfert partir d'un seul partenaire. Si aucune commande CFTRECV n'est associe un identifiant ID = FI, les caractristiques par dfaut indiques dans la commande CFTRECV ID = <dfaut> servent, si ncessaire, complter celles indiques dans la commande RECV. Correspondance entre la commande de fichier RECV et le paramtrage de Transfert CFT

Manuel de rfrence

Transfert de fichiers

8-3

8.3.3

A propos de l'objet CFTRECV par dfaut


L'objet CFTRECV initial vous permet : de dfinir le nom par dfaut et les caractristiques physiques locales du fichier recevoir ; de dfinir les actions par dfaut excuter localement pendant et aprs le transfert (transcodage, compression, appel d'un EXIT d'utilisateur, d'une procdure de fin de transfert, etc.) ; d'autoriser la plage temporelle par dfaut et l'utilisateur par dfaut associs aux transferts. Le nombre d'objets CFTRECV que vous pouvez crer dans le dossier Ongoing CFTRECV est illimit. Dans cette rubrique, vous dfinissez l'objet CFTRECV par dfaut. Certains objets par dfaut ne peuvent pas tre supprims. Ainsi, les objets CFTSEND, CFTRECV et CFTET par dfaut ne peuvent pas tre supprims s'ils sont utiliss par une autre configuration. Pour plus de clart, les caractristiques du paramtrage associ un fichier type pour des transferts en rception partir d'une base de donnes VFM sont dcrites dans une section spcifique la fin du prsent paragraphe.

8.3.4

Paramtres associs un fichier type


Les commandes CFTRECV contiennent des paramtres qui permettent de contrler la procdure de rception et l'enregistrement des donnes reues. Chaque commande CFTRECV - sauf la commande "default" - contrle la rception du fichier type ayant le mme identifiant (IDF correspondant l'ID de la commande CFTRECV). La commande CFTRECV "default" s'applique quant elle tous les autres fichiers types (dont l'IDF ne correspond aucun ID de commande CFTRECV). Pour plus de clart, toutes les commandes CFTRECV sont gnralement regroupes dans un fichier de paramtrage source et la commande CFTRECV par dfaut est place en premire ou dernire position. La commande CFTRECV permet de spcifier, pour chaque fichier type (IDF) : le nom et les caractristiques physiques (par exemple : format et longueur d'enregistrement) du fichier rcepteur ; les actions excuter localement telles que :
o

o o

l'appel d'une tche "EXIT de type fichier" crite par l'utilisateur pendant le transfert ; les actions excutes par le moniteur sur le fichier rcepteur au dbut du transfert ; le transcodage de donnes pendant la rception ; l'appel d'une procdure excuter la fin du transfert, etc. ; la plage temporelle autorise ; l'identifiant d'utilisateur par dfaut associ aux transferts.

diffrents paramtres contrlant l'excution des transferts, tels que :


o o

Les paramtres dfinissant les caractristiques physiques et le nom du fichier rcepteur sont pris en compte chaque nouveau transfert en rception, au dbut du transfert. Si CFT cre un nouveau fichier rcepteur : ces paramtres, condition d'tre explicitement dfinis, sont prioritaires sur les valeurs extraites (ou dduites) des messages protocolaires reus ; cependant, si une commande RECV locale est l'initiative du transfert en rception,

Manuel de rfrence

Transfert de fichiers

8-4

tout paramtre explicitement dfini associ cette commande est prioritaire sur les paramtres de la commande CFTRECV si la valeur du paramtre FORCE est FORCE = NO (pour tous les paramtres communs aux deux commandes, CFTRECV transmet uniquement RECV les valeurs par dfaut) ; ils ne sont pas pris en compte s'ils sont dfinis dans la commande CFTRECV et si la valeur du paramtre FORCE est FORCE = YES. La rgle de priorit suivante s'applique de manire globale : si FORCE = NO, les paramtres de la commande RECV sont prioritaires sur ceux de la commande CFTRECV ; si FORCE = YES, les paramtres de la commande CFTRECV sont prioritaires sur ceux de la commande RECV. Ces paramtres sont eux-mmes prioritaires sur les valeurs protocolaires reues qui sont elles-mmes prioritaires sur toute autre caractristique de fichier par dfaut fournie pour un systme quelconque, quel que soit le paramtrage de CFT ; si un fichier dj existant est rutilis pour recevoir les donnes d'un nouveau transfert, il est gnralement impossible de prendre en compte les nouvelles caractristiques de fichier. Le comportement "standard" de CFT consiste alors simplement vrifier que les nouvelles valeurs sont compatibles avec celles existantes ; si les donnes sont stockes dans une "enveloppe" dj existante (par exemple, lorsque CFT ajoute un nouveau membre un fichier partitionn existant), cette situation correspond intrinsquement un cas intermdiaire entre les deux prcdents : les nouvelles valeurs peuvent tre prises en compte pour certains paramtres mais pas pour d'autres. Le comportement de CFT dpend du systme. Pendant le transfert, le fichier reu peut tre stock dans un fichier temporaire qui est renomm la fin du transfert.

8.4 Cration du modle SEND par dfaut - CFTSEND


L'objet CFTSEND vous permet de spcifier les valeurs par dfaut pour : le nom et les caractristiques physiques locales du fichier envoyer ; les caractristiques rseau du fichier envoyer au partenaire ; les actions excuter localement pendant et aprs le transfert (transcodage, compression, appel d'un EXIT d'utilisateur, d'une procdure de fin de transfert, etc.) ; une plage temporelle autorise et l'utilisateur par dfaut associ aux transferts. Le nombre d'objets CFTSEND que vous pouvez crer dans le dossier Ongoing CFTSEND est illimit. Dans cette rubrique, vous allez crer un objet CFTSEND par dfaut. L'identifiant doit correspondre l'identifiant de fichier (IDF) ou, si ce paramtre n'est pas dfini, au paramtre par dfaut de l'objet CFTPARM. Certains objets par dfaut ne peuvent pas tre supprims. Ainsi, les objets CFTSEND, CFTRECV et CFTET par dfaut ne peuvent pas tre supprims s'ils sont utiliss par une autre configuration.

Manuel de rfrence

Transfert de fichiers

8-5

8.4.1

Paramtrage de la commande CFTSEND


Les caractristiques du paramtrage associ un fichier type pour des transferts en mission partir d'une base de donnes VFM sont dcrites dans une section spcifique la fin du prsent paragraphe.

8.4.1.1 Paramtres associs un fichier type L'objet CFTSEND contient des paramtres qui permettent de contrler l'accs aux donnes envoyer, ainsi que la procdure de transfert en mission. Une commande CFTSEND (sauf la commande default) contrle l'mission du fichier type ayant le mme identifiant (IDF identique l'ID de la commande CFTSEND). Cette commande est prise en compte dans un ou plusieurs des cas suivants : transfert en mission aprs une requte explicite de type SEND IDF = ... ; transfert en mission en utilisant le mcanisme SEND implicite qui traite automatiquement les requtes de rception envoyes sans avertissement d'un partenaire distant (mode serveur exclusivement) Pour couvrir ces deux cas pour un fichier type (IDF) donn, deux commandes CFTSEND ayant le mme ID sont requises : la premire contenant le paramtre IMPL = NO ; la seconde contenant IMPL = YES. La commande CFTSEND default s'applique pour sa part tous les autres fichiers types dans le cas d'une commande SEND explicite : elle est prise en compte lorsque le SEND IDF ne correspond aucune commande CFTSEND contenant IMPL = NO. Il est recommand de regrouper toutes les commandes CFTSEND dans un fichier de paramtrage source, en plaant la commande CFTSEND "default" en premire ou dernire position. La commande CFTSEND permet de spcifier, pour chaque fichier type (IDF) : le nom et les caractristiques physiques locales du fichier contenant les donnes envoyer. Au dbut d'un transfert en mission, ces paramtres sont utiliss par CFT : pour contrler l'accs aux donnes envoyer. Dans ce cas, seules les caractristiques du fichier qui ne varient pas d'un transfert l'autre et que CFT ne peut pas localiser automatiquement, sont gnralement spcifies. Par exemple, lorsque le mme nom physique local de fichier est toujours associ au fichier type (IDF), il est logique de spcifier ce nom en indiquant un paramtre FNAME dans la commande CFTSEND ; o en tant que valeurs par dfaut pour les caractristiques "rseau" du fichier si ces valeurs ne sont pas explicitement spcifies (voir ci-dessous) ; les caractristiques "rseau" du fichier : valeur envoyer au partenaire, dans des paramtres protocolaires, pour dcrire le fichier (un nom de fichier physique peut mme tre envoy).
o

Les caractristiques physiques que CFT peut localiser automatiquement pour le fichier local peuvent tre considres comme des valeurs par dfaut pour les paramtres CFT SEND correspondants (exemple : longueur d'enregistrement local : FLRECL), les paramtres tant eux-mmes constitus de valeurs par dfaut pour les caractristiques rseau (exemple : longueur d'enregistrement envoye au partenaire : NLRECL).

Manuel de rfrence

Transfert de fichiers

8-6

Lorsque le transfert est explicitement dclench par une commande SEND locale contenant un ou plusieurs paramtres qui sont galement inclus dans la commande CFTSEND, selon la valeur du paramtre FORCE : si FORCE = NO, les paramtres de la commande SEND sont prioritaires sur les paramtres de la commande CFTSEND (pour tous les paramtres communs aux deux commandes, la commande CFTSEND transmet uniquement les valeurs par dfaut la commande SEND) ; o si FORCE = YES, les paramtres de la commande CFTSEND sont prioritaires sur les paramtres de la commande SEND ; les actions excuter localement :
o

appel en cas de transfert une tche "EXIT de type fichier" crite par l'utilisateur ; o action excuter sur les donnes traites par le moniteur pendant le transfert (transcodage, compression) ; o action excute par le moniteur sur le fichier envoy, aprs le transfert ; o appel d'une procdure excuter la fin du transfert, etc ; diffrents paramtres contrlant l'excution des transferts, tels que :
o o o

plage temporelle autorise ; identifiant d'utilisateur par dfaut associ aux transferts.

8.4.2

A propos des paramtres SEND par dfaut


Cette section dcrit les catgories de paramtres SEND : protection des paramtres contenant des valeurs : FORCE ; Paramtres d'identification : gnraux : ID, USERID, GROUPID ; o associs au protocole PeSIT (profil SIT, PeSIT D profil CFT ou PeSIT E) : RAPPL, SAPPL ; o associs au protocole PeSIT (PeSIT D profil CFT ou PeSIT E) : RUSER, SUSER ; paramtres libres pour l'utilisateur CFT :
o

envoys au rcepteur : PARM, SPART ; usage local : COMMENT, OPERMSG, DELETE, NOTIFY ; paramtres de contrle d'excution :
o o

gnraux : IMPL, STATE, PRI ; utilisateur : EXEC, EXIT ; o gestion de l'ordonnancement : MINDATE, ...TCYCLE ; paramtres de traitement des donnes : NCOMP, XLATE ;
o o

paramtres associs au fichier envoy : gestion de fichier : FACTION ; o nom physique : FNAME ; o caractristiques physiques (fichier complet) : FSPACE, FORG, FTYPE, FCODE, FDISP ; o caractristiques physiques (enregistrements) : FRECFM, FLRECL, FBLKSIZE ; paramtres de fichier pour le partenaire, en fonction du protocole :
o o o o

nom physique : NFNAME ; caractristiques physiques (fichier complet) : NSPACE, NTYPE, NCODE ; caractristiques physiques (enregistrements) : NRECFM, NLRECL, NBLKSIZE, NKEYLEN, NKEYPOS.

Manuel de rfrence

Transfert de fichiers

8-7

Concernant les paramtres de fichier pour le partenaire (Nxxxxx de SEND et CFTSEND) : les paramtres sont facultatifs ; ils servent fixer les valeurs des informations envoyes (nom de fichier et/ou caractristiques physiques) lorsqu'ils sont dfinis dans les units de messages FPDU du protocole utilis (ou du profil protocolaire utilis) ; ces informations sont utilises par le moniteur rcepteur et les valeurs envoyes doivent tre valides du ct du partenaire rcepteur.

8.4.3

Emission d'un fichier


Si aucune commande CFTSEND n'est associe un identifiant ID = FI, les caractristiques par dfaut indiques dans la commande CFTSEND ID = <dfaut> servent, si ncessaire, complter celles indiques dans la commande SEND.

8.5 Tables de transcodage - CFTXLATE


L'objet CFTXLATE permet de dfinir des tables de transcodage entre deux alphabets pour : un sens de transfert ; un type de code de donnes de fichier (FCODE : ASCII ou EBCDIC) ; un type de code de donnes "rseau" (NCODE : ASCII ou EBCDIC). Chaque table est cre en utilisant un fichier (FNAME) contenant un enregistrement unique 256 caractres, dans lequel chaque caractre dfinit, par sa position et sa valeur, la correspondance entre les deux alphabets.

8.5.1

Transcodage
Le caractre "s" prend la valeur "t". "s" est la valeur du caractre de l'alphabet "source" ; "t" est la valeur du caractre de l'alphabet "cible" correspondant. Le premier caractre est en position 0. Exemple : Le caractre ayant la valeur dcimale 64 en position 32 correspond, dans une table ASCIII - EBCDIC, la conversion du caractre blanc (espace) ASCII (valeur 32) en caractre blanc EBCDIC (valeur 64). Pour les transferts en mission, le moniteur convertit FCODE en NCODE. Pour les transferts en rception, le moniteur convertit NCODE en FCODE. Si DIRECT = SEND (ou = BOTH), le fichier (FNAME) contient la description de la table de transcodage pour l'mission (FCODE en NCODE), et si DIRECT = RECV (ou = BOTH), il contient la description de la table de transcodage pour la rception (NCODE en FCODE). Cette table est utilise si l'une des conditions suivantes est satisfaite, dans l'ordre de priorit indiqu : l'identifiant de table a t indiqu dans la commande SEND/CFTSEND (SEND XLATE = identifier) ou dans la commande RECV/CFTRECV ; l'identifiant de table a t indiqu dans la commande CFTPART

Manuel de rfrence

Transfert de fichiers

8-8

(CFTPART XLATE = identifier) ; l'identifiant de table est l'identifiant par dfaut du moniteur CFT (CFTPARM DEFAULT = identifier) ; et si toutes les conditions suivantes sont satisfaites :
o o o

le sens de transfert correspond au paramtre DIRECT ; le code de donnes spcifi pour ce fichier figure dans le paramtre FCODE ; le code de donnes du rseau figure dans le paramtre NCODE.

Une table de transcodage peut tre cre et utilise entre 2 ordinateurs utilisant chacun un alphabet ASCII diffrent (FCODE = ASCII et NCODE = ASCII). Les valeurs des 2 tables de transcodage internes des moniteurs CFT (ASCII -> EBCDIC et EBCDIC -> ASCII) sont dcrites dans l'annexe du manuel. Il est possible de dfinir une table de transcodage pour un alphabet rduit. Les caractres invalides sont associs au caractre <SUPPR> de l'alphabet cible (0x7f pour une table de transcodage EBCDIC -> ASCII ou 0x07 pour une table de transcodage ASCII -> EBCDIC).

8.5.2

Phase de transfert de donnes


Cette section dcrit les fonctions de CFT pendant la phase de transfert de donnes :

8.5.2.1 Transcodage Pour communiquer avec un ordinateur ayant un code interne diffrent, CFT dispose de mcanismes de transcodage ASCII/EBCDIC qui utilisent les paramtres dcrits cidessous. Le transcodage s'applique des donnes alphanumriques. Ce transcodage peut tre appliqu "EN LIGNE" aux donnes envoyes (c'est--dire au fur et mesure que la transmission progresse), ou "HORS LIGNE" un fichier quelconque en utilisant la commande COPYFILE. Le transcodage peut tre ralis lors de l'mission ou de la rception d'un fichier, quel que soit le protocole utilis. Sa mise en oeuvre tient compte : du paramtrage du moniteur ; du fait que tout protocole envoie ou impose le code des donnes achemines. CFT ralise un transcodage en ligne des donnes alphanumriques envoyes, en appliquant les principes indiqus ci-dessous. Le transcodage est ralis sur la base des critres de transfert suivants : sens de transfert (mission ou rception) ; codage des donnes du fichier (paramtre FCODE : ASCII ou EBCDIC) ; codage des donnes en ligne (paramtre NCODE : ASCII ou EBCDIC) ; identifiant de table de transcodage (paramtre XLATE). Si les deux codes de donnes, FCODE et NCODE, ne sont pas BINAIRES, un transcodage peut avoir lieu et le moniteur recherche la table de transcodage correspondant aux critres de transfert. Un transcodage ASCII/ASCII ou EBCDIC/EBCDIC est donc galement possible. L'identifiant de table de transcodage XLATE peut tre explicite dans les commandes SEND (ou RECV), CFTSEND (ou CFTRECV) ou CFTPART, ou implicite. Il s'agit alors de la valeur du paramtre DEFAULT de la commande CFTPARM.

Manuel de rfrence

Transfert de fichiers

8-9

CFT tient compte, par ordre de priorit, de la valeur du paramtre XLATE dans les commandes suivantes : SEND ou RECV ; CFTSEND ou CFTRECV ; CFTPART ; ou la valeur par dfaut. La commande CFTXLATE permet de spcifier des tables de transcodage dfinies par l'utilisateur, qui tablissent des relations entre deux alphabets quelconques composs de 256 caractres. Par dfaut, CFT dispose de 4 tables de transcodage ASCII/EBCDIC pour chaque sens de transfert, ces tables tant bijectives. L'identifiant de ces tables est la valeur du paramtre DEFAULT de la commande CFTPARM. Il est nanmoins possible de remplacer, modifier ou supprimer ces tables internes en utilisant des commandes CFTXLATE ayant cet identifiant. Lorsque le moniteur ne trouve aucune table associe pour les 4 critres de transfert cits ci-dessus, il recherche la table par dfaut (valeur du paramtre DEFAULT de la commande CFTPARM, pour le paramtre XLATE). Si les valeurs des paramtres FCODE et NCODE diffrent, CFT doit rechercher une table de transcodage lgale. Il est donc interdit de supprimer une table de transcodage par dfaut. Dans le cas d'une commutation de fichier ralise par un partenaire, il n'y a aucun transcodage sur le site intermdiaire. Il est galement possible de dfinir une table de transcodage pour un alphabet "rduit". Les caractres qui ne doivent pas tre traduits en caractres spcifiques sont convertis en caractre <SUPPR> (0x7F en ASCII ou 0x07 en EBCDIC). Un caractre ainsi traduit n'apparat donc pas dans un diteur de texte, par exemple. Cette fonctionnalit est par exemple utilise pour les textes caractres cods sur 7 bits. L'exemple suivant dcrit un paramtrage utilis sur un ordinateur ASCII pour obtenir un transcodage EBCDIC non-standard en utilisant une table externe. Exemple de paramtrage pour un transcodage EBCDIC non standard sur un ordinateur ASCII

8.5.2.2 Compression La compression s'applique des donnes alphanumriques et binaires. Elle peut tre applique EN LIGNE aux donnes envoyes (c'est--dire au fer et mesure que la transmission progresse), ou HORS LIGNE un fichier quelconque.

Manuel de rfrence

Transfert de fichiers

8-10

La commande COPYFILE de l'utilitaire CFT permet de compresser ou de dcompresser un fichier. Les paramtres SCOMP et RCOMP de la commande CFTPROT dfinissent les valeurs maximales autorises pour les compressions de donnes en ligne, pour chaque protocole, pour les modes d'mission et de rception respectivement. Le paramtre NCOMP des commandes SEND et RECV dfinit la compression en ligne souhaite pour transfrer le fichier concern. Il n'est pas pris en charge par tous les protocoles. La compression relle applique pendant un transfert (NCOMP du poste de catalogue) rsulte de l'union logique du protocole SCOMP (ou RCOMP) et du fichier NCOMP, puis d'une ngociation entre les deux partenaires. Lors de l'envoi du fichier, les donnes sont compresses en ligne, en fonction de la valeur de compression relle, puis sont dcompresses de la mme manire lors de la rception du fichier. Cette dcompression est applique quel que soit l'tat de compression initial des donnes dans le fichier envoy. Les donnes envoyes et reues sont donc ncessairement dans le mme tat de compression. Paralllement, il est uniquement possible de transcoder des donnes dcompresses. Par consquent, lorsque le fichier envoyer est compress hors ligne, le transcodage doit tre dsactiv en spcifiant, par exemple, NCODE=BINARY dans les dfinitions CFTSEND et CFTRECV associes.

8.6 Scurit des changes SSL - CFTSSL


Le but de la scurit des changes est d'assurer la confidentialit et l'intgrit des changes, lorsque cela est ncessaire et lgal, ainsi que l'identification et l'authentification des messages changs. Le protocole synchrone SSL (Secure Sockets Layer) met en uvre des mcanismes de scurisation des transferts de fichiers ou de messages, indpendamment du protocole et du type de rseau. Il se compose de deux couches, la couche "Record" et la couche "Handshake". La couche "Record", la plus basse, s'appuie sur les couches rseaux TCP/IP, X25 et LU0 lorsqu'elles existent. Elle permet "l'encapsulation" des protocoles de plus haut niveau (PeSIT, ODETTE, FTP, ) et la mise en uvre de la fragmentation, la compression, le chiffrement/scellement des messages protocolaires. La couche "Handshake" assure le contrle de l'authentification des intervenants et la ngociation des paramtres de chiffrement et de scellement, avant tout change de donnes, entre les applications utilisatrices. Il peut y avoir trois types d'authentifications entre les intervenants : pas d'authentification ; l'authentification simple, o seul le serveur possde un certificat avec cl publique ; l'authentification rciproque o les deux intervenants disposent de certificats. La connexion est alors compltement scurise. Le certificat est l'quivalent d'une carte d'identit dans le systme de chiffrement avec cl publique de RSA (Rivest-Shamir-Adleman). Ce certificat est sign par une autorit dite de confiance qui garantit son authenticit.

Manuel de rfrence

Transfert de fichiers

8-11

Les caractristiques et la mise en uvre du protocole SSL ainsi que l'infrastructure cl publique sur lesquelles s'appuie le protocole SSL sont dcrits dans le "Guide de la scurit de transport". Remarque : SSL est une option, protge par la cl produit CFT. Assurez-vous que cette option scurit est accorde par la cl, avant de mettre en uvre SSL.

8.7 Excution des scripts - CFTCRON


La fonctionnalit CRONJOB permet dexcuter des scripts, comme par exemple : rechercher les fichiers nouveaux dans un rpertoire afin de les transfrer. Des exemples de script sont dlivrs avec le produit CFT et peuvent tre adapts pour des besoins spcifiques : Windows : exec\scandir.bat UNIX : filinst/scandir.cmd

8.7.1

Paramtrage dun CRONJOB

8.7.1.1 La commande CFTCRON La commande CFTCRON dfinit un script excuter par CFT. COMMAND CFTCRON USAGE MODE [CREATE|REPLACE|DELETE] *ID STRING max_length=32 COMMENT STRING max_length=80 *CRONTAB STRING max_length=32 *EXEC string max_length=512 PARM string max_length=512 *TIME string max_length=512 TYPE [EXEC] 'EXEC','CFTUTIL' USERID string max_length=32 Plusieurs commandes CFTCRON peuvent tre cres avec la mme valeur du paramtre CRONTAB. 8.7.1.2 La commande CFTPARM Le paramtre CRONTABS dclare la liste des travaux que CFT doit excuter. Il faut renseigner les valeurs des paramtres CRONTAB des commandes CRONJOB. Remarque : le paramtre CRONTABS ne fait pas rfrence au paramtre ID des commandes CFTCRON. 8.7.1.3 La commande RECONFIG TYPE = CRON Cette commande actualise les commandes CRONJOB dans le moniteur CFT. Elle est utile lorsquune commande CFTCRON est modifie, cre ou supprime. Remarque : cette commande ne prend pas en compte une modification du paramtre CRONTABS de la commande CFTPARM. Il faut dans ce cas redmarrer CFT.

Manuel de rfrence

Transfert de fichiers

8-12

8.7.1.4 La commande MQUERY NAME = CRON Cette commande affiche dans la Log de CFT les commandes CRONJOB actives. Exemple 1 La commande suivante: CFTUTIL CFTCRON id=CRON1, crontab=CRONTAB1, EXEC=my_exec, time='m=*/10' ... cre le script my_exec excuter toutes les 10 minutes lorsque CFT est actif. Si CFT est dmarr 11:44 la premire excution sera programme 11:50. Exemple 2 Syntaxe du paramtre TIME: notez que la syntaxe est sensible la casse. Par exemple, un m minuscule dfinit des minutes, alors qu'un M majuscule dfinit des mois. 8.7.1.5 Messages Les messages relatifs la fonctionnalit CRONJOB sont : CFTI36I &str : message dinformations relatif aux chargements des commandes CRONJOB ; CFTI38E &str : messages derreurs relatif aux chargements des commandes CRONJOB ; CFTS37I &str : message dinformations relatif a lexcution des commandes CRONJOB ; CFTS39E &str : messages derreurs relative a lexcution.

8.7.2

tats de transfert
Etat C: D: H: Signification Le transfert est en cours (Current). Le transfert est disponible (at Disposal) et sera dclench automatiquement ds que les ressources de CFT et les autorisations d'accs du partenaire le permettront. Le transfert est en attente (on Hold) l'initiative de l'initiateur du transfert, d'un oprateur (commande HALT) ou du moniteur suite un incident. Le transfert peut tre relanc par l'oprateur ou le partenaire distant. Le transfert est en attente (on Kept) l'initiative de l'initiateur du transfert, d'un oprateur (commande Keep) ou du moniteur suite un incident. Le transfert ne peut tre relanc que par l'oprateur. Le transfert s'est termin correctement (Terminated). Toutes les oprations de fin de transfert ont t eXcutes correctement et CFT a t averti via la commande END.

K:

T: X:

8.8 Commutation
8.8.1

Commutation de secours
Quatre conditions sont requises pour acheminer un fichier (voir la figure Exemple de cette section) : l'metteur initial A est capable d'tablir une connexion au site de commutation B (CFTPART ID=ID_B,... CFTX25 ID=ID_B,...) ;

Manuel de rfrence

Transfert de fichiers

8-13

le site de commutation B est capable de recevoir une connexion provenant de l'metteur initial A (CFTPART ID=ID_A,...) CFTX25 ID=ID_A,...) (paramtre COMMUT=YES par dfaut) ; le site de commutation B est capable d'tablir une connexion l'metteur final C (CFTPART ID=ID_C,.. CFTX25 ID=ID_C,...) ; le rcepteur final C est capable de recevoir une connexion provenant du site de commutation B (CFTPART ID=ID_B,... CFTX25 ID=ID_B,...). Le rcepteur final C connat l'metteur initial du fichier (CFTPART ID=ID_A). Pour l'exemple de commutation de secours suivant, pour un rcepteur final C donn (SEND PART=ID_C, par exemple), aucune connexion directe ce destinataire n'a pu tre tablie aprs la squence de tentatives de rappel dfinie dans le paramtrage associ ce destinataire. Le paramtre IPART de la commande CFTPART dfinit le partenaire intermdiaire B (IPART=ID_B) par le biais duquel le transfert doit transiter. Ce paramtre est alors le partenaire immdiat de l'metteur. Exemple de commutation de secours

Manuel de rfrence

Transfert de fichiers

8-14

8.8.2

Commutation intentionnelle
Cette section dcrit un exemple de commutation intentionnelle. Quatre conditions sont requises pour acheminer le fichier : l'metteur initial A est capable d'tablir une connexion au site de commutation B (CFTPART ID=ID_B,... CFTX25 ID=ID_B,...) ; le site de commutation B est capable de recevoir une connexion provenant de l'metteur initial A (CFTPART ID=ID_A,...) CFTX25 ID=ID_A,...) ; le site de commutation B est capable d'tablir une connexion l'metteur final C (CFTPART ID=ID_C,.. CFTX25 ID=ID_C,...) (paramtre COMMUT=YES par dfaut) ; le rcepteur final C est capable de recevoir une connexion provenant du site de commutation B (CFTPART ID=ID_B,... CFTX25 ID=ID_B,...). Le rcepteur final C connat l'metteur initial du fichier (CFTPART ID=ID_A). Sur la figure de l'exemple de cette section, pour un rcepteur final C donn (SEND PART=ID_C,...), les valeurs nulles des paramtres OMINTIME et OMAXTIME de la commande CFTPART associe forcent le routage du fichier par le partenaire intermdiaire. Ce partenaire immdiat de l'metteur initial est dfini par le paramtre IPART (IPART=ID_B). Remarque : si l'metteur initial A n'est pas contraint d'tablir une connexion physique directe au rcepteur final C, saisissez alors le paramtrage pour A dans la commande CFTX25ID=ID_C. De manire similaire, il n'est pas ncessaire de paramtrer CFTX25 ID=ID_A pour le rcepteur final C. Commutation intentionnelle

Manuel de rfrence

Transfert de fichiers

8-15

8.8.3

Commutation VAN intentionnelle


Les mmes conditions que celles indiques au paragraphe Commutation intentionnelle sont requises pour tablir le routage. Pour que le site de commutation soit en mode VAN, compltez les paramtres de commutation de la manire suivante : CFTPART ID=ID_A,COMMUT=SERVER,... Dans l'exemple de commutation ci-dessous, la procdure identifie par myproc inclut la commande suivante la fin du traitement : CFTUTIL SEND PART= &RPART, SPART= &SPART, FNAME= &FNAME, IDF= &IDF Aprs remplacement des variables symboliques : CFTUTIL SEND PART=ID_C,SPART=ID_A,FNAME=frecv,IDF=test. Les indications suivantes doivent tre trouves la fin du transfert : dans le catalogue de l'metteur initial : Etat : SFT o PART : ID_C o IDF : test dans le catalogue du site de commutation :
o

Etat : RFT PART : ID_A o IDF : test dans le catalogue du rcepteur final :
o o o o o

Etat : RFT PART : ID_A IDF : test

Remarque : si le rcepteur final souhaite envoyer un message de rponse (SEND TYPE = REPLY), les paramtres suivants doivent tre configurs (comme en mode COMMUTATION) conformment l'exemple ci-dessous : CFTPART IPART OMINTIME OMAXTIME = <intermediate site>, = 0, = 0, ...

Manuel de rfrence

Transfert de fichiers

8-16

Commutation VAN intentionnelle

8.8.4

Commutation force
Cette fonction, qui est uniquement valide dans le protocole PeSIT profil E, est utilise sur un site intermdiaire pour forcer le mode commutation sur un autre site sans connatre le partenaire final. Sur un site de commutation, il est donc ncessaire de dfinir un partenaire recevant la connexion entrante et un second partenaire tablissant la connexion avec le site suivant (galement intermdiaire ou le site final). Le lien entre le partenaire recevant la connexion et le partenaire metteur est tabli par le paramtre suivant : CFTPART CFTPART ID = IDRECEPT, COMMUT = PART, IPART = IDEMET, ID = IDEMET,

Le site initial tablit la connexion avec le site de commutation immdiate (CFTPART ID = IDNAT, NSPART = NINTNAT, NRPART = NNAT, etc.). Le site de commutation immdiate reoit la connexion provenant du site initial et force la commutation (COMMUT = PART) vers le partenaire indiqu (IPART = IDDEP). Ce processus est rpt autant de fois que ncessaire jusqu'au site final.

Manuel de rfrence

Transfert de fichiers

8-17

Commutation force

EXECRF SEND PART IPART PART IPART

= = = =

&PART, &IPART, NINTNAT, IDDEP2

La commande REPLY peut tre envoye lorsque la procdure de fin de transfert est excute (EXECRF). Le message d'acquittement est alors transfr de la mme manire, par le biais de tous les sites intermdiaires, jusqu' ce qu'il atteigne le site initial (IPART = ).

8.9 Transferts implicites


8.9.1

Transfert en lecture avec mission implicite


Il existe deux types d'missions implicites pour un transfert en lecture : mode ferm ; mode ouvert.

Manuel de rfrence

Transfert de fichiers

8-18

8.9.2

Transfert en lecture avec mission implicite en mode ferm


Ce mode est uniquement disponible avec les protocoles : ETEBAC3 ; PeSIT D profil EXTERN ; PeSIT D profil CFT ; PeSIT E. Un rcepteur/demandeur demande la rception d'un fichier type identifi par un IDF, en activant une commande RECV. Une commande de paramtrage implicite CFTSEND IMPL = YES a t dfini sur le serveur avec le mme IDF. Cet IDF correspond un fichier physique situ un emplacement indiqu dans le paramtre FNAME de cette commande. Le demandeur stocke le fichier reu sous le nom indiqu dans le paramtre FNAME de la commande RECV locale (ou, par dfaut, dans le paramtre de la commande CFTRECV). Le nom affect ct demandeur peut tre dfini explicitement ou peut tre dtermin en utilisant les variables symboliques dfinies la rception. Ct serveur, le nom du fichier envoyer peut galement tre dfini explicitement ou peut tre dtermin en utilisant les valeurs symboliques dfinies dans la requte d'mission. Sur la figure suivante, le nom attribu (FNAME = X) ct demandeur et le nom du fichier envoyer ct serveur (FNAME = Y) sont explicites. Transfert rcepteur/demandeur avec mission implicite : mode ferm - noms de fichiers explicites

Sur la figure suivante, le nom attribu ct demandeur est dfini en utilisant la variable symbolique &IDT qui permet de rcuprer l'identifiant associ au transfert en cours (transfert en protocole PeSIT, par exemple).

Manuel de rfrence

Transfert de fichiers

8-19

Transfert rcepteur/demandeur avec mission implicite : mode ferm - variable symbolique du ct demandeur

Sur la figure suivante, le nom du fichier envoyer ct serveur est dfini en utilisant la variable symbolique &PART qui permet de rcuprer l'identit du partenaire. Transfert rcepteur/demandeur avec mission implicite : mode ferm variable symbolique du ct serveur

8.9.3

Transfert en lecture avec mission implicite en mode ouvert


Ce mode est uniquement disponible avec les protocoles : PeSIT D profil CFT ; PeSIT E. Contrairement au mode de blocage en mission, le mode ouvert permet : a l'metteur/serveur d'imposer l'emplacement physique du fichier recevoir par le rcepteur/demandeur (mode ouvert ct demandeur) ; au rcepteur/demandeur d'imposer l'emplacement physique du fichier envoyer par le serveur (mode ouvert ct serveur).

Manuel de rfrence

Transfert de fichiers

8-20

Pour implmenter le mode ouvert ct demandeur : le serveur doit dfinir un nom physique utiliser ct demandeur pour stocker le fichier reu. Ce nom indiqu dans le paramtre NFNAME de la commande CFTSEND est communiqu par le protocole pendant le transfert ; le rcepteur/demandeur doit pouvoir utiliser le nom envoy. A cet effet, la valeur du paramtre FNAME de la commande RECV (ou, par dfaut, du paramtre de la commande CFTRECV) doit tre la variable symbolique &NFNAME. Cette variable symbolique est remplace par le nom de fichier envoy par l'metteur/serveur. L'emplacement physique du fichier envoyer par l'metteur/serveur est dfini par le paramtre FNAME de la commande CFTSEND. La valeur de ce paramtre peut tre explicite ou peut tre dfinie localement l'aide de variables symboliques. Remarque : Si un demandeur dfinit FNAME=&NFNAME et si le serveur n'a pas dfini NFNAME, ou inversement, le transfert choue et est interrompu. Si le serveur/metteur dfinit NFNAME et si le nom de fichier est prcd de "*", le demandeur/rcepteur peut utiliser le nom de son choix pour FNAME. Transfert rcepteur/demandeur avec mission implicite : mode ouvert - ct demandeur

Pour implmenter le mode ouvert ct serveur : le demandeur doit connatre l'emplacement physique du fichier qu'il souhaite recevoir. Ce nom est indiqu dans le paramtre NFNAME de la commande RECV activant la requte de rception et est communiqu par le protocole pendant cette requte ; l'metteur/serveur doit pouvoir utiliser le nom envoy. A cet effet, la valeur du paramtre FNAME de la commande CFTSEND doit tre la variable symbolique &NFNAME. Cette variable symbolique est remplace par le nom de fichier envoy par le rcepteur/demandeur. L'emplacement physique du fichier reu par le demandeur est dfini localement par le paramtre FNAME de la commande RECV (ou, par dfaut, par le paramtre de la commande CFTRECV). La valeur de ce paramtre peut tre explicite ou peut tre dfinie localement l'aide de variables symboliques (voir paragraphe prcdent). Remarque : Si un demandeur dfinit NFNAME et si le serveur n'a pas dfini FNAME = &NFNAME, ou inversement, le transfert choue et est interrompu.

Manuel de rfrence

Transfert de fichiers

8-21

Transfert rcepteur/demandeur avec mission implicite : mode ouvert - ct serveur

Ces deux mcanismes peuvent tre implments en mme temps : l'metteur/serveur peut imposer l'emplacement physique du fichier recevoir par le rcepteur/demandeur (mode ouvert ct demandeur) ; le rcepteur/demandeur peut imposer l'emplacement physique du fichier envoyer par le serveur (mode ouvert ct serveur). Ce mcanisme est reprsent sur la figure suivante. Transfert rcepteur/demandeur avec mission implicite : mode ouvert cts demandeur et serveur

Manuel de rfrence

Transfert de fichiers

8-22

8.10 Gestion des fichiers de CFT


8.10.1 mission d'un fichier
Les processus de gestion que CFT utilise lors de l'mission de fichiers sont dcrits cidessous. Pendant la phase de slection des fichiers : vrification de la mise disposition des fichiers CFT vrifie que le fichier envoyer n'a pas t bloqu par une autre application. Si tel est le cas : en mode demandeur, le poste de catalogue correspondant au transfert reste l'tat D, DIAGI=135. Une nouvelle tentative de transfert est effectue aprs WSCAN (voir commande CFTCAT) minutes sans incrmenter la squence RETRY ; o en mode metteur/serveur, le poste de catalogue correspondant au transfert passe l'tat H. Le moniteur envoie au partenaire un code de diagnostic protocolaire indiquant un conflit d'accs un fichier. Dans ce cas, le poste de catalogue du moniteur rcepteur/demandeur recevant ce code passe l'tat H, DIAGI=635 ; calcul de la taille relle du fichier envoy (en fonction des systmes et du protocole utiliss) :
o o

la taille est utilise des fins d'allocation dynamique ct rcepteur.

A la fin de la phase de transfert : action sur le fichier envoy : suppression ou remise zro du fichier, ou aucune action du tout (voir paramtre FACTION de la commande CFTSEND/SEND).

8.10.2 Rception de fichiers


Les processus de gestion que CFT utilise lors de la rception de fichiers sont dcrits cidessous. Pendant la phase de slection des fichiers : vrification de l'existence des fichiers (paramtre FDISP) et actions associes (paramtre FACTION) ; utilisation d'un fichier de stockage temporaire ; si le fichier de rception a t cr avant le transfert, la mise disposition de ce fichier est vrifie ; si le fichier n'a pas t cr, l'espace disque requis pour stocker le fichier reu est dynamiquement allou ; sur certains systmes : un rpertoire est implicitement cr avant que le fichier de rception ne soit cr (voir Cration implicite de rpertoires). A la fin de la phase de transfert : si un fichier de stockage temporaire a t utilis, le nom du fichier rel est affect ce fichier temporaire.

Manuel de rfrence

Transfert de fichiers

8-23

Les paragraphes ci-dessous dcrivent les mcanismes et procdures suivants : ct rcepteur, les mcanismes de vrification et la procdure pour grer le fichier reu pendant la phase de slection des fichiers ; cts metteur et rcepteur, le mcanisme d'allocation dynamique de l'espace disque requis pour stocker le fichier reu.

8.10.3 Stockage des donnes


Les donnes reues peuvent tre stockes : directement dans un fichier d'utilisateur dont le nom est dfini par le paramtre FNAME ou dans un fichier temporaire dont le nom est dfini par le paramtre WFNAME et remplac la fin de la rception par le nom utilis pour l'opration (paramtre FNAME). Cette mthode vrifie l'intgrit du fichier reu : le fichier est uniquement disponible la fin du transfert. Pendant le transfert, une application ne peut pas s'approprier le fichier temporaire. 8.10.3.1

Stockage direct des donnes

Lorsque les donnes sont directement stockes dans un fichier d'utilisateur, les tapes ou contrles suivants sont excuts : 1. Vrification de l'existence du fichier FNAME. Cette opration est effectue en utilisant le paramtre FDISP qui peut prendre l'une des 3 valeurs suivantes : FDISP = FDISP = o FDISP = Si le fichier
o o

NEW : vrifie que le fichier FNAME n'existe pas ; OLD : vrifie que le fichier FNAME existe ; BOTH : aucune vrification. FNAME existe dj et si : NEW : le transfert est refus ; OLD : le transfert passe la phase 2 ; BOTH : le transfert passe la phase 2. FNAME n'existe pas et si :

FDISP = FDISP = o FDISP = Si le fichier


o o o o o

FDISP = NEW : le transfert passe la phase 3 ; FDISP = OLD : le transfert est refus ; FDISP = BOTH : le transfert passe la phase 3.

2. Etapes excutes en cas de fichier FNAME existant. Les tapes possibles sont dfinies en utilisant le paramtre FACTION qui peut prendre l'une des valeurs suivantes :
o o o

FACTION = DELETE : supprime le fichier FNAME existant ; FACTION = ERASE : rinitialise le fichier FNAME existant ; FACTION = VERIFY : vrifie que le fichier FNAME existant est vide.

Si ce fichier n'est pas vide : le transfert est refus. 3. Mise disposition du fichier :
o o

si le fichier FNAME n'existe pas, il est cr ; le fichier FNAME est allou et ouvert.

Manuel de rfrence

Transfert de fichiers

8-24

8.10.3.2

Stockage des donnes dans un fichier temporaire


Lorsque les donnes sont stockes dans un fichier temporaire WFNAME, les mmes tapes et phases de vrification sont excutes. Pour utiliser ce fichier temporaire, le fichier FNAME qui sert le renommer la fin du transfert ne doit plus exister au dbut de la phase 3. Pour satisfaire cette exigence, le traitement des phases 1 et 2 devient :

1. Vrification de l'existence du fichier FNAME. Si le fichier FNAME existe dj et si : FDISP = o FDISP = o FDISP = Si le fichier
o o o o

NEW : le transfert est refus ; OLD : le transfert passe la phase 2 ; BOTH : le transfert passe la phase 2. FNAME n'existe pas et si :

FDISP = NEW : le transfert passe la phase 3 ; FDISP = OLD : le transfert est refus ; FDISP = BOTH : le transfert passe la phase 3.

2. Etapes excutes en cas de fichier FNAME existant :


o o o

FACTION = DELETE : le fichier FNAME existant est supprim. FACTION = ERASE : le transfert est refus. FACTION = VERIFY : le transfert est refus.

3. Les vrifications et traitements suivants sont effectus :


o

le moniteur vrifie que le fichier WFNAME n'existe pas. S'il existe, le transfert est refus ; le fichier temporaire WFNAME est cr, allou et ouvert.

A la fin de la phase de transfert, ce fichier temporaire est ferm et affect du nom indiqu dans le paramtre FNAME.

8.10.4 Allocation dynamique de l'espace disque ct rcepteur


UNIX, WinNT : ces systmes ne permettent pas ce type d'allocation. Avant de recevoir un fichier, le moniteur CFT rcepteur tente d'allouer l'espace disque requis en se basant sur la taille connue du fichier recevoir. Ct metteur, le paramtre FSPACE de la commande SEND dfinit la taille du fichier envoyer. Le paramtre NSPACE de la commande SEND dfinit la taille imposer au fichier de rception, du ct du partenaire. Si ce paramtre n'est pas dfini, il prend la valeur du paramtre FSPACE. Ce mcanisme n'est pas utilis pour tous les protocoles. En rgle gnrale, le paramtre FSPACE ne doit pas tre dfini car pour chaque transfert, le moniteur CFT identifie automatiquement la taille du fichier envoyer (pour voir si cette fonction est prise en charge, reportez-vous au Guide d'exploitation de CFT correspondant votre systme d'exploitation). Ct rcepteur, le paramtre FSPACE de la commande RECV dfinit la taille du fichier de rception. Si le protocole de transfert utilis achemine les informations relatives la taille des fichiers, il fournit la valeur du paramtre FSPACE de la commande CFTRECV lorsque ce paramtre n'est pas dfini (reportez-vous aux objets CFTSEND et CFTRECV). Avant d'activer le transfert, CFT s'assure que l'espace requis pour le fichier de rception est disponible.

Manuel de rfrence

Transfert de fichiers

8-25

8.10.5 Cration implicite de rpertoires


Dans le cas d'une cration de fichier par CFT ou par un utilitaire associ, c'est--dire la cration d'un fichier de rception ou d'un fichier service par le biais de la commande CFTFILE, cette opration peut tre prcde d'une cration de rpertoire. Selon l'environnement en question, l'utilisation d'un nom de chemin d'accs complet dans le paramtre FNAME peut implicitement entraner la cration de niveaux de rpertoires intermdiaires si ces derniers n'existent pas encore. Plus spcifiquement, un ou plusieurs sous-rpertoires infrieurs, voire tous les rpertoires d'un chemin d'accs complet, peuvent tre crs. Limitation dlibre : l'utilisateur peut limiter, voire totalement interdire, toute cration de rpertoire implicite. A cet effet, un caractre dlimiteur (indiqu par @ dans l'exemple, mais spcifique chaque systme) doit tre insr dans le nom du chemin d'accs et seuls les noms de rpertoires apparaissant droite du dlimiteur peuvent tre crs dynamiquement. Si le dlimiteur est plac juste devant le nom de fichier, aucun rpertoire ne peut tre cr. En gnral, ce caractre dlimiteur est positionn immdiatement aprs un sparateur. Exemple : FNAME = c:\d1\d2\@d3\d4\x.txt d3 et d4 peuvent tre crs de manire implicite, mais pas d1 ou d2.

8.11 Fichiers types et fichiers physiques


8.11.1 Types de modes de transfert
Pour chaque transfert, CFT peut fonctionner dans l'un des modes suivants : en mode demandeur : il est l'initiateur du transfert. En protocole PeSIT ou ETEBAC 3, l'initiateur d'une connexion rseau conserve le rle de demandeur pour le(s) transfert(s) effectu(s) en utilisant cette connexion ; en mode serveur : il accepte les requtes de transfert. En protocole PeSIT ou ETEBAC 3, CFT est galement l'accepteur de la connexion entrante. CFT peut jouer 4 rles : Emetteur/demandeur Rcepteur/demandeur Emetteur/serveur Rcepteur/serveur Selon le protocole utilis, deux modes de transfert peuvent ainsi tre grs : transferts entre un moniteur metteur/demandeur et un moniteur rcepteur/serveur : transfert metteur/demandeur ou transfert en criture, pour tous les protocoles ;

Manuel de rfrence

Transfert de fichiers

8-26

transferts entre un moniteur rcepteur/demandeur et un moniteur rcepteur/serveur : transfert rcepteur/demandeur ou transfert en lecture. Ce second mode peut uniquement tre utilis dans les protocoles suivants :
o o o o

ETEBAC 3 ; PeSIT D profil EXTERN ; PeSIT D profil CFT ; PeSIT E.

Chacun de ces modes appliqus un transfert de fichiers est reprsent sur la figure suivante. Mode de transfert de fichiers

Les fonctionnalits dcrites dans cette rubrique concernent uniquement les transferts (mission ou rception) de FICHIERS.

8.11.2 Qu'est-ce qu'un identifiant de fichier type ?


Pendant un transfert, CFT attribue un identifiant de fichier. Le fichier est identifi par un identifiant de fichier type appel "IDF". Un IDF peut tre assimil une classe logique contenant un ou plusieurs fichiers physiques. Par exemple, un service commercial peut quotidiennement envoyer ses commandes une unit de production dans un fichier type ORDERS. Dans ce cas, ORDERS est l'identifiant logique convenu entre les deux parties, les fichiers physiques contenant les commandes envoyes et reues, respectivement, sont grs indpendamment par les

Manuel de rfrence

Transfert de fichiers

8-27

deux partenaires, chacun pouvant notamment centraliser ou distribuer les donnes si ncessaire. L'IDF constitue la base de l'organisation de l'exploitation locale : contrle des transferts, convention de connexion entre les applications (liaison montante/descendante) et le moniteur CFT. Bien que l'IDF d'exploitation locale et l'IDF convenu avec le partenaire distant aient gnralement la mme valeur, il est possible d'utiliser des mcanismes de correspondance entre les identifiants locaux et les identifiants distants afin d'viter toute contrainte de dsignation. Les mcanismes dcrits dans ce chapitre supposent que l'IDF d'exploitation locale et l'IDF convenu entre les partenaires sont identiques. 8.11.2.1

Implmentation d'un transfert metteur/demandeur

L'environnement suivant permet d'implmenter un transfert en criture : Sur le site metteur/demandeur, la transmission en mission est active par une commande de transfert SEND. Les commandes suivantes sont associes cette commande : une commande de paramtrage CFTSEND ayant un identifiant identique l'IDF dfini dans la commande de transfert SEND. Les paramtres spcifis dans la commande CFTSEND peuvent tre prioritaire sur ceux dfinis dans la commande SEND (paramtre FORCE = YES). Dans ce cas, un message informe l'utilisateur que sa commande a t partiellement prise en compte ; si aucune commande CFTSEND n'a t dfinie, la commande CFTSEND ID=<default>, o <default> est la valeur par dfaut dfinie par le paramtre DEFAULT de CFTPARM. Cette transmission concerne le partenaire (serveur) indiqu dans le paramtre PART (voir Exemple de paramtrage dans Partenaire). Sur le site rcepteur/serveur, les caractristiques de rception sont gres en utilisant une commande de paramtrage CFTRECV ayant un identifiant identique l'IDF envoy par le demandeur dans la commande SEND. Si aucune commande CFTRECV n'a t dfinie avec un identifiant correspondant cet IDF, les caractristiques de cette rception sont gres en utilisant la commande CFTRECV ID = <default>, o <default> est la valeur par dfaut dfinie dans le paramtre DEFAULT de CFTPARM. Les mcanismes utiliss pour ce type de transfert sont rsums sur les figures suivantes. Implmentation d'un transfert metteur/demandeur (criture) - Paramtrage explicite

Manuel de rfrence

Transfert de fichiers

8-28

Implmentation d'un transfert metteur/demandeur (criture) - Paramtrage par dfaut

8.11.2.2

Implmentation d'un transfert rcepteur/demandeur

Cette fonctionnalit est uniquement disponible avec le protocole PeSIT et le profil SIT. L'environnement suivant permet d'implmenter un transfert en lecture : Sur le site rcepteur/demandeur, la rception est active par une commande de transfert RECV. Les commandes suivantes sont associes cette commande : une commande de paramtrage CFTRECV ayant un identifiant identique l'identifiant de fichier type dfini dans RECV (IDF) ; si aucune commande CFTRECV n'a t dfinie, la commande CFTRECV ID=<default>, o <default> est la valeur par dfaut dfinie par le paramtre DEFAULT de CFTPARM. Cette rception concerne le partenaire (serveur) indiqu dans le paramtre PART (voir Exemple de paramtrage dans Partenaire). Sur le site metteur/serveur, les caractristiques de transmission associes cette requte peuvent tre gres de deux manires, selon les contraintes d'exploitation : en utilisant une commande de blocage en mission pralablement enregistre dans le catalogue du serveur. Ce mode est activ par la commande de transfert SEND STATE=HOLD, le paramtre STATE=HOLD indiquant un transfert diffr (tat "H" du poste catalogue correspondant). En mode local, les commandes suivantes sont associes cette commande :
o

une commande de paramtrage CFTSEND ayant un identifiant identique l'identifiant de fichier type dfini dans SEND (IDF) ; si aucune commande CFTSEND n'a t dfinie, la commande CFTSEND ID=<default>, o <default> est la valeur par dfaut dfinie par le paramtre DEFAULT de CFTPARM. Cette transmission concerne le partenaire (demandeur) indiqu dans le paramtre PART (voir Exemple de paramtrage dans Partenaire) ;

en utilisant une mission implicite dfinie par une commande de paramtrage CFTSEND IMPL = YES. Ce mode implicite permet d'envoyer, en mode serveur, tout fichier autoris sans ncessiter de commande de blocage en mission. Le paramtrage par dfaut d'une commande CFTSEND est explicite (IMPL = NO). A la rception d'une requte de transfert, le moniteur : slectionne d'abord les commandes de blocage en mission (le cas chant) ; puis les commandes d'mission implicite.

Manuel de rfrence

Transfert de fichiers

8-29

Les figures suivantes rsument les mcanismes utiliser pour ce type de transfert, en fonction du mcanisme de contrle d'mission implment ct serveur. Implmentation d'un transfert en lecture, bloqu en mission ct serveur

Implmentation d'un transfert en lecture avec mission implicite ct serveur

8.11.3 Emplacements des fichiers


Les emplacements des fichiers physiques sont normalement grs localement, les caractristiques de transfert tant dfinies pour chaque partenaire en utilisant une convention de dsignation des IDF et de type de donnes commune. Ce mode de gestion des fichiers est appel "mode ferm". En protocole PeSIT D profil CFT et PeSIT E, CFT permet galement un partenaire de grer cet emplacement de fichier physique distance. Ce mode de gestion est appel "mode ouvert". Les exigences d'implmentation de ces deux modes sont dcrites pour chacun des mcanismes dcrits au paragraphe prcdent, dans la rubrique Emplacement des fichiers physiques. Sur les systmes MVS et VMS, plusieurs versions d'un fichier logique donn peuvent tre gres. Dans MVS, ces fichiers sont couramment appels "fichiers de type GDG" (groupe de fichiers classs par ordre chronologique). L'accs ce type de fichier peut s'effectuer par un nom absolu ou par un nom relatif constitu d'une racine et d'un numro de version. Le transfert d'un fichier dsign par un nom absolu n'engendre aucune particularit. D'autre part, lorsque le fichier envoy ou reu est dsign par un nom relatif, le moniteur CFT recherche systmatiquement le nom absolu correspondant pour s'assurer de pouvoir retourner les mmes donnes en cas d'incident. En effet, si le nom relatif initial est utilis au redmarrage d'un transfert, il y a un risque d'accs des donnes diffrentes (un changement de version peut s'tre produit dans l'intervalle). Du ct metteur, le nom absolu est dtect ds que la requte d'mission est faite.

Manuel de rfrence

Transfert de fichiers

8-30

8.11.4 Fichiers logiques VFM


VFM est une mthode d'accs logique qui simule la gestion des fichiers dans un espace disque pr-allou. Cet espace disque comporte deux fichiers rels connus du systme d'exploitation : un fichier d'index ; un fichier de donnes. Lorsqu'un fichier logique VFM est cr, une entre est ajoute dans le fichier d'index rel. Lorsque des donnes sont insres dans un fichier logique VFM, les enregistrements sont mis jour dans le fichier de donnes rel. En plus de ces fonctions de base, VFM fournit diffrents services tels que : le stockage des donnes sous forme compresse ; la concatnation des donnes dans un fichier logique spcifique ; la gestion des versions dans un fichier logique spcifique (rotation pour les GDG) ; la gestion des accs simultans par un blocage exclusif ou partag. L'utilitaire VFMUTIL fournit des commandes de gestion des fichiers logiques. Pour plus d'informations sur la mthode VFM, reportez-vous au guide CFT Prsentation de la mthode d'accs VFM.

8.11.5 Requte pour transfrer plusieurs fichiers physiques


Comme expliqu au paragraphe Utilisation de l'identifiant de fichier type, un mme IDF peut dsigner plusieurs fichiers physiques. Les mcanismes ci-dessous, dj dcrits dans les chapitres prcdents, permettent de grer cette possibilit. Pour les transferts metteur/demandeur, l'activation des commandes SEVERAL SEND ayant le mme IDF. Les caractristiques de rception sont alors gres ct serveur par une seule commande de paramtrage CFTRECV ayant le mme IDF que celui envoy par le demandeur (ou l'IDF par dfaut) (voir chapitre prcdent). Pour les transferts rcepteur/demandeur, l'enregistrement par le serveur en mode de blocage en mission des commandes SEVERAL SEND STATE = HOLD ayant le mme IDF. Pour recevoir tous les fichiers associs au mme IDF, le demandeur doit activer autant de commandes RECV qu'il existe de commandes de blocage en mission ct serveur ; l'activation d'une commande RECV identifie par un IDF EXPLICITE dbloque le PREMIER transfert ct serveur. Remarque : cette possibilit n'existe pas en mode d'mission implicite qui est dfini en utilisant une commande de paramtrage ayant un identifiant unique. Pour faciliter l'utilisation de cette fonctionnalit, le moniteur permet : de recevoir tous les fichiers ayant le mme IDF en mode de blocage en mission au niveau du serveur en utilisant UNE SEULE commande ct rcepteur/demandeur ; d'envoyer plusieurs fichiers avec le mme IDF en utilisant UNE SEULE commande ; de consulter le contenu d'un rpertoire distant.

8.11.6 Rception d'un groupe de fichiers ayant le mme IDF en mode

rcepteur/demandeur
ETEBAC3, PeSIT D profil EXTERN, PeSIT D profil CFT, PeSIT E Cette fonctionnalit est uniquement disponible avec les protocoles susmentionns.

Manuel de rfrence

Transfert de fichiers

8-31

Ce mcanisme permet de recevoir tous les fichiers ayant le mme IDF uniquement en mode de blocage en mission ct serveur, par une seule activation de la commande RECV. Pour implmenter ce mcanisme, la valeur du paramtre FILE de la commande RECV, ct demandeur, doit tre gale la valeur ALL prdfinie (FILE = ALL). Les transferts ne peuvent pas avoir lieu en mme temps. PeSIT D profil CFT, PeSIT Les requtes de transfert sont traites squentiellement ds qu'un transfert est termin. Ce type de transfert gnre, dans le catalogue du demandeur, un poste gnrique (virtuel) l'tat K qui est conserv dans le catalogue jusqu' ce que tous les fichiers aient t reus. Le code de diagnostic pour ce transfert est fix RECV ALL. Remarque : l'IDF explicite spcifi ct demandeur (commande RECV) ne doit pas correspondre, ct serveur, une commande CFTSEND en mode d'mission implicite, sous peine de dclencher une rptition continue des transferts. Un exemple de ce mcanisme est reprsent sur la figure ci-dessous. Dans cet exemple, les noms des fichiers reus sont dfinis en utilisant la variable symbolique &IDF qui permet de rcuprer l'identifiant associ au transfert en cours (en protocole PeSIT, par exemple) pour un partenaire spcifique. Exemple de rception d'un groupe de fichiers ayant le mme IDF

8.11.7 Emission d'un groupe de fichiers ayant le mme IDF en mode metteur
Ce mcanisme permet d'envoyer un groupe de fichiers ayant le mme IDF, en utilisant une seule commande SEND. Ce mcanisme et le paramtrage associ sont dcrits dans la rubrique Emission d'un groupe de fichiers.

8.11.8 Consultation d'un rpertoire distant


Pour consulter le contenu d'un rpertoire distant, un transfert rcepteur/demandeur doit tre implment en utilisant les dfinitions suivantes : ct serveur : mission en mode ouvert (CFTSEND IMPL = YES, FNAME = &NFNAME) ;

Manuel de rfrence

Transfert de fichiers

8-32

ct rcepteur : emplacement physique, paramtre NFNAME dans la commande RECV, en saisissant le nom d'un rpertoire distant (dirname) ou un nom gnrique (masque) en utilisant des caractres gnriques (mask). La convention syntaxique utilise correspond celle reconnue par le moniteur CFT metteur. En rponse, l'metteur/serveur slectionne un fichier, cre un poste dans le catalogue (avec FNAME= dirname ou mask) et envoie une srie d'enregistrements. Chaque enregistrement correspond un nom de fichier slectionn. En rponse, le fichier reu hrite des attributs dfinis dans la commande CFTRECV ou RECV associe. Ce fichier contient la liste des fichiers slectionns par l'metteur. Pour la modifier, vous devez spcifier les attributs associs au type de fichier texte sur votre systme. Exemple de consultation d'un rpertoire distant

8.11.9 Requte pour recevoir plusieurs fichiers types


CFT permet d'effectuer les oprations suivantes ct demandeur : la rception d'un fichier physique identifi par un IDF gnrique partiellement dfini en utilisant une chane de caractres et un caractre gnrique la fin de cette chane. Remarque : Ce caractre gnrique est spcifique chaque systme. Dans le reste de cette rubrique, il sera dsign par le caractre '*'. Cette valeur IDF est appele "masque" et sera dsigne par <mask> ; des rceptions slectives de plusieurs fichiers physiques associs des IDF gnrique identifis en utilisant un masque ; des rceptions globales d'IDF dont la valeur n'est pas spcifie par le demandeur. Cette possibilit est la gnralisation d'un IDF partiellement dfini. Pour tous les systmes, la valeur utilise pour cet IDF est le caractre '*' (le caractre indiqu ici n'est pas le caractre gnrique dfini pour l'IDF gnrique) Pour implmenter ces mcanismes, les transmissions ct serveur doivent tre en mode de blocage en mission (SEND STATE = HOLD).

Manuel de rfrence

Transfert de fichiers

8-33

8.11.10

IDF gnrique

PeSIT D profil CFT, PeSIT E Possible entre deux moniteurs CFT utilisant l'un de ces protocoles. Ce mcanisme permet de recevoir UN fichier physique identifi ct serveur par un identifiant de fichier type correspondant au masque du paramtre IDF envoy par le demandeur. Le serveur CFT dbloque le premier transfert en attente pour le partenaire demandeur et pour une valeur de paramtre IDF correspondant ce masque. Dans l'exemple suivant, la commande RECV IDF = IDF*, ... dbloque, ct serveur, le transfert SEND IDF = IDF1, STATE = HOLD, FNAME = Y..., le premier transfert en attente. Exemple du premier transfert en attente dbloqu par CFT

8.11.11

Rception slective

PeSIT E, PeSIT D profil CFT Possible entre deux moniteurs CFT utilisant l'un de ces protocoles. Ce mcanisme permet de recevoir tous les fichiers dont l'IDF ct serveur correspond au "masque" envoy par le demandeur. Pour implmenter ce mcanisme, la valeur du paramtre FILE de la commande RECV, ct demandeur, doit tre gale la valeur ALL prdfinie (FILE = ALL). Le serveur CFT dbloque tous les transferts en attente concernant le demandeur et les IDF correspondant au masque envoy. Les requtes de transfert sont traites squentiellement ds qu'un transfert est termin. Les fichiers ne sont pas transfrs en mme temps. Ce type de transfert gnre, dans le catalogue du demandeur, un poste gnrique (virtuel) l'tat K qui est conserv dans le catalogue jusqu' ce que tous les fichiers aient t reus. Le code de diagnostic pour ce transfert est fix RECV ALL.

Manuel de rfrence

Transfert de fichiers

8-34

Un exemple de ce mcanisme est reprsent sur la figure ci-dessous. Dans cet exemple, les noms des fichiers reus sont dfinis en utilisant les variables symboliques suivantes : &IDT qui permet de rcuprer l'identifiant associ au transfert en cours pour un partenaire spcifique ; &IDF qui permet de rcuprer l'IDF envoy par le serveur pendant un transfert. Exemple de rception slective utilisant un IDF gnrique

8.11.12

Rceptions globales
ODETTE, PeSIT D profil CFT, PeSIT E Cette fonctionnalit est uniquement possible avec les protocoles mentionns.

Ce mcanisme permet au demandeur de recevoir tous les fichiers en attente ct serveur.


ODETTE Seule la commande de rception suivante est valide : RECV IDF = * Bien que le transfert squentiel soit l'initiative de l'metteur, le catalogue ct rcepteur contiendra un enregistrement correspondant la requte de rception globale et un enregistrement pour chaque rception, de la mme manire que pour les autres protocoles. Cette commande permet de changer le sens de transfert et, de ce fait, de recevoir globalement tous les fichiers en attente du ct du partenaire distant. Pour activer une rception d'un moniteur demandeur CFT V2 un moniteur serveur CFT/370 V1, seules les commandes suivantes sont valides : RECV IDF = * et RECV IDF = *, FILE = ALL Possibles entre deux moniteurs CFT, en utilisant l'un de ces deux protocoles. Il s'agit d'un cas spcial de rception slective, la commande tant RECV IDF = *, FILE = ALL

PeSIT D profil CFT

PeSIT D profil CFT, PeSIT E

Manuel de rfrence

Transfert de fichiers

8-35

8.11.13

Protection de l'identifiant de fichier type

La commande CFTAUTH permet de dfinir la liste des IDF autoriss pour un partenaire spcifique, en fonction du sens de transfert (mission ou rception). Avant d'activer une commande SEND, CFT vrifie que le partenaire rcepteur a le droit de recevoir l'IDF spcifi. Ce mcanisme est implment grce aux relations de paramtrage indiques sur la figure suivante. Protection contre l'mission d'IDF

De manire similaire, lorsqu'une commande RECV est active, le moniteur vrifie que le partenaire metteur est autoris envoyer l'IDF demand. Ce mcanisme est implment grce aux relations de paramtrage indiques sur la figure suivante.

Manuel de rfrence

Transfert de fichiers

8-36

Vrification qu'un partenaire est autoris envoyer l'IDF demand

Ces mcanismes peuvent notamment tre implments pour vrifier que les partenaires sont autoriss accder, crire ou crer un fichier en mode ouvert. La liste des IDF autoriss ou interdits, indiqus dans la commande CFTAUTH, peut tre explicite : CFTAUTH ID = AUTH, IDF = (...,FI,...)

Le nombre d'IDF dfinis est alors limit. Cette liste peut galement tre dfinie dans un fichier d'indirection portant un nom gnrique <filename> : CFTAUTH ID = AUTH2, FNAME = <filename>

Les IDF autoriss ou interdits sont indiqus dans ce fichier.

Manuel de rfrence

Transfert de fichiers

8-37

S-ar putea să vă placă și