INTERNET-DRAFT                             Henrik Frystyk Nielsen,
draft-nielsen-dime-01                      Henry Sanders,
                                           Erik Christensen,
                                           Christian Huitema,
                                           Microsoft,
Expires August 2002                        February 01, 2002

                Direct Internet Message Encapsulation (DIME)


Status of this Memo


     This document is an Internet-Draft and is subject to all provisions
     of Section 10 of RFC2026.


     Internet-Drafts are working documents of the Internet Engineering
     Task Force (IETF), its areas, and its working groups.  Note that
     other groups may also distribute working documents as Internet-
     Drafts.


     Internet-Drafts are draft documents valid for a maximum of six
     months and may be updated, replaced, or obsoleted by other
     documents at any time.  It is inappropriate to use Internet-Drafts
     as reference material or to cite them other than as "work in
     progress."


     The list of current Internet-Drafts can be accessed at
     "http://www.ietf.org/ietf/1id-abstracts.txt"


     The list of Internet-Draft Shadow Directories can be accessed at
     "http://www.ietf.org/shadow.html".


     Please send comments to the "dime@discuss.develop.com" mailing
     list. Discussions are archived at
     "http://discuss.develop.com/dime.html".


Abstract


     Direct Internet Message Encapsulation (DIME) is a lightweight,
     binary message format that can be used to encapsulate one or more
     application-defined payloads of arbitrary type and size into a
     single message construct. Each payload is described by a type, a
     length, and an optional identifier. Both URIs and MIME media type
     constructs are supported as type identifiers. The payload length is
     an integer indicating the number of octets of the payload. The
     optional payload identifier is a URI enabling cross-referencing

Nielsen, et al.                                               [Page 1]


INTERNET-DRAFT                     DIME                  October, 2001

     between payloads. DIME payloads may include nested DIME messages or
     chains of linked chunks of unknown length at the time the data is
     generated. DIME is strictly a message format: it provides no
     concept of a connection or of a logical circuit, nor does it
     address head-of-line problems.


Table of Contents

     1  Introduction................................................3
     1.1   Notational Conventions...................................3
     1.2   Design Goals.............................................4
     1.3   DIME Terminology.........................................5
     1.4   Intended Usage...........................................6
     2  The DIME Mechanisms.........................................7
     2.1   DIME Encapsulation Constructs............................7
     2.1.1   Message................................................7
     2.1.2   Record.................................................8
     2.1.3   Record Chunks..........................................8
     2.2   DIME Payload Description.................................9
     2.2.1   Payload Length.........................................9
     2.2.2   Payload Type...........................................9
     2.2.3   Payload Identification................................11
     3  The DIME Specifications....................................11
     3.1   Data Transmission Order.................................11
     3.2   Record Layout...........................................12
     3.2.1   MB (Message Begin)....................................12
     3.2.2   ME (Message End)......................................12
     3.2.3   CF (Chunk Flag).......................................13
     3.2.4   ID_LENGTH.............................................13
     3.2.5   TNF (Type Name Format)................................13
     3.2.6   TYPE_LENGTH...........................................14
     3.2.7   DATA_LENGTH...........................................14
     3.2.8   ID....................................................15
     3.2.9   TYPE..................................................15
     3.2.10  DATA..................................................16
     3.3   Use of URIs in DIME.....................................16
     4  Internationalization Considerations........................17
     5  Security Considerations....................................17
     6  IANA Considerations........................................17
     6.1   Registration: application/dime..........................17
     7  Intellectual Property......................................19
     8  Acknowledgements...........................................19
     9  References.................................................19
     10 Authors' Addresses.........................................20










Nielsen, et al.                                               [Page 2]


INTERNET-DRAFT                     DIME                  October, 2001


