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_unload - Unloads media on the removable media device SYNOPSIS cc [ flag ... ] file ... -L/opt/SUNWsamfs/lib -lsamapi [library ... ] #include "/opt/SUNWsamfs/include/samapi.h" int sam_unload(ushort_t eq_number, int wait_response); DESCRIPTION sam_unload() requests that the media be unloaded from the device with equipment number eq_number. The device must be a removable media device or a robotic media changer. The dev- ice cannot be under the control of another process. If the equipment number eq_number is a removable media dev- ice controlled by a robotic media changer, the medium will be moved into storage. If the equipment number eq_number is a robotic media changer, the unload moves catalog entries from the robotic media changer's catalog to the Historian's catalog. 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_unload() fails if one or more of the following are true: ER_DEVICE_NOT_READY The specified eq_number device is not ready. ER_DEVICE_NOT_UNAVAILABLE The specified eq_number device must be in the unavailable state (see set_state(1M)). 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_DEVICE_FOUND The device with equipment number eq_number is not available in this con- figuration. 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 and 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 and SAM-QFS file systems are mounted. ER_NO_RESPONSE_FIFO Unable to create the response FIFO pipe. ER_NOT_REMOV_MEDIA_DEVICE The specified eq_number device is not a removable media device. ER_OPERATOR_NOT_PRIV Operator does not have permission to unload removable media. FILES mcf The configuration file for Sun QFS and SAM-QFS file systems. SEE ALSO load(1M), sam-robots(1M), set_state(1M), unload(1M). sam_load(3). mcf(4).