CNA-8000 Installation and Configuration Manual

CNA-8000 Channel Network Appliance
Installation and Configuration
P/N
707158-003
CNA-8000 Installation and Configuration
Revision Information
Comments
Initial Release
Second Release
Third Release
707158-003
Issue/Revision Schedule
Revision Number
707158-001
707158-002
707158-003
Date
02/27/2013
08/15/2013
10/10/2013
iii
CNA-8000 Installation and Configuration
Table of Contents
Revision Information ......................................................................................................... iii
Table of Contents.................................................................................................................v
Chapter 1. CNA-8000 Installation ................................................................................... 1-1
Product Overview ....................................................................................................... 1-1
Initial Installation ........................................................................................................ 1-2
Chassis Installation ..................................................................................................... 1-3
Rack Installation ......................................................................................................... 1-4
Cabling the CNA-8000 for Power .............................................................................. 1-6
Cabling for ESCON .................................................................................................... 1-7
Cabling for FICON ..................................................................................................... 1-8
Cabling for Ethernet.................................................................................................... 1-9
Cabling for Token Ring ............................................................................................ 1-10
Cabling for SDLC ..................................................................................................... 1-11
Local Console Control .............................................................................................. 1-12
Editing the FEP4600.ini File..................................................................................... 1-12
Powering up the CNA-8000 ..................................................................................... 1-13
Chapter 2. Configuration Overview................................................................................. 2-1
The Configuration Process of the CNA-8000............................................................. 2-2
Initial Configuration of the CNA-8000....................................................................... 2-3
Initial Connection Panel.............................................................................................. 2-4
Login Panel ................................................................................................................. 2-5
CNA-8000 Status Panel .............................................................................................. 2-6
Configuration Panel Tree............................................................................................ 2-8
Making Configuration Updates................................................................................... 2-8
Network Options Panel ............................................................................................... 2-9
Field Definitions .................................................................................................. 2-10
Button Definitions................................................................................................ 2-11
Server Options Panel................................................................................................. 2-12
Field Definitions .................................................................................................. 2-12
Button Definitions................................................................................................ 2-14
Security Options Panel.............................................................................................. 2-15
Enable/Disable Network Services........................................................................ 2-16
Button Definitions................................................................................................ 2-16
Connectivity Options ................................................................................................ 2-16
TN3270 ..................................................................................................................... 2-16
Save/Restore Configurations Panel........................................................................... 2-17
Deleting a Configuration...................................................................................... 2-18
Activating a Stored Configuration ....................................................................... 2-19
Saving the Current Configuration to a USB Drive .............................................. 2-19
Copy Configuration Files from a USB Drive ...................................................... 2-20
707158-003
v
Chapter 3. Connectivity Overview .................................................................................. 3-1
SNA Gateway ............................................................................................................. 3-1
Static LLC SNA Gateway Options ............................................................................. 3-2
Dynamic LLC SNA Gateway Options ....................................................................... 3-3
Static DLSw SNA Gateway Options .......................................................................... 3-4
Dynamic DLSw SNA Gateway Options..................................................................... 3-5
Static SDLC SNA Gateway Options .......................................................................... 3-6
TN3270E Gateway...................................................................................................... 3-7
Static Definitions or Pooled Definitions ................................................................ 3-7
Encryption Used or Not ......................................................................................... 3-7
Connection Password Requirement ....................................................................... 3-8
Resource Assignment Methods.............................................................................. 3-8
Connecting a TN3270E Client to a Specific LU ........................................................ 3-9
Using Client IP Address......................................................................................... 3-9
Using Listening Port .............................................................................................. 3-9
Using Predefined Format ..................................................................................... 3-10
Using Nicknames ................................................................................................. 3-10
Connecting a TN3270E Client to a Session Pool ..................................................... 3-11
Using Client IP Address....................................................................................... 3-11
Using Listening Port ............................................................................................ 3-11
Using Predefined Format ..................................................................................... 3-12
Using Nicknames ................................................................................................. 3-12
Using Client Subnet Address ............................................................................... 3-12
Select from a Menu Presented to the Client......................................................... 3-13
Chapter 4. ESCON XCA Configuration.......................................................................... 4-1
Update ESCON/FICON CUs Panel............................................................................ 4-3
Field Definitions .................................................................................................... 4-4
Button Definitions.................................................................................................. 4-5
UNITADD Address Format........................................................................................ 4-6
Configuring Subchannels............................................................................................ 4-6
Field Definitions .................................................................................................... 4-6
Button Definitions.................................................................................................. 4-7
Chapter 5. Token Ring Gateway...................................................................................... 5-1
Configuring Token Ring XCA LLC Drops ................................................................ 5-1
Field Definitions .................................................................................................... 5-2
Button Definitions.................................................................................................. 5-3
Drop Panel Option Determination .............................................................................. 5-4
Static vs Dynamic Drops ............................................................................................ 5-4
SAP Assignments ....................................................................................................... 5-4
Window Size Selection ............................................................................................... 5-5
Token Ring Drop Panel .............................................................................................. 5-6
Field Definitions .................................................................................................... 5-6
Button Definitions.................................................................................................. 5-8
Deleting Token Ring Drops ........................................................................................ 5-9
Button Definitions.................................................................................................. 5-9
vi
707158-003
CNA-8000 Installation and Configuration
Chapter 6. Ethernet Gateway ........................................................................................... 6-1
Configuring Ethernet XCA LLC and DLSw Drops ................................................... 6-1
Field Definitions .................................................................................................... 6-2
Button Definitions.................................................................................................. 6-4
Bit-Swapping LAN Addresses.................................................................................... 6-5
LLC Drop Panel.......................................................................................................... 6-7
Field Definitions .................................................................................................... 6-7
Window Size Selection .......................................................................................... 6-9
Button Definitions................................................................................................ 6-10
Deleting Ethernet Drops ........................................................................................... 6-11
Button Definitions................................................................................................ 6-11
Configuring the DLSw Drop Panel........................................................................... 6-12
Field Definitions .................................................................................................. 6-13
Button Definitions................................................................................................ 6-14
Chapter 7. SDLC Gateway .............................................................................................. 7-1
Configuring SDLC Lines............................................................................................ 7-1
Field Definitions .................................................................................................... 7-2
Button Definitions.................................................................................................. 7-4
SDLC Drop Panel ....................................................................................................... 7-5
Field Definitions .................................................................................................... 7-5
Button Definitions.................................................................................................. 7-6
Deleting SDLC Drops................................................................................................. 7-7
Button Definitions.................................................................................................. 7-7
Chapter 8. Gateway Circuit Configuration ...................................................................... 8-1
Field Definitions .................................................................................................... 8-2
Button Definitions.................................................................................................. 8-4
Chapter 9. Host Circuit Definition................................................................................... 9-1
Configuring XCA Host Circuits ................................................................................. 9-1
Field Definitions .................................................................................................... 9-2
Button Definitions.................................................................................................. 9-3
Chapter 10. TN3270 Client Configuration .................................................................... 10-1
Configuring Listen Ports........................................................................................... 10-3
Field Definitions .................................................................................................. 10-4
Button Definitions................................................................................................ 10-5
Configuring Session Pools........................................................................................ 10-6
Field Definitions .................................................................................................. 10-8
Button Definitions................................................................................................ 10-8
Configuring TN3270 Client Access.......................................................................... 10-9
Field Definitions ................................................................................................ 10-10
Button Definitions.............................................................................................. 10-11
Nicknames............................................................................................................... 10-12
Field Definitions ................................................................................................ 10-13
Button Definitions.............................................................................................. 10-13
Managing TN3270 User IDs................................................................................... 10-14
Field Definitions ................................................................................................ 10-15
Button Definitions.............................................................................................. 10-15
707158-003
vii
Acceptable Formats for User Defined Connection Requests ................................. 10-16
Making Dynamic TN3270 Changes ....................................................................... 10-17
Chapter 11. RPQs........................................................................................................... 11-1
viii
707158-003
CNA-8000 Installation and Configuration
Chapter 1. CNA-8000 Installation
This chapter covers procedures needed to position the CNA-8000 such that it is ready to
be configured.
Product Overview
The CNA-8000 is a versatile 3U, rack-mountable enterprise class server product capable
of running many features and functions traditionally supported by the Cisco CIP and
CPA products, the IBM 3172 and 2216, and the Visara 1174 Control Unit product family.
Features include:
 PU type 2 SNA gateway function over downstream connections including
Ethernet; Token Ring, and SDLC. Up to 2000 downstream PU2s and their
associated LUs are supported by the base software with an option for up to 2000
additional PU2s through a sales option.
 TN3270 Gateway function over Ethernet downstream connections. This is a sales
option with maximums of 4000, 8000, or 16000 concurrent sessions.
 Upstream connections for both the PU2 gateway and TN3270 gateway use XCA
as the upstream link over ESCON (up to 2 interfaces) and/or FICON (up to 4
interfaces).
 Integrated DLSw upstream function for PU2 gateway feature. This allows you to
