---------------------------------------------------------------------------

CELESTA MOBILE DOCUMENT ORGANIZER
USER'S GUIDE
---------------------------------------------------------------------------

TABLE OF CONTENTS

1.    READ THIS FIRST
2.    INTRODUCTION
3.    REQUIREMENTS
4.    INSTALLING MOBILE DOCUMENT ORGANIZER
4.1.  INSTALLATION FROM A FLOPPY USING A PC WITH THE NSERVER APPLICATION
4.2.  INSTALLATION USING THE COMMUNICATOR'S WWW BROWSER
5.    SETTING INTERNET ACCESS POINT
6.    STARTING MOBILE DOCUMENT ORGANIZER
7.    USING LOCAL VIEW
7.1.  COPYING, MOVING AND RENAMING LOCAL FILES
7.2.  DELETING LOCAL FILES
7.3.  DISPLAYING FILE PROPERTIES
8.    USING SERVERS VIEW
8.1.  DEFINING SERVERS
8.2.  EDITING AND DELETING SERVERS
8.3.  CONNECTING TO THE SERVERS
9.    USING REMOTE VIEW
9.1.  COPYING FILES BETWEEN THE COMMUNICATOR AND THE SERVER
9.2.  CREATING REMOTE DIRECTORIES
9.3.  DELETING REMOTE FILES OR DIRECTORIES
10.   SETTING THE MDO DEFAULTS
11.   SCRIPT LANGUAGE
11.1. SMS ACTIVATION
12.   REGISTERING MDO

---------------------------------------------------------------------------

1. READ THIS FIRST

To fully use and benefit from the possibilities of Celesta Mobile Document
Organizer you must register this product. Without registration the total 
number of file transfer operations is restricted. If you have purchased this
product from a retail dealer you should already be provided with the serial 
number needed for the registration. You will also need the serial number to
get customer support. Please, write down your serial number to the field 
below from which it can be referenced easily.

On the other hand, if you have downloaded Mobile Document Organizer through 
WWW, please, contact CCC companies to get more information about retail 
dealers and product ordering. You must purchase Mobile Document Organizer 
before you receive the serial number to be able to register.

Please, refer to chapter 12 REGISTERING MDO for more detailed information in 
registering this product.


Serial Number: ____________________________

---------------------------------------------------------------------------


2. INTRODUCTION

Celesta Mobile Document Organizer (MDO) is a sophisticated file transfer and 
management application designed especially for the revolutionary NOKIA 9000 
Communicator. MDO enables wireless two-way file transfer between the Nokia 
Communicator and a FTP server located anywhere in the Internet or in 
intranets. MDO also contains enhanced features to manage local and remote 
files. 

Mobile Document Organizer uses NOKIA Communicator's integrated GSM cellular 
phone. Therefore getting an access to the Internet does not require any 
cables or fixed lines. Connection can be made instantly everywhere where the 
GSM network data service is available. Mobile Document Organizer has an 
easy-to-use graphical user interface where both local and remote views are 
displayed simultaneously. Mobile Document Organizer has a script language 
for executing frequent file  transfer tasks easily. Special script commands 
are provided to import and export contacts information to the Communicator's 
Contacts application. The commands are stored in a script file and executed 
sequentially when the script file is activated. File transfers can also be 
launched automatically by an incoming short message (SMS). With this advanced 
feature files can be updated without user intervention to the Communicator 
from the central office.

---------------------------------------------------------------------------

3. REQUIREMENTS

Mobile Document Organizer runs on the Nokia 9000 Communicator. The memory 
requirement is 100 kbytes. MDO is compatible with most FTP servers and it 
has been tested with FTP servers included with Microsoft Windows NT 
(3.5x,4.x), HPUX and Sun Solaris. FTP servers are available as add-on 
products for Windows 95, Windows 3.1 and Novell operating systems. The most 
recent compatibility information is available in the World Wide Web at 
http://www.celestatoosl.com.

---------------------------------------------------------------------------

4. INSTALLING MOBILE DOCUMENT ORGANIZER

4.1. Installation from a floppy using a PC with the NSERVER application

Start installation by pressing System application button and select Software 
Install/Remove. The Software Install/Remove main view displays the serial 
connection type and the used PC drive. Press Settings to change the 
connection type or to redefine the used PC drive. The connection type is 
changed by pressing Change. The directory name and location can be edited 
manually. Press Install in the Software Install/Remove view. The NOKIA 
Communicator starts searching for installable software from the designated 
PC drive and a list of installable software is displayed. Select Celesta MDO
installation and simply follow the guidelines. Software is installed to 
Extras application group. For detailed instructions for software installation 
see the Nokia 9000 Communicator User's Manual.

