|Fileshare on Novell NetWare||Introduction to Relational Database Handling|
Fsview is a data tool which enables you to view and manage Fileshare servers remotely.
Fsview is not available on UNIX systems.
Fsview enables you to view data and statistics produced by Fileshare and monitor user activity on Fileshare servers from the windows displayed on your screen.
If you want
supervisor access to Fileshare from Fsview, you need to add the
to the fileshare password file. Then, when you start Fileshare,
start it with the
/pf option on the command line. If "FSVIEW"
is the only entry in the password file, all other Fileshare security is
not enabled. See the section Password File Maintenance in the
chapter Fileshare for further details.
You can also automate some of Fsview's supervisor functions using Fileshare Manager. See the section Fileshare Manager later in this chapter for further information.
Before invoking Fsview, you need to set Fsview to use the same communications protocol as the Fileshare servers it talks to.
DOS, Windows and OS/2:
For example, on DOS, Windows and OS/2 if you wanted to set Fsview to use the IPX protocol, create a Fileshare Client configuration file, fhredir.cfg containing the line:
To invoke Fsview from the system prompt, enter:
||is the program-name for the system component to be invoked, in this case Fsview:|
|Character Emulation||Windows||Presentation Manager|
||(OS/2 & NT)
When you first invoke Fsview, a window is displayed, prompting you to enter the name of the Fileshare server you want to monitor (see Figure 22-1).
This must be the same name you specified with the /s option in the Fileshare Server configuration file when you started that Fileshare server (see the section Fileshare Server Configuration in the chapter Fileshare for details of Fileshare options).
If, at this stage, you want to exit Fsview, select Cancel.
Figure 22-1: Fsview Monitor prompt
If the Fileshare server you want to access has Fileshare security enabled, you are also prompted to enter your user-ID and password. After you have logged on to the fileshare server successfully, the Fileshare Server Monitor window is displayed as shown in Figure 22-2.
Figure 22-2: Fileshare Server Monitor window
The Fileshare Server Monitor window displays:
The information displayed in this window is updated periodically by Fsview.
In the Fileshare Server Monitor window, there are four pulldown menu options: Control, Information, Options, and Help. These are discussed in the following sections.
From the Control pulldown menu, you can select a different Fileshare server to monitor, logon as a supervisor, shut down a server (if you have supervisor access), and exit from Fsview.
The Change Server option enables you to select and monitor a different Fileshare server.
To use Fsview's supervisor mode functions, you must enter the supervisor password for the server.
The Supervisor Password option is available only when Fileshare has been started using a password file . See the section Password File Maintenance in the chapter Fileshare for further details on password logon.
Note: Fileshare passwords are case-sensitive.
When you have supervisor access with Fsview, you can:
You can also automate some of these functions using Fileshare Manager. See the section Fileshare Manager later in this chapter.
The Shutdown option enables you to remotely shut down the Fileshare Server that you are currently monitoring. It is only available if you have supervisor access and you are asked to confirm that this is what you want to do. The Fileshare Server is shut down only after you exit Fsview.
The Exit button on the Control pull down menu enables you to exit Fsview. If you previously selected the Shutdown option, the Fileshare server you are monitoring will shut down only after you select Exit.
From the Information pulldown menu, you can monitor the recovery log file, view database information, monitor currently logged on users, monitor open files, and monitor network communications statistics.
The Log File option displays information regarding the Fileshare recovery log file . The recovery log file is used to store all file updates made by Fileshare. In the event of a system failure, the recovery log is used to restore any corrupt files to their original state.
The Log File Information window is displayed as shown in Figure 22-3.
Figure 22-3: Log File Information window
The Log File Information window displays:
- The log file filename
- The size in bytes of the log file
- The disk space remaining
- The size of the disk
As Fileshare runs, the log file gradually increases in size, which can cause a shortage of disk space. If you have supervisor access, you can back up the log file (by pressing the Backup button) and then use operating system commands to remove it from the disk, increasing the disk space available to Fileshare.
Note: You can specify the name of the log file and a log file back-up directory in the database reference file. You cannot specify the name of the back-up log file from FSVIEW.
See the section Rollfoward Recovery Logging in the chapter Fileshare for further information on the recovery log.
The Database Info option enables you to view the database reference file, if any, that the Fileshare Server is configured to use (see Figure 22-4).
You can scroll through the Database Information window using the vertical scroll bar. See the section Database Reference File Maintenance in the chapter Fileshare for further information on the database reference file.
Figure 22-4: Database Information window
The Users option displays information regarding the Fileshare Clients currently logged on to the Fileshare server you are monitoring (see Figure 22-5).
Figure 22-5: User Information window
The User Information window displays:
- The number of users logged on
- The peak number of users logged on
- The individual user information
The list box contains all of the information regarding the users currently accessing Fileshare. Each entry is split over two lines. The first line of each entry contains the user number (which is Fileshare's unique number for the user), the number of accesses made by that user and the time the user logged on. The second line contains the logon dates and the last access date for the users.
If the Fileshare Client declared a user name when it connected to the Fileshare Server, that name is displayed here. See the section Fileshare Security - Fileshare Client in the chapter Fileshare for further information.
A number of pushbuttons available on the User Information window:
|Cancel||Exits you from the User window|
|Refresh||Updates the contents of the window|
|List files||Lists the files open by the user currently selected. The files listed are displayed in a window and this also enables you to close any or all of the files opened by a user, should you have supervisor access.|
|Log off||Logs off the currently selected Fileshare Client, closing any files that the client has open. This function is only available if supervisor access is enabled.|
Note: The logged off Fileshare Client receives either a 9/124 or 9/125 error the next time that it attempts to access the Fileshare Server. See the section Additional COBOL Run-time Errors in the chapter Fileshare for more information.
The File Info option displays the files currently opened by the Fileshare server. The File Information window is displayed (see Figure 22-6).
The File Information window displays:
- The number of file opens
- Peak number of file opens
- Individual file information
The list box contains the file information which shows:
A number of pushbuttons are available on the File Information window:
|Refresh||Updates the contents of the screen.|
|List users||Lists the users with the selected file open at present. The users are displayed in a window, which enables you to close the files for any or all of the users displayed, should supervisor access be enabled.|
|Close file||Closes the currently selected file. This is only available when supervisor access is enabled.|
|Cancel||Exits you from the File Information window|
Note: Fileshare Clients attempting to access files that have been closed via FSVIEW receive a file error.
When running a Fileshare server, network errors can occur, such as send failures or communication controller messages.
The Comms Info option displays the number of network errors which have occurred (see Figure 22-7).
Figure 22-7: Communications Information window
The Communications Information window displays:
- The communications protocol in use at the Fileshare Server
- The number of send failures
- The number of too busy messages received
- The number of message timeouts
The Options option enables you to specify either American or European date formats , wherever Fsview displays dates.
The Help option gives you help for Fsview.
You can automate some of Fsview's supervisor mode functions using Fileshare Manager (fsmgr).
This involves writing a COBOL program that calls fsmgr, which then performs the action you require automatically.
fsmgr can be called to perform any of the following four functions:
This is particularly useful in the event of a system crash or power failure, either of which could cause Fileshare client program to terminate without properly disconnecting from Fileshare. If this happens and data files are left open on the Fileshare server, it can prevent automatic disk backups from running and possibly prevent other clients from accessing the files.
fsmgr is called from a COBOL program as follows:
call "fsmgr" using parameter-block
A group item defined as:
||The fsmgr function to execute which can be one of:
1 = backup Fileshare's log file.
||The name of the Fileshare server where the operation is to be directed. This is the name that was used when Fileshare was started.|
||The Fsview supervisor password declared in Fileshare's password file. This is the password which restricts access to some of Fsview's functions to system administrators. See the section Password File Maintenance in the chapter Fileshare for more information on Fileshare password files.|
||Reserved for future use. Must contain binary zeros.|
||Set to reflect the success or type of failure of the call.|
Possible values of
|0||Function completed successfully.|
|1||Communications error. A Fileshare server of the name
|2||File error during initial connection.
To connect to Fileshare, fsmgr opens a file called fsmgr.ctl . This file should not already exist and fsmgr does not actually create it. If it does exist, this status is returned if there is a subsequent error in closing the file.
|3||Invalid password specified in
Ensure that Fileshare is running with a password file and that the
See the section Password File Maintenance in the chapter Fileshare for more information on password files.
|4||Invalid value specified in
|5||No Fileshare log file.
You have attempted to backup Fileshare's log file to a Fileshare server which is not running with a recovery log file.
|6||Function 2 or 3 could not complete.
While attempting to log off all Fileshare's clients (function 3), it
is possible for other clients to log on before the logging off
operation completes. For example, fsmgr has to send a
Fileshare Manager, like Fsview and other Fileshare Client applications, accesses Fileshare servers using Fhredir.
Like other Fileshare Client applications, Fileshare Manager needs to be configured so that it uses the correct communications protocol required to contact the Fileshare Server. You do this by specifying the communications protocol in a Fileshare Client configuration file. See the section Fileshare Client Configuration in the chapter Fileshare for more information on Fileshare Client configuration.
If you want to make an executable from your program which calls fsmgr, you will need to link in similar objects to other applications which access Fileshare. See the chapter Fileshare for more details. In addition, you will need to link in the fileshare manager object file.
DOS, Windows and OS/2:
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 Novell NetWare||Introduction to Relational Database Handling|