IBM Content Navigator, Version 2.0.3 Supports: CMIS for Content Manager

Managing data in your IBM Content Manager repository

You can use the Browser tool to browse repository content and view item details that might not be easily viewable through applications. You can also use the Browser tool to view, cancel, or unlock any item in the database.

About this task

You can browse repository content in any of the following ways:

From search results
From the list of all libraries
From the library-based mounting mechanism root
From the repository root for hierarchical item types

By using the Browser tool, you can do the following tasks:

View the metadata, states, and IDs
View native data as seen through Content Manager EE native API (DDOs)
View ACL details
Update ACL selections
View any draft that is in the database
Lock and unlock items, or override locks on items
Check in, cancel checkout, or delete draft changes from any user
Delete documents, folders, or all documents and subfolders of a folder
Find all parent folders that contain an item
Identify whether a folder is mapped by a library and list all libraries that are mapped to a folder
Promote a folder to a library (create a library that is mapped to a selected folder) or mount a folder as a library

If saved search is supported by your repository, the Browser tool helps you build a query by using the query builder and gives you an option to save the search. You can also use the Browser tool to run a saved search and to edit the properties of a saved search, such as title, name, or description.

In an interactive mode, the tool prompts you for all required options. You can also run the tool in a silent mode by specifying the options and values. You can use either the single character or the full name of the option.

To display a list of available options, enter java com.ibm.content.cm.tools.Browser -? or java com.ibm.content.cm.tools.Browser -help.

Procedure

To run the Browser tool:

Run the Java command with the following format: java com.ibm.content.cm.tools.Browser -options values.

Use the following command options for the Browser tool:

r or repository: The Content Manager EE database name or the alias name.
u or user: The Content Manager EE user ID that you use to log in.
p or password: The Content Manager EE password that you use to log in.
o or options: The Content Manager EE connection options that you can use to connect to Content Manager EE. For more information about connection options, see the DKDatastoreICM::connect() method or the SConnectDisconnectICM.java sample.
q or query: The Content Manager EE query expression.
s or show: Filter results to display only documents, folders, or all items.
m or max: The maximum number of results. You can specify a maximum number of results instead of using the configuration parameter setting in cmpathservice.properties file. When you open folders, this setting does not override the configuration setting for maximum number of child components.
t or timeout: Timeout in seconds. You can specify a search timeout instead of using the existing configuration parameter setting in cmpathservice.properties file.
v or validate: Enable step-by-step validation in the interactive query builder. The query is always validated at confirmation, but you can validate the query as you enter it and see the current results count. The value can be either true or false. The default value is false. When you use the interactive query builder to build queries, you can manually toggle this option.
z or throwExc: The exception message. The value can be either true or false. The default value is false.

Example

The following code sample shows how to run the tool in an interactive mode:

Operating system	Code sample
Linux or UNIX systems	`./configure-repository.sh Browser`
Windows	`configure-repository.bat Browser`

The following code sample shows how to run the tool in a silent mode by specifying all options. You must enter the command in one line.

java com.ibm.content.cm.tools.Browser -r icmnlsdb -u icmadmin -p password
 -o SCHEMA=ICMADMIN -query "/MyItemType [@myAttr=\"abc\" OR @myAttr=\"def\"]" -m 500
 -t 90 -s all

Important: Follow these guidelines for query strings:

Use double quotation marks to surround a value with spaces. The double quotation marks are removed from the actual value.
If your query string contains double quotation marks, use \" where you want " to appear.