API Guide
601355 Rev A API Functions 2-975
Functins
VSCMD_Move VSCMD_Move directs the movement of media from one
archive to another. Inter-archive media movement requires
operator intervention. An operator must eject media from their
home archives and enter them into the specified target archive.
The eject and enter functionalities are available from the
appropriate archive's console display. The eject and enter
functionalities are not available from the API.
Upon receipt of a Move request, VolServ verifies the specified
media exist, the target archive supports the media type name of
the specified media, and there exists an appropriate archive
media class with the target archive. Only one target archive can
be specified on a move request. The current archive of each
specified medium is commanded to eject the medium. An Eject
request, specifying the target archive, is displayed on the
archive console of each source archive. The operator selects and
manually ejects/removes the media on each eject list. After a
medium is ejected from its home archive, the target archive
displays a corresponding Enter request for that medium. The
operator then manually enters the medium on the Enter list into
the target archive.
When the VSID_MOVE_OPTION parameter is set to
VSE_MOVE_WAIT, VolServ waits until processing of the
Move command completes before returning status to the client.
The client must monitor the media movement in some other
manner (e.g., MediaClass callbacks) to know when the media
are ejected from the home archives and entered into the target
archive.
When the VSID_MOVE_OPTION parameter is set to
VSE_MOVE_NOWAIT, VolServ returns a status code to the
client after the specified media are placed on the ejection
candidate list of the home archives.