Welcome to TimeVision NS(TM)!

- - - - - -
This Read Me file contains notes on:
* Installation
* Administration
* Windows client application
* DOS client application
* ns:Agent
* Utilities

Installation
============

Under some UNIX workstations using PCNFS version 5.0, running the 
TimeVision NS client install from the server may return an error, 
"Server is unable to copy the installation support file ~INST162.LIB to a 
temporary location." On these systems, run the client workstation 
installation from the original floppy disk shipped with TimeVision NS.

Administration (WNSADMIN.EXE)
=============================

Underscores are not displayed in the list box containing local users in the 
"Names" and "Local Users" menu items. Underscores are displayed 
when adding or changing local users, and in the client application.

TimeVision NS Administration restricts cc:Mail postoffice names to 
20 characters or less.

When importing cc:Mail users into TimeVision NS, any cc:Mail addresses 
longer than 31 characters are filtered out of the selectable list. The 
maximum length of a TimeVision NS display name is 31 characters.

When importing cc:Mail users who have double quotes in their E-mail 
addresses, an error may be returned depending on the location of the 
quotation marks. Single quotation marks do not return the error.
	If the double quotes surround a word in the middle of the address, 
as in Jacob "Jake" Worthington, an error is returned, "Unable to write 
to your link table file. Check that it is not Defined as a read only file". 
If the quotes surround the first word, such as "Jake" Worthington, the 
name imports correctly.
	
When importing NetWare users to a workstation not configured with the 
proper Windows network driver, an error may be reported, "Failed connection 
information". If this occurs, re-load the appropriate Novell NetWare driver 
in Windows Setup in the "Options" and "Change Network Settings" menu items.

When importing NetWare users, the TimeVision NS Administration program 
reads names from the bindery on the server which the executables are located,
as opposed to the default server set in your NET.CFG file or 
at the NetWare login command line.

An optional section can be added to the NSADMIN.INI file allowing 
fine tuning of variables concerning simultaneous database access requests. 
In the NSADMIN.INI file, located in the TVNS\USERS subdirectory, you 
may add the following section:
	[Contention]
	ReadSleep=200
	WriteSleep=250
	Retries=200
If this section is not defined, the client application uses the above
values as default.
	Only one user is allowed to read from or write to the database at a 
time. If activity requests occur while the database is already in use, 
the secondary requests are queued. Requests automatically retry to 
access the database according to the contention settings. ReadSleep 
and WriteSleep each control how long (milliseconds) the request waits 
between attempts to acquire a lock on the database. Retries is the number 
of times the client application tries to acquire a lock before returning a 
message to the user. Using the default settings, the program returns a 
prompt after 40 seconds on a read. TimeVision NS returns a prompt 
after 50 seconds on a write. The prompt returned to the users running 
the client application is, "Couldn't acquire lock on STCAL.LCK. 
TimeVision NS needs to lock the calendar database to prevent access 
during certain operations. It was unable to do so in the normal time allowed. 
This may be caused by the database being very busy at this time, or may 
indicate a network problem. Retry will attempt to lock the database again, 
cancel will abort the pending operation. WARNING: Pressing Cancel may 
result in loss of data."
	In general, smaller, less busy sites may be able to use smaller 
values for all entries. Larger sites may need larger numbers. If 
users do not experience the waiting-for-net cursor (an arrow with 
oscillating crests, much like an EKG blip), no contention is occurring 
and no fine tuning is necessary. If the users occasionally see the 
waiting-for-net cursor but it goes away before the "Can't acquire lock" 
message box appears, contention is occurring but is under control. 
If the users see the "Can't acquire lock" message box frequently, a 
contention setting adjustment may help.
	Increasing all three settings prohibits the occurrence of the 
time-out prompt for a longer period of time. Increasing settings allows
large database activities to finish in time for the queued requests to be 
handled. However, if a real problem situation occurs and an invalid residual 
lock improperly remains, this setting manipulation increases the 
amount of time it takes for the "Can't acquire lock" message to display.
	If users receive frequent time-out messages, but you are concerned 
about increasing the amount it takes for those messages to appear in real 
problem situations, try increasing the number of retries while decreasing 
the WriteSleep settings such that the product of the two is constant (does 
not change from the original of time 50 seconds). For example, 
(Retries=200) x (WriteSleep=250) = (50 sec). 
	Occurrences of residual locks are rare. However, residual lock 
errors are indicative of other problems; something is interrupting the 
TimeVision NS client application on a particular workstation before it is 
able to remove the lock information, such as improperly exiting Windows by 
turning off the machine's power or rebooting. CE recommends not decreasing 
the sleep settings. Doing so increases the risk of contention between 
simultaneous lock requests producing retries.

