ITU-T X 446 FRENCH-1997 COMMON MESSAGING CALL API《通用信息呼叫应用程序编程接口(API) X系列 数据网络和开放系统通信 信息处理系统 7号研究组 284pp》.pdf

1、UNION INTERNATIONALE DES TLCOMMUNICATIONSUIT-T X.446SECTEUR DE LA NORMALISATIONDES TLCOMMUNICATIONSDE LUIT(08/97)SRIE X: RSEAUX POUR DONNES ETCOMMUNICATION ENTRE SYSTMES OUVERTSSystmes de messagerieInterface de programme dapplicationdappel commun de messagerieRecommandation UIT-T X.446(Antrieurement

2、 Recommandation du CCITT)RECOMMANDATIONS UIT-T DE LA SRIE XRSEAUX POUR DONNES ET COMMUNICATION ENTRE SYSTMES OUVERTSPour plus de dtails, voir la Liste des Recommandations de lUIT-T.RSEAUX PUBLICS POUR DONNES X.1X.199Services et fonctionnalits X.1X.19Interfaces X.20X.49Transmission, signalisation et

3、commutation X.50X.89Aspects rseau X.90X.149Maintenance X.150X.179Dispositions administratives X.180X.199INTERCONNEXION DES SYSTMES OUVERTS X.200X.299Modle et notation X.200X.209Dfinitions des services X.210X.219Spcifications des protocoles en mode connexion X.220X.229Spcifications des protocoles en

4、mode sans connexion X.230X.239Formulaires PICS X.240X.259Identification des protocoles X.260X.269Protocoles de scurit X.270X.279Objets grs de couche X.280X.289Tests de conformit X.290X.299INTERFONCTIONNEMENT DES RSEAUX X.300X.399Gnralits X.300X.349Systmes de transmission de donnes par satellite X.35

5、0X.399SYSTMES DE MESSAGERIE X.400X.499ANNUAIRE X.500X.599RSEAUTAGE OSI ET ASPECTS SYSTMES X.600X.699Rseautage X.600X.629Efficacit X.630X.649Dnomination, adressage et enregistrement X.650X.679Notation de syntaxe abstraite numro un (ASN.1) X.680X.699GESTION OSI X.700X.799Cadre gnral et architecture de

6、 la gestion-systmes X.700X.709Service et protocole de communication de gestion X.710X.719Structure de linformation de gestion X.720X.729Fonctions de gestion X.730X.799SCURIT X.800X.849APPLICATIONS OSI X.850X.899Engagement, concomitance et rtablissement X.850X.859Traitement transactionnel X.860X.879O

7、prations distantes X.880X.899TRAITEMENT OUVERT RPARTI X.900X.999Recommandation X.446 (08/97) iRECOMMANDATION UIT-T X.446INTERFACE DE PROGRAMME DAPPLICATIONDAPPEL COMMUN DE MESSAGERIERsumLa prsente Recommandation spcifie une interface dappel simple, travers laquelle des applications tributaires dunem

8、essagerie peuvent invoquer les services du systme MHS en passant par une interface de programmation normalise.Cette Recommandation, labore de concert avec lassociation XAPI, dfinit linterface de programmation dapplicationmise en uvre pour le systme MHS par les principaux vendeurs et fournisseurs de

9、services du monde.SourceLa Recommandation UIT-T X.446, labore par la Commission dtudes 7 (1997-2000) de lUIT-T, a t approuve le9 aot 1997 selon la procdure dfinie dans la Rsolution n 1 de la CMNT.ii Recommandation X.446 (08/97)AVANT-PROPOSLUIT (Union internationale des tlcommunications) est une inst

10、itution spcialise des Nations Unies dans le domainedes tlcommunications. LUIT-T (Secteur de la normalisation des tlcommunications) est un organe permanent delUIT. Il est charg de ltude des questions techniques, dexploitation et de tarification, et met ce sujet desRecommandations en vue de la normali

11、sation des tlcommunications lchelle mondiale.La Confrence mondiale de normalisation des tlcommunications (CMNT), qui se runit tous les quatre ans, dtermineles thmes dtudes traiter par les Commissions dtudes de lUIT-T lesquelles laborent en retour desRecommandations sur ces thmes.Lapprobation des Rec

12、ommandations par les Membres de lUIT-T seffectue selon la procdure dfinie dans laRsolution n 1 de la CMNT.Dans certains secteurs de la technologie de linformation qui correspondent la sphre de comptence de lUIT-T, lesnormes ncessaires se prparent en collaboration avec lISO et la CEI.NOTEDans la prse

