| Skip Navigation Links | |
| Exit Print View | |
|
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
| Skip Navigation Links | |
| Exit Print View | |
|
|
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
NAME
sam_move - Move media in a robotic media changer
SYNOPSIS
cc [ flag ... ] file ... -L/opt/SUNWsamfs/lib -lsamapi [
library ... ]
#include "/opt/SUNWsamfs/include/samapi.h"
int sam_move(ushort_t eq_number, uint_t src_ea, uint_t
dest_ea, int wait_response);
DESCRIPTION
sam_move() requests that the media in the source element
address src_ea be moved to the destination element address
dest_ea in the robotic media changer at equipment number
eq_number. The source element address src_ea must be in use
and occupied (that is, the media is not mounted). The des-
tination element address dest_ea must not be occupied or in
use. Some robotic media changers do not support moving
media between storage element addresses.
The call will return immediately after issuing the command
if zero is specified for wait_response value. Other values
for wait_response will give undefined results.
RETURN VALUES
Upon succesful completion a value of 0 is returned. Other-
wise, a value of -1 is returned and errno is set to indicate
the error.
ERRORS
sam_move() fails if one or more of the following are true:
ER_DEVICE_NOT_READY The specified eq_number device is not
ready.
ER_DEVICE_USE_BY_ANOTHER
The specified eq_number device is busy
and is being used by another process.
ER_FIFO_PATH_LENGTH The path and filename for the FIFO pipe
is too long.
ER_NO_EQUIP_ORDINAL eq_number is not a defined equipment
number in this configuration.
ER_NO_MASTER_SHM No Sun QFS or SAM-QFS master shared
memory segment defined. Check that the
Sun QFS or SAM-QFS file systems are
mounted.
ER_NO_MASTER_SHM_ATT
No Sun QFS or SAM-QFS master shared
memory segment found. Check that the
Sun QFS or SAM-QFS file systems are
mounted.
ER_NO_RESPONSE_FIFO Unable to create the response FIFO pipe.
ER_NO_STAT_ROBOT_CATALOG
The robot media changer catalog for
equipment number eq_number cannot be
accessed for status.
ER_NOT_VALID_DEST_SLOT_NO
The specified destination element
address dest_ea is not valid for
eq_number device.
ER_NOT_VALID_SLOT_NUMBER
The specified source element address
src_ea is not valid for eq_number dev-
ice.
ER_OPERATOR_NOT_PRIV
Operator does not have permission to
move removable media.
ER_ROBOT_CATALOG_MISSING
The robot media changer catalog for
equipment number eq_number is missing
and a full audit is required.
ER_ROBOT_DEVICE_REQUIRED
Equipment number eq_number is not
defined as a robotic device.
ER_ROBOT_NO_MOVE_SUPPORT
Robotic media changer at equipment
number eq_number does not support move-
ment of media between element addresses.
ER_DST_SLOT_IS_OCCUPIED
dest_ea already contains removable
media.
ER_SLOT_NOT_OCCUPIED
ea does not contain any removable media.
ER_DST_SLOT_NOT_AVAIL_MOVE
dest_ea is not available for the move.
ER_SRC_SLOT_NOT_AVAIL_MOVE
src_ea is not available for the move.
ER_UNABLE_TO_MAP_CATALOG
The catalog for the removable media
changer at equipment number eq_number is
unable to be mapped into memory.
FILES
mcf The configuration file for Sun QFS and
SAM-QFS
SEE ALSO
export(1M), import(1M), sam-robotsd(1M).
sam_export(3), sam_import(3).
mcf(4).
|