1  Introduction


     Direct Internet Message Encapsulation (DIME) is a lightweight,
     binary message format designed to encapsulate one or more
     application-defined payloads into a single message construct. A
     DIME message contains one or more DIME records each carrying a
     payload of arbitrary type and up to 2^32-1 octets in size. Records
     can be chained together to support larger payloads. A DIME record
     carries three parameters for describing its payload: the payload
     length, the payload type, and an optional payload identifier. The
     purpose of these parameters is as follows:


     The payload length


          The payload length indicates the number of octets in the
          payload (see section 2.2.1). By providing the payload length
          within the first 8 octets of a record, efficient record
          boundary detection is possible.


     The payload type


          The DIME payload type identifier indicates the type of the
          payload. DIME supports both URIs [10] as well as MIME media
          type constructs [7] as type identifiers (see section 2.2.2).
          By indicating the type of a payload, it is possible to
          dispatch the payload to the appropriate user application.


     The payload identifier


          A payload may be given an optional identifier in the form of
          an absolute or relative URI (see section 2.2.3). The use of an
          identifier enables payloads that support URI linking
          technologies to cross-reference other payloads.


1.1  Notational Conventions


     The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
     "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in
     this document are to be interpreted as described in RFC 2119 [9].






Nielsen, et al.                                               [Page 3]


INTERNET-DRAFT                     DIME                  October, 2001

1.2  Design Goals


     Because of the large number of existing message encapsulation
     formats, record marking protocols and multiplexing protocols, it is
     best to be explicit about the design goals of DIME and, in
     particular, about what is outside the scope of DIME.


     The design goal of DIME is to provide an efficient and simple
     message format that can accommodate the following:


     1.   Encapsulating arbitrary documents and entities, including
          encrypted data, XML documents, XML fragments, image data like
          GIF and JPEG files, etc.


     2.   Encapsulating documents and entities initially of unknown
          size. This capability can be used to encapsulate dynamically
          generated content or very large entities as a series of
          chunks.


     3.   Aggregating multiple documents and entities that are logically
          associated in some manner into a single message. For example,
          DIME can be used to encapsulate a SOAP message and a set of
          attachments referenced from that SOAP message.


     In order to achieve efficiency and simplicity, the mechanisms
     provided by this specification have been deliberately limited to
     serve these purposes. DIME has not been designed as a general
     message description or document format such as MIME or XML.
     Instead, DIME-based applications can take advantage of such formats
     by encapsulating them in DIME messages.


     The following list identifies what is outside the scope of DIME:


     1.   DIME does not make any assumptions about the types of payloads
          that are carried within DIME messages or about the message
          exchange patterns of such messages.


     2.   DIME does not in any way introduce the notion of a connection
          or of a logical circuit (virtual or otherwise).


     3.   DIME does not attempt to deal with head-of-line blocking
          problems that might occur when using stream-oriented protocols
          like TCP.


Nielsen, et al.                                               [Page 4]


INTERNET-DRAFT                     DIME                  October, 2001

1.3  DIME Terminology


     DIME message


          The basic message construct defined by this specification. A
          DIME message contains one or more DIME records (see section
          2.1.1).


     DIME record


          A DIME record contains a payload described by a type, a
          length, and an optional identifier (see section 2.1.2).


     DIME record chunk


          A DIME record that has been marked as containing a chunk of a
          payload rather than a full payload (see section 2.1.3).


     DIME payload


          The data carried within a DIME record defined by a user
          application.


     DIME chunked payload


          A payload that has been partitioned into multiple DIME record
          chunks. This can be used to carry dynamically generated
          content or very large entities that don't fit into a single
          DIME record (see section 2.1.3).


     DIME payload length


          The size of the payload indicated in number of octets (see
          section 2.2.1).


     DIME payload type


          An identifier that indicates the type of the payload. This
          specification supports both URIs [10] as well as MIME media
          type constructs [11] as type identifiers (see section 2.2.2).

Nielsen, et al.                                               [Page 5]


INTERNET-DRAFT                     DIME                  October, 2001

     DIME payload identifier


          A URI that optionally can be used to identify a payload (see
          section 2.2.3).


     DIME user application


          The logical, higher-layer application that uses DIME for
          encapsulating messages.


     DIME generator


          An entity or module that encapsulates user application-defined
          payloads within DIME messages.


     DIME parser


          An entity or module that parses DIME messages and hands off
          the payloads to a DIME user application.


