rfc1645.txt

著名的RFC文档,其中有一些文档是已经翻译成中文的的.


RFC 1645                    SNPP - Version 2                   July 1994


   Entered" message, and allow the user to continue.

   Possible responses from the SNPP server, with suggested text, in
   response to a MESSage command are:

    250 Message OK
    421 Too Many Errors, Goodbye (terminate connection)
    421 Gateway Service Unavailable (terminate connection)
    503 ERROR, Message Already Entered
    550 ERROR, Invalid Message
    554 Error, failed (technical reason)

4.2.3 RESEt

   The RESEt command clears already entered information from the server
   session, resetting it to the state of a freshly opened connection.
   This is provided, primarily, as a means to reset accidentally entered
   information during a manual session.

   Possible responses from the SNPP server, with suggested text, in
   response to a RESEt command are:

    250 RESET OK
    421 Too Many Errors, Goodbye (terminate connection
    421 Gateway Service Unavailable (terminate connection)

4.2.4 SEND

   The SEND command finalizes the current message transaction, and
   processes the page to the paging terminal.  Prior to processing, the
   PAGEr and MESSage fields (or message DATA when using the level two
   option) should be checked for the existence of information.  Should
   one of these required fields be missing, the server should respond
   "503 Error, Incomplete Information" and allow the user to continue.
   Assuming that the information is complete, the SNPP server should
   format and send the page to the paging terminal, and await a
   response.

   Possible responses from the SNPP server, with suggested text, in
   response to a SEND command are:

    250 Message Sent Successfully
    421 Too Many Errors, Goodbye (terminate connection)
    421 Gateway Service Unavailable (terminate connection)
    503 Error, Pager ID or Message Incomplete
    554 Message Failed [non-administrative reason]





Gwinn                                                           [Page 6]

RFC 1645                    SNPP - Version 2                   July 1994


   Or, in the case of an illegal or non-existent pager ID, or some other
   administrative reason for rejecting the page, the server should
   respond:

    550 Failed, Illegal Pager ID (or other explanation)

   After processing a SEND command, the server should remain online to
   allow the client to submit another transaction.

4.2.5 QUIT

   The QUIT command terminates the current session.  The server should
   simply respond:

    221 OK, Goodbye"

   and close the connection.

4.2.6 HELP (optional)

   The optional HELP command displays a screen of information about
   commands that are valid on the SNPP server.  This is primarily to
   assist manual users of the gateway.  Each line of the HELP screen
   (responses) are preceded by a code "214".  At the end of the HELP
   sequence, a "250" series message is issued.

   Possible responses from the SNPP server, with suggested text, in
   response to a HELP command are:

    214 [Help Text]  (repeated for each line of information)
    250 End of Help Information
    421 Too Many Errors, Goodbye (terminate connection)
    421 Gateway Service Unavailable (terminate connection)
    500 Command Not Implemented

4.3 Level 2 - Minimum Extensions

   This section specifies minimum enhancements to the SNPP protocol for
   added functionality.

4.3.1 DATA

   The DATA command is an alternate form of the MESSage command,
   allowing for multiple line delivery of a message to the paging
   terminal.  This command's function is similar to the DATA command
   implemented in SMTP (Internet STD10, RFC821).  The SNPP server should
   only allow one DATA or MESSage command to be issued prior to a SEND.




Gwinn                                                           [Page 7]

RFC 1645                    SNPP - Version 2                   July 1994


   Possible responses from the SNPP server, with suggested text, in
   response to a DATA command are:

    354 Begin Input; End with <CRLF>'.'<CRLF>
    421 Too Many Errors, Goodbye (terminate connection)
    421 Gateway Service Unavailable (terminate connection)
    503 ERROR, Message Already Entered
    500 Command Not Implemented
    550 ERROR, failed (administrative reason)
    554 ERROR, failed (technical reason)

   Upon receiving a "354" response, the client begins line input of the
   message to send to the pager.  A single period ("."), in the first
   position of the line, terminates input.  After input, the server may
   respond:

    250 Message OK
    421 Too Many Errors, Goodbye (terminate connection)
    421 Gateway Service Unavailable (terminate connection)
    550 ERROR, Invalid Message (or administrative reason)
    554 ERROR, Failed (technical reason)

4.4 Level 2 - Optional Extensions

   This section discusses enhancements to the SNPP protocol for more
   control over paging functions.  These are primarily designed to
   mirror the added functionality built into the Telocator Message Entry
   (TME) protocol as specified in the TDP protocol suite. These
   functions may, optionally (as is being done by the author), be
   integrated into a paging terminal.  There is no requirement to
   implement all of these functions.  Requests for invalid functions
   should return a "500 Function Not Implemented" error.

   It is important to note that, at the time of this publication, the
   TME standard is still not finalized.

4.4.1 LOGIn <loginid> [password]

   This command allows for a session login ID to be specified.  It is
   used to validate the person attempting to access the paging terminal.
   If no LOGIn command is issued, "anonymous" user status is assumed.

   Possible responses from the SNPP server, with suggested text, in
   response to a LOGIn command are:

    250 Login Accepted
    421 Too Many Errors, Goodbye (terminate connection)
    421 Gateway Service Unavailable (terminate connection)



Gwinn                                                           [Page 8]

RFC 1645                    SNPP - Version 2                   July 1994


    421 Illegal Access Attempt
    550 Error, Invalid LoginID or Password
    554 Error, failed (technical reason)

4.4.2 PAGEr <PagerID> [Password/PIN]

   This PAGEr command is an enhancement to the level one specification.
   The primary difference is the ability to specify a password or PIN
   for validation or feature access.

   Before proceeding, it is important to understand the logical function
   of the PAGEr command with respect to the LEVEl, COVErage, HOLDtime,
   and ALERt commands (option parameters as described below).  Each time
   a PAGEr command is issued, it should be thought of as the last step
   in a multiple step transaction.

   When the PAGEr command is processed, the pager ID (and password) is
   submitted to the paging terminal with LEVEl, COVErage, HOLDtime, and
   ALERt.  If these parameters have not been altered, then their
   defaults are assumed for the transaction.  After the next PAGEr
   command has been processed, these option parameters are reset their
   defaults.  Using this type of "option-option- option-go" scheme, it
   is possible to specify a different priority level for "Jeff," and an
   alternate coverage area for "Kathy," while sending the same message
   to each.

   Possible responses from the SNPP server, with suggested text, in
   response to a PAGEr command are:

    250 Pager ID Accepted
    421 Too Many Errors, Goodbye (terminate connection)
    421 Gateway Service Unavailable (terminate connection)
    550 Error, Invalid Pager ID or Password
    554 Error, failed (technical reason)

4.4.3 LEVEl <ServiceLevel>

   The LEVEl function is used to specify an optional alternate level of
   service for the next PAGEr command.  Ideally, "ServiceLevel" should
   be an integer between 0 and 11 inclusive.  The TME protocol specifies
   ServiceLevel as follows:

    0 - Priority
    1 - Normal (default)
    2 - Five minutes
    3 - Fifteen minutes
    4 - One hour
    5 - Four hours



Gwinn                                                           [Page 9]

RFC 1645                    SNPP - Version 2                   July 1994


    6 - Twelve hours
    7 - Twenty Four hours
    8 - Carrier specific '1'
    9 - Carrier specific '2'
   10 - Carrier specific '3'
   11 - Carrier specific '4'

   The choice on how to implement this feature, or to what level it
   should be implemented, should be optional and up to the discretion of
   the carrier.

   Possible responses from the SNPP server, with suggested text, in
   response to a LEVEl command are:

    250 OK, Alternate Service Level Accepted
    421 Too Many Errors, Goodbye (terminate connection)
    421 Gateway Service Unavailable (terminate connection)
    500 Command Not Implemented
    550 Error, Invalid Service Level Specified
    554 Error, failed (technical reason)

4.4.4 ALERt <AlertOverride>

   The optional ALERt command may be used to override the default
   setting and specify whether or not to alert the subscriber upon
   receipt of a message.  This option, like the previous command, alters
   the parameters submitted to the paging terminal using the PAGEr
   command.  The TME protocol specifies AlertOverride as either 0-
   DoNotAlert, or 1-Alert.

   Possible responses from the SNPP server, with suggested text, in
   response to a ALERt command are:

    250 OK, Alert Override Accepted
    421 Too Many Errors, Goodbye (terminate connection)
    421 Gateway Service Unavailable (terminate connection)
    500 Command Not Implemented
    550 Error, Invalid Alert Parameter
    554 Error, failed (technical reason)

4.4.5 COVErage <AlternateArea>

   The optional COVErage command is used to override the subscriber's
   default coverage area, and allow for the selection of an alternate
   region.  This option, like the previous command, alters the
   parameters submitted to the paging terminal using the PAGEr command.
   AlternateArea is a designator for one of the following:




Gwinn                                                          [Page 10]

RFC 1645                    SNPP - Version 2                   July 1994