API Guide
601355 Rev A API Functions 2-839
Functions
The VSID_CONNECT_HANDLE parameter may be used after a
Connect Query command to disconnect an enterprise after the
client has gone down.
A VSCMD_Disconnect request can be issued only through
the client interface. The association between an enterprise and
its clients cannot be established via the GUI.
A Disconnect request cannot be cancelled. The client may
reestablish a connection by issuing a Connect request.
The total length of time the API software waits for a command
status in synchronous mode from VolServ is
(VSID_RETRY_LIMIT plus 1) multiplied by
VSID_TIMEOUT_VALUE.
If the VSID_ENTERPRISE_ID parameter is set to any value
other than zero, final status for this command is returned to the
enterprise registered with VolServ.
When the API software is operating in asynchronous mode,
client software must call VS_Select to receive final status on
a Disconnect command submitted through the API interface to
the VolServ system.
Two levels of default parameter settings are used in the API
software— global defaults and command-specific defaults.
• Global defaults for all commands are initialized at startup
and can be set or retrieved using
VS_Global_SetFields
and VS_Global_GetFields function calls.
• Command-specific parameter defaults for the Disconnect
command are set with
VSCMD_Disconnect_SetDefaults. If