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

《ITU-T X 446 SPANISH-1997 COMMON MESSAGING CALL API《通用信息呼叫应用程序编程接口(API) X系列 数据网络和开放系统通信 信息处理系统 7号研究组 284pp》.pdf》由会员分享，可在线阅读，更多相关《ITU-T X 446 SPANISH-1997 COMMON MESSAGING CALL API《通用信息呼叫应用程序编程接口(API) X系列 数据网络和开放系统通信 信息处理系统 7号研究组 284pp》.pdf（285页珍藏版）》请在麦多课文档分享上搜索。

1、UNIN INTERNACIONAL DE TELECOMUNICACIONESUIT-T X.446SECTOR DE NORMALIZACINDE LAS TELECOMUNICACIONESDE LA UIT(08/97)SERIE X: REDES DE DATOS Y COMUNICACINENTRE SISTEMAS ABIERTOSSistemas de tratamiento de mensajesInterfaz de programas de aplicacin parallamadas de mensajera comnRecomendacin UIT-T X.446(A

2、nteriormente Recomendacin del CCITT)RECOMENDACIONES DE LA SERIE X DEL UIT-TREDES DE DATOS Y COMUNICACIN ENTRE SISTEMAS ABIERTOSPara ms informacin, vase la Lista de Recomendaciones del UIT-T.REDES PBLICAS DE DATOS X.1X.199Servicios y facilidades X.1X.19Interfaces X.20X.49Transmisin, sealizacin y conm

3、utacin X.50X.89Aspectos de redes X.90X.149Mantenimiento X.150X.179Disposiciones administrativas X.180X.199INTERCONEXIN DE SISTEMAS ABIERTOS X.200X.299Modelo y notacin X.200X.209Definiciones de los servicios X.210X.219Especificaciones de los protocolos en modo conexin X.220X.229Especificaciones de lo

4、s protocolos en modo sin conexin X.230X.239Formularios para declaraciones de conformidad de implementacin de protocolo X.240X.259Identificacin de protocolos X.260X.269Protocolos de seguridad X.270X.279Objetos gestionados de capa X.280X.289Pruebas de conformidad X.290X.299INTERFUNCIONAMIENTO ENTRE RE

5、DES X.300X.399Generalidades X.300X.349Sistemas de transmisin de datos por satlite X.350X.399SISTEMAS DE TRATAMIENTO DE MENSAJES X.400X.499DIRECTORIO X.500X.599GESTIN DE REDES DE INTERCONEXIN DE SISTEMAS ABIERTOS Y ASPECTOSDE SISTEMASX.600X.699Gestin de redes X.600X.629Eficacia X.630X.649Denominacin,

6、 direccionamiento y registro X.650X.679Notacin de sintaxis abstracta uno X.680X.699GESTIN DE INTERCONEXIN DE SISTEMAS ABIERTOS X.700X.799Marco y arquitectura de la gestin de sistemas X.700X.709Servicio y protocolo de comunicacin de gestin X.710X.719Estructura de la informacin de gestin X.720X.729Fun

7、ciones de gestin X.730X.799SEGURIDAD X.800X.849APLICACIONES DE INTERCONEXIN DE SISTEMAS ABIERTOS X.850X.899Cometimiento, concurrencia y recuperacin X.850X.859Tratamiento de transacciones X.860X.879Operaciones a distancia X.880X.899PROCESAMIENTO DISTRIBUIDO ABIERTO X.900X.999Recomendacin X.446 (08/97

8、) iRECOMENDACIN UIT-T X.446INTERFAZ DE PROGRAMAS DE APLICACIN PARALLAMADAS DE MENSAJERA COMNResumenEsta Recomendacin especifica una interfaz de llamada simple a travs de la cual las aplicaciones basadas en mensajerapueden invocar los servicios del sistema de tratamiento de mensajes (MHS) mediante un

9、a interfaz de programacinnormalizada. Esta Recomendacin se elabor en cooperacin con la Asociacin XAPI y define la interfaz deprogramacin de aplicaciones que est siendo implementada, para el MHS, por los vendedores y proveedores deservicios ms importantes en el mundo.OrgenesLa Recomendacin UIT-T X.44

10、6 ha sido preparada por la Comisin de Estudio 7 (1997-2000) del UIT-T y fue aprobadapor el procedimiento de la Resolucin N. 1 de la CMNT el 9 de agosto de 1997.ii Recomendacin X.446 (08/97)PREFACIOLa UIT (Unin Internacional de Telecomunicaciones) es el organismo especializado de las Naciones Unidas

11、en el campode las telecomunicaciones. El UIT-T (Sector de Normalizacin de las Telecomunicaciones de la UIT) es un rganopermanente de la UIT. Este rgano estudia los aspectos tcnicos, de explotacin y tarifarios y publica Recomendacionessobre los mismos, con miras a la normalizacin de las telecomunicac

