FileNet Image Services: Technical background and steps to configure SAS time-out value

Content

In an unstable network environment,  existing ISTK connections may become unusable.  This can cause the FileNet Image Services software to abandon the existing ISTK connection and start a new connection. An error 71,0,2 is also logged at the same time. The default SAS behavior waits 30 seconds before re-establishing a new connection with the client.  The client station will appear to be frozen during this time.

Starting in FileNet Image Services 4.1.2 FP8, a new feature has been added to make the SAS time-out value configurable. This enhancement is intended to reduce the client wait time.

To change the SAS time-out value from the default 30 seconds, create a file named:


UNIX: /fnsw/local/trigger/sasopentimeout,
Windows: DRIVE:\fnsw_local\trigger\sasopentimeout


The number of seconds must be inserted in the file. The valid value can range from 2 to 40. If the number of seconds entered in to the file is less than 2, a value of 30 seconds is used. If the number of seconds entered in the file is greater than 40 seconds, a value of 40 seconds is used

Since every customer environment differs, the value the trigger file can be different. IBM suggests that if the problem exists on the server, the System Administrator reduce the value incrementally by 5 to 10 seconds until the desired time-out value has been reached.

For the change to occur, the FileNet Image Services software must be recycled. When the software is started, an informational message is written to the event log, even when the trigger file has not been created.


2010/07/28 23:04:04.077 71,0,7 <fnsw> ds_init (1269906.1.28 0x136092.1) ... [INFO]
SAS init X_sasopentimeout: 30 initialized from '/fnsw/local/trigger/sasopentimeout'


The number of seconds in the informational message reflects the value in the trigger file. The message can be ignored if the trigger file has not been created.