Ref: 99970049
Title: Rel Note - SW/1-PCS Ver 2.0 (pt no 5347-00 )
Date: 12/13/89

Copyright 3Com Corporation, 1991.  All rights reserved.

SW/1-PCS Version 2.0

TO:  PCS/1 Users
FROM: 3Com Corporation
SUBJECT: SW/1-PCS Version 2.0
DATE: November 17, 1989

Enclosed are three distribution diskettes containing SW/1-PCS Version 2.0
and hardware diagnostics to be used on your personal computer.

This release memo is an addendum to the PCS/1 User's Guide (May 1989
edition) and the ILANA Installation Guide (December 1989 edition).  It
outlines the features added and bugs fixed since Version 10010.  It also
describes the compatibility, limitations, and known problems of Version
2.0.

** CAUTION **

Consult your installation guide before installing your ILANA board.  When
setting ILANA base memory, make sure no other add-on boards (such as VGA
board, hardware debugger, and so forth) are using the same memory address.




New in This Release
===================

- Software should be installed by network manager to ensure security.

- ILANA/XT board can be configured for a 32-kilobyte window.

- Local HOSTS file lets you store host names and internet addresses.

- Access control support with additional access control commands.

- Domain name service support.

- PIng command available to test operability of network hosts.

- PCSBAPI can be installed as a TSR or TLM program.

- New hardware diagnostics program supports 32-kilobyte windows.

- Four IP security options are now available per RFC-1038.

- New SETDefault command parameters.

- New SHow command parameters.

- The NetBIOS scope feature is available and changeable by using the
  SETDefault command.



** NOTE **

3Com changed its software version numbering scheme in early 1989.  Instead
of using a five-digit number, such as 20060, 3Com now uses two- or three-
digit numbers, such as 2.2 and 2.21.  Higher version numbers represent more
recent releases.  For example, 2.21 is more recent than 2.2, 2.2 is more
recent than 20060, and 20060 is more recent than 20000.


Compatibility
=============

SW/1-PCS Version 2.0 can operate with the following products and software
releases:

CS/1 running SW/1-TCP Version 3.0 or higher
CS/1 running SW/1-T-SNA Version 21000 or higher
CS/1 running SW/20-TCP Version 3.0 or higher
CS/50 running SW/50-TCP Version 3.0 or higher
CS/100 running SW/100-TCP Version 3.0 or higher
CS/200 and CS/210 running SW/200-TCP Version 3.0 or higher
NCS/AT running SW/AT Version 10000 or higher
NCS/2 running SW/2-NCS Version 20000 or higher
GS/3-IP running SW/3-IP Version 10000 or higher
Personal computer running SW/PCS-TCP Version 20000 or higher
IB/2 running SW/20-IB Version 20000 or higher

Table 1 illustrates the hardware and firmware compatibility of SW/1-PCS
Version 2.0.


Table 1  Hardware/Firmware Compatibility


 Product      Boards              PROMS

 PCS/1        ILANA/XT            P1 MMON
  Rev. 04 or higher Rev. 01A or higher

 PCS/1        ILANA/AT            P1 MMON
   Rev. 01A or higher



Software Installation
=====================

The software installation procedure has changed since Version 10010.  While
a network user could install Version 10010, the network manager should
install Version 2.0 to ensure network security.  Refer to the PCS/1 User's
Guide for the software installation procedure.

If your PC has more than 512K of base memory, you cannot use the 080000 and
090000 base addresses.


New Features
============

The following features have been added to SW/1-PCS since Version 10010.
Refer to the PCS/1 User's Guide for further information on these features.

- Version 2.0 supports an ILANA/XT board with a 32-kilobyte shared memory
  window.

    ** NOTE **

  Follow the instructions in the PCS/1 User's Guide to configure the
  ILANA/XT board for a 32-kilobyte window.  In addition, you must place a
  shorting plug on Pin C at configuration area E2.

- You can create a local hosts file, which is a database containing the
  host names and internet addresses, on your PCS/1 working disk.  PCS/1
  uses this file to resolve commands that reference host names.

