Adapteur de Fichier

Spécifications

Système de règlement brut en temps réel

Version 1

CMA Small Systems AB

2005
Système de règlement brut en temps réel
Adapteur de fichier
Spécifications
Version 1

Ce LOGICIEL est la propriété de CMA Small Systems AB et de ses

fournisseurs ; il est donc protégé par les lois internationales relatives au droit
d’auteur et par les lois appliquées en la matière par chaque pays. Par
conséquent, vous devez traiter ce LOGICIEL comme tout autre matériel
protégé par des droits d'auteur (des livres, par exemple), sauf dans le cas
suivant : si le logiciel n’est pas protégé contre la copie, vous pouvez soit (a)
effectuer une copie du LOGICIEL pour des besoins de sauvegarde ou
d’archivage, soit (b) transférer le LOGICIEL sur un disque dur, étant entendu
que vous conservez l’original uniquement pour des besoins de sauvegarde ou
d’archivage. Vous n’êtes pas autorisé à copier le(s) guide(s) de l’utilisateur ou
la documentation écrite accompagnant le LOGICIEL.

Copyright © Highex AB. Tous droits réservés.

CMA Small Systems AB est le distributeur exclusif de RTS/X

 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

Table des Matières

1. INTRODUCTION.....................................................................................................................................................1-1

2. STRUCTURES DES DONNÉES...........................................................................................................................2-1

2.1 DESCRIPTION GÉNÉRALE DU FORMAT DES DONNÉES........................................................................................2-1

2.2 CHAMPS POUR MESSAGES ENTANTS..................................................................................................................2-2
2.3 CHAMPS POUR MESSAGES SORTANTS................................................................................................................2-3

3. DESCRIPTION DE L’ADAPTEUR DE FICHIER RTS/X................................................................................3-1

3.1 DESCRIPTION GÉNÉRALE...................................................................................................................................3-1

3.2 PARAMÈTRES DE CONFIGURATION....................................................................................................................3-1
3.2.1 Configuration du Système Fichier..........................................................................................3-3
3.2.2 Configuration de la connectivité de RTS/X............................................................................3-4
3.3 ADAPTATION AUX MESSAGES S.W.I.F.T...........................................................................................................3-5
3.3.1 Configuration.........................................................................................................................3-5
3.3.2 Utilisation...............................................................................................................................3-6
3.4 ADAPTATION AUX MESSAGES XML..................................................................................................................3-6
3.4.1 Configuration.........................................................................................................................3-6
3.4.2 Utilisation...............................................................................................................................3-6

4. ANNEXES A. OPTIONS CRYPTOGRAPHIQUES.............................................................................................A

5. ANNEXE B. FORUM AUX QUESTIONS..............................................................................................................B

PEUT-ON RECEVOIR DES MESSAGES À PARTIR DU SERVEUR RTS/X EN FORMAT S.W.I.F.T. PLUTÔT QU’EN FORMAT
XML?...............................................................................................................................................................................B
COMMENT ORGANISER UN FONCTIONNEMENT CONJOINT DU GESTIONNAIRE DE SIGNATURE - SIMPLECHECKER ET DE

L’ADAPTATEUR DE FICHIER..............................................................................................................................................B
Que faire si l’adaptateur ne peut démarrer à cause d’un numéro de séquence erroné?....................................................c

i
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

1. Introduction
RTS/X autorise une interaction avec les participants aussi bien par l'intermédiaire du réseau S.W.I.F.T. que par
n'importe quel réseau privé.
En cas d'interaction via le réseau SWIFT, le participant utilise le logiciel Swift existant pour la transmission
des messages préalablement préparés vers le réseau de S.w.i.f.t.. Ce type d'interaction ne constitue pas l’objet de ce
document.
L’interaction avec RTS/X via un réseau privé peut être établie au moyen de l’une quelconque des méthodes
suivantes :
 Grace aux postes de travail spécifiques du participant
 Par échange de fichiers
 En utilisant RCCC.
Dans le cas où les postes de travail spécifiques du participant sont utilisés, les fonctions interactives avec
RTS/X restent transparentes pour le participant ; le logiciel les exécute automatiquement lorsqu’elles sont requises. Ce
document ne contient aucune description des fonctionnalités des postes de travail du participant.
Les Échanges de fichiers de messages avec RTS/X sont basés sur un programme spécial installé sur
l’ordinateur du participant. Deux répertoires doivent être dédiés à l’échange de messages : l’un pour envoyer des
messages à RTS/X, et l’autre pour lire les messages reçus de RTS/X. Les noms de ces répertoires sont spécifiés dans le
fichier de configuration lors de l’installation du logiciel d’interfaçage RTS/X. Le participant peut choisir entre deux
formats de fichiers d’échange :
 Le format spécifique pour la transmission de messages via le réseau S.W.I.F.T.
 Le format propriétaire décrit dans la section 2 ci-après.