12、iones en el plano mundial.La Conferencia Mundial de Normalizacin de las Telecomunicaciones (CMNT), que se celebra cada cuatro aos,establece los temas que han de estudiar las Comisiones de Estudio del UIT-T, que a su vez producen Recomendacionessobre dichos temas.La aprobacin de Recomendaciones por l

13、os Miembros del UIT-T es el objeto del procedimiento establecido en laResolucin N. 1 de la CMNT.En ciertos sectores de la tecnologa de la informacin que corresponden a la esfera de competencia del UIT-T, sepreparan las normas necesarias en colaboracin con la ISO y la CEI.NOTAEn esta Recomendacin, la

14、 expresin “Administracin“ se utiliza para designar, en forma abreviada, tanto unaadministracin de telecomunicaciones como una empresa de explotacin reconocida de telecomunicaciones.PROPIEDAD INTELECTUALLa UIT seala a la atencin la posibilidad de que la utilizacin o aplicacin de la presente Recomenda

15、cin suponga elempleo de un derecho de propiedad intelectual reivindicado. La UIT no adopta ninguna posicin en cuanto a lademostracin, validez o aplicabilidad de los derechos de propiedad intelectual reivindicados, ya sea por los miembros dela UIT o por terceros ajenos al proceso de elaboracin de Rec

16、omendaciones.En la fecha de aprobacin de la presente Recomendacin, la UIT ha recibido/no ha recibido notificacin de propiedadintelectual, protegida por patente, que puede ser necesaria para aplicar esta Recomendacin. Sin embargo, debe sealarsea los usuarios que puede que esta informacin no se encuen

17、tre totalmente actualizada al respecto, por lo que se les instaencarecidamente a consultar la base de datos sobre patentes de la TSB. UIT 1997Es propiedad. Ninguna parte de esta publicacin puede reproducirse o utilizarse, de ninguna forma o por ningn medio,sea ste electrnico o mecnico, de fotocopia

18、o de microfilm, sin previa autorizacin escrita por parte de la UIT.Recomendacin X.446 (08/97) iiiNDICEPgina1 Introduccin . 11.1 Finalidad . 11.2 Visin de conjunto 11.3 Terminologa. 21.3.1 Definiciones 21.3.2 Abreviaturas 21.4 Documentos a que se hace referencia . 31.4.1 Recomendaciones | Normas Inte

19、rnacionales idnticas 31.4.2 Pares de Recomendaciones | Normas Internacionales de contenido tcnico equivalente . 31.4.3 Referencias adicionales. 31.5 Niveles 41.6 Convenios de denominacin. 42 Arquitectura de la CMC . 52.1 Modelo funcional 52.2 Modelo computacional . 62.2.1 Interfaces. 62.2.2 Sesin 72

20、.2.3 Soporte de caracteres formados por dos octetos . 72.2.4 Notificacin de eventos. 72.2.5 Extensiones . 82.3 Modelo de configuracin 82.3.1 Gestor de CMC . 92.3.2 Directrices para vinculaciones de plataformas 102.3.3 Consulta de la informacin de configuracin . 102.4 Modelo de objeto 102.4.1 Compone

21、ntes del modelo 103 Clases de objetos de CMC . 133.1 Clases de objetos API de CMC. 133.1.1 Libro de direcciones 143.1.2 tem de contenido 143.1.3 Lista de distribucin 143.1.4 Mensaje. 143.1.5 Contenedor de mensajes . 153.1.6 Informacin por cada recibiente . 153.1.7 Contenedor de perfiles 163.1.8 Reci

22、biente . 163.1.9 Informe 163.1.10 Contenedor raz. 174 Estructuras de datos 174.1 Tipos de datos bsicos 184.2 Tipos de datos de matriz . 184.3 Aadidura . 204.4 Booleano. 214.5 Memoria tampn. 214.6 Estructuras de datos de llamada de retorno. 214.7 Cadena contada. 234.8 Asa de cursor 244.9 Restriccin d

23、e cursor 244.10 Clave de clasificacin de cursor . 26iv Recomendacin X.446 (08/97)Pgina4.11 Tabla de despacho. 274.12 Enumerado 334.13 Eventos . 334.14 Extensin 334.15 Banderas . 344.16 GUID 354.17 Identificador 354.18 Fecha y hora ISO 354.19 Mensaje. 364.20 Referencia de mensaje 384.21 Sumario de me

24、nsaje 394.22 Nombre . 394.23 Asa de objeto 404.24 Identificador de objeto 404.25 Datos opacos. 404.26 Propiedad 414.27 Recibiente . 424.28 Informe . 434.29 Cdigo de retorno . 444.30 Identificador de sesin 444.31 Asa de tren 444.32 Cadena 454.33 Tiempo (u hora) 454.34 Identificador de interfaz de usu

