Topology Export Utility

The export command saves the topology data for a domain, or for all domains, to a file.

Export Command Parameters

The export command takes the following parameters:

comment

The value of the comment parameter is an annotation to be included in the file.

domain

The value of the domain parameter is the name of the domain whose topology is to be exported. If no domain is specified, all domains are exported.

filename

The value of the filename parameter is the name of the file to which the topology information should be exported.

mode

The value of the mode parameter determines how the topology information is incorporated into the file. If the value is append, then the data is appended to the contents of the file. If the value is overwrite, then the previous contents of the file are replaced by the new data.

validity

The value of the validity parameter is the length of time in days for which the data is valid. The following values are legal values for the validity parameter:

• Unlimited

• 7

• 15

• 30

• 90

Example 19–2 Exporting Default Domain Topology to a File

In the following example, the Default Domain is saved to a file that is named snapshot. The original contents of snapshot are overwritten by the new data. The new data is assumed to be valid for an unlimited period of time. The comment specifies that this data is for the system testing group.

> export filename=/home/examples/snapshot \
domain="Default Domain" mode=overwrite validity=Unlimited \
comment="System Test Group"

Output Messages for the Export Command

The following list shows the messages that might appear as a result of the export command.

Export: Results 1/1

State=Success

Message=The topology data is successfully exported.

Cause:

Success.

Description:

The operation completed successfully.

export: Cannot open file.

Cause:

File does not exist.

Description:

The parameter file does not exist.

filename: Permission denied.

Cause:

File error.

Description:

The file cannot be created or be opened for writing.

export: File format not supported.

Cause:

Format wrong.

Description:

The error occurs when appending the export data to a file that is not a valid export data file.

export: The domain <domainname> does not exist

Cause:

Object error.

Description:

The domain that you want to export does not exist.

export: Wrong parameter file.

Cause:

Parameter file error.

Description:

The parameter file contains a list of name = value pairs. If the file format is not correct, the application notifies you and stops.

export: The current user is different from the last one.

Cause:

User conflict.

Description:

The error occurs when you try overwrite or append the data to an existing data file created by others. You cannot modify or overwrite export data that another user created.

export: Data is out-of-date.

Cause:

Data is too old.

Description:

You are using an out-of-date export file. This message only occurs when you export data in append mode.

export: illegal parameter - <para>.

Please use -h option to get usage.

Cause:

Illegal parameter.

Description:

An illegal parameter was passed to the export operation.