sam_export(3)

NAME
     sam_export - Exports media from the removable media  robotic
     device

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

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

     int sam_export(ushort_t eq_number, char *vsn, uint_t ea, int
     wait_response, int one_step);

DESCRIPTION
     sam_export() requests the robotic media changer to place the
     selected  media  that  belongs  in ea or is labeled with vsn
     into the mail-slot of the media changer.  Either the vsn  or
     the  ea  must be specified.  The vsn should be set to a NULL
     pointer if ea  is  specified.   The  ea  should  be  set  to
     ROBOT_NO_SLOT if the vsn is specified.

     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.

     For network-controlled media changers such as the GRAU using
     the  GRAU  ACT  interface, IBM 3494, or Sony libraries using
     PSC, this interface only removes the entry from the catalog.
     Physical  removal  and  addition of media within these media
     changers is performed by utilities supplied  by  GRAU,  IBM,
     and  Sony.  For  STK network-controlled media changers using
     ACSLS, this interface removes the  entry  from  the  catalog
     only  if  zero is specified for one_step value. Other values
     for one_step will cause the physical removal  of  media  and
     also remove the media from the catalog.

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_export() 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_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 shared memory seg-
                         ment  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_OPERATOR_NOT_PRIV
                         Operator does  not  have  permission  to
                         export 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_NOT_OCCUPIED
                         ea does not contain any removable media.

     ER_SLOT_OR_VSN_REQUIRED
                         Either ea or 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
                         vsn specified cannot  be  found  in  the
                         specified   robot  at  equipment  number
                         eq_number

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

SEE ALSO
     build_cat(1M), dump_cat(1M),  export(1M),  import(1M),  sam-
     robotsd(1M).

     sam_import(3).

     mcf(4).