9.14 cfmg_listvnet (Displaying a Virtual Network List)

Name

[Windows Manager]
Installation_folder\RCXCFMG\bin\cfmg_listvnet - Displaying a Virtual Network List

[Linux Manager]
/opt/FJSVcfmg/bin/cfmg_listvnet - Displaying a Virtual Network List

Synopsis

cfmg_listvnet [-utf8]

Functional Description

This command outputs in XML format a list of the network resources that have been registered with Resource Management.

All of the network resources that have been registered with Resource Management are output in the following format:

<?xml version="1.0" encoding="UTF-8"?>
<networks>
	<network>
		<id>[Resouce ID]</id>
		<name>[Resource name]</name>
		<tenantName>[Tenant name]</tenantName>
		<category>[Network category]</category>
		<extid>[VLAN ID]</extid>
		<type>[Network type]</type>
		<segmentType>[Segment type information]</segmentType>
		<comment>[Comment]</comment>
		<locked>[The locked status of the resource]</locked>
		<addrset>
			<name>[Address set name]</name>
			<subnet>[Subnet address]</subnet>
			<mask>[Subnet mask]</mask>
			<start>[Start address]</start>
			<end>[End address]</end>
		</addrset>
		<exclude>
			<range>
				<start>[Start address]</start>
				<end>[End address]</end>
			</range>
			<range>
				<start>[Start address]</start>
				<end>[End address]</end>
			</range>
		</exclude>
		<status>
			<num>[Total number of addresses]</num>
			<used>[Number of used addresses]</used>
			<avail>[Number of available addresses]</avail>
		</status>
	</network>
</networks>

Note

If network resources registered with Resource Management do not exist, information is output in the following format:

<?xml version="1.0" encoding="UTF-8"?>
<networks />

Options

-utf8 (optional): This option outputs the list in UTF-8 format.
This option is only enabled for Windows Manager versions.
If this option is omitted, the list is output in ISO-8859-1 format.
For Linux Manager versions, the list is output in UTF-8 irrespective of this option.

Requirements

Permissions: Infrastructure administrator with OS administrator privilege

Location: Admin server

Example

> cfmg_listvnet
<?xml version="1.0" encoding="Windows-31J"?>
<networks>
	<network>
		<id>ST01-M_1446</id>
		<name>gyomu-3</name>
		<tenantName>tenant1</tenantName>
		<category>BUSINESS</category>
		<extid>10</extid>
		<type />
		<segmentType>DMZ</segmentType>
		<comment>DMZ LAN</comment>
		<locked>true</locked>
		<addrset>
			<name>192.168.xxx.xxx</name>
			<subnet>192.168.xxx.xxx</subnet>
			<mask>255.255.xxx.xxx</mask>
			<start>192.168.xxx.xxx</start>
			<end>192.168.xxx.xxx</end>
		</addrset>
		<exclude>
			<range>
				<start>192.168.xxx.xxx</start>
				<end>192.168.xxx.xxx</end>
			</range>
			<range>
				<start>192.168.xxx.xxx</start>
				<end>192.168.xxx.xxx</end>
			</range>
		</exclude>
		<status>
			<num>20</num>
			<used>3</used>
			<avail>17</avail>
		</status>
	</network>
</networks>

Remarks: Encoding will be "UTF-8" with the Linux Manager.

Exit Status

This command returns the following values:

0: The command executed successfully.

non-zero: An error has occurred.