Copyright Digital Equipment Corp. All rights reserved.

Parameters

   o  robot_name - The name of the robot device to be opened. On
      Digital UNIX, if the leading character of the name is not a
      slash (/), /dev/ will be prepended to the name.

   o  robot_info - This is the address of a robot_info_t structure
      initialized using mrd_startup(3mrd) or mrd_show(3mrd). This
      data structure contains the element starting address and
      counts for each type of element, which are needed to map an
      absolute element to the correct zero relative address and
      type.

   o  element_type - The type of robot element on which the
      operation takes place. If an element type of zero (0) is used,
      all elements will be searched starting at element 0 of each
      type and searching all the elements of that type on the robot.
      The order of this search is Slot, Drive, Transport and finally
      Ports.

   o  element_name - A string used to specify the name of the first
      element about which to obtain information. While SCSI devices
      use integer numbers for element addresses, DSA robots use
      character strings. This allows the same interface to be used
      for both types, where supported.

   o  element_count - A volume tag search in a large library
      can take a long time. Some applications (a graphic user
      interface for example) may want to break up a large search
      into smaller, quicker sub-searches. When a specific element_
      type is specified only a range specified by the element_name
      and element_count will be searched. This argument is ignored
      when the element_type is zero (0).

   o  element_info - The array of element_info_t structures that is
      filled in with information on the type and number of elements
      requested with element_type and element_count. The information
      includes volume tag (if available), state, port type (if PORT
      information is requested), status, and when available a copy
      of the Read Element Status data for the element.

   o  log_info - This is a character array that should be at least
      MRD_MAX_LOG_STRING in length. If this function fails as the
      result of a SCSI error, this will be filled with the formatted
      request sense data. If this function fails as the result
      of an operating system error, the operating system message
      particular to the error will be copied into the array.