Standard Operation | Database Integrity |
This chapter describes how to configure your Fileshare Client and Fileshare Server.
This section describes all of the available Fileshare Client configuration options. These options can appear as many times as necessary within a Fileshare Client configuration file, and in any order, but only one option can be specified per line.
Notes:
/cm CCI-protocol
Specifies the default communications protocol for this Fileshare Client. Valid values for CCI-protocol are listed below.
/cm CCI-protocol /s server-name
Specifies the communications protocol to use when contacting the Fileshare Server, server-name. Valid values for CCI-protocol are listed below.
/f filename /s server-name
Specifies that the data file filename is a remote file on the Fileshare Server named server-name. Repeat this option for every data file you want assigned to a specific Fileshare Server that is not the default Fileshare Server. Valid values for filename and server-name are listed below.
/f filename
Specifies that filename is a local data file held on the workstation where the Fileshare Client resides. Valid values for filename are listed below.
/s server-name
Specifies server-name as a default Fileshare Server.
Accesses to data files not directed to a particular Fileshare Server or defined as local data files are directed to the default Fileshare Servers. The order in which the default Fileshare Servers are defined in the Fileshare Client configuration file is the order in which the Fileshare Client contacts each Fileshare Server in an attempt to locate the file.
If the data file is not found on any Fileshare Server, the request for that data file is directed to the first default Fileshare Server listed in the configuration file.
Valid values for options in the Fileshare Client configuration file are:
CCI-protocol |
Windows: ccitcp cciipx ccinetb cciappc UNIX: ccitcp ccinampu |
server-name |
Any character string up to 16 characters long depending on the
CCI protocol you are using. The Fileshare Client configuration file can contain
a maximum of 16 unique Fileshare Server names. |
filename |
Any valid filename that is supported by the operating system. Filenames cannot contain embedded space characters. You can use terminating wildcard characters in filename to designate groups of files. For example, use /f \accounts\* to specify all files starting with the string \accounts\. |
This example shows a typical Fileshare Client configuration file.
/s server1 /s server2 /cm cciipx /f \orders\* /s server3 /cm ccitcp /s server3 /f \accounts\payroll.dat /f \transport\delivery\*
where:
Line 1:
/s server1
Specifies that server1 is one of the default Fileshare Servers.
This Fileshare Server is searched for any file that is not defined as being on a particular Fileshare Server (see Line 4) or as local (see Lines 6 - 7). If you specify more than one default Fileshare Server (see Line 2), the Fileshare Servers are searched in the order that you have defined them in the configuration file. In this example, server1 is searched before server2.
Line 2:
/s server2
Specifies that server2 is also a default Fileshare Server. If you access a file that you have not defined to be on a particular Fileshare Server (see line 4) or as local (see lines 6 and 7), this Fileshare Server is searched after the Fileshare Server server1.
Line 3:
/cm cciipx
Specifies that the default communications protocol is CCIIPX. When the Fileshare Client tries to contact a Fileshare Server that does not have a specific CCI protocol defined (see Lines 1 and 2), this is the one used.
Line 4:
/f \orders\* /s server3
Specifies that FHRedir should direct all accesses to files with a name beginning with the string \orders\ to the Fileshare Server named server3.
Line 5:
/cm ccitcp /s server3
Specifies that the communications protocol to use when communicating with the Fileshare Server, server3 is ccitcp. This overrides any default CCI protocol specified in the Fileshare Client configuration file (see Line 3).
Line 6:
/f \accounts\payroll.dat
Specifies that the file \accounts\payroll.dat is a local file on the Fileshare Client machine. The Fileshare Client accesses this file using a local copy of the Callable File Handler.
Line 7:
/f \transport\delivery\*
Specifies that any files with a filename beginning with the string \transport\delivery\ are local files.
This section describes all of the available Fileshare Server configuration options. The /s option that defines the server-name is compulsory. All other options are optional or have default values that are specified below.
Notes:
/s server-name
Specifies the name that the Fileshare Server registers on the network. This must be a character string, up to 16 characters in length depending on the CCI protocol that you are using. The name specified must be unique. If a Fileshare Server with the same name is already registered on the network, an error is returned.
/d database-reference-file
Specifies the name of the database reference file that the Fileshare Server is to use. The database reference file is used to determine which additional Fileshare features you want to use. See the section Database Reference File Maintenance in the Database Integrity chapter.
/t timeout-period
Sets the record lock timeout period after which the Fileshare Server releases all record locks held by a Fileshare Client and rolls back any outstanding transactions. The timeout period is specified in seconds. The default value is 60 seconds. Specifying a value of 0 disables the timeout and record locks are only released under the control of your application program. Valid values are 0 - 99999. The timeout only occurs if another Fileshare Client requests a record currently locked by this Fileshare Client. See the section Automatic Record Lock Timeout in the Database Integrity chapter.
/m record-size
Specifies the maximum record size that can be processed by the Fileshare Server. Setting a lower value than the default value reduces the amount of memory that the Fileshare Server needs to run. The record-size is specified in kilobytes. Valid values are 16 - 64. If you specify a value less than 16, the Fileshare Server uses a buffer size of 16K. If you specify a value greater than 64, the Fileshare Server uses a buffer size of 64K.
/cm cci-protocol
Specifies the CCI protocols that the Fileshare Server can use. Repeat this option for every communications protocol that you want to use to contact this Fileshare Server. Valid values for cci-protocol are:
Windows:
ccinetb
ccitcp
cciipx
UNIX:
ccitcp
ccinampu
/pf password-file
Specifies the name of the password file that the Fileshare Server uses. See the chapter Security for details.
/tr f
Activates the Fileshare Server trace option on start-up. Trace messages are written to the screen and to a file called fsscreen.lst in the Fileshare Server's current directory. This option seriously impacts the Fileshare Server's performance so you should only use it for problem investigation. See the section Monitoring Fileshare in the Advanced Operation chapter.
/wd working-directory
Specifies the directory that the Fileshare Server changes to on start-up. This option is only relevant if you are running the Fileshare Server as a background service on Windows NT. See the section Running Fileshare as a Windows NT Service in the Advanced Operation chapter.
UNIX:
-b working-directory
Specifies that the Fileshare Server is to run as a background process. See the chapter Fileshare on UNIX for more details.
This example shows a typical Fileshare Server configuration file.
/s mainsrv /cm cciipx /d dbase1.ref /t 120 /pf \pass\passwd.fil
where:
Line 1:
/s mainsrv
Specifies that the Fileshare Server is to register its name on the network as mainsrv. Fileshare Clients must specify this name when they want to contact this Fileshare Server.
Line 2:
/cm cciipx
Specifies that cciipx is one of the communications protocols that a Fileshare Client can use to contact this Fileshare Server.
Line 3:
/d dbase1.ref
Specifies that the database reference file the Fileshare Server is to use is named dbase1.ref.
Line 4:
/t 120
Specifies that the automatic record lock timeout period is 120 seconds.
Line 5:
/pf \pass\passwd.fil
Specifies that the Fileshare Password Security feature is enabled and that the password file (containing valid user-IDs and passwords) is \pass\passwd.fil.
Copyright © 1998 Micro Focus Limited. All rights reserved.
This document and the proprietary marks and names
used herein are protected by international law.
Standard Operation | Database Integrity |