TimeVision NS with MSMail uses FFAPI and TimeVision NS with cc:Mail 
uses VIM within the Administration program to extract names from the 
postoffice regardless of the ForceFileAPI setting in the NSADMIN.INI file. 
MSMail for Windows does not have to be installed on the TimeVision NS 
Administration workstation unless it is the machine that runs ns:Agent 
with MSMail-MAPI. Since TimeVision NS for cc:Mail includes the VIM API 
software, cc:Mail for Windows does not have to be installed on the 
TimeVision NS Administration workstation. 

TimeVision NS with MSMail Admin no longer displays a DOS full screen session 
or Windowed DOS session when it runs FFAPI to extract mail names. The 
session is minimized in the background and a custom PIF file is used to 
ensure that it executes properly regardless of any _DEFAULT.PIF settings.

Windows client application (WNS3.EXE)
=====================================

The trustee access icon has been removed in the Day Folder. Proposers 
of events must edit the event and select "Save" to save a change to the 
trustee access setting of their own personal instance. This revises all 
attendee's instances of the event, resetting data fields to the proposer's 
values except individual alarm and trustee access settings.

New access rights granted to users do not take affect until the users close 
and re-launch the client application, or use the "Login As New User" feature 
to connect to TimeVision NS.

A display issue may be experienced when using video cards utilizing the 
Cirrus Logic CL-GD5426/GD5428 chip, such as the Boca Research 
SUPERX video card, in conjunction with Windows drivers prior to 
version 1.32. In the TimeVision NS client application's Month Folder, 
the magnified day cell appears filled with a single color or pattern, 
except for the active time interval.
	Obtain the latest video drivers package from the Boca Research BBS, 
version 2.0 or later. A driver included in this package resolved the display 
issue, version 1.43 dated 8/1/94.

Running the TimeVision NS client application or ns:Agent after the 
cc:Mail application has been loaded in Windows may return a VIM Error, 
"General Failure". This occurs if cc:Mail loads an earlier version of the 
MAILENG.DLL file than the latest VIM DLL files supplied by Lotus, 
version 2.07. Be sure to launch TimeVision NS on your workstation before 
running cc:Mail to load the latest MAILENG.DLL into memory, or update 
the MAILENG.DLL file in the CCMAIL executable directory. To do this, 
copy the MAILENG.DLL from the TimeVision NS directory into cc:Mail.

When changing Time Zones, events that overlap months do not appear. 
When the default Time Zone is restored, events re-appear at the 
original start time.

If a Private Name is added with a display name that matches a local 
user's display name but in a reversed LAST-NAME, FIRST_NAME or 
FIRST_NAME LAST-NAME format, the local user cannot connect to 
TimeVision NS using the reverse-format of the display name. 
Use the exact format of the local user's display name or the ns:Name 
when connecting to TimeVision NS.

To use the Online/Offline feature, load the VSHARE virtual device driver 
in the Windows SYSTEM.INI file (standard in versions 3.11 and above), 
or run DOS SHARE.EXE before launching Windows. Otherwise an error is returned 
when "Work Offline" is selected, "File sharing violation or failure was 
detected. Check that you are connected and logged onto the network."

The default display window size of TimeVision NS client application in 
1024x768 resolution cuts off the DIL (Dynamic Information Line) and the 
Interval drop-down list box in the Day Folder. Enable the "Remember Windows 
Positions" preference and drag the edges of the main window to increase 
the size.

If you open an event in the InBox, when exiting the InBox the focus moves
to that event's date and time.

To run the TimeVision NS fresh install and launch the client application 
solely on a local hard drive, a "-O" command line option must be used with 
WNS3.EXE. This disables the Online/Offline related network drive detection. 
For example, a valid command line would be: C:\TVNS\WNS3.EXE -O

DOS client application (NS3.EXE)
================================

NS3.EXE and NSAGENT.EXE experience a memory conflict with 
QEMM 7.03. The DOS versions of TimeVision NS and ns:Agent 
use a memory swapping utility to decrease the amount of memory 
required. This utility constantly monitors the Memory Control Blocks 
(MCBs) ensuring swapped-out information from the DOS application 
can be safely restored. This ensures compatibility with certain pop-up 
Terminate-and-Stay-Resident (TSR) programs. If a TSR pops-up over 
a TimeVision NS session that has data swapped to EMS, XMS, or 
virtual hard disk space, the swapping utility records the memory the 
TSR is using from a DOS MCB check. This allows TimeVision NS to 
track the memory it is using, and keep it separate from the memory 
utilized by the other resident programs. Quarterdeck Office System's 
Quarterdeck Expanded Memory Manager version 7.x takes control 
of MCB management from DOS in an effort to free as much conventional 
memory as possible for DOS programs. TimeVision NS assumes that 
standard memory management techniques be used. MCB control will be 
a DOS function and applications must register their memory requests 
with DOS. QEMM 7.x uses a non-standard approach. If an error occurs, 
the following may display: "ERROR EXECUTING {program}: 7 MEMORY 
CORRUPTION DETECTED" This may occur while gathering or sending 
mail and when attempting to access print or import/export functions.
	To correct this, do not load COMMAND.COM high in your 
