sam_chmed(3)

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).