HELPLIB.HLB  —  MRD Library, mrd_inject, Description
    The mrd_inject(3mrd) function is a specialized interface to the
    SCSI Move Medium command. For the robot specified by robot_name,
    the routine will attempt to move the cartridge in the specified
    port to the specified slot. Element addresses are zero based.

    The robot will be opened and the arguments to the function will
    be verified to make sure they are safe and appropriate. The port
    and slot address will be verified they are within the valid of
    those elements on the robot.

    The volume_tag argument can be used to perform cartridge volume
    tag verification before the move. If the cartridge volume tag at
    the port doesn't match that specified by this argument, then mrd_
    inject(3mrd) will fail with the status MRD_STATUS_CART_INVALID.
    If volume_tag argument is a NULL pointer, an empty string or
    used on a robot without vision support this argument is silently
    ignored and the volume tag check will not be made.

    The TL820 family requires special handling within the mrd_
    inject(3mrd) routine, because of the way the Input/Output Device
    (IOD) works. This routine will explicitly check the specified
    inport to see if it is full. If empty and the robot is a TL820,
    the Pass-through mechanism will then be checked. If the PTM is
    full the source address will be reset to the PTM. If both are
    empty, the routine will send a Ready Inport command to enable the
    IOD. A one minute polling loop will be performed waiting for the
    inport to become full, five seconds between polls. If this first
    loop fails, the Ready Inport will be sent again and the loop
    repeated. This allows the user two minutes to put a tape into the
    inport.

    If volume tag verification is desired on the TL820, the cartridge
    will be moved to the PTM so the volume tag can be read. If the
    check fails, the cartridge will left on the PTM. If the mrd_
    inject(3mrd) is repeated with the correct volume tag or without
    one, the cartridge will be found on the PTM and the Move Medium
    command will proceed from there.
Close Help