NETEX NESiGate-CA User manual

MAN-REF-CASW
NESiGate-CA
NetEx/IP Host Channel-to-IP Gateway
Release 2.8.2
Reference Manual

Page ii MAN-REF-CASW
Revision Record
Revision Description
01 (Oct 2000) Initial manual release by Network Executive Software.
02 (Jan 2001) Added procedures for new CDROM distribution and software keys
03 (Jan 2002) Updated for RedHat 7.2 distribution and miscellaneous corrections and additions.
04 (Apr 2002) Miscellaneous updates to correspond with version 2.3 release.
05 (xxx 2002) Added documentation for Hitachi IBM-compatible configuration requirements.
06 (Oct 2002) Added documentation for NG_CA service
07 (Dec 2002) Removed Integration section to NESiGate Software Installation Guide
08 (Jun 2005) Added Software RAID configuration to install
09 (Aug 2005) Updated for release 2.7.2
09 (Jan 2006) Updated for release 2.7.4
10 (Jan 2006) Updated for release 2.7.5
11 (Feb 2006) Updated for release 2.7.6
12 (Oct 2006) Updated for release 2.8
13 (Dec 2006) Updated for release 2.8.1
14 (Feb 2007) Updated for release 2.8.2
© 2000-2006 Network Executive Software, Inc. Reproduction is prohibited without prior permission of
Network Executive Software. Printed in the USA. All rights reserved.
The U.S. Department of Commerce restricts the distribution of technical information contained in this
document when exported outside the U.S. Therefore, careful attention should be given to compliance
with all applicable U.S. Export Laws if any part of this document is to be exported.

MAN-REF-CASW Table of Contents Page iii
Table of Contents
Revision Record.....................................................................................................................................ii
Copyrights and Trademarks ...................................................................................................................v
Notice to the Customer..........................................................................................................................vi
NESiGate Modification Policy..........................................................................................................vi
Introduction..............................................................................................................................................1
Customization...........................................................................................................................................3
Overview................................................................................................................................................3
Configure NESiGate...............................................................................................................................3
Device Number ..................................................................................................................................3
GNA Address.....................................................................................................................................4
IP Address..........................................................................................................................................4
Using a Web Browser to Configure NESiGate......................................................................................4
Define the Channel Boards(s) ............................................................................................................4
Define the Devices.............................................................................................................................4
Add Routes (optional)........................................................................................................................5
Define IP Interface.............................................................................................................................5
Reboot NESiGate...............................................................................................................................5
Web Browser Interface............................................................................................................................7
Overview................................................................................................................................................7
Browser Considerations .....................................................................................................................7
Browser Considerations .....................................................................................................................7
Initial Screen ......................................................................................................................................7
System, Product, SNMP & Network Configuration ..........................................................................8
NESiGate Board/Channel Commands ...............................................................................................9
Display Board Config.....................................................................................................................9
Channel Define Board and Channel Undefine Board ....................................................................9
Channel Command drop-down menu...........................................................................................10
Channel Display Interface Config................................................................................................10
Channel Display ESCON Config.................................................................................................11
Channel Display Info....................................................................................................................11

Page iv MAN-REF-CASW
Channel Display Stats ..................................................................................................................12
Channel Clear Stats......................................................................................................................13
Channel Start Interface.................................................................................................................13
Channel Stop Interface.................................................................................................................13
Channel Undefine Interface..........................................................................................................13
Channel Define Interface..............................................................................................................14
Channel Set Debug.......................................................................................................................15
NESiGate Router Commands...........................................................................................................16
Command drop-down menu.........................................................................................................16
Route Display Config...................................................................................................................16
Route Display Info .......................................................................................................................16
Route Display Locals ...................................................................................................................16
Route Display Routes...................................................................................................................17
Route Display Stats......................................................................................................................17
Route Clear Stats..........................................................................................................................17
Route Set Debug...........................................................................................................................18
Help Debug ..................................................................................................................................18
Route Add Route..........................................................................................................................18
Route Delete Route ......................................................................................................................19
Route Delete All Routes...............................................................................................................19
NESiGate IP Interface Commands...................................................................................................20
Command drop-down menu.........................................................................................................20
IP Interface Display Config..........................................................................................................20
IP Interface Display Info..............................................................................................................21
IP Interface Display Stats.............................................................................................................22
IP Interface Clear Stats.................................................................................................................23
HELP Debug................................................................................................................................23
IP Interface Set Debug .................................................................................................................23
IP Interface Define Interface........................................................................................................24
Appendix A: Configuration Worksheet ...............................................................................................25
Appendix B: NESiGate Sense Bytes .....................................................................................................27

