VMS Help  —  MRD Library, mrd_find_cartridge, 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  volume_tag- A NULL terminated character string that is the
       volume tag to search for.

    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_start- A NULL terminated character string that is the
       zero relative address of the element where the search should
       be started. This argument is not used when the element_type is
       zero (0).

    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  result_param- If an element matching the volume_tag string is
       found, the element_info_t will copied into the space pointed
       to by result.

    o  result_name- The zero relative element address of the matching
       element will be copied into the space pointed to by result_
       name. This space should be a character array of size MRD_NAME_
       SIZE.

    o  result_type- The element type of the matching element will be
       copied into the space pointed to by result_type.

    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.
Close Help