The OECATALOG utility is used to administer a master catalog. You might use this command-line utility as part of the build process on the server hosting a source code management system. You can use the utility in a batch script or shell script on Windows, UNIX, and Linux platforms.
The catalog definitions file, usually called catalog.xml.
<catalog-name>
The name of a specific definition in the definitions file.
<root-path>
The root path of a project in the catalog.
<new-path>
The new root path where the project has been moved.
<resource-path>
The path, either absolute or relative to the -root, where the resource that you want to scan exists.
<project>
The project that you want to scan.
<content-type>
is the content type (ANNOTATION, APPSCHEMA, or ABLREFERENCE) for a content builder that you want to use on the resource.
Use spaces, not commas, to delimit multiple arguments for an option.
Use double quotes ( " ) to escape spaces in paths.
You must specify the -catalog and the -root option, and specify either the -set or the -build option.
The -set option is used to change root paths in the catalog database.
The -build option is used to update content in the catalog database.
The -resource, -project, and -type options are optional.
You can specify the -set, -build, -catalog, -root, -resource, -project in any order.
You can specify multiple root paths. The projects are assumed to be the directories at the root path location.
The -resource and -project options are equivalent if a relative path is used. The -project option can validate that the parameters are valid project names.
If -resource or -project are not specified, then all the projects associated with the catalog in the definition file are processed.
If -type is not specified, all the content builders associated with a catalog is used.
When the -type option is specified, it overrides the association of content builders with the catalog. Since the -project and -resource option are equivalent, and it is similar to doing Meta Catalog > Add from within Progress Developer Studio for OpenEdge, a project or resource is added to a catalog only if the project is associated with the catalog.
If you do not supply the full path in the -catalog option, the utility looks for the file in the local directory.
Examples
The following command would add content using all the content builders from all resources in C:\wrk and its subdirectories to all catalogs defined in the catalog definition file:
Note: Because of the way Windows batch files handle equal signs ( = ), you should enclose any argument that contains an equal sign in double quotes ( " ).
Use spaces, not commas, to delimit multiple arguments for an option.