ATG Repository Guide

-m <module name>

The modules to load. The -m argument must precede all other arguments if it is present. You can specify multiple module names by using a separate –m argument for each module.

-s <server name>

The name of the ATG server to use. This optional argument lets you specify a ATG server that is configured to use a ATG data source that points to the repository’s database.

See the note on Server Conflicts, however.

-repository <Nucleus path to Repository>

The Nucleus address of the repository. For example:

-repository /atg/dynamo/
service/jdbc/SQLRepository

If you run the script with the DPS module or a module which requires the DPS module, you can omit this argument, and the script will use the first repository registered in the /atg/registry/ContentRepositories component.

-outputSQL

Outputs a DDL (SQL) file for the XML templates in the repository to standard out.

-outputSQLFile <file>

Outputs a DDL (SQL) file for the XML templates in the repository to the specified file.

-database <vendor>

Customizes the DDL for the SQL variant used by the specified vendor’s database software. Possible values are:

db2
microsoft
oracle
solid
sybase

-output <file>

Sends all output from <print-item> and <query-item> tags to a file (instead of standard out).

-verboseSQL

Outputs additional logging information. This option is equivalent to setting the loggingSQLInfo and loggingSQLDebug properties to true for the JTDataSource used by the repository. All SQL emitted will be logged.

-export "<item-type1,item-type2>" <file>

Exports all of the items of one or more item descriptors to an XML repository definition file. The location of the resulting file is relative to the <ATG2007.3dir>/home directory.

-export all <file>

Exports all of the items of all item descriptors in this repository to a file. The location of the resulting file is relative to the <ATG2007.3dir>/home directory.

-exportRepositories <path-to-repository1,path-to-repository2> <file>

To export data from more than one repository into the same file, use this option. This may be preferable to the -export option if your repositories are linked as it prevents duplicating the linked item descriptors in more than one file.

-exportRepositories all <file>

Exports all repositories into one file. The location of the resulting file is relative to the <ATG2007.3dir>/home directory.

-skipReferences

By default, when you use one of the export arguments, all referenced item descriptors are automatically added to the list of item descriptors to be exported. If you use the -skipReferences argument, referenced item descriptors are added only if you affirmatively include them.

-noTransaction

If you use this argument, this operation won’t be wrapped in a transaction. Using a transaction for large operations can run into database limitations on transaction sizes and numbers of permitted row-level locks.

-import <file>

Imports XML definitions from a file created with the –export or –export all arguments.

-debug

Outputs additional logging information. This option is equivalent to setting the loggingDebug property to true for the repository.

-encoding <encoding>

If the content you are exporting contains non-ASCII characters, use this option to specify an encoding such as 8859_1 or SJIS in which to save your content.

<file names>

The file names of the XML files to parse.