Document: FSC-0056
Version:  001
Date:     03-May-1991





                      EMSI/IEMSI Protocol Definitions
                          Joaquim H. Homrighausen
                               May 3, 1991
 



    Status of this document:

     This FSC suggests a proposed protocol for the FidoNet(r) community,
     and requests discussion and suggestions for improvements.
     Distribution of this document is subject to the restrictions
     specified on the next page.

     Fido and FidoNet are registered marks of Tom Jennings and Fido
     Software.




      (Also known as EMSC-001; Electronic Mail Standards Document #001)
    ---------------------------------------------------------------------
      Copyright 1989-1991 Joaquim H. Homrighausen. All rights reserved.
    ---------------------------------------------------------------------


    Notice
    =====================================================================
    This document obsoletes EMSI_003 and any previous document describing
    the EMSI, UZAP, and/or IEMSI handshake protocol. I apologize for the
    lack of proper state charts. I am currently under a fairly heavy
    work-load and thought it would be better to release something half-
    decent than not to release anything at all.

    Restrictions
    =====================================================================
    EMSI/IEMSI may be used by any developer as long as these
    specifications are followed exactly. The IEMSI and EMSI specifications
    may be implemented independently of each other.

    EMSI/IEMSI may be used free-of-charge by any developer for any
    purpose, commercially or otherwise. In creating EMSI/IEMSI, we are
    taking the first step towards developing a clear protocol definition
    for state-of-the-art E-Mail systems to follow.

    This document and its NOTES file (EMSI.NOT) may be freely copied and
    distributed, but must NEVER be distributed in a modified form. If you
    have an enhancement request, please contact the author of this
    document; do not change it yourself.

    Permission is hereby granted to the FTSC (Fidonet Technical Standards
    Committee) and other technical organisations to republish this
    document in its entirety. Librarians may change the title page and
    page headers to match their library format as long as all copyrights
    and body text remain unaltered. The original document name and source
    (EMSC) must be mentioned in any republished versions of this
    document.

    No organization, company, person, or other being may impose any fees
    for any reason for providing this document. This document may not be
    sold or otherwise transferred for personal or company gain under any
    circumstances.

    Layout
    =====================================================================
    This document consists of four major parts; A short introduction and
    explanation of the EMSI/IEMSI handshake protocol, the EMSI
    definitions, the IEMSI definitions, and finally various notes and
    credits.


    PART I

    Introduction
    =====================================================================
    The EMSI/IEMSI handshake protocol allows for maximum flexibility in
    E-Mail session start-up and control. The YooHoo (FTS-6) standard,
    designed by Wynn Wagner III, was a good idea, but did not allow
    sufficient room for growth and cannot be used in 7-bit environments.
    EMSI/IEMSI should provide for virtually unlimited growth and
    expansion of its own scope. By providing variable-length packets,
    EMSI/IEMSI is capable of being as simple or as complex as necessary
    and entirely backwards compatible when new features and/or protocols
    are added.

    All EMSI/IEMSI packets and sequences consists of 7-bit printable
    ASCII characters. This format allows us to establish a universal
    handshake between "PCs" and "mainframes" alike. The more complicated
    the computer system, the more restrictions affect its I/O; there are
    many I/O channels that cannot transmit control characters such as XON
    and XOFF; for this, we have created a universal handshake protocol
    that uses all printable characters.

    EMSI/IEMSI does allow control and 8-bit ASCII characters to be
    transmitted. This is, however, accomplished by escaping the data
    and converting it to 7-bit printable ASCII characters.

    Data layer
    =====================================================================
    EMSI/IEMSI is a protocol based on multi-character sequences rather
    than single character flow control. There are several advantages of
    using several characters rather than just one, but there is also a
    drawback. On very poor-quality telephone lines, EMSI will most likely
    require several retransmissions of packets since line noise usually
    come in bursts. That aside, there is little advantage in using a
    protocol based on single characters.

    All EMSI/IEMSI sequences are terminated by a single  unless
    otherwise specified. This is necessary to force some data collection
    equipment to flush their buffers. Appending  to EMSI/IEMSI
    sequences in a FidoNet environment is a delicate matter and it is
    important that you follow the notes regarding this.

    Note regarding file requests
    ---------------------------------------------------------------------
    The file request concept mentioned in the EMSI document refers to
    WaZOO style file requests as specified in FTS-6. No other file
    request mechanism is supported in the EMSI specifications.


    Separator usage
    ---------------------------------------------------------------------
    To designate the fields within the EMSI/IEMSI packets and retain
    complete transparency, both start and stop characters are used.

    The ASCII1 type is used for all fields within the packet. This uses
    the brace characters to delimit the fields. The '{' (ASCII 123)
    character is the start byte and '}' (ASCII 125) is the stop byte.
    If a stop byte is used as literal data within a field, it must be
    transmitted twice. The end of a field is designated by a stop byte
    that is not followed by another identical stop byte.

    The ASCII2 fields are delimited in exactly the same way, but use the
    square brackets as delimiters. The '[' (ASCII 91) is the start byte
    and ']' (ASCII 93) is the stop byte. ASCII2 is used to delimit data
    within the ASCII1 extra_field information.

    7-bit data restriction
    ---------------------------------------------------------------------
    It is the developer's responsibility to ensure that the software
    generates EMSI/IEMSI packets and sequences containing only 7-bit
    (00H through 7eH) printable ASCII characters.

    It is recommended that all EMSI/IEMSI implementations strip the high-
    order bit of all received characters prior to processing the packet/
    sequence and prior to calculating CRC values.

    CRC values
    ---------------------------------------------------------------------
    The polynomial used to calculate a 16-bit CRC is the same polynomial
    used in the Xmodem file transfer protocol. The polynomial used to
    calculate a 32-bit CRC is the same polynomial used in the Zmodem file
    transfer protocol.

    Binary values
    ---------------------------------------------------------------------
    Since the EMSI environment specifies only 7-bit printable ASCII
    characters to be used, binary values, such as CRC and length
    descriptors are expressed as a four character hexadecimal string. The
    only exception to this is a 32-bit CRC value which is expressed as an
    eight character hexadecimal string.

    The application must treat them case insensitive, eg. ffaa should be
    treated identical to FFAA. 


    Handling 8-bit data
    ---------------------------------------------------------------------
    Although EMSI only uses 7-bit printable ASCII characters, there is an
    escape mechanism that allows systems to transmit control and 8-bit
    ASCII characters without the requirement of an 8-bit data link. The
    escape character is a backslash character ('\') and is followed by two
    characters in hexadecimal notation. Eg. "\80" is the ASCII character
    128. To insert an actual backslash character, two backslashes are used
    ("\\"), or a backslash followed by the hexadecimal code for a
    backslash, eg. "\5c".

    The hexadecimal code following a backslash MUST always be two
    characters, ie. to insert ASCII 15 (hexadecimail 'f'), the result
    would be "0f". All hexadecimal sequences must be treated case
    insensitively.


    PART II - Electronic Mail Standard Idenfitication

    Connecting two EMSI capable systems
    =====================================================================
    This assumes that the two systems are connected and that no data
    has been transmitted by the Caller.

    It should be mentioned that sending/monitoring for the "YooHoo",
    "TSYNC", and other protocol start characters is optional and not
    required for a strict EMSI implementation.

    STEP 1, EMSI INIT    

        Calling system                   Answering system
    +-+-------------------------------+----------------------------------+
    :1: Send <CR> until ANY character : Send EMSI_REQ and possible       :
    : : is received.                  : banner, etc.                     :
    +-+-------------------------------+----------------------------------+
    :2: Receive banner, etc. Monitor  : Monitor line for the EMSI_INQ    :
    : : line for the EMSI_REQ         : sequence and if received,        :
    : : sequence and if received,     : attempt to handshake immediately.:
    : : transmit EMSI_INQ and attempt :                                  :
    : : to handshake immediately.     :                                  :
    +-+-------------------------------+----------------------------------+
    :3: No EMSI_REQ sequence received,: Monitor line for EMSI_INQ and    :
    : : send EMSI_INQ twice followed  : possible other protocol start    :
    : : by possible other protocol    : characters and if received,      :
    : : start characters.             : attempt to handshake immediately.:
    : :                               :                                  :
    : : Transmit <CR>                 : Go to step 3.                    :
    +-+-------------------------------+----------------------------------+
    :4: If EMSI_REQ sequence received,:
    : : send EMSI_INQ and attempt to  :
    : : handshake immediately,        :
    : : otherwise repeat step 3.      :
    +-+-------------------------------+

    In steps 1 and 2, both the Calling and Answering system terminate all
    sequences with <CR>. In step 3, the Calling system does not terminate
    sequences with <CR> as it is explicitly transmitted after possible
    protocol start characters. In step 4, the Calling system once again
    terminate all sequences with a <CR>.


    STEP 2A, RECEIVE EMSI HANDSHAKE

    At this point, all sequences are terminated with a <CR>.

    +-+------------------------------------------------------------------+
    :1: Tries=0, T1=20 seconds, T2=60 seconds                            :
    +-+------------------------------------------------------------------+
    :2: Increment Tries                                                  :
    : :                                                                  :
    : : Tries>6?                      Terminate, and report failure.     :
    : +------------------------------------------------------------------+
    : : Are we answering system?      Transmit EMSI_REQ, go to step 3.   :
    : +------------------------------------------------------------------+
    : : Tries>1?                      Transmit EMSI_NAK, go to step 3.   :
    : +------------------------------------------------------------------+
    : : Go to step 4.                                                    :
    +-+------------------------------------------------------------------+
    :3: T1=20 seconds                                                    :
    +-+------------------------------------------------------------------+
    :4: Wait for EMSI sequence until EMSI_HBT or EMSI_DAT or any of the  :
    : : timers have expired.                                             :
    : :                                                                  :
    : : If T2 has expired, terminate call and report failure.            :
    : +------------------------------------------------------------------+
    : : If T1 has expired, go to step 2.                                 :
    : +------------------------------------------------------------------+
    : : If EMSI_HBT received, go to step 3.                              :
    : +------------------------------------------------------------------+
    : : If EMSI_DAT received, go to step 5.                              :
    : +------------------------------------------------------------------+
    : : Go to step 4.                                                    :
    +-+------------------------------------------------------------------+
    :5: Receive EMSI_DAT packet                                          :
    : +------------------------------------------------------------------+
    : : Packet received OK?                Transmit EMSI_ACK twice, and  :
    : :                                    go to step 6.                 :
    : +------------------------------------------------------------------+
    : : Go to step 2.                                                    :
    +-+------------------------------------------------------------------+
    :6: Received EMSI_DAT packet OK, exit.                               :
    +-+------------------------------------------------------------------+

    All processing of the information in the EMSI_DAT packet must be done
    after transmitting EMSI_ACK twice to the remote system. It is
    recommended that an EMSI_HBT sequence is issued once every seven
    seconds while such processing is taking place to avoid unnecessary
    handshake collissions. Emitting EMSI_HBT should only be done when
    it is obvious that the remote system is waiting for the second phase
    of the EMSI handshake to take place.



    STEP 2B, TRANSMIT EMSI HANDSHAKE

    At this point, all sequences are terminated with a <CR>.

    +-+------------------------------------------------------------------+
    :1: Tries=0, T1=60 seconds                                           :
    +-+------------------------------------------------------------------+
    :2: Transmit EMSI_DAT packet and increment Tries                     :
    : :                                                                  :
    : +------------------------------------------------------------------+
    : : Tries>6?                        Terminate, and report failure.   :
    : +------------------------------------------------------------------+
    : : Go to step 3.                                                    :
    +-+------------------------------------------------------------------+
    :3: T2=20 seconds                                                    :
    +-+------------------------------------------------------------------+
    :4: Wait for EMSI sequence until T1 has expired                      :
    : :                                                                  :
    : : If T1 has expired, terminate call and report failure.            :
    : +------------------------------------------------------------------+
    : : If T2 has expired, go to step 2.                                 :
    : +------------------------------------------------------------------+
    : : If EMSI_REQ received, go to step 4.                              :
    : +------------------------------------------------------------------+
    : : If EMSI_ACK received, go to step 5.                              :
    : +------------------------------------------------------------------+
    : : If any other sequence received, go to step 2.                    :             :
    +-+------------------------------------------------------------------+
    :5: Received EMSI_ACK, exit.                                         :
    +-+------------------------------------------------------------------+


    EMSI packet and sequence definitions
    =====================================================================

    =====================================================================
    EMSI Inquiry                                    **EMSI_INQ<crc16><CR>
    ---------------------------------------------------------------------
    EMSI Inquiry is transmitted by the calling system to identify it as
    EMSI capable. If an EMSI_REQ sequence is received in response, it is
    safe to assume the answering system to be EMSI capable.

    =====================================================================
    EMSI Request                                    **EMSI_REQ<crc16><CR>
    ---------------------------------------------------------------------
    EMSI Request is transmitted by the answering system in response to an
    EMSI Inquiry sequence. It should also be transmitted prior to or
    immediately following the answering system has identified itself by
    transmitting its program name and/or banner. If the calling system
    receives an EMSI Request sequence, it can safely assume that the
    answering system is EMSI capable.
    
    =====================================================================
    EMSI Client                                     **EMSI_CLI<crc16><CR>
    ---------------------------------------------------------------------
    EMSI Client is used by terminal emulation software to force a mailer
    front-end to bypass any unnecessary mail session negotiation and
    treat the call as an incoming human caller. The EMSI_CLI sequence may
    not be issued by any software attempting to establish a mail session
    between two systems and must only be acted upon by an answering
    system.

    =====================================================================
    EMSI Heartbeat                                  **EMSI_HBT<crc16><CR>
    ---------------------------------------------------------------------
    EMSI Heartbeat is used to prevent unnecessary timeouts from occurring
    while attempting to handshake. It is most commonly used when the
    answering system turns around to transmit its EMSI_DAT packet. It is
    quite normal that any of the timers of the calling system (which at
    this stage is waiting for an EMSI_DAT packet) expires while the
    answering system is processing the recently received EMSI_DAT packet.

    =====================================================================
    EMSI Data                      **EMSI_DAT<len16><data_pkt><crc16><CR>
    ---------------------------------------------------------------------
    EMSI Data is transmitted by both the calling and answering system at
    the appropriate time to exchange system information. Following the
    header is a four byte number representing the length of <data_pkt>
    excluding the CRC and terminating <CR>.

    The EMSI_DAT packet is a variable length packet. Since this is a
    synchronous protocol, the inbound data buffer should be purged
    between transmission of the <data_pkt> and <crc16> fields to prevent
    accidental EMSI_NAK sequences, etc.


    =====================================================================
    EMSI ACK                                        **EMSI_ACK<crc16><CR>
    ---------------------------------------------------------------------
    EMSI ACK is transmitted by either system as a positive
    acknowledgement of the valid receipt of a EMSI_DAT packet. This should
    only be used as a response to EMSI_DAT and not any other packet.
    Redundant EMSI_ACK sequences should be ignored.

    =====================================================================
    EMSI NAK                                        **EMSI_NAK<crc16><CR>
    ---------------------------------------------------------------------
    EMSI NAK is transmitted by either system as a negative
    acknowledgement of the valid receipt of a EMSI_DAT packet. This
    should only be used as a response to EMSI_DAT and not any other
    packet. Redundant EMSI_NAK packets should be ignored.

    The EMSI_DAT packet
    =====================================================================
    The EMSI_DAT packet is the core of an EMSI negotiated session. It
    contains information vital to the mail session. The following pseudo
    structure shows the layout of the EMSI_DAT packet.

    EMSI_DAT
        fingerprint,            "EMSI"
        system_address_list,
        password,
        link_codes,
        compatibility_codes,
        mailer_product_code,
        mailer_name,
        mailer_version,
        mailer_serial_number:    ASCII1;
        extra_field_1,
            ..
            ..
        extra_field_n:            EMSI_addon; (optional fields)
    end;

    The EMSI_addon structure is defined as follows:

    EMSI_addon
        product_ID,
        specific_data:            ASCII1;
    end;


    Following is an example of the actual data transmitted as an EMSI_DAT
    packet:

    {EMSI}{2:270/17}{}{8N1,PUA}{ZAP,ZMO,ARC,XMA}{44}{AirMail}{0.10}
    {Beta-2}{IDENT}{[Advanced Engineering S.A.R.L.][Luxembourg]
    [Joaquim Homrighausen][-Unpublished-][9600][MO,XA,HST,V32B,V42B]}

    EMSI_DAT field definitions
    ---------------------------------------------------------------------
    
    =====================================================================
    Fingerprint                                                      EMSI
    ---------------------------------------------------------------------
    The constant "EMSI". There is no need for a revision level since this    
    basic format cannot change and remain backward compatible.

    =====================================================================
    System address list
    ---------------------------------------------------------------------
    The system address list is a list of system-specific identifiers for
    the E-Mail system separated by spaces.

    For FidoNet-technology based networks, it is required that
    Zone:Net/Node be presented, and .Point be omitted if zero. Zone and
    Net must not be zero.

    In other networks, an address such as "jhom@csource.oz.au" should be
    considered valid.

    =====================================================================
    Password
    ---------------------------------------------------------------------
    For systems using a session level password, it would be passed in
    this field. Note that the same password is used for all presented
    addresses and that it must be treated case insensitive.

    =====================================================================
    Link codes
    ---------------------------------------------------------------------
    Link codes is a string of flags that specify desired connect
    conditions. These codes are separated by commas. New codes may be
    added with prior approval from the author of this document.

    Calling system/answering system options:

        8N1,
        7E1,
        7O2,
        etc.       Communication parameters.

    Calling system options:

        PUA        Pickup mail for all presented addresses.
        PUP        Pickup mail for primary address only.
        NPU        No mail pickup desired.


    Answering system options:

        HAT        Hold ALL traffic.
        HXT        Hold compressed mail traffic.
        HRQ        Hold file requests (not processed at this time).

    =====================================================================
    Compatibility codes
    ---------------------------------------------------------------------
    Compatibility codes is a string of flags that specifies the
    capabilities and enabled features of the mailer. These codes are
    separated by commas. New codes may be added with prior approval from
    the author of this document.
     
    The calling system must list supported protocols first and descending
    order of preference (the most desirable protocol should be listed
    first). The answering system should only present one protocol and it
    should be the first item in the compatibility_codes field.

        Protocols
        -----------------------------------------------------------------
        DZA*    DirectZAP (Zmodem variant).
        ZAP     ZedZap (Zmodem variant).
        ZMO**   Zmodem w/1,024 byte data packets.
        JAN     Janus.
        KER     Kermit.

        Other codes
        -----------------------------------------------------------------
        NCP     No compatible protocols (failure).
        NRQ     No file requests accepted by this system.
        ARC     ARCmail 0.60-capable, as defined by the FTSC.
        XMA     Supports other forms of compressed mail.
        FNC     Filename conversion. This indicates that any transmitted
                files must follow the MS-DOS restrictions of an eight
                character file name followed by a three character
                extension; eg. FILENAME.EXT

    (*) DirectZAP is a variant of ZedZap. The difference is that the
    transmitter only escapes CAN (18H). It is not recommended to use the
    DirectZAP protocol when two systems are connected via a packet
    switching network, or via another layer sensitive to control
    characters such as XON and XOFF.

    (**) The minimum protocol requirement for an EMSI implementation is
    to support plain Zmodem (16- or 32-bit CRC, 1,024 byte packets) which
    is represented by the ZMO flag in EMSI.

    =====================================================================
    Mailer product code
    ---------------------------------------------------------------------
    The hexadecimal representation of the EMSC product code assigned to
    the mailer. Currently, the EMSC codes are the same as the FTSC
    assigned codes.

    =====================================================================
    Mailer name
    ---------------------------------------------------------------------
    Specifies the name of the E-Mail system sending the EMSI packet.

    =====================================================================
    Mailer version
    ---------------------------------------------------------------------
    The version number of the mailer software, ie. "1.10", "2.00".

    =====================================================================
    Mailer serial number
    ---------------------------------------------------------------------
    The serial number, distribution source, version information, etc.
    This field is usually displayed like:

        NameVersion/Serial_number

    eg.

        AirMail 0.10/Beta-2

    =====================================================================
    Extra fields
    ---------------------------------------------------------------------
    The extra fields make the EMSI handshake protocol extremely flexible.
    Any program or mailer may add fields to the end of the pre-defined
    structure so that program-specific data may be passed without the
    concern of interferring with other systems.

    There may be any number of extra fields added to the end of this
    structure. Each EXTRA_FIELD contains two ASCII1 strings:

    PRODUCT_IDENTIFIER      A unique "tag" that defines a specific
                            program (such as a mailer or a utility).

    SPECIFIC_DATA           ASCII text that is specific data to the
                            program defined in PRODUCT_IDENTIFIER. With
                            this structure, any program can add its own
                            data to the EMSI packet without affecting
                            other applications.

    It is recommended that you contact the author of this document should
    you have any EXTRA_FIELDS that you may think worthwhile for other
    developers to implement and support.

    Predefined extra fields
    ---------------------------------------------------------------------
    The following extra fields have been defined to date.

    PRODUCT_IDENTIFIER   :  IDENT

    Purpose              :  General identification of system that
                            includes all information to generate a St.
                            Louis-format nodelist entry.

    SPECIFIC_DATA        :  system_name,
                            city,
                            operator_name,
                            phone_number,
                            baud_rate,
                            flags:            ASCII2;

        SYSTEM_NAME         The name of the system given by the user.
                            This would normally be a company name, BBS
                            name or other identifying text.

        CITY                The geographical location of the system.

        OPERATOR_NAME       The name of the person primarily responsible
                            for the system.

        PHONE_NUMBER        The telephone number of the system, or
                            "-Unpublished-" if the telephone number is
                            unpublished. This MUST be in the standard
                            format COUNTRY-CITY-NUMBER. Leading zeros
                            should be stripped from the city code,
                            ie. Stockholm (Sweden) has a city code of 08,
                            included in an EMSI packet, it would read
                            46-8-<number>.

        BAUD_RATE           The maximum baud rate supported by the
                            system. This is NOT necessarily the same as
                            the highest DTE rate.

        FLAGS               The St. Louis (FTSC) nodelist flags
                            associated with the system.


    PART III - Interactive Electronic Mail Standard Idenfitication

    Connecting two IEMSI capable systems
    =====================================================================
    Two specific labels are used when discussing the IEMSI definitions.
    The Client, which in this case is the Terminal software, and the
    Server, which in this case is the interactive on-line software,
    such as a BBS package or database system. It is assumed that the
    Client and the Server have established a data link and that no
    data has been transmitted by the Server.

    STEP 1, IEMSI INIT    

    There is no specific sequence of events in the IEMSI definition. The
    Client must monitor incoming data and if the EMSI_IRQ sequence is
    detected, it attempts to negotiate an IEMSI session with the Server.
    Under no circumstances is the Client allowed to transmit an EMSI_ICI
    packet prior to receiving the EMSI_IRQ sequence from the Server.
    All IEMSI sequences and EMSI sequences used during an IEMSI session
    are terminated by a single . There are no exceptions to this.


    STEP 2A, Server

    +-+------------------------------------------------------------------+
    :1: Tries=0, T2=60 seconds                                           :
    +-+------------------------------------------------------------------+
    :2: Transmit EMSI_IRQ sequence                                       :
    +-+------------------------------------------------------------------+
    :3: T1=20 seconds, increment Tries                                   :
    : :                                                                  :
    : : Tries>3?                        Discontinue IEMSI negotiation.   :
    +-+------------------------------------------------------------------+
    :4: Wait for EMSI_ICI packet until any of the timers have expired.   :
    : :                                                                  :
    : : If T2 has expired, discontinue IEMSI negotiation.                :
    : +------------------------------------------------------------------+
    : : If T1 has expired, go to step 2.                                 :
    : +------------------------------------------------------------------+
    : : If EMSI_ICI seen, go to step 5.                                  :
    : +------------------------------------------------------------------+
    : : Go to step 4.                                                    :
    +-+------------------------------------------------------------------+
    :5: Receive EMSI_ICI packet                                          :
    : +------------------------------------------------------------------+
    : : Packet received OK?             Transmit EMSI_ISI packet, and    :
    : :                                 go to step 6.                    :
    : +------------------------------------------------------------------+
    : : Packet not received OK?         Transmit EMSI_NAK and go to step :
    : :                                 3.                               :
    +-+------------------------------------------------------------------+
    :6: Tries=0                                                          :
    +-+------------------------------------------------------------------+
    :7: T1=20 seconds, increment Tries                                   :
    : :                                                                  :
    : : Tries>3?                        Discontinue IEMSI negotiation.   :
    +-+------------------------------------------------------------------+
    :8: Wait for EMSI_ACK/EMSI_NAK until any of the timers have expired. :
    : :                                                                  :
    : : If T2 has expired, discontinue IEMSI negotiation.                :
    : +------------------------------------------------------------------+
    : : If T1 has expired or EMSI_NAK received, transmit EMSI_ISI packet :
    : : again and go to step 7.                                          :
    : +------------------------------------------------------------------+
    : : If EMSI_ACK received, go to step 9.                              :
    : +------------------------------------------------------------------+
    : : Go to step 8.                                                    :
    +-+------------------------------------------------------------------+
    :9: IEMSI session successfully established, exit.                    :
    +-+------------------------------------------------------------------+

    The Server must monitor its incoming data channel for 'normal' data,
    ie. data not transmitted as IEMSI sequences, to detect if the user is
    attempting to log-in without the use of IEMSI. The only basic
    restriction this imposes on the Server is that user names and/or IDs
    may not start with the character '*' since all EMSI/IEMSI sequences
    start with this character.

    All processing of the information in the EMSI_ICI packet must be done
    after transmitting the EMSI_ISI packet and receiving two EMSI_ACK
    sequences in return.


    STEP 2B, Client

    Note that this assumes that the Client has seen the EMSI_IRQ sequence
    transmitted by the Server and that the negotiation is ready to take
    place.

    +-+------------------------------------------------------------------+
    :1: Tries=0, T2=60 seconds                                           :
    +-+------------------------------------------------------------------+
    :2: Transmit EMSI_ICI packet                                         :
    +-+------------------------------------------------------------------+
    :3: T1=20 seconds, increment Tries                                   :
    +-+------------------------------------------------------------------+
    :5: Tries>3 or T2 expired?            Discontinue IEMSI negotiation. :
    : +------------------------------------------------------------------+
    : : If T1 has expired, go to step 2.                                 :
    : +------------------------------------------------------------------+
    : : If EMSI_ISI seen, go to step 6.                                  :
    : +------------------------------------------------------------------+
    : : Go to step 5.                                                    :
    +-+------------------------------------------------------------------+
    :6: Receive EMSI_ISI packet                                          :
    : +------------------------------------------------------------------+
    : : Packet received OK?              Transmit EMSI_ACK packet twice, :
    : :                                  and go to step 7.               :
    : +------------------------------------------------------------------+
    : : Packet not received OK?          Transmit EMSI_NAK and go to step:
    : :                                  3.                              :
    +-+------------------------------------------------------------------+
    :7: IEMSI session successfully established, exit.                    :
    +-+------------------------------------------------------------------+

    All processing of the information in the EMSI_ISI packet must be done
    after transmitting two EMSI_ACK sequences in return.

    If either of the ICI or ISI packets are NAK'd three consecutive times,
    the session negotiation attempt is terminated and the Client proceeds
    as it would have done should the Server not have supported IEMSI.


    IEMSI packet and sequence definitions
    =====================================================================

    =====================================================================
    EMSI ACK                                        **EMSI_ACK<crc16><CR>
    ---------------------------------------------------------------------
    EMSI ACK is transmitted by either Client or Server as a positive
    acknowledgement of the valid receipt of an IEMSI packet such as
    EMSI_ISI and EMSI_ICI. During an IEMSI session, this sequence can,
    however, be used as a positive acknowledgement for other IEMSI
    packets. Redundant EMSI_ACK sequences should be ignored.

    =====================================================================
    EMSI NAK                                        **EMSI_NAK<crc16><CR>
    ---------------------------------------------------------------------
    EMSI NAK is transmitted by either Client or Server as a negative
    acknowledgement of the valid receipt of an IEMSI packet such as
    EMSI_ISI and EMSI_ICI. During an IEMSI session, this sequence can,
    however, be used as a negative acknowledgement for other IEMSI
    packets. Redundant EMSI_NAK sequences should be ignored.

    =====================================================================
    EMSI IRQ                                        **EMSI_IRQ<crc16><CR>
    ---------------------------------------------------------------------
    Similar to EMSI_REQ which is used by mailer software to negotiate a
    mail session. IRQ identifies the Server as being capable of
    negotiating an IEMSI session. When the Client detects an IRQ sequence
    in its inbound data stream, it attempts to negotiate an IEMSI
    session.

    =====================================================================
    EMSI IIR                                        **EMSI_IIR<crc16><CR>
    ---------------------------------------------------------------------
    The IIR (Interactive Interrupt Request) sequence is used by either
    Client or Server to abort the current negotiation. This could be
    during the initial IEMSI handshake or during other interactions
    between the Client and the Server.

    =====================================================================
    EMSI ICI                             **EMSI_ICI<len><data><crc32><CR>
    ---------------------------------------------------------------------
    The ICI packet is used by the Client to transmit its configuration
    and Server-related information to the Server. It contains Server
    parameters, Client options, and Client capabilities.

    =====================================================================
    EMSI ISI                             **EMSI_ISI<len><data><crc32><CR>
    ---------------------------------------------------------------------
    The ISI packet is used by the Server to transmit its configuration
    and Client-related information to the Client. It contains Server data
    and capabilities.

    =====================================================================
    EMSI ISM                             **EMSI_ISM<len><data><crc32><CR>
    ---------------------------------------------------------------------
    The ISM packet is used to transfer ASCII images from the Server to
    the Client. These images can then be recalled by the Client when
    the Server needs to display a previously displayed image. This will
    be further described in future revisions of this document.

    =====================================================================
    EMSI CHT                                        **EMSI_CHT<crc16><CR>
    ---------------------------------------------------------------------
    The CHT sequence is used by the Server to instruct the Client
    software to enter its full-screen conversation mode function (CHAT).
    Whether or not the Client software supports this is indicated in the
    ICI packet.

    If the Server transmits this sequence to the Client, it must wait for
    an EMSI_ACK prior to engaging its conversation mode. If no EMSI_ACK
    sequence is received with ten seconds, it is safe to assume that the
    Client does not support EMSI_CHT. If, however, an EMSI_NAK sequence
    is received from the Client, the Server must re-transmit the
    EMSI_CHT sequence. Once the on-line conversation function has been
    sucessfully activated, the Server must not echo any received
    characters back to the Client.

    =====================================================================
    EMSI TCH                                        **EMSI_TCH<crc16><CR>
    ---------------------------------------------------------------------
    The TCH sequence is used by the Server to instruct the Client
    software to terminate its full-screen conversation mode function
    (CHAT).

    If the Server transmits this sequence to the Client, it must wait for
    an EMSI_ACK prior to leaving its conversation mode. If no EMSI_ACK
    sequence is received with ten seconds, a second EMSI_TCH sequence
    should be issued before the Server resumes operation. If, however, an
    EMSI_NAK sequence is received from the Client, the Server must
    re-transmit the EMSI_TCH sequence.


    The EMSI_ICI packet
    =====================================================================
    The following pseudo structure shows the layout of the EMSI_ICI
    packet. Note that the information in the EMSI_ICI packet may not
    exceed 2,048 bytes.

    EMSI_ICI
        name,
        alias,
        location,
        data#,
        voice#,
        password,
        birthdate,
        crtdef,
        protocols,
        capabilities,
        requests,
        software,
        xlattabl:                ASCII1;
    end;

    EMSI_ICI field definitions
    ---------------------------------------------------------------------
    
    =====================================================================
    Name and Alias (or Handle)
    ---------------------------------------------------------------------
    The name and possible alias (AKA) of the user (Client). This must be
    treated case insensitively by the Server.

    =====================================================================
    Location
    ---------------------------------------------------------------------
    The geographical location of the user, ie. Stockholm, Sweden.

    =====================================================================
    data# and voice#
    ---------------------------------------------------------------------
    Unformatted data and voice telephone numbers of the user. Unformatted
    is defined as the full telephone number, including country and local
    area code. Eg. 46-8-90510 is a telephone number in Stockholm, Sweden.

    =====================================================================
    Password
    ---------------------------------------------------------------------
    The password for the user. This must be treated case insensitively by
    the Server.

    =====================================================================
    Birthdate
    ---------------------------------------------------------------------
    Hexadecimal string representing a long integer containing the birth-
    date of the user in UNIX notation (number of seconds since midnight,
    Jan 1 1970). This must be treated case insensitively by the Server.

    =====================================================================
    CrtDef
    ---------------------------------------------------------------------
    Consisting of four sub-fields separated by commas, this field
    contains from left to right: The requested terminal emulation
    protocol, the number of rows of the user's CRT, the number of columns
    of the user's CRT, and the number of ASCII NUL (00H) characters the
    user's software requires to be transmitted between each line of text.

    The following terminal emulation protocols are defined:

        AVT0    AVATAR/0+. Used in conjunction with ANSI. If AVT0 is
                specified by the Client, support for ANSI X3.64 emulation
                should be assumed to be present.
        ANSI    ANSI X3.64
        VT52    DEC VT52
        VT100   DEC VT100
        TTY     No terminal emulation, also referred to as RAW mode.

    =====================================================================
    Protocols
    ---------------------------------------------------------------------
    The file transfer protocol option specifies the preferred method of
    transferring files between the Client and the Server in either
    direction. The Client presents all transfer protocols it is capable
    of supporting and the Server chooses the most appropriate protocol.

        DZA*    DirectZAP (Zmodem variant)
        ZAP     ZedZap (Zmodem variant)
        ZMO     Zmodem w/1,024 byte data packets
        SLK     SEAlink
        KER     Kermit
    
    (*) DirectZAP is a variant of ZedZap. The difference is that the
    transmitter only escapes CAN (18H). It is not recommended to use the
    DirectZAP protocol when the Client and the Server are connected via a
    packet switching network, or via another layer sensitive to control
    characters such as XON and XOFF.


    =====================================================================
    Capabilities
    ---------------------------------------------------------------------
    The capabilities of the user's software. If more than one capability
    is listed, each capability is separated by a comma.

    The following capability codes are defined:

        CHT     Can do full-screen on-line conversation (CHAT).
        MNU     Can do ASCII image download (see ISM packet).
        TAB     Can handle TAB (ASCII 09H) characters.
        ASCII8  Can handle 8-bit IBM PC ASCII characters.

    =====================================================================
    Requests
    ---------------------------------------------------------------------
    The requests field specifies what the user wishes to do once the
    initial IEMSI negotiation has been successfully completed. If more
    than one capability is listed, each capability is separated by a
    comma.

    The following request codes are defined:

        NEWS    Show bulletins, announcements, etc.
        MAIL    Check for new mail.
        FILE    Check for new files.
        HOT     Hot-Keys.
        CLR     Screen clearing.
        HUSH    Do not disturb.
        MORE    Page pausing, often referred to as "More".
        FSED*   Full-screen editor.
        XPRS    <reserved>.

    (*) Note that this allows the Client to request use of a full-screen
    editor without requiring that it also supports a full-screen terminal
    emulation protocol.

    =====================================================================
    Software
    ---------------------------------------------------------------------
    The name, version number, and optionally the serial number of the
    user's software. Eg. {FrontDoor,2.00,AE000001}.

    =====================================================================
    XlatTabl
    ---------------------------------------------------------------------
    Used for character translation between the Server and the Client.
    This field has not been completely defined yet and should always be
    transmitted as {} (empty).


    The EMSI_ISI packet
    =====================================================================
    The following pseudo structure shows the layout of the EMSI_ISI
    packet. Note that the information in the EMSI_ISI packet may not
    exceed 2,048 bytes.

    EMSI_ISI
        id,
        name,
        location,
        operator,
        localtime,
        notice,
        wait,
        capabilities:            ASCII1;
    end;

    EMSI_ISI field definitions
    ---------------------------------------------------------------------
    
    =====================================================================
    ID
    ---------------------------------------------------------------------
    The name, version number, and optionally the serial number of the
    Server software. Eg. {RemoteAccess,1.10/b5,CS000001}.

    =====================================================================
    Name
    ---------------------------------------------------------------------
    The name of the Server system. Eg. {Advanced Engineering S.A.R.L.}.

    =====================================================================
    Location
    ---------------------------------------------------------------------
    The geographical location of the user, ie. Stockholm, Sweden.

    =====================================================================
    Operator
    ---------------------------------------------------------------------
    The name of the primary operator of the Server software. Eg. {Joaquim
    H. Homrighausen}.



    =====================================================================
    Localtime
    ---------------------------------------------------------------------
    Hexadecimal string representing a long integer containing the current
    time of the Server in UNIX notation (number of seconds since midnight,
    Jan 1 1970). This must be treated case insensitively by the Client.

    =====================================================================
    Notice
    ---------------------------------------------------------------------
    May contain copyright notices, system information, etc. This field
    may optionally be displayed by the Client.

    =====================================================================
    Wait
    ---------------------------------------------------------------------
    A single character used by the Server to indicate that the user
    has to press the <Enter> key to resume operation. This is used in
    conjunction with ASCII Image Downloads (see ISM packet).

    =====================================================================
    Capabilities
    ---------------------------------------------------------------------
    The capabilities of the Server software. No Server software
    capabilities have currently been defined.

    Credits and other notes
    =====================================================================
    The original EMSI specifications were designed by Chris Irwin and
    Joaquim H. Homrighausen. The original IEMSI specifications were
    designed by Joaquim H. Homrighausen and Andrew Milner.
BackGo Back