ADIC Server manual Aciinsert

aci_insert

The aci_insert function inserts volumes into the AML. See

Figure 4-66.

#include "aci.h"

int aci_insert( char *insert_area, char *volser_ranges, enum aci_media type )

Figure 4-66	aci_insert Function Call
		This function is for compatibility. Please use the
		aci_insertgen function.
		The cartridges which are actually located in the insert area of
		the AML and registered by the AMU (automatically
		inventoried after closing the area) will be inserted.
		• Volsers which already have a entry in the AMU database,
		will be moved to this position.
		• Volsers which have no entry in the AMU database, will be
		moved to the first free slot (AMU database Attribute:
		"Empty" of this media type of the Type AMU-Dynamic)
		• Cartridges with an invalid volser (barcode not readable)
		will moved to the problembox.
		See Table 4-28for a description of the parameters for the
		aci_insert function call.
Table 4-28	Parameters for the aci_insert Function Call
Parameter		Description
insert_area		Logical insert range of the Insert/Eject unit of the AML in the
		AMS (e.g. I03)
volser_range		The volumes found in the insert_area are returned in the
		volser_ranges array of strings, where each volser is separated by a
		comma. Each range is ACI_RANG_LEN long and there are up to
		ACI_MAX_RANGES ranges. An empty string indicates the end of
		the ranges
type		media type of the volser in the insert area
		Refer to Media Types on page 2-7
		aci_insert 4-75

21 Dec 2001