sam_audit(3)

NAME
     sam_audit - Audits media

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

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

     int   sam_audit(ushort_t   eq_number,   uint_t    ea,    int
     wait_response);

DESCRIPTION
     sam_audit() performs a catalog audit on either a single ele-
     ment  address  in  a robot or all the element addresses in a
     robot, for either optical or tape robotic devices.  Specify-
     ing  ea as the number of the robot element address will per-
     form a catalog audit of that element address.  If the ea  is
     set  to  the  global  ROBOT_NO_SLOT  value,  an audit of the
     entire robot will be performed. The call will return immedi-
     ately  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_audit() 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  master  shared
                         memory  segment  found.   Check that the
                         Sun QFS  or  SAM-QFS  file  systems  are
                         mounted.

     ER_NOT_VALID_SLOT_NUMBER
                         ea is not a valid element address in the
                         robot at equipment number eq_number

     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_OPERATOR_NOT_PRIV
                         Operator does  not  have  permission  to
                         perform a full audit

     ER_ROBOT_CATALOG_MISSING
                         The  robot  media  changer  catalog  for
                         equipment  number  eq_number  is missing
                         and a full audit is required.

     ER_SLOT_NOT_OCCUPIED
                         No media exists at the  element  address
                         number ea 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

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

     mcf(4).