CONFIG.SYS file, or refer to Quarterdeck's technical note on the topic 
"Troubleshooting Stealth ROM", found in the file STEALTH.TEC located 
in the C:\QEMM\TECHNOTE directory. If further assistance is required, 
please contact our Technical Support Department.

ns:Agent (WNSAGENT.EXE and NSAGENT.EXE)
=======================================

Both the DOS and Windows versions of ns:Agent generate E-mail updates 
during the maintenance period. These updates concern deferred local user 
name changes or deletions. Upon receipt, remote calendars in turn store these 
administrative transactions as deferred actions. This maintenance-generated 
E-mail is not sent to remote calendars until the next ns:Agent cycle after 
the maintenance period was executed. 

Calendar update messages are scanned for validity when gathered from the 
calendar mailbox. If an anomaly is found, the corrupt E-mail item is placed 
into a CMF.ERR file located in the TVNS\MAIL subdirectory.

Dedicated machines running ns:Agent with MSMail-MAPI can significantly 
increase overall performance of the system by manually starting the Microsoft 
Mail Spooler Program MAILSPL.EXE before starting ns:Agent.
	Normally, ns:Agent with MSMail-MAPI opens a new MAPI session at the 
start of each cycle. This is a time consuming process requiring a new session 
be opened and MAILSPL.EXE be launched. MAILSPL.EXE downloads all messages 
in the calendar mailbox to the (usually) local MMFF file to be extracted by 
MAPI. ns:Agent reads and processes each message, sends any necessary 
messages, closes MAILSPL.EXE and closes the MAPI session. Each message that 
ns:Agent sends is uploaded to the MSMail postoffice before it can quit. 
ns:Agent does this because it runs in one shot mode (with the -1 parameter) 
where it completes all of it's work in one cycle and cleans up afterward. 
	ns:Agent takes advantage of any existing open MAPI sessions to the 
calendar mailbox. By manually opening MAILSPL.EXE before running ns:Agent, a 
persistent MSMail-MAPI session is created with the TimeVision NS calendar 
mailbox at the postoffice. The Mail Spooler (MAILSPL.EXE) downloads new 
messages from the postoffice and uploads sent messages while the machine is 
idle and as a background task. When ns:Agent is active while the Spooler is 
running, it immediately starts processing messages the Spooler downloads, 
submits any new messages to the spooler and performs database maintenance or 
waits for the next cycle without closing the open MAPI session. While 
ns:Agent is performing these other tasks, the Spooler is acquiring new 
messages for ns:Agent to process in the next cycle.
	In order to take advantage of these benefits you must do the 
following:

	1) Start windows (only for WNSAGENT.EXE).

	2) Make sure the ns:Agent machine has MSMail properly setup. 

	3) Run MAILSPL.EXE. It should be in the WINDOWS/SYSTEM directory. It 
	will prompt for the mailbox and password for the TimeVision NS 
	calendar mailbox. A MAPI session opens signified by the MAILSPL 
	program shrinking to an icon on the desktop.

	5) Setup the ns:Agent parameters in WNSADMIN.

	6) Run ns:Agent.

Utilities
=========

The NS3CHECK utility automatically shuts down the database, displaying 
the TimeVision NS Shutdown dialog with a message, "NS3CHECK 
database maintenance."

LOCK.EXE does not shut down the database. LOCK.EXE temporarily locks 
records in the STCAL.LCK file causing any active TimeVision NS client 
applications to retry database access requests until the command used in 
conjunction with LOCK.EXE is finished. This allows interleaved database 
access between LOCK and the client that can run during the day without 
forcing all users to exit the application.


============================================================
Copyright _ 1995 CE Software, Inc. West Des Moines, IA. All Rights 
Reserved.

TimeVision NS is a trademark of CE Software, Inc. All other brand or 
product names are trademarks or registered trademarks of their respective 
holders.

CE Software, Inc.
P.O. Box 65580
West Des Moines
Iowa 50265 U.S.A.
Tel: 515-221-1801
Fax: 515-221-1806
Tech Support: 515-221-1803
QuickMail: 515-224-1721
QuickFacts: 800-579-9733

Internet: ce_support@cesoft.com

Support Forums:
America Online - Use Keyword "CESOFTWARE"
AppleLink - CE Software folder in Third Parties folder
CompuServe - At any system prompt, type 'go MACAVEN"
eWorld - Go To shortcut "CESOFTWARE"

International users contact your local distributor. Information may be 
found in the TimeVision NS About Box.
