API Guide
601355 Rev A API Functions 2-855
Functions
If the lock identifier specified on a Dismount request differs
from the lock identifier associated with the specified drive, the
Dismount request fails.
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, the final status for this request 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 Dismount request 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 Dismount
commands are set with VSCMD_Dismount_SetDefaults.
If command-specific defaults are set for Dismount
commands, they override the global defaults for all
commands.
Tip
To override a default (global or command-specific)
parameter value for a specific instance of a Dismount
command, the parameter identifier and the value to be
used for the parameter can be submitted on the specific
request itself.