25、ario 465 Propiedades de objetos. 465.1 Propiedades del objeto de libro de direcciones. 565.1.1 Vstago permitido. 565.1.2 Comentario 565.1.3 Ubicacin 575.1.4 Nombre . 575.1.5 Clase de objeto 575.1.6 Progenitor 585.1.7 Nombre del servidor . 585.1.8 Compartido . 585.1.9 Tipo. 585.2 Propiedades del obje

26、to de tem de contenido 595.2.1 Juego de caracteres . 595.2.2 Informacin de contenido . 595.2.3 Tipo de contenido . 605.2.4 Hora de creacin . 625.2.5 Tipo de codificacin . 625.2.6 Directorio de ficheros . 635.2.7 Nombre de fichero 635.2.8 Nmero de tem. 645.2.9 Tipo de tem 645.2.10 ltimo modificado 64

27、5.2.11 Clase de objeto 645.2.12 Posicin de reproduccin655.1.13 Tamao . 655.2.14 Ttulo. 655.3 Propiedades del objeto de lista de distribucin. 665.3.1 Direccin. 665.3.2 Comentario 665.3.3 Hora de la ltima modificacin. 66Recomendacin X.446 (08/97) vPgina5.3.4 Nombre . 665.3.5 Clase de objeto 675.3.6 Pr

28、ogenitor 675.3.7 Compartida 675.4 Propiedades del objeto de mensaje . 675.4.1 Identificador de aplicacin 685.4.2 Estado de mensaje de aplicacin. 685.4.3 Accin automtica. 685.4.4 Hora de entrega diferida 695.4.5 Identificador 695.4.6 Estado de mensaje de entrada . 695.4.7 En respuesta a . 705.4.8 Cue

29、nta de tems. 705.4.9 Diagnstico de la notificacin de no recepcin 705.4.10 Motivo de la notificacin de no recepcin 705.4.11 Clase de objeto 715.4.12 Estado de mensaje de salida 715.4.13 Prioridad 725.4.14 Recibo solicitado. 725.4.15 Tipo de recepcin 735.4.16 Informe solicitado . 735.4.17 Rol (o papel

30、) . 735.4.18 Sensibilidad. 745.4.19 Tamao . 745.4.20 Asunto. 755.4.21 Hora de recepcin . 755.4.22 Hora de envo 755.4.23 Tipo. 755.5 Propiedades del objeto de contenedor de mensajes 765.5.1 Vstago permitido. 765.5.2 Comentario 765.5.3 Ubicacin 775.5.4 Nombre . 775.5.5 Clase de objeto 775.5.6 Progenit

31、or 785.5.7 Nombre del servidor . 785.5.8 Compartido . 785.5.9 Tipo. 785.6 Propiedades del objeto informacin por cada recibiente 795.6.1 Comentario 795.6.2 Hora de entrega. 795.6.3 Diagnstico . 795.6.4 Clase de objeto 805.6.5 Motivo (o razn) . 805.6.6 Direccin de recibiente . 805.6.7 Nombre de recibi

32、ente 805.6.8 Tipo. 815.7 Propiedades del objeto de contenedor de perfiles.815.7.1 Accin automtica. 815.7.2 Juego de caracteres . 825.7.3 Conformidad . 825.7.4 Servicio por defecto 825.7.5 Usuario por defecto. 835.7.6 Terminador de lnea 835.7.7 Clase de objeto 835.7.8 Extensiones de objetos soportada

33、s 835.7.9 Objetos soportados 845.7.10 Propiedades soportadas. 845.7.11 Extensiones de propiedades soportadas 845.7.12 Contrasea requerida 845.7.13 Servicio requerido. 85vi Recomendacin X.446 (08/97)Pgina5.7.14 Usuario requerido . 855.7.15 Soporte de cadenas contadas. 855.7.16 Soporte de ausencia de

34、marca como leer 855.7.17 Interfaz de usuario disponible . 865.7.18 Usuarios 865.7.19 Versin de la implementacin. 865.7.20 Versin de la especificacin . 865.8 Propiedades de objetos de recibientes 875.8.1 Direccin. 875.8.2 Retorno de contenido solicitado 875.8.3 Nombre . 875.8.4 Clase de objeto 875.8.

35、5 Recibo solicitado. 885.8.6 Informe solicitado . 885.8.7 Bandera de responsabilidad 895.8.8 Rol (o papel) . 895.8.9 Tipo. 905.9 Propiedades del objeto de informe 905.9.1 Identificador de aplicacin905.9.2 Identificador 905.9.3 Cuenta de tems. 915.9.4 Identificador del sistema de mensajera 915.9.5 Cl

