Network Working Group                                      H. Alvestrand
Request for Comments: 1495                                  SINTEF DELAB
Updates: 1327                                                   S. Kille
                                                       ISODE Consortium
                                                               R. Miles
                                                      Soft*Switch, Inc.
                                                                M. Rose
                                           Dover Beach Consulting, Inc.
                                                            S. Thompson
                                                      Soft*Switch, Inc.
                                                            August 1993

           Mapping between X.400 and RFC-822 Message Bodies

Status of this Memo

  This RFC specifies an IAB standards track protocol for the Internet
  community, and requests discussion and suggestions for improvements.
  Please refer to the current edition of the "IAB Official Protocol
  Standards" for the standardization state and status of this protocol.
  Distribution of this memo is unlimited.

Table of Contents

  1.  Introduction .............................................    1
  2.  Approach .................................................    2
  3.  Mapping between X.400 and RFC-822 Message Bodies .........    3
  3.1  Mapping from X.400 to RFC-822 ...........................    4
  3.2  Mapping from RFC-822 to X.400 ...........................    5
  3.2.1 Asymmetric Mappings ....................................    6
  3.2.1.1 Message/External-Body ................................    6
  3.2.1.2 Message/Partial ......................................    6
  3.2.1.3 Nested Multipart Content-types .......................    6
  3.2.2 Multipart IPMS Heading Extension .......................    7
  4.  Mapping between X.400 and RFC-822 Message Headers ........    7
  5.  OID Assignments ..........................................    9
  6.  Security Considerations ..................................    9
  7.  Authors' Addresses .......................................   10
  8.  References ...............................................   11

1.  Introduction

  The Internet community is a large collection of networks under
  autonomous administration, but sharing a core set of protocols.
  These are known as the Internet suite of protocols (or simply
  "TCP/IP").

  Use of electronic-mail in the Internet is defined primarily by one



Alvestrand, Kille, Miles, Rose & Thompson                       [Page 1]

RFC 1495            MHS/RFC-822 Message Body Mapping         August 1993


  document, STD-11, RFC-822 [1], which defines the standard format for
  the exchange of messages.  RFC-822 has proven immensely popular; in
  fact, the 822-connected Internet, is larger than the scope of the
  IP-connected Internet.

  The framework provided by RFC-822 allows for memo-based textual
  messages.  Each message consists of two parts:  the headers and the
  body.  The headers are analogous to the structured fields found in an
  inter-office memo, whilst the body is free-form.  Both parts are
  encoded using ASCII.

  Recently, the Internet Engineering Task Force (IETF) has developed an
  document called,

     Multipurpose Internet Mail Extensions

  or MIME RFC-1341.  The title is actually misleading.  MIME defines
  structure for Internet message bodies.  It is not an extension to
  RFC-822.

  Independently of this, the International standards community
  developed a different framework in 1984 (some say that's the
  problem).  This framework is known as the OSI Message Handling System
  (MHS) or sometimes X.400.

  Since the introduction of X.400(84), there has been work ongoing for
  defining mappings between MHS and RFC-822.  The most recent work in
  this area is RFC-1327 [3], which focuses primarily on translation of
  envelope and headers.  This document is complimentary to RFC-1327 as
  it focuses on translation of the message body.  The mappings defined
  are largely symmetrical with respect to MIME and MHS structuring
  semantics, although the MIME semantics are somewhat richer.  In order
  to provide for reversible transformations, MHS heading extensions are
  used to carry the additional MIME semantics.

  Please send comments to the MIME-MHS mailing list:
  <[email protected]>.

2.  Approach

  The mappings have been specifically designed to provide optimal
  behavior for three different scenarios:

  (1) Allow a MIME user and an MHS user to exchange an arbitrary binary
      content;

  (2) Allow MIME content-types to "tunnel" through an MHS relay that
      is, two MIME users can exchange content-types without loss



Alvestrand, Kille, Miles, Rose & Thompson                       [Page 2]

RFC 1495            MHS/RFC-822 Message Body Mapping         August 1993


      through an MHS relay); and,

  (3) Allow MHS body parts to "tunnel" through a MIME relay that is,
      two MHS users can exchange body parts without loss through a MIME
      relay).

  Other, related, scenarios can also be easily accommodated.

  To facilitate the mapping process, the Internet Assigned Numbers
  Authority (IANA) maintains a table termed the "IANA MHS/MIME
  Equivalence Table".  Once an enterprise has registered an OID to
  describe an MHS body part, it should complete a corresponding
  registry with the IANA for a MIME content-type/subtype.  In practice,
  the corresponding content-type will be "application", with an
  appropriate choice of sub-type and possible parameters.  If a new
  MIME content-type/subtype is registered with the IANA without a
  corresponding entry in the Equivalence Table, the IANA will assign it
  an OID, from the arc defined in this memo. See [4], section 5 for
  details.

  The companion document, "Equivalences between 1988 X.400 and RFC-822
  Message Bodies"[4], defines the initial configuration of this table.
  The mappings described in both this document and the companion
  document use the notational conventions of RFC-1327.