- Version 2.0 supports access control, which ensures that only authorized
  users can access the network.

- These are the new commands that you can enter at the PCSMGR> prompt when
  access control is in effect:

- The LOGIn command allows you to gain access to the network if you are an
  authorized user.

- The LOGOut command allows you to disconnect from the network.

- The PASSWord command allows you to change your password for network
  login.

- Version 2.0 supports the Domain name service for resolving commands that
  reference internet names.

- Another new command that can be entered at the PCSMGR> prompt is the PIng
  command.  It is available whether or not access control is in effect.  It
  determines whether a host on the network is operating.

- Version 2.0 supports the NetBIOS scope ID.  If the NetBIOS scope ID is
  set to anything other than null, only those names with the same scope ID
  are recognized.  The NetBIOS scope ID can be displayed and changed within
  the PCS Manager program.

- The SHow GLobal command allows you to view the current Net BIOS scope.

- To set the NetBIOS scope to "netbios.3com.com", type the following as one
  line:

  SETDefault NetBiosScopeId=
  "netbios.3com.com"

- The SETDefault command supports the following new parameters:

- The SECurityServerAddress parameter allows you to specify the address of
  the 3Com Network Control Server (NCS) that acts as the security server.
  This parameter is available only when access control is in effect.  You
  can set it before or after network login.

- The DomainName parameter specifies the default domain string for all
  domain names entered on the personal computer.  If access control is in
  effect, this parameter is available only after network login.  It is also
  available if access control is disabled.


- The NameServerType parameter determines the type of name service (IEN116
  or Domain name service) used by the personal computer.  If access control
  is in effect, this parameter is available only after network login.  It
  is also available if access control is disabled.

- To set the NetBIOS scope to "netbios.3com.com", type the following as one
  line:

   SETDefault NetBiosScopeId=
   "netbios.3com.com"

- The SHow command supports the following new parameters:

- The SHow GLobal command displays the values of three new parameters:
  DomainName, NameServerType and NetBiosScopeId.  These parameters are
  described under the SETDefault command.

- The SHow GatewayServer command displays the internet address of the
  default Gateway server.  The GatewayServer parameter is only available
  when access control is in effect and you have not logged into the
  network.  If access control is disabled or you have logged into the
  network, use the SHow InternetServers command to display the internet
  address of the Gateway server.

- If access control is in effect, the SHow InternetServers command displays
  the internet address of the Security Server, in addition to the internet
  addresses of the Audit Trail Server, the Name Server, and the Gateway
  Server.

- If access control is in effect, the SHow LOgin command displays the login
  name that has been used to log into the network.

- The SHow SecurityServer command displays the internet address of the NCS
  that acts as the security server.  This command is available only when
  access control is enabled and you have not logged in to the network.  If
  you have logged in, use the SHow InternetServers command to display the
  internet address of the security server.

- You can optionally invoke PCSBAPI as a terminate-and-stay-resident (TSR)
  program or as a terminate-and-leave-memory (TLM) program.  If you want to
  make PCSBAPI a TLM program, include either the /F or /T parameter in the
  PCSBAPI command line in the AUTOEXEC.BAT file.  If you want to make it a
  TSR program, use neither of these parameters.

- SW/1-PCS Version 2.0 includes a separate diskette that contains a new
  hardware diagnostics program.  This diskette should supersede any
  previous version of diskette.  The old program will not work with a 32K
  window.  See Appendix D in the ILANA Installation Guide for information
  on hardware diagnostics.

The following new feature is not described in the PCS/1 User's Guide:

- IP Security options are now available.  These options are set in the
  ILANALOD command line in the AUTOEXEC.BAT file.  There are four options
  available:


- Security level can be set to one of the following values:

  LU (unclassified)
  LC (confidential)
  LS (secret)
  LT (top secret)

If you do not specify a value for security level, the default value LU
(unclassified) is used.

- Authority mask can be set to one of the following values:

  AGE (GENSER)
  ASI (SIP)
  ASP (SPINTCOM)
  ACR (CRITICOM)

 If you do not specify a value for authority mask, the default value AGE
