KeyView 23.2

# Persist the Child Process

By default, in out-of-process filtering, the parent process maintains a persistent connection with the child server after each file is filtered. When the connection is preserved in this way, subsequent filtering requests are processed more quickly because the server is already prepared to receive data.

You can restart the server at regular intervals by using a method or a configuration setting.

## In the API

To force KeyView to restart, call the `refreshFilterKVOOP()` method.

    public void refreshFilterKVOOP();

## In the formats.ini File

To control whether Filter persists the server, use the `kvoopRefresh` parameter in the `[FilterSDK_Config]` section of the `formats.ini` file:

`kvoopRefresh=0` | When this is set to 0 (zero), the connection to the server is persisted for as long as the parent process is running or until the server fails. This is the default.
`kvoopRefresh=n` | When this is set to `n`, the connection is persisted for `n` filter requests. After the `n`th request, the server is shutdown and restarted before processing the next request. For example, if `kvooprefresh=5`, the connection to the server is persisted for 5 filter requests. For the 6th request, the server is shutdown and restarted.

To control whether the parent process attempts to filter a file after the file has caused the server to fail, use the `kvoopRetry` parameter in the `[FilterSDK_Config]` section of the `formats.ini` file:

`kvoopRetry=0` | When this is set to 0 and the server fails, the parent process does not resend the file to a new server.
`kvoopRetry=n` | When this is set to `n` (a positive number) and the server fails, the parent process resends the file to a new server `n` times. By default, the `kvoopRetry` is set to `1`, and the file is resent to a server once.

The `formats.ini` file is in the directory `install\OS\bin`, where `install` is the path name of the Filter installation directory and `OS` is the name of the operating system.

NOTE: The `kvoopRefresh` and `kvoopRetry` parameters do not apply when running the File Extraction functions out of process. See Run File Extraction Functions Out of Process.

Copyright 2016-2023 Open Text
Version 23.2 | Last updated March 2023

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL KeyView 23.2

Topic Title: Persist the Child Process