Linux operating systemsAIX operating systems

dsmsanlist (Display information about devices)

Use the dsmsanlist device information utility to display information about devices that are connected to the IBM Storage Protect server.

The dsmsanlist utility is part of the IBM Storage Protect server and IBM Storage Protect storage agent package. The utility is installed along with the IBM Storage Protect server or the IBM Storage Protect storage agent. By default, the utility is located in either the server/bin directory (/opt/tivoli/tsm/server/bin) or the storage agent directory (/opt/tivoli/tsm/StorageAgent/bin).

The dsmsanlist utility uses the host bus adapter (HBA) API interface to get the device information from the storage area network (SAN). Therefore, before you run the utility, ensure that the HBA API library of the HBA vendor is also installed.

You can run the dsmsanlist utility by browsing to the relevant directory (either /opt/tivoli/tsm/server/bin or /opt/tivoli/tsm/StorageAgent/bin), and then entering dsmsanlist. No additional options are available for this utility.

The dsmsanlist utility displays the following information as output:
  • HBA information
  • HBA port number
  • Device vendor ID
  • Product ID
  • Device type
  • Device serial number
  • Port worldwide name
  • IBM Storage Protect device name
A log file (dsmsanlist.log), which you can use for debugging purposes, is also generated by default.
Linux operating systemsAIX operating systems

Example: Display information about all devices

Display information about all devices that are connected to the IBM Storage Protect server:
dsmsanlist
root@xlinux3:/opt/tivoli/tsm/server/bin]# ./dsmsanlist

******************************************
*       IBM Storage Protect       *
*       dsmsanlist Utility Program       *
******************************************
Licensed Materials - Property of IBM

(C) Copyright IBM Corporation 2013. All rights reserved.
U.S. Government Users Restricted Rights - Use, duplication or disclosure
restricted by GSA ADP Schedule Contract with IBM Corporation.

Port #1  Vendor_ID   Product_ID        Type     Serial_Number            Port_WWN            Dev_Name
=======================================================================================================================
          IBM        ULTRIUM-TD8       Tape     C3EAC62000               500308c3eac62001   /dev/sg13;
          QUANTUM    Scalar i3-i6      Changer  QUANTUMFFC1652024_LLA    500308c3eac62001   /dev/sg28;/dev/changer-sg28;
          IBM        ULTRIUM-HH7       Tape     11C1A030B5               5000e111c1a030b6   /dev/sg1;
          BDT        MULTISTAK         Changer  DE68101026_LL01          5000e111c1a030b6   /dev/sg2;/dev/changer-sg2;
          IBM        ULTRIUM-HH6       Tape     11C1A030BF               5000e111c1a030c0   /dev/sg3;
          HPE        Ultrium 8-SCSI    Tape     9C1730D495               5001438016044f42   /dev/sg8;
          HP         1x8 G2 AUTOLDR    Changer  4C6140X001               5001438016044f42   /dev/sg21;/dev/changer-sg21;
          IBM        ULTRIUM-TD8       Tape     C3EAC62114               500308c3eac62115   /dev/sg24;
========================================================================================================================