4.2. Installation using the Communicator's WWW browser

You can also install the unregistered version of MDO from the WWW pages of 
CCC companies at http://www.celestatools.com. Follow the instructions given 
in the Mobile Computing group's Celesta product family pages at URL 
http://www.celestatools.com. After MDO has been downloaded to your 
communicator in few minutes, you will be asked if you want to install the 
software. Answer OK to the questions. This file is the most recent version 
of MDO. If you have the serial number from the sales package, you can also 
register the downloaded version of MDO as described in section 12. 
The registration process converts the demo version to a normal version. 

---------------------------------------------------------------------------

5. SETTING INTERNET ACCESS POINT

Before you can connect to the FTP servers you must configure the Internet 
Access Point (IAP) settings. IAP is the service which connects you to the 
Internet or intranets via GSM data call. IAPs are usually provided by 
commercial Internet service. Notice that these IAPs typically require a 
contract between you and the service provider. Companies or individuals can 
also set up IAPs of their own using standard modems and software.

To change or to create a new Internet Access Point press the Internet 
application button to open the Internet program group. Press Settings and 
select item Internet Access and press Change. Next you will see a list of 
the defined IAPs. If the list is empty, you have not defined any IAPs so far.
Edit lets you change the settings of an existing access point and New creates 
a new one. The information stored for each IAP contains following fields:

Provider name: Internet access provider's name which appears on the access 
	       point list. The name can be edited freely.
Phone number:  Telephone number of the IAP.
Username:      Used in authentication process if required.
Password:      Used in authentication process if required.

---------------------------------------------------------------------------

6. STARTING MOBILE DOCUMENT ORGANIZER

After successful installation Mobile Document Organizer will be found in the 
Extras application group. Choose the Celesta MDO item and press Select. 
Mobile Document Organizer's main window will appear. 
 
The main window is divided in two views. You can move between these views 
using the Tab or right and left arrow keys. On the left side is always the 
Local view, which displays the contents of the current local directory. On 
the right side is either the Server view or the Remote view. Server view 
displays a list of the defined servers. Remote view displays the contents of
the current server directory when the  connection has been established with 
the server The commands available are the same in all  views: Open, Close, 
Menu and Quit. The views and the respective commands are described in detail 
in following chapters.

---------------------------------------------------------------------------

7. USING LOCAL VIEW

Open allows you to open a file or change a directory. If you press Open while 
a file is selected, the contents of the file is shown. Pressing Open on a 
directory displays the contents of that directory i.e. moves down in the 
directory tree.

Close moves to the parent directory and displays the contents of the 
directory. Close button is dimmed if you are already in the root directory.

Menu command button opens a menu containing the following operations:

Local Copy/Move opens a dialog for selecting the target file and directory 
and the type of the command (copy/move). For more information see chapter 
7.1 Copying, Moving and Renaming Local Files.

Local Delete removes the selected local file.

Remote Copy copies local files to the selected directory of the remote 
server. If a single local file is highlighted only that will be copied to 
the server. On the other hand, if a local directory is highlighted all files 
in it are copied. Notice that this command is available only if you are 
logged in a server. For more information see chapter  9.1 Copying Files 
between the Communicator and the Server.

File Properties displays information on the selected file: name, size in 
bytes, date and time. For more information see chapter 7.3 Displaying File 
Properties 

Default Settings contains settings used with scripts. For more information 
see chapter 10 SETTING THE MDO DEFAULTS.

Run Script executes the selected local script file. For more information 
about scripts see chapter 11 SCRIPT LANGUAGE.

 
Please notice that Local Copy/Move and Local Delete commands are available 
only for files, not for directories.

Quit exists Mobile Document Organizer.


7.1. Copying, Moving and Renaming Local Files

Select Local Copy/Move from the Menu to copy, move or rename a local file. 
Proceed as follows:

1)  Use the TAB key to switch between the Target field and directory listing.

2) Enter the new name to the the Target field. Leave the field unchanged if 
you do not wish to change the name of the file.

3) Use the arrow keys to select the target directory from the directory list.

4) Press Copy to copy the file and Move to move (copy and delete the source) 
it to the selected target directory. 

To rename a file, just enter the new name, select the target directory to be 
the same as the source and press Move.

