Use the qptool report
command to pull information from the Place Catalog to generate reports about places. You can use this command on a place created prior to the current version of IBM® Lotus® Quickr™ only if you first use the qptool upgrade
command to upgrade the place.
About this task
Using the report command, you can retrieve the following information from the Place Catalog about places:
- Server name
- Date last accessed
- Date last modified
- Locked state
Using the report command, you can perform the following policy operations:
- Retrieve a list of places based on the assigned policy criteria
- Execute policy actions on places with specific policy criteria
can gather information from all servers in a cluster. However, if the results of the report command are supplied as input to another qptool
command, the other command only acts immediately on the places on the server from which you issue the command.
Note that although the Place Catalog lists the Readers, Authors, and Managers of places you cannot use the report command to generate this information in a report.
- Make sure the Place Catalog is full-text indexed. For information, see Domino Administrator Help.
- Enter the following command at the server console to update statistics in the Place Catalog:
load qptool placecatalog -push -a
- (Cluster environment only) Enter the following command at the server console to synchronize place statistics across place documents:
load qptool placecatalog -update
- Enter the following command at the server console:
load qptool report arguments
are described in Table 1
Table 1. qptool report arguments for reporting on places
|-?||Prints help on the command.|
|-a||Generates a report for all places.|
|-q query ||Generates a report on places that match the criteria specified in a full-text query. In a query, you refine a search by using operators in conjunction with any of the fields in the Place Catalog.|
For example, you can generate a report on all places last accessed before a specified date.
Enclose a field specified in a query within brackets [ ]. For information on using operators to refine a search, see Notes Help.
|-p place(s) ||Generates a report for a specified place or a space-separated list of places.|
|-o outputfilename ||XML output file that logs the results of the command. By default the command logs results to qptool.report.xml in the server program directory.|
|-policy||Generates a report on places that match the policy criteria assigned to the place.|
|-policyexecute||Executes the policy actions assigned to a place and generates a report of the results.|
Table 2. Examples of reporting on places
|Report on a specific place|
load qptool report -p placename
|Report on all places in the Place Catalog|
load qptool report -a
|Report on all places whose size is greater than 1000 kilobytes|
load qptool report -q [PlaceSize]>1000.
|Report on all places last accessed before 5/30/2006||>load qptool report -q [PlaceLastAccessed]<5/30/2006|
|Report on all places last modified after 5/30/2006|
load qptool report -q [PlaceLastModified]>5/30/2006
|Report on all places and log results to a non-default XML output file qptool.myout.xml|
load qptool report -a -o qptool.myout.xml
Parent topic: Managing places using My Places and qptool commands