background image

Introduction

 

The purpose of this manual is to provide an overview of the procedures used to integrate and customize 
the NetEx/IP components onto a NESiGate channel offload platform, and to provide a description of the 
command and web browser interfaces. 

This manual is divided into the following sections: 

1)

 

Software Installation:

 Installation of NESiGate software on the hardware platform is covered in 

the NESiGate Common Reference Manual.  Refer to that guide, then return to this manual to com-
plete the configuration of NESiGate as a Channel Offload (CO) type device 

2)

 

Customization:

 this section is targeted to the end-user who is responsible for customizing the NE-

SiGate appliance for use as a NetEx/IP channel offload device.  It is assumed the NESiGate already 
has the appropriate level of the system software installed.  To complete the customization, the read-
er 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 appliance for use as a NetEx/IP channel offload device, and who is responsible for 
configuring and controlling operational aspects of the device. 

MAN-REF-COSW 2.10-19 

Introduction 

Page 

Summary of Contents for NESiGate-CO

Page 1: ...NESiGate CO NetEx IP Offload Channel to IP Gateway Release 2 10 Reference Manual MAN REF COSW 2 10 19 ...

Page 2: ...llation 10 Aug 2005 Updated for release 2 7 2 11 Jan 2006 Updated for release 2 7 4 12 Jan 2006 Updated for release 2 7 5 13 Feb 2006 Updated for release 2 7 6 14 Oct 2006 Updated for release 2 8 15 Nov 2006 Updated for release 2 8 1 16 Feb 2007 Updated for release 2 8 2 17 Apr 2007 Updated for release 2 8 3 Major command security redefinitions 18 Feb 2008 Updated for release 2 9 1 19 Feb 2010 Upd...

Page 3: ...gure NESiGate 5 Define the Channel Boards s 5 Define the Devices 5 Configure NetEx IP 5 GNA to IP Mapping 6 Reboot NESiGate 7 Web Browser Interface 9 Overview 9 Browser Considerations 9 Initial Screen 9 Common Command Frame 9 Common Webpage Navigation 9 NESiGate Board Channel Commands 10 Show Channel Config 12 Show Channel Info 13 Channel Display Stats 13 Channel Define Interface 15 Remove Channel...

Page 4: ...t Parameters 21 Appendix C NetEx IP Messages 29 Viewing NetEx IP Messages 29 Using the Web Browser Interface 29 Using the Command Line Interface 29 Messages 30 Appendix D NRB Status Error Codes 37 General Errors 37 Session Errors 38 Appendix E NESiGate Sense Bytes 41 NESiGate ESCON 41 Page iv MAN REF COSW 2 10 19 ...

Page 5: ...iness Machines ESCON Unisys Corporation SBCON Red Hat Inc RedHat Note RedHat is a registered trademark of Red Hat Inc This product is not a product of Red Hat Inc and is not endorsed by Red Hat Inc This is a product of Network Executive Software and we have no relationship with Red Hat Inc Additional trademark references MAN REF COSW 2 10 19 Page v ...

Page 6: ...are 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 through means other than NESiGate s defined User Interfaces in cluding adding deleting or moving files and or directories adding or deleting user accounts or changing permission ...

Page 7: ...MAN REF COSW 2 10 19 Page vii ...

Page 8: ...on of NESiGate as a Channel Offload CO type device 2 Customization this section is targeted to the end user who is responsible for customizing the NE SiGate appliance for use as a NetEx IP channel offload device It is assumed the NESiGate already has the appropriate level of the system software installed To complete the customization the read er must be familiar with channel device and network add...

Page 9: ...Page 2 Introduction MAN REF COSW 2 10 19 ...

Page 10: ...ior to performing the Device and IP customization tasks it would be beneficial to review NESiGate device and network addressing concepts 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 ...

Page 11: ...e Interface button on page 15 for a description of defining the channel de vices Conflicts and illogical configurations may be accepted as input to the web or CLI however that does NOT mean they will work i e overlapping subchannel addresses incorrect CUs etc The channel configuration in the NESiGate must match the gen ed configuration in the host GNA Address The GNA address represents a NetEx IP ...

