API Guide
2-848 API Functions 601355 Rev A
VSCMD_
Dismount
A VSCMD_Dismount request informs VolServ that the client
is finished using a drive and the medium mounted in the drive.
Upon receipt of a VSCMD_Dismount request for an
automated archive, VolServ determines whether the medium
has been ejected from the drive by the storage subsystem.
If the medium has been ejected from the drive, VolServ
commands the archive robotics to move the medium from the
drive pickup point to a bin within the archive system. A
successful return code is returned to the client after the medium
movement has completed.
If the medium has not been ejected from the drive, the dismount
request fails, and VolServ returns a failure status to the client.
For manual archives, a dismount notice is sent to the
appropriate archive's console display for action. An operator
must dismount the specified medium and then notify VolServ
the medium dismount is complete. VolServ returns status to the
client only after the operator confirms the dismount is complete.
The Dismount command supports a lock identifier parameter.
This parameter is required if the drive to be dismounted has
been previously locked with a Lock request.
Synopsis
VST_BOOLEAN VSCMD_Dismount
(VST_COMMAND_HANDLE handle,
“…”,
VSID_ENDFIELD)