background image

MAN-REF-CASW Customization 

Page 

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 

666

14 for a description of defining the channel de-

vices.  

 

Customization

Summary of Contents for NESiGate-CA

Page 1: ...MAN REF CASW NESiGate CA NetEx IP Host Channel to IP Gateway Release 2 8 2 Reference Manual...

Page 2: ...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 fo...

Page 3: ...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 Consider...

Page 4: ...splay 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 Int...

Page 5: ...ocument contains references to the trademarks of the following corporations Corporation Trademarks International Business Machines ESCON Netscape Communications Corp Netscape Unisys Corporation SBCON...

Page 6: ...tary 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 no...

Page 7: ...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...

Page 8: ...Page 2 Introduction MAN REF CASW...

Page 9: ...nels 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...

Page 10: ...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...

Page 11: ...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...

Page 12: ...Page 6 Customization MAN REF CASW...

Page 13: ...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 re...

Page 14: ...N 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...

Page 15: ...ng 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...

Page 16: ...terface 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...

Page 17: ...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 Thi...

Page 18: ...w 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 da...

Page 19: ...rom 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 i...

Page 20: ...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 defi...

Page 21: ...the host system s device configuration Failure to do so will make the devices unusable The total number of devices supported on each ESCON interface board is 64 Use this selection button multiple tim...

Page 22: ...lecting the desired command click the GO button to process Results of the command will be returned to the browser for display Route Display Config This command displays the current configured routes R...

Page 23: ...the lower stream txbytes the number of bytes sent from the router to the lower stream rxmsgs the number of messages received from a lower stream rxbytes the number of bytes received from a lower strea...

Page 24: ...for the Router control stream L_INDEX set Router debug level for the stream linked under the Router at L_INDEX L_INDEX can be obtained by first displaying the channel configuration Help Debug This bu...

Page 25: ...tarted Chg file perm select this box to make a permanent change Route Delete All Routes This button deletes all defined routes Prior to selecting this button provide the following data on the selectio...

Page 26: ...the browser for display IP Interface Display Config This command displays the current IP configuration type prot minor l_index ref optfl lport mxrcvbyt mxsndbyt MSG UDP 2 4 c2a4ba20 0 6950 512000 5120...

Page 27: ...n currently unused db stream debug level prot protocol currently only UDP supported fl stream flags 0x80 read queue is being serviced 0x40 write queue is being serviced 0x20 control stream backlog cur...

Page 28: ...evel mt memory trace on or off fl connection flags 0x80 hc connection 0x08 no checksum socket option 0x04 debug socket option retId current retry timeout id hcCon address of special hc connection cont...

Page 29: ...tream delayed messages destined for IP rxdelay stream delayed messages coming from IP outDrop dropped messages destined for IP inDrop dropped messages coming from IP IP Interface Clear Stats This comm...

Page 30: ...the local port number normally set to 6950 checksum select this box to enable the checksum of IP packets Max Receive the maximum receive buffer size normally set to 512000 Max Send the maximum send b...

Page 31: ...ce information Used for OS Definitions Example Site Configuration Device number or name 5200 Number of devices 4 Director port device director port F3 Control unit number or name 1 Unit address 0 LPAR...

Page 32: ...or NESiGate Static Routes defini tions Note 1 Example Site Configuration StartGNA remote GNA address DC00 IP Addr 10 1 2 15 Num number of consecutive addresses 4 repeat for all remote GNA addresses NE...

Page 33: ...se bytes that are returned from the NESiGate channel interface board Sense Bytes 0 8 31 X 80 Command Reject X 10 Equipment Check X 80 Data Timeout X 10 Waitmsg Timeout X 2A Data Timeout X 2B Waitmsg T...

Page 34: ...Page 28 Appendix B MAN REF CASW...

Reviews: