DisconnectFromMachine

(RPC Manager Library)

Description: This subroutine disconnects from a workstation by decrementing the usage count on the specified workstation and forcing the RPC Manager to attempt to establish a connection with the specified workstation if it is not already connected. Subroutine call only.

Returns: Nothing

Usage: Script

Format: \RPCManager\DisconnectFromMachine(Workstation)

Parameters: Workstation { text } { required } { no default }
Any of the name or IPs that can be used to connect to the workstation.

Comments: This subroutine is a member of the RPC Manager's Library, and must therefore be prefaced by \RPCManager\, as shown in the "Format" section. If the application you are developing is a script application, the subroutine call must be prefaced by System\RPCManager\, and the System variable must be declared in AppMod.src.

When the usage count of the workstation reaches "0", the RPC Manager will not attempt to re-establish a connection to the workstation once the current connection is lost.

It is critical that each DisconnectFromMachinecall should be paired with a ConnectToMachine call; if the number of DisconnectFromMachine calls exceeds the number of ConnectToMachine calls, the RPC Manager will not behave as expected and connection with the remote workstation may be impeded. A negative value for the Srv value in the socket's entry in the RPC Diagnostics Window may be an indication of a DisconnectFromMachine/ConnectToMachine mismatch.

Example:

If Valid(sNode) Done;

[

\RPCManager\DisconnectFromMachine(sNode);

]

This closes an existing socket by using its socket value.