13、nte Recommandation, lexpression “Administration“ est utilise pour dsigner de faon abrge aussi bienune administration de tlcommunications quune exploitation reconnue.DROITS DE PROPRIT INTELLECTUELLELUIT attire lattention sur la possibilit que lapplication ou la mise en uvre de la prsente Recommandati

14、on puissedonner lieu lutilisation dun droit de proprit intellectuelle. LUIT ne prend pas position en ce qui concernelexistence, la validit ou lapplicabilit des droits de proprit intellectuelle, quils soient revendiqus par un Membre delUIT ou par une tierce partie trangre la procdure dlaboration des

15、Recommandations.A la date dapprobation de la prsente Recommandation, lUIT avait/navait pas t avise de lexistence dune propritintellectuelle protge par des brevets acqurir pour mettre en uvre la prsente Recommandation. Toutefois, commeil ne sagit peut-tre pas de renseignements les plus rcents, il est

16、 vivement recommand aux responsables de la mise enuvre de consulter la base de donnes des brevets du TSB. UIT 1997Droits de reproduction rservs. Aucune partie de cette publication ne peut tre reproduite ni utilise sous quelque formeque ce soit et par aucun procd, lectronique ou mcanique, y compris l

17、a photocopie et les microfilms, sans laccordcrit de lUIT.Recommandation X.446 (08/97) iiiTABLE DES MATIRESPage1 Introduction 11.1 But 11.2 Aperu gnral 11.3 Terminologie. 21.3.1 Dfinitions 21.3.2 Abrviations 21.4 Rfrences normatives 31.4.1 Recommandations | Normes internationales identiques 31.4.2 Pa

18、ires de Recommandations | Normes internationales quivalentes par leur contenutechnique. 31.4.3 Rfrences supplmentaires 31.5 Niveaux. 41.6 Conventions de nom en langage C . 42 Architecture CMC 52.1 Modle fonctionnel. 52.2 Modle informatique 62.2.1 Interfaces. 62.2.2 Session 72.2.3 Prise en charge de

19、caractres tendus . 72.2.4 Notification dvnement 72.2.5 Extensions. 82.3 Modle de configuration. 82.3.1 Gestionnaire CMC 92.3.2 Directives pour les liaisons de plates-formes 102.3.3 Interrogation de linformation concernant la configuration 102.4 Modle objet . 102.4.1 Composants du modle . 103 Classes

20、 dobjets CMC. 133.1 Classes dobjets de lAPI CMC . 133.1.1 Carnet dadresses (Address book) 143.1.2 Article de contenu (Content item). 143.1.3 Liste de distribution (Distribution list) . 143.1.4 Message (Message). 143.1.5 Conteneur de messages (Message Container) 153.1.6 Information par destinataire (

21、Per Recipient Information). 153.1.7 Conteneur de profil (Profile Container) . 163.1.8 Destinataire (Recipient). 163.1.9 Compte rendu (Report) . 163.1.10 Conteneur racine (Root Container). 174 Structures de donnes. 174.1 Types de donnes de base. 184.2 Types de donnes tableau . 184.3 Attachement (Atta

22、chment) 204.4 Boolen (Boolean) 214.5 Tampon (Buffer) .214.6 Structures de donnes de rappel automatique (Callback Data Structures) 214.7 Chane avec comptage (Counted String) 234.8 Descripteur opaque de curseur (Cursor Handle) 244.9 Contrainte de curseur (Cursor Restriction) 244.10 Cl de tri de curseu

23、r (Cursor sort key) . 26iv Recommandation X.446 (08/97)Page4.11 Table de distribution (Dispatch Table). 274.12 Enumr (Enumerated). 334.13 Evnements (Events) 334.14 Extension (Extension). 334.15 Fanions (Flags). 344.16 Identificateur Guid (Guid) 354.17 Identificateur (Identifier) 354.18 Date et heure

24、 ISO (date and time) 354.19 Message (Message). 364.20 Rfrence de message (Message Rfrence) 384.21 Rsum de message (Message summary). 394.22 Nom (Name) . 394.23 Descripteur opaque dobjet (Object handle) . 404.24 Identificateur dobjet (Object identifier) . 404.25 Donnes opaques (Opaque data) 404.26 Pr

