Micro Focus Visual COBOL 2.3 Update 1 for Eclipse (UNIX) > Programming > Data Access > File Handling > Fileshare Guide > Standard Operation > Fileshare Client > Configuring Your Fileshare Client > Fileshare Client Configuration Options

Fileshare Client Configuration Options

This section describes 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.

Note:

The Fileshare Client configuration file can contain a maximum of 16 unique Fileshare Server names
Filenames appearing in the configuration file are case-sensitive unless defined by the /r option (DYNCONFIG), in which case they are not case sensitive when run in Windows
The filename in the configuration file must appear exactly as it will appear to FHRedir on the first OPEN request passed by your program
The Fileshare Server name is folded to uppercase. Note that it may be necessary to use the name in uppercase in some configuration files to ensure name matching works as expected.
UNIX:
- In this section, options are shown starting with a forward slash (/). This is how you specify the options on Windows. On UNIX, use the hyphen (-) character instead of the forward slash.
- Filenames are shown using the Windows file-naming convention. On UNIX, use the UNIX filenaming conventions.

Client Configuration Option	Specifying
/bl	Open a file exclusively to enable blocking, to improve performance.
/cm `CCI-Protocol`	The default communications protocol for this Fileshare Client. Valid values for `CCI-Protocol` are listed in the table below.
/cm `CCI-Protocol` /s `ServerName`	The communications protocol to use when contacting the Fileshare Server, `ServerName`. Valid values for `CCI-Protocol` are listed in the table below.
/ct `CCI-Timeout` `server-name`	The communications timeout period, specified in 1/10th seconds. The default is 1200 (120 seconds). See Configuring the CCI Timeout for more information.
/cr `CCI-Timeout`	The connection retry timeout period, specified in 1/10th seconds. The default is 0. This timeout is only for the initial connection and only applies if the CCI module returns and is out of memory or resources. The client will re-attempt to connect at varying intervals up to the timeout period. However, the default is that the connection is only tried once.
/f `Filename` /r `Custom-File-Handler`	The data file `Filename` is a local file and should be actioned by the custom file handler. Repeat this option for every data file you want assigned to a specific custom file handler that is not the default File Handler. Valid values for `Filename` and `Custom-File-Handler` are listed in the table below. This option only applies if the environment variable DYNREDIR is set to DYNCONFIG.
/f `Filename` /s `ServerName`	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 `ServerName` are listed in the table below.
/f `Filename`	`Filename` is a local data file held on the PC where the Fileshare Client resides. Valid values for `Filename` are listed in the table below.
/s `ServerName`	The `ServerName` as a default Fileshare Server
/um	Micro Focus Common Client (MFCC) shall be used to communicate with the Fileshare server/listener. MFCC can be configured using a mf-client.dat configuration file to automatically connect to servers on remote machines.
/ra	The number of times a client will attempt to reconnect to a Fileshare server if its connection is lost. The default is 0. In a high availability environment fhredir will connect to a new fileshare listener if one becomes available.
/rd	The length of time (in milliseconds) a client will wait between each re-connection attempt (specified by /ra). The default is 0.

Accesses to data files not directed to a particular Fileshare Server or not 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:

Option	Valid Values
`CCI-Protocol`	Windows: TCP IP: `/ccitcp` CCISMEM: `/ccism` UNIX: TCP IP: `-ccitcp`: `ccitcp` UNIX named pipes: `-ccinampu`
`ServerName`	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\".

Option

Valid Values

CCI-Protocol

Windows:

TCP IP: /ccitcp
CCISMEM: /ccism

UNIX:

TCP IP: -ccitcp: ccitcp
UNIX named pipes: -ccinampu

ServerName

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\".