ADIC Server manual Acieject complete

aci_eject_ complete

The aci_eject_complete function ejects volumes and removes the database entries. See Figure 4-39.

#include "aci.h"

int aci_eject_complete( char *eject_area, char *volser_range, enum aci_media type)

Figure 4-39aci_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-18for a description of the parameters for the aci_eject_complete function call.

Table 4-18Parameters 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

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.

aci_eject_ complete 4-49

21 Dec 2001