25、oprit (Property) 414.27 Destinataire (Recipient) 424.28 Compte rendu (Report) . 434.29 Code retour (Return code) 444.30 Identificateur de session (Session Id) 444.31 Descripteur opaque de flux (Stream handle) 444.32 Chane (String) . 454.33 Temps (Time) 454.34 Identificateur dinterface utilisateur (U

26、ser interface Id) . 465 Proprits dobjet 465.1 Proprits de lobjet carnet dadresses. 565.1.1 Enfant autoris (Child allowed) 565.1.2 Commentaire (Comment) 565.1.3 Emplacement (Location). 575.1.4 Nom (Name) 575.1.5 Classe dobjets (Object class) 575.1.6 Parent (Parent) 585.1.7 Nom de serveur (Server name

27、) . 585.1.8 Partag (Shared) . 585.1.9 Type (Type). 585.2 Proprits de lobjet article de contenu . 595.2.1 Jeu de caractres (Character set) 595.2.2 Information de contenu (Content information). 595.2.3 Type de contenu (Content type) 605.2.4 Instant de cration (Create time). 625.2.5 Type de codage (Enc

28、oding type). 625.2.6 Rpertoire de fichier (File directory) 635.2.7 Nom de fichier (File name). 635.2.8 Numro darticle (Item number) 645.2.9 Type darticle (Item type) 645.2.10 Dernire modification (Last modified) 645.2.11 Classe dobjets (Object class) 645.2.12 Position de rendu (Render position) . 65

29、5.2.13 Taille (Size) . 655.2.14 Titre (Title) 655.3 Proprits de lobjet liste de distribution. 665.3.1 Adresse (Address) . 665.3.2 Commentaire (Comment) 665.3.3 Instant de dernire modification (Last modification time) 66Recommandation X.446 (08/97) vPage5.3.4 Nom (Name) 665.3.5 Classe dobjets (Object

30、 class) 675.3.6 Parent (Parent) 675.3.7 Partag (Shared) . 675.4 Proprits de lobjet message 675.4.1 Identificateur dapplication (Application Id) . 685.4.2 Statut de message de lapplication (Application message status) 685.4.3 Action automatique (Auto-action) 685.4.4 Instant de remise diffre (Deferred

31、 delivery time) 695.4.5 Identificateur (Id) 695.4.6 Statut de message en entre (In message status). 695.4.7 En rponse (In reply to) 705.4.8 Comptage darticles (Item count) 705.4.9 Diagnostic de non-acquittement (NRN diagnostic). 705.4.10 Motif de non-acquittement (NRN reason). 705.4.11 Classe dobjet

32、s (Object class) 715.4.12 Statut de message en sortie (Out message status). 715.4.13 Priorit (Priority) 725.4.14 Acquittement demand (Receipt requested) . 725.4.15 Type dacquittement (Receipt type). 735.4.16 Compte rendu demand (Report requested) . 735.4.17 Rle (Role) 735.4.18 Sensibilit (Sensitivit

33、y) 745.4.19 Taille (Size) . 745.4.20 Sujet (Subject). 755.4.21 Instant de rception (Time received). 755.4.22 Instant dmission (Time sent). 755.4.23 Type (Type). 755.5 Proprits de lobjet conteneur de messages . 765.5.1 Enfant autoris (Child allowed) 765.5.2 Commentaire (Comment) 765.5.3 Emplacement (

34、Location). 775.5.4 Nom (Name) 775.5.5 Classe dobjets (Object class) 775.5.6 Parent (Parent) 785.5.7 Nom de serveur (Server name) . 785.5.8 Partag (Shared) . 785.5.9 Type (Type). 785.6 Proprits de lobjet information par destinataire . 795.6.1 Commentaire (Comment) 795.6.2 Instant de remise (Delivery

35、time) 795.6.3 Diagnostic (Diagnostic) 795.6.4 Classe dobjets (Object class) 805.6.5 Motif (Reason) 805.6.6 Adresse du destinataire (Recipient address) . 805.6.7 Nom du destinataire (Recipient name) 805.6.8 Type (Type). 815.7 Proprits de lobjet conteneur de profil . 815.7.1 Action automatique (Auto-A

36、ction) 815.7.2 Jeu de caractres (Character Set) 825.7.3 Conformit (Conformance). 825.7.4 Service par dfaut (Default Service) . 825.7.5 Utilisateur par dfaut (Default User) 835.7.6 Fin de ligne (Line Terminator) . 835.7.7 Classe dobjets (Object Class). 835.7.8 Extensions dobjet prises en charge (Obje

37、ct Extensions Supported). 835.7.9 Objets pris en charge (Objects Supported) . 845.7.10 Proprits prises en charge (Properties Supported) 845.7.11 Extensions de proprit prises en charge (Property Extensions Supported). 845.7.12 Mot de passe exig (Required Password). 845.7.13 Service exig (Required Ser

38、vice) 85vi Recommandation X.446 (08/97)Page5.7.14 Utilisateur exig (Required User) . 855.7.15 Prise en charge des chanes avec comptage (Support Counted Strings) . 855.7.16 Prise en charge dabsence de marquage en lecture (Support No Mark As Read) 855.7.17 Interface utilisateur disponible (User Interf

39、ace Available). 865.7.18 Utilisateurs (Users) . 865.7.19 Version de la mise en uvre (Version of the Implementation). 865.7.20 Version de la spcification (Version of the Specification) 865.8 Proprits dobjets destinataire . 875.8.1 Adresse (Address) . 875.8.2 Renvoi de contenu exig (Content Return Req

40、uested) . 875.8.3 Nom (Name) 875.8.4 Classe dobjets (Object Class). 875.8.5 Acquittement demand (Receipt Requested). 885.8.6 Compte rendu demand (Report Requested). 885.8.7 Fanion de responsabilit (Responsibility Flag). 895.8.8 Rle (Role) 895.8.9 Type (Type). 905.9 Proprits de lobjet compte rendu 90