1.4  Intended Usage


     The intended usage of DIME is as follows: A user application wants
     to encapsulate one or more related documents into a single DIME
     message. For example, this can be a SOAP message along with a set
     of attachments. The DIME generator encapsulates each document in
     DIME records as payload or chunked payload, indicating the type and
     length of the payload along with an optional identifier. The DIME
     records are then put together to form a single DIME message. The
     DIME parser deconstructs the DIME message and hands the payloads to
     a (potentially different) user application.


     DIME can be used in combination with most protocols that support
     the exchange of binary data as long as the DIME message can be
     exchanged in its entirety. A DIME message can be carried as a MIME
     entity using the media type "application/dime" (see section 6 for
     IANA media type registration considerations of "application/dime").


     DIME records can encapsulate documents of any type. It is possible
     to carry MIME messages in DIME records by using a media type such
     as "message/rfc822". A DIME message can be encapsulated in a DIME
     record by using the media type "application/dime" (see section 6).


Nielsen, et al.                                               [Page 6]


INTERNET-DRAFT                     DIME                  October, 2001

     It is important to note that although MIME entities are supported,
     there are no assumptions in DIME that a record payload is MIME;
     DIME makes no assumption concerning the type of the payloads
     carried in a DIME message.


     DIME provides no support for error handling. It is up to the DIME
     parser to determine the implications of receiving a malformed DIME
     message. It is the responsibility of the user applications involved
     to provide any additional functionality such as QoS that they may
     need as part of the overall system in which they participate.


2  The DIME Mechanisms


     This section describes the mechanisms used in DIME. The specific
     syntax for these mechanisms is defined in section 3.


2.1  DIME Encapsulation Constructs


2.1.1 Message


     A DIME message is composed of one or more DIME records. The first
     record in a message is marked with the MB (Message Begin) flag set
     and the last record in the message is marked with the ME (Message
     End) flag set (see section 3.2.1 and 3.2.2). The minimum message
     length is one record which is achieved by setting both the MB and
     the ME flag in the same record. Note that at least two record
     chunks are required in order to encode a chunked payload (see
     section 2.1.3). The maximum number of DIME records that can be
     carried in a DIME message is unbounded.


     DIME messages MUST NOT overlap; that is, the MB and the ME flags
     MUST NOT be used to nest DIME messages. DIME messages can be nested
     by carrying a full DIME message within a DIME record with the type
     "application/dime" (see section 6).


     <--------------------- DIME message ---------------------->
     +---------+     +---------+     +---------+     +---------+
     | R1 MB=1 | ... | Rr      | ... | Rs      | ... | Rt ME=1 |
     +---------+     +---------+     +---------+     +---------+


        Figure 1: Example of a DIME message with a set of records.
        The message head is to the left and the tail to the right,
        with the logical record indexes t > s > r > 1. The MB
        (Message Begin) flag is set in the first record (index 1)


Nielsen, et al.                                               [Page 7]


INTERNET-DRAFT                     DIME                  October, 2001

        and the ME (Message End) flag is set in the last record
        (index t).


     Note that actual DIME records do not carry an index number; the
     ordering is implicitly given by the order in which the records are
     serialized.


2.1.2 Record


     A record is the unit for carrying a payload within a DIME message.
     Each payload is described by its own set of parameters (see section
     2.2).


2.1.3 Record Chunks


     A record chunk carries a chunk of a payload. Chunked payloads can
     be used to partition dynamically generated content or very large
     entities into multiple subsequent record chunks serialized within
     the same DIME message.


     Chunking is not a mechanism for introducing multiplexing into DIME.
     It is a mechanism to limit the need for outbound buffering on the
     generating side. This is similar to the message chunking mechanism
     defined in HTTP/1.1 [11].


     A DIME message can contain zero or more chunked payloads. A chunked
     payload is encoded as an initial record chunk followed by zero or
     more middle record chunks followed by a terminating record chunk.
     Each record chunk is encoded as a DIME record using the following
     encoding rules:


     1.   The initial record chunk is a DIME record with the CF (Chunk
          Flag) flag set (see section 3.2.3). The type of the entire
          chunked payload MUST be indicated in the TYPE field regardless
          of whether the DATA_LENGTH field value is zero or not. The ID
          field MAY be used to carry an identifier of the entire chunked
          payload. The DATA_LENGTH field indicates the size of the data
          carried in the DATA field (see section 2.2.1).


     2.   Each middle record chunk is a DIME record with the CF flag set
          indicating that this record chunk contains the next chunk of
          data of the same type and with the same identifier as the
          initial record chunk. The value of the TYPE_LENGTH and the
          ID_LENGTH fields MUST be zero and the TNF (Type Name Format)
          field value MUST be 0x00 (see section 3.2.4). The DATA_LENGTH

