API Guide
2-526 API Functions 601355 Rev A
Notes The API must be initialized with a call to VS_Initialize
before this function may be executed.
VolServ does not generate intermediate status messages for a
Checkin request.
VSCMD_Checkin can trigger MediaClass callbacks from
Vol S e rv .
Media must be checked-out before they can be specified on a
Checkin request.
Media checked-out of one archive can be checked into another
archive, as long as the MediaClass group where the media
belong are associated with archive media class(es) in the
receiving archive.
Failure of a Checkin request for one medium does not fail the
request for all specified media.
Media checked out from more than one archive can be checked
in as a single group into a single new archive (assuming
necessary archive media class associations are defined.)
Media that are checked out from more than one archive and are
checked in as a single group without a target archive specified
(the archive name is set to the empty string, “ “) are returned to
their respective check-out archives.
The total length of time the API software waits for a command
status 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.