Page 12: ...tion incorrect results will occur Select the Board Channel link located on the navigation menu This will open the page that is titled NESiGate CO Board Channel Using the device configuration data from a completed worksheet provided in Appendix A Configura tion Worksheet on page 19 use the Channel Define Interface button to define the devices Refer to page 17 for a description of this command Repea...

Page 13: ...e 21 for a description of the parameters contained in ntx_default Two parameters MUST be changed in order to make Netex functional local and device1 for your site and one may be changed in order to improve performance on some networks segsize See Modify NetEx Startup Parms on page 18 for details GNA to IP Mapping NetEx IP Offload performs dynamic mapping of GNA addresses to IP addresses Dynamic ma...

Page 14: ... effective Vary the devices offline to the host operating system Navigate to the System Config webpage of the NESiGate In the Misc Command drop down menu select REBOOT Click the Misc Commands button After NESiGate is back up vary the devices online to the host operating system MAN REF COSW 2 10 19 Customization Page 7 ...

Page 15: ...Page 8 Customization MAN REF COSW 2 10 19 ...

Page 16: ...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 Common Command Frame In the top left frame is a dropdown navigation list of the available command pages and some common display command...

Page 17: ...rd Webpage The following are general definitions of components on this page IFname name given to a channel interface for displays other commands board name of the channel board on which this interface is being defined UADD OS gened Unit Address StartGNA first HCM network address UUSS UU matches NCT netaddr smgdref is within SS SS num devices Number of devices number of GNA addresses subchannels fo...

Page 18: ...Address must be 0 for Unisys CHlink escon only Escon director host side port or for direct connect 1 IBM 2 Unisys old SBCON 77 Unisys SCIOP SIOP SBCON LPAR escon only Logical Partition IBM MAN REF COSW 2 10 19 Web Browser Interface Page 11 ...

Page 19: ...5e00 board1 MSG HCM 00005e00 4 0 1 1 65535 0 1 1 30 0 65535 Boards Config File Auto configured on 2010Jun03 150841 board1 pcibus 2 pcidev 1 escon cfgd Interface Config File channel config file created 2010 May 11 at 09 08 14 if5e00 board board1 type MSG prot HCM sgna 5E00 num 4 in 00 mxdt 65535 bfsz 65535 uadd 0 cu 1 chlink E6 lpar 1 sdevinx 1 Escon Config File ESCON configuration created on 2010 ...

Page 20: ...e prot startGna Su sUnt sdi TxMsgs RxMsgs if5e00 1 STARTED 0 MSG HCM 00005e00 4 1 1 0 0 id sub unit devi initStat accWSize currWMsg if5e00 1 0 1 1 0 0 0 Figure 3 Output from Show Channel Config Channel Display Stats This displays statistics for a particular channel interface Prior to selecting this button provide the fol lowing data on the selection screen IFname The name of the channel interface ...

Page 21: ...scEr 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 st...

Page 22: ...N director port number to which the channel is connected that is used for communicating to the ESCON board If the ESCON interface is connected directly to the channel without going through an ESCON Director a port num ber of 1 or 01 should be specified if connection is to an IBM or Hitachi IBM compatible system a port number of 2 or 02 should be specified if connection is to a Unisys system If the...

Page 23: ...efine more than 64 devices to satisfy specific configuration requirements e g extra devices that are only used when needed on backup systems but care must be taken so that no more than 64 devices are active at any point in time Over configuring the ESCON interfaces with many devices being used concurrently will have a negative impact on performance Remove Channel Interface This removes a defined c...

Page 24: ...cified showNtx showNCT or showPAM command Display the current Netex log file the loaded NCT or PAM file Netex Show Detailed Commands Display all or specific host session transport or network buildPam Build a PAM for the specified host the host must match the local host in the Netex Default file Set Netex Parm MAN REF COSW 2 10 19 Web Browser Interface Page 17 ...

Page 25: ...ter the desired value in the window next to it select configure default value in the second dropdown and click defaultcmd All the initial values can be restored by selecting reset all defaults and clicking on the defaultcmd button Local Host must agree with the hostname used for buildPAM Local GNA device 1 must agree with the netaddr smgdref of the local ADAPTER in the NCT Segment Size may be adju...

