(RPC Manager Library)
Description: This function returns the connection status of either: 1) The machine node if the subnet is not valid, or 2) The socket that is on the specified subnet.
Warning: For use by advanced programmers only. Effective use of this function requires a thorough understanding of VTS programming.
Returns: See comments
Usage: Steady State or subroutine call
Format: \RPCManager\GetSocketStatus(MachineName [,Subnet])
Parameters: MachineName { text } { required } { no default }
The name of the machine for which you wish to get the Socket status.
Subnet { text } { optional } { no default }
An optional parameter that specifies which subnet the socket you are interested in is on.
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.
This module returns the status of the connection between two PCs if no Subnet is specified. If the Subnet is specified, then the return value is that of the Socket’s status on the specified Subnet. If a Subnet is not specified and you are using a multi-homed PC, the return value will indicate how many sockets are connected to a particular PC.
Note: In a network using multi-homed PCs, it is possible for two PCs to be connected multiple times under a given Subnet. In such a case, GetSocketStatus will return the status of the first applicable socket found.
See Also: