4-40 DAS ACI Functions
601626-B
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. See Table 4-15.
The database entry for the volume is not deleted, and the
position in the AML that the volume occupied remains
reserved for insertion of a volume with a matching volser.
This could be useful if the volume is temporarily ejected and
will be inserted in the near future. In such case, the position
remains reserved and the volume’s location within the AML
does not change.
The eject will stop, when the eject area is full. The request will
either be cancelled or completed after the area is marked
empty depending on the DAS_EJECTAREAFULL
environment variable.
For additional information, refer to aci_eject2 on page 4-42,
and aci_eject_ complete on page 4-49.
Return Values
• 0: The call was successful.
• -1: The call failed.
The external variable d_errno is set to one of the following
DAS error codes:
• ERPC
• EINVALID
Table 4-15 Parameters for the aci_eject Function Call
Parameter Description
clientname Using SHARED_ACCESS as a key word for the client shows
all drives which are allocated in the SHARED_ACCESS mode.
Using EXUP as a key word for the clientname shows all drives
which are allocated in the EXUP mode.
eject_area Logical area defined in AML, where the cartridges should be
ejected
volser_ranges • a single volser
• multiple volsers separated by commas
• a range of volsers separated by a hyphen
types media type of the named volser
Refer to Media Types on page 2-7