3.  Mapping between X.400 and RFC-822 Message Bodies

  MHS messages are comprised of an IPMS.heading and an IPMS.body.  The
  IPMS.Body is a sequence of IPMS.BodyParts.  An IPMS.BodyPart may be a
  nested message (IPMS.MessageBodyPart).

  A MIME message consists of headers and a content.  For the purpose of
  discussion, the content may be structured (multipart or message), or
  atomic (otherwise).  An element of a structured content may be a
  message or a content.  Both message and structured content have
  subtypes which do not have direct analogies in MHS.

  The mapping between X.400 and RFC-822 message bodies which this
  document defines is symmetrical for the following cases:

         (1) any atomic body part

         (2) multipart: digest and mixed subtypes

         (3) message/rfc822

  RFC-1327 specifies the mappings for headers.  Section 4 describes how
  those mappings are modified by this document.  When mapping between



Alvestrand, Kille, Miles, Rose & Thompson                       [Page 3]

RFC 1495            MHS/RFC-822 Message Body Mapping         August 1993


  an MHS body and a MIME content, the following algorithm is used:

3.1.  Mapping from X.400 to RFC-822

  This section replaces the text in RFC-1327 starting at the bottom of
  page 84,

      The IPMS.Body is mapped into the RFC-822 message body.  Each
      IPMS.BodyPart is converted to ASCII as follows:

  and continuing up to and including page 86 of Section 5.3.4 of RFC-
  1327.

            If the IPMS.Body

                 Body ::=
                     SEQUENCE OF
                         BodyPart

  consists of a single body part, then the RFC-822 message body is
  constructed as the MIME content corresponding to that body part.

  If the body part is an IPMS.MessageBodyPart (forwarded IPM), the
  mapping is applied recursively.  Otherwise, to map a specific MHS
  body part to a MIME content-type, the IANA MHS/MIME Equivalence table
  is consulted.  If the MHS body part is not identified in this table,
  then the body-part is mapped onto an "application/x400-bp" content,
  as specified in [4].

  If the IPMS.Body consists of more than one body part, then the RFC-
  822 message body is constructed as a

         multipart/mixed

  content-type, unless all of the body parts are messages, in which
  case it is mapped to a

         multipart/digest

  content-type.  Each component of the multipart content-type
  corresponds to a IPMS.BodyPart, preserving the ordering of the body
  parts in the IPMS.Body.

  There is one case which gets special treatement.  If the IPMS.Body
  consists solely of a single IA5Text body part, then the RFC822
  message body is NOT marked as a MIME content.  This prevents RFC822
  mailers from invoking MIME function unnecessarily.




Alvestrand, Kille, Miles, Rose & Thompson                       [Page 4]

RFC 1495            MHS/RFC-822 Message Body Mapping         August 1993


3.2.  Mapping from RFC-822 to X.400

  First, replace the first paragraph of Section 5.1.3 on page 72 of
  RFC-1327 to read as:

      The IPM (IPMS Service Request) is generated according to the
      rules of this section.  The IPMS.body usually consists of one
      IPMS.BodyPart of type

                          IPMS.IA5TextBodyPart

                     with
                          IPMS.IA5TextBodyPart.parameters.repertoire

      set to the default (ia5), which contains the body of the RFC-822
      message.  However, if the 822.MIME-Version header field is
      present, a special algorithm is used to generate the IPMS.body.


      Second, replace the "Comments:" paragraph on page 74 to reads as:

      Comments:

         If an 822.MIME-Version header field is not present,
         generate an IPMS.Bodypart of type

             IPMS.IA5TextBodyPart

         with

             IPMS.IA5TextBodyPart.parameters.repertoire

         set to the default (ia5), containing the value of
         the fields, preceded by the string "Comments: ".
         This body part shall preceed the other one.

  Third, add the remainder of this section to the end of Section 5.1.3
  of RFC-1327.

  If the 822.MIME-Version header field is present, the following
  mapping rules are used to generate the IPMS.body.

  If the MIME content-type is one of:

  (1)  any atomic body part

  (2)  multipart: digest and mixed subtypes




