sam_unload(3)

NAME
     sam_unload - Unloads media on the removable media device

SYNOPSIS
     cc [ flag  ... ] file  ... -L/opt/SUNWsamfs/lib  -lsamapi  [library ... ]

     #include "/opt/SUNWsamfs/include/samapi.h"

     int sam_unload(ushort_t eq_number, int wait_response);

DESCRIPTION
     sam_unload() requests that the media be  unloaded  from  the
     device with equipment number eq_number. The device must be a
     removable media device or a robotic media changer.  The dev-
     ice cannot be under the control of another process.

     If the equipment number eq_number is a removable media  dev-
     ice  controlled  by a robotic media changer, the medium will
     be moved into storage.

     If  the  equipment  number  eq_number  is  a  robotic  media
     changer,  the  unload moves catalog entries from the robotic
     media changer's catalog to the Historian's catalog.

     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_unload() 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_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_DEVICE_FOUND  The   device   with   equipment   number
                         eq_number  is not available in this con-
                         figuration.

     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 and  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 and  SAM-QFS  file  systems  are
                         mounted.

     ER_NO_RESPONSE_FIFO Unable to create the response FIFO pipe.

     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
                         unload removable media.

FILES
     mcf                 The configuration file for Sun  QFS  and
                         SAM-QFS file systems.

SEE ALSO
     load(1M), sam-robots(1M), set_state(1M), unload(1M).

     sam_load(3).

     mcf(4).