B.1.16 getvb Command

NAME

getvb - Displays information about a virtual enclosure

SYNOPSIS

[Solaris OS/Linux OS]

/opt/FJSVssmgr/sbin/vscmcmd getvb [-a [-d]]
/opt/FJSVssmgr/sbin/vscmcmd getvb -x virtual-box-name [-d]
/opt/FJSVssmgr/sbin/vscmcmd getvb -h

[Windows OS]

$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe getvb [-a [-d]]
$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe getvb -x virtual-box-name [-d]
$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe getvb -h

($INS_DIR means "Program Directory" specified at the Manager installation.)

DESCRIPTION

This command displays information about virtual enclosures.

Information can be displayed in the following two ways:

Displaying a list of virtual enclosures.
Displaying information about the virtual targets that have been registered with the specified virtual enclosure.

Execute this command as the administrator for the operating system (that is, with “Administrator” or “root” privileges).

OPTIONS

-x virtual-box-name: Specify the name of the virtual enclosure.

-a: This option displays detailed information.

-d

This option displays information in CSV format.

If -x option is not specified, the -a option must be specified.

-h: Indicates how to use the command.

EXAMPLES

Displaying a list of virtual enclosures.

# /opt/FJSVssmgr/sbin/vscmcmd getvb
VirtualBoxName SwitchName
VBOX001        switch001(vsce1),switch001(vsce2)
VBOX002        switch002(vsce3),switch002(vsce4)
VBOX003        switch003(vsce5),switch003(vsce6)
Command terminated normally.

Displaying a list of virtual enclosures, with detailed information about each virtual enclosure.

# /opt/FJSVssmgr/sbin/vscmcmd getvb -a
VirtualBoxName Type    SwitchName                        BoxID
VBOX001        virtual switch001(vsce1),switch001(vsce2) 00VS900#######VS900#######BB0001########
VBOX002        virtual switch002(vsce3),switch002(vsce4) 00VS900#######VS900#######BB0002########
VBOX003        virtual switch003(vsce5),switch003(vsce6) 00VS900#######VS900#######BB0003########
Command terminated normally.

Displaying a detailed list of virtual enclosures in CSV format.

# /opt/FJSVssmgr/sbin/vscmcmd getvb -a -d
"VirtualBoxName","Type","SwitchName","BoxID"
"VBOX001","virtual","switch001(vsce1),switch001(vsce2)"," 00VS900#######VS900#######BB0001########"
"VBOX002","virtual","switch002(vsce3),switch002(vsce4)"," 00VS900#######VS900#######BB0002########"
"VBOX003","virtual","switch003(vsce5),switch003(vsce6)"," 00VS900#######VS900#######BB0003########"
Command terminated normally.

Displaying information about the virtual targets that have been registered with the specified virtual enclosure (VBOX001).

# /opt/FJSVssmgr/sbin/vscmcmd getvb -x VBOX001
VirtualTragetName VTWWPN
VT001             2000000b5d12fd31
VT002             2001000b5d12fd31
VT003             2002000b5d12fd31
Command terminated normally.

Displaying information about the virtual targets that have been registered with the specified virtual enclosure (VBOX001) in CSV format.

# /opt/FJSVssmgr/sbin/vscmcmd getvb -x VBOX001 -d
"VirtualTragetName","VTWWPN"
"VT001","2000000b5d12fd31"
"VT002","2001000b5d12fd31"
"VT003","2002000b5d12fd31"
Command terminated normally.

Table B.3 Display items for the getvb command and their meanings
Display item	Displayed when the -a option is not specified	Meaning
VirtualBoxName	Yes	The names of the virtual enclosures
Type	No	”virtual” is always displayed
SwitchName	Yes	The names of the virtualization switches that have been registered with each virtual enclosure (followed by the host names in parentheses)
BoxID	No	A unique identifier for each virtual enclosure
VirtualTargetName	Yes	The names of virtual targets that have been registered with the virtual enclosure
VTWWPN	Yes	The WWPN for each virtual target

EXIT STATUS

0: Displaying information about the virtual enclosure has terminated normally.

1: Displaying information about the virtual enclosure has terminated abnormally.