API Guide
2-554 API Functions 601355 Rev A
A ClearEject request can trigger MediaClass callbacks from
Vol S e rv .
Failure of a ClearEject request for one medium does not fail the
request for all media.
An operator can also remove a medium from the Eject list by
performing an Eject Fail from the appropriate archive console.
The Eject Fail functionality is not available over the API
interface.
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 on a ClearEject 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 ClearEject
commands are set with
VSCMD_ClearEject_SetDefaults. If