Page 26: ...m 3rd Fl SNMP SysContact ownet myworld com SNMP Community netexsw SNMP Trap Server 10 1 2 75 DNS Server 10 1 3 1 DNS Domain myworld com DNS Search myworld com IP Network Information Network Configuration Example Site Configuration IP address data netmask 11 1 2 27 255 255 255 0 IP address management 10 1 2 27 255 255 255 0 Default gateway 10 1 2 50 IP address of name server 10 1 3 1 Static Routes ...

Page 27: ...l board Information Used for NESiGate board definitions Example Site Configuration Board name Board1 NESiGate Channel Information Used for NESiGate device definition Example Site Configuration IFname IBM5200 Type must be emsg EMSG Board name of channel board Board1 UADD unit address 0 StartGNA starting GNA address EA00 Number of devices 14 Input device n a for NG CO 0 Max Data 65535 For ESCON devi...

Page 28: ...these errors are normal but normally occur only once every few hours ALL this value logs all adapter and com munication errors mbxname not changable This is the name of the pipe used to move NRB and DATA requests from user space into NetEx IP space pamfile not changable This is the name of the PAM file NetEx IP uses to load the initial NCT This name should match the name specified in the Con figur...

Page 29: ... CONNECT TIMEOUT datato 300 This is the initial value for DATA TIMEOUT In a heavily loaded system or during transfer to tape this value should be increased to about 1000 deadto 60 This is the initial value for DEAD TIMEOUT debugreq 0 This parameter enables or disables the tracing of user requests arriving at the NetEx IP pro tocol stack A value of 0 turns tracing off any other value turns tracing ...

Page 30: ...to be increased if many very small transfers are needed highresmsecs 10 This is the value of the internal high resolu tion timer It is used for internal rate throt tling and should not be changed idleto 6 This is the initial value for IDLE TIME In networks with many errors or contention it may help to drop this value to 2 or 3 maxblkin 65400 This is the maximum NRBBLKIN value in bytes maxblkout 65...

Page 31: ... recorded in the ntxlog file multihost ON When set ON allows Netex to distinguish between SOFFERs of the same application name from multiple locally attached hosts LAN or channel Set to OFF if there is only one attached host or if all SOFFERs will have unique names numlogs 5 This value defines the maximum number of ntxlog files that are saved by the swlog command prefprot 2 Defines the default pre...

Page 32: ...rate value specified in the PAM or NRB This value is specified in Kbits per second For example a value of 50 means 50Kbs a value of 50000 means 50Mbs i e 50 000 Kbs ratedelaydecp 250 25 0 This is the percentage factor used to decrease the sending rate of a network connection if the round trip delay increases This recalculation is performed after the expiration of each in terval specified by the rt...

Page 33: ...reduced to the value specified by rcvdataqlbytes rcvdataqlbytes 3000000 This is the low threshold value in bytes for the size of the receiving NetEx DataQue for each network connection See the rcvda taqhbytes parameter for the description of how this value is used rtdelayincsecs 60 This is the interval in seconds used by the sending side of a network connection after which a check is made for an i...

Page 34: ...percentage factor used to calculate the initial send rate of each network connec tion This value is applied against the maxi mum rate for the connection as specified in the PAM NRB or by the defstartkbitsper sec parameter During the course of the con nection the actual send rate may be adjusted based on network activity The value speci fied represents a percentage multiplied by a factor of 10 Resu...

Page 35: ... This is the name of a second NetEx IP device and is only used if there is a second NIC card device3 This is the name of a third NetEx IP device and is only used if there is a third NIC card device4 This is the name of fourth NetEx IP device and is only used if there is a fourth NIC card ...

Page 36: ...select the ShowNtxLog command The recording of NetEx IP session messages in the ntxlog file requires the msglvl parameter to be set to important or less This can be set by issuing the following command after NetEx IP is initialized set msglvl important This command should be entered following the procedures in the Modify NetEx Startup Parms sec tion on page 18 After this command is issued select t...

