Filter
Top Products
API Guide
601355 Rev A API Functions 2-709
Functions
If a Mount request specifies a drive pool and does not specify a
lock identifier, only available and unlocked drives in the
specified drive pool are considered to satisfy the Mount request.
If there are no available, unlocked drives in the specified drive
pool, the Mount request waits until a drive from the specified
drive pool becomes available and unlocked.
There are three ways to specify drives for locking: by drive
identifier, drive list, or drive pool (with or without the exclusion
list).
A Lock command that is queued and awaiting resources can be
cancelled via the Cancel command.
An Unlock command should be issued when the client no
longer needs drives for exclusive use.
All parameters can be set for the specific request being sent by
passing them to this function, or they can be set for all Lock
requests using the VSCMD_Lock_SetDefaults function.
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 API is not able to receive status for this
request.
When the API software is operating in asynchronous mode,
client software must call VS_Select to receive intermediate
and final status on command requests 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.