TPMove()

Move a single Trading Partner ID from a Network/Mailbox to the Session Network/Mailbox.


      Public Function TPMove(ByVal SessionID As String, _
                       ByVal ECGridID As Integer, _
                       
      ByVal MoveDateTime As Date) 
      _
                       
      As Integer

Parameters

SessionID: String - GUID; The current session's GUID in string format. This is a 32-character hexidecimal string in the format:
00000000-0000-0000-0000-000000000000. This is the value returned by the Login() function.
ECGridID: Integer; The ECGridID that represents the existing Trading Partner on another Network/Mailbox.
MoveDateTime: Date; Specified date and time in UTC (see NowUTC) for the move. At that date and time the old ECGridID will be terminated and the new ECGridID will be activated.

Returns

ECGridID: Integer; A new ECGridID for the ID on the Session Network/Mailbox.

Remarks

Moving a Trading Partner Qualifier/ID (QID) from one Network/Mailbox to another is a process also known as a Migration. There are numerous complexities in this process which may include written authorization by the owner of the QID to release the QID from the existing Network. In general, a PDF of such a request on company letterhead is sufficient.

ECGrid can optionally manage this migration by sending out notices of the pending migration to all Networks, sending reminders and tracking confirmations.

Most Networks require at least 3 business days advanced notification for an ID to be moved. The system enforces this rule. If you need a move expedited, please contact ECGrid NetOps to override this limitation.

To move a QID to a specified Network/Mailbox use TPMoveEx().

Example

Visual Basic

[insert code sample]

TPMove()

Parameters

Returns

Remarks

Example

EventID: 3004

See Also