support the SNA traffic over an IP connection (no LLC2 protocol on the local
LAN). This feature comes standard on the platform.
Configuration of the CNA-8000 is achieved by means of a secure web browser interface
(HTTPS). The CNA-8000 ships with a default configuration including a default IP
address. You must modify the configuration for your own network requirements. You can
browse to the unit from a PC or you can directly attach a monitor, keyboard, and mouse
directly to the platform and configure it from there. To attach from a PC, the IP interface
can be modified by editing or creating a text file (FEP4600.ini) located on a 3.5” floppy
(supplied with the base unit) using a PC, and inserting this file into the floppy drive of the
CNA-8000, prior to booting. Once booted, you can connect across the network to make
further customization. You may also opt to use a crossover (null) Ethernet cable, modify
the IP address of your PC and connect using the default IP address assigned to the unit in
the factory.
Once configured, the CNA-8000 is capable of running independently, without human
intervention. That is, if power is lost and regained, it will automatically boot back into
service using the stored configuration. You can manage the platform using the same
secure web browser connection from anywhere. Multiple management console interfaces
are supported by the CNA-8000, making it ideal for remote disaster recovery operations.
707158-003
1-1
Chapter 1. Installation
Initial Installation
Installation of the CNA-8000 consists of multiple steps, and may involve more than one
person. The CNA-8000 can be locally or remotely configured. Tasks required to
complete an installation include:
1.
Mounting the hardware platform (if desired) in a rack or placing the platform
within the necessary proximity of all of the network connections required to
satisfy the configuration.
2.
Cabling the unit for power, ESCON, FICON, Ethernet, Token Ring, and
SDLC connections as needed.
Locally configuring using direct attached console:
3.
Attach monitor, mouse, and keyboard directly to the unit.
4.
Once booted, select Start>Programs>Firefox.
Remotely configuring using a PC or other browser capable platform:
3.
Editing the FEP4600.ini file if necessary to provide access to a web browser
capable platform, such as a PC, or connect to the factory shipped address.
4.
Powering up the unit with the floppy containing the FEP4600.ini file.
5.
Connect to the platform with a web browser to finish the configuration.
Locally configuring using a PC and a crossover cable:
3.
Attach a null or crossover Ethernet cable between your PC or some other
browser capable device and the CNA-8000 Ethernet port 0.
4.
Reconfigure your PC to use an address that would be on the same network as
the factory default IP address used by the CNA-8000.
5.
Connect to the platform with a web browser to finish the initial configuration.
1-2
707158-003
CNA-8000 Installation and Configuration
Chassis Installation
Tools needed:
1. Phillips Screw Driver
2. Antistatic Strap
Installing Chassis Rails:
Please make sure that the chassis covers and chassis rails are installed on the chassis
before you install the chassis into the rack.
To avoid personal injury and property damage, please follow all the safety steps listed
below.
Before installing the chassis rails:
1. Enclose the chassis with chassis covers.
2. Unplug the AC power cord(s).
3. Remove all external devices and connectors.
Procedures to install chassis rails:
1. Included in the shipping package is a pair of rail assemblies. In each rail
assembly, locate the inner rail and the outer rail.
2. Press the locking tab to release the inner rail from its locking position and pull out
the inner rail from the rail assembly. (The inner rails are to be attached to the
chassis and the outer rails are to be installed in the rack.)
3. Locate the five rail buttons and each side of the chassis and locate the five
corresponding holes on each of the inners rails.
(Please note that one end of the hole is larger than the other end of the hole.)
4. Align the larger end of each hole against its corresponding button. Once all
aligned, push the holes toward their corresponding buttons and the rail is placed
on the chassis.
5. Once the rail is placed on the chassis, pull the rail forward until the rail buttons
lock in the small ends of the corresponding holes.
707158-003
1-3
Chapter 1. Installation
6. Secure the rail to the chassis with a Type G screw. Repeat the above steps to
install the other rail on the chassis.
Rack Installation
After you have installed the inner rails on the chassis, you are ready to install the outer
rails of the rail assemblies to the rack.
(The rails are designed to fit in the racks with the depth of 28-33”.)
Procedure:
1. In the package, locate a pair of front (short) and rear (long) brackets. Please note
that the brackets are marked with Up/Front Arrows (front) and Up/Rear arrows
(rear).
2. Secure the front (short) bracket (marked with the Up/Front arrows) to the outer
rail with two Type G screws.
3. Locate the two buttons on the outer rail and attach the rear (long) bracket to it by
sliding the opening of the rear rail through the button.
4. Measure the depth of your rack and adjust the length of the rails accordingly.
5. Repeat the same steps to install the other outer rail on the chassis.
6. Secure both outer rail assemblies to the rack with Type H screws and Type I
washers.
1-4
707158-003
CNA-8000 Installation and Configuration
7. Slide the server chassis into the rack from the front.
(The server may not slide into the rack smoothly or easily when installed the first
time. Some adjustments to the slide assemblies might be needed for easy
installation.)
8. You will need to release the safety taps on both sides of the chassis in order to
completely remove the chassis out of the rack.
707158-003
1-5
Chapter 1. Installation
Cabling the CNA-8000 for Power
The CNA-8000 supports a pair of hot-swappable power supplies. Each power supply
requires a separate power cord, which can be plugged into a separate properly grounded
power source if available. Each supply can provide the full power requirements for the
unit.
1-6
707158-003
CNA-8000 Installation and Configuration
Cabling for ESCON
The ESCON interface card used by the CNA-8000 uses a duplex ESCON interface cable.
The ESCON interface card ships with a plastic plug inserted into the ESCON interface,
for purposes of keeping dust from the optical leads and to help protect the connector
during shipment. The plastic plug should be left in place until you are ready to attach the
ESCON cable. When ready, squeeze the sides of the plastic plug to disengage it and
allow it to be removed, as diagrammed below. (You may want to set this plug aside in a
safe place for future use.) Insert the ESCON cable into the cavity vacated by the plastic
plug, and push in until you hear/feel it click into place. Be careful when handling ESCON
cables, and do not bend the cables any more than necessary. The cables are fiber optics,
and bending them too tightly will cause them to break internally, and make them useless.
Squeeze
Extract
Squeeze
707158-003
1-7
Chapter 1. Installation
Cabling for FICON
The FICON interface card used by the CNA-8000 may have 1, 2, or 4 individual FICON
interfaces built in. Each FICON interface includes a transceiver mounted on the interface
card. FICON transceivers come in short wave and long wave versions. Correct
transceivers for the customer’s environment should have been shipped with the platform.
However if the correct transceivers are not installed, it is possible to swap transceivers in
the field. Please refer to the CNA-8000 Users Guide and Maintenance Manual for
information regarding this.
You can do a visual check to compare the transceivers to your environment. Each
transceiver can be viewed from the rear of the unit and checked for color. Transceivers
with black on the bail are short wave and transceivers with blue on the bail are long
wave. Compare this with a visual inspection of the FICON cables being used. Micron
values are typically written on the cable jackets. Values of 50/125 or 62/125 are short
wave cables (usually orange). A value of 9/125 represents a long wave cable (usually
yellow).
The FICON interface card ships with a plastic plug inserted into each FICON interface,
for purposes of keeping dust from the optical leads and to help protect the connector
during shipment. The plastic plug(s) should be left in place until you are ready to attach
the FICON cable(s). When ready, remove each plastic plug and set aside in a safe place
for future use. Insert the FICON cable into the cavity vacated by the plastic plug, and
push in until you hear/feel it click into place. Be careful when handling FICON cables,
and do not bend the cables any more than necessary. The cables are fiber optics, and
bending them too tightly will cause them to break internally, and make them useless.
1-8
707158-003
CNA-8000 Installation and Configuration
Cabling for Ethernet
The Ethernet interfaces for the CNA-8000 each consist of an RJ45 socket. Plug a
standard Ethernet cable with an RJ45 jack mounted on the end, into the appropriate
socket until you feel it click into place. The Ethernet interface of the CNA-8000 will
default to auto-detect the speed and can be plugged into a switch or hub running at 10
Mhz, 100 Mhz, or 1000 Mhz. Note that the interface may be reconfigured to operate at a
specific speed in the configuration. The first two Ethernet interfaces come in the base
platform. Up to 8 additional Ethernet interfaces can be added through the addition of 2
Quad Ethernet cards. Numbering of those additional Ethernet interfaces is based on slot
positioning and are numbered from top to bottom, right to left as viewed from the rear of
the platform (see diagram below).
Ethernet Cable Spec
Maximum Length
Minimum Length
Category 3, 4, or 5
100 meters (328 feet)
1 meter (3.28 feet)
ANSI/IEEE Standard
802.3I – 1990 Section 14 or greater
Recommended Minimum Cabling Type
Ethernet Speed
10 Mbps
100 Mbps
1000 Mbps
Minimum Twisted Pair Cable Type
Cat 3
Cat 5
Cat 5e
Ethernet 0
707158-003
Ethernet 1
Ethernet 6
Ethernet 2
1-9
Chapter 1. Installation
Cabling for Token Ring
The Token Ring interfaces for the CNA-8000 each support both, RJ45 and 9-pin D
sockets. Each interface card supports a single interface so only one cable should be
plugged in at a time. RJ45 connectors should be inserted until you feel it click into place.
9-pin D connectors should be secured with captive screws. The Token Ring interface of
the CNA-8000 defaults to auto-detect the speed and can be plugged into a switch or a hub
running at 4 Mhz, 16 Mhz, or 100 Mhz. Note that the interface can be reconfigured to run
at a specific speed if desired. It should be noted that when connecting the CNA-8000 to a
Token Ring switch, it may be necessary to set the Token Ring to a specific speed in order
for the CNA-8000 Token Ring interface card to insert into the ring. If the interface does
not appear to be inserting automatically, try reconfiguring for the specific speed and try
again.
Recommended Minimum Cabling Type
Token Ring Speed
4 Mbps
16 Mbps
100 Mbps
Minimum Twisted Pair Cable Type
Cat 2
Cat 3
Cat 5
DB9 Interface
RJ45 Interface
1-10
707158-003
CNA-8000 Installation and Configuration
Cabling for SDLC Connections
Each QSI (SDLC) card utilizes a “Hydra” cable implementation (a single connector on
one end and with four connectors on the opposite end). The single connector end of the
Hydra cable is attached to the back of the QSI card. Connectors located at the multiconnector end, will be connected to modem cables or modem eliminator cables. Hydra
cables are approximately 6 ft. in length. Two versions of the QSI card exist. One version
supports RS232, the other V.35. If X.21 modems are to be used, then an appropriate
RS232 to X.21, or V.35 to X.21 converter is required.
Modems
Single Hydra
Cable
CNA-8000
The QSI card used in the CNA-8000 is also capable of providing clocks in an
environment where the CNA-8000 is expected to be directly attached to a downstream
SDLC platform without the use of modems or modem eliminators. When this is the case,
a DCE adapter must be attached to each end of the Hydra cable that is to be directly
attached to a downstream platform.
QSI Hydra Cable
(one leg)
Serial Interface
Cable
DCE
Adapter
CNA-8000
(Providing Clocks)
707158-003
AS400
1-11
Chapter 1. Installation
Local Console Control
You can attach a monitor, keyboard and mouse to the back of the CNA-8000 to perform
the initial configuration. The CNA-8000 supports a standard SVGA compatible monitor
and uses a PS2 style interface for both the keyboard and mouse. Click on the [Start]
button and select Programs>Firefox to bring up the local browser for connecting to
configuration.
Editing the FEP4600.ini File
The CNA-8000 ships with a default IP address of 192.168.0.46. You can use this address
as is, providing that you connect to the platform with a PC configured for a compatible
address using a crossover cable or an appropriate hub. However, if you prefer to connect
the CNA-8000 to your existing IP network and assign it a different IP address, you can
override the existing IP address by editing the FEP4600.ini file found on the floppy that
is included with the CNA-8000 when it ships. If the original diskette that ships with the
product cannot be located, the file may be created with the entries as shown below, and
saved to a floppy using the FEP4600.ini file name.
[Network]
IP=192.168.0.46
NetMask=255.255.255.0
DefaultGateway=192.168.0.254
Notes regarding FEP4600.ini file entries:
1.
No white space is allowed within the entries (spaces or tabs).
2.
The data is not case sensitive.
3.
The diskette is not required for future reboots and should be removed after the
initial load.
4.
If the diskette is in the drive when the CNA-8000 is powered up in the future,
the values within the file will override any settings saved on the hard drive.
5.
Obviously, select values that are compatible with your network, and
specifically the device that will be used to configure your platform.
1-12
707158-003
CNA-8000 Installation and Configuration
Powering Up the CNA-8000
If you are applying an IP address, insert the floppy with the FEP4600.ini file into the
floppy drive before applying power. With one or both power cables attached to the CNA8000 and a power source, press the power button (button is located in the upper right
corner of the front of the platform) to apply power.
Power Button
If none of the indicators light up with the power applied, recheck the power cable
connections and check any power switches or circuit breakers associated with your power
source.
Once the power up sequence has completed (should take less than 5 minutes), you should
be ready to configure the CNA-8000 with your browser or through the local console
interface.
707158-003
1-13
CNA-8000 Installation and Configuration
Chapter 2. Configuration Overview
The configuration for the CNA-8000 is stored on the hard drive in the file FEP4600.ini
located in the /usr/local/etc directory. This file is actually a link to the file that was the
last active configuration file (identified as active on the Save/Restore Configurations
panel). Multiple configuration files can be created and stored on the hard drive. A default
configuration file is loaded on in the factory. You will need to perform a configuration to
customize the CNA-8000 for your environment. Once configured, you should keep a
backup of your configuration in a safe place. You may copy your active configuration to
a USB memory stick or you may use the Visara eManager product to retrieve backups of
your CNA-8000 automatically.
Note: if a floppy with a FEP4600.ini file is inserted into the floppy drive, the file will
be copied over to the hard drive at boot time (replacing the saved file), and the
CNA-8000 will attempt to boot on the provided configuration.
Configuration of the Visara CNA-8000 platform is accomplished through a locally
attached monitor, keyboard, and mouse, or through secure browser interface (HTTPS).
Note that the browser that you use should be capable of establishing an HTTPS
connection. Each CNA-8000 ships from the factory preconfigured for the IP address of
192.168.0.46. You may use this address or define a different address by editing the
FEP4600.ini file included on the diskette that shipped with the CNA-8000. Refer to the
previous chapter if you need to change the IP address.
You may override the configuration stored on the hard drive by inserting a floppy
containing a copy of the FEP4600.ini file, and forcing a boot of the platform.
The configuration of your CNA-8000 is password protected. If you forget your password,
you may work around the problem by using the original floppy which ships with the
platform. It has the default administrative password (‘admin’) configured (and
encrypted). Just insert the floppy and reboot. Do not attempt to edit the password in the
file to make a change. Because it is encrypted, typing anything in its place will change
the password to something unknown. If you have forgotten your password and have also
misplaced your floppy, contact your Visara representative. Note that you should limit the
parameters in the file to just the password entry, since any parameters listed in the file
may overwrite your current configuration parameters.
707158-003
2-1
Chapter 2. Configuration Overview
The Configuration Process of the CNA-8000
The configuration process is independent to the operation of the CNA-8000. That is you
can make configuration changes at any time without affecting the functional operation of
the platform. Some changes made to the configuration, primarily those made to the
upstream interface (ESCON, FICON, Host Circuits) will not take place until the next
reboot of the platform or restart of the server program. Some changes will take affect
immediately, such as changing the administrative password. Yet other options, mainly
those affecting TN3270 clients, may be made to take affect immediately by using a
special ‘Apply’ button.
It should be noted that most of the configuration panels have an ‘Update’ or ‘Submit’
button on them. These are used to save the changes made to that specific panel. Changing
values on a panel, then closing the panel (by selecting the X in the upper right corner of
the window or by pressing the Return button, without pressing the Update button first,
will not save your changes, and any modifications will be lost. Warning messages will
normally be displayed prior to your leaving a panel if the changes have not been saved.
The CNA-8000 is capable of storing multiple configurations. Modifications can be made
to whichever configuration is selected to be “currently in use”. Whenever the CNA-8000
is rebooted or restarted, the configuration that is “currently in use” is the one that gets
loaded. Therefore, if you wish to work with a configuration other than the one that
loaded, you need to select the loaded configuration as the “currently in use” configuration
before rebooting again. Information specific to which configuration the platform is
running on can be found on the Server Information panel accessed through the
Maintenance menu.
You are allowed to save a fresh copy of the “currently in use” configuration at any time
from the Save Configuration panel.
2-2
707158-003
CNA-8000 Installation and Configuration
Initial Configuration of the CNA-8000
You can perform the initial configuration of your CNA-8000 by attaching a monitor,
keyboard and mouse directly to the CNA-8000. You may also connect a PC directly to
the CNA-8000 by using a crossover Ethernet cable connected directly between the
Ethernet 0 interface (leftmost Ethernet as looking from the rear) and your PC. You may
also connect the CNA-8000 directly to a hub or switch and connect your PC to the same
hub or switch. When connecting to the CNA-8000 using the default IP address, your PC
must be configured with an appropriate IP address to be able to communicate on the same
subnet as the CNA-8000 (192.168.0.x, where x= 1-254, but do not use ‘46’ which is used
by the CNA-8000, or ‘254’ which is already defined as the default gateway in the file).
If you are using the directly attached monitor, keyboard, and mouse, you may open the
local browser by using the mouse to select Start>Programs>Firefox. Firefox is the
browser that is included on the CNA-8000. The local browser will make the connection
using the internal network address and thus does not need to be configured for an IP
address initially.
If you are using a PC, once you have an appropriate hardware connection between your
PC and the CNA-8000, start your browser and connect to the configured IP address. (i.e.
‘http://192.168.0.46’)
707158-003
2-3
Chapter 2. Configuration Overview
Initial Connection Panel
The initial browser connection should appear similar to the diagram below.
Note that on this initial panel, you have access to platform documentation included on the hard
drive by pressing the [Help] button. You also have information displayed as the Hostname (as
configured), software revision level, and date and time of creation of the software that is running.
If you suspect that the documentation found on your hard drive is outdated or missing, you may
find the latest released documentation for this product on the Visara web site: www.visara.com
Once on the Visara web site, select ‘Support’ from the menu and then ‘Product Manuals’.
2-4
707158-003
CNA-8000 Installation and Configuration
Login Panel
Select the administrative functions button. The following panel should appear.
Note that you may get a security alert when you attempt to proceed to get the Password
prompt. This is due to the secure SSL browser connection and the Visara self-signed
certificate.
If you do not wish to see this warning each time that you establish a connection, you can
normally view and install the certificate on the PC or thin client platform that you are
using the browser from.
Enter the default administrator password (‘admin’) to continue. The next panel to appear
is the Connections panel, and will appear similar to the one shown next. (This panel
reflects a platform that already has a configuration on it.)
707158-003
2-5
Chapter 2. Configuration Overview
CNA-8000 Status Panel
A menu appears at the top of the screen.
Configuration of the CNA-8000 can be accessed by selecting the ‘Configuration’ menu
option. The following panel should appear:
2-6
707158-003
CNA-8000 Installation and Configuration
The configuration of the CNA-8000 can be broken down into two categories.
 Administrative configuration items
 Communications configuration (‘Connectivity’) items
Administrative configuration items include:
 Network options for management access
 Server options for logging and email options
 Security options for passwords and allowed protocol access
 Configuration File management
Communications configuration items include:
 Connectivity to configure ESCON CUs, Host Circuits, Gateway Circuits,
Ethernet, Token Ring, and SDLC network information
 TN3270 to configure Clients, Pools, and Ports, User IDs, Nicknames
 RPQs to enable special features that may not be commonly used
For the best results, it is recommended that you perform the Communications portion of
the configuration in the order shown above.
707158-003
2-7
Chapter 2. Configuration Overview
Configuration Panel Tree
Configuration
Network
Server
Security
Connectivity
ESCON/FICON CUs
Subchannels
Token Ring Line
Token Ring Drops
Ethernet Line
Ethernet LLC Drops
Ethernet DLSW Drops
SDLC Line
SDLC Drops
XCA Host Circuits
Gateway Circuits
TN3270
TN3270 Listen Ports
LU Pools
Manage TN3270 Client Access
Nicknames
Manage TN3270 User IDs
RPQs
Save/Restore
Making Configuration Updates
Before making major configuration changes, if you already have a working
configuration, you may want to either make a restore point, or at least save your current
configuration, so that you can go back to it if necessary. It should be noted that most of
the configuration panels have an ‘Update’ or ‘Submit’ button on them. These are used to
save the changes that you make on that panel. Changing values on a panel, then closing
the panel (by selecting the X in the upper right corner of the window or by pressing the
Return button, without pressing the Update button first, will not save your changes, and
any modifications will be lost. Normally you will get a message to remind you to save
your changes if changes have been made, when you attempt to leave the panel. Passwords
and nickname changes will take affect immediately. Some changes, mostly related to the
TN3270 configuration can be made to take effect immediately by utilizing the [Apply]
button found on the TN3270 Configuration Menu.
2-8
707158-003
CNA-8000 Installation and Configuration
Network Options Panel
Selecting the ‘Network’ option will display the following configuration options:
The configuration options on this panel will allow you to modify the network interface
used for management of the CNA-8000. After you have entered all of the values that you
need, then press the ‘Submit’ button. The new values will be stored and will take affect
the next time the CNA-8000 gets booted. Note that only the Ethernet interfaces that are
installed on the unit will be displayed. Eth0 and Eth1 are resident on the motherboard and
are always present. Eth2-5 will appear only if the Quad Ethernet card is installed. Eth6-9
will appear only if a second Quad Ethernet card is installed.
The CNA-8000 makes use of a single IP protocol stack. This means that there is a single
Default Gateway. Traffic that is to be sent to a destination that is not immediately on one
of the subnets defined to be on one of the CNA-8000 interfaces may be routed through
the ETH0 interface to the Default Gateway. The Default Gateway value is associated
with the ETH0 address and must be on the same subnet to be used. For network
installations involving more than one physical network, static routes may be added to
direct traffic through other gateways. Creation of these static routes is currently beyond
the scope of this configuration manual. Please contact Visara support personnel for
information on how to create static routes.
707158-003
2-9
Chapter 2. Configuration Overview
Field Definitions
Host Name: This will be the name that the server will used when interrogated by
SNMP. It is also displayed at the top of most panels, and is indicated on the initial
connect panel, prior to logging on to the platform. This name is also used when
generating email alerts (when configured to generate them).
Domain:
This identifies the default domain to be used by the server.
Default Gateway: This IP address is for the local router, which will interface the
CNA-8000 to the greater network. The CNA-8000 requires for you to fill in this field. If
you elect to keep the CNA-8000 connected to an isolated LAN, you will still need to
provide an unused address on the subnet to which the CNA-8000 will be attached.
Otherwise, enter the value for your local router. Note that the Default Gateway is
associated with the Ethernet 0 interface and should be accessible (compatible) to the
Ethernet 0 IP address.
DNS Server: The function of the DNS server is to allow you to use domain names
instead of IP addresses. You must enter the value for your local DNS server if you are not
to be on an isolated CNA-8000. If you wish for the CNA-8000 to update its code directly
from the Visara FTP site, you will need to configure DNS.
eth0 IP Address:
Enter the IP address that you want to use with Ethernet interface 0.
Changing this value may affect the server IP address that you initially browsed to for
making the initial configuration.
eth0 Netmask:
0.
This is the subnet mask that is to be used by the Ethernet interface
eth1-9 IP Address: Enter the IP address that you want each of the eth1-eth9 interfaces
to use.
eth1-9 Netmask: Enter the subnet mask that you want each of the eth1-9 interfaces to
use.
eth1-9 Gateway: Enter the gateway that you wish to use for the defined interface. If no
Gateway IP address is entered, traffic through this interface will be limited to traffic on
the local subnet. The address entered into this field must be on the same subnet as the
interface to which it is assigned.
2-10
707158-003
CNA-8000 Installation and Configuration
Button Definitions
Submit: Saves the current information into the FEP4600.ini file for use on the next boot
of the platform.
Return: Returns back to the Configuration Menu panel.
707158-003
2-11
Chapter 2. Configuration Overview
Server Options Panel
Selecting the ‘Server’ option from the Configuration panel brings up the ‘Configure
Server’ panel for configuring the Logging policies to be used by the CNA-8000. This
panel appears below. Information on viewing the log file can be found in the CNA-8000
Users Guide and Maintenance Manual (P/N 707157-00x). Information on interpreting
the Log File can be found in the CNA-8000 Problem Determination Manual (P/N
70xxxx-00x).
Field Definitions
Configurable options on this panel include:
Server Parameters:
Display Red Status options: There are two options:
 Red Status is displayed if all circuits are down
 Red Status is displayed if any circuits are down
Status Panel Refresh Rate: Status panels when displayed are not updated immediately
when status changes, but are updated periodically. The default is 5 seconds, but may be
increased to a larger time interval if desired.
2-12
707158-003
CNA-8000 Installation and Configuration
Kernel Debug Messages Enabled Checkbox: This determines whether Kernel Debug
Messages get included in the debug trace. Additional information to make use of this
option can be found in the CNA-8000 Problem Determination manual.
Log Which Events:
The check boxes allow you to select which types of messages are included in the main
event log. Unless you have a reason for excluding events, it is probably best to allow all
messages to get recorded. Below is a list of message categories that can be included or
excluded.
 Server Events
 ESCON Events
 SSP Events
 Error Events
 LLC Events
 Administrative Events
 Token Ring Events
 Ethernet Events
 Hardware Events
 XCA Events
 eManager Events
TN3270 Keepalive Policy:
Keepalive messages are used to determine whether a TN3270 client is still
communicating with the server when there is little traffic conducted between the client
and the CNA-8000. When enabled, a Telnet ‘Do Timing Mark’ is sent to the client
periodically, requiring the client to respond back with an acknowledgement which is
interpreted that the client is still communicating. If no response is received within a
specific timeframe the CNA-8000 will close the client session, making it available for
another potential user. There are two options configurable for sending Keepalive
messages to TN3270 clients.
 Enable/Disable Keepalive – determines whether Keepalive will be used.
 TN3270 Keepalive Interval – Determines in seconds how long the CNA-8000
will wait before sending a Keepalive message to the client.
707158-003
2-13
Chapter 2. Configuration Overview
Log File Retention Policy:
There are two primary logs available on the CNA-8000. There is a ‘general’ Event Log
where events determined by the ‘Log Which Events’ section described above determines.
There is another log that keeps track of TN3270 client connections, disconnections, and
failed attempted connections. Both logs are governed by the Log File Retention Policy.
There are two options for limiting the size of the Log File. These are:
 Limit the size by limiting the number of days that the log includes. Old log entries
are purged automatically when they fall outside the prescribed timeframe.
 Limit the actual file size by setting the maximum file size that will be kept. As
new items are logged, the file size is monitored and old events will be dropped to
maintain the maximum file size.
Email Alert Notification:
Certain severe log events can generate an email message to be sent to one or more email
accounts. Enter the destination email address(es) where those messages are to be sent.
Multiple email addresses can be entered by leaving a space between each email address.
At this time you cannot configure which events are considered to be severe on the CNA8000 itself. Editing of which messages are to generate email alerts can be performed
using the Visara eManager product. Automatic generation of severe event email
messages and the sending of those messages is an optional event determined by whether
any email destinations have been generated. Note that the configured Host Name will be
included in the email alerts that are sent.
Button Definitions
Submit: The Submit button saves the changes. Most changes on this panel should take
affect immediately.
Return: The Return button takes you back to the previous panel.
2-14
707158-003
CNA-8000 Installation and Configuration
Security Options Panel
If you are logged on as the administrator, selecting the Security button from the
configuration menu will allow you to set the passwords and determine some of the
protocols that will be supported for management purposes. The Security Options panel
appears similar to the one below.
There are three levels of users supported on the CNA-8000.
 Administrator
 Operator
 Guest
Each level of user can be protected with a different password.
For a description of the functions supported at each user level, refer to the CNA-8000
Users Guide and Maintenance Manual (P/N 707157-00X).
Type in the new password or passwords that you want, then type them again in the
Verification field. Press the Submit button when you are finished. If the New Password
and Verification fields have the identical information, then the passwords will be changed
immediately.
Note that if any of the passwords are not verified correctly, an error message will appear
and none of the passwords will be changed.
707158-003
2-15
Chapter 2. Configuration Overview
Enable/Disable Network Services
There are three protocols that can be optionally disabled if necessary in order to improve
security within the production environment. Disabling of these protocols will limit some
of the options for managing the platform. Interfaces that may be disabled include:



Telnet
FTP
SNMP
Optionally you may also configure a different SNMP Community name from the default
value of ‘public’. Changing any of these options will only take affect after a reboot of the
platform.
Note that if you are using port 23 for your TN3270 clients to connect to, you must disable
the Telnet network service. Not doing so will cause TN3270 clients to connect as NVT
sessions only.
Button Definitions
Submit: The Submit button saves the changes. Password changes should take affect
immediately (for the next login attempt). Protocol support changes will take affect after
the next reboot.
Return: The Return button takes you back to the previous panel.
Connectivity Options
Selecting the ‘Connectivity’ option from the Configuration menu will result in the display
of the Connectivity menu. The menu items on this panel will vary according to the
hardware that is installed on your platform. This will be covered in later chapters.
TN3270
Selecting the TN3270 option from the Configuration panel will display the TN3270
Menu panel. This will be covered in a later chapter.
2-16
707158-003
CNA-8000 Installation and Configuration
Save/Restore Configuration Panel
Selecting the Save/Restore option from the Configuration panel will display the
following panel.
From this panel you can save, delete, and restore configurations. Multiple configurations
for the CNA-8000 can be kept at one time; one active configuration and multiple
previously saved configurations. You may also copy the current configuration to a USB
drive or copy configuration files from a USB drive onto the CNA-8000.
When saving a configuration, a name is assigned and the date and time are recorded. This
information is displayed on this panel along with buttons that can be used to activate
inactive configurations, or delete them. The configuration that is currently active is
identified on this panel also. (Note that the currently active configuration is not
necessarily the one that the platform booted on, and is currently functional.) Changes
made to the current configuration are saved as part of the current configuration
automatically. You do not need to save the current configuration with this utility unless
you desire to save a snapshot of what the current configuration is (for possible use later).
If you need to work with multiple configurations, then you will want to save a copy of
each of those configurations.
A newly reactivated configuration will not take affect until the CNA-8000 is either
restarted or rebooted, depending on the option changes.
Among the options that may require a reboot are:
 ESCON Options have changed
 Ethernet MAC address has changed
 Token Ring MAC address has changed
707158-003
2-17
Chapter 2. Configuration Overview
Options that should take affect immediately include:
 Administrative passwords
 Nicknames used by TN3270 clients
 User IDs and Passwords used by TN3270 clients
Options that should take affect when the [Apply] button is selected include:
 TN3270 Client resource assignments
Saving the Current Configuration Changes:
Enter a file name into the field next to the [Save] button and press the [Save] button. The
current configuration should then be saved and added to the list.
Deleting a Configuration
Press the [Delete] button next to the name of the configuration that you want to delete.
You will be given a chance to complete the deletion or to cancel the deletion request
through a prompt.
You are not allowed to delete the currently active configuration.
2-18
707158-003
CNA-8000 Installation and Configuration
Activating a Stored Configuration
Press the [Activate] button next to the name of the configuration that you need to
activate. A message will display to advise you that you must restart the server after
completing the activation. You may press [OK] to proceed with the activation process or
press [Cancel] to abort the process.
Pressing the [OK] button copies the stored configuration file to be the current
configuration file, but does not operationally change how the server is functioning (it is
still running on the configuration that it was booted on). This allows you to make changes
to any of the stored configurations, without affecting current operations. You must
manually restart or reboot the server to make the activated configuration operational.
If you have not saved the current configuration prior to activating a previously saved
configuration, your current configuration will be lost.
Saving the Current Configuration to a USB Drive
You can copy the Current Configuration file to a USB drive. Note that you can copy any
of your saved configurations to a USB drive by first making the saved configuration the
Current Configuration, then pressing the [Copy to USB] button. Just remember that if
you have made changes to your running configuration, you will want to save that prior to
making another configuration the Current Configuration or you will lose those changes.
To copy your Current Configuration to a USB drive, just insert the USB drive into the
socket, and press the [Copy to USB] button. You should see confirmation that the copy
was successful on your screen.
707158-003
2-19
Chapter 2. Configuration Overview
Copy Configuration Files from a USB Drive
You can copy configuration files from a USB drive onto the CNA-8000 hard drive to
make them available for use. The copy utility is designed to search the root directory of
the USB drive and copy over any files that have a ‘.4600’ extension.
2-20
707158-003
CNA-8000 Installation and Configuration
Chapter 3. Connectivity Overview
This chapter attempts to give you an overview of how the gateway functions provided by
the CNA-8000 work, to give you more insight as to what is required to properly
configure the platform to achieve your goals.
SNA Gateway
The SNA Gateway function of the CNA-8000 can be managed in a couple of different
ways. Gateway circuits can be statically configured or dynamically configured.
Static configuration of the SNA gateway involves configuring a drop on one of the
network cards for each downstream PU2 platform that is to use the gateway by MAC
address and SAP. Platforms attempting to connect will be checked against the list of
configured circuits and will be allowed to connect if there is a match. The client platform
will next be allowed to contact VTAM for XID negotiation. If VTAM likes the XID the
platform will get a connection. Otherwise the client will be promptly disconnected.
Dynamic configuration involves creating a dynamic drop on one or more of the network
cards that downstream PU2 platforms will connect to. No attempt will be made by the
CNA-8000 to validate the connecting platform against any list of prospective
downstream clients, and the connecting XID exchange will be passed upstream for
VTAM to allow or disallow.
If both static and dynamic connections are permitted, different local SAPs are typically
used to keep static and dynamic connections differentiated.
When supporting LLC clients, you can configure dynamic or static drops. When
configuring dynamic drops, no gateway circuit is required. Static drops each require a
separate gateway circuit.
DLSw clients require a gateway circuit to be defined. If DLSw clients are to be statically
configured, one gateway circuit for each PU2 client is required. If dynamic connections
are to be supported then only one gateway circuit for each remote DLSw gateway is
required, and multiple PU2 platforms can be routed through each DLSw gateway.
SDLC PU2 clients each require a static gateway circuit configuration. This static gateway
circuit includes assigning a virtual LLC MAC address and virtual SAP for use by the
gateway circuit when communicating with VTAM.
Please use the following sections to assist in planning for your configuration.
707158-003
3-1
Chapter 3. Connectivity Overview
Static LLC SNA Gateway Configuration Options
Host IO Gen
CNTLUNIT
UNITADD
CUADD
IODEVICE (subchannel)
VTAM Gen
XCA Definition
SAPADDR
MEDIUM
ADAPNO
CNA-8000 Configuration
CU Definition
Hi & Lo Addresses
CUADD
Subchannel Definition
VTAM SAP
Adapter
Switched PU Definition
IDBLK + IDNUM
VTAM GEN
Gateway Definition
VTAM SAP
Adapter
Drop Definition
CNA-8000
DROP Definition
Local MAC
Local SAP
Remote MAC
Remote SAP
PUID
Host IO Gen
CNTLUNIT
UNITADD
CUADD
IODEVICE
(subchannel)
XCA
Definition
SAPADDR
MEDIUM +
ADAPNO
CNA-8000
CNA-8000
CU/Subchannel
Gateway
Definition
Definition
CU Definition
Hi & Lo
Addresses
CUADD
Subchannel
Definition
VTAM SAP
VTAM SAP
Adapter
Adapter
Drop Name
Line/Drop
Definition
Drop Name
Local MAC
Local SAP
Remote
MAC
Remote SAP
PU
Definition
IDBLK +
IDNUM
PUID
(optional
override)
Remote PU2
Host Definition
Remote MAC
Remote SAP
Local MAC
Local SAP
PUID
Remote
PU2
Remote
MAC
Remote
SAP
Local MAC
Local SAP
PUID
Notes:
1)
3-2
Optionally you can configure a PUID on the Gateway Circuit panel of
the CNA-8000, which will override any PUID provided by the
downstream PU2.
707158-003
CNA-8000 Installation and Configuration
Dynamic LLC SNA Gateway Configuration Options
Host IO Gen
CNTLUNIT
UNITADD
CUADD
IODEVICE (subchannel)
VTAM Gen
XCA Definition
SAPADDR
MEDIUM
ADAPNO
CNA-8000 Configuration
CU Definition
Hi & Lo Addresses
CUADD
Subchannel Definition
VTAM SAP
Adapter
CNA-8000
Gateway Definition
VTAM SAP
Adapter
Drop Definition
CNA-8000
DROP Definition
Local MAC
Local SAP
Switched PU Definition
IDBLK + IDNUM
VTAM GEN
Host IO Gen
CU/Subchannel
Definition
RESOURCE
PARTITION
CNTLUNIT
UNITADD
XCA
Definition
SAPADDR
MEDIUM +
ADAPNO
CUADD
IODEVICE
(subchannel)
CNA-8000
Gateway
Definition
Line/Drop
Definition
High & Low
Addresses
CUADD
Subchannel
Definition
VTAM SAP
Adapter
Remote
PU2
VTAM SAP
Adapter
Drop Name
Local MAC
Local SAP
707158-003
Host Definition
Remote MAC
Remote SAP
Local MAC
Local SAP
PUID
LPAR Number
Drop Name
PU
Definition
IDBLK +
IDNUM
Remote PU2
Remote
MAC
Remote
SAP
Local MAC
Local SAP
PUID
3-3
Chapter 3. Connectivity Overview
Static DLSw SNA Gateway Configuration Options
Host IO Gen
CNA-8000 Configuration
CNTLUNIT
UNITADD
CUADD
IODEVICE (subchannel)
VTAM Gen
XCA Definition
SAPADDR
MEDIUM
ADAPNO
CU Definition
Hi & Lo Addresses
CUADD
Subchannel Definition
VTAM SAP
CNA-8000
Gateway Definition
VTAM SAP
Adapter
Drop Definition
Adapter
CNA-8000
Configure Network
Local IP
Switched PU Definition
IDBLK + IDNUM
VTAM
Gen
Host IO Gen
RESOURCE
PARTITION
CNTLUNIT
UNITADD
CUADD
IODEVICE
(subchannel)
MEDIUM
+
ADAPNO
DLSw
Gateway
Remote PU2
Host Definition
Remote MAC
Local MAC
Local IP
Remote IP
PUID
CNA-8000
Gateway
Definition
DLSw
Gateway
Remote
PU2
Line/Drop
Definition
LPAR Number
High & Low
Addresses
CUADD
Subchannel
Definition
VTAM SAP
Adapter
VTAM
SAP
Adapter
Drop
Name
Configure
Network
Local IP
PU
Definition
IDBLK +
IDNUM
DROP Definition
Local DLID
Remote DLID
Remote IP
PUID
CU/Subchannel
Definition
XCA
Definition
SAPADDR
CNA-8000
Drop
Name
Local
DLID
Remote
DLID
Remote IP
Remote
MAC
Local
MAC
Local IP
Remote
IP
PUID
(optional
override)
PUID
Notes:
1)
3-4
Optionally you can configure a PUID on the Gateway Circuit panel of
the CNA-8000, which will override any PUID provided by the
downstream PU2.
707158-003
CNA-8000 Installation and Configuration
Dynamic DLSw SNA Gateway Configuration Options
Host IO Gen
CNA-8000 Configuration
CNTLUNIT
UNITADD
CUADD
IODEVICE (subchannel)
VTAM Gen
XCA Definition
SAPADDR
MEDIUM
ADAPNO
CU Definition
Hi & Lo Addresses
CUADD
Subchannel Definition
VTAM SAP
CNA-8000
Gateway Definition
VTAM SAP
Adapter
Drop Definition
Adapter
CNA-8000
Configure Network
Local IP
Switched PU Definition
IDBLK + IDNUM
VTAM
Gen
Host IO Gen
XCA
Definition
SAPADDR
CUADD
IODEVICE
(subchannel)
MEDIUM
+
ADAPNO
Gateway
Definition
707158-003
Remote PU2
Host Definition
Remote MAC
Local MAC
Remote IP
Local IP
Remote IP
PUID
DLSw
Gateway
Remote
PU2
Line/Drop
Definition
LPAR Number
High & Low
Addresses
CUADD
Subchannel
Definition
VTAM SAP
Adapter
VTAM
SAP
Adapter
Drop
Name
PU
Definition
IDBLK +
IDNUM
DLSw
Gateway
DROP Definition
Local DLID
CNA-8000
CU/Subchannel
Definition
RESOURCE
PARTITION
CNTLUNIT
UNITADD
CNA-8000
Configure
Network
Local IP
Drop
Name
Local
DLID
Remote
DLID
Remote IP
Remote
MAC
Local
MAC
Local IP
Remote
IP
PUID
3-5
Chapter 3. Connectivity Overview
Static SDLC SNA Gateway Configuration Options
Host IO Gen
CNTLUNIT
UNITADD
CUADD
IODEVICE (subchannel)
VTAM Gen
XCA Definition
SAPADDR
MEDIUM
ADAPNO
CNA-8000 Configuration
CU Definition
Hi & Lo Addresses
CUADD
Subchannel Definition
VTAM SAP
Adapter
Switched PU Definition
IDBLK + IDNUM
VTAM GEN
Gateway Definition
VTAM SAP
Adapter
Drop Definition
CNA-8000
Drop/Line
Poll Address
NRZ/NRZI
Duplex
Host IO Gen
CUADD
IODEVICE
(subchannel)
CU/Subchannel
Definition
CU Definition
Hi & Lo
Addresses
CUADD
Subchannel
Definition
VTAM SAP
Adapter
CNA-8000
Gateway
Definition
Host Definition
Poll Address
NRZ/NRZI
Duplex
Line/Drop
Definition
Remote
PU2
VTAM SAP
Adapter
Drop Name
Drop Name
Poll Address
NRZ/NRZI
Duplex
PU
Definition
IDBLK +
IDNUM
Remote SDLC PU2
PUID
PUID
CNTLUNIT
UNITADD
XCA
Definition
SAPADDR
MEDIUM +
ADAPNO
CNA-8000
PUID
(optional
override)
Poll
Address
NRZ/NRZI
Duplex
PUID
Notes:
1)
3-6
Optionally you can configure a PUID on the Gateway Circuit panel of
the CNA-8000, which will override any PUID provided by the
downstream PU2.
707158-003
CNA-8000 Installation and Configuration
TN3270E Gateway
The TN3270E Gateway function of the CNA-8000 is an optional feature.
TN3270E Client sessions are implemented as SNA 3270 sessions by the CNA-8000.
Each session is handled by the host as a dependent SNA LU session. In the SNA
environment LU sessions require a PU function to manage them. On the CNA-8000 this
is provided by a PU type 2.0 Host Circuit. Each Host Circuit provides support for up to
253 concurrent dependent LU sessions. Multiple Host Circuits may be configured on the
CNA-8000 to support the number of TN3270E clients that are to make use of it.
To make use of switched PU/LU definitions in VTAM through the XCA gateway feature
of the CNA-8000, each Host Circuit is made to appear as if it were a remote downstream
SNA node. To accomplish this each Host Circuit is assigned to one of the configured
network adapters and is assigned a virtual MAC address and virtual SAP.
TN3270E clients connect to the CNA-8000 by targeting the IP address of one of the
CNA-8000’s Ethernet adapters and using one of the configured Listening Ports to
connect to. If encryption is expected on the Listening Port, then only clients using
encryption will be allowed to connect. Various TN3270E options get negotiated, and
depending on the configuration of the CNA-8000, the client will be allowed to connect
under the conditions allowed by the CNA-8000.
There are several approaches to managing the remote TN3270 clients. Chances are you
already have clients deployed and a management scheme in place. The purpose of this
section is to describe the many ways management can be accomplished by the CNA-8000
options. Combinations of the different options described below can be deployed and
supported by the CNA-8000.
Static Definitions or Pooled Definitions:
Each time a client connects, they can be given a specific LU assignment from a specific
Host Circuit, or they can be given a session from a session pool. Session pools allow the
same LU resource be shared by multiple users on a first-come-first-serve basis. Session
pools consist of any number of LUs from one or more Host Circuits that have been
grouped together and assigned a name. Each LU can be assigned to one or more pools
and can be statically mapped as well. Usually however, you will want to have them
assigned to either a pool or a static assignment.
Encryption Used or Not:
Whether Encryption is used or not is configurable on a Listening Port by Listening Port
basis. This option must be matched by the client exactly or no connection will be
accepted.
707158-003
3-7
Chapter 3. Connectivity Overview
Connection Password Requirement:
User ID and Passwords can be required to connect to the CNA-8000 if desired, and is
configurable. If the User ID or Password gets changed while a client is currently attached,
having previously attached using the previous User ID and Password, the session remains
connected until such time the client disconnects or is forcibly disconnected by the
administrator. Their next connection will require the new User ID and Password.
Resource Assignment Methods:
Resources can be requested by the client or assigned by the CNA-3000. Methods used to
assign resources include:
 Client IP Address
 Client Subnet Address
 Listening (TCP) Port that the Client Connects To
 Specific Resource Requested Using a Predefined Format
 Specific Resource Requested Using a Nickname
 Selected from a Menu Presented to the Client
