PreviousFileshare on Novell NetWare Introduction to Relational Database HandlingNext"

Chapter 22: Fsview

Fsview is a data tool which enables you to view and manage Fileshare servers remotely.

UNIX:
Fsview is not available on UNIX systems.

22.1 Overview

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 user-ID FSVIEW 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.

22.2 Operation

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:

/cm cciipx

To invoke Fsview from the system prompt, enter:

component

where:

component is the program-name for the system component to be invoked, in this case Fsview:
Character Emulation Windows Presentation Manager
(DOS)
(OS/2 & NT)
(DOS)
(OS/2)
xm fsview fsview fsvieww fsviewpm

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.

22.2.1 Control Options

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.

22.2.1.1 Change Server

The Change Server option enables you to select and monitor a different Fileshare server.

22.2.1.2 Supervisor Password

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.

22.2.1.3 Shutdown

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.

22.2.1.4 Exit

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.

22.2.2 Information Option

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.

22.2.2.1 Log File

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.

22.2.2.2 Database Info

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

22.2.2.3 Users

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.


22.2.2.4 File Info

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.


22.2.2.5 Comms Info

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

22.2.3 Options Option

The Options option enables you to specify either American or European date formats , wherever Fsview displays dates.

22.2.4 Help Option

The Help option gives you help for Fsview.

22.3 Fileshare Manager

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:

22.3.1 Call Interface

fsmgr is called from a COBOL program as follows:

call "fsmgr" using parameter-block
Parameters:

parameter-block     A group item defined as:
function-code         pic xx comp-x.
error-status          pic xx comp-x.
fileshare-name        pic x(16).
supervisor-passwd     pic x(20).
reserved              pic x(24).

On entry:

function-code The fsmgr function to execute which can be one of:

1 = backup Fileshare's log file.
2 = close all Fileshare's open data files.
3 = log off all Fileshare's connected clients.
4 = shut down Fileshare.

fileshare-name The name of the Fileshare server where the operation is to be directed. This is the name that was used when Fileshare was started.
supervisor-passwd 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 Reserved for future use. Must contain binary zeros.

On exit:

error-status Set to reflect the success or type of failure of the call.

Possible values of error-status:

Value
Meaning
0 Function completed successfully.
1 Communications error. A Fileshare server of the name specified in fileshare-name could not be contacted on the network using the specified communications protocol. This error is also returned if a network failure occurs during the execution of the function but after the initial connection was made.

Check that fileshare-name is specified correctly and that Fhredir is correctly configured in order that the right communications protocol is used.

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 supervisor-password.

Ensure that Fileshare is running with a password file and that the contents of supervisor-password match the Fsview supervisor password entry in the password file. Note that Fileshare passwords are case sensitive.

See the section Password File Maintenance in the chapter Fileshare for more information on password files.

4 Invalid value specified in function-code. function-code must be in the range 1 through 4.
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 logoff client n request four times if there are four clients logged on. If, however, a new client logs on before all four original clients have been logged off, fsmgr retries the logoff client n request in order to log off the new client. It retries 10 times and if new clients are still logging on, it will return error 6. A similar situation can occur during processing of a function 2 (close all data files) if new files are continuously getting opened at the same time.

10 Other error.

22.3.2 Fileshare Manager Configuration

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.

22.3.3 Linking Fileshare Manager Applications

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: 
fsmgr.obj


Copyright © 1999 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.

PreviousFileshare on Novell NetWare Introduction to Relational Database HandlingNext"