MAN-REF-CASW Page v
Copyrights and Trademarks
This document contains references to the trademarks of the following corporations.
Corporation Trademarks
International Business Machines ESCON®
Netscape Communications Corp. Netscape®
Unisys Corporation SBCON
Additional trademark references:
Linus Torvalds Linux®

Page vi MAN-REF-CASW
Notice to the Customer
Comments about this manual may be submitted via mailto:[email protected] or by visiting our website:
http://www.netex.com
Always include the complete title of the document with your comments.
Information on Network Executive Software’s general software support policy (e.g., alternate contact
methods, support severity level descriptions, and service status definitions) may be found at
http://www.netex.com/services/supportpolicy.html.
Details on Network Executive Software’s warranty and support policies specific to NESiGate may be
found at http://www.netex.com/services/warrantyNG.html.
NESiGate Modification Policy
NESiGate is an appliance that contains proprietary software and firmware. Modifications to the soft-
ware, firmware, or hardware platform that are not specifically authorized by NESi are prohibited.
Examples of prohibited activities include (but are not limited to) the following items:
•Installing other software on NESiGate
•Modifying the file system (including adding, deleting, or moving files and/or directories, or
changing permission levels, ownership, or other attributes of files and/or directories)
•Adding or deleting user accounts
•Starting or stopping system services
•Adding or removing hardware components
Any unauthorized modifications to NESiGate may affect its operation and/or obstruct NESi’s ability to
diagnose problems and provide corrections. Any work resulting from unauthorized modifications shall
be paid by the customer at NESi’s then-current support rates and may result in the immediate termina-
tion of warranty/support coverage.

MAN-REF-CASW Page 1
This manual provides an overview of the procedures used to integrate and customize the NetEx/IP com-
ponents onto a NESiGate-CA host channel platform, and to provide a description of the command and
web browser interfaces.
This manual is divided into four sections:
1) Integration: Integration of NESiGate software on the hardware platform is covered in the NESi-
Gate Software Installation Guide. Refer to that guide, then return to this manual to complete the
configuration of NESiGate as an Channel Adapter (CA) type device
2) Customization: this section is targeted to the end-user who is responsible for customizing NESi-
Gate for use as a host-based NetEx/IP channel device. It is assumed the NESiGate already has the
appropriate NESiGate-OS installed. To complete the customization, the reader must be familiar
with channel device and network addressing concepts.
3) Web Browser Interface: this section is targeted to the end-user who is responsible for customizing
the NESiGate for use as a host-based NetEx/IP channel device, and who is responsible for configur-
ing and controlling operational aspects of the device.
Introduction

Page 2Introduction MAN-REF-CASW

MAN-REF-CASW Customization Page 3
Overview
This section provides an overview of the procedures used to complete the customization of the NESi-
Gate-CA for use with Host-Based NetEx/IP products. This section is targeted to the end-user responsi-
ble for customization. The reader must be familiar with channel device and network addressing con-
cepts.
Configure NESiGate
There are three important addressing elements involved in delivering NetEx/IP channel data that is not
IP-aware, and transferring it over an IP network to the correct destination:
• Device Number
• GNA Address
• IP Address
Device Number
The Device Number on the host and Device Index on the NESiGate channel board are numeric repre-
sentations of the same unique "device". On the Host operating system, a "Device Number" is defined as
a Unit Address on a Logical Control Unit (a physical control unit may consist of from 1-16 logical con-
trol units). The Physical Control Unit may be connected to a Port on an ESCON Director. Multiple
inbound Host channels may be connected to the ESCON Director and provide connectivity to the device
from multiple partitions (LPARs) across multiple hosts.
Similarly, on the NESiGate ESCON board, a "Device Index" is defined as a Unit Address on a Logical
Control Unit (up to 16 may exist). The Physical Control Unit may be connected to a Port on an ESCON
Director, which may provide connectivity to multiple LPARs across multiple hosts.
Since both the Device Number and Device Index represent the same unique device (from different per-
spectives), the same addressing components must be specified exactly the same in both definitions.
Failure to do so will prevent the NESiGate devices from functioning properly.
When defining devices on the ESCON channel board, the following items are specified: Device Unit
Address, Logical Control Unit, the Director port to which the host channel is connected, and Partition-id
(LPAR). The Device Index values are not specified by the user. They are automatically generated
when the channel configuration is defined.
A maximum of 64 devices are supported on each ESCON interface.
Refer to the “Channel Define Interface” button on page 66614 for a description of defining the channel de-
vices.
Customization