Chaque message à envoyer à RTS/X est inclus dans un fichier séparé. Le programme envoie tous les fichiers
que le participant a placé dans le répertoire des messages sortants. Les messages reçus de RTS/X sont placés dans le
répertoire des messages entrants.
Dans le cas de l’utilisation de RCCC, l’authentification du participant, la réception et l’envoi de n’importe
quels messages sont effectués par invocation des fonctions de RCCC. Ce document liste les fonctions qui doivent être
utilisées pour connecter l’application d’un utilisateur à RTS/X. En plus, le protocole d’échange de messages entre
l’application d’un utilisateur et RTS/X est aussi décrit.
Pour mettre en oeuvre RCCC, on doit bien connaître :
 Les formats de messages S.W.I.F.T.
 Les formats de données XML,
Une expérience de programmation en C/С++ et/ou Visual Basic et Microsoft Visual C/C++ et/ou de
l’environnement de développement Visual Basic est indispensable.
Ci-dessous se trouve une liste de lectures recommandées :

1
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

 Guide de l’utilisateur S.W.I.F.T.

 Extensible Markup Language (XML) 1.0 (deuxième Edition). W3C Recommendation 6 Octobre 2000
 Programming Microsoft Visual C++. 5è édition. Microsoft Press 1998.
 Microsoft Visual Basic 6.0 Guide du programmeur. Microsoft Press 1998.

2
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

2. Structures des données

2.1 Description Générale du format des données

Cette API vise à établir une interaction entre RTS/X et tout participant connecté via le réseau privé. Pour une
harmonisation de la terminologie utilisée pour décrire les formats de messages, le ‘participant’ sera dénommé ci-après
‘utilisateur’.
Chaque message est transformé en un document de type XML, basé sur le format de présentation de données
destiné à établir une interaction avec le réseau [Link].T en utilisant le composant MME.
L'ensemble et la structure des champs de service dans de tels messages sont identiques à ceux des champs d’un
message S.W.I.F.T., alors que tous les champs du 4 ième bloc sont copiés tel quel dans le champ du 4 ième bloc d'un
message correspondant de type XML. Tous les messages (sortants et entrants) doivent être conformes au diagramme de
définition de données XML décrit ci-dessous:

<?xml version="1.0" ?>

