VISTA Plus for MPE Administrator's Guide

Managing Reports
5-13
Re-indexing Reports
When you change search indices or page security for a report after the report has been saved in a
folder, you need to rebuild the indices to implement the changes. Rebuilding indices implements
index search options and page security. A couple of examples where this is necessary are when you
create a Logical View with Page Security for a new user, or add search keys to a report.
Since VISTA references external tables to determine index values, the tables need to be established
prior to viewing reports with indices. If you don’t index a report with page security, then it might
be possible for a user to view report pages that they have not been authorized to view. Indexing a
report when the report is captured occurs automatically when the INDEX option is specified using
the VSAVE command. Re-indexing a report requires that you execute VISTA with the
INDEXREPORT entry point and know which folders contain the report to re-index.
An entry point named INDEXREPORT within the VISTA program is available to rebuild search
indices and page table indices. Page table indices define page security and search indices reflect
indexing of search values within a report.
To rebuild indices, execute VISTA with the entry point of INDEXREPORT and a PARM value of
101. The PARM value specifies that you want to rebuild indices. You also must specify the folder
file to index with the INFO string. For example:
RUN VISTA,INDEXREPORT;PARM=101;INFO=“BANNER.ARCHIVE”
The program will prompt you to enter the report name to re-index. This will occur when re-
indexing search indices and page table indices. If you decide not to rebuild either one of these, then
press Enter when prompted for input. You can also enter a wild card (@) to rebuild all indices for
all reports.
When a report name is entered and a matching report name is found within the folder, the specified
indices are built. A message tells you when the indices are being created. For example:
RUN VISTA,INDEXREPORT;PARM=101;INFO=“BANNER.ARCHIVE”
Enter Report Name to rebuild search indices: BANREP03
Building Search Indices for report BANREP03
Enter Report Name to rebuild page index tables: BANREP03
Enter User Name (Session,User.Account) to rebuild: MENDOZA,MGR.NETBASE
Building Page Index Tables for report: BANREP03
Total Pages Extracted for MENDOZA,MGR.NETBASE = 5
Total Pages Extracted for MGR.NETBASE = 20