Use the DGUIDE command to open an information catalog from the MS-DOS command line. You can add parameters to the command to import or export a tag language file. Importing a tag language file from the command line and Exporting metadata from the information catalog describe the parameters that you can add to the DGUIDE command.
Use the DGUIDE command to open an information catalog and import a tag language file from an MS-DOS command prompt. When you use the DGUIDE command, keep in mind the following rules for the command syntax:
Figure 70. DGUIDE command parameters for opening an information catalog and importing metadata
DGUIDE /USERID userid /PASSWORD password /DGNAME dgname Optional keywords: /ADMIN /TRACE 0|1|2|3|4 /IMPORT filename /LOGFILE filename /RESTART B|C Optional import keyword: /ICOPATH iconpath |
The following example shows the required parameters you specify to open the sample information catalog as an administrator.
DGUIDE /USERID longods /PASSWORD secret /DGNAME ICMSAMP /ADMIN
The following list shows the parameters you can add to the DGUIDE command. Optional and required keywords for importing a tag language file are noted.
If the information catalog is local, give the database name. If the information catalog is remote, give the alias under which it was cataloged.
Example:
/DGNAME ICMSAMP
Indicates that you are importing icons and specifies the icon path that the import function will use. The Information Catalog Manager assumes that the path is the same as the one where you installed the Information Catalog Manager unless you specify a full drive and path. You must specify a fixed drive.
Example:
/ICOPATH d:\icons\
Example:
/IMPORT d:\tagfile.tag
This keyword bypasses the Information Catalog Manager user interface and performs the import function as a batch process.
Specifies the file destination for messages the Information Catalog Manager generates during import. Unless you specify a full drive, path, and file name, the Information Catalog Manager places the file in the path specified on the DGWPATH environment variable. You must specify a fixed drive.
Example:
/LOGFILE d:\tagfile.log
Example:
/PASSWORD secret
Passwords are case-sensitive for accessing databases on the following operating systems, you must type them exactly as specified.
Indicates which option the import function uses. The valid options are:
Example:
/USERID longods
Use the DGUIDE command to export metadata into a tag language file which you can import into another information catalog.
When you use the DGUIDE command to export metadata, keep in mind the following rules for command syntax:
Figure 71. DGUIDE command parameters for exporting metadata
DGUIDE /DGNAME ic_name /USERID userid /PASSWORD password /ADMIN /EXPORT filename /LOGFILE filename /OBJTYPE object_type /OBJECTS name Optional keywords: /ADMIN /A /C /L /T |
This keyword is optional.
This keyword is optional.
This keywords is optional.
If the information catalog is local, give the database name. If the information catalog is remote, give the alias under which it was cataloged.
Example:
/DGNAME ICMSAMP
Example:
/EXPORT d:\tagfile.tag
This keyword is optional.
Specifies the file destination for messages the Information Catalog Manager generates during the export process. Unless you specify a full drive, path, and file name, the Information Catalog Manager places the file in the path specified on the DGWPATH environment variable. You must specify a fixed drive.
Example:
/LOGFILE d:\tagfile.log
Example:
/OBJECTS "DWCTARGET.DWCADMIN.CUSTOMER"
Example:
/OBJTYPE TABLES
Example:
/PASSWORD secret
Passwords are case-sensitive for accessing databases on the following operating systems, you must type them exactly as specified.
This keyword is optional.
Example:
/USERID hchan
In the following example, the administrator hchan exports a relational table object with a UUI of DBNAME(DWCTARGET) OWNER(DWCADMIN) TABLES(CUSTOMER) from the ICMSAMP information catalog. The table object and all columns associated with the object will be exported as well as all contact objects and objects that have linked relationships with the table object. The metadata for the exported objects will be written to a file called x:\mypath\tagfile.tag.
DGUIDE /DGNAME ICMSAMP /USERID hchan /PASSWORD mypass /ADMIN /EXPORT x:\mypath\tagfile.tag /LOGFILE x:\mypath\tagfile.log /OBJTYPE TABLES /OBJECTS "DWCTARGET.DWCADMIN.CUSTOMER" /c /t /l