Alvestrand, Kille, Miles, Rose & Thompson                       [Page 5]

RFC 1495            MHS/RFC-822 Message Body Mapping         August 1993


  (3)  message/rfc822

  then the symmetric mapping applies as described in Section 6.1.  Note
  that the multipart content-types should be marked with the
  IPMS.HeadingExtension described below.

  Otherwise, three cases remain, which are discussed in turn.

3.2.1.  Asymmetric Mappings

3.2.1.1.  Message/External-Body

  This is mapped into a mime-body-part, as specified in [4].

3.2.1.2.  Message/Partial

  This is mapped onto a message, and the following heading extension is
  used.  The extension is derived from the message/partial parameters:

                 partial-message  HEADING-EXTENSION
                     VALUE PartialMessage
                     ::= id-hex-partial-message

                 PartialMessage ::=
                     SEQUENCE {
                         number INTEGER,
                         total  INTEGER,
                         id     IA5String
                     }

  If this heading is present when mapping from MHS to MIME, then a
  message/partial should be generated.

3.2.1.3.  Nested Multipart Content-types

  In MIME, a multipart content refers to a set of content-types, not a
  message with a set of content-types. However, a nested multipart
  content will always be mapped to an IPMS.MessageBodyPart, with an
  IPMS.BodyPart for each contained content-type.

  The only mandatory field in the heading is the IPMS.this-IPM, which
  must always be generated (by the gateway). A IPMS.subject field
  should also be generated where there is no "real" heading. This will
  present useful information to the non-MIME capable X.400(88) and to
  all X.400(84) UAs.






Alvestrand, Kille, Miles, Rose & Thompson                       [Page 6]

RFC 1495            MHS/RFC-822 Message Body Mapping         August 1993


  The IPM.subject fields for the various types are:

  mixed:        "Multipart Message"
  alternative:  "Alternate Body Parts containing the same information"
  digest:       "Message Digest"
  parallel:     "Body Parts to be interpreted in parallel"

3.2.2.  Multipart IPMS Heading Extension

  The following IPMS.HeadingExtension should be generated for all
  multipart content-types, with the enumerated value set according to
  the subtype:

                 multipart-message HEADING-EXTENSION
                     VALUE MultipartType
                     ::= id-hex-multipart-message

                 MultipartType ::=
                     ENUMERATED {
                         mixed(1),
                         alternative(2),
                         digest(3),
                         parallel(4)
                     }

  If this heading is present when mapping from MHS to MIME, then the
  appropriate multipart content-type should be generated.

4.  Mapping between X.400 and RFC-822 Message Headers

  Replace the first paragraph of Section 3.3.4 on page 26 of RFC-1327
  to read as:
       In cases where T.61 strings are used only for conveying human-
       interpreted information, the aim of this mapping is to render
       the characters appropriately in the remote character set, rather
       than to maximize reversibility.  For these cases, the following
       steps are followed to find an appropriate encoding:

       1) If all the characters in the string are contained within the
       ASCII repertoire, the string is simply copied.

       2) If all the characters in the string are from an IANA-
       registered character set, then the appropriate encoded-word(s)
       according to [5] are generated instead.

       3) If the characters in the string are from a character set
       which is not registered with the IANA, then the mappings to IA5
       defined in CCITT Recommendation X.408 (1988) shall be used



Alvestrand, Kille, Miles, Rose & Thompson                       [Page 7]

RFC 1495            MHS/RFC-822 Message Body Mapping         August 1993


       [CCITT/ISO88a].  These will then be encoded in ASCII.

       This approach will only be used for human-readable information
       (Subject and FreeForm Name).

       When mapping from an RFC-822 header, when an encoded-word (as
       defined in [5]) is encountered:

       1) If all the characters contained therein are mappable to T.61,
       the string content shall be converted into T.61.

       2) Otherwise, the encoded-word shall be copied directly into the
       T.61 string.

  Modify procedure "2a" on page 56 of RFC-1327 to read as:
       If the IPMS.ORDescriptor.free-form-name is present, convert it
       to ASCII or T.61 (Section 3.3.4), and use this as the 822.phrase
       component of the 822.mailbox construct.

  Modify the final paragraph of procedure "2" on page 55 of RFC-1327 to
  read as:
       The string is then encoded into T.61 or ASCII using a human-
       oriented mapping (as described in Section 3.3.4).  If the string
       is not null, it is assigned to IPMS.ORDescriptor.free-form.name.

  Modify the second paragraph of procedure "3" on page 55 of RFC-1327
  to read as:
       If the 822.group construct is present, any included 822.mailbox
       is encoded as above to generate a separate IPMS.ORDescriptor.
       The 822.group is mapped to T.61 or ASCII (as described in
       Section 3.3.4), and an IPMS.ORDescriptor with only an free-
       form-name component is built from it.

  Modify procedure "822.Subject" on page 62 of RFC-1327 to read as:

       Mapped to IMPS.Heading.subject.  The field-body uses the human-
       oriented mapping referenceed in Section 3.3.4.

  Modify procedure "IPMS.Heading.subject" on page 71 of RFC-1327 to
  read as:
       Mapped to "Subject:".  The contents are converted to ASCII or
       T.61 (Section 3.3.4).  Any CRLF are not mapped, but are used as
       points at which the subject field must be folded.








