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_load - Loads media on the removable media device SYNOPSIS cc [ flag ... ] file ... -L/opt/SUNWsamfs/lib -lsamapi [library ... ] #include "/opt/SUNWsamfs/include/samapi.h" int sam_load(ushort_t eq_number, char *vsn, char *media, uint_t slot, int partition, int wait_response); DESCRIPTION sam_load() requests that the media be loaded from slot:partition or media.vsn into device eq_number. The dev- ice must be in the unavailable state (see set_state(1M)) and controlled by a media changer. If device eq_number already has media loaded, it will be unloaded and the media put away before the new media is loaded. 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. Note: Loading media used by Sun QFS or SAM-QFS for archiving could result in the loss of the data contained on that media. Oracle Corporation strongly recommends that archive media NOT be loaded in this manner. 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_load() 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_OFF_OR_DOWN The specified eq_number device is "off" or "down" and must be in the "unavail- able" 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_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_SLOT_NUMBER The specified ea is not valid for eq_number device. 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 load 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_SLOT_IS_CLEAN_CARTRIDGE ea contains a cleaning cartridge. ER_SLOT_NOT_OCCUPIED ea does not contain any removable media. ER_SLOT_OR_VSN_REQUIRED Either a ea in the media changer or a vsn must be specified. ER_UNABLE_TO_MAP_CATALOG The catalog for the removable media changer at equipment number eq_number is unable to be mapped into memory. ER_VSN_NOT_FOUND_IN_ROBOT The specified vsn cannot be found in the robotic media changer at equipment number eq_number. FILES mcf The configuration file for Sun QFS and SAM-QFS file systems. SEE ALSO load(1M), set_state(1M), sam-robotsd(1M), unload(1M). sam_unload(3). mcf(4).