lsvrtcap command

Use the lsvrtcap command to list virtualization capabilities of a virtual server or host system.

Synopsis

smcli [-c] [-prompt] [-user user_name] [-pw password] lsvrtcap options

smcli lsvrtcap [-h | -? | --help]

smcli lsvrtcap {-c command} [-v] [-g | -A guest_os] [-m | -e existing_virtual_server] [-p] [-o owner] [-w | --network network] [-d | --diskalloctype allocation_type] [-t | --portlayer port_layer] [-s setting] {-i ip_address | [-n] system}

Description

The lsvrtcap command displays the customizable attributes for a virtual server or host system. You must specify an action, then the action that you specify determines which other options you must or can specify. After you determine the attributes that you can customize for a virtual server or host system, you can specify those attributes in the -A option of the following commands: chvrthost, chvs, and mkvs.

The virtualization capabilities include attributes and information about those attributes (such as its format, minimum value and maximum value) that are useful when creating related objects or changing attributes on the target virtual server host system.

If you do not specify the -g | --availgos or -A | --guestosattr options, this command lists all virtualization capabilities for the target virtual server host system.

See the chvrthost, chvs, and mkvs command topics for more information about how to use the lsvrtcap information when running each command.

Operands

This command uses a host name, platform-manager name, or virtual-server name as an operand. The list can optionally be preceded by the -n | --names option.

Options

-A | --guestosattr guest_os

Lists the guest-operating-system attributes available when creating a virtual server on the specified virtual-server host system on which the specified guest operating system runs.

Tip: If you specify this option, you must also specify the -c mkvs option.

-c | --cmd {mkvs | chvs | chvrthost}

Lists the attributes that can be set by the specified virtualization command.

-d | --diskalloctype allocation_type

Lists attributes for the given disk allocation type.

-e | --existingvs existing_virtual_server

Lists the system attributes available when creating a virtual server on the specified host from the existing virtual server that is provided.

Tip: If you specify this option, you must also specify the -c mkvs option.

-g | --availgos

Lists the guest-operating-systems that can be used when creating a virtual server on this virtual-server host system. This option is not supported for hosts using Hyper-V operating systems.

Tip: If you specify this option, you must also specify the -c mkvs option.

Note: This option is only available on IBM® Power® systems.

-h | -?

Displays the syntax and a brief description of the command.

Tip: If you specify additional options other than -h | -? | --help, the options are ignored.

--help

Displays detailed information about the command, including the syntax, a description of the command, a description of the options and operands, error codes, and examples.

Tips:

If you specify additional options other than -h | -? | --help, the options are ignored.
You can also display detailed help in the form of man pages using the man command_name command.

-i | --ipaddress {ip_address | host_name | platform_manager_name | virtual_server_name}

Targets a host system, platform manager, or virtual server, specified by IP address, host name, platform-manager name, or virtual-server name.

ip_address

The IP address of the system.

Tips:

You can enter lssys -A IP_address to list the IP address of each discovered system.
You can use either the IPv4 or IPv6 format to specify the IP address.

host_name

Either the host name or the host name and Domain Name System (DNS) suffix of the system. If the host name contains spaces, enclose it in quotation marks. If it contains a comma, prefix the comma with a backslash (\).

Tips:

You can enter lssys -A HostName to list the host name of each discovered system.
The host names are not locale specific.
A given IP address or host name might resolve multiple systems. For example, both the OperatingSystem and Server instance of a particular system will have the same host name. Use system Object ID (option -n) to target a system uniquely.

platform_manager_name

Either the platform-manager name or the platform-manager name and Domain Name System (DNS) suffix of the system.

Tips:

You can enter lsgp -N "Platform Managers" -A GroupMembers to list all platform-manager names.
The platform-manager names are not locale specific.

virtual_server_name

The name of the virtual server.

Tips:

You can enter lsgp -N "Virtual Servers" -A GroupMembers to list all virtual-server names.
The virtual-server names are not locale specific.

-m | --availvms

Lists the virtual systems that can be used when creating a new virtual server on this virtual server host system.

Tip: If you specify this option, you must also specify the -c mkvs option.

-n | --names {system_oid | system_name}

Targets a virtual server, platform manager, or host system specified by name or ID.

system_oid

The unique ID of the system, specified as a hexadecimal value prefixed with 0x (for example, 0x37) or a decimal value (for example, 123).

Tip: Use the lssys -o command to list all system IDs.

system_name

The name of the system. If the system name contains a comma, prefix the comma with a backslash (\).

Tips:

The system names might not be unique. This command acts on all systems with the specified name. Use the -v | --verbose option to generate a message when this command targets multiple systems with the same name. To target a particular system that has a name that is not unique, identify the system by specifying its unique, hexadecimal ID, or use additional target options to refine the selection.
Use the lssys command without any options to list all system names.
The system names are not locale specific.

-o | --owner owner

Lists the virtual addresses for the given owner.

Tip: If you specify this option, you must also specify the -c mkvs or the -c chvs option.

-p | --procdata

Shows additional processor data. This data contains the processor id, address, processor type, dedicated state, and cryptographic facility.

Tip: If you specify this option, you must also specify the -c mkvs or the -c chvs option.

-s | --generalsetting setting

Lists the types of server settings that can be modified.