Page 4Customization MAN-REF-CASW
GNA Address
The GNA address represents a NetEx/IP network address that is associated with a given device. It is
specified in the NetEx/IP Network Configuration Table (NCT). It is also specified during the customi-
zation of the NESiGate Channel Driver. At that time, an association is established between a particular
GNA address and a Device Index.
IP Address
The IP address represents a NetEx/IP network node address. There is no channel device awareness in-
herent in an IP address. However, during the NESiGate customization task, IP host names are defined,
each having a format based on its GNA address. This enables NESiGate to perform a direct mapping
between GNA and IP addresses. This mapping is transparent to the NetEx/IP running on the host, as
well as to all NetEx/IP applications.
Using a Web Browser to Configure NESiGate
The NESiGate Web Browser Interface may be used to configure NESiGate. Before configuring the
NG-CA specific items, the common System and Network configuration should be completed. See the
“Installation Guide” (NG-SW) manual for details.
Refer to the "Web Browser Interface" section on page 7 for a complete description of the commands
used in this section.
Define the Channel Boards(s)
The channel board(s) are automatically configured by the NESiGate initialization software. Normally,
no re-configuration of the board config is required.
Define the Devices
This step is required. If this step is not performed, the ESCON devices will respond as the correct de-
vice without regard to LPAR or ESCON director port affinity. If this does not match the real configura-
tion, incorrect results will occur.
Select the Board/Channel link in the navigation menu. This will open the page that is titled: NESiGate
CA Board/Channel.
Using the device configuration data from a completed worksheet provided in “Appendix A: Configura-
tion Worksheet” on page 25, use the "Channel Define Interface" button to define the devices. Refer to
page 14 for a description of this command.
Repeat this step as many times as necessary until all required channel interfaces are defined.

MAN-REF-CASW Customization Page 5
Add Routes (optional)
This step is only necessary if static GNA routes are to be defined, and have NOT been configured using
the System page “GNA-host Mapping” command. If static GNA routes are not defined, NESiGate will
use DNS services to resolve GNA to IP addressing.
Select the Router link in the navigation menu. This will open the page that is titled: NESiGate Router.
Using the device configuration data from a completed worksheet provided in “Appendix A: Configura-
tion Worksheet” on page 25, use the "Route Add Route" button to define the routes. Refer to page 18
for a description of this command.
Repeat this step as many times as necessary until all required routes are defined.
Define IP Interface
This step is only necessary if default IP parameters are to be modified. It is rarely needed.
Select the IP Interface link in the navigation menu. This will open the page that is titled: NESiGate
IP Interface.
Use the "IP Interface Define Interface" button to define the IP interface parameters. Refer to page 24
for a description of this command.
Reboot NESiGate
After the configuration changes have been made, the NESiGate unit must be rebooted to make the
changes effective:
•Vary the devices offline to the host operating system.
•Browse to the “System Config” page of the NESiGate
•In the “Misc Commands” menu, select “REBOOT with NG on”
•Click the “DoIt” button
•After NESiGate is back up vary the devices online to the host operating system.

Page 6Customization MAN-REF-CASW

MAN-REF-CASW Web Browser Interface Page 7
Overview
The Apache web server is used on NESiGate to provide a web-enabled configuration facility. Connect-
ing NESiGate to an intranet infrastructure enables usage of a web browser to configure the Channel,
Router, IP, and Control components. The browser can also be used to display configuration informa-
tion, and control various operational aspects of the components.
Browser Considerations
The browser can be hosted on any system, as long as that system has connectivity to NESiGate. How-
ever, the browser must be configured to refresh pages on each page reference.
Browser Considerations
The browser can be hosted on any system, as long as that system has connectivity to NESiGate. How-
ever, the browser must be configured to refresh pages on each page reference.
Initial Screen
When the browser first connects to NESiGate, a password entry window will be displayed. Enter the
ngadmin userid you have been assigned and its password to gain access to the NesiGate. Default user-
ids and passwords are described in the common NESiGate Installation Manual.
The initial screen displayed when the password has been accepted includes a “Welcome” screen with
general information on the right and a dropdown navigation list of the available command frames and
HELP links on the left.
Web Browser Interface