Nielsen, et al.                                               [Page 8]


INTERNET-DRAFT                     DIME                  October, 2001

          field indicates the size of the data carried in the DATA field
          (see section 2.2.1).


     3.   The terminating record chunk is a DIME record with the CF flag
          cleared indicating that this record chunk contains the last
          chunk of data of the same type and with the same identifier as
          the initial record chunk. As with the middle record chunks,
          the value of the TYPE_LENGTH and the ID_LENGTH fields MUST be
          zero and the TNF (Type Name Format) field value MUST be 0x00
          (see section 3.2.4). The DATA_LENGTH field indicates the size
          of the data carried in DATA field (see section 2.2.1).


     A chunked payload MUST be entirely encapsulated within a single
     DIME message. That is, a chunked payload MUST NOT span multiple
     DIME messages. As a result, neither an initial nor a middle record
     chunk can have the ME (Message End) flag set.


2.2  DIME Payload Description


     Each record contains information about the payload carried within
     it. This section introduces the mechanisms by which these payloads
     are described.


2.2.1 Payload Length


     Regardless of the relationship of a record to other records, the
     payload length always indicates the length of the payload
     encapsulated in THIS record. The length of the payload is indicated
     in number of octets in the DATA_LENGTH field. Note that zero is a
     valid length.


2.2.2 Payload Type


     The payload type of a record indicates the kind of data being
     carried in the payload of that record. This may be used to guide
     the processing of the payload at the discretion of the user
     application. The type of the first record, by convention, provides
     the processing context not only for the first record but for the
     whole DIME message. Additional context for processing the message
     may be provided by the transport service port (TCP, UDP, etc) at
     which the message was received and by other communication
     parameters.


     It is important to emphasize that DIME mandates no specific
     processing model for DIME messages. The usage of the payload types

Nielsen, et al.                                               [Page 9]


INTERNET-DRAFT                     DIME                  October, 2001

     is entirely at the discretion of the user application. The comments
     regarding usage above should be taken as guidelines for building
     processing conventions, including mappings of higher level
     application semantics onto DIME.


     The format of the TYPE field value is indicated using the TNF (Type
     Name Format) field (see section 3.2.5). This specification supports
     TYPE field values in the form of absolute URIs and MIME media type
     constructs. The former allows for decentralized control of the
     value space and the latter allows DIME to take advantage of the
     already very large and successful media type value space maintained
     by IANA [3].


     The media type registration process is outlined in RFC 2048 [8].
     Use of non-registered media types is discouraged. The URI scheme
     registration process is described in RFC 2717 [12]. It is
     recommended that only well-known URI schemes registered by IANA be
     used (see [16] for a current list).


     URIs can be used for message types that are defined by URIs.
     Records that carry a payload with an XML-based message type MAY use
     the XML namespace identifier of the root element as the TYPE field
     value. A SOAP/1.1 message, for example, may be represented by the
     URI


          http://schemas.xmlsoap.org/soap/envelope/


     Records that carry a payload with an existing, registered media
     type SHOULD carry a TYPE field value of that media type. Note that
     the TYPE field indicates the type of the payload; it does NOT refer
     to a MIME message that contains an entity of the given type. For
     example, the media type


          image/jpeg


     indicates that the payload is a JPEG image. Similarly, the media
     type


          message/http


     indicates that the payload is an HTTP message as defined by RFC
     2616 [11]. A value of


          application/xml; charset="utf-16"

Nielsen, et al.                                              [Page 10]


INTERNET-DRAFT                     DIME                  October, 2001

     indicates that the payload is an XML document as defined by RFC
     3023 [15].


2.2.3 Payload Identification


     The optional payload identifier allows user applications to
     identify a payload within a DIME record. By providing a payload
     identifier, it becomes possible for other payloads supporting URI-
     based linking technologies to refer to that payload. DIME does not
     mandate any particular linking mechanism but leaves this to the
     user application to define in the language it prefers.


     It is important that payload identifiers are maintained so that
     references to those payloads are not broken. If records are
     repackaged, for example, by an intermediate application, then that
     application MUST ensure that the payload identifiers are preserved.


