FileNet Report Manager 4.1 Fix Pack Readme: RM-4.0.1-030
© Copyright IBM Corporation 2008. All Rights Reserved.

Contents

About this Fix Pack

Product Compatibility

New in this Fix Pack

Installation, migration, upgrade and configuration

Support Documentation

Requirements

Installation Instructions

Uninstall this Fix Pack

Known limitations, problems and workarounds

Product Fix History

Contact Customer Support

Notices and Trademarks

 

About this Fix Pack

This document provides information about the fixes, features, requirements, and certifications available for Report Manager 4.1 and the steps to install them. 

Note: IBM is currently migrating the contents of the IBM Customer Service and Support web site for FileNet customers to a new location. If you click on a documentation link after the migration is complete, you will be redirected to an information page. Follow the instructions to reach the new product documentation download web site.

Product Compatibility

New in this Fix Pack

In this Fix Pack, doc IDs more than 2 billion(2^31 - 1) and up to 4 billion ( 2^32 - 1) have been supported. Please note that from the IDM client, docIDs with more than 2 billion have not been supported yet.

Installation, migration, upgrade and configuration

Support Documentation

You can find a copy of the latest Report Manager Documentation and the Report Manager Documentation packages and the Report Manager 4.1 Installation Guide on the IBM Customer Service and Support web site for FileNet customers.

You will need an IBM-issued login name and password to access the web site.

Requirements

See the FileNet Report Manager Compatibility & Dependency Matrix for information on requirements and supported service packs.

Certifications As of Report Manager 4.1 Fix Pack 5, MSSQL Server 2000 with SP2 is supported. As of Report Manager 4.1 Fix Pack 7, IDM 3.2 Desktop and WebServices are supported. As of Report Manager 4.1 Fix Pack 11, MSSQL Server 2000 with SP3 is supported. As of Report Manager 4.1 Fix Pack 13, MSSQL Server 7.0 with SP4 is supported. As of Report Manager 4.1- Fix Pack 15, a new API is supported which enhances the performance of bulk INX records deletion. As of Report Manager 4.1 Fix Pack 18, IDM 3.2b Desktop and WebServices are supported. As of Report Manager 4.1 Fix Pack 21, AFP2PDF v5.3 and Meta2PDF v5.3 are supported. As of Report Manager 4.1 Fix Pack 22, Adobe Acrobat 6.x is supported. As of Report Manager 4.1 Fix Pack 25, IS 4.0 with DB2 is supported for cross cataloging of documents. As of Report Manager 4.1 Fix Pack 25, IS 4.0 with DB2 is supported for cross cataloging of documents. As of Report Manager 4.1 Fix Pack 26, this Fix Pack contains the updated WAL 3.6 modules. As of Report Manager 4.1 Fix Pack 26, IS 4.0 with SP3 is supported. As of Report Manager 4.1 Fix Pack 26, ISTK 4.0 with SP3 is supported. As of Report Manager 4.1 Fix Pack 26, MSSQL Server 2000 with SP4 is supported. As of Report Manager 4.1 Fix Pack 27, AFP2PDF v5.4 and Meta2PDF v5.4 are supported. As of Report Manager 4.1 Fix Pack 29, AFP2PDF v5.4.1 (a2pd.dll) and Meta2PDF v5.4.1 (m2pd.dll) are supported. As of Report Manager 4.1 Fix Pack 29, MSSQL Server 2005 is supported. As of Report Manager 4.1 Fix Pack 29, Windows Server 2003 R2 Standard and Enterprise editions are supported. As of Report Manager 4.1 Fix Pack 29, IS 4.1 SP1 is supported

Installation Instructions

1. Backup the existing product directories prior to installation of fixes. 
2. Copy the self-extracting executable (RM41-30.exe) to a temporary directory.
3. Stop all Report Manager Services if they are running.
4. Execute RM41-30.exe. This will extract the necessary setup files in a 'Client' directory and a 'Server' directory. Execute setup.exe from the appropriate directory and accept all default options to automatically upgrade your client or server machines.
5. A log can be found in the Windows directory after the installation of each software fix pack. The log file for the client is prmdinst.log. The log file for the server is prmsinst.log.

Uninstall this Fix Pack

Once this Fix Pack is installed, the process cannot be reversed.

Known limitations, problems and workarounds

Image Services

As of the release of RM 4.1-015 software fix pack, you may see this warning message in the event log on your FileNet Image Services system:

90,1,13 INXs [PID=1772 TID=2104] ...
INXs parse_call: unknown procedure number = 87

To resolve this issue, install SCR 171065 on your FileNet Image Services system. Installing the SCR will enhance the performance of the Report Manager Index Purge process.

We have applied the Microsoft recommended fix for the 8-byte boundary issue in RM-4.1-008 fix pack. This has partially resolved the problem; however you may occasionally see the 8-byte boundary warnings. These warnings should not affect Report Manager Functionality or data integrity in any way.

Conversion Utility

As of Report Manager 4.1 Fix Pack 22, a new parameter is provided for the background operation of the Conversion utility. Please refer to DTS 95107 under the Resolved STRs and DTSs section below. /r is the new retry parameter. An integer following this parameter specifies the number of times Conversion will retry to open the input file before an error message will be displayed. The conversion utility waits 60 seconds between each retry, and the default, if this parameter is omitted, is 10.

Desktop/OLE Automation Interface Commands