(GENSER) is used.

- The secure option flag determines whether packets are sent with secure
  options when security level is unclassified and authority mask is GENSER.
  To send packets with secure options, set this value to SS.  If you do not
  specify a value for this option, the default is no secure options sent.

- The source routed datagram flag determines whether or not source routed
  datagrams are accepted.  To set this option to no source routed datagrams
  accepted, use the value NSR.  If no value is specified, the default is
  source routed datagrams accepted.


 For example, to set the IP security level to secret (LS) and the authority
mask to GENSER (AGE), and to disable the receipt of source routed
datagrams, specify the following (on a single line) for the ILANALOD line
in the AUTOEXEC.BAT file:

 ILANALOD /LS /AGE /NSR xxx.xxx.xxx.xxx

 The x's represent the IP address.


Known Problems
==============

The following is a list of problems that exist in SW/1-PCS Version 2.0:

- You should be able to indicate that no Enter Command Mode (ECM) character
  is to be used by specifying no ECM character on the PCSBAPI command line
  in the AUTOEXEC.BAT file.  Currently, however, if no ECM character is
  specified, the default character ([Ctrl] + ^) is used.

- If the NameServerType parameter is set to Domain, and you use the "SHow
  NAmes" command with the -s option, a message similar to the following
  appears:

   Querying the Secondary Name Server...

 If the NameServerType parameter is set to Domain, and you use the "SHow
 NAmes" command with the -p option, a message similar to the following
 appears:

   Querying the Primary Name Server...


 In fact, regardless of the option specified, when NameServerType is
 Domain, PCS/1 resolves the name by querying the local HOSTS file, the
 Primary Name Server, and the Secondary Name Server, in that order.

- If you use the PASSWord command to change your password, the new password
  must be no longer than 14 characters.  Otherwise, an error message
  appears and you must reboot your personal computer.  After rebooting, you
  cannot use the old password to log in.


Limitations
===========

The following is a list of limitations in SW/1-PCS
Version 2.0:

- If PCS/1 is configured to use a 128-kilobyte window and to support 64
  sessions, you must use the internet address, not the internet name, to
  connect to a host for the 64th session.

- To enable or disable access control, you must ensure that the
  PCSGLOBL.DAT file is in the path that is specified by the SET PATH
  command line in the AUTOEXEC.BAT file.

- When PCS/1 is running the FTP File Transfer Service, using the GET or
  RECv command to transfer a large file from a host to a full floppy
  diskette may disconnect the system from the host.  The system responds to
  the GET command by displaying the following message:

 Lost connection with <hostname>

 After disconnection, the system displays the "ftp>" prompt.


 If the file to be transferred is small, the system functions correctly.
 It maintains the connection and displays the following warning message:

 Out of space on local disk

- The ILANA board cannot be configured to run from the E0000 segment of the
  personal computer.

- To use NetBIOS, the default gateway address must be set to 0.

- The Quote command is displayed in the FTP help screen, but is not
  supported.

- To use PCS 3270, note the following:

- When the window size is 128K, you can have up to (but not including) 32
  sessions.

- When the window size is 64K, you can have up to (but not including) 16
  sessions.

- When the window size is 32K, you must have above four sessions.


Additions/Changes to the Manuals
================================

- The ILANA board can coexist with the following boards:

 - Intel Above Board
 - AST RAMPage! Board
 - AST RAMPage AT Board
 - AST Advantage Board


Documentation
=============

The following manuals are shipped with SW/1-PCS
Version 2.0:

- PCS/1 User's Guide (May 1989)
 (Part Number: 09-0102-01)

- ILANA Installation Guide (December 1989)
 (Part Number: 09-0154-00)

If you have further questions, please contact your network supplier or 3Com
for help.


Trademarks
==========

ILANA/XT and ILANA/AT are trademarks of 3Com Corporation.  Intel and Above
are trademarks of Intel Corporation.  RAMPage!, RAMPage AT, and Advantage
are registered trademarks of AST Corporation.
