API Guide
2-884 API Functions 601355 Rev A
VolServ can generate intermediate status in response to a Drive
Query request. Statuses are cumulative. Each status is added to
the previous status so that after the final status is given, the
status handle contains information from all statuses.
VSCMD_DriveQuery does not trigger any MediaClass
callbacks from VolServ.
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.
The VSID_DRIVE_ID_LIST and
VSID_COMP_STATE_LIST parameters require that two
arguments be passed instead of one.
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 Drive Query 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 Drive Query
commands are set with
VSCMD_DriveQuery_SetDefaults. If