Page 8Web Browser Interface MAN-REF-CASW
System, Product, SNMP & Network Configuration
The navigation links will bring you to the area for re-configuring and displaying common information.
Refer to the NESiGate Installation Manual for a description of these commands.

MAN-REF-CASW Web Browser Interface Page 9
NESiGate Board/Channel Commands
Display Board Config
This button displays the channel boards that have been previously defined.
Prior to selecting this button, provide the following data on the selection screen:
Board Name the name of the board to display.
If no name is specified in the Board Name window, then all defined channel boards are displayed.
Channel Define Board and Channel Undefine Board
This button deletes or adds the specified channel board from the configuration.
Prior to selecting this button, provide the following data on the selection screen:
Board Name a 1-8 character name by which the board will be identified in subse-
quent define and display commands.
For ‘Define Board’ the following additional information is needed:
Channel Type select either ESCON/SBCON, or
If the board is a Bus&Tag interface, select DCI, 3.0 MB, or 4.5 MB,
depending on the speed of the channel to which the board is connected.
PCI Bus PCI bus number on which the ESCON board is installed.
PCI Device PCI device in which the ESCON board is installed.
The PCI Bus and Device numbers are dynamically determined and the channel boards are automatically
defined. The Bus and Device numbers can be viewed by selecting the “Display Board Config” button.

Page 10 Web Browser Interface MAN-REF-CASW
Channel Command drop-down menu
From this drop-down menu, the following commands can be initiated -
•Channel Display Interface Config
•Channel Display ESCON Config
•Channel Display Info
•Channel Display Stats
•Channel Clear Stats
•Channel Start Interface
•Channel Stop Interface
•Channel Undefine Interface
After selecting the desired command and entering the necessary parameters, click the GO button to pro-
cess. Results of the command will be returned to the browser for display.
Channel Display Interface Config
This command displays the current channel configuration. Prior to selecting this button, provide the
following data on the selection screen:
IFname the name of the channel interface to display.
If IFname is not specified, all defined channel interfaces are displayed.

MAN-REF-CASW Web Browser Interface Page 11
Channel Display ESCON Config
This command shows the currently defined and currently loaded ESCON subchannel ranges and their
index values, as illustrated in Figure 1.
Prior to selecting this button, provide the following data on the selection screen:
IFname the name of the channel interface to display.
If IFname is not specified, all defined channel interfaces are displayed.
NESIGate Channel Display Escon Config
Current Loadable (/etc/nesigate/conf/chlescon.cfg)
;ESCON configuration
;indexNN=subchannel,emulation,controlunit,channellink,lpar,tag
slot=196609
index1=0,HCM,1,ef,0,nesiweb
index2=1,HCM,1,ef,0,nesiweb
index3=2,HCM,1,ef,0,nesiweb
index4=3,HCM,1,ef,0,nesiweb
index5=4,HCM,1,ef,0,nesiweb
index6=5,HCM,1,ef,0,nesiweb
index7=6,HCM,1,ef,0,nesiweb
index8=7,HCM,1,ef,0,nesiweb
Figure 1. Output from ‘Display ESCON Config’
Channel Display Info
This command displays detailed channel interface information. 8Prior to selecting this button, provide
the following data on the selection screen:
IFname the name of the channel interface to display. If not specified, all defined chan-
nel interfaces are displayed.
Device# limit the display of the channel interface to a particular device. For an ESCON
channel interface running in “configured” mode, this parameter is the Device
Index. For an ESCON channel interface running in “non-configured” mode, or
for a Bus & Tag channel interface, this parameter is an offset from the UADD
specification. If the UADD parameter is not used, this parameter is an offset
from the low-order byte of the startGNA address.

