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_chmed - Changes library catalog flags SYNOPSIS cc [ flag ... ] file ... -L/opt/SUNWsamfs/lib -lsamapi [library ... ] #include "/opt/SUNWsamfs/include/samapi.h" int sam_chmed(ushort_t eq_number, uint_t ea, int partition, char *media, char *vsn, int flags, int on_off, int wait_response); DESCRIPTION sam_chmed() sets or clears library catalog flags for a par- ticular VSN vsn of media type or a robotic media changer equipment number eq_number and ea and partition number. If the on_off is set to one (1) or zero (0), the flag positions represented by the flags will be set or cleared, respec- tively. 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_chmed() 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_INVALID_FLAG_SET One of the flags specified to be set or cleared is not defined. ER_INVALID_MEDIA_TYPE media specified is not a valid media type. See mcf(4) for valid media types to be specified. ER_INVALID_VSN_LENGTH vsn specified is not the correct length. 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 ea is not a valid element address in the robot at equipment number eq_number ER_ON_OFF_BAD_VALUE on_off value specified is not valid; must be one (1) or zero (0). ER_OPERATOR_NOT_PRIV Operator does not have permission to change media catalog flags 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 eq_number is not a robotic device ER_SLOT_NOT_OCCUPIED No media exists at the element address ea specified ER_SLOT_OR_VSN_REQUIRED Either a element address or volume serial number must be specified; both cannot 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. FILES mcf The configuration file for Sun QFS or SAM-QFS file systems. SEE ALSO chmed(1M), sam-recycler(1M), samu(1M). mcf(4).