3-8
707158-003
CNA-8000 Installation and Configuration
Connecting a TN3270E Client to a Specific LU
There are several ways to connect a TN3270E client to a specific LU on a specific Host
Circuit. These methods can be used
 Using Client IP Address
 Use Listening Port
 Using Predefined Format
 Using a Nickname
Here is a summary of what needs to be done for each of the methods.
Using Client IP Address:
Panel
Ports
Pools
Clients
Nicknames
User IDs
Action
One port configured for many clients
Not Required
Specify the port configured on the ports panel.
Specify the client’s IP address in the address field.
Specify the Host Circuit assignment in the Resource field.
Specify the LU assignment in the LU field.
Not Required
Not Required
Using Listening Port:
Panel
Ports
Pools
Clients
Nicknames
User IDs
707158-003
Action
One port configured for each client session
Not Required
Specify the port configured on the ports panel.
Specify the Host Circuit assignment in the Resource field.
Specify the LU assignment in the LU field.
Not Required
Not Required but Recommended
3-9
Chapter 3. Connectivity Overview
Using Predefined Format:
Panel
Ports
Pools
Clients
Action
One port configured for many clients
Not Required
Specify the port configured on the ports panel.
Specify ‘User Specified’ assignment in the Resource field.
Nicknames
Not Required
User IDs
Not Required but Recommended
On the TN3270E emulator enter one of the following formats into the LUNAME field
associated with the session:
 ’hc,lu’ where ‘hc’ is the Host Circuit index number and lu is the LU number (no
white space)
 ‘Host_Circuit,lu’ where ‘Host_Circuit’ is the Host Circuit name configured on the
