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 lock_value - This value indicates whether the the routine
should prevent or allow media removal for the robot. The
include file <mrd_common.h> defines two constants PREVENT_
REMOVAL and ALLOW_REMOVAL that will set the correct value.
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.
This routine sends a SCSI Prevent-Allow Media Removal command.
Some robots have been observed to silently ignore the command,
others will fail with an illegal request and others will do
something particular to the robot. This command is not supported
on the DSA medium-changers (TA and TF drives). SCSI defines this
a single command where the value of a single bit determines the
affect.
On some versions of TL820 firmware, the command with PREVENT_
REMOVAL will disable Move Medium commands to the outport. Other
versions will also disable Move Medium commands from the inport.
Other models will ignore the command entirely. The TL810 family
of libraries use the command to disable the front panel button
which allows opening the port door. Please refer to your robot's
documentation to see what affect this command will have.