
              NOVELL TECHNICAL INFORMATION DOCUMENT

TITLE:              Convert SNA to SAA
DOCUMENT ID:        TID000093
DOCUMENT REVISION:  B
DATE:               13JAN94
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:

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.


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     Revision:  B

     Files Included     Size     Date      Time

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


               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.