<!--This is a specification of pay order message for the RTS/X
participant-->
<!ELEMENT SWIFT_msg_fields (msg_format, msg_sub_format, msg_sender,
msg_receiver, msg_type, msg_priority, msg_del_notif_rq,
msg_user_priority, msg_user_reference?, msg_copy_srv_id?,
msg_fin_validation?, msg_pde?, (msg_session, msg_sequence,
msg_net_input_time, msg_net_output_date, msg_net_mir,
msg_copy_srv_info?, msg_mac_result?, msg_pac_result?, msg_pdm?)?,
block4)>
<!ELEMENT msg_format (#PCDATA)>
<!ELEMENT msg_sub_format (#PCDATA)>
<!ELEMENT msg_sender (#PCDATA)>
<!ELEMENT msg_receiver (#PCDATA)>
<!ELEMENT msg_type (#PCDATA)>
<!ELEMENT msg_priority (#PCDATA)>
<!ELEMENT msg_del_notif_rq (#PCDATA)>
<!ELEMENT msg_user_priority (#PCDATA)>
<!ELEMENT msg_user_reference (#PCDATA)>
<!ELEMENT msg_copy_srv_id (#PCDATA)>
<!ELEMENT msg_fin_validation (#PCDATA)>
<!ELEMENT msg_pde (#PCDATA)>
<!ELEMENT msg_session (#PCDATA)>
<!ELEMENT msg_sequence (#PCDATA)>
<!ELEMENT msg_net_input_time (#PCDATA)>
<!ELEMENT msg_net_output_date (#PCDATA)>
<!ELEMENT msg_net_mir (#PCDATA)>
<!ELEMENT msg_copy_srv_info (#PCDATA)>
<!ELEMENT msg_mac_result (#PCDATA)>
<!ELEMENT msg_pac_result (#PCDATA)>

1
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

<!ELEMENT msg_pdm (#PCDATA)>

<!ELEMENT block4 (#PCDATA)>

Les règles pour remplir les champs des messages à envoyer à RTS/X sont décrites dans la Section 2.2.
Les règles pour analyser les champs des messages reçus de RTS/X sont décrites dans la Section 2.3.

2.2 Champs pour messages entants

Cette section décrit les règles pour remplir les champs des messages envoyés à RTS/X :
Elément ‘msg_format’ – Format du message (toujours ‘S’ pour les messages utilisant l’interface RCCC )
Elément ‘msg_sub_format – ‘I’ pour les messages à envoyer à RTS/X.
Elément ‘msg_sender’ – les 12 caractères de l’adresse BIC de l’expéditeur du message.
Elément ‘msg_receiver’ - les 12 caractères de l’adresse BIC du destinataire du message.
Elément ‘msg_type’ – Type de message . Il s’agit du type de message sur 3 caractères comme spécifié dans le
bloc d’en-tête Application du message S.W.I.F.T.
Elément ‘msg_priority’ – 1 caractère pour le niveau de priorité transport (toujours ‘N’ pour les messages
utilisant l’interface RCCC).
Elément ‘msg_del_notif_rq’ – demande de notification de livraison du message sur 1 caractère (toujours ‘N’
pour les messages utilisant l’interface RCCC).
Elément ‘msg_user_priority’ – information sur 4 caractères pour la priorité que l'expéditeur assigne au
traitement du message par le destinataire. C'est le champ Priorité de l'opération bancaire (champ 113) dans le bloc d'en-
tête Utilisateur du message S.W.I.F.T. RTS/X utilise le contenu de ce champ en tant que niveau de priorité à affecter au
règlement de l’ordre de paiement.
Elément ‘msg_user_reference’ – référence utilisateur facultative sur 16 caractères. C'est le champ MUR
(référence utilisateur du message) (champ 108) dans le bloc d'en-tête utilisateur
Elément ‘msg_copy_srv_id’ – identification facultative du service réseau sur trois caractères. Doit toujours
être vide pour les messages entrants
Elément ‘msg_fin_validation’ – 8 caractères facultatifs pour la requête de services de validation réseau. Doit
toujours être vide pour les messages entrants.
Elément ‘msg_pde’ – 1 caractère facultatif pour ‘duplication possible de l’émission du message’. L’utilisateur
doit entrer la valeur ‘Y’ lorsque le message est envoyé une deuxième fois.
Eléement ‘msg_session’ – 4 caractères pour le numéro de session. Doit toujours être vide pour les messages
entrants.
Elément ‘msg_sequence’ – 6 caractères pour le numéro de séquence sortant. Doit toujours être vide pour les
messages entrants.
Elément ‘msg_net_input_time’ – 4 caractères pour indiquer l’heure du serveur distant sous format HHMM.
Doit toujours être vide pour les messages entrants.
Elément ‘msg_net_output_date’ – 10 caractères pour indiquer la date et l’heure locales, format
YYMMDDHHMM. Doit toujours être vide pour les messages entrants.

2
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

Elément ‘msg_net_mir’ – référence du message entrant sur 28 caractères. Doit toujours être vide pour les
messages entrants.
Elément ‘msg_copy_srv_info’ – information facultative de service FIN Copy sur 32 caractères. Doit toujours
être vide pour les messages entrants.
Elément ‘msg_mac_result’ – signature numérique de l’élément bloc4 pour l’authentification de l’utilisateur
du participant
Elément ‘msg_pac_result’ – signature numérique du message entier pour l’authentification du participant.
Doit être toujours vide pour les messages entrants.
Elément ‘msg_pdm’ – 1 caractère pour ‘duplication possible du message’. Doit toujours être vide pour les
messages entrants.
Elément ‘block4’ – contenu du bloc 4 du message S.W.I.F.T. .

Exemple de bloc 4:
CRLF :20:TRNCRLF:79:Frée text

ou
CR = retour chariot
LF = renvoi à la ligne

Ci-dessous un exemple de message d’un participant à envoyer à RTS/X:

<?xml version="1.0"?>
<SWIFT_msg_fields>
<msg_format>S</msg_format>
<msg_sub_format>I</msg_sub_format>
<msg_sender>SNDRCC2AAXXX</msg_sender>
<msg_receiver>RCVRCC2AXXXX</msg_receiver>
<msg_type>100</msg_type>
<msg_priority>N</msg_priority>
<msg_del_notif_rq>N</msg_del_notif_rq>
<msg_user_priority>10</msg_user_priority>
<block4>
20:TRANSREF
32A:990802CCD10000,00
50:A PAYER INC
59:A PAYÉE INC
70:PAYER TO PAYÉE INFO</block4>
</SWIFT_msg_fields>

2.3 Champs pour messages sortants

Cette section décrit les règles pour le remplissage des champs de messages venant de RTS/X:
Elément ‘msg_format’ – Format du message. Toujours ‘S’ pour les messages provenant de RTS/X.

3
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

Elément ‘msg_sub_format –‘O’ pour les message provenant de RTS/X.

Elément ‘msg_sender’ – 12 caractères de l’adresse BIC de l’expéditeur du message.
Elément ‘msg_receiver’ – 12 caractères de l’adresse BIC du destinataire du message.
Elément ‘msg_type’ – le type du message sur 3 caractères comme spécifié dans le bloc d’en-tê teApplication
du message S.W.I.F.T.
Element ‘msg_priority’ – 1 caractère pour le niveau de priorité transport
Elément ‘msg_del_notif_rq’ – 1 caractère pour demande de notification de livraison du message
Elément ‘msg_user_priority’ – information sur 4 caractères pour la priorité que l'expéditeur assigne au
traitement du message par le destinataire. C'est le champ Priorité de l'opération bancaire (champ 113) dans le bloc d'en-
tête Utilisateur du message S.W.I.F.T. RTS/X utilise le contenu de ce champ en tant que niveau de priorité à affecter au
règlement de l’ordre de paiement.
Elément ‘msg_user_reference’ – référence utilisateur facultative sur 16 caractères. C'est le champ
MUR (référence de utilisateur du message) (champ 108) dans le bloc d'en-tête utilisateur
Elément ‘msg_copy_srv_id’ – identification facultative sur trois caractères du service réseau.
Elément ‘msg_fin_validation’ – 8 caractères facultatifs pour la requête de services de validation réseau.
Elément ‘msg_pde’ – 1 caractère facultatif pour ‘duplication possible de l’émission du message’.
Elément ‘msg_session’ – 4 caractères pour le numéro de session.
Elément ‘msg_sequence’ – 6 caractères pour lenuméro de séquence sortant.
Elément ‘msg_net_input_time’ 4 caractères pour indiquer l’heure du serveur distant sous format HHMM.
Elément ‘msg_net_output_date’ – 10 caractères pour indiquer la date et l’heure locales, format
YYMMDDHHMM.
Elément ‘msg_net_mir’ – référence du message entrant sur 28 caractères.
Elément ‘msg_copy_srv_info’ – information facultative de service FIN Copy sur 32 caractères.
Elément ‘msg_mac_result’ – signature numérique de l’élément bloc4 pour l’authentification de l’utilisateur
du participant
Elément ‘msg_pac_result’ – signature numérique du message entier pour l’authentification du participant.
Elément ‘msg_pdm’ – étiquette sur 1 caractère pour ‘duplication possible du message’.
Elément ‘block4’ – contenu du bloc 4 du message S.W.I.F.T.

Exemple de bloc 4:
CRLF :20:TRNCRLF:79:Frée text
ou
CR = retour chariot
LF = renvoi à la ligne

Ci-dessous est un exemple de message provenant de RTS/X et reçu par un participant:

<?xml version="1.0"?>

4
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

<!--Example of input message-->

<SWIFT_msg_fields>
<msg_format>S</msg_format>
<msg_sub_format>O</msg_sub_format>
<msg_sender>SNDRCC2AAXXX</msg_sender>
<msg_receiver>RCVRCC2AXXXX</msg_receiver>
<msg_type>100</msg_type>
<msg_priority>N</msg_priority>
<msg_del_notif_rq>N</msg_del_notif_rq>
<msg_user_priority>10</msg_user_priority>
<msg_user_reference/>
<msg_copy_srv_id/>
<msg_fin_validation/>
<msg_pde>N</msg_pde>
<msg_session>0123</msg_session>
<msg_sequence>000456</msg_sequence>
<msg_net_input_time>1200</msg_net_input_time>
<msg_net_output_date>9908021428</msg_net_output_date>
<msg_net_mir>990802SNDRCC2AAXXX0123000456</msg_net_mir>
<msg_copy_srv_info/>
<msg_mac_result>4CDF324373308B2F8035DE18364</msg_mac_result>
<msg_pac_result>9C19C3B495281E7E75810309AE</msg_pac_result>
<msg_pdm>N</msg_pdm>
<block4>
20:TRANSREF
32A:990802CCD10000,00
50:A PAYER INC
59:A PAYEE INC
70:PAYER TO PAYEE INFO</block4>
</SWIFT_msg_fields>

5
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

3. Description de l’Adapteur de Fichier RTS/X

3.1 Description Générale

L’Adapteur de Fichier ou le client Adaptateur de Fichier (ci-après nommé l’Adaptateur de Fichier) est un
produit logiciel destiné à fournir une connectivité au RTS/X par échange de fichiers. L’Adaptateur de Fichier est basé
sur un Adapteur d'Application Externe (XAdapter) du middleware d’intégration applicatif PIE (Processware Integration
Environment). L’Adaptateur de Fichier met en application deux interfaces. D'une part il établit et maintient une
connexion réseau du client à RTS/X, et d'autre part il surveille le répertoire dédié aux fichiers entrants à envoyer à
RTS/X. Chaque fichier placé dans le répertoire d’entrée est traité par l’Adaptateur de Fichier et envoyé à RTS/X,
chaque message reçu par l’Adaptateur de Fichier à partir du RTS/X est transformé et placé dans le répertoire de sortie.
L’Adaptateur de Fichier supporte deux formats des messages. L’un d'eux est le format S.W.I.F.T., et l'autre est
le format XML, utilisé en interne dans RTS/X. L’Adaptateur de Fichier fait la conversion des formats de fichier selon
la configuration. Les messages S.W.I.F.T. sont envoyés à l'Adaptateur via l'application Gestionnaire de Signature -
SimpleChecker. Le Gestionnaire de signature - SimpleChecker signe le bloc4 d'un message S.W.I.F.T puis convertit le
message entier en message de format XML qui est accepté par l’Adaptateur de Fichier. Pour plus d'information voir le
guide de l’utilisateur du Gestionnaire de Signature - SimpleChecker

3.2 Paramètres de Configuration

Les paramètres de configuration de l’Adaptateur de Fichier sont situés dans le fichier de configuration appelé par
défaut’[Link]’. Il est possible, cependant, de lancer le XAdapter avec n'importe quel fichier particulier de configuration
en l'indiquant dans le paramètre de la ligne de commande:
>XAdapter –i rsc_swift.ini

L’adaptateur de fichier RTS/X contient deux fichiers de configuration conçus pour supporter l’échange de
fichiers sous format S.W.I.F.T. et XML. Ce sont les fichiers rsc_swift.ini et rsc_xml.ini . Les deux fichiers
partagent la même structure de base expliquée ci-dessous.
Les paramètres de configuration qui n'ont pas été mentionnés dans cette documentation affectent la
fonctionnalité interne du XAdapter et ne doivent pas être changés par l'utilisateur pour les opérations ordinaires. La
description détaillée des paramètres de configuration peut être trouvée dans la documentation XAdapter. Quelques
paramètres principaux de configuration sont communs à S.W.I.F.T. et à XML. Ceux-ci sont:
Le paramètre inputProtocol dans la section [xad], définit le type de module d’échanges de données
concernant les flux de données entrants. Le module "file" est utilisé pour les deux configurations. Il fournit une
interface pour le système de fichier local.

1
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

Le paramètre outputProtocol dans la section [xad] définit le type de module d’échange de données
concernant les flux de données sortants. Le module "xowalcli" est utilisé pour les deux configurations. Il fournit une
interface réseau pour RTS/X.
Le paramètre specialProcessing dans la section [xad] définit le module de traitement spécial utilisé pour
supporter les fonctionnalités client de RTS/X. Le module RCCC est utilisé pour les deux configurations. Vous devez
spécifier ce paramètre ‘RSC@RSCProcessing’ à cause de la différence de noms des modules et du fichier DLL
correspondant.
Le paramètre DataFile dans la section [xad processing RCS] définit le fichier dans lequel les
informations récupérées vont être enregistrées. Ce fichier est utilisé pour conserver les informations importantes lors de
l’exécution de l’Adaptateur de Fichier et pour la récupération après un problème de fonctionnement. L’adaptateur de
fichier doit avoir un accès lecture et écriture sur le fichier spécifié. Notez que vous devez effacer ce fichier
manuellement dans le cas d’une réinitialisation de la session du participant sur le serveur RTS/X.
Le paramètre JournalFile dans la section [xad processing RCS] définit le fichier dans lequel les
informations du journal sont enregistrées. Le fichier journal est utilisé pour sauvegarder les informations de traçage des
messages traités par l’adaptateur de fichier.
Le paramètre facultatif CryptoIniFile dans la section [xad processing RCS] définit le fichier qui
contient les paramètres de configuration du sous système de cryptographie. Il peut s’agir du fichier dans lequel la
configuration de l’Adaptateur de Fichier est enregistrée ou d’un fichier séparé. Si ce paramètre est positionné,
l’adaptateur de fichier utilise la bibliothèque cryptographique pour signer et chiffrer les messages sortants et pour
déchiffrer et vérifier les signatures des messages entrants.
Le paramètre facultatif CryptoIniSection dans la section [xad processing RCS] définit le nom de la
section dans le fichier de configuration désigné par le paramètre CryptoIniFile dans lequel les paramètres
cryptographiques sont définis. Ce paramètre doit obligatoirement être positionné lorsque le paramètre CryptoIniFile est
positionné.
Le paramètre ServerBIC dans la section [xad processing RCS] définit le BIC du système distant
(RTS/X).
Le paramètre LogonTimeout dans la section [xad processing RCS] définit le temps d’attente maximum
autorisé pour recevoir la réponse au message Logon envoyé au serveur RTS/X. La valeur du paramètre est définie en
millisecondes.
Le paramètre Timeout dans la section [xad processing RCS] définit le temps d’attente maximum
autorisé pour recevoir la réponse à un message envoyé au serveur RTS/X. La valeur du paramètre est définie en
millisecondes.
Le paramètre facultatif IncomingMsgStorePath dans la section [xad processing RCS] définit le chemin
du répertoire dans lequel les copies de tous les messages provenant du serveur RTS/X sont enregistrés. Les messages
seront enregistrés dans leur forme originale avec toutes les informations d’authentification nécessaires pour effectuer
d’autres vérifications d’authentification. Si ce paramètre n’est pas positionné, aucune copie des messages entrants ne
sera sauvegardée.

2
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

Le paramètre facultatif OutgoingReplyStorePath dans la section [xad processing RCS] définit le

chemin du répertoire dans lequel les copies de tous les messages d’accusé de réception envoyés au serveur RTS/X
seront enregistrées. Les messages seront enregistrés dans leur forme originale avec toutes les informations
d’authentification nécessaires pour effectuer d’autres vérifications d’authentification. Si ce paramètre n’est pas
positionné, aucune copie des messages sortants ne sera sauvegardée.
Le paramètre facultatif OutgoingMsgStorePath dans la section [xad processing RCS] définit le chemin
du répertoire dans lequel toutes les copies des messages envoyés au serveur RTS/X seront enregistrées. Les messages
seront enregistrés dans leur forme originale avec toutes les informations d’authentification nécessaires pour effectuer
d’autres vérifications d’authentification. Si ce paramètre n’est pas défini, aucune copie des messages sortants ne sera
sauvegardée.
Le paramètre facultative IncomingReplyStorePath dans la section [xad processing RCS] définit le
répertoire dans lequel les copies de tous les messages d’accusé de réception reçus du serveur RTS/X seront
enregistrées. Les messages seront enregistrés dans leur forme originale avec toutes les informations d’authentification
nécessaires pour effectuer d’autres vérifications d’authentification. Si ce paramètre n’est pas défini, aucune copie des
messages entrants ne sera sauvegardée.

3.2.1 Configuration du Système Fichier

La section [xad input file] contient les paramètres de configuration de l’interface fichier de
l’Adaptateur de Fichier. Il y a quatre principaux paramètres à définir selon la structure du répertoire :
Le paramètre InFilePath définit le chemin du répertoire à partir duquel l’Adaptateur lit les fichiers de données.
En conjonction avec le nom du répertoire, ce paramètre permet d’établir un ou plusieurs modèles de nommage des
fichiers à partir desquels se fera la lecture des données.
Le paramètre facultatif InErrorBackUpPath définit le chemin du répertoire dans lequel l’Adaptateur placera
les copies de tous les fichiers de données lus, dont le traitement s’est terminé par des erreurs. Si le paramètre n’est pas
défini, les fichiers contenant des erreurs ne seront pas sauvegardés.
Le paramètre ScanInterval définit le délai maximum entre deux sessions de balayage des répertoires pour
rechercher de nouveaux fichiers. La valeur de ce paramètre est définie en millisecondes. Si le système de fichier utilisé
supporte le mécanisme de notification de changements, le module file sera utilisé et ce paramètre sera uniquement
utilisé comme intervalle entre les sessions de balayage forcées sans tenir compte des messages de notification de
changements.
Le Paramètre OutFilePath définit le chemin du répertoire dans le système de fichier dans lequel l’Adaptateur
placera toutes les données reçues sous forme de fichier. En conjonction avec le nom du répertoire ce paramètre permet
d’établir un modèle de nommage des fichiers de messages sortants. La valeur ‘%A’ devra être utilisée pour toutes les
configurations de l’Adaptateur de Fichier à utiliser avec RTS/X.
Ci-dessous un exemple typique de configuration du système de fichier.
[xad input file]
InFilePath=.\ClientFiles\in\*.*
InErrorBackUpPath=.\ClientFiles\error

3
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

ScanInterval=3000
OutFilePath=.\ClientFiles\out\%A

3.2.2 Configuration de la connectivité de RTS/X

La configuration de la connectivité de RTS/X doit être spécifiée dans la section [xad output
xowalcli] du fichier de configuration de l’Adaptateur de Fichier. Les principaux paramètres de configuration de
cette section sont décrits ci-dessous.

Section [xad output xowalcli]

AdapterID
Le Paramètre AdapterID définit l’identifiant de l’utilisateur au nom duquel l’adaptateur de fichier se connecte
à RTS/X. Notez que si la bibliothèque cryptographique est utilisée le AdapterID sera dérivé de la clé secrète fournie (le
parameter AbonentID, section [crypidll], Annexes A).
AdapterPassword
Le Paramètre AdapterPassword définit le mot de passe qui sera utilisé pour la connection de l’adaptateur de
fichier à RTS/X.
Servers
Liste de noms de serveurs vers lesquels l’adaptateur de fichier doit établir une connexion.
Service
Nom du service TCP/IP utilisé par le Système pour accepter les connexions entrantes.
HBticks
Le nombre de périodes d’inactivité (idle) d’une seconde de l’horloge interne qui doivent s’écouler entre
l’émission de deux pulsations successives (beats) envoyées au serveur. La valeur par défaut est 20 et est valide
seulement du coté client.

ConnectionTimeout
Nombre de secondes d’attente pour la réponse du serveur RTS/X à une demande de connexion. La valeur par
défaut est 20 secondes et est valide seulement du coté client.

IOTimeout

Nombre de secondes d’attente pour une réponse d’un homologue (peer) sur l’envoi une requête. La valeur par défaut est
de 60 secondes.

LifeTime

Le nombre de seconde que le serveur attend lorsque la pulsation (beat) disparaît (connexion perdue). La valeur par
défaut est 300. Le serveur attend une tentative de connexion du client pendant cet intervalle. Si le client ne le fait pas,
le serveur considère que la connexion est perdue et ferme la session et son contexte.

4
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

BufSize
Taille de la mémoire tampon de communication. La valeur par défaut est 32768. Les tailles de la mémoire
tampon du client et du serveur doivent être égales.
notzipmax

Taille maximum d’un message qui doit être envoyé sans être compressé. La valeur par défaut est 200. Si la valeur est
inférieure à 100 alors la compression doit être désactivée.

Re-connexion

Nombre de tentatives de re-connexion du client en cas de connexion perdue. La valeur par défaut est 3.

Ci-dessous un exemple type de configuration de connectivité.

[xad output xowalcli]

AdapterID=Client1
AdapterPassword=eb3twal

Service=BRRServiceDup1
Servers=gate1,gate3
HBticks=21
ConnectionTimeout=20
IOTimeout=60
LifeTime=300
BufSize=32768
notzipmax=1024

3.3 Adaptation aux messages S.W.I.F.T.

3.3.1 Configuration
Pour permettre à l’Adaptateur de Fichier d’enregistrer les messages sous format S.W.I.F.T., les modifications
suivantes doivent être apportées au fichier de configuration de l’Adaptateur de Fichier:
Le Paramètre OutputType dans la section [xad processing the RSC] doit être défini avec une valeur ‘SWIFT’
afin de modifier le mode de traitement.
[xad processing RSC]
OutputType=SWIFT

Le chemin vers les répertoires doit être configuré pour mener vers l’emplacement du système de fichier dans
lequel les messages S.W.I.F.T. seront placés. La configuration des répertoires de fichier est décrite dans le Chapitre
3.2.1. Notez que pour le mode ‘SWIFT’, l’adaptateur de fichier enregistre les messages reçus du serveur RTS/X sous
format S.W.I.F.T. mais attend les messages à envoyer vers le serveur RTS/X sous format XML. Ces messages sont
générés à partir de messages S.W.I.F.T. grâce à l’application Gestionnaire de Signature - Simple Checker.

5
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

3.3.2 Utilisation
Après lancement, l’Adaptateur de Fichier établit une connexion avec RTS/X. Lorsque la connexion est établie,
les opérations normales débutent.
L’adaptateur de fichier surveille le répertoire spécifié pour le paramètre InFilePath. Lorsqu’un nouveau fichier
apparaît, l’Adaptateur de Fichier prend ce fichier, en considérant qu’il est sous format XML, le convertit sous format
interne XML et l’envoi vers le serveur RTS/X. Si le fichier contient des erreurs (erreurs syntaxiques, information de
service non valides ou toute autre erreur qui entraîne un rejet par le système RTS/X ou l’adaptateur de fichier lui-
même), il est copié dans le répertoire spécifié par le paramètre InErrorBackupPath.
Tous les messages envoyés à l’Adaptateur de Fichier par le serveur RTS/X sont convertis au format
S.W.I.F.T. et placés dans le répertoire spécifié par le paramètre OutFilePath.
Les considérations suivantes doivent être prises en compte lorsque l’adaptateur de fichier tourne en mode
‘SWIFT’. Les fichiers placés dans le répertoire d’entrée de l’Adaptateur de Fichier doivent être conformes au format
XML décrit dans le Chapitre Error: Reference source not found. Si le message dans le fichier contient des erreurs
empêchant sa livraison vers RTS/X, le fichier est transféré dans le répertoire spécifié par le paramètre
InErrorBackupPath. Si le fichier disparaît du répertoire d’entrée et n’apparaît pas dans le répertoire des messages
erronés, cela signifie que le fichier a été envoyé à RTS/X et accepté pour traitement.

3.4 Adaptation aux messages XML

3.4.1 Configuration
Pour permettre à l’Adaptateur de Fichier de traiter les messages sous format XML, les modifications suivantes
doivent être apportées au fichier de configuration Adaptateur de Fichier:
Le paramètre OutputType dans la section [xad processing the RSC] doit avoir la valeur ‘XML’. Le mode de
traitement sera adapté en conséquence.
[xad processing RSC]
OutputType=XML

Les chemins vers les répertoires doivent être configurés pour mener vers les emplacements du système de
fichier dans lesquels les messages XML seront placés ou récupérés. La configuration des répertoires de fichier est
décrite dans le Chapitre 3.2.1.

3.4.2 Utilisation
Après lancement l’Adaptateur de Fichier établit une connexion avec RTS/X. Lorsque la connexion est établie,
les opérations normales débutent.
L’adaptateur de fichier surveille le répertoire spécifié pour le paramètre InFilePath. Lorsqu’un nouveau fichier
apparaît, l’Adaptateur de Fichier prend ce fichier, en considérant qu’il est sous format XML interne, le convertit sous

6
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

format interne XML et l’envoie vers le serveur RTS/X. Si le fichier contient des erreurs (erreurs syntaxiques,
information de service non valides ou toute autre erreur qui entraîne un rejet par le système RTS/X ou l’adaptateur de
fichier lui-même), il est copié dans le répertoire spécifié par le paramètre InErrorBackupPath.
Tous les messages envoyés à l’Adaptateur de Fichier par le serveur RTS/X sont convertis au format XML et
placés dans le répertoire spécifié par le paramètre OutFilePath.
Les considérations suivantes doivent être prises en compte lorsque l’adaptateur de fichier tourne en mode
XML. Les fichiers placés dans le répertoire d’entrée de l’Adaptateur de Fichier doivent être conforme au format XML
décrit dans le Chapitre 2.1. Si le message dans le fichier contient des erreurs empêchant sa livraison vers RTS/X, le
fichier est transféré dans le répertoire spécifié par le paramètre InErrorBackupPath. Si le fichier disparaît du répertoire
d’entrée et n’apparaît pas dans le répertoire de messages erronés, cela signifie que le fichier a été envoyé à RTS/X et
accepté pour traitement.

7
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

4. Annexes A. Options Cryptographiques

Les options suivantes affectent le fonctionnement de la couche cryptographique de la bibliothèque de
communication et doivent être placées dans le fichier et la section définis par les paramètres CryptoIniFile et
CryptoIniSection du fichier d’initialisation (by default the name is crypto).
The module_path parameter defines the path to *.dll-file, which is used for cryptography purposes. While
executing the program components that contained in this dll-file calls up program components from another dll-file,
which is specified by the cryface parameter in [crapidll] section.
The c_face parameter defines the name of the section, which contains parameters of RSA cryptography
package.
The [crapidll] section contains parameters of RSA cryptography package. If the following parameters
are specified the encryption and digital signature options are enabled. This means that all outgoing messages are signed
and encrypted, and it is all assumed that all incoming messages are encrypted and digitally signed too.
The cryface parameter specifies a path to dll-file, which contains the cryptography module.
The LOGFILE defines the cryptography log file name.
The LOGLEVEL defines the level of logged events:
 0 — errors only are registered in the log file;
 1 — function calls of are registered;
 3 — all function calls are registered;
 8 — the parameter values are registered;
 10 — the memory dumps are included.
The ABONENTID defines user’s BIC.
The ISSUER defines the name of Certification Authority (CA) root.
The ldap_search – it’s necessary to update certificates and CRL from LDAP server every start.
The ldap_server – LDAP server.
The ldap_port – port of LDAP server.
The ldap_certs_search – LDAP path of certificates.
The dap_crls_search – LDAP path of CRL.

a
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

5. Annexe B. Forum aux questions

Peut-on recevoir des messages à partir du serveur RTS/X en format

S.W.I.F.T. plutôt qu’en format XML?
Oui. Pour permettre au l’Adaptateur de Fichier d’enregistrer les messages reçus par le serveur RTS/X sous
format S.W.I.F.T., les modifications suivantes doivent être apportées dans le fichier de configuration de l’Adaptateur de
Fichier:
Le paramètre OutputType dans la section [xad processing the RSC] doit prendre la valeur ‘SWIFT’. Le mode
de traitement sera adapté.
[xad processing RSC]
OutputType=SWIFT

Notez que le mode ‘SWIFT’ de l’Adaptateur de Fichier enregistre les messages reçus depuis le serveur RTS/X
sous format S.W.I.F.T. mais s’attend à envoyer au serveur RTS/X des messages sous format XML. Ces messages
peuvent être générés par l’application Gestionnaire de Signature - Simple Checker.

Comment organiser un fonctionnement conjoint du Gestionnaire de

Signature - SimpleChecker et de l’Adaptateur de Fichier
Le Gestionnaire de Signature - SimpleChecker doit être configuré correctement. Le répertoire de sortie du
Gestionnaire de Signature - SimpleChecker doit coincider avec le répertoire d’entrée de l’Adaptateur de Fichier
(paramètre InFilePath dans le fichier [Link]).
Par exemple, InFilePath= C:\RTSX\RTSXClients\Adapter\FileAdapter\ClientFiles\in.
Sélectionnez la valeur du paramètre InFilePath dans le fichier [Link] comme répertoire de sortie pour le
Gestionnaire de Signature - SimpleChecker.
En mode manuel ouvrez le formulaire Signe le fichier dans le menu de commande Manuel/Signature/XML
ou Manuel/Signature/SWIFT.

Figure 5-1. Choix des fichiers d’entrée et de sortie.

b
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

Cliquez sur le bouton Parcourir…en face du champ Fichier de et sélectionnez le répertoire d’entrée de
l’Adaptateur de Fichier comme emplacement dans lequel le fichier sortant du Gestionnaire de Signature -
SimpleChecker sera placé.

Figure 5-2. Paramétrage de signature automatique.

Après avoir sélectionné un fichier d’entrée et cliqué sur le bouton Signe, le fichier de sortie avec signature
sera placé dans le répertoire de sortie de l’Adaptateur de Fichier.
En mode automatique, vous devez assigner un répertoire de sortie dans le formulaire Signature Auto. Il
pourra être affiché en utilisant la commande du menu Automatique/Paramètres.
Les changements effectués dans le formulaire sont reflétés dans le fichier [Link] , vous
pouvez aussi changer la valeur du paramètre OutputPath pour une valeur égale au paramètre InFilePath dans le fichier
[Link].

Par exemple,
OutputPath= C:\RTSX\RTSXClients\Adapter\FileAdapter\ClientFiles\in
Les fichiers de sortie du Gestionnaire de Signature - SimpleChecker seront placés dans le répertoire d’entrée
de l’Adaptateur de Fichier, et en lors du traitement, il essayera d’envoyer ces fichiers vers le serveur RTS/X.

Que faire si l’adaptateur ne peut démarrer à cause d’un numéro de

séquence erroné?
Lorsque vous envoyez des messages au serveur RTS/X, l’adaptateur assigne des numéros de séquence aux
messages sortants. Cet ordre peut être cassé, par exemple, lorsque qu’on efface une base de données principale. Si le

c
 Adapteur de Fichier.
Spécifications
Système ARTS Banque d'Algérie

message d’erreur “Output sequence number mismatch” apparaît lors du démarrage de l’Adaptateur de Fichier,
l’utilisateur doit trouver l’origine du problème de correspondance. S’il y a une justification alors l’utilisateur doit lancer
le fichier clear_stat.bat dans le répertoire de l’Adaptateur de Fichier. Ce fichier exécute la commande pour
effacer le fichier [Link] qui contient l’information concernant le numéro des messages entrants et sortants.
Le fichier clear_all.bat peut également être utilisé. Il contient une option supplémentaire, tous les
fichiers journal et copies des messages.