3  The DIME Specifications


3.1  Data Transmission Order


     The order of transmission of the DIME record described in this
     document is resolved to the octet level. For diagrams showing a
     group of octets, the order of transmission of those octets is first
     left to right and then top to bottom, as they are read in English.
     For example, in the diagram in Figure 2, the octets are transmitted
     in the order they are numbered.


                                     1  1  1  1  1  1
       0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
     +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
     |        Octet 1        |        Octet 2        |
     |        Octet 3        |        Octet 4        |
     +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
     |        Octet 5        |        Octet 6        |
     +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+


        Figure 2: DIME octet ordering


     Whenever an octet represents a numeric quantity, the leftmost bit
     in the diagram is the high order or most significant bit. That is,
     the bit labeled 0 is the most significant bit.




Nielsen, et al.                                              [Page 11]


INTERNET-DRAFT                     DIME                  October, 2001

     For each multi-octet field representing a numeric quantity defined
     by DIME, the leftmost bit of the whole field is the most
     significant bit. Such quantities are transmitted in a big-endian
     manner with the most significant octet transmitted first.


3.2  Record Layout


     DIME records are variable length records with a common format
     illustrated in Figure 3. In the following sections, the individual
     record fields are described in more detail.


                                     1  1  1  1  1  1
       0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
     +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
     |MB|ME|CF|              ID_LENGTH               |
     +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
     |   TNF  |             TYPE_LENGTH              |
     +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
     |                  DATA_LENGTH                  |
     |                                               |
     +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
     |                  ID + PADDING                 /
     /                                               |
     +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
     |                 TYPE + PADDING                /
     /                                               |
     +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
     |                                               /
     /                 DATA + PADDING                /
     /                                               |
     +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+


        Figure 3: DIME Record Layout. The use of "/" indicates a
        field length which is a multiple of 4 octets.


3.2.1 MB (Message Begin)


     The MB flag is a 1 bit field that when set indicates the start of a
     DIME message (see section 2.1.1).


3.2.2 ME (Message End)


     The ME flag is a 1 bit field that when set indicates the end of a
     DIME message (see section 2.1.1). Note, that in case of a chunked
     payload, the ME flag is set only in the terminating record chunk of
     that chunked payload (see section 2.1.3).

Nielsen, et al.                                              [Page 12]


INTERNET-DRAFT                     DIME                  October, 2001

3.2.3 CF (Chunk Flag)


     The CF flag is a 1 bit field indicating that this is either the
     first record chunk or a middle record chunk of a chunked payload
     (see section 2.1.3 for a description of how to encode a chunked
     payload).


3.2.4 ID_LENGTH


     An unsigned 13 bit integer that specifies the length in octets of
     the ID field excluding any padding used to achieve a 4 octet
     alignment of the ID field (see section 2.2.3).


3.2.5 TNF (Type Name Format)


     The TNF field value indicates the structure of the value of the
     TYPE field (see section 2.2.2 for a description of the TYPE field
     and section 4 for a description of internationalization issues
     related to the TYPE field). The TNF field is a 3 bit field with
     values defined in Table 1:


       Type Name Format                              Value


       Unchanged (see section 2.1.3)                  0x00


       media-type as defined in RFC 2616 [11]         0x01


       absoluteURI as defined in RFC 2396 [10]        0x02


       Unknown                                        0x03


       None                                           0x04


       Reserved                                    0x05-0x07


        Table 1: DIME TNF field values.


     The value 0x00 (Unchanged) MUST be used in all middle record chunks
     and terminating record chunks used in chunked payloads (see section

Nielsen, et al.                                              [Page 13]


INTERNET-DRAFT                     DIME                  October, 2001

     2.1.3). It MUST NOT be used in any other record. When used, the
     TYPE_LENGTH field value MUST be zero.


     The value 0x01 (media-type) indicates that the TYPE field contains
     a value that follows the "media-type" BNF construct defined by RFC
     2616 [11] (see section 2.2.2).


     The value 0x02 (absoluteURI) indicates that the TYPE field contains
     a value that follows the "absoluteURI" BNF construct defined by RFC
     2396 [10] (see section 2.2.2).


     The value 0x03 (Unknown) SHOULD be used to indicate that the type
     of the payload is unknown. This is similar to the
     "application/octet-stream" media type defined by MIME [7]. When
     used, the TYPE_LENGTH field value MUST be zero. Regarding
     implementation, it is RECOMMENDED that a DIME parser receiving a
     DIME record of this type provides a mechanism for storing but not
     processing the payload (see section 5).


     The value 0x04 (None) indicates that there is no type or payload
     associated with this record. When used, the value of the
     TYPE_LENGTH and the DATA_LENGTH fields MUST be zero. This TNF value
     can be used whenever an empty record is needed, for example in
     order to terminate a DIME message in cases where there is no
     payload defined by the user application.


     There is no default value for the TNF field. Reserved TNF field
     values are for future use and MUST NOT be used. A DIME parser that
     receives a DIME record with an unknown TNF field value SHOULD treat
     it as 0x03 (Unknown).


