
              NOVELL TECHNICAL INFORMATION DOCUMENT

TITLE:              Unit & Currency Conversion Utility
DOCUMENT ID:        TID000093
DOCUMENT REVISION:  A
DATE:               01JUL93
ALERT STATUS:       Yellow
INFORMATION TYPE:   Symptom Solution
README FOR:         CONVRT.EXE

NOVELL PRODUCT and VERSION:
NetWare for SAA 1.2
NetWare for SAA 1.1

ABSTRACT:
CONVRT contains 2Convert, a unit conversion program, allowing conversion
between over 500 standard units. Customised conversion rates can also be
created, allowing virtually any multiple unit conversion rate to be catered
for. Also converts temperature and Currency, with an option to edit
currency exchange rates. Novell style interface ensures ease of use. You
will need this one day .....
_________________________________________________________________

DISCLAIMER
THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. 
NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION. 
HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION
ONLY.  NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS
INFORMATION.
_________________________________________________________________

Self-Extracting File Name:  CONVRT.EXE

Files Included     Size     Date        Time

  CONVRT.TXT          (This File)
 CONVERT.EXE     303155    3-05-92      5:16p
 DBU$ERR.DAT       9451    2-26-90      6:52p
DBU$HELP.DAT       3722    9-01-89     12:00a
 DBU$MSG.DAT      24812   12-14-89      4:52p
 IBM$DBU.OVL       2936    9-01-89     12:00a


      Converting NetWare SNA Gateway Configuration Information to a
                          NetWare for SAA profile
*********************************************************************
This conversion utility transfers configuration information on PU and
dependent LUs from the NetWare SNA Gateway (version 1.2, 1.3, or 1.3.01) to
a NetWare for SAA (version 1.1 or 1.2) profile.  The LUs on the NetWare SNA
Gateway are transferred to Public LUs in the profile.  The PU and LUs are
transferred in one of the following two ways:

-  A profile is created and PU  information and dependent LU information is
transferred.

-  Only dependent LU information is appended to an existing profile.

Note that this utility does not transfer NetBIOS and coax information
because they are not supported by NetWare for SAA.  During the transfer,
NetBIOS is converted to SPX and coax is converted to token ring.  Also,
independent LUs are not transferred.

BEFORE YOU BEGIN
Make sure that the number of sessions on your version of NetWare for SAA is
equal to or greater than the number of LUs you are transferring from the
NetWare SNA Gateway. If there are more LUs on the NetWare SNA Gateways than
are permitted by your version of NetWare for SAA, upgrade the NetWare for
SAA software or reduce the number of LUs on your SNA gateways.

Make sure that NetWare for SAA is installed and the Communication Executive
is running on the server where the information is to be transferred. To
load the Communication Executive, enter the following command at the
NetWare console (:) prompt:

     LOAD COMMEXEC

For more information on loading the Communication Executive, refer to the
NetWare Communication Services Administration Guide or the NetWare for SAA
v1.2 Administration Guide.

INSTALLING THE FILES
Copy the following files from the floppy diskette to a directory on your
hard disk:

     CONVERT.EXE
     DBU$MSG.DAT
     DBU$HELP.DAT
     DBU$ERR.DAT
     IBM$DBU.OVL

RUNNING THE CONVERSION UTILITY
Perform the following steps to transfer the PU and LU configuration
information on your NetWare SNA Gateway to a NetWare for SAA profile:

1. From a DOS workstation, log in to the network server as a supervisor or
with  "supervisory  equivalent" privileges.

2. From the directory containing the utility files, type
     CONVERT

3. You are prompted for the gateway-executable file (the file that loads
the gateway). The default GWSERVER.EXE is displayed.  Press <Enter> if the
default is correct. Otherwise, enter the path of your gateway filename. For
example:

     F:\3270\svl\GATE1.EXE

4. From the list of communication servers displayed, select the server that
is to receive the configuration information.

5. You will be prompted for a User Name. The default is Supervisor. Log in
as Supervisor or with "supervisory equivalent" privileges.

6. Confirm whether you want to append the configuration information on the
NetWare SNA Gateway to an existing profile on the communications server.

Select NO to create a profile on the communications server. The profile is
named after the NetWare SNA gateway's "Unique Server Name" field.  All PU
information and LU type and model information is transferred to this
profile.

If you select YES to "Append to Existing Profile," a list of existing
profiles is displayed. Select the profile to which you want to transfer LU
information; the PU address information on that profile will not change.

Appending allows you to consolidate LUs from several NetWare SNA Gateways
into one NetWare for SAA profile. However, the maximum number of LUs
transferable is restricted by the licensing for NetWare for SAA. For
example, if your NetWare for SAA software is licensed for 64 sessions and
you are transferring  64 LUs from the NetWare SNA Gateway, but you already
have 16 LUs on a profile, this utility will transfer the first 48 LUs from
the NetWare SNA Gateway. If you want to transfer the remaining LUs on the
gateway, you need to upgrade your NetWare for SAA software to hold more
sessions.

Transfer of LUs will be aborted if the sum of LUs in the profile and in the
gateway is greater than 253. For example, if your NetWare for SAA is
licensed for 254 sessions, the profile already has 126 LUs and you want to
transfer 128 LUs from the gateway, this utility will not append any of the
LUs to your profile. However, if you reduce the number of LUs on the SNA
gateway to 127, you can transfer all the LUs to the specified profile.

VERIFYING TRANSFERRED INFORMATION
During the conversion process, a text file is created with the NetWare SNA
Gateway name and .LOG extension. This file will be in the directory where
the gateway files are located. All the transferred information is logged
into this file. For example:

 ** SNA Gateway  ->  NWSAA Conversion Log 02/12/92 10:01:19  **
Remember to configure your workstation software.
Created profile named "GWMIX2" on server "SVL_CS1"
The following Configuration was transferred:
     Configuration File: C:\3270\GWCAL\GWTOKEN.EXE
     Interface:          SPX
     Network Connection: Token Ring
          Destination Address:     5555 79999999 hex
          Service Access Point:    04 hex
          Adapter Type:       Primary
          Block ID:                017 hex
          PUID:                    00000
     Gateway LUs 2-11 (hex) transferred as LUs 2-11 (hex)
     16 dependent LUs transferred

Run CSCON to verify or change the transferred PU and Public LU information.
 You may need to specify PU information, for example, when you transfer a
coax gateway (a coax connection gets converted to a token ring in NetWare
for SAA).

NetWare for SAA provides a  more efficient pooling system than that
provided in the NetWare SNA Gateway, so run CSCON to convert  the Public
LUs to pools and dedicated LUs, because pooling information is lost during
the conversion process.

For more information on running CSCON, refer to the NetWare Communication
Services Administration Guide or the NetWare for SAA v1.2 Administration 
Guide.

RECONFIGURING WORKSTATION SOFTWARE
Once the transfer is complete, check the workstation software to see if the
sessions on your workstations are compatible with those on the
communications server. All LU type and model information are transferred as
Public LUs.  NetWare for SAA has a more efficient pooling system than that
of the NetWare SNA Gateway.  If necessary, reconfigure the workstation
software to take advantage of the new pooling system.
***************************************************************

