autochanger.7 (2010 09)

a
autochanger(7) autochanger(7)
/* structure for SIOC_RESERVE and SIOC_RELEASE ioctls */
struct reservation_parms {
unsigned short element;
unsigned char identification;
unsigned char all_elements;
};
/* structure for SIOC_MOVE_MEDIUM ioctl */
struct move_medium_parms {
unsigned short transport;
unsigned short source;
unsigned short destination;
unsigned char invert;
};
/* structure for SIOC_EXCHANGE_MEDIUM ioctl */
struct exchange_medium_parms {
unsigned short transport;
unsigned short source;
unsigned short first_destination;
unsigned short second_destination;
unsigned char invert_first;
unsigned char invert_second;
};
SIOC_INIT_ELEM_STAT
Cause the media changer device to take inventory. As a result, the media changer device deter-
mines the status of each and every element address, including the presence or absence of a unit of
media. This is a mechanical operation which can take time. This function only necessary in the
event of a severe error of the media changer.
SIOC_ELEMENT_ADDRESSES
Determine the element addresses supported by a media changer device. The first valid element
address and the number of elements is indicated for each element type. These element addresses
may be used as source and destination location arguments.
SIOC_ELEMENT_STATUS
Determine the status of an element. The element address for which status information is requested
is specified via the element field. The resulting status data indicates the presence or absence of a
unit of media in that element address as well as other information about the element address.
SIOC_RESERVE and SIOC_RELEASE
Control access to element addresses. Depending on the device, reservations may limit operator con-
trol of those element addresses in the media changer device. Specific element addresses can be
reserved to handle interlocking between multiple requesters if each requester has a unique reserva-
tion identification. The value zero in the all_elements field specifies that a single element
address should be reserved or released. An element address reserved in this manner can not be
reserved by another single element address reservation using a different reservation identification.
The reservation field specifies the reservation identification. The element field specifies the
element address to be reserved.
The value "1" in the
all_elements field indicates that all element addresses should be reserved.
The reservation and element fields should contain the value zero since these fields are not
meaningful when reserving all element addresses. Reserving all element addresses is primarily
useful for limiting operator control.
SIOC_MOVE_MEDIUM and SIOC_EXCHANGE_MEDIUM
Reposition unit(s) of media. Depending on the source and destination element types, this may result
in a media load, eject, or simple repositioning. Media can be "flipped" using values of "1" in the
invert, invert_first, or invert_second fields. The SIOC_EXCHANGE_MEDIUM ioctl
repositions two different units of media. One unit of media is moved from the element specified by
the source field to the element specified by the first_destination field. A second unit of
media is moved from the element specified by the first_destination field to the element
specified by the second_destination field. In an autochanger with multiple changer mechan-
isms, or a media staging area, an exchange occurs if the source and second_destination
fields are the same.
HP-UX 11i Version 3: September 2010 − 3 − Hewlett-Packard Company 3