3.2.6 TYPE_LENGTH


     An unsigned 13 bit integer that specifies the length in octets of
     the TYPE field excluding any padding used to achieve a 4 octet
     alignment of the TYPE field (see section 2.2.2).


3.2.7 DATA_LENGTH


     The DATA_LENGTH field is an unsigned 32 bit integer that specifies
     the length in octets of the DATA field excluding any padding used
     to achieve a 4 octet alignment of the DATA field (see section
     2.2.1).



Nielsen, et al.                                              [Page 14]


INTERNET-DRAFT                     DIME                  October, 2001

     A payload size of 0 octets is allowed. Payloads larger than 2^32-1
     octets can be accommodated by using chunked payloads (see section
     2.1.3).


3.2.8 ID


     The value of the ID field is an identifier in the form of a URI
     [10] (see section 2.2.3 and 3.3). The required uniqueness of the
     message identifier is guaranteed by the generator. The URI can be
     either relative or absolute; DIME does not define a base URI which
     means that user applications using relative URIs MUST provide an
     actual or a virtual base URI (see [10]).


     With the exception of subsequent record chunks (see section 2.1.3),
     all records MAY have a non-zero ID field.


     The length of the ID field MUST be a multiple of 4 octets. If the
     length of the payload id value is not a multiple of 4 octets, the
     generator MUST pad the value with all zero octets. Padding is not
     included in the ID_LENGTH field (see section 3.2.4).


     A DIME generator MUST NOT pad the ID field with more than 3 octets.
     A DIME parser MUST ignore the padding octets.


3.2.9 TYPE


     The value of the TYPE field is an identifier describing the type of
     the payload (see section 2.2.2). The value of the TYPE field MUST
     follow the structure implied by the value of the TNF field (see
     section 3.2.5).


     The length of the TYPE field MUST be a multiple of 4 octets. If the
     length of the payload type value is not a multiple of 4 octets, the
     generator MUST pad the value with all zero octets. Padding is not
     included in the TYPE_LENGTH field (see section 3.2.6).


     A DIME generator MUST NOT pad the TYPE field with more than 3
     octets. A DIME parser MUST ignore the padding octets.


     A DIME parser receiving a DIME record with a known TNF field value
     but an unknown TYPE field value SHOULD interpret the type
     identifier of that record as if the TNF field value was 0x03
     (Unknown).


Nielsen, et al.                                              [Page 15]


INTERNET-DRAFT                     DIME                  October, 2001

     It is STRONGLY RECOMMENDED that the identifier be globally unique
     and maintained with stable and well-defined semantics over time.


3.2.10 DATA


     The DATA field carries the payload intended for the DIME user
     application. Any internal structure of the data carried within the
     DATA field is opaque to DIME.


     The length of the DATA field MUST be a multiple of 4 octets. If the
     length of the payload is not a multiple of 4 octets, the generator
     MUST pad the value with all zero octets. Padding is not included in
     the DATA_LENGTH field (see section 3.2.7).


     A DIME generator MUST NOT pad the DATA field with more than 3
     octets. A DIME parser MUST ignore the padding octets.