CNA-8000 and ‘lu’ is the LU number (no white space)
Using Nicknames:
Panel
Ports
Pools
Clients
Action
One port configured for many clients
Not Required
Specify the port configured on the ports panel.
Specify ‘User Specified’ assignment in the Resource field.
Nicknames
Configure one Nickname for each client session.
Enter desired Nickname into Nickname field.
Select ‘Host’ radio button.
Select the appropriate Host Circuit from the Host dropdown.
Enter the appropriate LU number.
User IDs
Not Required but Recommended
On the appropriate TN3270E emulator enter the nickname that was configured on the
CNA-8000 into the LUNAME field.
3-10
707158-003
CNA-8000 Installation and Configuration
Connecting a TN3270E Client to a Session Pool
There are several ways to connect a TN3270E client to a session pulled from a session
pool. These methods can be used.
 Using Client IP Address (not recommended)
 Use Listening Port
 Using Predefined Format
 Using a Nickname
 Client Subnet Address
 Selected from a Menu Presented to the Client
Here is a summary of what needs to be done for each of the methods.
Using Client IP Address:
This would be a tedious way to configure a user to get a session from a pool and would
not be the recommended way to do it.
Panel
Ports
Pools
Clients
Nicknames
User IDs
Action
One port configured for many clients
Create as many different pools as needed.
Specify the port configured on the ports panel.
Specify the client’s IP address in the address field.
Specify the Pool assignment in the Resource field.
Not Required
Not Required
Using Listening Port:
Panel
Ports
Pools
Clients
Nicknames
User IDs
707158-003
Action
One listening port configured for each pool that will be defined.
Create as many different pools as needed.
Specify the port configured on the ports panel.
Specify the Pool assignment in the Resource field.
Not Required
Not Required but Recommended
3-11
Chapter 3. Connectivity Overview
Using Predefined Format:
Panel
Ports
Pools
Clients
Action
One port configured for many clients
Create as many different pools as needed.
Specify the port configured on the ports panel.
Specify ‘User Specified’ assignment in the Resource field.
Nicknames
Not Required
User IDs
Not Required but Recommended
On the TN3270E emulator enter the following formats into the LUNAME field
associated with the session:
 ‘Pool_name’ where ‘Pool_name’ is the name assigned to the pool that was created
in the CNA-8000 configuration.
Using Nicknames:
Panel
Ports
Pools
Clients
Action
One port configured for many clients
Create as many different pools as needed.
Specify the port configured on the ports panel.
Specify ‘User Specified’ assignment in the Resource field.
Nicknames
Configure one Nickname for each pool.
Enter desired Nickname into Nickname field.
Select ‘Pool’ radio button.
Select the appropriate Pool from the Pool dropdown.
User IDs
Not Required but Recommended
On the appropriate TN3270E emulator enter the nickname that was configured on the
CNA-8000 for the pool that is desired.
Using Client Subnet Address:
Panel
Ports
Pools
Clients
Nicknames
User IDs
3-12
Action
One port configured for many clients
Create as many different pools as needed.
Specify the port configured on the ports panel.
Specify the client’s IP address in the address field using wildcards as
needed to encompass the range of addresses that are to get access to the
resources.
Specify the Pool assignment in the Resource field.
Not Required
Not Required but Recommended
707158-003
CNA-8000 Installation and Configuration
Select from a Menu Presented to the Client:
Panel
Ports
Pools
Clients
Nicknames
User IDs
707158-003
Action
One port configured for many clients
Create as many different pools as needed.
Specify the port configured on the ports panel.
Specify the ‘Present Menu’ assignment in the Resource field.
Not Required
Not Required, but Recommended
3-13
CNA-8000 Installation and Configuration
Chapter 4. ESCON/FICON XCA Configuration
A CU on the CNA-8000 can be thought of as a logical Control Unit image. Each CU
corresponds to a CTRLUNIT macro in the IOCDS gen, and is tied to a specific LPAR. If
a CTRLUNIT macro is being shared by more than one LPAR in the IO gen, one CU
definition for each of the LPARs actively sharing the CNTLUNIT macro is required on
the CNA-8000. The CNA-8000 supports up to 16 CU images per ESCON or FICON
interface. Each CU can have multiple subchannels determined by the address range
defined in the CTRLUNIT statement. Each subchannel can be used to define an XCA
portal. There is a maximum of 256 subchannels per ESCON or FICON interface allowed,
but there is a further limitation of a maximum of 8 XCA portals defined to each network
interface card (Token Ring or Ethernet). Note that a single IODEVICE macro can specify
multiple subchannels, with each subchannel being a separate XCA portal.
To define and configure CUs on the CNA-8000, select the [Connectivity] button from the
Configuration menu.
707158-003
4-1
Chapter 4. ESCON/FICON XCA Configuration
Next press the [Channel] button on the resulting Connectivity Configuration menu.
4-2
707158-003
CNA-8000 Installation and Configuration
The following panel will appear.
Update ESCON/FICON CUs Panel
If any Control Units have already been defined, the first definition will automatically be
displayed. The Control Unit ID dropdown control allows you to select among those
Control Units already defined to be displayed. Changes can be made to the various
displayed fields and saved by pressing the [Update] button.
New CUs can be defined by pressing the [New] button. If you have multiple ESCON or
FICON interfaces installed you will need to select which one you wish to add the CU to
prior to pressing the [New] button. Pressing this button displays the next available CU
with default values entered. You will need to modify these values, and press the [Update]
button to save them. Once the CU has been created, you will need to press the
[Subchannels] button to bring up a panel to complete the XCA portal configuration.
707158-003
4-3
Chapter 4. ESCON/FICON XCA Configuration
Field Definitions
CU Number: Allows you to select which of the CUs you wish to work with. CU
numbers represent an index number associated with the CNA-8000 and does not
reference anything specific in the host gen. Only CUs that are currently defined will be
listed in the dropdown list. Note the following CU Number ranges used by the CNA8000:
 ESCON 0 – CU 0-F
 ESCON 1 – CU 10-1F
 FICON 0 – CU 20-2F
 FICON 1 – CU 30-3F
 FICON 2 – CU 40-4F
 FICON 3 – CU 50-5F
CU Name: This is a 16-character field that you may enter a name to represent the CU in
other panels. Choose a name that is descriptive for your environment.
Protocol: This value represents the type of characteristic the CU will have. The only
valid value for this field is “XCA”. No other options should be offered on this model.
CUADD: This parameter corresponds to the CUADD value assigned in the CTRLUNIT
macro in the IOCDS gen. The CUADD parameter is a single hex digit (0-F). If the
CUADD parameter is not explicitly defined in the CNTLUNIT macro, then the default
value used is ‘0’.
LPAR Number: This is the LPAR number that is assigned the LPAR that will have
control of this CU. The LPAR number is assigned in the RESOURCE macro of the
IOCDS gen. The controlling LPAR name is identified in the IODEVICE macro as the
PARTITION parameter.
Host Director Port:
ESCON – This field should contain 2 hex digits, and refers to the logical port on an
ESCON director that is connected back to the host CPU. If no director is being used, you
should define the value as either ‘01’ (directly attached) or ‘FF’ (wildcard); either should
work.
FICON – This field must contain a 4 hex digit value that represents the Link Address of
the host. The Link Address consists of a 2 hex digit Domain ID field followed by a 2 hex
digit logical port number indicating the port that is connected back to the host. If no
director is being used, you should define the value as ‘FFFF’.
Low Address: This is the value of the lowest address assigned in the range of addresses
specified by the UNITADD parameter in the CTRLUNIT macro of the IOCDS gen.
High Address: This is the value representing the highest address assigned by the range
of addresses specified by the UNITADD parameter in the CTRLUNIT macro of the
IOCDS gen.
4-4
707158-003
CNA-8000 Installation and Configuration
CU On: This dropdown control is present when more than one ESCON or FICON
interface is present and allows you to select which ESCON or FICON interface you wish
to configure. When only one interface is present, this dropdown control is replaced with
an information field.
Button Definitions
Return: Pressing this button returns you to the previous configuration menu.
Update: Pressing this button causes the information displayed on this panel to get
written into the current configuration file. Requesting to leave the panel will normally
result in a warning message being posted to give you a chance to save the contents of the
panel.
Subchannels: Pressing this button will result in the Subchannels panel being displayed.
Delete CUs: Selecting this button will display all of the currently defined CUs in a
separate panel for the purpose of allowing you to delete CU definitions.
New: Pressing this button will cause a new CU index being displayed along with default
values in the remaining fields. This allows you to define a ‘new’ CU.
707158-003
4-5
Chapter 4. ESCON/FICON XCA Configuration
UNITADD Address Format
The UNITADD parameter is specified by the format of UNITADD=(xx,yy) where xx is
the lowest address of a range, and yy indicates how many consecutive addresses are
defined beginning with the lowest address of the range. Subchannel addresses are defined
as a hexadecimal number, but the value of yy specifies the total number in decimal. For
example, the parameter UNITADD=(A0,32) is interpreted as a range of addresses
beginning with the subchannel address ‘A0’ and ending with the subchannel address
‘BF’.
Configuring Subchannels
Once a CU has been defined, you may configure the individual subchannel addresses
called out by the Lowest IODEVICE Address and the Highest IODEVICE Address, by
pressing the [Subchannels] button. First select which CU you wish to configure sessions
for, and select the [Subchannels] button. Each subchannel corresponds to an XCA
definition on the host CPU.
The Update Subchannels panel is displayed below.
Field Definitions
Update Subchannels for CU: This dropdown allows you to select the CU that you wish
to configure the subchannels for. Note that you need to press the [Update] button to save
changes made to the currently displayed CU subchannels before displaying another CU,
or the changes will be lost.
Subchannel: This is an information only field and specifies which Subchannel is being
displayed.
4-6
707158-003
CNA-8000 Installation and Configuration
ID: This field determines the name by which this resource will be referred to elsewhere
on the CNA-8000. You should select a name that is meaningful and easily recognized. A
default name will automatically be assigned by CNA-8000.
Network Interface: This is the network interface associated with the subchannel. Each
XCA defined subchannel is dedicated to a network interface, specified in the gen. Up to
255 PUs can utilize a single XCA subchannel at a given time. Multiple XCA subchannels
(up to 8) can be assigned to a single network interface.
VTAM SAP: This defines the VTAM SAP that has been assigned to this subchannel in
the host gen. Traffic headed inbound will use this SAP as the destination SAP. Each
VTAM associated with a specific CU must have a different SAP associated with it. The
Gateway Circuit panel of the CNA-8000 maps network drops to the correct
subchannel/SAP.
Buffer Size: This value determines the maximum data (block size) that can be
transferred at a time over the subchannel. Normally this value should be left at the default
value.
Blocking Timeout (msec): This field determines how long the CNA-8000 assembles a
block of data before sending it inbound. If the maximum buffer size is reached prior to a
timeout occurring, the block of data will be queued for immediate inbound transfer.
Bytes per Trace Record: The value of this parameter determines the maximum size of
the associated Trace Record. Traces wrap when the maximum size record has been
reached with the oldest data deleted as new data gets added to the trace. The default value
for this option is 1024 bytes.
Button Definitions:
Update: The Update button causes the information on the panel to update the
configuration file. You must press the [Update] button before leaving the panel if you
want the changes to be made, otherwise the changes will be discarded.
Return: Selecting this button will take you back to the Update ESCON/FICON CUs
panel.
707158-003
4-7
CNA-8000 Installation and Configuration
Chapter 5. Token Ring Gateway
Configuring Token Ring XCA LLC Drops
The downstream side of the XCA circuits defined and assigned to subchannels on the
ESCON/FICON interface(s) must be defined to the Ethernet, Token Ring, and SDLC
network interfaces. To define the downstream portion of the XCA circuit to reside on
Token Ring, select the [Token Ring] button from the Connectivity Configuration menu.
707158-003
5-1
Chapter 5. Token Ring Gateway
The resulting panel should appear similar to the one shown below.
Field Definitions
Configure Token Ring Line: This dropdown control allows you to select a different
Token Ring card to configure if there is more than one installed.
Line ID: This is the name that you choose to use for the Token Ring interface.
Mac Address: This field indicates the MAC address assigned to this Token Ring
interface. If the ‘Use Burned in MAC Address’ option is selected this field will display
the hardware assigned MAC address and the field will be grayed out so that you can not
change the value. If the option is not selected, then you may enter a locally-administered
MAC address value in the form of 6 hex bytes separated by colons.
Example: 40:00:30:74:00:01
Use Burned in MAC Address: This option allows you to use the unique factory
assigned MAC address when selected. Selecting this option will cause the burned in
address to be displayed and used.
5-2
707158-003
CNA-8000 Installation and Configuration
Ring Speed: This dropdown control allows you to specify which ring speed is to be
used. Most of the time you will want to leave the option set to Auto Negotiate the correct
interface speed. If you have difficulty making contact with the Token Ring card remotely,
you may want to assign a speed to the interface to match the switch/hub that you will be
attaching to. Valid options for this parameter are:




