lshostvol

The lshostvol command displays the mapping of host device names or volume names to machine type 2105, 2107, and 1750 volume IDs. (This command is not supported on the i5/OS.)


>>-lshostvol---------------------------------------------------><

Parameters

There are no parameters for this command.

Notes:

The lshostvol command displays only volumes that are accessed using a direct fibre channel path when you use the command on an OpenVMS host system that is a member of an OpenVMS cluster. The command output does not display information about the following OpenVMS cluster devices:
- Volumes to which the host system only has MSCP paths.
- Volumes to which the host system uses only MSCP paths at this time even though it has both MSCP and direct paths.
If you do not have installed the IBM Multipath Subsystem Device Driver (SDD), the virtual path (vPath) name is not displayed.
On a Red Hat Enterprise Linux system, attached devices might be detected by the HBA driver, but they are not registered with the operating system. Normally, the operating system is set up to automatically detect all LUNS. However, if this does not occur automatically, you must issue the following for every volume (LUN):
```
echo
scsi add-single-device host# channel# lun# >/proc/scsi/scsi
```
If SDD is installed on your system, you can run the scsiscan script to detect all the LUNs.

Example

The information that is displayed on the report that is generated from the lshostvol command is different depending on whether you have SDD installed. The following example tables indicate the differences.

For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.

The following tables represent the headers that are displayed on the output reports that are associated with the lshostvol command. A separate example is not shown for the 1750 because the information is the same for both the 2107 and 1750.

Invoking the lshostvol command

dscli>lshostvol

The resulting output with SDD installed

Date/Time: Sun Aug 11 02:23:49 PST 2004 DS CLI Version: 5.0.0.0 
DS: IBM.1750–75FA120

Device/Volume Name	Volume ID	Vpath Name
my_vol_01,my_vol_04	IBM.1750-75DA110/175D	vpath01
my_vol_02,my_vol_05	IBM.1750-75EA120/175E	vpath02
my_vol_03,my_vol_06	IBM.1750-75FA130/175F	vpath03
my_vol_07,my_vol_09	IBM.2105-29239/119E	Vpath04
my_vol_08,my_vol_10	IBM.2105-29239/119F	Vpath05

The resulting output without SDD installed

Date/Time: Sun Aug 11 02:23:49 PST 2004 DS CLI Version: 5.0.0.0 
DS: IBM.1750–75FA120

Device/Volume Name	Volume ID	Vpath Name
Hdisk01	IBM.1750-75DA110/175D	-
Hdisk02	IBM.1750-75EA120/175E	-
Hdisk03	IBM.1750-75FA130/175F	-
Hdisk07	IBM.2105-29239/119E	-
Hdisk08	IBM.2105-29239/119F	-

Report column definitions

Device/Volume name: Specifies the nickname you assigned to the device or volume. When SDD is installed, this column reports the volume name instead of the device name.
Volume ID: Specifies the ID of the storage unit.
Vpath name: Specifies the virtual path name. When SDD is not installed, this value is reported as null (-).