Page 12 Web Browser Interface MAN-REF-CASW
Channel Display Stats
This command displays statistics for a particular channel interface. Prior to selecting this button, pro-
vide the following data on the selection screen:
IFname the name of the channel interface to display. If not specified, all defined chan-
nel interfaces are displayed.
Device# limit the display of the channel statistics to a particular device. For an ESCON
channel interface running in “configured” mode, this parameter is the Device
Index. For an ESCON channel interface running in “non-configured” mode, or
for a Bus & Tag channel interface, this parameter is an offset from the UADD
specification. If the UADD parameter is not used, this parameter is an offset
from the low-order byte of the startGNA address.
Example: specific interface
id txpacks txbytes rxpacks rxbytes
-------- -------- ------------ -------- ------------
2 0 0 0 0
txMiscEr rxMiscEr haltIO streamTo sysReset cmdRej intvReq
-------- -------- -------- -------- -------- -------- --------
0 0 0 0 0 0 0
busOutCk equipCk dataCk overRun delayTx delayRx dataTo
-------- -------- -------- -------- -------- -------- --------
0 0 0 0 0 0 0
where -
id : id for display only – minor number
txpacks : # messages sent to the channel
txbytes : # data bytes sent to the channel
rxpacks : # messages read from the channel
rxbytes : # data bytes read from the channel
txMiscEr : # transmit to the channel errors
rxMiscEr : # receive from the channel errors
haltIO : halt I/O count
streamTo : I/O streaming timeout count
sysReset : system reset count
cmdRej : command reject count
intvReq : intervention required count
busOutCk : bus out check count
equipCk : equipment check count
dataCk : data check count
overRun : overrun count
delayTx : # stream delayed messages destined for the channel
delayRx : # stream delayed messages coming from the channel
dataTo : data timeout count

MAN-REF-CASW Web Browser Interface Page 13
Channel Clear Stats
This command clears all or selected channel statistics. Prior to selecting this button, provide the follow-
ing data on the selection screen:
IFname - specify the name of the channel interface to clear.
Device# - limit the clear of the channel interface to a particular device. For an ESCON
channel interface running in “configured” mode, this parameter is the Device
Index. For an ESCON channel interface running in “non-configured” mode, or
for a Bus & Tag channel interface, this parameter is an offset from the UADD
specification. If the UADD parameter is not used, this parameter is an offset
from the low-order byte of the startGNA address.
Channel Start Interface
This command starts a defined channel interface. Prior to selecting this button, provide the following
data on the selection screen:
IFname the name of the channel interface to start.
Channel Stop Interface
This command stops a defined channel interface. Prior to selecting this button, provide the following
data on the selection screen:
IFname the name of the channel interface to stop.
Channel Undefine Interface
This command removes a defined channel interface.
Prior to selecting this button, provide the following data on the selection screen:
IFname the name of the channel interface to stop.

Page 14 Web Browser Interface MAN-REF-CASW
Channel Define Interface
This button defines a channel interface, which consists of a range of devices for use by a particular
NetEx/IP.
⇒Note: a channel board must be defined first before defining any channel interfaces.
Prior to selecting this button, provide the following data on the selection screen:
IFname a name by which the interface will be identified.
Prot the channel protocol version.
HCM is the traditional HYPERchannel mode message/data format.
HCM2 is a single-CCW protocol which is more efficient for small
channel transfer applications. The host NetEx must support this (cur-
rently only supported in H210IP 6.1 and later).
On board the name of the board on which this interface is being defined. Auto-
Define uses ‘board1’ and ‘board2’
StartGna the GNA address of the first device in the form 'UUSS', where 'UU' is
the NETADDR for this ADAPTER definition in the NCT. ‘SS’ must
be the same as the first device address lower byte. The SMGDREF
definition for this ADAPTER definition in the NCT must be in the
range 'SS' to 'SS' + Number of devices.
Number of devices the number of devices being defined for this interface (4 is normally
sufficient). The maximum number of devices that can be defined per
interface definition is 16.
Input (optional) the low-order byte of the input device.
UADD the unit address of the device.
Max Data - (optional) the memory allocation size used by the Channel driver to
buffer data coming off or going on the channel. This value must be at
least as large as the NetEx/IP segsize parameter. The default is 65535
bytes.
For ESCON devices only -
CU - the control unit number. Up to sixteen control units can be specified,
ranging from 0-F. A unique Control Unit should be defined for each
concurrent host, or host partition, running NetEx/IP. Note: CU 0 must
be used if connection is to a Unisys system.
CHlink - the ESCON director port number to which the channel is connected that
is used for communicating to the ESCON board. If the ESCON inter-
face is connected directly to the channel without going through an ES-