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_export - Exports media from the removable media robotic device SYNOPSIS cc [ flag ... ] file ... -L/opt/SUNWsamfs/lib -lsamapi [library ... ] #include "/opt/SUNWsamfs/include/samapi.h" int sam_export(ushort_t eq_number, char *vsn, uint_t ea, int wait_response, int one_step); DESCRIPTION sam_export() requests the robotic media changer to place the selected media that belongs in ea or is labeled with vsn into the mail-slot of the media changer. Either the vsn or the ea must be specified. The vsn should be set to a NULL pointer if ea is specified. The ea should be set to ROBOT_NO_SLOT if the vsn is specified. 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. For network-controlled media changers such as the GRAU using the GRAU ACT interface, IBM 3494, or Sony libraries using PSC, this interface only removes the entry from the catalog. Physical removal and addition of media within these media changers is performed by utilities supplied by GRAU, IBM, and Sony. For STK network-controlled media changers using ACSLS, this interface removes the entry from the catalog only if zero is specified for one_step value. Other values for one_step will cause the physical removal of media and also remove the media from the catalog. 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_export() fails if one or more of the following are true: 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 shared memory seg- ment 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 ea is not a valid element address in the robot at equipment number eq_number ER_OPERATOR_NOT_PRIV Operator does not have permission to export 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_NOT_OCCUPIED ea does not contain any removable media. ER_SLOT_OR_VSN_REQUIRED Either ea or 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 vsn specified cannot be found in the specified robot at equipment number eq_number FILES mcf The configuration file for Sun QFS and SAM-QFS file systems. SEE ALSO build_cat(1M), dump_cat(1M), export(1M), import(1M), sam- robotsd(1M). sam_import(3). mcf(4).