41、5.9.1 Identificateur dapplication (Application Id) . 905.9.2 Identificateur (Id) 905.9.3 Comptage darticle (Item Count) . 915.9.4 Identificateur du systme de messagerie (Messaging System Id) 915.9.5 Classe dobjets (Object Class). 915.9.6 Lu (Read) 915.9.7 Taille (Size) . 925.9.8 Sujet (Subject). 925

42、.9.9 Identificateur du message sujet (Subject Message Id) 925.9.10 Instant de rception (Time Received) 925.9.11 Instant dmission (Time Sent) 935.9.12 Non mis (Unsent) 935.10 Proprits de lobjet conteneur racine . 935.10.1 Enfant autoris (Child Allowed) 935.10.2 Commentaire (Comment) 935.10.3 Emplacem

43、ent (Location). 945.10.4 Nom (Name) 945.10.5 Classe dobjets (Object Class). 945.10.6 Partag (Shared) . 956 Interface fonctionnelle . 956.1 Fonctions de linterface CMC simple. 956.1.1 Emission de message 966.1.2 Rception de messages 1006.1.3 Consultation de noms 1066.1.4 Administration 1096.2 Fonctio

44、ns CMC compltes 1166.2.1 Fonctions de liaison 1176.2.2 Fonctions de composition . 1196.2.3 Fonctions dnumration . 1306.2.4 Fonctions de notification dvnements 1446.2.5 Fonctions de messagerie . 1496.2.6 Fonctions de manipulation de nom . 1526.2.7 Fonctions de flux 1547 Codes retour . 1608 Conformit

45、. 175Annexe A Rsum des dclarations en langage C. 177A.1 Rsum des dclarations en langage C. 177Recommandation X.446 (08/97) viiPageAnnexe B Extensions de fournisseurs CMC . 220B.1 Extensions CMC faites par les fournisseurs . 220B.1.1 Extensions de fonctions 221B.1.2 Extensions de donnes 227B.2 Rsum d

46、es dclarations en langage C de lensemble dextensions 229B.2.1 Ensemble dextensions X.400 . 230B.2.2 Extensions supplmentaires pour un mappage CMC simple vers X400. 231B.2.3 Autres ensembles dextension . 234B.2.4 Informations propres aux plates-formes, y compris les associations dexcution. 234B.2.5 U

47、tilisation des services de lossature X.400 par linterface CMC simple 236Annexe C Exemples de programmation 255C.1 Exemples de programmation 255C.1.1 Demande de configuration, ouverture et fermeture de session . 255C.1.2 Fonctions dmission et dmission de documents 255C.1.3 Lister, lire et supprimer l

48、e premier message non lu 257C.1.4 Recherche un destinataire donn et obtenir ses dtails . 258C.1.5 Utilisation dextensions . 258C.1.6 Mise en uvre de la liaison CMC. 259C.2 Exemple de mise en uvre de liaison de mise en uvre CMC 261C.3 Composition dun message 262C.4 Recherche de nouveaux messages 265C.5 Remplissage dun message 267C.6 Suppression dun message. 271C.7 Extraction dun message . 273Recommandation X.446 (08/97