ADIC Server - Manual (Page 91)

aci_eject_ complete 4-49
21 Dec 2001
aci_eject_ complete
The aci_eject_complete function ejects volumes and removes
the database entries. See Figure 4-39.
Figure 4-39 aci_eject_complete function call
Eject the volumes in volser_range to the eject_area. The media
type of the volumes must match that of the eject_area. Set type
to the media type of the volser_range. The database entry for
the volume is deleted, and the position in the AML that the
volume occupied becomes free. This could be useful if the
volume is to be placed in long-term archive storage or more
space is needed in the AML. If the volume is re-inserted into
the AML, it is stored in the next available position, and it
probably will not occupy the previous position. The volume is
re-inserted in the same position only if aci_eject is used.
See Table 4-18 for a description of the parameters for the
aci_eject_complete function call.
The eject will stop, when the eject area is full. Depending on
the DAS_EJECTAREAFULL environment variable, the request
will either be cancelled or completed after the area is marked
empty.
For additional information, refer to aci_eject on page 4-39, and
aci_insert on page 4-75.
Table 4-18 Parameters for the aci_eject_complete Function Call
Parameter Description
eject_area Logical area defined in AMS, where the cartridges should be
ejected
volser_range • a single volser
• multiple volsers separated by commas
• a range of volsers separated by a hyphen
types media types of the named volser
Refer to Media Types on page 2-7
#include "aci.h"
int aci_eject_complete( char *eject_area,
char *volser_range,
enum aci_media type)