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_import - Imports media to the removable media robotic device SYNOPSIS cc [ flag ... ] file ... -L/opt/SUNWsamfs/lib -lsamapi [library ... ] #include "/opt/SUNWsamfs/include/samapi.h" int sam_import(ushort_t eq_number, char *vsn, char *media_nm, int audit_eod, int wait_response); DESCRIPTION sam_import() requests the robotic media changer to import the selected media into the robot. The media is placed in the first available element address of the catalog. For GRAU, STK, or IBM libraries, the vsn must be specified. Physical import of media within the GRAU and STK are per- formed by utilites supplied by the vendor. Both the vsn and the media_nm need to be specified to import into the His- torian. 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_import() fails if one or more of the following are true: ER_AUDIT_EOD_NOT_HISTORIAN A non-zero audit_eod flag, requesting an audit to end-of-data, cannot be speci- fied for the Historian. ER_DEVICE_NOT_READY The specified eq_number device is not ready. ER_FIFO_PATH_LENGTH The path and filename for the FIFO pipe is too long. ER_HISTORIAN_MEDIA_ONLY media_nm can only be specified for the Historian. ER_INVALID_MEDIA_TYPE The specified media_nm is not a valid media type. ER_MEDIA_FOR_HISTORIAN The type of media media_nm must be specified for the Historian. 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_RESPONSE_FIFO Unable to create the response FIFO pipe. 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_OPERATOR_NOT_PRIV Operator does not have permission to import removable media. ER_ROBOT_DEVICE_REQUIRED Equipment number eq_number is not defined as a robotic device. ER_VSN_BARCODE_REQUIRED vsn must be specified for the GRAU, STK, and IBM media changers and the His- torian. FILES mcf The configuration file for Sun QFS and SAM-QFS file systems. SEE ALSO export(1M), import(1M), sam-robotsd(1M). sam_export(3). mcf(4).