Page 37: ... by the application User Response None ISCONN nref n uname connecting to pname at hname path from aa to bb Description A CONNECT has been issued by the NetEx IP application that is running under the user name uname n identifies the internal NetEx IP session reference number uname identifies the user name under which the NetEx IP application is running pname identifies the NetEx IP name of the remo...

Page 38: ...hich the OFFER occurred local host User Response None ISCLOS nref n uname closing Description A CLOSE has been issued by the NetEx IP application that is running under the user name uname n identifies the internal NetEx IP session reference number of the local application uname identifies the user name under which the NetEx IP application is running User Response None ISDISC nref n uname disconnec...

Page 39: ...rror Codes on page 37 for a description of the possible status codes i identifies the status of the connection 6 session is disconnected User Response None NEXTPAM nref n new path from aa to bb Description An APR alternate path retry operation has occurred for the indicated session connection n identifies the internal NetEx IP session reference number aa identifies the local unit portion of the ne...

Page 40: ...y received We received a new one part message instead 10 Received the second part of a two part message prior to receiving the first part 11 Awaiting the second part of a two part message after the first part was already received We received the first part of a different two part message instead 12 Two part message error no P data or O data 13 Invalid network unique id 14 Bad status creating TUB N...

Page 41: ...d x too small y type size 9 sub field x length y overlaps total transport length z type size length 10 New path has smaller segsize User Response None Netex reports the invalid message and continues Message received with no read active Description A Netex message was received on the network but there was no Netex read request ac tive at the time Message is dropped User Response None Netex reports ...

Page 42: ...connecting Description An abort indicator was received by the NESiGate CO application xx yyy identifies the NESiGate CO process User Response None Netex reports the condition and continues chnlMailHandler stream nnnnnnnn xx system reset subch nn Description A system reset was received on the channel xx identifies the NESiGate CO channel interface name nn identifies the NESiGate CO subchannel devic...

Page 43: ...Handler stream nnnnnnnn xx data timeout subch nn Description A data timeout has occurred on the indicated subchannel device Data is discarded and the Netex session is aborted xx identifies the NESiGate CO channel interface name nn identifies the NESiGate CO subchannel device User Response None Netex reports the condition and continues chnlGenAbortInd stream nnnnnnnn xx putnext message nnnnnnnn Des...

Page 44: ...e status of the connection is not affected 0011 A read type operation completed normally within NETEX but the Odata buffer provided by the user was not large enough to hold the data NRBPROTL reflects the amount of data the other party intended to send however the amount of data moved to the user s program was only the amount of addressable units originally specified in NRBPROTL NRBIND specifies th...

Page 45: ... Session Errors The following status codes are Session level errors that are returned in the NRBSTAT field indicating the completion status of a NetEx IP request All errors that result in the loss of the connection and a Disconnect Indication in NRBIND are indicated by an asterisk following the error code number 3005 During a WRITE operation the length of the buffer as specified by NRBLEN exceeds ...

Page 46: ...ype request SWRITE or another SCLOSE has been issued against a connection that has accepted a previous SCLOSE 3402 The remote application has failed to issue an SREAD request for a period of elapsed time READTO specified by the installation systems programmer on the remote host The con nection is terminated A Disconnect Indication will be found in NRBIND 3403 The remote application exited without ...

Page 47: ...ons path exists between the local host and the specified remote host The SCON NECT terminates with a Disconnect Indication in NRBIND 3509 The specified value of NRBBLKO exceeds an installation or implementation defined maxi mum The connection request is rejected 3510 The specified value of NRBBLKI exceeds an installation or implementation defined maxi mum The connection request is rejected 3511 Th...

Page 48: ... X 2B Waitmsg Timeout Table 1 NESiGate ESCON Sense Bytes Subchannel not started error only two byes of sense are returned X 8200 On NESiGate offload CO type boxes connect completion and write completion errors are returned as follows Sense Byte 0 10 11 12 13 14 17 18 21 X 80 Command Reject X 03 X 00 nrbstat nrbind nrbnref Table 2 NESiGate Offload CO Sense Bytes See Appendix D NRB Status Error Code...

Page 49: ...Page 42 Appendix E MAN REF COSW 2 10 19 ...

Reviews: