sam_import(3)

NAME
     sam_import - Imports media to the  removable  media  robotic
     device

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

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

     int   sam_import(ushort_t   eq_number,   char   *vsn,   char
     *media_nm, int audit_eod, int wait_response);

DESCRIPTION
     sam_import() requests the robotic media  changer  to  import
     the  selected  media into the robot.  The media is placed in
     the first available element address  of  the  catalog.   For
     GRAU,  STK,  or  IBM  libraries,  the vsn must be specified.
     Physical import of media within the GRAU and  STK  are  per-
     formed by utilites supplied by the vendor.  Both the vsn and
     the media_nm need to be specified to import  into  the  His-
     torian.

     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_import() fails if one or more of the following are true:

     ER_AUDIT_EOD_NOT_HISTORIAN
                         A non-zero audit_eod flag, requesting an
                         audit  to  end-of-data, cannot be speci-
                         fied for the Historian.

     ER_DEVICE_NOT_READY The specified eq_number  device  is  not
                         ready.

     ER_FIFO_PATH_LENGTH The path and filename for the FIFO  pipe
                         is too long.

     ER_HISTORIAN_MEDIA_ONLY
                         media_nm can only be specified  for  the
                         Historian.

     ER_INVALID_MEDIA_TYPE
                         The specified media_nm is  not  a  valid

                         media type.

     ER_MEDIA_FOR_HISTORIAN
                         The  type  of  media  media_nm  must  be
                         specified for the Historian.

     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_RESPONSE_FIFO Unable to create the response FIFO pipe.

     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_OPERATOR_NOT_PRIV
                         Operator does  not  have  permission  to
                         import removable media.

     ER_ROBOT_DEVICE_REQUIRED
                         Equipment  number   eq_number   is   not
                         defined as a robotic device.

     ER_VSN_BARCODE_REQUIRED
                         vsn must be specified for the GRAU, STK,
                         and  IBM  media  changers  and  the His-
                         torian.

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

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

     sam_export(3).

     mcf(4).