Eicon Networks CX1 Installationshandbuch

GLINEHOST LINKSTM G&RLine Handlersand Configurationhttp://www.gar.no/hostlinks/

G&R Gline Line Handlers and Configuration 4

G&R Sample dsa.cfg for OSI Transport This sample configuration is meant to cover many of the most used configuration scenarios and will hopefu

G&R Brief description of the configuration For simplicity all GCOS6 hosts are referred to as DPS6s, all GCOS7 hosts as DPS7s and all GCOS8 ho

G&R The configuration files The Host Links node ‘GRDL’ Windows Server \gar\config\dsa.cfg UNIX/Linux /usr/gar/config/dsa.cfg # dsa.cfg: Confi

G&R rsc b8dc -ts dn01_lan ts dn01_lan -class 4 -ns 080038200557 -tp gril_lan # A DPS8 system, B8DF, direct FDDI access to FCP8 rsc b8df -ts

G&R The Host Links node ‘GRIW’ Windows NT/2000 \gar\config\dsa.cfg UNIX /usr/gar/config/dsa.cfg # dsa.cfg: Configuration for G&R Host Lin

G&R TERM -NAME SNM150 -MODE USER -NTD NTDVIP -TYPE DKU7107 -EL 150 TERM -NAME ROP150 -MODE IMPLO -NTD NTDVIP -TYPE TTU8125 -EL 15

G&R * various local SAPs * LCLSAP LXPT18,,X’F8’/X’080038363E18’ LCLSAP LDDS18,,X’14’/X’080038363E18’ LCLSAP LTNV18,,X’28’/X’080038363E18’ LCLS

G&R routes.wdf: # # Local session control for ‘B8DF, channel fe4 (in routes.wdf) # create_node_route_list gril -nrl fe4 loadscen: # # FCP8 M

G&R SC B8DC RMT -ADDR 1:2 -SR CXIA SR B8DC CXI -CH B8DC CH B8DC CXI -CT DIA1 -T1 6000 -T2 2400 -CNX 1000 &*************************

G&R A shared dsa.cfg for all the Host Links nodes In some situations it makes sense to build and maintain one dsa.cfg file for all the Host Li

G&R Overview G&R product architecture The G&R products are built in a modular way, and designed to take advantage of the multitasking

G&R # The Dps8 system (DNET/ROUT and CXI), accessed over X25 in DN01 rsc b8dt -addr 1:1 -ts dn01_wan rsc b8dc -ts dn01_wan # The DN, used

G&R Gline Line Handlers and Configuration 105

G&R Gline Line Handlers and Configuration 106

G&R Appendix: Host Links Manuals Below you find a complete list of all available Host Links manuals: Installation Host Links Installation

G&R Gline Line Handlers and Configuration 108

G&R Appendix: DSA test utilities The Gline package includes a set of Gline communication utilities. These are used when testing and debugging

G&R Gmacfix When connecting to the FCP cards on the Bull mainframes via an Ethernet port on the LAN-Extender the address on the host side is g

G&R Gtrace Same as gping but writes the DSA/DIWS communication trace on the user’s terminal (applicable to UNIX versions) Example: gtrace -li

G&R Gline Line Handlers and Configuration 112

G&R Appendix: Error Codes OSI/DSA error codes Below is a list of OSI/DSA error codes and the corresponding description. These are the same des

Gline Line Handlers and Configuration 6 G&R Architecture diagram Clients for terminal users (V78sim, Qsim, G3270, G5250 Pthru) on UNIX and L

G&R 0013 Open Failure in LC, connection is not negotiated in FD mode / impossible to start the IOF job 0014 Disconnection - Timeout result

G&R 0056 Error or Event on LC initiated by GW. GW has no known explanation. 0057 Error or Event on LC initiated by GW. Reject mailbox perm

G&R 0087 (X.25) Frame level reset. 0090 Frame level not set. 0092 (X.25) X.25 Echo service in use. 0093 (X.25) Incorrect password for

G&R 0117 Incorrect Access Right for MB 0118 Incorrect Access Right for the Application 0119 Pre-negotiated Message Path Descriptor unkno

