ADIC Digital Camera 601355 Rev A User Manual

601355 Rev A

API Functions

2-855

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.

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.