Alvestrand, Kille, Miles, Rose & Thompson                       [Page 8]

RFC 1495            MHS/RFC-822 Message Body Mapping         August 1993


5.  OID Assignments

  MIME-MHS DEFINITIONS ::= BEGIN


  mail OBJECT IDENTIFIER ::= { internet 7 }

  mime-mhs OBJECT IDENTIFIER ::= { mail 1 }

  mime-mhs-headings OBJECT IDENTIFIER ::= { mime-mhs 1 }

  id-hex-partial-message OBJECT IDENTIFIER ::=
          { mime-mhs-headings 1 }

  id-hex-multipart-message OBJECT IDENTIFIER ::=
          { mime-mhs-headings 2 }


  mime-mhs-bodies OBJECT IDENTIFIER ::= { mime-mhs 2 }


  END

6.  Security Considerations

  There are no explicit security provisions in this document.  However,
  a warning is in order.  This document maps two mechanisms between
  RFC822 and X.400 that could cause problems.  The first is the
  transfer of binary files.  The inherent risks are well known and
  won't be reiterated here.  The second is the propagation of strong
  content typing.  The typing can be used to automatically "launch" or
  initiate applications against those contents.  Any such launching
  leaves the invoker vulnerable to application-specific viruses; for
  example, a spreadsheet macro or Postscript command that deletes
  files.  See [2], Section 7.4.2 for a Postscript-specific discussion
  of this issue.















Alvestrand, Kille, Miles, Rose & Thompson                       [Page 9]

RFC 1495            MHS/RFC-822 Message Body Mapping         August 1993


7.  Authors' Addresses

  Harald Tveit Alvestrand
  SINTEF DELAB
  N-7034 Trondheim
  NORWAY

  EMail: [email protected]


  Steve Kille
  ISODE Consortium
  P.O. Box 505
  London
  SW11 1DX
  England

  Phone: +44-71-223-4062
  EMail: [email protected]


  Robert S. Miles
  Soft*Switch, Inc.
  640 Lee Road
  Wayne, PA 19087

  Phone: (215) 640-7556
  EMail: [email protected]


  Marshall T. Rose
  Dover Beach Consulting, Inc.
  420 Whisman Court
  Mountain View, CA  94043-2186
  US

  Phone: +1 415 968 1052
  Fax:   +1 415 968 2510
  EMail: [email protected]


  Steven J. Thompson
  Soft*Switch, Inc.
  640 Lee Road
  Wayne, PA 19087

  Phone: (215) 640-7556
  EMail: [email protected]



Alvestrand, Kille, Miles, Rose & Thompson                      [Page 10]

RFC 1495            MHS/RFC-822 Message Body Mapping         August 1993


8.  References

  [1] Crocker, D., "Standard for the Format of ARPA Internet Text
      Messages", STD 11, RFC 822, UDEL, August 1982.

  [2] Borenstein, N., and N. Freed, "MIME: Mechanisms for Specifying
      and Describing the Format of Internet Message Bodies", RFC 1341,
      Bellcore, Innosoft, June 1992.

  [3] Hardcastle-Kille, S., "Mapping between X.400(1988) / ISO 10021
      and RFC-822", RFC 1327, University College London, May 1992.

  [4] Alvestrand, H., and S. Thompson, "Equivalences between 1988 X.400
      and RFC-822 Message Bodies", RFC 1494, SINTEF DELAB, Soft*Switch,
      Inc., August 1993.

  [5] Moore, K., "Representation of Non-ASCII Text in Internet Message
      Headers Message Bodies", RFC 1342, University of Tennesse, June
      1992.
































Alvestrand, Kille, Miles, Rose & Thompson                      [Page 11]