Compaq Media Robot Utility, Version 1.4 Guide to Installation, Connectivity, and Operation Media Robots and MRU Software 3 What Is a Media Robot? 3 Mechanical Attributes of a Media Robot 3 What Is Media Robot Utility Software? 3 MRU Software Variants 4 MRU Command Line Interface 4 MRU Graphic User Interface 4 Connecting the Media Robot Hardware 5 Device Naming for Windows NT 5 Finding SCSI Coordinates for a Connected Media Robot 5 MRU Software Installation 6 MRU Distribution Medium 6 Installing MRU Software 6 The Windows NT Operating Environment 7 Case Sensitive Searches 8 Verifying a MUSL Configuration 8 Media Robot Utility Software for Digital UNIX 8 Supporting Software Version Compatibility 9 Connecting the Media Robot Hardware 9 Hardware Connection Restrictions 9 Creating Special Device Files for Digital UNIX Systems 10 Special Device Files for DLT and DAT Media Loaders 10 Constructing a Device Name for a Desktop TZ Loader 11 MRU Software Installation 12 Installing the Software 12 Verifying the Installation 13 Internationalization 13 Using the Media Robot Utility Manual Pages 13 The Digital UNIX Operating Environment 14 Required Authorization 14 Logging Robot Operations 14 Accessing the MRU Graphic User Interface 16 Verifying a MUSL Configuration 17 Media Robot Utility Software for OpenVMS 18 Supporting Software Version Compatibility 18 Connecting the Media Robot Hardware 18 Direct Connect SCSI Devices 18 Connecting DLT and DAT Media Loaders 18 Connecting TL8nn Automated Libraries 19 Creating a Tape Robot Unit 20 Connecting Through an HSxnn Controller 20 MRU Software Installation 21 MRU Distribution Medium 21 Required Process Privileges 22 Logging Robot Operations 23 The MRU Interfaces 25 Accessing the MRU Graphic User Interface 25 Verifying a MUSL Configuration 26 Media Robot Utility Command Reference 27 Command Parameters 27 Commands for Operating a Media Robot 27 Media Robots and MRU Software This section defines the terms media robot and describes the purpose of Media Robot Utility (MRU) software. What Is a Media Robot? A media robot is an enclosure that houses one or more tape drives and multiple slots for storing cartridges, and a mechanical transport for moving cartridges between locations in the enclosure. Another term for media robot is medium changer. Mechanical Attributes of a Media Robot SCSI robotic medium changers present four different objects to host systems; the transport, slots, drives, and ports. These are collectively called "elements" by the SCSI-2 specification. Transport- This is the robot used to move tapes or optical cartridges (media). The SCSI term for the transport is "Medium Transport Element." Most media changer subsystems only have one robot, but there can be more. Slot- This is the place that a medium is stored. For the robot subsystems supported by the Media Robot Utility, the number of slots ranges from 4 to 1320. The SCSI term for a slot is "Storage Element." Drive- This is the tape or optical drive. The robot has very little control over its drives and is often at a different SCSI address. Robot subsystems have at least one drive, but the DLT libraries, for example, have more than one. The SCSI term for a drive is "Data Transfer Element." Ports- Some media robots have slots for storing many cartridges. Such robots also have ports which are used to place cartridges into the robot, or remove them from the robot. Media loaders have no ports. Media libraries can have one or more ports; on the TL810 automated tape library system, a port is both to add media to a robot and remove, and on the TL820 automated tape library system, separate ports are used for importing and exporting cartridges. The SCSI terms for port are "Import Export Element," "Import Element," and "Export Element" depending on the function of the port. What Is Media Robot Utility Software? The Media Robot Utility (MRU) is a multiplatform utility for controlling robotic medium changers. MRU allows users to control operations at a very low level: injecting and ejecting cartridges, loading and unloading cartridges, and showing status and media robot attributes. 3 -----------------------------Note----------------------------------------- Use MRU in a managed media environment with care. MRU provides no media management or cataloging capability. Manipulating cartridges with MRU alone could create inconsistency between the media management system's view and the physical status of the robot and cartridges. MRU Software Variants MRU software runs on computers under Microsoft Windows NT, Digital UNIX, and OpenVMS. All of these systems are capable of communicating with media robots. On each system, MRU offers both a command line operating environment and a graphic user environment. Each interface environment offers access to the software and to online information. MRU Command Line Interface The command line interface allows users with character cell terminals to access MRU. The MRU command line interface uses a common syntax across all three platforms. Case sensitivity, however, is an issue on Digital UNIX systems, as is the rule with all UNIX systems. Online help is available for character cell terminal users. See the operating system specific information for instructions on how to access the online information. MRU Graphic User Interface The graphic user interface provides allows users with Motif, the Common Desktop Environment (CDE) or Windows NT systems to access MRU. The MRU graphic user interface provides a similar look and feel across all platforms. Although there are some minor differences, they all offer similar features. Online help is available through the Help pull down menu as well as through context sensitive help. See the operating system specific information for instructions on how to access online help. 4 Media Robot Utility Software for Microsoft Windows NT This chapter describes the Microsoft Windows NT variant of Media Robot Utility software. It explains some important aspects of hardware installation, establishing the operating system connection, installing the MRU software, and the MRU operating environment. MRU software for Windows NT runs under Windows NT, Version 4.0 for Intel and Alpha hardware platforms. ------------------------------Note---------------------------------------- MRU software will not work concurrently with a third party medium changer driver installed on a Windows NT workstation. -------------------------------------------------------------------------- Connecting the Media Robot Hardware Refer to the documentation that comes with your media robot hardware for information about connecting to the computer system. When you configure the hardware for installation, you select the SCSI coordinates (the SCSI bus, target ID, and LUN). Make a note of the SCSI coordinates as you set them on the hardware. ------------------------------Note---------------------------------------- If the media robot has a hardware setting to enable or disable automatic inventory on startup, MAKE SURE this option is enabled. If the automatic inventory on startup option is disabled, MRU may not work. --------------------------------------------------------------------------- Device Naming for Windows NT MRU uses special routines for communicating with the changer in a media robot. These routines use the pass-through SCSI driver built into the Windows NT system. MRU derives the name of the medium changer device (not the tape device) from its SCSI port, bus, target and LUN. This name lets you know which device you control with MRU. For instance, a medium changer connected to SCSI port 3, bus 0, target ID 2, LUN 1 would be named by MRU software as Scsi3:B0T2L1. Finding SCSI Coordinates for a Connected Media Robot If your system is already connected to media robot, you can find the SCSI coordinates through Windows NT Control Panel. Write down the target ID, LUN, SCSI Port, and bus numbers and apply them to the convention described above to relate the MRU device name to the media robot. 5 Use the "SCSI Adapters" control panel to help identify the port, bus, target, and lun numbers. On the "Devices" tab, expand the host adapter entry to show its devices. Highlight the medium changer, and click on the "Properties" button. The pop-up window has a "Settings" tab which displays the TargetID: Firmware revision: Logical unit number: SCSI Adapter Name: SCSI Port: Bus number: MRU Software Installation This section describes the installation prerequisite tasks and information, the installation procedure, and some follow up information. MRU Distribution Medium The distribution CDROM contains the Windows NT Media Robot Utility software in the ISO 9660 format. Installing MRU Software By default, the MRU installation procedure creates its own subdirectory under the system drive and places the software and help files into it. For example, if your system drive is C, the MRU installation creates the subdirectory C:\Program Files\MRU You have the option of placing the files into a different directory during installation. Follow these steps to install MRU software: Insert the CDROM into the drive, or onto a shared device accessible by the system. Use Explorer to locate the WINNT subdirectory. From the WINNT subdirectory, open the directory that corresponds to your processor type. For Intel based systems, use the Intel subdirectory. For Alpha based systems, use the Alpha subdirectory. Execute the SETUP.EXE file. 6 Verifying Installation Use the following procedure to verify the MRU installation: Change directory to the MRU installation directory. Execute the xrobot.exe file. Verify that your media robots are displayed in the startup window. If you have no media robots available, take these steps: Verify and note the SCSI setting on the hardware. Verify and note the SCSI device information using the Control Panel. Correlate the device information. The Windows NT Operating Environment Before you use the MRU software, you should get to know the logging features and learn how to select a media robot for operation. Logging Robot Operations MRU software allows you to capture results of robot operations in a log file. To do so, set the MRU_LOG environment variable. set MRU_LOG=logfile Where logfile is the full path and file name of the file in which you want to audit activities. Remove this environment variable if no log file is desired. You can control the amount of information captured. By default, MRU software supplies brief information. For more information, you can enable the verbose option with the MRU_VERBOSE environment variable. set MRU_VERBOSE=1 Remove this environment variable to disable this feature. Refer to the media robot hardware information to interpret SCSI sense data returned when this option is enabled. Default Robot By defining a default robot, you do not have to supply a robot name parameter with MRU commands you execute. This is especially useful in the command line and batch file environment. The default robot is the implicit target for any command which does not include the ROBOT robot_name parameter. 7 set MRU_ROBOT=SCSIp:BbTtLl Where: p is the port number b is the bus number t is the target ID l is the LUN For instance, the default robot parameter for a medium changer connected to SCSI port 3, bus 0, target ID 2, LUN 1 would be named by MRU software as Scsi3:B0T2L1 Case Sensitive Searches The FIND command default search behavior matches cartridge labels without case sensitivity. If you need a case sensitive search, then use the MRU_CASE_SENSITIVE environment variable. set MRU_CASE_SENSITIVE=1 This environment variable also affects the behavior of the graphic user interface find feature. Verifying a MUSL Configuration You can use MRU to verify a successful Multi-Unit, Single LUN (MUSL) configuration. Use the SHOW ROBOT command to get information about the configuration: robot show robot Scsi2:B0T2L2 Robot Name : Scsi2:B0T2L2 Type: SCSI Media Robot Identifier: DEC TL820 (C) DEC2A5A Slots: 176 Drives: 6 Inports: 1 Outports: 1 Transports: 2 MUSL control is available on firmware 2A5A or higher. This information appears on the Media Robot Identifier line of the SHOW ROBOT output. When MUSL is activated, the combined hardware units respond to a single medium changer unit. MRU shows this with a Transport count greater than 1. Media Robot Utility Software for Digital UNIX This chapter describes the variant of Media Robot Utility software for Digital UNIX. It explains some important aspects of hardware installation, establishing the operating system connection, installing the MRU software, and the MRU operating environment. 8 Supporting Software Version Compatibility The MRU command line interface runs under Digital UNIX Version 4.0D through 4.0F systems, and the graphic user interface runs under Digital UNIX Version 4.0D through 4.0F systems and requires Motif Version 1.2.3 or later. ---------------------------Note------------------------------------------------ Use the correct version of the CLC driver with MRU. Using the incorrect version can cause a system crash. Starting with Version 4.0D of Digital UNIX, install the CLC driver from the Associated Products CDROM distributed with Digital UNIX. Do not use the CLC driver distributed with the MRU software. -------------------------------------------------------------------------------- The following table identifies the required versions of the SCSI CLC. Digital UNIX Versions and Required CLC Versions Digital UNIX Version SCSI CLC Version ------------------------------------------------ Version 4.0 or higher CLC Version 3.1C Connecting the Media Robot Hardware Refer to the documentation that comes with your media robot hardware for information about connecting to the computer system. This section includes information about creating special device files for the media robot changers. If the media robot has a hardware setting to enable or disable automatic inventory on startup, MAKE SURE this option is enabled. If the automatic inventory on startup option is disabled, MRU may not work. Hardware Connection Restrictions You cannot connect a TL820 changer on the AHA1740 EISA adapter. A workaround for this situation would be to connect the changer to a different SCSI adapter and leave the drive connected to the AHA1740 EISA adapter. You cannot connect a TL82n robotic library running firmware below the 1G revision to the KFTIA adapter. If you have a TL82n robotic library running a firmware below the 1G revision, contact your Digital service representative for information on the firmware upgrade. 9 Creating Special Device Files for Digital UNIX Systems MRU software supports only locally connected medium changers. Before you can use the Media Robot Utility software on a Digital UNIX system, you must create special device files for the medium changers. This is not the same as creating special device files for tape drives. There are two types of medium changers to consider: The TL8nn automated tape libraries require you to create a device file for the medium changer that is separate from the drives. The TLZ6L, TLZ7L, and TZ8nn SCSI loaders require you to create a device file for the medium changer that is a logical unit of the loader. Each of these types of robots imposes special rules for naming the robot (changer) device name. The MRU software uses the robot device name as the target for MRU commands. Some restrictions apply to the kinds of connections you can between a robot and a host system. Determine the device name for the media changer, then use the name in the command to create the special device file. For more information, see the mc(7) manual page. Special Device Files for DLT and DAT Media Loaders ------------------------------Note---------------------------------------- This information applies to the TLZnx and TZ8nn classes of DLT and DAT media loaders. -------------------------------------------------------------------------- Tape loaders of the DLT and DAT variety treat their robotic devices and tape devices as logical units of the device target ID. The are four parts to the naming convention with this type of medium changer: Determine the target ID for a drive in the loader: # scu show edt bus num Where: num is the number of the bus on which the loader is connected. Multiply the SCSI bus number by 8 and add the value of the target ID, Then append a letter corresponding with the logical unit number. The correspondence for letter to logical unit number starts with b corresponding to logical unit number 1, c corresponding with logical unit number 2, and so on. Create the device name by concatenating mc with the number and letter derived in the previous step. Use the device name to create the special device file for the media changer. 10 The following example shows how to construct a device name for a desktop TZ media changer. The media changer is on bus 2, target ID of 5, logical unit 1. Constructing a Device Name for a Desktop TZ Loader # /sbin/scu show edt bus 2 Bus: 2, Target: 5, Lun: 0, Device Type: Sequential Access Bus: 2, Target: 5, Lun: 1, Device Type: Changer Bus: 2, Target: 5, Lun: 2, Device Type: (not present) Bus: 2, Target: 5, Lun: 3, Device Type: (not present) Bus: 2, Target: 5, Lun: 4, Device Type: (not present) The name of the device for the media changer would be calculated by multiplying 2 by 8 and adding 5, and concatenating the letter b, providing a name of mc21b. The commands for creating the special device would be: # cd /dev ;./MAKEDEV.MC mc21b Special Device Files for TL8nn Automated Tape Libraries ------------------------------Note---------------------------------------- This information applies to the TL81n, TL82n, TL89n classes of libraries. -------------------------------------------------------------------------- To determine the device name for the media changer in a TL8nn automated tape library, use the following procedure: Determine the target ID for a drive in the robot: # scu show edt bus num Where: num is the number of the bus on which the loader is connected. Multiply the SCSI bus number by 8 and add the value of the target ID of the changer. Create the device name by concatenating mc with the number derived in the previous step. Use the device name to create the special device file for the media changer. The following example shows how to construct a device name for a TL810 media changer with two drives. The media changer is on bus 4, target ID of 0, logical unit 0. How to Construct a Device Name for a TL895 Medium Changer # /sbin/scu show edt bus 4 Bus: 4, Target: 0, Lun: 0, Device Type: Changer Bus: 4, Target: 1, Lun: 0, Device Type: Sequential Access Bus: 4, Target: 2, Lun: 0, Device Type: Sequential Access Bus: 4, Target: 3, Lun: 0, Device Type: Sequential Access 11 The name of the device for the media changer would be calculated by multiplying 4 by 8 and adding 0, providing a name of mc32. The commands for creating the special device would be: # cd /dev ; ./MAKEDEV.MC mc32 When installing a TL8nn medium changer system, you need to keep track of the device file names for the drives serviced by the particular robotic transport device. MRU software cannot unload a cartridge from a drive in a TL8nn medium changer system without first taking the drive offline. MRU software has no way of associating the drives with the robotic transport device. You must supply the device file name before unloading a cartridge. MRU Software Installation The distribution CDROM contains the Digital UNIX Media Robot Utility software in the ISO 9660 format. Installing the Software This procedure explains how to install the Digital UNIX MRU software for CDROM systems with and without Rock Ridge Interchange Protocol (RRIP) extensions to the ISO 9660 format. If your system supports RRIP Extensions Log in as a superuser. Use the command for device rz4c at mount point /mnt/CDROM as follows: # mount -r -t cdfs -o noversion,rrip /dev/rz4c /mnt/CDROM Invoke setld with the following option and the kit location name: # setld -l /mnt/CDROM/unix/robot140/kit If your system does not support RRIP Extensions Log in as a superuser. You must first mount the CDROM, then copy the files from the CDROM to your system. The mount command for device rz4c at mount point /mnt /CDROM would be: # mount -r -t cdfs -o noversion /dev/rz4c /mnt/CDROM Copy the kit to /var/tmp. Of the following two commands, use the first to go to the /var/tmp directory and the next to copy the files from the CDROM: # cd /var/tmp # tar xvf /mnt/CDROM/unix/robot140.tar 12 Invoke setld with the following option and the kit location name: # setld -l /var/tmp/robot140/kit After Step 3 - common to all systems Select subset options from the displayed list. You have two options for the graphic user interface, Motif and CDE. You can select either or both subsets. Confirm the selected subset options. Select to build a kernel file when prompted. Decline the option to edit the configuration file. After installation, delete the /tmp/ROBOT.Legal.Notice file. Verifying the Installation Use the following procedure to verify the MRU installation: Invoke setld with the following option and subset name: # setld -v ROBOTBASE140 Select the robot on which you want to verify the installation. Internationalization A UNIX friendly, American English message catalog is included with the Media Robot Utility kit. The default messages contain examples that are more appropriate to OpenVMS systems. To use this alternate message catalog, set the LANG environment variable to en_US.ISO8859-1: # setenv LANG en_US.ISO8859-1 Using the Media Robot Utility Manual Pages The Media Robot Utility software manual pages require the installation of the Admin/User Reference Pages (OSFMANOS) or the Windows Admin/Users Reference Pages (OSFMANWOS). These two subsets require the installation of the Document Preparation Tools (OSFDCMT) subset. The OSFMANOS and OSFMANWOS subsets are not automatically installed as a result of installing OSFDCMT. Before you can use the robot.8 and xrobot.1X manual pages, you must have installed OSFDCMT and either OSFMANOS or OSFMANWOS subsets. 13 The Digital UNIX Operating Environment Before you use the MRU software, you need to know the required privilege level to execute the software. You should also understand the logging features, and understand the implicit and explicit selection of a media robot for any operation. Required Authorization To use MRU software, you must have read access to the special device files for the robots you want to operate. For more information on special device files for MRU software, refer to the section entitled Creating Special Device Files for Digital UNIX Systems. Logging Robot Operations MRU software allows you to capture results of robot operations in a log file. To do so, set the MRU_LOG environment variable in the process running MRU software. These commands create a log file named logfile in the current default directory for the shell indicated. C-Shell: # setenv MRU_LOG logfile Bourne Shell: # MRU_LOG=logfile ; export MRU_LOG Remove this environment variable if no log file is desired. You can control the amount of information captured. By default, MRU software supplies brief information. For more information, you can enable the verbose option with the MRU_VERBOSE environment variable. These commands enable verbose logging. C-Shell: # setenv MRU_VERBOSE Bourne Shell: # MRU_VERBOSE= ; export MRU_VERBOSE Remove this environment variable to disable this feature. Refer to the media robot hardware information to interpret SCSI sense data returned when this option is enabled. 14 Default Robot By defining a default robot, you do not have to supply a robot name parameter with MRU commands you execute. The default robot is the implicit target for any command which does not include the ROBOT robot_name parameter. These commands set the default robot to /dev/mc32. C-Shell: # setenv MRU_ROBOT /dev/mc32 Bourne Shell: # MRU_ROBOT=/dev/mc32 ; export MRU_ROBOT You can override the default robot by explicitly including the ROBOT robot_name parameter in an MRU command. Remove this environment variable if no default robot is needed. Case Sensitive Searches The find command default search behavior matches cartridge labels without case sensitivity. If you need a case sensitive search, then use the MRU_CASE_SENSITIVE environment variable. C-Shell: # setenv MRU_CASE_SENSITIVE Bourne Shell: # MRU_CASE_SENSITIVE= ; export MRU_CASE_SENSITIVE This environment variable also affects the behavior of the graphic user interface find feature. Exit Status Starting with this version, MRU returns operating system specific status messages to programs written against the application programming interface. If you want to continue using scripts and programs written against previous versions of MRU, then use the MRU_OLD_ STATUS environment variable. C-Shell: # setenv MRU_OLD_STATUS 16 Bourne Shell: # MRU_OLD_STATUS= ; export MRU_OLD_STATUS With this logical defined, exit status reports either success or failure. The MRU Interfaces MRU software includes two interfaces. The MRU command line interface allows for direct interaction with the MRU software, and for the development of scripts for programmed operations. A manual page file contains information about MRU software for Digital UNIX systems. You can access the information in the manual page with this command: # man robot Accessing the MRU Graphic User Interface The graphic user interface runs under Digital UNIX Version 3.0 and later, and Motif Version 1.2.3. This interface provides a simple way to operate a library or loader. By default, the graphic user interface scans the system to provide access to all connected robots. To start the graphic user interface, enter: # xrobot To use the graphic user interface to access particular robots, specify the robot special device files in a list following the xrobot command. The following command example shows this feature: # xrobot /dev/mc32 /dev/mc48 /dev/mc19b The system view window shows all libraries and loaders connected to the system. Select the library or loader you want from the system view window by placing the pointer on the robot icon and double clicking MB1. The robot dialog represents the selected library or loader. Use it to conduct operations with the robot, and set robot- specific customizations. Move cartridges by either drag and drop operation with MB1, or use point and click operations on cartridge source and destination locations. Cartridges can be moved from any location to any other location as allowed by the media robot hardware (except for the explicit dismount/offline operation required by drives in the TL8nn automated tape libraries). The online help provides detailed information on using the graphic user interface and, operating your media robot. 16 Verifying a MUSL Configuration You can use MRU to verify a successful Multi-Unit, Single LUN (MUSL) configuration. Use the SHOW ROBOT command to get information about the configuration: robot show robot mc48 Robot Name : mc48 Type: SCSI Media Robot Identifier: DEC TL820 (C) DEC2A5A Slots: 176 Drives: 6 Inports: 1 Outports: 1 Transports: 2 MUSL control is available on firmware 2A5A or higher. This information appears on the Media Robot Identifier line of the SHOW ROBOT output. When MUSL is activated, the combined hardware units respond to a single medium changer unit. MRU shows this with a Transport count greater than 1. 17 Media Robot Utility Software for OpenVMS This chapter describes the Media Robot Utility software variant for the OpenVMS system. It explains some important aspects of hardware installation, establishing the operating system connection, installing the MRU software, and the MRU operating environment. Supporting Software Version Compatibility The MRU command line interface runs under OpenVMS VAX and OpenVMS Alpha Version 6.2, 7.1, 7.2 and 7.2-1 systems. The graphic user interface runs under OpenVMS VAX and OpenVMS Alpha Version 6.2, 7.1 systems and requires Motif Version 1.2.3. Under OpenVMS VAX and OpenVMS Alpha Versions 7.2 and 7.2-1 the graphic user interface requires Motif Version 1.2.5. Connecting the Media Robot Hardware Refer to the documentation that comes with your media robot hardware for information about connecting to the computer system. ------------------------------Note---------------------------------------- If the media robot has a hardware setting to enable or disable automatic inventory on startup, MAKE SURE this option is enabled. If the automatic inventory on startup option is disabled, MRU may not work. -------------------------------------------------------------------------- Direct Connect SCSI Devices A SCSI device that is directly connected to a VAX or Alpha system uses the GKDRIVER software to control the movement of the robotics. (The tape devices use tape device drivers.) The GKDRIVER is a standard OpenVMS device driver and does not require a separate installation. However, you must first create a tape robot unit to use the robotic features on tape jukeboxes directly connected through a SCSI bus. The tape robot unit is named such that it describes the physical SCSI connection. There are two categories of medium changers to consider, and each uses a different naming convention for its drive and changer devices because of the manner in which it is configured and physically connected to the SCSI bus. Keep these conventions in mind as you configure your systems, especially for creating tape robotic units. Connecting DLT and DAT Media Loaders ------------------------------Note---------------------------------------- This information applies to the TLZnx and TZ8nn classes of DLT and DAT media loaders. -------------------------------------------------------------------------- DLT and DAT tape loaders treat their robotic devices and tape devices as logical units of the device target ID. The are four parts to the naming convention with this type of robotic loader: 18 The name begins with a prefix of MK for the tape device and GK for the robotic device. The prefix is followed by a letter indicating the physical SCSI bus to which the device is connected to the host system. For devices connected to the first bus detected at boot time, the letter is A, for the second bus detected, B, and so on. The next part is a number corresponding to the SCSI target ID. The last part is a two-digit number corresponding to the SCSI target ID logical unit number. Because tape drives in a DLT or DAT loader are always at logical unit 0, the last two digits are 00. The last two digits for the robotic device are 01. MKA400 is the name of a tape device connected to the first SCSI bus seen at boot time, at target ID 4. GKA401 is the name of the robotic device and the name of the robotic unit corresponding to the tape device MKA400. Connecting TL8nn Automated Libraries ------------------------------Note---------------------------------------- This information applies to the TL81n, TL82n, TL89n classes of libraries. -------------------------------------------------------------------------- With TL8nn tape libraries, the drives and robot units are separate. There are three parts to the naming convention for a TL8nn tape library: The name begins with a prefix of MK for the tape device and GK for the robotic device. The prefix is followed by a letter indicating the physical SCSI bus to which the device is connected to the host system. For devices connected to the first bus detected at boot time, the letter is A, for the second bus detected, B, and so on. The next part is a number corresponding to the SCSI target ID. For example, for a TL810 library system with the robotic unit connected to the second bus detected at boot time at target ID 5, the name would be GKB500. When installing a TL8nn medium changer system, you need to keep track of the device names for the drives serviced by the particular robotic transport device. MRU software cannot unload a cartridge from a drive in a TL8nn medium changer system without the OpenVMS system first dismounting the cartridge. MRU software has no way of associating the drives with the robotic transport device. You must correlate the device and device name before unloading a cartridge. 19 Creating a Tape Robot Unit Use the following procedure to create a tape robot unit: For SCSI magazine loaders connected directly to a SCSI bus, enter the SYSGEN or SYSMAN command in the appropriate format: VAX system: $ MCR SYSGEN CONNECT GKannn:/DRIVER=GKDRIVER/NOADAPTER Alpha system: $ MCR SYSMAN IO CONNECT GKannn:/DRIVER=SYS$GKDRIVER - $_ /NOADAPTER Where: GKannn: is the robot device name. With media loaders, the robot device name is always the same as the tape drive name incremented by one, and without any prefixes (allocation class or NODE$ prefix) to the GK string. For example, a tape drive name of $1$MKA200: could use a robot device name of GKA201:. COMPAQ recommends that you include the SYSGEN commands in your system startup command procedure. Connecting Through an HSxnn Controller When connecting a media robot to an HSJnn or HSDnn controller, you must associate the loader name with an internal passthrough name. After installing the media robot hardware, and connecting the cables between host, controller, and media robot, you can make the association at the controller console terminal. Add the loader to the controller by identifying the loader name and SCSI port, target ID, and LUN CLI> ADD LOADER loader_name port target lun Add the passthrough name to the controller, relating it to the loader name. CLI> ADD PASSTHROUGH pass_name loader_name Add the unit name, relating it to the passthrough name. CLI> ADD UNIT unit_name pass_name This example shows the commands for connecting a TL810 Automated Tape Library system loader. The SCSI Port is 5, Target ID is 4, and LUN is 0. CLI> ADD LOADER TL810A 5 4 0 CLI> ADD PASSTHROUGH P810A TL810A CLI> ADD UNIT D810 P810A 20 After establishing this connection, the OpenVMS system will show the device DUA810 with its allocation class. The MRU ROBOT name will be the OpenVMS allocation class name $1$DUA810. MRU Software Installation This section describes the installation prerequisite tasks and information, the installation procedure, and some follow up information. MRU Distribution Medium The distribution CDROM contains the OpenVMS Media Robot Utility software in the Files11 format. Preparing to Install MRU Software Use the following procedure for preinstallation: Login to the SYSTEM account. Enable all privileges. Verify that the current system disk backup copy is appropriate. Load and mount the media that contains the software kit. Installing the Software Use the following procedure to install the software: Invoke the VMSINSTAL procedure using the following form, where location is the name of the device and directory in which the kit is located: $ @SYS$UPDATE:VMSINSTAL ROBOT014 location: Where: location: is the name of the device from which you are installing the kit. Confirm the state of the system disk. Select no additional options. Purge previous MRU files. If you are upgrading MRU At this point, you are likely to get a message from the VMSINSTAL procedure about version sequencing. If you receive this message, select to replace the image that is currently installed. 21 This message is an artifact of a naming change for the underlying image. Run the Installation Verification Procedure (IVP). Verifying the Installation The IVP searches the system for connected libraries and loaders and any it finds are presented to you for selection. If the IVP finds none, the installation finishes, but the IVP fails. In this case, you must install the hardware and/or appropriate drivers and execute the IVP. Use this command line to execute the IVP: $ @SYS$COMMON:[SYSTEST]ROBOT$IVP.COM Updating the OpenVMS DCL Tables If you installed MRU on a VMScluster system, users will have to log out and log in again to use MRU. This is due to the automatic update of the DCLTABLES performed during MRU software installation. The OpenVMS Operating Environment Before you use the MRU software, you need to know the required privileges to execute the software. You should also understand the logging features, and understand how to select a media robot for operation. ------------------------------Note---------------------------------------- Define logical names only within the context of a user process if you use any DIGITAL Storage Management Software product that includes the Media and Device Management Services (MDMS) software. If you use MDMS software and define any of these logicals so they are set for any MDMS process (i.e. any group or system logical table accessible by MDMS, you could cause failures in MDMS operations. --------------------------------------------------------------------------- Required Process Privileges Privileges required to operate MRU software depend on the robot connection to the host. See Required Process Privileges lists the privileges required for each of three different kinds of connections. Required Process Privileges Required PrivilegeDirect Connect SCSI HSJ Controller Connect SYSPRV X PHY_IO X X DIAG X X 22 Logging Robot Operations MRU software allows you to capture results of robot operations in a log file. To do so, define the MRU_LOG logical in the process running MRU software. This command creates a log file named file_name in the current default directory: $ DEFINE MRU_LOG file_name Deassign this logical if no log file is desired. You can control the amount of information captured. By default, MRU software supplies brief information. For more information, you can enable the verbose option with the MRU_VERBOSE logical. This command enables verbose logging: $ DEFINE MRU_VERBOSE 1 Deassign this logical to disable this feature. Refer to the media robot hardware information to interpret SCSI sense data returned when this option is enabled. Default Robot By defining a default robot, you do not have to supply a robot name parameter with MRU commands you execute. The default robot is the implicit target for any command that does not include the robot_name parameter. This command sets the default robot to robot_name: $ DEFINE MRU_ROBOT robot_name You can override the default robot by explicitly including the ROBOT robot_name parameter in an MRU command. Deassign this logical if no default robot is needed. Case Sensitive Searches The FIND command default search behavior matches cartridge labels without case sensitivity. If you need a case sensitive search, then use the MRU_CASE_SENSITIVE logical. $ DEFINE MRU_CASE_SENSITIVE 1 This environment LOGICAL also affects the behavior of the graphic user interface find feature. 23 Exit Status Starting with this version, MRU returns operating system specific status messages to programs written against the application programming interface. If you want to continue using scripts and programs written against previous versions of MRU, then use the MRU_OLD_STATUS logical. $ DEFINE MRU_OLD_STATUS 1 With this logical defined, exit status reports either success or failure. Using the Inport on TL820 Class Libraries The MRU_READY_DELAY logical defines the amount of time you will take to place a cartridge into a TL820 class ATL inport and close the inport door, after you issue the READY command. If you fail to close the inport door within the specified time, MRU may report an error on subsequent commands. The default value is 65 seconds. This logical definition sets the time to two minutes. $DEFINE MRU_READY_DELAY 120 Waiting for the Robot If you issue a command to a media robot while it is performing an ongoing operation, the MRU software waits until the ongoing operation completes before attempting the execute the command. By default, the MRU software waits up to approximately 18 hours for the operation to finish before failing the command. If you, or a scripted procedure, cannot tolerate a long delay, you can specify number of seconds delay you can tolerate with the MRU_WAIT logical. This command sets the longest wait period to two minutes: $ DEFINE MRU_WAIT 120 Another feature of MRU software controls the amount of time it waits after an unload operation is initiated on a DLT media robot. It can take up to about three minutes for a tape to rewind in response to an unload request. By default, MRU software will attempt to perform an unload up to 180 times, until the unload is successful. You can change this by specifying an unload retry value with the MRU_UNLOAD_DELAY logical. The amount of time taken to retry a single unload operation can take from one to approximately seven seconds depending on the particular media robot. This command sets the number of unload retries to 10: $ DEFINE MRU_UNLOAD_DELAY 10 24 The MRU Interfaces MRU software includes two interfaces. The MRU command line interface allows for direct interaction with the MRU software, and for the development of scripts for programmed operations. A help file contains information about MRU software for OpenVMS systems. You can access the information in the help file with this command: $ HELP ROBOT Accessing the MRU Graphic User Interface The MRU system now includes a graphic user interface. The graphic user interface runs under OpenVMS Alpha and OpenVMS VAX, Version 6.2, 7.1, 7.2 and 7.2-1 and Motif Version 1.2.3. This interface provides a simple way to operate a library or loader. By default, the graphic user interface scans the system to provide access to all connected robots. To start the graphic user interface, enter: $ XROBOT To use the graphic user interface to access particular robots, specify the robot devices in a list following the XROBOT command. The following command example shows this feature: $ XROBOT $1$DUA812: GKA2: $1$MIA4: The system view window shows all libraries and loaders connected to the system. Select the library or loader you want from the system view window by placing the pointer on the robot icon and double clicking MB1. The robot dialog represents the selected library or loader. Use it to conduct operations with the robot, and set robot- specific customizations. Move cartridges by either drag and drop operation with MB1, or use point and click operations on cartridge source and destination locations. Cartridges can be moved from any location to any other location as allowed by the media robot hardware (except for the explicit dismount/offline operation required by drives in the TL8nn automated tape libraries). The online help provides detailed information on using the graphic user interface and, operating your media robot. 25 Verifying a MUSL Configuration You can use MRU to verify a successful Multi-Unit, Single LUN (MUSL) configuration. Use the SHOW ROBOT command to get information about the configuration: $ROBOT SHOW ROBOT $1$DUA560: Robot Name : $1$DUA560: Type: SCSI Media Robot Identifier: DEC TL820 (C) DEC2A5A Slots: 176 Drives: 6 Inports: 1 Outports: 1 Transports: 2 MUSL control is available on firmware 2A5A or higher. This information appears on the Media Robot Identifier line of the SHOW ROBOT output. When MUSL is activated, the combined hardware units respond to a single medium changer unit. MRU shows this with a Transport count greater than 1. 26 Media Robot Utility Command Reference All the MRU command listed are subcommands of the robot command under Digital UNIX systems, and the ROBOT command under OpenVMS systems. Command Parameters MRU software uses these common parameters in its commands: slot_number - An integer value indicating a physical slot in the media robot. drive_number - An integer value indicating a physical drive in the media robot. port_number - An integer value indicating a physical port in the media robot. robot_name - The system name for the media robot accessed. MRU software will use the default robot name if none is specified. To override the default robot name, supply a response to the robot_name parameter in the command. cartridge_name - The name of the cartridge as identified by its external label. MRU treats cartridge names with case sensitivity. MRU drive, slot, and port numbering begins with 0. The default value supplied by MRU for DRIVE, SLOT, and PORT is 0. Commands for Operating a Media Robot The following command descriptions show the general command syntax. For commands that involve cartridges, such as LOAD and MOVE, you can optionally specify the cartridge name as it appears on the barcode. If the media robot has a vision capability, MRU can determine the bar code value before actually executing the command. If the specified bar code is not the bar code value at the source, the comand fails before processing any farther. If the media robot does not support bar codes, the bar code value is ignored. Consult your online information for examples and detailed descriptions of commands for your operating system. INJECT The INJECT command moves a cartridge from a port to a slot. INJECT [ PORT port_number ] { SLOT slot_number } [ ROBOT robot_name ][ CART cartridge-name ] 27 EJECT This EJECT command moves a cartridge from a slot to a port. EJECT SLOT { SLOT slot_number } [ PORT port_number ] { ROBOT robot_name } [ CART cartridge_name ] This EJECT command moves a cartridge from the PTM of a TL82n Automated Tape Library System to a port. EJECT [ ROBOT robot_name ] { PORT } [ port_number ] [ CART cartridge_name ] LOAD The LOAD command moves a cartridge from a slot into a drive. LOAD { SLOT slot_number } [ DRIVE drive_number ] [ ROBOT robot_name ] [ CART cartridge_name ] UNLOAD The UNLOAD command moves the cartridge from a drive into a slot. UNLOAD [ DRIVE drive_number ] { SLOT slot_number } [ ROBOT robot_name ] [ CART cartridge_name ] READY The READY command enables the inport door release button on the TL82n Automated Tape Library System. READY { PORT port_name } [ ROBOT robot_name ] LOCK The LOCK command sends a SCSI Prevent Media Removal command to the media robot. Refer to your hardware documentation for a description of the result of issuing this SCSI command. LOCK [ ROBOT robot_name ] UNLOCK The UNLOCK command sends a SCSI Allow Media Removal command to the media robot. Refer to your hardware documentation for a description of the result of issuing this SCSI command. UNLOCK [ ROBOT robot_name ] MOVE The MOVE command moves a cartridge from a source location to a destination. Allowable actions with the MOVE command are determined by the specific library or loader system. 28 MOVE {PORT port_number | SLOT slot_number | DRIVE DRIVE_NUMBER } { PORT port_number | SLOT slot_number | DRIVE drive_number } [ ROBOT robot_name ] [ CART cartridge_name ] POSITION The POSITION command positions the cartridge manipulation mechanism to the specified location. POSITION { Port port_number | SLOT slot_number | drive drive_number } [ ROBOT robot_name ] HOME The HOME command returns a cartridge from the specified location to its home (previous) location. The home position varies between different media robots. To find out the home location on your media robot, consult your hardware documentation, or issue the command and observe the placement of the mechanism. HOME [ ROBOT robot_name ] { PORT port_number | SLOT slot_number | DRIVE drive_number | TRANSPORT transport_number } FIND CARTRIDGE The FIND CARTRIDGE command locates a named cartridge in any media robot which includes a vision system. If the named cartridge resides in the media robot, MRU software returns its location. This command uses the name on the external label affixed to the cartridge, it DOES NOT use the name of the recorded label on the medium. FIND CARTRIDGE { cartridge_name } [ ROBOT robot_name ] IMPORTANT: The following Wild card support is for the CLI command robot find cartridge only and not for the GUI. MRU V1.4 allows wildcard names for this command as in the following examples: FIND CARTRIDGE {"?*"} this command shows all elements namely: slots drives transports ports that are full. FIND CARTRIDGE {"*"} this command shows all slots, drives, transports and ports. Irrespective of whether they are full or empty this command shows all the elements available in the library. 29 INITIALIZE The INITIALIZE command inventories the robot and updates the robot's internal element status. The time it takes to complete the operation depends on the size of the robot. A small loader takes less time to inventory than does a multitower robot. INITIALIZE [ ROBOT robot_name ] Commands for Showing Media Robot Status The following command descriptions show the general command syntax. Consult your online information for examples and detailed descriptions of commands for your operating system. SHOW ROBOT The SHOW ROBOT command shows the status of the specified robot. SHOW ROBOT [ ROBOT robot_name ] SHOW PORT The SHOW PORT command shows the status of the specified ports. For a description of the results, review the online information. SHOW PORT [ ROBOT robot_name ] { PORT } SHOW SLOT The SHOW SLOT command shows the status of the specified slots. For a description of the results, review the online information. SHOW SLOT [ ROBOT robot_name ] { SLOT } [[ slot_number | slot_number-slot_number ],... ] SHOW DRIVE The SHOW DRIVE command shows the status of the specified drives. For a description of the results, review the online information. SHOW DRIVE [ ROBOT robot_name ] { DRIVE } [[ drive_number | drive_number-drive_number ],... ] About Media Robot Utility Software SHOW VERSION The SHOW VERSION command displays the current version of the Media Robot Utility software SHOW VERSION HELP The HELP command displays information about MRU commands. 30