G&R 015B Negotiation failed on resynchronization (in the Logical Connection record). 015C Negotiation failed on end-to-end ACK (Logical C

G&R 0191 Byte count is greater than GP. 0192 Byte count is greater than GP. 0193 Byte count is greater than GP. 0194 Byte count is gre

G&R 01EA Write segmented letter request without turn. 01EB Send control letter request without turn. 01EC Disconnection request withou

G&R 0323 Intervention required (on principal device). 0324 Request not executable. 0325 EOI required. 0326 Presentation space altered

G&R 0383 Desynchronization in the exchange of data. 0384 KDS block count error. 038C Remote terminal is not connected 0390 Unknown mai

G&R 1741 Open failure on virtual circuit. No flow control on this NS. 1742 Incorrect facility. Protocol error for the equipment directly c

G&R Handler/product relationships Any product using the Gline API to communicate with the line handler can be run using any line handler. This

G&R 17CC Incompatible generations (NR object without mapping). 17CE Invalid status NR locked. 17CF Lack of space. 17D0 Unknown subscri

G&R 1824 Collision between Close NC and Open TC. 182E Remote station not configured. 182F Resource saturation. 1831 ISO: No route for

G&R 2735 WSAEALREADY The asynchronous routine being cancelled has already completed. 2736 WSAENOTSOCK The descriptor is not a socket. 2737 W

Gline Line Handlers and Configuration 127 G&R 2749 WSAENOTCONN The socket is not connected. 274A WSAESHUTDOWN The socket has been shutdown.

G&R The G&R/Ggate product off-loads the DSA session protocol into gateways. By running Ggate on the system(s) with the mainframe connecti

G&R Enclosures and ‘turn’ The interface between a Host Links product and the line handler is global throughout the G&R product range, and

G&R Whereas a simple handler might have no session protocol unit size restriction it might have a transport size restriction, or a network pac

G&R Host Links Trace If you experience any kind of problem when using a Host Links application, the application trace file and/or the line han

G&R All Gline line handlers accept a parameter -s_ to turn on a session trace. It records the raw data being exchanged between the line module

G&R Tracing Ggate When Glink, a Host Links client or a customer application based on GlAPI connects through Ggate to the application, the line

Microsoft, Windows, MS, MS-DOS are registered trademarks of Microsoft Corp. IBM and PC are registered trademarks of IBM Corp. UNIX is a registered

G&R qsm-gli.dbg Qsim host line trace -li dsa -s_ pth-glit.dbg Pthru terminal line trace -term -s_ pth-glih.dbg Pthru -host line trace -li dsa

G&R gspd-gli.def Gspool DPS8 data trace -li tcp -s_ gsp._00 Gspool started on demand debug -dbg gsp-gli._00 Gspool started on demand trace -li

G&R Example: \gar\debug\system debug directory for user "system" cpi-16.dbg CPI-C single session debug -dbg cpi-16.gli CPI-C singl

G&R Line handlers The DSA/DIWS handler You start this handler when you specify -li dsa or -li diws as the line handler for a Host Links produc

G&R • Increased speed since the unneeded level of protocol translation is by-passed • Simpler DNS and/or mainframe configuration, as it’s li

G&R Transport stacks The DSA/DIWS handler interfaces to a transport stack. The transport stack traditionally used by Bull front-ends and mainf

G&R OSI-transport The Host Links product set does not include an OSI-transport stack as a part of the standard delivery. If one is needed it m

G&R Accepting connections Products and applications receiving connections must configure a local node name using the -ln option, causing the l

G&R Listener parameter overview Option value Explanation -prot DSA DIWS Session protocol to be used. Default DSA -dbg Enable data and event

G&R Using the Windows listener For Windows servers the nl_dsa line module server (listener) must be started before any Host Links product can

G&R Contents Installation... 1 Scope of the product ..

G&R Mailbox pools for incoming connects Contrast this functionality with ‘Starting applications on demand’ described below. You can start mult

G&R You can also accept multiple simultaneous incoming connects to GUFT servers with the same Host Links node name and mailbox name. The nl_d

G&R The file above allows an unlimited number of simultaneous connections to mailboxes printer1, printer2 and printer3. For each connection

G&R Two-way-simultaneous sessions do not have a ‘turn’ concept, but the DSA session records indicate the enclosure level specified by the send

G&R The connect command 3 different $*$CN formats can be used: Using a predefined CONAME from dsa.cfg to connect: $*$CN coname If the name g

G&R If you set all connect parameters in the configuration file you can connect from most of the Host Links products using a single key connec

G&R The default configuration for break is: GCOS8 Attention and purge GCOS7 Attention only DNS Attention only For DSA300 applications (CXI a

G&R Transport disconnect ‘Transport disconnect received’ errors after a connection attempt typically mean that you have a physical problem wit

G&R Parameter Description -AW on/OFF Delay initial turn from host (in the session accept) until real data is received on the session. -BRK AT/

G&R Parameter Description -DU xxxxxx -USR -USERID Default userid -DX xxxx -EXT Default application mailbox extension 4 characters. -DEE Delaye

G&R Connection errors... 30 Parameters for DSA/DIWS han

G&R Parameter Description -MN xxxxxxxx -LMB Local mailbox name -MX xxxx Local mailbox extension. -NA xxx yyy zzz Send statistics to Gproxy n

G&R Parameter Description HDS7 TWS2255V 7800 8-bit 72-line ASCII terminal -CS ASCII VIP7700 VIP7760 Early sync text/forms terminals. Repla

G&R DSA and DIWS parameters in detail -LI DSA and -LI DSA:GATEWAY Also -LI DIWS and -LI DIWS:GATEWAY These parameters start the DSA/DIWS line

G&R -BT 1/2/3 This parameter changes the default for the break signal. The default for DSA200 is ‘Attention 1’ (-BT 1), with ‘Attention 2’ (-B

G&R -CO xxxxxx qsim -li dsa -co b8dcacce This parameter sets a symbolic connection name. The line handler parameters are set in dsa.cfg for th

G&R This parameter enables the line handler’s data trace. Data sent and received to the client application is written to a file in the Host Li

G&R -DU, -USR, -USERID xxxxxx qsim -li dsa -du mmluser This parameter defines the default userid for the mainframe. -DX, -EXT xxxx qsim -li d

G&R Making connect parameters fixed value The following parameters stop the user from changing connection parameters that are set in the confi

G&R mode Explanation DPS6 Used when communicating with GCOS6 systems through SNM. DN Host type Datanet. Used when connecting to DNS applicatio

G&R -LT XXXX gspool -li dsa -lt grdw This defines a non-standard local node name for outgoing connections. XXXX must match an SC record in dsa

G&R The dsa.cfg configuration file... 74 Overview...

G&R This enables broadcasting of network administration information to systems running Gproxy. Broadcasts allow multiple, but unspecified, sys

G&R -SX on/OFF qsim -li dsa -sx on This selects Scandinavian transliteration tables for conversion between EBCDIC and ASCII. The -SX parameter

G&R -UD, -UR, -STR, -STRG xxxxxx qsim -li dsa -hm dps8 -ur glid qsim -li dsa -hm dps7 -ur !NEW This defines the default user record for the ma

G&R The TCP/IP handler You start this handler (gl_tcp) when you specify -li tcp as the line handler for a Host Links product. When you connect

G&R Service messages The TCP handler accepts service messages for connect ($*$CN), disconnect ($*$DIS) and break ($*$BRK) from the communicati

G&R The disconnect and break commands All systems accept: $*$DIS force disconnection (normally done by application). $*$BRK interrupt applicat

G&R Parameter Description -HO hostname:port Numeric/symbolic IP-address, optional port -HW n Enable ‘delayed enclosure’. Number of sec/10 to w

G&R -AM XXXXXX This is used to select a mode of operation. The following modes are available: -AM mode Description RAW In this mode all data

G&R TN3270 and TN3270E Gweb, G3270 and Gspool use these modes. In TN3270 mode Gweb, G3270 and Gspool can select LU name. Gspool supports TN327

G&R -DN ipaddress:port v78sim -li tcp -dn 192.150.211.4:9998 This selects the server to which you connect. You can use its numeric IP-address

G&R Appendix: Host Links Manuals... 107 Appendix: DSA test utilities...

G&R -LP local port myglineapp -li tcp -lp 9999 This parameter selects the local port for incoming connections, and enables accept of incoming

G&R -S_ on/OFF Windows Server gspool -id gs1 -ps \\SERVER\LEXMARK -li tcp -am tnvip -s_ on -ho some.gcos.system UNIX Linux gspo

G&R The default value in application mode TN5250 is IBM-3179-2. G5250 -li tcp -tm ibm-3179-2 For TNVIP the terminal types listed in RFC-1921

G&R The X.25 handler You start the X.25 handler (gl_x25) when you specify -li x25 as the line handler for a Host Links product. It is only ava

G&R User applications using one of our communications APIs from the GlAPI library must send the $*$CN, $*$DIS and $*$BRK messages themselves w

G&R Parameters for the X.25 handler The following parameters apply to this handler (defaults in uppercase): Parameter Description -LI X25 Star

G&R Parameter Description -XS nnn/NONE Facility code: Transmit packet length override -XW nnn/NONE Facility code: Transmit window size overrid

G&R The Asynchronous (TTY) handler You start the TTY handler (gl_tty) when you specify -li tty as the line handler for a Host Links product. I

G&R Service messages The TTY handler accepts service messages for connect ($*$CN), disconnect ($*$DIS) and break ($*$BRK) from the communicati

G&R Parameters for the TTY handler The following parameters apply to this handler (defaults in uppercase): Parameter Description -LI TTY Start

G&R Installation The G&R emulations and gateways are independent programs, but part of the G&R Host Links product set available on all

G&R Gline Line Handlers and Configuration 64

G&R DSA Configuration Step-By-Step Guide Configuration check list Before you start to configure the mainframe and Host Links system you must o

G&R The Host Links system • The DSA node name (SCID, session control ID) for the Host Links system If DSA session is to be used for DSA200 co

G&R RSYS NAME = GRDL, PF = ‘STID/ISO/SID3’, RSC = GRDL; RSC NAME = GRDL, ADDR = DSA, SCID = 54:060, SVR=NCC1; Or as follows for a DIWS Host Li

G&R SRISO -RNSAP_NAME NSGRDLI RSCA -NAME GRDL -TYPE D6SC RTSEL -RNSAP_NAME NSGRDLI -T_SEL -HEX 4002454C3344 -TU_SIZE 1024 -CLASS 4 -WINDOW 1

G&R Configuring the Host Links system Configuring the transport stack DSA is a session level protocol that runs over a transport stack. Tradit

G&R Configuring Host Links It is assumed here that the Host Links software, and OSI-transport, if used, is already installed on the target pla

G&R The listener The listener is used for distribution of incoming connections from the remote host(s) to the Host Links applications. The lis

G&R Establish the physical connections X25 connections For a public X25 connection simply connect the appropriate cables to the X25 DCEs. Mos

G&R Host Links tools If you are using OSI-transport there are usually internal debug and trace tools supplied with the communication stack. C

G&R Gline Line Handlers and Configuration 2

G&R The dsa.cfg configuration file Overview One or more local session control entities (SC) must be defined. These are looked up using the val

G&R Access to undefined connection names may be configured to be either an error or to be ignored (COSTRICT). Arbitrary options or groups of o

G&R Configuration file directives In the syntax used below UPPERCASE is used for the fixed keywords and lowercase for the variable parameters.

G&R -UNAME is optional. It’s the system’s UNIX/Linux or Windows server communications node name. NB! it is not the DSA node name. This name ca

G&R -TS points to a TS (Transport Station) directive somewhere else in the file. If you omit the option the default TS is used. rsc is2b rsc

G&R -CLASS is required and must be set to 0 for RFC1006 connections, 2 for WAN/X.25 connections and 4 for LAN connections. -NS is also require

G&R Deriving -NS for FDDI hosts All Ethernet MAC addresses are in ‘LLC’ format. All FDDI addresses are in ‘SMT’ format. In SMT format you will

G&R For Marben on Windows servers: Specify either WAN or LAN. For SUN Specify a local network layer address as configured in the local OSI st

G&R CONAME - Connection Name CONAME name [-DESC desc] [-FILTER filter] [-PARAMS params] [-POOL pool] [-TYPE TERM | PRINT] [Gline

G&R Gline parameters Gline parameters can be added to the CONAME directly, or via PARAMS or POOL directives. By default Gline parameters can b

G&R Scope of the product G&R/Gline comprises a set of communications line handlers with a standard interface used by the G&R Host Link

G&R coname tssprod -desc “TSS production system” -params tssprod -scid is40 -dmb tss * Gline parameter list for all users params tsspro

G&R filter bergen permit tcp 192.150.212.[00-10] * macro for group filter lillehammer permit tcp 192.150.213.4 * single user Macro f

G&R RESTRICT - Parameter Restrictions RESTRICT [-FILTER filter] Gline parameter list [Gline parameter list] Defines Gline parameters that sho

G&R running Qsim, V78sim etc. will match filter lines with LOCAL specified. Local clients are the Host Links products on the system that own

G&R USER expression: The expression is the user name that is supplied by the client in the ‘logon packet’ (in the -us parameter). The user nam

G&R restrict -filter internal # addresses passing the filter cannot choose -dn * # the default node to which they connect

G&R Sample dsa.cfg for RFC1006 HL02FDDIFCP8ONP1 GC7FBull hosts and FEPG&R Host Links nodesFCP7GC8FHL01LANBrief description of the

G&R The Host Links node ‘HL01’ Windows Server \gar\config\dsa.cfg UNIX/Linux /usr/gar/config/dsa.cfg # Local Host Links DSA node HL01 # sc h

G&R The DPS9000 node ‘GC8F’ Osi.cfg STACK I_NOERRFLAG NETSHARE TCIVMO NAME=IVMO8 TPUSIZE=1024 NRSC NAME=HL01 NRTS=HL01TS NRTS NAME=HL01TS TYPE

G&R The MainWay & & LOCAL MAINWAY NODE 'ONP1', ADDR=49:005 & SC ONP1 LOC -ADDR 49:005 -ISOPLG TS ONP1 LOC -ADDR 4