Auto Negotiate
4 Mbit
16 Mbit
100 Mbit
Source Routing: There are three possible configurations for this option.
 All Routes Broadcast – Source Route Bridging is used. Broadcasts to establish a
session will attempt to get to the destination over all possible routes.
 Single Route Broadcast – Source Route Bridging is used. An administrator must
configure which bridges are to be used to pass broadcasts and which ones are not,
thus reducing the number of paths that a broadcast frame has to traverse. (This is
configured on the bridges themselves, not in the CNA-8000.)
 Disable – Source Route Bridging will not be used and the destination must be on
the same logical ring as the CNA-8000.
Response Timer T1 (secs): This option identifies how long the CNA-8000 Token Ring
interface is to wait for an LLC response before declaring a timeout and retransmitting the
request.
Retry Count N2: This option identifies the maximum number of retransmissions that
will be attempted before attempting error recovery.
Inactivity Timer TI: This option identifies how long the CNA-8000 Token Ring
interface will wait between attempts to contact the session partner when there is no
session established.
Button Definitions:
Update: The Update button causes the information on the panel to update the
configuration file. You must press the [Update] button before leaving the panel if you
want the changes to be made, otherwise the changes will be discarded.
Return: Selecting this button will take you back to the Update Connectivity
Configuration panel.
Drops: Selecting this button displays the LLC Drops panel.
Unconfigure: Selecting this button allows you to delete the Token Ring configuration
that is currently displayed.
707158-003
5-3
Chapter 5. Token Ring Gateway
Drop Panel Option Determination
Below you will find a discussion on how to determine values for some of the options
found on the Token Ring Drop Panels.
Static vs Dynamic Drops
Token Ring Drops on the CNA-8000 can be set up two different ways.
 Static
 Dynamic
Static Drops:
Static drops offer simplicity and security. Defining a static drop means that you will
configure the MAC address and SAP of the downstream platform. Only that platform can
connect to this circuit. The Token Ring end of the circuit must be configured to a specific
upstream (ESCON) XCA portal.
Dynamic Drops:
Dynamic drops offer flexibility and may be used as part of a disaster recovery scenario.
Defining a dynamic drop means that any downstream platform configured to seek out the
MAC address of the CNA-8000 interface, and connecting to the Local SAP associated
with this drop definition, will be allowed to attempt to make a connection. The
downstream platform will be challenged for an SNA XID. The XID response from the
downstream platform will be forwarded through the XCA gateway up to VTAM to be
matched to a configured VTAM switched PU2 definition for that specific XID (IDBLK +
IDNUM options). If a match is found by VTAM, the upstream to downstream circuit will
be generated dynamically (for the length of the session). If no match is found, the
downstream platform will be disconnected.
SAP Assignments
The same Local SAP number can be used for multiple drops and will automatically
default to a value of ‘04’ on the CNA-8000. SAPs used for SNA communication must be
a multiple of ‘04’ hex (04, 08, 0C, 10, 14, etc.) for use on Z/OS systems or a multiple of
‘02’ hex (04, 06, 08, 0A, 0C, 0E, 10, etc) for use on Z/VM systems, and must be between
the values of 04-EC. If more than one PU connection is to be made between the CNA8000 and the same platform (same LAN address), a unique combination of Remote SAP
address and Local SAP address must be used for each circuit (drop). For example a
combination of RSAP = 04, LSAP=04 and RSAP=08, LSAP=04 would be a valid
configuration for a downstream platform that requires two PUs to be defined. SAP
numbers are assigned on both platforms conducting the PU session, and typically must be
configured to communicate with each other. On the CNA-8000, when defining Dynamic
Connections or XCA drops, use a different SAP for each of those that are not duplicated
by the static PU2 connections.
5-4
707158-003
CNA-8000 Installation and Configuration
Window Size Selection
The Transmit and Receive Windows Size parameters are part of a static sliding Window
algorithm used by LLC for controlling packet flow. There is a separate set of Transmit
and Receive Window settings for each end of an LLC circuit. Coordinating the values
used is recommended.
The Transmit Window represents the maximum number of outstanding packets (packets
without a response or acknowledgement) a platform can send before having to stop and
wait for a response to one of the packets. Setting the Transmit Window too small may
result in a platform having to stop and wait for a response often, causing poor response
times. Setting the value too high, may result in having to retransmit several packets,
whenever a packet gets clobbered or lost. (If a negative acknowledgement is received for
a packet, then that packet and subsequent packets that have already been sent must be
resent.)
The Receive Window represents how many packets in a single conversation can be
received before an acknowledgement must be queued to be sent. If a Receive Window
size is set too large, the receiver may be waiting to receive additional packets that are not
forthcoming, resulting in unnecessary delays in sending acknowledgements.
As a general rule, you want to keep the Transmit Window set to a higher value than the
Receive Window. This allows the transmitter to keep sending packets, and with the lower
Receive Window at the session partner, the partner will send acknowledgements back
sooner than required. As the transmitter receives acknowledgements, the number of
outstanding unacknowledged packets will decrement allowing for even more packets to
be sent. The longer the path from transmitter to receiver, the larger difference you may
want between Transmit and Receive Windows. (This is the sliding window.) This works
well for LAN environments, but may not for WAN environments.
In WAN environments packets can be distorted or lost or delayed to the point where an
earlier packet arrives after a later packet. In cases where there is an apparent sequence
number error, the normal recovery is for the LLC circuit to be taken down and brought
back up. This can result in abnormal termination of a session. Keeping the Transmit and
Receive Windows set to 1 ensures that there are no sequence number errors.
The rules of thumb for setting the Window sizes are as follows:
1)
For a LAN environment use a Transmit Window size of 2 + an additional
value of 1 for each hop (bridge or router that is crossed) between the
transmitter and receiver, up to the maximum value.
2)
Keep the Receive Window set to the common default of 1.
3)
For a WAN environment with frequent congestion or unreliable delivery, use
a Transmit Window of 1 and a Receive Window of 1.
707158-003
5-5
Chapter 5. Token Ring Gateway
Token Ring Drop Panel
Pressing the [Drops] button on the Token Ring Line panel causes the Token Ring Drop
panel to display. This panel allows you to define a Token Ring drop that will be
associated with an upstream Switched Node definition on the host. An example of this
panel appears below.
Field Definitions
Configure Token Ring Line: This option allows you to specify a different Token Ring
line, if the one that is currently selected is not the one that you wish to make changes to.
Drop: This field displays a list of names given to drops that have been defined thus far
by the administrator. As each new drop is defined, it will be added to the list.
Dynamic LLC Connection: When this box is checked, this definition will be used for
dynamic connections. Multiple remote stations may connect through a single Dynamic
LLC Drop. When a remote station connects, it will be challenged for its SNA XID
(PUID). This XID will be forwarded to VTAM through the specified XCA connection
and used to dynamically connect the station to an upstream VTAM Switched PU2
definition that is configured to match the XID (PUID). Selecting Dynamic LLC will force
the remote MAC address in the configuration to ’00:00:00:00:00:00’ and gray out the
‘Remote MAC Address’ and ‘Remote SAP’ since the CNA-8000 will not care what those
values are.
5-6
707158-003
CNA-8000 Installation and Configuration
Drop ID: The ‘Drop ID’ is the name that is being given to this drop, and is the same
name that will be added to the list of drops when this definition is saved. The name can
be most any text string (alphanumeric characters plus dash, underscore, and period
characters), and should be created by the administrator to provide a name for the drop
that is most useful to describe what or where it is.
Remote MAC Address: This is the LAN address of the platform that the CNA-8000 is
talking to on this drop. This address might also be referred to as the remote platform’s
hardware address or LLC address. If this drop is defined to be dynamic this field will be
grayed out and will not be required. The MAC address should be entered in the format of
6 hex bytes separated by colons. Example: 40.00.11:74:00:0A
Local SAP: This option defines the local Service Access Point address that is assigned
by the CNA-8000 for use for communications with the remote platform. Refer to the
‘SAP Assignments’ section above for selecting a valid SAP value. Note that if you have
the Dynamic Connections option selected, the SAP used for the dynamic connections
should be different than the one used for static connections.
Remote SAP: This option defines the remote Service Access Point address that is
configured on the remote platform that the CNA-8000 is communicating with. Refer to
the ‘SAP Assignments’ section below for a discussion on selecting valid SAP values. If
this drop is defined to be dynamic this field will be grayed out and will not be required.
Max Transmit Frame Size: This value represents the maximum size frame (including
TH, RH, and RU) that may be sent in a single packet over the LLC link. Most Token
Ring LLC circuits are limited to a maximum frame size of 4105, but some (usually older)
platforms may be limited to a smaller maximum frame size. Using a smaller value than
what is supported by the session partner will work, but will result in the transmission of
more packets than if a larger value is set. The minimum size for a PU type 2 is 265. Note
that if the traffic is to cross an Ethernet LAN segment to get to the session partner, then
the maximum value must be restricted to that handled by Ethernet (a value of 1500).
Receive Window Size: This is the maximum number of packets in an LLC conversation
with a session partner that can be received, before an LLC acknowledgement must be
sent. The default value for this option is 1. Refer to the ‘Window Size Selection’ section.
Transmit Window Size: This is the maximum number of packets that will be sent
before requiring an LLC acknowledgement. The default value for this option is 2. Refer
to the ‘Window Size Selection’ section.
Network Protocol: The only valid setting available for this option is ‘XCA’.
Keepalive Timeout (secs): Keepalive is used to determine when the session partner
goes away. Any value other than zero enables the feature and determines how often a
keepalive packet is to be sent.
707158-003
5-7
Chapter 5. Token Ring Gateway
Button Definitions
Return: Selecting this button will return you to the ‘Configure Token Ring Line’ panel.
Update: Selecting the ‘Update’ button will save any changes that you have made on this
panel. A message indicating ‘Subchannel update complete!’ should display.
Delete: Pressing this button will bring up the Delete Drops panel.
Add: Pressing this button will add a new Drop definition and set several of the options
to default values. You must remember to press the [Update] button when you are finished
modifying the values to save the new drop information.
5-8
707158-003
CNA-8000 Installation and Configuration
Deleting Token Ring Drops
When pressing the Delete button on the Configure Token Ring Drops panel, a new panel
will be displayed with the currently configured Drops listed. An example of what this
panel looks like is displayed below.
Select one or more of the listed drops then press the Delete button.
Button Descriptions
Return: Pressing this button will return you to the Configure Token Ring Drops panel.
Select All: When pressing the Select All button, all of the displayed Drops will get
selected.
Clear All: Pressing the Clear All button will deselect any selected Drops.
Delete: Pressing the Delete button will cause a message to display:
You are about to delete the selected drops on line 0. Are you sure you want to do this?
Pressing the OK button will complete the deletion. Pressing the Cancel button will abort
the deletion.
707158-003
5-9
CNA-8000 Installation and Configuration
Chapter 6. Ethernet Gateway
Configuring Ethernet XCA LLC and DLSW Drops
The downstream side of the XCA circuits defined and assigned to subchannels on the
ESCON/FICON interface(s) must be defined to the Ethernet, Token Ring, and SDLC
network interfaces. To define the downstream portion of the XCA circuit to reside on
Ethernet, select Ethernet from the Connectivity Configuration menu.
The resulting panel should appear similar to the one shown below.
707158-003
6-1
Chapter 6. Ethernet Gateway
Field Definitions
Configure Ethernet Line: This dropdown control allows you to select a different
Ethernet interface to configure.
Line ID: This is the name that you choose to use for the Ethernet interface.
Mac Address: This field indicates the MAC address assigned to this Ethernet interface.
If the ‘Use Burned in MAC Address’ option is selected this field will display the
hardware assigned MAC address and the field will be grayed out so that you can not
change the value. If the option is not selected, then you may enter a locally-administered
MAC address value. Entered values should consist of 6 hex bytes separated by colons.
Example:
02:00:01:75:B3:02
Duplicating a MAC address may cause one or both platforms to stay off the network, or
could cause other errors. The selection of this address is important.
If the CNA-8000 is replacing an existing 37x5 FEP or a Token Ring gateway product, the
downstream platforms that are communicating to that product, include in their
configurations the Token Ring address of that gateway/FEP product. To avoid having to
reconfigure all of those platforms, you may want to set the Ethernet address of the CNA8000 to that same address. You can not typically however, replace a Token Ring address
directly with the same address on an Ethernet card. This is due to Ethernet and Token
Ring designating the high order bit in complete opposition to each other. You must
therefore convert the existing Token Ring address to an Ethernet address using a bit
swapping algorithm. Refer to the section discussing ‘Bit-Swapping LAN Addresses’
below.
6-2
707158-003
CNA-8000 Installation and Configuration
If you wish to use the burned in MAC address you can select the checkbox entitled ‘Use
burned in MAC address’. This is not recommended. Since downstream platforms are
configured for the MAC address of this unit, replacing the board in the CNA-8000 would
require reconfiguration of all downstream units. Any other address entered will be used to
override the burned in address. Traditionally, locally administered Ethernet addresses use
the format 02:00:xx:xx:xx:xx, where ‘x’ can be any valid hex digit.
Note that you can not attach the CNA-8000 to the same Ethernet as the platform you are
replacing (or the same bridged Token Ring) and have them powered on at the same time
if you have duplicate addresses. (If you have a duplicate address situation, the CNA-8000
will stay off the Ethernet.) If you want to conduct tests where the CNA-8000 has the
same address as the platform it is replacing, you must ensure that both platforms are not
powered on and connected to the same network at the same time.
Use Burned in MAC Address: This option allows you to use the unique factory
assigned MAC address when selected. Selecting this option will cause the burned in
address to be displayed and used.
Media Type: This dropdown control allows you to specify which media interface is to
be used. Most of the time you will want to leave the option to Auto Negotiate the correct
interface speed. If you have difficulty making contact with the Ethernet interface
remotely, you may want to assign a speed to the interface to match the switch/hub that
you will be attaching to. Valid options for this parameter are:




Auto Negotiate
10 Mbit
100 Mbit
1 Gbit
Duplex Mode: This option is used to identify whether the interface will run in Full
Duplex or Half Duplex mode. If the Media Type option is set to Auto Negotiate, you
should not have to configure this option. Set the Media Type to Auto Negotiate whenever
possible.
Response Timer T1 (secs): This option identifies how long the CNA-8000 Ethernet
interface is to wait for an LLC response before declaring a timeout and retransmitting the
request.
Retry Count N2: This option identifies the maximum number of retransmissions that
will be attempted before attempting error recovery.
Inactivity Timer TI: This option identifies how long the CNA-8000 Ethernet interface
will wait between attempts to contact the session partner when there is no session
established.
707158-003
6-3
Chapter 6. Ethernet Gateway
Button Definitions:
Update: The Update button causes the information on the panel to update the
configuration file. You must press the [Update] button before leaving the panel if you
want the changes to be made, otherwise the changes will be discarded.
Return: Selecting this button will take you back to the Update Connectivity
Configuration panel.
LLC Drops: Selecting this button displays the LLC Drops panel.
DLSW Drops: Selecting this button displays the DLSW Drops panel.
6-4
707158-003
CNA-8000 Installation and Configuration
Bit-Swapping LAN Addresses
Whenever you have a cross media LAN circuit connection between Ethernet and Token
Ring, you will probably need to bit-swap the LAN addresses to complete your
configuration. This is because of the way the address is identified between the two media.
The low order bit designation is opposite between the two LAN media. That is, the most
significant bit in one media is the least significant bit in the other media. This only
becomes an issue when you are entering the LAN addresses that you need as part of the
configuration.
The address that you enter for your media is always correct for your media, but if you are
referencing the address of another platform that is attached to the other media, then you
must reference the bit swapped version of that address. (For example the CNA-8000 is
attached to a Token Ring and the DSPU is attached through an LLC bridge on Ethernet.)
Following you will find an example of a procedure you can use to bit swap an address.
For the example, we will bit-swap the Token Ring address 40:00:37:45:00:16 to the
equivalent that would be seen on an Ethernet drop.
Bit swapping is performed on a byte by byte basis. Separating the address into individual
bytes, we end up with:
40
00
37
45
00
16
00000000
00010110
00000000
01101000
00
68
which translates to the binary representation of:
01000000
00000000
00110111
01000101
Now if we swap the bits of each byte we will have:
00000010
00000000
11101100
10100010
Now displaying the resulting hex values again we have:
02
00
EC
And bringing it back together :
A2
02:00:EC:A2:00:68
So the bit-swapped version of 40:00:37:45:00:16 is 02:00:EC:A2:00:68.
707158-003
6-5
Chapter 6. Ethernet Gateway
Locally administered addresses for a Token Ring environment will normally begin with
4000…. and for the Ethernet environment 0200….. So, for a configuration for the
Ethernet interface, both the local address of the Ethernet card and the address of a remote
Token Ring box, both addresses will typically begin with 0200….., and if the same
configuration were to be implemented on a Token Ring interface, both addresses will
typically begin with 4000….
6-6
707158-003
CNA-8000 Installation and Configuration
LLC Drop Panel
When you select the [LLC Drop] button, the LLC Drop Panel appears similar to the
picture below:
Field Definitions
Configure Ethernet Line: This is a dropdown control listing the available Ethernet
lines. You may select a different Ethernet Line to configure drops on.
Drop: This dropdown control lists the Ethernet Drops already defined for the selected
Ethernet interface. You can display a different drop by selecting the desired drop from
the list.
Dynamic LLC Connection: When this box is checked, this definition will be used for
dynamic connections. Multiple remote stations may connect through a single Dynamic
LLC Drop. When a remote station connects, it will be challenged for its SNA XID
(PUID). This XID will be forwarded to VTAM through the specified XCA connection
and used to dynamically connect the station to an upstream VTAM Switched PU2
definition that is configured to match the XID (PUID). Selecting Dynamic LLC will force
the remote MAC address in the configuration to ’00:00:00:00:00:00’ and gray out the
‘Remote MAC Address’ and ‘Remote SAP’ since the CNA-8000 will not care what those
values are.
Drop ID: This field allows you to assign a name for this drop that will be used in other
panels to reference this drop. A default name is generated by the CNA-8000 when you
define a new drop.
707158-003
6-7
Chapter 6. Ethernet Gateway
Remote MAC Address: Remote nodes may be identified by entering their IP address
and SAP. This can provide increased security but less flexibility than defining the drop to
be dynamic.
Local SAP: The Local SAP is the service access point used by the CNA-8000 to listen
for connection attempts to access this drop. Values for this option must be a multiple of
hex 02.
Remote SAP: When specifically defining a remote node to have access, the SAP of that
remote node must be specified. When the drop is defined to be dynamically accessible
the SAP field is not required and will be grayed out.
Maximum Transmit Frame Size: This option determines the maximum size frame that
may be sent to the session partner. Normally the default value of 1500 (which is the
maximum size for Ethernet) is used.
Receive Window Size: This is the maximum number of frames that can be received
from the session partner before a response is required. The default value for this option is
1 and should be typically a value less than the Transmit Window size of the session
partner. For more information on selecting a Receive Window size refer to the section
entitled Window Size Selection below.
Transmit Window Size: This is the maximum number of frames that can be sent before
a response from the session partner is required. The default value for this parameter is 2
and is typically set to a value greater than session partner’s Receive Window. For more
information on selecting a Receive Window size refer to the section entitled Window
Size Selection below.
Network Protocol: This dropdown control is currently populated with XCA as the only
option that is always selected.
Keepalive Timeout (secs): This option can be used to help determine when a remote
connection goes away.
6-8
707158-003
CNA-8000 Installation and Configuration
Window Size Selection
The Transmit and Receive Windows Size parameters are part of a static sliding Window
algorithm used by LLC for controlling packet flow. There is a separate set of Transmit
and Receive Window settings for each end of an LLC circuit. Coordinating the values
used is recommended.
The Transmit Window represents the maximum number of outstanding packets (packets
without a response or acknowledgement) a platform can send before having to stop and
wait for a response to one of the packets. Setting the Transmit Window too small may
result in a platform having to stop and wait for a response often, causing poor response
times. Setting the value too high, may result in having to retransmit several packets,
whenever a packet gets clobbered or lost. (If a negative acknowledgement is received for
a packet, then that packet and subsequent packets that have already been sent must be
resent.)
The Receive Window represents how many packets in a single conversation can be
received before an acknowledgement must be queued to be sent. If a Receive Window
size is set too large, the receiver may be waiting to receive additional packets that are not
forthcoming, resulting in unnecessary delays in sending acknowledgements.
As a general rule, you want to keep the Transmit Window set to a higher value than the
Receive Window. This allows the transmitter to keep sending packets, and with the lower
Receive Window at the session partner, the partner will send acknowledgements back
sooner than required. As the transmitter receives acknowledgements, the number of
outstanding unacknowledged packets will decrement allowing for even more packets to
be sent. The longer the path from transmitter to receiver, the larger difference you may
want between Transmit and Receive Windows. (This is the sliding window.) This works
well for LAN environments, but may not for WAN environments.
In WAN environments packets can be distorted or lost or delayed to the point where an
earlier packet arrives after a later packet. In cases where there is an apparent sequence
number error, the normal recovery is for the LLC circuit to be taken down and brought
back up. This can result in abnormal termination of a session. Keeping the Transmit and
Receive Windows set to 1 ensures that there are no sequence number errors.
The rules of thumb for setting the Window sizes are as follows:
1)
For a LAN environment use a Transmit Window size of 2 + an additional
value of 1 for each hop (bridge or router that is crossed) between the
transmitter and receiver, up to the maximum value.
2)
Keep the Receive Window set to the common default of 1.
3)
For a WAN environment with frequent congestion or unreliable delivery, use
a Transmit Window of 1 and a Receive Window of 1.
707158-003
6-9
Chapter 6. Ethernet Gateway
Button Definitions
Return: Pressing this button will return you back to the ‘Configure Ethernet Line’ panel.
Update: Selecting the Update button will save the current values. If there is a value in
error, an error message will display to the right of the buttons to inform you of the
problem.
Delete: Select the LLC Drop that you wish to delete from the Drop ID dropdown control
and press the [Delete] button to dispose of the definition. Upon confirmation of your
request the drop will be deleted and the listing of that drop will be removed from the list.
Add: Pressing this button will cause the Drop ID field to change from a dropdown list to
a data entry field and defaults for the new drop will appear. Make the configuration
changes needed for the new drop; then press the Update button to save the information.
6-10
707158-003
CNA-8000 Installation and Configuration
Deleting Ethernet Drops
When pressing the Delete button on the Configure Ethernet Drops panel, a new panel will
be displayed with the currently configured Drops listed. An example of what this panel
looks like is displayed below.
Select one or more of the listed drops then press the Delete button.
Button Definitions
Return: Pressing this button will return you to the Configure Ethernet Drops panel.
Select All: When pressing the Select All button, all of the displayed Drops will get
selected.
Clear All: Pressing the Clear All button will deselect any selected Drops.
Delete: Pressing the Delete button will cause a message to display:
You are about to delete the selected drops on line x. Are you sure you want to do this?
Pressing the OK button will complete the deletion. Pressing the Cancel button will abort
the deletion.
707158-003
6-11
Chapter 6. Ethernet Gateway
Configuring the DLSW Drop Panel
Pressing the [DLSW Drops] button on the Ethernet Line panel causes the Configure
DLSW Drops panel to display. This panel allows you to define a DLSw pipe across an IP
network to a remote IP DLSw router. PU2 SNA traffic is transported through this pipe
within IP packets making use of any available IP network redundancy. A DLSw
definition must be matched in the CNA-8000 configuration to an ESCON subchannel
definition later through a configured gateway circuit. This allows network attached PU2
devices to communicate to Switched Major Node PU2 definitions on the host.
It should be noted that if a downstream PU2 node attempts to attach through the CNA8000 using two or more circuits to connect to the same VTAM XCA circuit (same CNA8000 subchannel), the node must use different SAPs to connect from. Example if the
node uses the DLPID MAC value 02:00:11:74:00:26 and SAP 04, then a second circuit
from the same node must use a different SAP such as 08. When the CNA-8000 passes the
connection request up to VTAM, if the same MAC and SAP attempt a connection,
VTAM will see it as an attempt for the same client to connect (duplicate connection)
which will fail.
An example of the DLSW Drops panel appears below.
6-12
707158-003
CNA-8000 Installation and Configuration
Field Definitions
Drop ID: This control has a dual function. When Drops have been created, this control is
a dropdown control containing a list of available drops. If you select the [New] button the
control changes into a data entry control allowing you to type a new name into the field.
The name can be most any text string (alphanumeric characters plus dash, underscore,
and period characters), and should be created by the administrator to provide a name for
the drop that is most useful to describe what or where it is.
Network Interface: This dropdown control lists all of the Ethernet interfaces, allowing
you to select the interface that you want to assign the drop to.
Dynamic: Checking this control for the drop causes the interface to operate in
promiscuous mode. That means that you do not have to define specific definitions for
each downstream node that you want to allow use of the DLSw pipe. Any downstream
node that is presented to the interface by its downstream DLSw partner will be accepted
as if it were predefined. Selecting the Dynamic check box will cause the DLPID and
Remote DLPID fields to become disabled.
Canonical MAC Addresses: This checkbox determines whether the MAC address
entered in the DLPID MAC Address and the Remote DLPID MAC Address fields are
being displayed in Canonical MAC format or Non-Canonical MAC format. Canonical
MAC format indicates that the address is ordered with the least significant bit on the left
and is how Ethernet addresses are typically formatted. Non-Canonical MAC format
indicates that the address is ordered with the most significant bit on the left and is how
Token Ring addresses are typically formatted.
DLPID (MAC Address and SAP): This defines the local data link address to be used to
receive connections directed to this drop. When Promiscuous mode is selected this
address has no meaning since all requests received regardless of the destination will be
accepted. When Promiscuous mode is not selected, any connection request through this
drop must direct the traffic to the specified MAC Address/SAP pair configured.
Remote IP Address: Enter the IP address of the remote DLSw partner. This is typically
a DLSw router, but could also be another DLSw endpoint such as a Visara 1174
controller. Together this drop definition and the Remote IP Address partner define a
DLSw pipe through which one or more downstream PU2 nodes may communicate.
Remote DLPID (MAC Address and SAP): This defines the remote data link address
and SAP used by the remote PU2 node that this drop is defined for. If the remote node is
LAN attached to the remote DLSw gateway, the MAC address and SAP should represent
the MAC address and SAP configured in that node. If the remote node is SDLC attached
or the remote node contains the DLSw gateway, then the address and SAP are normally
configured in the DLSw gateway itself. When Promiscuous mode is selected, this
parameter is not configured since any remote PU2 node that requests a connection will be
allowed to connect through this drop.
707158-003
6-13
Chapter 6. Ethernet Gateway
DLSw Version: Two DLSw versions are supported by the CNA-8000. Version 1
represents remote nodes that adhere to RFC 1434. This is typically a Visara 1174
controller, but could also be an IBM 6611 router or possibly some other platform that
supports RFC 1434. Version 2 represents remote nodes that support RFC 1795. This is
the more commonly supported RFC supported by most router vendors. Note that
platforms that support RFC 2106 should use the Version 2 setting, as those platforms
should negotiate backwards to RFC 1795 compatibility.
Keepalive Timeout (secs): This parameter indicates whether you want to invoke a
keepalive timer to determine when a remote node has gone away. Setting a non-zero
value indicates the interval of the timer. A value of zero indicates that the Keepalive
timer is disabled. Identifying that a node is no longer connected allows the CNA-8000 to
request VTAM to clean up the connection (allowing VTAM to accept another connection
through a different gateway).
Button Definitions
Return: Pressing this button will return you back to the ‘Configure Ethernet Line’ panel.
Update: Selecting the Update button will save the current values. If there is a value in
error, an error message will display to the right of the buttons to inform you of the
problem.
Delete: Select the DLSw Drop that you wish to delete from the Drop ID dropdown
control and press the [Delete] button to dispose of the definition. Upon confirmation of
your request the drop will be deleted and the listing of that drop will be removed from the
list.
New: Pressing this button will cause the Drop ID field to change from a dropdown list to
a data entry field and defaults for the new drop will appear. Make the configuration
changes needed for the new drop; then press the Update button to save the information.
6-14
707158-003
CNA-8000 Installation and Configuration
Chapter 7. SDLC Gateway
The CNA-8000 can be used to gateway SNA PU2 traffic across SDLC lines. First you
will need to define the SDLC line information and drops. Afterwards you must tie the
SDLC definitions back to the appropriate subchannel (XCA gateway) using a gateway
definition. You will also need to define at least one of the network interfaces (such as
Eth0 or Eth1) for LLC communications. The SDLC gateway must be assigned to appear
to be on a valid network adapter that is configured to support LLC. (Note that it is not
necessary to have the network adapter actually connected to a network unless there are
also network attached platforms making use of the network connection.) To configure the
SDLC lines select the [SDLC] button on the Connectivity Configuration menu.
707158-003
7-1
Chapter 7. SDLC Gateway
The resulting Configuring SDLC Line panel is displayed below.
Field Definitions
Configure SDLC Line: This dropdown control displays the current line that the
configuration is associated with, and allows you to display a different line configuration.
Network Protocol: Currently only PU2.0 and PU2.1 protocols are supported on the
CNA-8000 through the SDLC interface.
NRZI: Set to ‘Yes’, the NRZI option will be used. When set to ‘No’, NRZ will be used
instead. This parameter must be set correctly to establish communication with the remote
device. If you are replacing an NCP platform with the CNA-8000 the correct value for
this parameter should show up in the NCP gen and is also called ‘NRZI’ there.
RTS: When set to ‘Constant’ the Request to Send (RTS) signal will be kept high. This
option is the preferred option if you are using a 4-wire circuit, since the CNA-8000 will
not have to wait for Clear to Send (CTS) to be offered. If you are using a 2-wire circuit,
you must set this option to ‘Controlled’. When set to ‘Controlled’ the RTS signal will be
brought active only when the CNA-8000 needs to transmit data. If you are having
difficulty getting a new circuit to work, set this option to ‘Controlled’, since it will work
in 2-wire and 4-wire situations, until you are confident that the circuit is 4-wire.
Poll Interval: The poll interval indicates the minimum amount of time between the start
of each poll cycle. A timer begins at the start of a poll cycle, and if the cycle is completed
and the interval has not been met, then the CNA-8000 will wait until the interval lapses to
begin the next poll cycle.
Line Protocol: Currently SDLC is the only protocol supported for this interface.
7-2
707158-003
CNA-8000 Installation and Configuration
Line ID: This is a text field (alphanumeric plus underscore, dash, and period) that you
can enter a description for the line to make it more recognizable for management
purposes.
Line Speed: Most lines will be configured for ‘External’, indicating that a modem or
modem eliminator is to be attached that will provide the clocking for the circuit. If no
modem or modem eliminator are to be used and the CNA-8000 is to provide the clocking,
then you will need to set this option to one of the clocking speeds provided in the drop
down. The QSI card will attempt to provide the clocking signal for SDLC interfaces
when a value for any speed other than ‘External’ is set. When the CNA-8000 is providing
clocks, a special DCE adapter should be ordered to fit between the end of the QSI cable
and the end of the corresponding unit’s cable. This DCE adapter provides correct pin
configurations to support the clocking functions. Note that there are separate adapters
available for RS232 and V.35.
Supported clocking speeds are:









