






                                  Table of Contents


     Special Notes on Version 1.03*..........1

     Before Installing.......................1

     Upgrading PC-Xware......................2

     Networks................................3

          3COM (3COMNT)......................3

          Beame & Whiteside (BWTCP)..........3

          DEC Pathworks TCP/IP (DNWTCP)......4

          FTP Software PC/TCP (PCTCP)........4

          SUN PC-NFS (PCNFS).................4

          Walker Richer & Quinn Reflection (REFLEC)...........4

          Windows for Workgroups TCP/IP......4

          Windows Sockets (WINSOCK)..........4

          Wollongong Runtime 1.2 (PATHWY)....5

     Changing Network Software...............6

     PC-Xware Initialization File (XWARE.INI).................6

     Windows TEMP Environmental Variable.....7

     XRemote.................................7

     Remote Window Managers..................7

     VMS Support.............................7

          VMS Launcher Installation..........7

          VMS Launcher Use...................8

          Tuning NCP on the PC...............9

          VMS DECWindow Hints................9

          DEC Fonts Provided with PC-Xware...11

          X Utilities for DEC VMS............11




                                           i







          To Run the X Utilities.............11

     Far East Fonts..........................12

     PC-Xware on a Network File Server.......13

          Running PC-Xware from a network file server.........13

          Installing PC-Xware on a network file server........13

          Setting up PC-Xware on a network workstation........14

     Features................................16

          PC-Xservices Console...............16

          PC-Xware Desktop...................16

          PC-Xware Settings..................17

          Numlock Support....................17

          The Windows Bitmap Cache...........18

          XDM Terminates Default Window Manager...............18

          PCXTrace -- X Protocol Tracer......18

          X Client Icons.....................19

     Utilities...............................20

          DOSMEM - Display DOS (640K) memory usage under Windows.     20

     Limitations.............................20
















                         
       * New with this release of PC-Xware



                                          ii































































                                          iii




     Special Notes on Version 1.03*
       o If you wish to install PC-Xware's Integrated Stack (NEWT) please read
         the following carefully.

         The NEWT serial number which accompanied this product is an evaluation
         version.  This serial number expires on the date indicated on the NEWT
         label found on the license record card.  If a permanent serial number
         is desired, contact NCD via the phone number printed on that same
         label.

         To use PC-Xware's Integrated Stack you must install it separately from
         PC-Xware.  This is different from the method described in the PC-Xware
         Operations Guide.

         If you already have PC-Xware installed:

           _ Use the "Quick Install Card NEWT, Chameleon, Chameleon NFS" to
            install NEWT.

           _ If the installation program prompts for a NEWT serial number and
            key, use the NEWT serial number and key code found on your PC-Xware
            License Record Card.

           _ Install PC-Xware according to the instructions on the PC-Xware
            "Setup" diskette. Do a "Selective" install for the "PC-Xware
            Server" only.

         If you are installing PC-Xware and NEWT:

           _ Install NEWT first according to the instructions in the "Quick
            Install Card NEWT, Chameleon, Chameleon NFS" document.

           _ When the installation program prompts for the NEWT serial number
            and key, use the NEWT serial number and key code found on your PC-
            Xware License Record Card in the PC-Xware product box.

           _ When installing PC-Xware, follow the instructions in PC-Xware
            Operations Guide, Chapter 2, "Installing PC-Xware without NEWT."
            When the Network Type is requested, choose "NetManage
            NEWT/Chameleon" from the "Network Type" drop down menu.

       o This version of PC-Xware requires approximately 20K of low DOS memory
         in addition to the memory used by your underlying network software.
         For example, FTP 2.2 requires 85K of additional low DOS memory.

       o This version of PC-Xware has replaced the Network Test with a more
         thorough System Test.  In addition to checking the connection with the
         host (like the Network Test), the System Test evaluates your PC
         environment and writes information pertinent to PC-Xware into a
         diagnostic file, xwtest.xlg.  This information is useful in case you
         have trouble using PC-Xware.

     Before Installing

       It is recommended that you have SMARTDrive, the Microsoft Windows
       disk-caching program, installed for faster installation of PC-Xware.



       The default PC-Xware configuration uses three (3) TCP and two (2) UDP
       network sockets.  Please ensure that your network software has
       additional sockets available for each of your X applications.

       If you wish to completely delete PC-Xware from your system, ensure the
       files XWARE.INI and PCXWARE.GRP are deleted from the Windows directory
       and the BIGWIN.386 line is deleted from SYSTEM.INI.  This would be the
       case for a complete re-install of the product from scratch or installing
       after a previous installation that was terminated before completion.


     Upgrading PC-Xware

       If you are updating PC-Xware from a previous version only the Server and
       Network type need to be updated; fonts have not changed from version
       1.0.  In this case we recommend choosing Server and Network Type from
       the Selective Installation menu.

       Please refer to chapter two of PC-Xware - Operations Guide for further
       information on upgrading from a previous version of PC-Xware.








































                                           2




     Networks


      3COM (3COMNT)

          PC-Xware supports 3COM TCP/DPA 2.1 in addition to the other versions
          of 3COM that are listed in the PC-Xware Operations Guide.  3COM
          TCP/DPA 2.1 supports TCP/IP connections via their Windows Sockets
          Library implementation (WINSOCK.DLL).
          PC-Xware does not work with the initial 3COM 2.1 WINSOCK.DLL release.
          Do not choose "Winsock compatible TCP/IP" from
          PC-Xware's Network Type dialog box during PC-Xware installation.
          Instead, follow these installation instructions:

          If you have upgraded from 3COM TCP/DPA 2.0, copy the 3COM TCP/DPA 2.0
          WSOCKETS.DLL file into your 3COM 2.1 directory.  Select "3COM TCP/DPA
          2.0" from PC-Xware's Network Type dialog box during PC-Xware
          installation.

          If you do not have access to the 3COM TCP/DPA 2.0 WSOCKETS.DLL file,
          select "3COM TCP/DPA 1.2" from
          PC-Xware's Network Type dialog box during PC-Xware installation.

          The following 3COM TSR modules need to be loaded in the following
          order:

          TCPLITE.EXE
          NMTSR.EXE
          SOCKTSR.EXE
          DNTSR.EXE     (only needed if host names are resolved via a 
               Domain Name Server)



      Beame & Whiteside (BWTCP)

          Beame & Whiteside is supported through the BW WLIBSOCK.DLL module.  BW
          3.0a and later versions contain an accurate WLIBSOCK.DLL (dated
          5/25/93 or later).  If you have 2.3 or 3.0, contact Beame & Whiteside
          to obtain the latest WLIBSOCK.DLL module.

          Note:  XDM connections are not supported with BW 2.3 even if the
          latest WLIBSOCK.DLL module is used.
















                                           3




      DEC Pathworks TCP/IP (DNWTCP)

          PC-Xware DEC Pathworks TCP/IP support requires the file WSOCKETS.EXE
          in your path.  This file may be installed during DEC PATHWORKS TCP/IP
          installation.  If the file is not installed the following message is
          displayed when starting PC-Xware:

               cannot find WSOCKETS.DLL

          WSOCKETS.EXE is on the DEC Pathworks TCP/IP Utils 2 disk.


      FTP Software PC/TCP (PCTCP)

          When the PC/TCP socket limit is reached, PC-Xware may behave
          unpredictably.  To monitor the sockets used, run the PC/TCP WINET
          utility and choose Configuration.


      SUN PC-NFS (PCNFS)

          Because of the low DOS memory requirement of PCNFS, we recommend you
          load high as many devices and TSRs as possible.

          PC-NFS version 4.0a or higher is required to run PC-Xware.

          To provide the most sockets, load the PC-NFS Resident Transport Module
          with the maximum heap:

               rtm /heap 64




          The PC-NFS Resident Naming Module must be loaded before starting PC-
          Xware.  If this module is not loaded and XDM Startup is used, you will
          see a failure message of "Unable to Connect to DECnet host...."  See
          the SUN PC-NFS section of Appendix A about loading the Resident naming
          modules.


      Walker Richer & Quinn Reflection (REFLEC)

          The buffers must be configured to be the maximum number (16).  This
          setting is found under Advanced Configuration of Network Parameters
          in the TCP Connection Setup Utility of the network Setup program.


      Windows for Workgroups TCP/IP

          PC-Xware now supports the Windows for Workgroups TCP/IP stack.  Select
          Microsoft LAN Manager as the networking interface.


      Windows Sockets (WINSOCK)

          Windows Sockets network support for network vendors other than
          NetManage has not been certified.  We recommend that you use the
          direct support for your network.
                                           4





      Wollongong Runtime 1.2 (PATHWY)

          The number of packet buffers should be increased to the Number of
          NetBIOS sessions plus one (1).

          To make the change, run PWSETUP.EXE and select:

            Configuration Modify TCP/IP Software Setup

          The number of packet buffers and the Number of NetBIOS sessions are
          set in the Advanced Configuration Setup.















































                                           5




     Changing Network Software

       PC-Xware only installs the network module needed for your selected
       network type.  If you change network software, you will need to install
       an additional PC-Xware network module.  Please refer to "Changing
       Network Software" in chapter 2, "Installation" of your "PC-Xware
       Operations Guide".


     PC-Xware Initialization File (XWARE.INI)

       When PC-Xware is installed, a file (XWARE.INI) is placed in the
       MS-Windows installation directory.  This file contains the NVRAM
       (non-volatile random access memory) startup information for PC-Xware.
       The default contents and a brief explanation of XWARE.INI follow:

                    [NVRAM]
                    net-network-software-type=network type
                    unit-serial-number=serial number
                    unit-authorization-code=authorization code
                    unit-installation-directory=installation directory


          network type    specifies the network type that will be used with PC-
                          Xware.  For example, BWTCP, to specify Beame &
                          Whiteside network software.

          serial number   specifies the serial number provided with your copy
                          of PC-Xware.  For example, "123456".

          authorization code  specifies the authorization code provided with
                          your copy of PC-Xware.  For example,
                          "1-2345-6-789ABC".

          installation directory   specifies the directory where
                          PC-Xware is installed.
                          For example, "C:\PCXWARE\".

          Note:  All the default entries in XWARE.INI are established at the
          time PC-Xware is installed.



















                                           6




     Windows TEMP Environmental Variable

       Windows font files (.FON) are created and accessed by PC-Xware.  If the
       Windows TEMP environmental variable has been set, PC-Xware will store
       the font files in the specified directory.  Otherwise, the font files
       will be created in the root directory of your boot disk drive.  These
       font files are temporary and are deleted by PC-Xware at termination.  If
       for some reason PC-Xware is terminated abnormally, the existing font
       files will be deleted the next time PC-Xware is executed.  For further
       information on the Windows TEMP environmental variable see your
       Microsoft Windows User's Guide.


     XRemote

       Using the XRemote function requires NCD supplied host software to be
       installed.  The host software for PC-Xware Remote can be ordered from
       NCD PC-Xdivision(part number PC3020) or the binaries for a specific host
       and operating system can be downloaded from the Bulletin Board.  To
       order it please contact the Sales Department at NCD PC-Xdivision.  To
       obtain it from the Bulletin Board System:

             o  The BBS is compatible with 2400,9600 and
                14400 baud modems.

             o  Default communication parameters are: No Parity, 8 data bits,
                1 stop bit, 9600 baud.

             o  Modem phone number is (503) 646-1743.

             o  Download the appropriate host file from the XRemote Host
                Software directory.


     Remote Window Managers

       When an X window manager is run from your host to your PC, the X window
       manager only knows about the X windows on the screen.  It has no
       knowledge of the Microsoft Windows.  Thus, using the window manager to
       raise or lower an X window, only raises or lowers it within the stack of
       X windows.  PC-Xware attaches a "Lower" item to all system menus.  If
       you need to lower Microsoft Windows beneath your X windows, select the
       "Lower" item from any of your Microsoft Windows system menus.


     VMS Support

      VMS Launcher Installation

          An icon based program launcher is available for DECnet users to VMS
          hosts.  To install the VMS Launcher icon, perform the following steps:

       1. Select the Program Group you wish to place the icon in by
          clicking your mouse on the title bar of the Program Group.

       2. Select the File menu of the Program Manager and click the New...
          menu item.


                                           7



       3. Select the Program Item button in the New Program Object dialog
          and then click the OK button.

       4. In the Program Item Properties dialog select the Browse button.
          In the Browse dialog change to the PC-Xware installation directory and
          select the file PCLAUNCH.EXE and then click on the OK button.

       5. In the Program Item Properties dialog fill in the Description
          edit box with a title identifying the icon (e.g. VMS  Launcher).

       6. In the Program Item Properties dialog fill in the Working
          Directory edit box with the fully qualified installation path (e.g.
          C:\PCXWARE) and click the OK button.  The icon will appear in the
          selected Program Group.

          The PCLAUNCH program provides a means of "launching" a command to a
          VMS system over DECnet.  The VMS command is expected to start an X
          window system application, generally the session manager.  The
          PCLAUNCH command will invoke the PC-Xware server if it is not
          currently running.

          The file "ncd_serv.com" (found in the VMS directory on the Setup disk)
          should be installed on the VMS systems to be used.  Generally, this
          can be done using the Pathworks NFT command:

           $NFT COPY ncd_serv.com VMSHOST"user password"::ncd_serv.com

          It must be installed as an NCP object.  You will need to have system
          account privileges to do the installation.   First copy it to the
          system executables directory -

           $copy ncd_serv.com sys$common:[sysexe]

          Set the protections so that it may be used:

           $set protection=(S:RWED, O:RWED, G:RWED, W:RE)
           sys$system:ncd_serv.com

          Run the NCP program

           $NCP

          Define the object for the permanent data base

           NCP>define object pcx$server file sys$system:ncd_serv.com number 0

          Define the object for the current data base

           NCP>set object pcx$server file sys$system:ncd_serv.com number 0


      VMS Launcher Use

          To use the VMS Launcher, double-click on the launcher icon.  A dialog
          box appears with the following fields:

               Host Name
               User Name
               Password
               Command
                                           8



               Icon Name

          Place the node name of your VMS machine in the "Host Name" field.
          Place your login name on the VMS machine in the "User Name" field and
          your password in the "Password" field.  The default "Command" launches
          the DECwindows session manager application from the VMS machine to
          your PC-Xware PC.  If you need to launch an application other than the
          session manager, change the entry in the "Command" field.

          All the information, excluding the password, can be saved as an icon
          in the PC-Xware program group.  From the VMS Session Launcher window,
          type a name into the "Icon Name" field then select the "Save as Client
          Icon" button.  Double-click to start the icon.  You will be prompted
          for your password before the application is launched.


      Tuning NCP on the PC

          To increase performance under DECnet on the PC, the following items
          should be altered in the PC's NCP database.

            NCP> SHOW EXECUTOR CHAR
            (Suggested minimums)
            NCP> DEFINE EXECUTOR MAXIMUM BUFFERS 16
            NCP> DEFINE EXECUTOR MAXIMUM LINKS 32
            NCP> DEFINE EXECUTOR TRANSMIT PIPE QUOTA 6
            NCP> DEFINE EXECUTOR RECEIVE PIPE QUOTA 6


      VMS DECWindow Hints

          Here are some hints/suggestions when using PC-Xware in a VMS
          DECWindow environment:

          1.If you get a LANGUAGE error when starting your DECTERM, you may
            have to alter your DECW$TERMINAL_DEFAULT.DAT file to include the
            following line:

             DEC$TERMINAL.main.terminal.xnlLlanguage: en_us

          2.If you are not seeing a change in the BIG and SMALL fonts when
            altering your DECTERM options, you may have to indicate a specific
            font selection for these values.  You will have to alter your
            DECW$TERMINAL_DEFAULT.DAT to include the following:

             DECW$TERMINAL.main.terminal.bigFontSetName:
                    -*-Terminal-*-*-*--18-*-75-*-*-*-*-*-*-*

             DECW$TERMINAL.main.terminal.littleFontSetName:
                    -*-Terminal-*-*-*--14-*-100-*-*-*-*-*-*-*

          3.To start an REXEC session using a TCP/IP transport, the following
            steps should be followed:



            a. Create a file in your users login directory which has
               the following lines (STARTME.COM or some filename)

               $ set display/create/transport=<type>/node=<ip address>
                                           9



                    $ @sys$manager:decw$startsm

            where:
                <ip address> is the TCP ip address for your PC
                   <type> is the transport name for your VMS TCP/IP.

            NOTE: Transports could be TCPIP, WINTCP or FUSION

            b. When starting PC-Xware, the connection type in the PC-
               Xware dialog should be REXEC and the application should be:
                         SUBMIT STARTME

          4.The version of MOTIF should be 1.1 for better performance.

          5.If you are trying to use FILEVIEW to start applications, a line in
            your SYLOGIN.COM or LOGIN.COM may cause a problem.  Remove the line

               $ set terminal/inquire

            Add the following line to improve startup of non interactive
            applications like DECterm.

               $ if (F$MODE() .EQS. "INTERACTIVE") .AND.
               (F$GETJPI("","TERMINAL").EQS. "") THEN GOTO EXIT

               To add logging, add the following line to the SYLOGIN.COM

               $ define DECW$VUE_OUTPUT "SOME_FILE_NAME"
































                                          10




      DEC Fonts Provided with PC-Xware

          Use the SELECTIVE INSTALLATION from the SETUP disk and select DEC
          fonts.

      X Utilities for DEC VMS

          The "VMS" directory on the Setup disk contains the file
          "vmsutils.exe." This is a self-extracting program that extracts the
          following X version 11 utilities and documentation:

           - xdpyinfo.exe          xdpyinfo.doc   (Displays X server 
                         			   information.)
           - xmodmap.exe           xmodmap.doc    (Displays the current 
                                                   keyboard map.
                                                   Allows modifications to the 
                                                   keyboard  map.)
           - keymap.401                           (DEC 401 keyboard->PC
                                                   example remapping file.
                                                   To be used with XMODMAP.
           - xlsfonts.exe          xlsfonts.doc   (Lists X font names.)
           - xev.exe               xev.doc        (Examines events (key 
                                                   press/releases, button 
                                                   press/releases, etc)
                                                   from the  X server.)
           - xlswins.exe           xlswins.doc    (Lists all the X Windows on 
                                                   the screen.)
           - xfd.exe               xfd.doc        (Displays characters in an X 
                                                   font.)
           - xrdb.exe              xrdb.doc       (Sets X resources.)

          To extract the applications and documentation, copy "vmsutils.exe"
          to a clean directory on the hard disk.  At the command line prompt
          invoke:
                    vmsutils



      To Run the X Utilities

          1.Transfer the X Utilities to your DEC VMS machine.
            This can be done  using the DECnet "NFT COPY" command
            or if TCP/IP  FTP.

          2.Start PC-Xware and connect to your VMS machine.

          3.Start your DECwindows applications.

          4.From a DECterm window, create a foreign symbol for
            each X Utility.




          For example:

           $ XMOD :=="$DKA300:[TOOLS.XCLIENTS]XMODMAP.EXE"
           where:
               XMOD   - is the name of the symbol
                                          11



               $ - used to specify a foreign symbol ***
               DKA300: - is the disk where the utilities reside
               [TOOLS.XCLIENTS] - is the directory where the utilities 
               reside

          5.Run the command by typing the symbol name:

                 XMOD -h     *** this will show available parameters ***

          6.Or if you need to supply command line options to the utility

                 XMOD -pk

          7.If you need to use the example keyboard remapping file:

               XMOD KEYMAP.401


     Far East Fonts

          If you need any of the following Far Eastern font files,

               hanglg16  hanglm16  hanglm24
               jiskan16  jiskan24  k14

          please contact the Sales Department at NCD PC-Xdivision and request
          the "PC-Xware Far East Font Option."

































                                          12




     PC-Xware on a Network File Server

      Running PC-Xware from a network file server

          The PC-Xware program and font files that are typically installed on
          your computer's hard disk may also be installed on a network file
          server.  You can then run PC-Xware on any computer that has network
          access to the network file server.  To comply with the license
          agreement for PC-Xware, you must license each PC-Xware user on the
          network by purchasing a PC-Xware packaged product or a PC-Xware multi-
          user license.  For information on network use restrictions see your
          PC-Xware license agreement.


      Installing PC-Xware on a network file server

          Run the PC-Xware installation (setup.exe) program.  When the
          installation program asks you for a Serial Number and Authorization
          code type in a Serial Number and Authorization Code that has been
          supplied for your site.  Next, when the installation program displays
          the Standard Install or Selective Install
          that the Selective Install option be selected so that all of the
          available fonts may be installed on your network file server.  This
          will allow PC-Xware to support the different display resolutions that
          might be on your network.  Moving on, when the font selection dialog
          is presented select all of the fonts that you wish made available for
          your site.  Continue on to the network interface dialog and select an
          interface that may be used at your site.  This selection can be
          changed by individual network nodes later.

            NOTE:  It is assumed that the network stack is already installed on
            each network workstation.

          When the installation program asks for the name of the directory where
          you want to install PC-Xware, type the name of the network directory.

            NOTE:  You must have read-write and directory creation access to
            the network file directory for the setup program to install PC-
            Xware on the network file server.

          Now, if you have multiple network software installations at your site,
          the remaining network modules must be copied from the Setup disk.
          This is done by using the DOS expand utility with each of the IF*.EX_
          and IF*.DL_ modules on the Setup disk.  The files must be expanded
          from the Setup disk onto the network server disk where PC-Xware is
          installed.  Expand each one of the IF*.EX_ files as follows:

               expand b:IFname.EX_  n:IFname.EXE

          Then do the same with the IF*.DL_ files as follows:

               expand b:IFname.DL_  n:IFname.DLL



          After completing the installation on the network file server there are
          some files that will need to be saved for later installation on each
          node.  Make a directory in your installation directory (let's call it
          NODE) and copy the following files into that directory:
                                          13




          XWARE.INI
               This file is created by the installation program and will be
               found in the Windows installation directory (typically \WINDOWS)
               on the local machine.

          PCXWARE.GRP
               This file is created by the installation program and will be
               found in the Windows installation directory (typically \WINDOWS)
               on the local machine.

          It is recommended that after completing the installation of
          PC-Xware on the file server that you make the PC-Xware installation
          directory READ-ONLY so that data may not be inadvertently modified or
          destroyed.


      Setting up PC-Xware on a network workstation

          To set up a network node to use PC-Xware from the network file server
          following the following steps:

          1.Copy PCXWARE.GRP from the installation directory created above
            (\NODE) on the network file server to the local machine's Windows
            directory (typically \Windows).

          2.Copy XWARE.INI from the installation directory created above
            (\NODE) on the network file server to the local machine's Windows
            directory (typically \Windows).

          3.Create a local directory for PC-Xware.  For this example call it
            \PCXWARE.

          4.Copy BIGWIN.386 from the installation directory on the network file
            server to the local \PCXWARE directory created in step 3 above.

          5.With Windows Notepad or your favorite text file editor open the
            local version of XWARE.INI modify the unit-installation-directory=
            line to reflect the fully qualified path for this network node to
            access the PC-Xware root directory on the file server.  It may not
            be necessary to change this item if the initial installation was
            done to a standard network drive location.

          6.Modify the net-network-software-type= line to match the type of
            network software on this node.  This must be one of the strings
            from the left hand column of the following list.

              BWTCP        Beame and Whiteside
                              TCP/IP
              NEWT         NetManage Chameleon/NEWT
              DECNET       DEC Pathworks DECnet
              DNWTCP       DEC Pathworks DECnet-
                              TCP/IP
              PCTCP2       FTP Software version 2.10
                              or later
              HPARPA       HP ARPA Services
              MSLNMN       Microsoft Lan Manager
              NLANWP       Novell LAN WorkPlace
              PCNFS        Sun Microsystems PC-NFS
              3COMNT       3COM TCP
                                          14



              WINSOCK      Windows Sockets
              PATHWY       Wollongong Pathway
              REFLEC       WRQ Reflection Network
              UBTCP        Ungermann-Bass TCP/IP

          7.Modify the unit-serial-number= and unit-authorization-code= lines
            with this node's licensed serial number and authorization code.

          8.Add the config-named-changes-file= line to reflect the fully
            qualified path of the local directory where CHANGES.USR (file does
            not yet exist) will be stored.  This should be the same local
            \PCXWARE directory created in step 3 above.  The following is an
            example using the path specified in 3 above:

               config-named-changes-file=C:\PCXWARE\CHANGES.USR

            This is the user's personal preferences configuration file.  Save
            your local version of XWARE.INI.

          9.With Windows Notepad or your favorite text file editor open
            SYSTEM.INI in the Windows installation directory and add the
            following device line to the [386Enh] section.
               device=C:\PCXWARE\BIGWIN.386

            The C:\PCXWARE portion of the above path should be the same path as
            specified in 3 above.  Save your modified system.ini file.

          10.  In the File menu of the Program Manager select the New menu item.
            In the New Program Object dialog box select the Program Group
            button and then select the OK button.  In the Program Group
            Properties dialog type the following in to the Description edit
            box:

                    PC-Xware

             Tab to the Group File edit box and type the PCXWARE.GRP
             with a fully qualified path.  For a typical Windows installation
             the text would be:

                    C:\WINDOWS\PCXWARE.GRP

       At this point the PC-Xware for Windows group has been installed.  If the
       unit-installation-directory variable was modified in XWARE.INI (step 5
       above) then the following steps must be followed for the   PC-Xware
       icons to function properly:

          1.Select the PC-Xware icon in the PC-Xware for Windows group box by
            clicking once on the PC-Xware icon.  In the File menu of the
            Program Manager select the Properties menu item.  In the Program
            Item Properties dialog box edit the Command Line edit box to
            reflect where PC-Xware directory is on the network.  This should
            match what you set the unit-installation-directory variable to in
            XWARE.INI above.  Select the OK button when the path has been
            updated.

          2.Repeat step 1 for the Font Tools and Network Test Icons.

       This should complete the local installation of PC-Xware.  After
       restarting Windows, double clicking the PC-Xware icon should startup PC-
       Xware as if it were installed locally.
                                          15





     Features

      PC-Xservices Console

          The PC-Xservices Console, similar to the console on NCD X terminals,
          can be activated by a single keystroke.  From the
          PC-Xservices Console select the Setup menu and then the "Change User
          Preferences..." menu item.  Click on the "Keyboard" item and then
          select a key: F10, F12 or "Pause" from the "Setup Key (raises PC-
          Xservices)" option.  Select "Apply" to activate the selection.

          If you would like an icon in your PC-Xware program group for the
          PC-Xware PC-Xservices console, perform the following steps:

          1.Select the Program Group you wish to place the icon in by
            clicking your mouse on the title bar of the Program Group.

          2.Select the File menu of the Program Manager and click the New...
            menu item.

          3.Select the Program Item button in the New Program Object
            dialog and then click the OK button.

          4.In the Program Item Properties dialog select the Browse button.
            In the Browse dialog change to the PC-Xware installation directory
            and select the file XWCONSOL.EXE and then click on the OK button.

          5.In the Program Item Properties dialog fill in the Description
            edit box with a title identifying the icon (e.g. PC-Xservices).

          6.In the Program Item Properties dialog fill in the Working
            Directory edit box with the fully qualified installation path (e.g.
            C:\PCXWARE) and click the OK button.  The icon will appear in the
            selected Program Group.


      PC-Xware Desktop

          The PC-Xware Desktop is a useful utility to allow the user to access
          cut and paste operations and to quickly bring up other menus.

          If you would like an icon in your PC-Xware program group for the
          PC-Xware Desktop, perform the following steps:

          1.Select the Program Group you wish to place the icon in by
            clicking your mouse on the title bar of the Program Group.

          2.Select the File menu of the Program Manager and click the New...
            menu item.

          3.Select the Program Item button in the New Program Object dialog
            and then click the OK button.

          4.In the Program Item Properties dialog select the Browse button.
            In the Browse dialog change to the PC-Xware installation directory
            and select the file XWDESK.EXE and then click on the OK button.


                                          16



          5.In the Program Item Properties dialog fill in the Description
            edit box with a title identifying the icon (e.g. PC-Xware Desktop).

          6.In the Program Item Properties dialog fill in the Working
            Directory edit box with the fully qualified installation path (e.g.
            C:\PCXWARE) and click the OK button.  The icon will appear in the
            selected Program Group.


      PC-Xware Settings

          The PC-Xware Settings is a windows utility to access common
          PC-Xware configuration choices.  If you would like an icon in your
          PC-Xware program group for the PC-Xware Settings, perform the
          following steps:

          1.Select the Program Group you wish to place the icon in by
            clicking your mouse on the title bar of the Program Group.

          2.Select the File menu of the Program Manager and click the New...
            menu item.
          3.Select the Program Item button in the New Program Object dialog
            and then click the OK button.

          4.In the Program Item Properties dialog select the Browse button.
            In the Browse dialog change to the PC-Xware installation directory
            and select the file XWCONFIG.EXE and then click on the OK button.

          5.In the Program Item Properties dialog fill in the Description
            edit box with a title identifying the icon (e.g. PC-Xware
            Settings).

          6.In the Program Item Properties dialog fill in the Working
            Directory edit box with the fully qualified installation path (e.g.
            C:\PCXWARE) and click the OK button.  The icon will appear in the
            selected Program Group.


      Numlock Support

          Local NUMLOCK Support gives you the ability to decide whether or not X
          clients will receive a keycode when the NUMLOCK is pressed. If you
          have this switch turned on (the default), then PC-Xware will intercept
          the NUMLOCK key code and do the necessary processing of the numeric
          keypad keys.  If this switch is off, PC-Xware sends the NUMLOCK
          keycode through to the client, assuming that the client will deal with
          it appropriately.  Some clients know how to do that, and, in fact,
          won't deal with the keypad keys correctly unless they see the NUMLOCK
          key activity.  This switch was designed for those clients.  If you're
          using one of them, then you'll want to turn off this switch.

          To change Numlock support, from the PC-Xservices Console select the
          Setup menu and then the "Change User Preferences..." menu item.  Click
          on the "Keyboard" item.  The "Local NUMLOCK support" button can be
          toggled between on and off.





                                          17




      The Windows Bitmap Cache

          NCD has added a flexible Windows Bitmap Cache that gives you control
          over Windows system resources.  This is particularly useful when
          running other Windows applications that require large amounts of
          Windows system resources.  You can control the total number of Windows
          bitmaps that PC-Xware will use and also control whether or not PC-
          Xware caches Windows bitmaps at all.  You can do that from
           PC-Xservices Console->Setup->Change Setup Parameters:

               - Select X and Graphics
               - To toggle bitmap caching:
                    Click the 'Enable Windows Bitmap Cache' button
               - To change the cache size
                    Click on and move the 'Windows Bitmap Cache
                    Size' slider.

          Move the slider left to decrease the cache size and right to
          increase it.  PC-Xware comes configured to use 100 bitmaps.  The
          minimum cache size is eight, the maximum is 256.  Caching is enabled
          by default.


      XDM Terminates Default Window Manager

          PC-Xware's local window managers are PC resident X applications.  When
          an XDM session begins, it terminates all running X applications.
          Hence, XDM terminates your PC-Xware local window manager.

          To automatically enable your PC-Xware local window manager, start  the
          window manager as part of the .xsession file that is used by XDM.
          Here is an example of the command that would be in the .xsession:

               PCNAME=`echo $DISPLAY | cut -d: -f1'`
               rsh $PCNAME mswm   # starts local MS Window Manager
                    or
               rsh $PCNAME wm       # starts local NCD Window Manager




      PCXTrace -- X Protocol Tracer

          The PCXTrace application is a protocol tracer for the X Window System.
          It affords developers, technical support, and others interested in the
          X Protocol, or debugging X applications, the real-time ability to
          examine how a program is interacting with the X Server. This protocol
          is defined in volume zero of the O'Reilly series of X books, or in the
          book "X WINDOW SYSTEM", by Scheifler & Gettys.

          PCXTrace is an MS-Windows application, and can either tie directly
          into the running PC-Xware server (default), or function independent of
          both the application and the server - as a pass-through conduit.

          Useful in its ability to capture runtime sessions of an application,
          PCXTrace can be utilized by X users having problems with their
          applications. The NCD Technical Support staff can utilize the trace
          files created by this application to remotely diagnose problems and
          provide solutions you experience on-site.
                                          18




          PCXTrace is copied to the hard disk during installation.  Users can
          add it to the PC-Xware program group using the Program Manager's 'New'
          menu item from the File menu.  PCXTrace is installed in the PC-Xware
          directory as 'pcxtrace.exe'.

          To use the default method of executing a protocol trace:
            - With PC-Xware already running, start PCXTrace by double clicking
              on the PCXTrace icon.
            - Click on the 'Start Listen' button.  A 'Listen' *Active* icon
              will be displayed at the lower left of the PCXTrace window.
            - At this point any new client will be traced.

          For further information on suspending or listing traces, setting trace
          options or other features of the protocol tracer, please refer to the
          Help menu provided with PCXTrace.


      X Client Icons

          X application icons are now fully displayed in PC-Xware under the
          local Microsoft Window Manager.  In releases prior to  PC-Xware 1.02,
          an X client icon would be "cropped" to fit within the MS Windows 32
          bit icon boundary.




































                                          19




     Utilities

      DOSMEM - Display DOS (640K) memory usage under Windows.

          Microsoft Windows sometimes fails to perform tasks when not enough low
          DOS memory is available.  Windows is largely able to resolve this lack
          of memory by having most information stored in movable memory chunks.
          When low DOS memory becomes scarce, Windows can relocate the
          information in these movable chunks into higher addresses.  Not all
          Windows allocations can be made movable; in particular the basic
          Windows code is all fixed in low memory, consuming about 200K.  Other
          portions of the system may need fixed low memory, typically to
          interact with the real-mode DOS environment, such as TSR based network
          systems.  DOSMEM is designed to help the Windows user discover what
          portions of their environment are consuming this critical resource.

          To install DOSMEM, add it to the PC-Xware program group using the
          Program Manager's 'New' file menu item.  DOSMEM is installed in the
          PC-Xware directory as 'dosmem.exe'.  Start it by double clicking on
          the icon.

          There are two sections of information provided.  The first section is
          summary information, containing a summation of the amount of fixed low
          memory used by Windows, PC-Xware and other portions of the system.
          Below that is a summary of the amount of low memory available.
          Because Windows can manipulate memory usage by moving some pieces of
          information around, a large portion of low memory may be in use, but
          can easily be freed when necessary by moving that information into
          higher memory.  Thus the amount of available low dos memory is the sum
          of the free and allocated-but-movable pieces.

          Below this summary information is an itemized list of users of fixed
          low memory, identified by an internal Windows name.  Some of these
          names are obviously related to a particular program, other names are
          not.  It may be useful to save a copy of the information before
          starting an application and comparing the results while the
          application is running to discover which allocations that application
          is responsible for.  Items which are part of the basic Windows system
          are marked with a 'W', while parts of PC-Xware are marked with an 'X'.
          Any other items are marked with an 'O'.  The mechanism for identifying
          these classifications is not particularly accurate, meaning that some
          items may be mis-classified.
          DOSMEM doesn't automatically update this information, instead the user
          is responsible for using the Update menu item whenever new information
          is needed.



     Limitations

       o File and Print services are not available with XRemote.

       o When making an XDM connection from the PC-Xware Available Connections
         window, the Login Chooser is sometimes displayed for a very short
         period before the XDM login window appears.  This is due to a delayed
         XDM connection caused by heavy network traffic or host use.  This does
         not adversely affect the operation of  PC-Xware.


                                          20



       o Due to problems with PC-Tools for Windows desktop software, icons
         created with PC-Xware will not be accessible.  It is recommended that
         you create your PC-Xware icons while NOT running PC-Tools for Windows.

       o When using PseudoColor visuals, Microsoft Windows applications that
         allocate more than the 20 standard Microsoft Windows colors will not
         get the correct colors copied into the Microsoft Windows clipboard
         when using Microsoft Windows cut and paste.  Microsoft Windows Excel
         is one such application.

       o PC-Xware opens all available serial ports on startup.  This may
         prevent some devices, such as a serial printer, from working correctly
         after starting PC-Xware.  To prevent PC-Xware from opening a serial
         port, add the following line for each serial port to the CHANGES.USR
         file (or specified configuration file) located in the PC-Xware CONFIGS
         sub directory:

                    serial-test-for-com2 = false

       o When using a Hercules Graphics Station video adapter, PC-Xware may
         conflict with the video card.  To prevent any conflict, add the
         following line to the PC-Xware configuration file (CHANGES.USR by
         default):

                    serial-test-for-com3 = false



       o The default PC-Xware configuration is to use the Microsoft window
         manager (mswm).  In some cases, especially when using XDM, this
         interferes with the startup mechanisms of some clients and may result
         in incorrect execution of the client and PC-Xware.  If this occurs
         invoke PC-Xservices->Setup->Change Setup Parameters...  Under Commands
         and Startup delete the mswm or ncdwm entry in the Startup Commands
         section.  This problem has been seen specifically with the HP Vue
         login window.

       o For the ATI Graphics Ultra family of display drivers, if images are
         incorrectly displayed, i.e. xgif images, use the ATI driver
         configuration program, flexdisk (MS Windows application), to correct
         the problem.  Under the advanced options heading change device bitmaps
         from 'on' to 'off' to correct the image display.

               You can download a later driver from the ATI BBS (416/764-9404).


       o Eight Bit Characters*
         The PC-Xware 1.0 and 1.01 releases have unexpected  behavior with
         regard to eight bit characters. This behavior affects European
         customers using the Telnet protocol.

         The misbehavior has to do with the <return> keyboard key not
         functioning as expected when the NCDterm resources for eight bit
         operations are enabled. If you are having problems, where you need
         to enter ^J to login, and get extra ^M's on input at the command line
         prompt, this is the problem.

         With the 1.02 release of PC-Xware, follow these steps:
           1) Set the .Xdefaults resources for eight bit as follows:

                                          21



               NCDterm.eightBitInput:  True
               NCDterm.eightBitBinary: False

           2) Load the resources using xrdb prior to starting NCDterm.

         This will make the input/output telnet stream function with "correct"
         newline translations in the Telnet binary mode used when
         eightBitInput is enabled.

         If you encounter problems with the addition of CR on LF output, it is
         recommended that you operate in eightBitBinary: True mode. This might
         require replacement of the telnetd on your system with one handling LF
         on input correctly. It's a known problem of Sun systems that setting
         eightBitBinary to True will present the problem described with ^J and
         ^M needed. Solbourne and others seem to work correctly.

         The specific bits needed for correct filtering of ISO eight-bit
         characters are:

           cs8      character size of eight bits
           -istrip       don't strip characters to seven bits
           icrnl         map CR to NL on input
           opost         post-process output enabled
           onlcr         map NL to CR-NL on post-process output

         For completeness and correctness, the user might wish to have the
         command "stty cs8 -istrip icrnl opost onlcr" in their .profile or
         .cshrc startup file.
































                                          22