Press Cancel to close the dialog without copying or moving anything.

7.2. Deleting Local Files

Select the file you want to remove from the Local view and choose Local 
Delete from the Menu. Next you will be asked to confirm the deletion of the 
file. Notice that due to the special file system used in the Communicator, 
it is not possible to delete or create local directories.

7.3. Displaying File Properties

Select File Properties from the Menu to display the file properties.

File properties contain the following fields:
- Name of the file
- Size of the file in bytes. It is sometimes useful to check the size of the 
  selected item before starting the remote copy operation. 
- Date and Time shows when the file was last modified.

Press Close to close the dialog.

---------------------------------------------------------------------------

8. USING SERVERS VIEW

First check that Servers View is selected. If the selection bar is not in 
Servers View, use the Tab, left or right arrow key to change the selection. 
Use up and down arrow keys to select the FTP server you want to connect to 
and press Open.  Enter the username and password to log in to the server and
press OK. For more information about the login procedure see chapter 8.3 
Connecting to the Servers. If no servers are listed in Servers View, you 
should enter the server information by selecting New Server from the Menu.

Close command is not available in this view.

Menu command button opens a menu containing the following items:

New Server allows you to define a new FTP server. For more information see 
chapter 8.1 Defining Servers.
  
Edit Server allows you to edit the settings of the selected server. For more 
information see chapter 8.2 Editing and Deleting Servers.

Delete Server removes the selected server entry.
  
Default Settings contains settings used with scripts. For more information 
see chapter 10 SETTING THE MDO DEFAULTS.

Register allows you to register your Mobile Document Organizer. For more 
information see chapter 12.

 
Quit exists Mobile Document Organizer.

Use TAB, left or right arrow key to move between the views on the screen.

8.1. Defining Servers

Before you can connect to any FTP server, you must enter some basic 
information about the server. Select New Server from the Menu to enter the 
information. The Server Settings dialog contains the following fields:

Server Name:           Enter a freely chosen name for the server. You will 
		       later see this name listed in the Servers view.

IP Address :           All devices using Internet Protocol have unique IP 
		       addresses. You can enter either the Internet host name
		       or the actual IP address. For example ftp.funet.fi or 
		       128.214.248.6. Note that the connection to the server 
		       is created faster if you use the actual IP address, 
		       since the name resolving is not required. 

Server Port:           Identifies the communications port to be used by the 
		       server. If a specific port number is not given by the 
		       server administrator, use the default FTP port number 
		       21.

Internet Access Point: Select the IAP used with the server. Use Change 
		       command button to open the list of predefined IAPs and 
		       use scroll buttons or up and down arrow keys to 
		       highlight the IAP you want to use. Press Ok or Cancel 
		       to accept or to cancel the selection, respectively.

Press Close to create a new server definition.

 
8.2. Editing and Deleting Servers

If you want to change existing server configuration highlight the server you
want to edit and select Edit Server from the Menu. The fields of the Server 
Settings dialog are described in chapter 8.1 Defining Servers. 

To remove an existing server configuration use Delete Server from the Menu. 
A confirmation dialog is shown where you can select Delete to continue the 
operation or Cancel not to remove the configuration.

8.3. Connecting to the Servers