4800 bps
9600 bps
14,400 bps
19,200 bps
56,000 bps
64,000 bps
128,000 bps
T1 (1.544 Mbps) speed
E1 (2.0 Mbps) speed
Serial Interface
Cable
Serial Interface
Cable
DCE
Adapter
FEP-4600
(Providing Clocks)
AS400
Duplex: There are three values for this option:
 Full – RTS is kept active to reduce turnaround time. If you are connected to a 2wire circuit, you must not use this setting.
When using this for multi-drop lines, the CNA-8000 does not have to wait for a
response from one drop before a poll is sent to the next drop in the list. The
secondary PUs on the line should be set for Half Duplex. Outbound data takes
priority over polling a drop with no outbound data.
When using this on point-to-point lines, both the CNA-8000 and the secondary
station can be set for Full Duplex
 Half – RTS is switched. The CNA-8000 and the secondary PU(s) take turns
communicating over the line.
For multi-drop lines, each drop is polled in order, regardless of whether there is
outbound data for one of the drops.
 HDXSP – The CNA-8000 will operate the same as when configured for ‘Half’
with one major difference. If the CNA-8000 has outbound data, sending the data
will take precedence over a scheduled poll to a drop.
707158-003
7-3
Chapter 7. SDLC Gateway
Note: If you are having trouble getting a new circuit up, then set this value to ‘Half’ until
you resolve what is causing the problem. You should also turn off all but one drop on a
multi-drop line, and add more drops one at a time until they all work. If adding a drop
causes problems, check to ensure that the drop is configured to run in Half Duplex mode
and that the address of the new platform does not duplicate an address already in use.
Poll Timeout: This value determines how long the CNA-8000 is to wait for a response
before continuing through the poll list.
Line Type: The options for this are either ‘Leased’ or ‘Switched’. If the remote platform
will be dialing in, then set the Line Type for ‘Switched’. Otherwise set it for ‘Leased’. If
the Line Type is set to Switched, then the remote box should be configured to pass
IDBLK and IDNUM information in the form of an Exchange ID (XID).
Max Out: The value of this option determines the maximum number of outstanding
frames that the CNA-8000 will support on this line. The default value is 7.
Button Definitions
Return: Pressing the Return button takes you back to the previous panel.
Update: Pressing the Update button will save the current values. If there is a value in
error, a message will display to the right of the buttons to alert you to the error situation,
and the values will not be saved.
Drops: Selecting the Drops button will display the SDLC Drops panel to allow you to
edit the configurations of currently defined drops, and allow you to define new drops.
7-4
707158-003
CNA-8000 Installation and Configuration
SDLC Drop Panel
By selecting the ‘Drops’ button the following SDLC Drop Configuration panel will
display.
Field Definitions
Configure SDLC Line: This option defaults to the line that you selected. You can
change to a different line to make changes to.
Drop: This defaults to the Drop that you selected, but you can change the configuration
of a different drop if you wish by selecting another drop from the drop down control.
Undefined Drops are ignored. To add a new drop, select the [Add] button at the bottom of
the panel.
Drop ID: This is a text field (alphanumeric plus underscore, dash, and period) that you
can define that will be used in the CNA-8000 panels to allow you to recognize individual
drops better.
Address: This is the hex value (01-FE) that will be used to poll the platform identified
by this Drop. The value entered on this panel must match the configuration of the
platform that is represented by this drop.
707158-003
7-5
Chapter 7. SDLC Gateway
Frame Size: This option determines the maximum frame size that will be sent by the
CNA-8000 to the remote platform, and ranges from 265-4105. Common values are:
 265: This is the default value and the smallest frame size that is allowed. All
