API Guide
601355 Rev A API Functions 2-641
Functions
VSCMD_Drive
Vary VSCMD_DriveVary is issued to execute VolServ Drive Vary
requests and to change the operational availability of a drive.
The drive and target state (VSE_COMP_ONLINE,
VSE_COMP_OFFLINE, or VSE_COMP_DIAGNOSTIC) must
be specified.
A drive in the off-line, unavailable, or diagnostic state is
excluded from VolServ's drive selection algorithm.
A Mount or Lock request for an off-line, unavailable, or
diagnostic drive fails.
Conversely, varying a drive to the on-line state makes it
available for selection for Mount or Lock requests.
Upon receipt of a Drive Vary request, VolServ attempts to
change the state of the specified drive. The return code
presented to the client indicates the success or failure of the
command.
Synopsis VST_BOOLEAN VSCMD_DriveVary
( VST_COMMAND_HANDLE handle,
"…",
VSID_ENDFIELD )
Arguments •handle = The command handle for this Drive Vary
request.
•"…" = Variable length argument list consisting of pairs of
arguments. Each pair of arguments consists of a parameter
identifier, followed by the value of the field to use for this
request. The valid parameter identifiers and types for this
function are shown in the following "Parameters"
paragraph.