New OLE Automation Functions:

CopyDocTemplate

DeleteDocTemplate

EditDocTemplateFileSpec

GetDocTemplateFileSpecName

Desktop/OLE Call

The SearchIndexSQL OLE call uses the setting "MaxQueryHits" under the [CUSTOM] heading in the PRMDSK32.INI file. This setting can be done manually, or by running the Index Search dialog in the Desktop and setting the "Maximum Query Hits" parameter in the edit box. The number of items will be defaulted to 200 if the “MaxQueryHits” setting is 0 or less.

Note: Since this parameter is used by both the Desktop Index Search dialog and the OLE call, changing the setting via the dialog will affect any OLE program and vice versa. Thus, it is recommended that any OLE application should always verify the setting and change it if necessary.

Desktop/Form Overlay

Added a new section to the "Configure Background" dialog. The new edit field is "Text Offset | Column Offset". Enter a value in this field and every text row will have extra blank characters added to the beginning of the line. The purpose of this field is to aid in aligning form overlays with the text of a report.

The font typeface used when setting up a form overlay is now part of the information saved. When a document is opened with a form overlay, and if the typeface was saved, the font for the report will be set to the saved typeface. If not saved, the default system font is used.

Defining Document Layouts

Report Manager treats all Page fields as though they are part of the Detail section. In the absence of a Detail section, fields in the Group Header will be used. In the absence of a Detail section and a Group Header, fields in the Page Header will be used.

Traffic Service

Add the following to the prm_ts.ini file:

[CUSTOM]
RowsReturned=XXX

If XXX=0 or if the key is not present, then the number of rows returned defaults to 16255.

If XXX>64,000 then the number of Rows returned is set to 64,000 which is the maximum limit.

This setting affects the number of items that are listed when a folder is opened through Report Manager Desktop. The setting will affect all of the Report Manager Desktop clients that are connecting to the RM Traffic service.

Storage Service/Channel Mapping

Add the following to the Prm_ss.INI file:

[Channel Map]
Convert Nulls = 1 (default)

if Convert Nulls = 1, then nulls will be replaced with a space (0x20).
if Convert Nulls = 0, then Storage Service will stop loading the file and reports an error to the event log when it encounters null characters.

Storage Service/Loading Files

Loading Multiple Statements

When multiple statement documents are loaded with multiple processes a unique stmtLog.outX file will be created for each statement being loaded. 

When the Fix Pack is installed the following entry will automatically be added to the prm_ss.ini file.

[PDF]
Statement File = [Same path as the 'Report File' entry]\StmtLog.out

The StmtLog.out files are created when statement files are created. The StmtLog.out files have the same format as report.out files. 

Loading Bad Files

When a file fails to load properly, Storage Service will now, by default, continue to load other files in it's file list. In previous versions if a file failed to load properly all file processing stopped. If the user wants all file processing to halt when a file cannot be loaded they can add the following to the prm_ss.ini file:

[Configuration]
Stop On Bad File = 1

Storage Service/Form Feeds

Add the following to the prm_ss.ini file:

[Configuration]
InsertFF = 1

If InsertFF is set to 1 and no form feeds are found in the data stream then form-feeds will be inserted after every 66 lines. If InsertFF is set to any other value or is absent (the default behavior) then if no form feeds are found a form-feed WILL NOT be inserted IF the file is smaller than the maximum size of a single page. This is to handle cases in which each report file contains only a single page and that page contains more then 66 lines. 

The parameter is added as a way to distinguish between small files that contain more than a single page and small files that only contain one single page. Thus it should only be used in cases where the data file is small but contains more than a single page and it is desirable to add page breaks after every 66 lines.

Storage Service/Rollover

Delete empty archive files

Added the following to the prm_ss.ini file:

[SYSTEM]
DeleteArchiveWithNoDoc=0 (default)

if DeleteArchiveWithNoDoc=1 then empty archive files will be deleted
if DeleteArchiveWithNoDoc=0 then empty archive files will not be deleted for either setting and an entry will be made in the Event log.

Product Fix History

The following abbreviations are used:

• ECMDB # ECM Defect Number
• RM Report Manager
• STR # Software Trouble Report Number

The following tables list the product fixes available for Report Manager 4.1:

RM 4.1-030

RM 4.1-029

RM 4.1-028

RM 4.1-026

RM 4.1-025

RM 4.1-024

RM 4.1-023

RM 4.1-022

RM 4.1-021

RM 4.1-020

RM 4.1-019

RM 4.1-018

RM 4.1-017

RM 4.1-015

RM 4.1-014

RM 4.1-013

RM 4.1-012

RM 4.1-011

RM 4.1-010

RM 4.1-009

RM 4.1-007

RM 4.1-006

RM 4.1-005

RM 4.1-004

RM 4.1-003

RM-4.1-002 Fix Pack does not exist 

RM 4.1-001

Contact Customer Support

For information about contacting customer support, see the IBM Customer Service and Support web site for FileNet customers. You will need an IBM-issued login name and password to access the web site.

Notices and Trademarks

• IBM is a registered trademark of International Business Machines Corporation in the United States, other countries, or both.
• Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.
• Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.
• Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
• Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
• Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.
• UNIX is a registered trademark of The Open Group in the United States and other countries.
• Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
• ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office.
• IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency, which is now part of the Office of Government Commerce.
• Other company, product, or service names may be trademarks or service marks of others.