SDLC platforms are required to support a minimum frame size of 265. Any 3274
or 3276 compatible platform will support this value.
 521: This is the commonly supported value for a 3174 compatible platform.
 4105: This value is supported by some platforms (such as a Visara 1174 HSC
card).
Configure a value that is compatible with the type of platform that is connected. Setting a
larger value than that which is supported by the remote platform will result in receive
overrun errors on the remote platform. If the remote platform is unknown, use the default
value initially.
Initial Status: This option determines whether the CNA-8000 should attempt to poll the
SDLC line whenever it is powered up. If set to Active, the CNA-8000 will attempt to poll
the drop at the configured interval anytime that the CNA-8000 is up. If set to Inactive, the
CNA-8000 will not attempt to bring up the drop.
Button Definitions
Return: Pressing this button will return you back to the ‘Configure SDLC Line’ panel.
Update: Selecting the Update button will save the current values. If there is a value in
error, an error message will display to the right of the buttons to inform you of the
problem.
Delete: Pressing the Delete button will cause a new panel with the currently defined
Drops listed, to allow you to delete one or more of them. Refer to the Deleting SDLC
Drops section below.
Add: Pressing this button will cause the fields to display their defaults and display the
next drop number. Make the configuration changes needed for the new drop, and press
the Update button to save the information.
7-6
707158-003
CNA-8000 Installation and Configuration
Deleting SDLC Drops
When pressing the Delete button on the Configure SDLC Line panel, a new panel will be
displayed with the currently configured Drops listed. An example of what this panel
looks like is displayed below.
Select one or more of the listed drops then press the Delete button.
Button Definitions
Return: Pressing this button will return you to the Configure SDLC Line panel.
Select All: When pressing the Select All button, all of the displayed Drops will get
selected.
Clear All: Pressing the Clear All button will deselect any selected Drops.
Delete: Pressing the Delete button will cause a message to display:
You are about to delete the selected drops on line x. Are you sure you want to do this?
Pressing the OK button will complete the deletion. Pressing the Cancel button will abort
the deletion.
707158-003
7-7
CNA-8000 Installation and Configuration
Chapter 8. Gateway Circuit Configuration
XCA gateways on the CNA-8000 are used to provide data pipes for SNA traffic between
an ESCON or FICON subchannel interface and a LAN adapter. On the host side,
switched PU 2.0 or 2.1 nodes defined in VTAM communicate through the XCA gateway
to what appears to be LLC attached LAN nodes. Traffic exiting the XCA data pipe in the
CNA-8000 always arrives on the LAN side in LLC format. Gateway Circuits are used on
the CNA-8000 to direct this LLC traffic and provide a further reformatting of the data to
communicate with three different types of drops, LLC, SDLC, and DLSw.
The resulting Configure Gateway Circuits panel appears similar to the one below:
707158-003
8-1
Chapter 8. Gateway Circuit Configuration
Field Definitions:
Gateway Identifier: The Gateway Identifier field functions in two ways. When one or
more gateways have been defined, the control functions as a dropdown control listing all
of the previously defined gateway circuits. Pressing the [New] button changes the control
to a data entry field. This allows you to enter a new Gateway Identifier (name) to be
associated to the new Gateway Circuit.
XCA Subchannel: This dropdown box determines which of the ESCON/FICON
subchannels is to be the destination of the traffic. Each subchannel is the host side of an
XCA portal capable of directing traffic for up to 255 PUs simultaneously. Each XCA
subchannel is associated with a specific ESCON/FICON physical interface, VTAM SAP,
and network adapter. Selecting an XCA subchannel causes the appropriate dropdown
control (as selected by the gateway type to populate with only the drops on the network
adapter associated with the subchannel (the ESCON/FICON Subchannel panel needs to
have been configured previously).
PUID Override: This checkbox is selected to indicate that the predefined gateway
circuit will substitute whatever PUID may be provided by the downstream PU node with
the one configured in the PUID field. The checkbox will be grayed out whenever a
dynamic gateway type has been selected.
PUID: The PUID field can be configured with a value that will be passed upstream to
VTAM (to be matched to the IDBLK and IDNUM parameters). This value is typically
used when the gateway circuit is used to map a downstream SDLC node to an XCA
destination. If configured for a downstream LAN device, the PUID will override any
PUID provided by the downstream node.
Predefined DLSW: Selecting this control will cause only predefined DLSw Drops
associated with the network adapter configured for the indicated XCA Subchannel to
display as options.
8-2
707158-003
CNA-8000 Installation and Configuration
Dynamic DLSW: Selecting this control will cause only dynamic DLSw Drops
associated with the network adapter configured for the indicated XCA Subchannel to
display as options.
Predefined LLC: Selecting this control will cause only predefined LLC Drops
associated with the network adapter configured for the indicated XCA Subchannel to
display as options.
Dynamic LLC: Selecting this control will cause only dynamic LLC Drops associated
with the network adapter configured for the indicated XCA Subchannel to display as
options.
SDLC: Selecting this control will cause only SDLC Drops to display as options.
Enabling SDLC will cause the Virtual MAC Address and Virtual SAP fields to become
enabled.
Virtual MAC Address: This address is used by SDLC destinations when
communicating with VTAM since connections through an XCA gateway are expected to
be LAN attached devices. Traffic to and from the SDLC node are made to appear to be
directed to and from the MAC address from the perspective of VTAM.
Virtual SAP: Like the Virtual MAC Address, a node that is being addressed through an
XCA gateway requires a SAP to identify the service access point to which the traffic
must be directed. For SDLC nodes this Virtual SAP serves the purpose.
Force 2-stage pacing in BIND: When checked, BINDs passing through this gateway
circuit will be monitored, and the appropriate bit to force 2-stage pacing will be
overlayed onto the BIND before sending it on. Left unchecked, BINDs will be passed
through to the clients as sent by the host.
707158-003
8-3
Chapter 8. Gateway Circuit Configuration
Button Definitions
Return: Pressing this button will return you back to the ‘Configure Connectivity’ menu.
Update: Selecting the Update button will save the current values. If there is a value in
error, an error message will display to the right of the buttons to inform you of the
problem.
Delete: Select the Gateway Identifier that you wish to delete from the Gateway Identifier
dropdown control and press the [Delete] button to dispose of the definition. Upon
confirmation of your request the gateway definition will be deleted and the listing of that
circuit will be removed from the list.
New: Pressing this button will cause the Gateway Identifier field to change from a
dropdown list to a data entry field and defaults for the new gateway circuit will appear.
Make the configuration changes needed for the new gateway circuit; then press the
Update button to save the information.
8-4
707158-003
CNA-8000 Installation and Configuration
Chapter 9. Host Circuit Definition
Configuring XCA Host Circuits
When running the TN3270 Server option on the CNA-8000, Host Circuits must be
defined to interact with VTAM as PU type 2 nodes. Each Host Circuit must have a
corresponding PU2 Switched Node definition in VTAM, identified by a configured PUID
that must match the IDBLK and IDNUM values within the VTAM PU2 definition.
Corresponding LU definitions in VTAM are used to support the TN3270 display and
printer sessions associated with the Host Circuit. Host Circuits should be defined prior to
defining the TN3270 client connectivity.
Each Host Circuit appears to VTAM as if it were connected through a LAN adapter on
the CNA-8000. This is only an illusion, since the Host Circuit actually resides within the
server. To complete the illusion, each Host Circuit must have a virtual MAC address and
SAP assigned to it so that VTAM can direct data traffic to it. The virtual LAN location
can be assigned to any of the configured XCA Network Interfaces. (At least one of the
network adapters needs to be configured as an XCA Network Interface to support this
feature.)
To define a Host Circuit on the CNA-8000 you will need to select the [XCA Host
Circuit] button on the Connectivity Configuration panel.
707158-003
9-1
Chapter 9. Host Circuit Definition
The resulting XCA Host Circuits panel will appear similar to the one below.
Each Host Circuit must be given a virtual drop assigned to communicate through one of
the configured XCA subchannels to reach the host.
Host Circuits that have already been defined appear in the Host Identifier dropdown
control. Additional Host Circuits can be defined by pressing the [New] button. A more
complete description of the controls on this panel follows:
Field Definitions:
Host Identifier: Provides a dropdown list of Host Circuits that are already defined.
When the [New] button is pressed, the control becomes a data entry field, allowing you to
enter a new name.
XCA Subchannel: This dropdown control lists all of the defined XCA subchannels.
These are defined on the ESCON/FICON Subchannels panel.
PUID: This field allows you to define the PUID that will be sent inbound to VTAM to
be matched against the Switched PU definition. The first three digits are matched to the
IDBLK parameter in the VTAM PU2 definition, and the last five digits are matched to
the IDNUM parameter in the VTAM PU2 definition.
Virtual MAC Address: Since the Host Circuit is to appear to be located downstream to
one of the network adapters (virtually) the Host Circuit must have a MAC address
associated with it. The value of the MAC address itself is not important as long as it is
unique to the network, giving VTAM a proper destination to direct the traffic to.
9-2
707158-003
CNA-8000 Installation and Configuration
Virtual SAP: Likewise, the value of the SAP is not important as long as the value is a
valid SAP value (multiple of hex 04 on zOS systems or multiple of hex 02 on zVM
systems). The value selected should be unique to the Virtual MAC Address that it is
assigned to.
Restrict Connections to Active LUs: When selected, TN3270 clients attempting to
connect to the CNA-8000 will only be allowed to connect if their destination LU has
been activated by VTAM. When the LU has not been activated, the client will be
informed that the connection can not be made by way of a NVT message at connection
time. When pools are used, only LUs that have been activated within the pool will be
allocated to clients when this option is enabled.
Disconnect Client Upon Unbind: When selected, clients will be automatically
disconnected from the CNA-8000 when they receive an UNBIND from the host. This
occurs when they log off from their active session or whenever the session becomes
unbound (such as due to a problem that takes the session down). If left unselected, the
client connection will not be disconnected when their session ends, but would normally
be presented with a VTAM logon screen so that the client can log onto another session if
desired.
Button Definitions:
Return: Selecting this button will take you back to the Connectivity Configuration
menu.
Update: The [Update] button causes the information on the panel to update the
configuration file. You must press the [Update] button before leaving the panel if you
want the changes to be made, otherwise the changes will be discarded.
New: Pressing the [New] button changes the dropdown control into a data entry control
allowing you to define a new Host Circuit. Once you have entered the name for your new
Host Circuit and selected other desired parameters for the CU that you wish to associate
it with you will need to press the [Update] button. This will change the control back to a
dropdown control that will include the newly defined Host Circuit.
Delete: This button is used to delete a Host Circuit definition. Select the Host Circuit
that you wish to delete using the dropdown control, then press the [Delete] button.
707158-003
9-3
CNA-8000 Installation and Configuration
Chapter 10. TN3270 Client Configuration
The CNA-8000 offers a rich selection of options to support TN3270 clients. Listening
TCP ports must be configured for the clients to connect to. You may select optionally to
require encryption to be used when making the connection. Connections can be made to
pooled resources, or nailed to a specific Host Circuit and LU. It is also possible to
provide incoming clients with menus to select their resource from.
Security is provided by a combination of using specific connection ports, requiring a
valid user ID and password, requiring the before mentioned encryption, limiting access to
specific user IP addresses or specific subnets.
Configuration for the clients is achieved by selecting the [TN3270] button on the
Configuration Connectivity menu panel.
707158-003
10-1
Chapter 10. TN3270 Client Configuration
The resulting menu is displayed below.
10-2
707158-003
CNA-8000 Installation and Configuration
Configuring Listen Ports
The CNA-8000 will listen for TN3270 clients only on the TCP ports that have been
configured for listening. Clients attempting to connect to a TCP port that has not been
configured will be turned away by the CNA-8000, and an NVT message indicating that
the CNA-8000 rejected the connection should be sent.
To configure the TCP ports that will be listened to, select the [Ports] button on the
TN3270 Configuration Panel. The resulting panel will appear.
This panel allows you to define which TCP ports the CNA-8000 is to listen on and
whether traffic through the port is to use SSL encryption. Ports can be added to the list by
pressing the [New] button. Ports can be deleted from the list by selecting the port that you
wish to eliminate and pressing the [Delete] button. Before leaving the panel you will need
to press the [Update] button to save any changes that you have made.
The Ports dropdown box contains a list of all of the ports that have configured for
listening. A port only needs to be added one time. Any number of users may connect
through the same port if configured to do so. Port 23 is the default port for Telnet, which
TN3270 is part of. Most TN3270 clients will also default to use Port 23. For security
purposes and to avoid attempting to use other commonly assigned ports in the IP world,
the CNA-8000 permits port assignments of 23 and in the range of 1026 and higher.
Configured ports are available through any of the Ethernet adapters configured on the
platform.
707158-003
10-3
Chapter 10. TN3270 Client Configuration
To add a port for the CNA-8000 to listen to, press the [New] button. The Port field will
become a data entry field allowing you to type in the new port number.
The TN3270 client platform must support SSL encryption to establish a session to the
CNA-8000 when the Encryption option has been selected. Many emulators have
encryption built into the emulator. By default Visara uses self-signed certificates for SSL
encryption. Optionally you may choose to obtain your own certificates for use on the
CNA-8000 from a trusted certificate provider, or you may choose to load your own
corporate certificate. Contact your Visara support person for using SSL certificates other
than the one shipped on the platform.
Visara also offers a PC software package, eConduit that can provide encryption when the
emulator itself does not include it.
Field Definitions:
Port: This is a dropdown control that allows you to display the ports that have been
configured, and is an input field when you want to add another listening port. TCP ports
that are accepted are 23 (Telnet default port) and in the 1026-49151 range. There are a
few ports in the allowed range that are predefined for other protocols and may be
unavailable. A warning message will appear if you attempt to configure one of those port
numbers.
Encrypted: This checkbox is used to define whether SSL encryption will be required to
access the displayed port.
10-4
707158-003
CNA-8000 Installation and Configuration
Button Definitions:
Return: Returns you to the TN3270 Configuration menu panel. Make sure that you have
pressed the [Update] button prior to leaving the panel if you want to save changes made
on this panel.
Update: Causes any changes made since displaying this panel to be saved into the
configuration file.
New: Changes the Ports dropdown control to be a data entry field for typing in a new
listening port.
Delete: Allows you to delete the currently displayed listening port from the current list
of listening ports.
707158-003
10-5
Chapter 10. TN3270 Client Configuration
Configuring Session Pools
Before you define pools, you should have defined the CUs, Host Circuits, and the
sessions that belong to them.
Sessions may be pre-assigned to TN3270 clients or gathered together into a pool of
sessions where they are doled out one at a time to clients requesting a session from the
pool. The CNA-8000 supports multiple pools. Four methods can typically be used to
obtain sessions from a pool.
Method 1:
When clients connect to a specific TCP port number they are
automatically mapped to a session within the corresponding pool. Using specific TCP
port numbers allows for reconfiguration of resources on the CNA-8000 without having to
reconfigure individual user platforms.
Method 2:
Each client that is to use the pool is configured with the name of the pool
which is requested at connect time. This pool name is configured in the client’s
LUNAME field. Connection in this case can be through any configured listening port that
allows the user to specify the resource. You must configure the listening port as ‘User
Defined’ to use this method.
Method 3:
A nickname is configured into the client in their LUNAME field. On the
CNA-8000 the nickname is assigned to the pooled resource through configuration. Use of
the nickname allows reconfiguration of the resources on the CNA-8000 without having to
reconfigure the individual client platforms. You must configure the listening port as
‘User Defined’ to use this method.
Method 4:
Select the pool from a menu posted on the client’s screen at connection
time. You must configure the listening port to provide a menu to the client.
10-6
707158-003
CNA-8000 Installation and Configuration
To define or change pool definitions, select the [Pools] button from the TN3270
Configuration panel.
Selecting the [Pools] button will cause the following panel to display:
707158-003
10-7
Chapter 10. TN3270 Client Configuration
Any pools that already exist will be contained in the Pool Name dropdown control. To
add pools, press the [New] button. Enter the name for the new pool and enter the sessions
that you want to include in the pool and press the [Update] button to save the
information. The name that you select for the Pool Name must be 16 characters or less.
Resources are added to the pool by defining the Host Circuit and LU range within that
circuit then pressing the [Include] button.
Field Definitions:
Pool Name: This is a dropdown control that lists all of the pools that have been defined.
Selecting one of the pools in the list will cause a list of the host session resources that are
part of the pool to display in the list control below the pool name.
Host Circuit: This is a dropdown control with a list of all of the host circuits that have
been defined. Selecting a host circuit from the list will allow you to input a range of LUs
that you wish to include in the pool or to exclude from the pool.
LU Range: This allows you to input the low end and high end of a range of LUs to be
used with the Host Circuit dropdown.
Button Definitions:
Delete Selected Range: Pressing this button will delete the highlighted range from the
selected pool.
Include: Selecting this button will copy the indicated LU Range into the pool identified
by the Pool Name dropdown control.
Exclude: Pressing this button takes the information configured in the LU Range and
eliminates the range from the pool.
Return: Selecting this returns you to the TN3270 Configuration menu.
New: Pressing the [New] button converts the Pool Name field to a data entry field
allowing you to define a new pool name.
Delete: This button allows you to delete the selected pool as indicated by the Pool Name
control.
Update: Pressing this button saves the changes that you have made while on this panel.
When defining a new pool, you must press the [Update] button to save the new pool. A
message that the pool was successfully updated should appear to confirm that the pool
has been created.
10-8
707158-003
CNA-8000 Installation and Configuration
Configuring TN3270 Client Access
Management of which resources are to be made available to individual clients is
determined by what is defined on the Manage TN3270 Client Access panel. Some of the
options include:
 Client is assigned a predefined session
 Client receives a session from a pool of sessions
 Client can select a session from a menu
 Client can specify which resource they want at connection time through use of
their configured LUNAME field (using a nickname or using an acceptably
formatted request for a specific resource or pool)
This panel can further control access by allowing you to filter the clients by IP Address or
by Subnet, and by requiring a user ID and password.
Entry to the Manage TN3270 Client Access panel is made by selecting the [Clients]
button on the TN3270 Configuration menu.
707158-003
10-9
Chapter 10. TN3270 Client Configuration
An example of the Manage TN3270 Client Access panel is displayed below.
Field Definitions:
TN3270 Client Access Entries: This is a list of Client Access entries that have already
been defined (the above panel shows a single entry). Entries can be added by selecting
the appropriate information and pressing the [Add/Modify] button.
Note that you will still need to press the [Update] button prior to leaving the panel to
make the changes take effect.
Local IP Address: This field allows you to define whether you want to specify a
specific local IP address to be associated with the port number, or allow the port number
to be used by all local addresses, for the entry you are defining. If you use the default
value ‘*.*.*.*’ then the entry you create will apply to all network adapters used for client
access. You can also select one of the local IP interfaces from the dropdown control to
specify that this entry applies to only that interface.
Port: This dropdown control lists all of the TCP listen ports that have been defined for
TN3270 clients. Remember that how the port was defined determines whether the clients
need to use encryption or not.
Client IP Address: An IP address can be specified allowing you to pin a particular
client’s access to their IP address. You can also use wild cards (asterisk) to define subnets
or groups of clients. By using the value of ‘*.*.*.*’ all users connecting to the specified
port will make use of the resource(s) specified. Similarly you could limit access to a class
C subnet by using an entry similar to ‘195.17.34.*’. Anyone on that subnet could gain
access by meeting the port/local address requirement. Subnet access is usually associated
with access to a pool.
10-10
707158-003
CNA-8000 Installation and Configuration
Resource: This dropdown provides a list of resources that have been previously defined.
Included in the list are –
 All 3270 Hosts that have been defined
 All Pools that have been defined
 Present Menu option
 User Specified option
LU: This represents an individual host session within a host circuit. If you select a Host
in the Resource dropdown control, the LU field will be enabled allowing you to specify
which session belonging to that Host connection is to be assigned.
User ID Password Required: This checkbox indicates whether the user will be
challenged for a User ID and Password.
Button Definitions:
Add/Modify: Pressing this button either adds an entry to the list based on the selected
options, or if the entry would conflict with a previously defined entry, it will modify the
existing entry to satisfy the new definition.
Delete: This button allows you to delete the selected entry.
Return: Selecting this returns you to the TN3270 Configuration menu.
Update: Pressing this button saves the changes that you have made while on this panel.
707158-003
10-11
Chapter 10. TN3270 Client Configuration
Nicknames
Nicknames can be used by a client to request a resource without the user having to know
which resource they are requesting. This permits the platform administrator to assign a
resource to the nickname as needed. Resources can be moved and swapped without
having to involve the user in the making of the changes.
To create nicknames select the [Nickname] button on the TN3270 Configuration menu.
The resulting panel should appear similar to the one below.
10-12
707158-003
CNA-8000 Installation and Configuration
Field Definitions:
Nickname: This is the defined nickname that is to be configured in the client’s
configuration in the ‘LU Name’ field. (Note that the name of this field may vary from
one client software package to another.)
Host Selection Button: If selected, the Host dropdown control will allow you to select
from among the defined Hosts. Also the LU field will be enabled to allow you to enter a
valid value.
Host Dropdown Control: Provides a list of names for all configured Host Circuits. This
allows you to define which host the nickname is to have assigned to it. This control
should only be enabled when the Host Selection Button is selected.
LU: This is field allows you to identify the device session number belonging to the
selected Host that you wish to assign to the nickname. This control should only be
enabled when the Host Selection Button is selected.
Pool Selection Button: If selected the Pool Dropdown Control will be populated with all
of the Pools that have been configured to allow you to assign a pool to the nickname.
Pool Dropdown Control: This control is populated with all of the names of the pools
that have been configured. This control should only be enabled when the Pool Selection
Button is selected.
Button Definitions:
Return: Selecting this returns you to the TN3270 Configuration menu.
Update: Pressing this button saves the changes that you have made while on this panel.
New: Pressing this button allows you to add another Nickname. The Nickname field
changes from a dropdown control to a data entry control allowing you to enter a new
Nickname. Once you have entered the information necessary to define the new Nickname
you will need to press the [Update] button to save the information.
Delete: This button is used to delete the currently displayed Nickname. Pressing the
button will cause a message to be displayed allowing you to cancel the delete option if
you need to.
707158-003
10-13
Chapter 10. TN3270 Client Configuration
Managing TN3270 User IDs
TN3270 clients may be required to provide User IDs and passwords to gain access to
resources on the CNA-8000. This information is managed on the Manage TN3270 User
ID’s panel by the CNA-8000 administrator (not the clients themselves). To access this
panel, select the [User ID’s] button on the TN3270 Configuration menu.
The Manage TN3270 User ID’s panel should appear similar to that below.
10-14
707158-003
CNA-8000 Installation and Configuration
Field Definitions:
User ID: This control has a dual function. It is a dropdown control normally if any User
IDs have been defined. It changes to a data entry field when the [New] button is pressed.
If you wish to change the password for an existing User ID, select the User ID from the
dropdown list, enter the new Password and the Verification, then press [Update].
Password: This field is used to enter a password that is to be associated with the User
ID. This field is case sensitive.
Verification: You must enter the same information that was entered in the Password
field. This field is case sensitive.
Button Definitions:
Return: Selecting this returns you to the TN3270 Configuration menu.
Update: Pressing this button saves the changes that you have made while on this panel.
New: Pressing this button allows you to enter a new User ID (and associated password)
into the fields. The User ID dropdown will change to a data entry field allowing you to
enter the new User ID. Once you have entered the necessary information, you should
press the [Update] button.
Delete: The [Delete] button is used to cause the currently displayed User ID to be
deleted from the list. When pressed, a message will display allowing you to abort the
delete operation if needed.
707158-003
10-15
Chapter 10. TN3270 Client Configuration
Acceptable Formats for User Defined Connection Requests
In addition to using predefined nickname resources, when a port is configured to allow
the user to define the requested resource the LUNAME field of the client must use one of
the acceptable formats for making that request. Among the accepted formats are:
Pool_Name – Use one of the pool names that have been defined. Pool names are case
sensitive. LUs from the pool will be allocated based on the allocation algorithm used by
the CNA-8000. Only sessions from the requested pool will be allocated. If all sessions
associated with the pool are in use, a message indicated that the resource is currently
unavailable.
Host_Name – Use one of the configured Host Circuit names that have been configured.
Any available LU defined for that Host Circuit may be given to the requesting client.
Host_Name,LU_Number – Only the specified LU associated with the specified Host
Circuit will be allocated to the client. If the requested resource is already in use, a
message indicating that the resource is unavailable will be sent using an NVT datastream.
Host_Circuit_Number,LU_Number – In place of using a configured Host Circuit
name, the host circuit number may be used. Only the specified resource will be allocated
when requested and only if it is available. If the requested resource is already in use, a
message indicating that the resource is unavailable will be sent to the client using an
NVT datastream.
Note that if the option to ‘Restrict Connections to Active LUs’ is enabled and the
requested resource is not active, then a message will be sent to the client indicating that
the resource is not available.
10-16
707158-003
CNA-8000 Installation and Configuration
Making Dynamic TN3270 Changes
The CNA-8000 allows you to make configuration changes dynamically. That is, you do
not have to perform a Restart or Reboot to make changes related to TN3270 operations
take affect.
The way changes take affect can be broken down into two groups. Nickname changes
and User ID/Password changes take affect as soon as you press the [Update] button on
the configuration panel associated with those options. Changes made to Ports, Pools, and
Client definitions do not take affect immediately when you press the [Update] button on
those associated panels. The changes are written to the configuration file, but not read in
for immediate use. Instead you are allowed to make as many TN3270 related changes as
you need. If you want those changes to take immediate affect you can go to the TN3270
Configuration menu and press the [Apply] button as shown below. This will cause all of
the changes made to the Ports, Pools, and Client definitions to be read in and used.
It should be noted that we do not disconnect any client automatically that already has an
established session. When the [Apply] button is pressed the changes take affect for new
connections only. If you need to force a client session to disconnect, you will need to
make use of the [Disconnect] button option on the appropriate Host Circuit panel. Refer
to the CNA-8000 Users Guide and Maintenance Manual for how to force clients to
disconnect.
707158-003
10-17
CNA-8000 Installation and Configuration
Chapter 11. RPQs
RPQs are special features that usually have limited application (not widely used) and are
grouped onto a special panel. Enabling an RPQ may cause the CNA-8000 to react
differently to a particular set of circumstances than it would otherwise normally operate.
RPQs can be enabled by selecting the [RPQ] button on the Configuration menu.
707158-003
11-1
Chapter 11. RPQs
A panel similar to that below should appear.
Below is a brief description of the RPQs listed on this panel. For further information on
any of the RPQs or to request a feature not offered, contact your local Visara
representative.
UNBIND Before NOTIFY Power Off Sequence: Normally when a client disconnects
gracefully from the CNA-8000, a NOTIFY is sent to the application followed by an
UNBIND request to VTAM. Enabling this RPQ reverses the order of these two events.
Disconnect TN3270 Clients that Violate SNA Protocol: Normal operations when SNA
protocol is violated include sending an SNA sense code to VTAM to report the error, but
the client remains connected to the CNA-8000 unless some other event such as an
UNBIND occurs and the option to Disconnect on UNBIND is configured. When this
option is enabled, the TN3270 client will be forcibly disconnected from the CNA-8000
and the power off sequence will be followed to report the client’s departure.
Pass WRITE STRUCTURED FIELDS to LU3 TN3287 Clients: Not all TN3287
clients support WRITE STRUCTURED FIELDS so they may not automatically be sent
to the client unless this RPQ is enabled.
Use Terminate-Self Instead of Inbound UNBIND: Normally when a client wishes to
end a session and UNBIND will be generated (requested log off or session ending due to
a problem). With this option enabled, an SNA Terminate-Self will be sent in place of an
inbound UNBIND.
Maximize TN3287 Response Timer: When enabled, the response timer used to time
out a TN3287 client when it has been requested to perform a print will be increased to a
value much larger than normal to allow the client more time to perform its function and
respond.
11-2
707158-003
CNA-8000 Installation and Configuration
Fujitsu UNBIND, Force Reason Code to Normal: When this option is enabled, the
Reason Code will always be set to Normal regardless of the actual reason for the
UNBIND. This is required for use on Fujitsu mainframes running the Fujitsu OS.
Allow SAPs Divisible by Two: Normally only SAPs divisible by four are allowed in
configuration. When this RPQ is enabled, SAPs divisible by two are also allowed.
707158-003
11-3
Download PDF
Similar pages