-t | --portlayer port_layer

Lists attributes for the given port layer.

-v | --verbose

Writes verbose messages to standard output.

If this option is not specified, this command suppresses noncritical messages.

-w | --network network

Lists attributes for the given network.

Exit status

The following codes are returned by this command.

0: The operation completed.
1: A usage error occurred.
2: The command or bundle was not found.
3: The command was not performed because either authentication failed or you are not authorized to perform the action.
10: The file was not found.
25: A number-formatting error occurred.
29: The specified locale is not valid or not supported.
100: An error occurred while retrieving targeted systems.
101: A targeted system was not found.

Examples

List all virtualization capabilities
This example illustrates how to lists all virtualization capabilities that can be specified when creating a virtual server on a virtual-server host system named virthost1.
```
smcli lsvrtcap -c mkvs -n virthost1
```
List guest operating systems
This example illustrates how to list the guest operating systems that can be used when creating a virtual server on the virtual server host system with IP address 110.110.1.2.
```
smcli lsvrtcap -g -c mkvs -i 110.110.1.2
```
List the guest-operating-system attributes
This example illustrates how to list the guest-operating-system attributes available when creating a virtual server on the host system named virtsys1 on which the specified guest operating system Windows Server 2003 Enterprise runs.
```
smcli lsvrtcap -n system1 -c mkvs -A "Windows Server 2003 Enterprise"
```

List attributes displayed in a table format and select rows from the table

Tips: These tips apply to the tables that are displayed for these examples.

The key column is used to uniquely identify a row in a table.
The syntax to select a row from the Options is: table_name=row_key1;row_key2; (for example disks=disk1:rootvg:pva3202;disk2:rootvg:pva3202).
Multiple rows are separated by using a semicolon.
When changing the rows in a table, specify a plus to add a row and a minus to remove a row.
When adding a new options row by using the chvs command and -s option, use lsvrtcap -c chvs to determine the virtualization capabilities values to be specified by using the -s option.

This example illustrates how to determine the attributes that can be specified when creating a virtual server on the host named Power_Host for the IBM Power - AIXLINUX operating system. Inspect the disks table displayed.

smcli lsvrtcap -c mkvs -A "IBM Power - AIXLINUX" Power_Host

networks

    Options:
    Key,               Logical Network, Bridged,  VLAN ID,  Deployment State,  
    [Discovered-1016]  Discovered-1016  Yes       1016      Existing on host   
    [Discovered-1015]  Discovered-1015  Yes       1015      Existing on host   
    [Discovered-1014]  Discovered-1014  Yes       1014      Existing on host   

    Options (continued from above):
    Virtual Servers,  Description,  VLAN ID
    pva8072
    pva8071
    pva8070,pva8080

This example illustrates how to create a virtual server specifying Discovered-1015 and Discovered-1016 and verify it is created with Discovered-1015 and Discovered-1016.

smcli mkvs -A "name=vs1, gos=IBM Power - AIXLINUX, cpumode=DEDICATED, 
cpudedicated=1, memsize=256, 
networks=Discovered-1015;Discovered-1016" Power_Host

smcli lsvrtcap -c chvs vs1

networks   Values:

    Options:
    Key,               Logical Network,  Bridged,  VLAN ID,  Deployment State,  
    [Discovered-1016]  Discovered-1016   Yes       1016      Existing on host   
    [Discovered-1015]  Discovered-1015   Yes       1015      Existing on host   

    Options (continued from above):
    Virtual Servers,  Description,  VLAN ID
    pva8072,vs1
    pva8071,vs1

This example illustrates how to remove Discovered-1016 from vs_1.

smcli chvs -A "networks=-Discovered-1016" vs1

smcli lsvrtcap -c chvs vs1

networks   Values:

    Options:
    Key,               Logical Network,  Bridged,  VLAN ID,  Deployment State,  
    [Discovered-1016]  Discovered-1016   Yes       1016      Existing on host   

    Options (continued from above):
    Virtual Servers,  Description,  VLAN ID
    pva8072,vs1

This example illustrates how to add an options row to the diskslinked parameter table.

smcli chvs -n 0xd84 -s 
"disklinked=addlinkeddiskvirtaddr:190;addlinkeddiskowner:27.MAINT;
addlinkeddiskowneraddr:190;addlinkeddiskaccess:RR"

smcli lsvrtcap -c chvs vs1

disklinked		 Min:		 1
		 Max:		 1
		 Changeable Columns:
		 		 Column Name*           CLI Attribute
		 		 Virtual Device Number  LinkedDiskVirtualAddress
		 		 Disk Owner             LinkedDiskOwner
		 		 Owner's Address        LinkedDiskOwnerAddress
		 		 Access Mode            LinkedDiskAccessMode

		 Values:
Key,  Virtual Device Number*, Disk Owner*, Owner's Address*, Access Mode*, 
[191] 191		 		 		   27.ADM		 191		 R		 R

		 Options:
		 Key,  Virtual Device Number*,		 Disk Owner*, Owner's Address*, Access Mode*,

		 Values available to add new options row with -s : 
		 		 addlinkeddiskvirtaddr
		 		 addlinkeddiskowneraddr
		 		 addlinkeddiskaccess
		 		 addlinkeddiskowner