36、ase de objeto 915.9.6 Ledo . 915.9.7 Tamao . 925.9.8 Asunto. 925.9.9 Identificador de mensaje de asunto. 925.9.10 Hora de recepcin . 925.9.11 Hora de envo 935.9.12 No enviado 935.10 Propiedades del objeto de contenedor raz . 935.10.1 Vstago permitido. 935.10.2 Comentario 935.10.3 Ubicacin 945.10.4 N

37、ombre . 945.10.5 Clase de objeto 945.10.6 Compartido . 956 Funciones de la interfaz . 956.1 Funciones de la CMC simple. 956.1.1 Envo de mensajes. 966.1.2 Recepcin de mensajes . 1006.1.3 Consulta de nombres. 1066.1.4 Administracin 1096.2 Funciones de la CMC completa 1166.2.1 Funciones de vinculacin 1

38、176.2.2 Funciones de composicin 1196.2.3 Funciones de enumeracin 1306.2.4 Funciones de notificacin de eventos . 1446.2.5 Funciones de mensajera . 1496.2.6 Funciones de tratamiento de nombres. 1526.2.7 Funciones de trenes. 1547 Cdigos de retorno . 1608 Conformidad 175Anexo A Sumario de declaraciones

39、en el lenguaje de programacin C 177A.1 Sumario de declaracin en lenguaje C 177Recomendacin X.446 (08/97) viiPginaAnexo B Extensiones de vendedores de CMC 220B.1 Extensiones de vendedores de CMC 220B.1.1 Extensiones de funciones 221B.1.2 Extensiones de datos . 227B.2 Sumario de las declaraciones en l

40、enguaje C para el conjunto de extensiones 229B.2.1 Conjunto de extensiones X.400 230B.2.2 Extensiones adicionales para la correspondencia CMC simple/X400 231B.2.3 Otros conjuntos de extensiones. 234B.2.4 Informacin especfica de la plataforma, incluidas las vinculaciones durante laejecucin . 234B.2.5

41、 Utilizacin de servicios X.400 fundamentales por la CMC simple 236Anexo C Ejemplos de programacin. 255C.1 Ejemplos de programacin . 255C.1.1 Funciones de indagar configuracin (query configuration), establecer sesin (logon) yterminar sesin (logoff). 255C.1.2 Funciones de enviar (send) y enviar docume

42、ntos (send documents) 255C.1.3 Funciones de listar (list), leer (read), y suprimir (delete) el primer mensaje no ledo 257C.1.4 Consultar sobre un recibiente especfico y obtener sus detalles . 258C.1.5 Utilizacin de extensiones 258C.1.6 cmc_bind_implementation 259C.2 Ejemplo de cmc_bind_implementatio

43、n 261C.3 Composicin de un mensaje . 262C.4 Comprobacin para determinar la presencia de nuevos mensajes 265C.5 Archivo de un mensaje . 267C.6 Supresin de un mensaje 271C.7 Extraccin de un mensaje . 273Recomendacin X.446 (08/97) 1Recomendacin X.446Recomendacin X.446 (08/97)INTERFAZ DE PROGRAMAS DE APL

44、ICACIN PARALLAMADAS DE MENSAJERA COMN(Ginebra, 1997)1 IntroduccinEsta clusula introduce la interfaz de programas de aplicacin (API, application program interface) para llamadas demensajera comn (CMC, common messaging call) y sus especificaciones. Expresa la finalidad de la interfaz,proporciona una v

45、isin de conjunto del mismo, indica las abreviaturas utilizadas, proporciona referencias a documentos,explica el nivel de abstraccin de la interfaz, define convenios de denominacin en el lenguaje de programacin C yespecifica requisitos de conformidad.Esta Recomendacin es un perfeccionamiento de la pr

46、imera versin de API para CMC (brevemente CMC API)publicada en junio de 1993 por la Asociacin API X.400 (o XAPIA). Esta Recomendacin ampla el soporte de lasaplicaciones conscientes de la mensajera (messaging-aware application) en el documento original con el soporte deaplicaciones basadas en la mensa

47、jera (messaging-reliant application).1.1 FinalidadEsta Recomendacin tiene por finalidad especificar una interfaz de programas de aplicacin de mensajera de alto nivelque pueda ser soportada por la mayor parte de los servicios de mensajera empleados en la actualidad. Se tiene laintencin de que la API

48、permita a los programadores de aplicaciones integrar fcilmente la mensajera, y por tanto lascomunicaciones, en sus aplicaciones, creando un amplio cuerpo de aplicaciones habilitadas para mensajera(messaging-enabled applications).Esta Recomendacin est dirigida a los desarrolladores de servicios de mensajera que pudieran desear soportar esainterfaz de programas de aplicacin. Esta Recomendacin puede tambin orientar a los desarrolladores de aplicacionespara la comprensin de aquellas caractersticas de la API para llamadas de mensajera comn que son independientes dela aplicac