Micro Focus Visual COBOL 2.3 Update 2 for Eclipse (Windows) > Programming > Data Access > File Handling > Fileshare Guide > Advanced Operation > Running Fileshare as a Background Process

Running Fileshare as a Background Process

Note: This process is applicable to Fileshare Servers on UNIX only.

The Fileshare Server uses the Enhanced Accept/Display syntax (Adis module) for its screen displays and keyboard handling. Consequently, the Fileshare Server uses much more processor time if you start it as a background UNIX process. To avoid this overhead, you should configure the Fileshare Server using the -b option. This disables all Fileshare displays and keyboard reading.

Since Fileshare does not read the keyboard in background mode, you cannot close it down in the normal manner using the Esc key sequence.

CAUTION:

Do not kill the Fileshare process because this results in the corruption of any data files which are open.

Because you can only shut down the Fileshare Server remotely, the Fileshare Server must have been configured to use a password file. See Password File Maintenance in the Security section for details.

There are three methods you can use to shut down the Fileshare Server remotely:

Use the FSVIEW commands server set, admin password and server shutdown to identify the Fileshare Server, provide the admin password, and request shutdown. The server will only shut down when you have terminated the FSVIEW session using the exit command.
Use the supplied utility cobfsclose. The cobfsclose utility prompts you for the name of the Fileshare Server you want to shut down, the admin password, and the CCI protocol. Once these have been entered, the shutdown command will be passed to the server via calls to Fileshare Manager.
Write a program that calls Fileshare Manager, and issues the appropriate commands. Refer to the Fileshare Manager topic for details.

The Fileshare Server does not start in background mode unless you start it with a password file.

In background mode, any messages the Fileshare Server would normally display on the screen are written to the file fsscreen.lst in the Fileshare Server's current directory.

An example configuration file follows.

-s server-1
-pf password.fil
-cm ccitcp

This configuration file specifies:

Fileshare Server name is server-1
Password file is password.fil
Communications protocol to use is CCITCP
-b option invokes running in background mode

On UNIX, you can now start the Fileshare Server in background mode by entering:

fs -b > server-1.log 2>&1 &

On some UNIX systems, output can be sent to the terminal after it has been disconnected. When this happens the entire session terminates. Consequently, you need to redirect the output from the command.