3.3  Use of URIs in DIME


     DIME uses URIs [10] for some identifiers. To DIME, a URI is simply
     a formatted string that identifies--via name, location, or any
     other characteristic--a resource on the Web.


     The use of IP addresses in URIs SHOULD be avoided whenever possible
     (see RFC 1900 [5]). However, when used, the literal format for IPv6
     addresses in URIs as described by RFC 2732 [14] SHOULD be
     supported.


     DIME does not define any equivalence rules for URIs in general as
     these are defined by the individual URI schemes and by RFC 2396
     [10]. However, because of inconsistencies with respect to some URI
     equivalence rules in many current URI parsers, it is STRONGLY
     RECOMMENDED that generators of DIME messages only rely on the most
     rudimentary equivalence rules defined by RFC 2396.


     The size of URIs used as values in the ID field and the TYPE field
     is limited by the maximum size of these fields which is 2^13-1
     octets. DIME parsers and generators MUST be able to deal with URIs
     of this size.







Nielsen, et al.                                              [Page 16]


INTERNET-DRAFT                     DIME                  October, 2001

4  Internationalization Considerations


     Identifiers used in DIME such as URIs and MIME media type
     constructs may provide different levels of support for
     internationalization. Implementers are referred to RFC 2718 [13]
     for internationalization consideration of URIs and RFC 2046 [7] for
     internationalization considerations of MIME media types.


5  Security Considerations


     Implementers should pay special attention to the security
     implications of any record types that can cause the remote
     execution of any actions in the recipient's environment. Before
     accepting records of any type, an application should be aware of
     the particular security implications associated with that type.


     Security considerations for media types in general are discussed in
     RFC 2048 [8] and in the context of the "application/postscript" and
     the "message/external-body" media type in RFC 2046 [7].


6  IANA Considerations


     This draft describes a new content type, "application/dime" for
     which section 6.1 contains a registration application following the
     guidelines in RFC 2048 [8].


6.1  Registration: application/dime


     MIME media type name: application


     MIME subtype name: dime


     Required parameters: none


     Optional parameters: none


     Encoding considerations:


          This media type MAY be encoded as appropriate for the charset
          and the capabilities of the underlying MIME transport. For 7-
          bit transports, data using 8-bit or higher MUST be encoded in

Nielsen, et al.                                              [Page 17]


INTERNET-DRAFT                     DIME                  October, 2001

          quoted-printable or base64 content-transfer-encodings. For 8-
          bit clean transport (e.g., 8BITMIME [2] ESMTP [4] or NNTP
          [1]), 8-bit data such as UTF-8 does not need to be encoded.
          Over HTTP [11], no content-transfer-encoding is necessary
          regardless of the encoding.


     Security considerations: See section 5


     Interoperability considerations: n/a


     Published Specification: this specification


     Applications which use this media type:


          Applications that choose to use DIME as the packaging
          mechanism for encapsulating one or more application-defined
          payloads of arbitrary type and size into a single message
          construct.


     Additional information: none


     Magic number(s): none


     File extension(s):


          .dim
          .dime


     Macintosh File Type Code(s):


          DIME


     Person and email address for further information: see section 10


     Intended usage:


          COMMON




Nielsen, et al.                                              [Page 18]


INTERNET-DRAFT                     DIME                  October, 2001

     Author/Change controller:


          The DIME specification is an individual Internet Draft
          submission. It is not the product of an IETF Working Group.
          The IETF has change control over the DIME specification.


7  Intellectual Property


     The following notice is copied from RFC 2026 [6], Section 10.4, and
     describes the position of the IETF concerning intellectual property
     claims made against this document.


     The IETF takes no position regarding the validity or scope of any
     intellectual property or other rights that might be claimed to
     pertain to the implementation or use other technology described in
     this document or the extent to which any license under such rights
     might or might not be available; neither does it represent that it
     has made any effort to identify any such rights.  Information on
     the procedures of the IETF with respect to rights in standards-
     track and standards-related documentation can be found in BCP-11.
     Copies of claims of rights made available for publication and any
     assurances of licenses to be made available, or the result of an
     attempt made to obtain a general license or permission for the use
     of such proprietary rights by implementers or users of this
     specification can be obtained from the IETF Secretariat.


     The IETF invites any interested party to bring to its attention any
     copyrights, patents or patent applications, or other proprietary
     rights that may cover technology that may be required to practice
     this standard. Please address the information to the IETF Executive
     Director.