Select a server from the server list displayed in the Servers view and press 
the Open trigger. Open connection dialog appears and you are prompted for 
username and password.  Type in your user name, press Tab or down arrow key 
and type the password and then press OK to start logging in the server. 
Hint: If you want to access public FTP servers, try to use anonymous or ftp 
as a user name and "your email address" as a password. Progress dialog is 
displayed on the screen during the data call activation and the connection 
set up. After a successful login, Remote view is displayed. 

 
If a connection cannot be established, make sure that
1. the phone is turned on (notice the usage restrictions stated in the Nokia 
   9000 Communicator User's Manual),
2. you are in GSM coverage area and signal strength is adequate (see the bars 
   next to the antenna symbol on the left side of the screen),
3. you have valid contracts with your GSM operator (including GSM data 
   service) and Internet access point provider,
4. server settings are correct (see chapter 8.2). Check that you have 
   selected the correct access point to be used with the server,
5. the access point definition is correct (see chapter 5),
6. you entered the user name and password correctly,
7. you have permission to log in the server.

If the failure was caused by a temporary error such as number busy or 
temporary network or server error, try contacting the server later.

---------------------------------------------------------------------------

9. USING REMOTE VIEW
 
Open allows you to open a remote directory. Open command button is dimmed if 
a remote file is selected since it is not possible to open or edit remote 
files on the server.

Close moves to the parent directory and displays the contents of it. Close 
command button is dimmed if you are in the root directory.

Menu command button opens a menu containing the following operations:

Remote Copy copies the selected directory or file from server to the selected
local directory. For more information see chapter 9.1 Copying Files between 
the Communicator and the Server.

Remote Delete removes the selected remote file or directory.

Remote Create Directory allows you to make a new directory on the server. 
Notice that deleting file or directories or creating a directory may be 
prohibited by the server.
  
File Properties displays information about the selected remote file: name, 
size in bytes and the date and time when the file was last modified.
  
Default Settings contains some settings used with scripts.
 
Quit closes the server connection.
Note that you need to have appropriate access rights to the remote server.  
During a file transfer the Progress dialog  is shown. The dialog displays 
the total size of the document and the number of transferred bytes. You are 
able to cancel the transfer operation at any stage of the process. 

9.1. Copying Files between the Communicator and the Server

Select Remote Copy from the Menu to copy remote files to a local directory 
or vice versa. Notice that the currently selected view is considered to be 
the copy source. To copy a local file to the remote server, select the local
file and choose Remote Copy. If you want to copy all files under a local 
directory highlight the directory name and  press Remote copy. To copy a 
remote file or directory content to the current local directory, select the 
remote file or directory and choose Remote Copy. Copy Text copies the 
selected directory or file in ASCII mode to the currently selected local 
directory. Use this mode for text documents such as HTML and plain text 
files.

Copy Data copies the selected directory or file in binary mode. Use this 
mode for all binary files such as gif and jpeg images, etc.

Notice: If you are copying  Communicator files such as Note, Fax, Memo, Mail
and Message to your PC in backup purposes, use the Copy Data mode, since 
copying them in text mode will lead to a loss of all document formatting 
information. However, if you want to copy a Communicator file permanently to
your PC and edit it there, use the Copy Text mode.

Cancel closes the copy dialog without copying any files.

Notice, that copying a directory does not create a new directory if copying 
from a remote server to the Communicator, instead it copies all the files 
from the selected source directory to the selected target directory. On the 
other hand, if you are copying a directory from the Communicator to a remote 
server a directory with same name is created.

9.2. Creating Remote Directories

Select Remote Create Directory from the Menu to create a new remote 
directory.

The dialog contains a text field for entering the name of the new server 
directory. The new directory will be located under the currently selected 
directory in the Remote view.

Create the directory by entering its name and pressing OK command button.

Close the dialog without creating a new directory by pressing Cancel command 
button.

9.3. Deleting Remote Files or directories

Select the desired file or directory from the Remote view and choose Remote 
Delete from the Menu. A confirmation is asked before deleting. If you are 
deleting a remote directory it must be empty.

---------------------------------------------------------------------------

10. SETTING THE MDO DEFAULTS

Select Default Settings from the Menu of Local or Server View to enter the 
default settings.

Internet Access Point is the default IAP to be used in scripts that do not 
have IAP setting.

Allow SMS activation lets you to enable or disable  SMS activated scripts 
For more information about scripts and SMS messages see chapters 11 and 11.1.

To set the default IAP press Change command button to open the list of 
available IAPs, use scroll buttons or up and down arrow keys to select the 
IAP and press OK. To cancel the selection use the Cancel command button.

To toggle on/off the SMS activation press Change command button.

Press Close to close the Default settings dialog.

---------------------------------------------------------------------------

11. SCRIPT LANGUAGE 

The purpose of the script language is to automate frequently used file 
transfer operations. You can save  the required commands to a script file 
and run it when needed. The script file can contain arbitrary number of 
commands. Script files are ASCII text or Notes files. Each line contains 
exactly one command. Lines starting with # symbol are comments. Empty lines 
are ignored. Language is not case sensitive, but be careful with the 
filenames in various servers. The execution of  the selected script file is 
triggered  by selecting Run script from the Menu in the Local view.

The basic commands of the script language are
	iap     defines Internet Access Point (IAP)
	host    defines the name of the ftp server or it's IP address
	port    defines the server port number to be used in connection 
	user    defines user name 
	pass    defines user's password
	copy    command used to transfer files in both directions
	impcon  command used to import Contacts information from a remote 
		FTP server
	expcon  command used to export Contacts information to a remote 
		FTP server

The syntax of the copy command is

	copy filename to [local | host]  filename [as text | as data ]

If filename or IAP contains spaces it must be inside quotation marks.

When copying a local file to remote server and no explicit directory path is 
given as a source directory, the file is searched in the directory Own texts. 
Similarly, when transferring a remote file to Communicator and no explicit 
target directory is given, the file is downloaded to the directory Downloaded 
files (see example 1.).

The contacts import can be used to transfer Contacts information from a 
remote FTP server to the Communicator. The command

	impcon filename

adds the contacts contained in the remote file filename to the Contacts 
database of the Communicator.

Similarly, the Contacts information database can be exported to a remote FTP 
server. The command

	expcon filename

saves the whole Contacts database of the Communicator to the server with name 
filename. The filename in the import or export commands can also contain 
directory path, if the file is not in the login directory (see example 2.).

Example 1.
# this is a comment
iap  = ccc
user = anonymous 
pass = my@email.address
host = ftp.funet.fi
port = 21
# local source directory is "Own texts"
copy fubar1.txt to host /incoming/fubar1.txt as text
# local source directory is explicitly given
copy "Downloaded files\fubar2.txt" to host /incoming/fubar2.txt as text

# local target directory is "Downloaded files"
copy /pub/pics/shuttle1.gif to local shuttle.gif as data
# local target directory is explicitly given
copy /pub/pics/shuttle1.gif to local "Own texts\sh.gif" as data

Example 2.

# import first new contacts
host = machine1.domain.country
user = john
pass = xyz
impcon my_contacts/contacs.dat

# export then to an other machine
host = machine2.domain.country
pass = zyx
expcon communicator/Contacs/contacs.dat


11.1. SMS Activation

An incoming SMS, directed to MDO application, may contain script language 
commands. SMS activation is used to trigger FTP transfer without any user 
interaction.

The incoming SMS message contains the following fields:
//CMDO16439                                         
[run | saverun | save] [filename]
[script] 

run command loads a local script file from directory Own texts and runs it. 
No text is allowed after run command and filename. save stores the included 
SMS script in a file named as  filename. If the file already exists, it will 
be overwritten. saverun command first saves the script and then executes it. 
These commands must directly follow the reference field (//CMDO16439). 

If there are no  commands [run | saverun | save] [filename] in the incoming 
SMS the subsequent script is executed. Script commands are interpreted as if 
they were stored in a script file. Please notice that the maximum length of 
a short message is 160 characters.

Failures in SMS activated file transfer are handled as with locally activated 
scripts. If an error occurs during the execution, script is terminated, all 
communication channels are closed and an error message is displayed. The 
failed SMS script is stored to a file. The location of the file is told in
the error message.

A log of succesful script transactions is stored in the file CELESTA.LOG in 
the directory Own texts. You can open this file and check if the script 
completed succesfully.

---------------------------------------------------------------------------

12. REGISTERING MDO

Select Register from the Menu of Local, Server or Remote View to register 
your Mobile Document Organizer. You must register MDO in order to get 
customer support and to use the full version of MDO. The unregistered 
version of  MDO has an upper limit for the total number of file transfers 
operations.

If you have purchased MDO product from a retail dealer you should already 
have the serial number needed to register MDO. To start the installation 
procedure select Yes from the confirmation dialog. A registration dialog is 
presented where you should enter the Serial Number. To get the registration 
key press Create WWW form and follow the instructions to start the WWW 
browser and to fetch the registration form. Fill in the Celesta Registration 
Request, send it and wait for a WWW document with the registration key to be 
presented. Write the registration key down, return back to the registration 
dialog and enter your registration key and press Register command button. 

If  you have downloaded MDO through WWW and have not yet purchased the 
product ,select No in the register confirmation box to get information in 
how to contact CCC Companies to receive more information about retail 
dealers and product ordering. Only after you have purchased the product 
you have the possibility to register the product using the procedure 
described above.





NOKIA is registered trademark of Nokia Corporation.
NOKIA 9000 Communicator is a trademark of Nokia Corporation c 1995 Nokia 
Mobile Phones.
HP-UX is a registered trademark of Hewlett-Packard Company.
Sun and Solaris are registered trademarks of Sun Microsystems Inc.
Microsoft is a registered trademark and Windows and Windows NT are  
trademarks of Microsoft Corporation.
Novell is a registered trademark of Novell, Inc.


3C Mobile Oy    Celesta Mobile Document Organizer
