Difference between revisions of "Common NetMsg Exchanges"

Line 9: Line 9:
 
# App GS accepts the socket connection.
 
# App GS accepts the socket connection.
 
# App M and App GS are now connected at the socket level.
 
# App M and App GS are now connected at the socket level.
# App M sends a RemHostNameSET NetMsg to App GS.
+
# App M sends a [[RemHostNameSET]] NetMsg to App GS.
# App GS checks its RemHostName list for duplicates. (Alt #1)
+
# App GS checks its [[RemHostName]] list for duplicates. '''(Alt #1)'''
# App GS sends a RemHostNameSETOK NetMsg to App M.
+
# App GS sends a [[RemHostNameSETOK]] NetMsg to App M.
# App GS sends a RemHostNameSET NetMsg to App M.
+
# App GS sends a [[RemHostNameSET]] NetMsg to App M.
# App GS waits for App M to send a RemHostNameSETOK NetMsg.
+
# App GS waits for App M to send a [[RemHostNameSETOK]] NetMsg.
# App M sends a RemHostNameSETOK NetMsg.
+
# App M sends a [[RemHostNameSETOK]] NetMsg.
 
# App M is now connected to the Geometry Service network.
 
# App M is now connected to the Geometry Service network.
# App M sends a NewSessionREQ NetMsg.
+
# App M sends a [[NewSessionREQ]] NetMsg.
 
# App GS creates a new Session.
 
# App GS creates a new Session.
# App GS sends a NewSessionREQOK NetMsg.
+
# App GS sends a [[NewSessionREQOK]] NetMsg.
  
 
===Alt Sequence #1===
 
===Alt Sequence #1===
 
:6a. App GS finds that the incoming Host is already on the HostList.  Either a duplicate name, or a duplicate connection.   
 
:6a. App GS finds that the incoming Host is already on the HostList.  Either a duplicate name, or a duplicate connection.   
:6b. App GS sends App M a RemHostNameSETFAIL NetMsg.
+
:6b. App GS sends App M a [[RemHostNameSETFAIL]] NetMsg.
 
:6c. App GS drops socket connection to App M.
 
:6c. App GS drops socket connection to App M.
 
:6d. App M drops socket connection to App GS.
 
:6d. App M drops socket connection to App GS.
Line 28: Line 28:
  
 
==Application Request For Geometry==
 
==Application Request For Geometry==
This sequence of NetMsg exchanges represents the communications between an external application (App M) as it requests Geometry from the Geometry Service (App GS).  This sequence assumes success.
+
This sequence of NetMsg exchanges represents the communications between an external application (App M) as it requests Geometry from the Geometry Service (App GS).  This sequence assumes success and that both App M and App GS have completed the Application Interconnect Handshake.
 +
 
 +
===Main Sequence===
 +
# App M sends a [[GeometryREQ]] NetMsg to App GS.
 +
# App GS finds the request Geometry. '''(Alt #1)'''
 +
# App GS sends App M a [[GeometryMANIFEST]] NetMsg.
 +
# App GS sends App M as many [[GeometryCHUNK]] NetMsgs as required in order to fulfill the [[GeometryMANIFEST]].
 +
 
 +
===Alt Sequence #1===
 +
:2a. App GS does NOT find requested Geometry.
 +
:2b. App GS sends App M a [[GeometryREQFAIL]] NetMsg.

Revision as of 15:12, 3 December 2008

Design icon.png This page contains the design document for an enhancement or feature. The design should be considered a work in progress and may not represent the final design. As this is a collaborative design, contributions and participation from other developers and users is encouraged. Use the discussion page for providing comments and suggestions.


Application Interconnect Handshake

This sequence of NetMsg exchanges represents the communications between an external application (App M) attempting to connect to a running Geometry Service (App GS). This sequence assumes success.

Main Sequence

  1. App GS waits for incoming socket requests.
  2. App M creates a socket connection to App GS.
  3. App GS accepts the socket connection.
  4. App M and App GS are now connected at the socket level.
  5. App M sends a RemHostNameSET NetMsg to App GS.
  6. App GS checks its RemHostName list for duplicates. (Alt #1)
  7. App GS sends a RemHostNameSETOK NetMsg to App M.
  8. App GS sends a RemHostNameSET NetMsg to App M.
  9. App GS waits for App M to send a RemHostNameSETOK NetMsg.
  10. App M sends a RemHostNameSETOK NetMsg.
  11. App M is now connected to the Geometry Service network.
  12. App M sends a NewSessionREQ NetMsg.
  13. App GS creates a new Session.
  14. App GS sends a NewSessionREQOK NetMsg.

Alt Sequence #1

6a. App GS finds that the incoming Host is already on the HostList. Either a duplicate name, or a duplicate connection.
6b. App GS sends App M a RemHostNameSETFAIL NetMsg.
6c. App GS drops socket connection to App M.
6d. App M drops socket connection to App GS.


Application Request For Geometry

This sequence of NetMsg exchanges represents the communications between an external application (App M) as it requests Geometry from the Geometry Service (App GS). This sequence assumes success and that both App M and App GS have completed the Application Interconnect Handshake.

Main Sequence

  1. App M sends a GeometryREQ NetMsg to App GS.
  2. App GS finds the request Geometry. (Alt #1)
  3. App GS sends App M a GeometryMANIFEST NetMsg.
  4. App GS sends App M as many GeometryCHUNK NetMsgs as required in order to fulfill the GeometryMANIFEST.

Alt Sequence #1

2a. App GS does NOT find requested Geometry.
2b. App GS sends App M a GeometryREQFAIL NetMsg.