API Guide
601355 Rev A API Functions 2-751
Functions
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 intermediate and 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 intermediate
and final status for Media Type Query 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.
• Global defaults 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 Media Type
Query commands are set with
VSCMD_MediaQuery_SetDefaults. If
command-specific defaults are set for the Media Type
Query commands, they override the global defaults for all
commands.
The following fields can be retrieved from the status handle
after a successful Media Type Query request:
Tip
To override a default (global or command-specific)
parameter value for a specific instance of a Media Type
Query command, the parameter identifier and the value to
be used for the parameter can be submitted for the specific
command itself.