sam_load(3)

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