| Fileshare on UNIX | Error Handling | |
The Fileshare Client(s) and Fileshare Server(s) communicate using the Common Communications Interface (CCI).
A Fileshare Server can use several communication protocols concurrently, enabling it to communicate with a number of Fileshare Clients that do not all use the same protocol.
When you invoke a Fileshare Server, you need to specify the
communications protocols it supports, using the /cm
option in the Fileshare configuration file. Valid values for
/cm are:
Windows:
ccitcp
ccinetb
cciipx
UNIX:
ccitcp
ccinampu
UNIX:
When running the Fileshare Server and Fileshare Client on the same
UNIX machine, use the Named Pipes protocol for UNIX (CCINAMPU) as this
provides significantly better performance than CCITCP.
Fileshare defaults to the TCP/IP (CCITCP) protocol. When using CCITCP, you can use either CCITCP Direct or the following process:
If you do not set the environment variable, CCITCP assumes that ccitcp2 is running on the local machine. The Fileshare Client and the Fileshare Server must register with the same ccitcp2 process in order to communicate with each other.
For example, consider the situation where the Fileshare Server and the Fileshare Client are running on different machines and the ccitcp2 process is running on the same machine as the Fileshare Server. The environment variable CCITCP2 does not have to be set on the machine running the Fileshare Server. However, it must be set (on the machine running the Fileshare Client) to the TCP/IP host name of the machine where the Fileshare Server (and the ccitcp2 process) is running.
For details of TCP/IP, please refer to:
For details of CCITCP Direct, please refer to your online book:
CCI Trace enables all the messages sent by CCI to be logged to a file. This can help in tracking down and debugging problems related to communications. To activate CCI Trace, add the following to the Fileshare Server configuration file:
/tr cci
To prevent unauthorized access to the CCI Trace information, you are prompted for the supervisor password when you invoke a Fileshare Server with CCI Trace enabled. If the password is accepted, CCI Trace is enabled and a second prompt asks if CCI Trace should be activated immediately or not.
Note: The supervisor password is that specified for the user-ID FSVIEW in the password file, so you must specify the appropriate password file when you start the Fileshare Server.
CCI Trace can be toggled on and off using the F3 key.
The CCI trace options are specified via the CCITRACE environment variable.
By default, CCI waits 120 seconds for a network request to complete before it times it out and returns an error. If a network request has not completed in a period much shorter than this, it can usually be assumed that it is unnecessary to wait any longer. For example, if a Fileshare Server with the correct server-name is not active when a Fileshare Client attempts its first open, the application appears to hang for 120 seconds before a 9/124 status is returned because the server cannot be contacted. See the section Communications Errors in the chapter Error Handling for more details.
You
can configure the Fileshare Client to use a shorter timeout period by
using the /ct option in the client configuration file, fhredir.cfg.
The timeout period is specified in 1/10th seconds.
For example:
/ct 300
This instructs the Fileshare Client to specify that CCI waits for 30 seconds for network requests to complete. After this time it returns a 9/124 status to the application program.
Copyright © 1999 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names
used herein are protected by international law.
| Fileshare on UNIX | Error Handling | |