8  Acknowledgements


     Special thanks go to Paul H. Gleichauf and Krishna Sankar of Cisco
     for their input on this specification.


9  References

     [1]   B. Kantor, P. Lapsley, "Network News Transfer Protocol", RFC
           977, U.C. San Diego, U.C. Berkeley, February 1986
     [2]   J. Klensin, N. Freed, M. Rose, E. Stefferud, D. Crocker,
           "SMTP Service Extension for 8bit-MIMEtransport", RFC 1652,
           MCI, Innosoft, Dover Beach Consulting, Inc., Network
           Management Associates, Inc., Silicon Graphics, Inc., July
           1994.

Nielsen, et al.                                              [Page 19]


INTERNET-DRAFT                     DIME                  October, 2001

     [3]   Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC
           1700, October 1994.
     [4]   J. Klensin, N. Freed, M. Rose, E. Stefferud, D. Crocker, "
           SMTP Service Extensions", RFC 1869, MCI, Innosoft
           International, Inc., Dover Beach Consulting, Inc., Network
           Management Associates, Inc., Brandenburg Consulting, Inc.,
           November 1995.
     [5]   B. Carpenter, Y. Rekhter, "Renumbering Needs Work", RFC
           1900, IAB, February 1996
     [6]   S. Bradner, "The Internet Standards Process -- Revision 3",
           RFC 2026, Harvard University, October 1996
     [7]   N. Freed, N. Borenstein, "Multipurpose Internet Mail
           Extensions (MIME) Part Two: Media Types" RFC 2046, Innosoft
           First Virtual, November 1996
     [8]   N. Freed, J. Klensin, J. Postel, "Multipurpose Internet Mail
           Extensions (MIME) Part Four: Registration Procedures", RFC
           2048, Innosoft, MCI, ISI, November 1996
     [9]   S. Bradner, "Key words for use in RFCs to Indicate
           Requirement Levels", RFC 2119, Harvard University, March
           1997
     [10]  T. Berners-Lee, R. Fielding, L. Masinter, "Uniform Resource
           Identifiers (URI): Generic Syntax", RFC 2396, MIT/LCS, U.C.
           Irvine, Xerox Corporation, August 1998.
     [11]  R. Fielding, J. Gettys, J. C. Mogul, H. F. Nielsen, T.
           Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC
           2616, U.C. Irvine, DEC W3C/MIT, DEC, W3C/MIT, W3C/MIT,
           January 1997
     [12]  R. Petke, I. King, "Registration Procedures for URL Scheme
           Names", BCP: 35, RFC 2717, UUNET Technologies, Microsoft
           Corporation, November 1999
     [13]  L. Masinter, H. Alvestrand, D. Zigmond, R. Petke,
           "Guidelines for new URL Schemes", RFC 2718, Xerox
           Corporation, Maxware, Pirsenteret, WebTV Networks, Inc.,
           UUNET Technologies, November 1999
     [14]  R. Hinden, B. Carpenter, L. Masinter, "Format for Literal
           IPv6 Addresses in URL's", RFC 2732, Nokia, IBM, AT&T,
           December 1999
     [15]  M. Murata, S. St.Laurent, D. Kohn, "XML Media Types" RFC
           3023, IBM Tokyo Research Laboratory, simonstl.com, Skymoon
           Ventures, January 2001
     [16]  List of Uniform Resource Identifier (URI) schemes registered
           by IANA is available at
           "http://www.iana.org/assignments/uri-schemes"

10 Authors' Addresses


     Henrik Frystyk Nielsen
     Microsoft
     One Microsoft Way, Redmond, WA 90852
     Email: henrikn@microsoft.com




Nielsen, et al.                                              [Page 20]


INTERNET-DRAFT                     DIME                  October, 2001

     Henry Sanders
     Microsoft
     One Microsoft Way, Redmond, WA 90852
     Email: henrysa@microsoft.com


     Erik Christensen
     Microsoft
     One Microsoft Way, Redmond, WA 90852
     Email: erikc@microsoft.com


     Christian Huitema
     Microsoft
     One Microsoft Way, Redmond, WA 90852
     Email: huitema@microsoft.com







































Nielsen, et al.                                              [Page 21]