jcfcolvmvirtage

Organization of this page

Function
Format
Execution permission
Storage directory
Arguments
Return values
Format of the virtualization configuration information file
Example output

Function

This command acquires virtualization configuration information from Virtage and outputs it to a virtualization configuration information file.

For the prerequisite conditions for executing this command, see 3.3.1(1) Prerequisites for managing a virtualization configuration in the Job Management Partner 1/Integrated Management - Manager Configuration Guide.

To Page Top

Format

jcfcolvmvirtage
          -c host-name [host-name]
          -o output-file-name

To Page Top

Execution permission

In Windows: Administrator permissions (If the Windows UAC feature is enabled, the command is executed from the administrator console.)

In UNIX: Superuser permissions

To Page Top

Storage directory

In Windows:: Manager-path\bin\imcf\
In UNIX:: /opt/jp1imm/bin/imcf/

To Page Top

Arguments

-c host-name [host-name]: Specifies the name of the host where JP1/SC/CM that manages Virtage is running. For a host name, specify a maximum of 255 characters. You can specify multiple host names by separating them with the space character or the tab delimiter.
-o output-file-name: Specifies the virtualization configuration information file that stores the configuration information obtained from JP1/SC that manages Virtage in relative path or absolute path format. This option cannot be omitted. If the path contains a space, enclose the entire path in double-quotation marks (").

To Page Top

Return values

`0`	Normal termination^#1
`1`	Argument error
`2`	Insufficient memory
`3`	JavaVM start error occurred
`4`	Execution permission error
`5`	The command was not executed from the administrator console
`6`	Output file already exists
`7`	Acquisition of virtualization configuration information failed^#2
`8`	Input/output error
`99`	Other error

#1: The command terminates normally even when some of the virtual configuration information has not been acquired.
#2: The command outputs a return value if it is unable to acquire virtualization configuration information from any host.

To Page Top

Format of the virtualization configuration information file

Table 1‒25: Header information (line 1)
Item	Output value
Identification character string for a virtualization configuration information file	`#VM`
File format version	`090100`
Character encoding	UTF-8 fixed

Table 1‒26: Header information (line 2)
Item	Output value
Host name	`Host_name`
VMM host name	`VMM_host_name`
Virtualization management type	`Virtual_manager_type`
Virtualization management product version	`Manager_version`
Virtualization configuration management host	`Virtual_host_manager`

Table 1‒27: Output items (From line 3)
Item	Description
Host name	Host name
VMM host name	Name of the host where virtualization environment software runs. In the case of a VMM host with no guest OS, the virtual host name field is blank and only the VMM host name is set.
Virtualization management type	Type of product that manages the virtualization configuration: For JP1/SC/CM: `JP1/SC/CM` For Virtage: `Virtage`
Virtualization management product version	Version of the product that manages a virtualization configuration
Virtualization management former host name	Name of the host that manages a VMM host

To Page Top

Example output

#VM,090100,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager 
Vm1,VIRTAGE1,,,
Vm2, VIRTAGE1,,,
VIRTAGE1,,Virtage,
SCCM1,VIRTAGE1,JP1/SC/CM,,

To Page Top