ADIC Server - Manual (Page 117)

aci_insert 4-75
21 Dec 2001
aci_insert
The aci_insert function inserts volumes into the AML. See
Figure 4-66.
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-28 for 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
#include "aci.h"
int aci_insert( char *insert_area,
char *volser_ranges,
enum aci_media type )