- DL manuals
- I-Data
- Software
- ida ReRouter
- Installation & Operator’s Manual
I-Data ida ReRouter Installation & Operator’s Manual
i-data Electronic Documentation
ida ReRouter
Installation & Operator’s Guide
Doc. no 60276 Revision 00
WARNING:
This equipment generates, uses, and can radiate radio frequency energy and if not installed and used
in accordance with the instruction manual, may cause interference to radio communications. It has
been tested and found to comply with the limits for a Class A computing device pursuant to Subpart B
of Part 15 of FCC Rules, which are designed to provide reasonable protection against such inter-
ference when operated in a commercial environment. Operation of this equipment in a residential
area is likely to cause interference in which case the user at his own expense will be required to take
whatever measures may be required to correct the interference.
EMCdirective:
This product observes the rules and regulations of the EMC directive. If so required, a declaration of
conformity in local language stipulating the applied rules and regulations can be obtained.
Trademarks:
Company and product names mentioned in this datasheet are trademarks or registered trademarks of
their respective owners. i-data international a-s cannot be held responsible for any technical or
typographical errors and reserves the right to make changes to products and documentation without
prior notification.
The i-data Printing Solutions
ida
ReRouter
Summary of ida ReRouter
Page 1
I-data electronic documentation ida rerouter installation & operator’s guide doc. No 60276 revision 00 warning: this equipment generates, uses, and can radiate radio frequency energy and if not installed and used in accordance with the instruction manual, may cause interference to radio communicatio...
Page 2
- 2 - document no.: d60276-00 © copyright i-data international a-s 1997 main office: i-data international a-s vadstrupvej 35-43 dk-2880 bagsvaerd denmark telephone: +45 44 36 60 00 telefax: +45 44 36 61 11 e-mail: i-data i-data.Com www: http://www.I-data.Com i-data denmark vadstrupvej 35 dk-2880 bag...
Page 3: Preface
Preface idarerouter 3 preface january 1997 this manual covers the installation and configuration of the ida rerouter. The ida rerouter is a transaction program designed to take host ipds print using the lu 6.2 protocol and convert it to print using a bi-directional tcp/ip protocol. The program opera...
Page 4
Preface idarerouter 4 related manuals for operation of the ida rerouter on a remote device, you are also to consult the documentation for that particular remote device. Token ring ethernet ida 913-03 token ring lan brick installation guide doc. No. D11068/d61068 ida 913-04 ethernet lan brick install...
Page 5: Table of Contents
Table of contents ida rerouter 5 table of contents 1. Introduction ................................ ................................ .................... 7 1.1 what is the ida rerouter?................................ ............................... 7 1.2 product features ..............................
Page 6
Table of contents ida rerouter 6 8. Testing connection to remote device ................................ .......... 59 8.1 ping function ................................ ................................ ................. 59 8.2 log files ................................ ................................
Page 7: 1. Introduction
Introduction ida rerouter 7 1. Introduction this chapter provides a brief introductory description of the ida rerouter. Chapter 4 describes the installation and setup in details. 1.1 what is the ida rerouter? The ida rerouter is a transaction program which is able to take host print using the lu 6.2...
Page 8
Introduction ida rerouter 8 from the ida rerouter, printer data will be passed transparently through the tcp/ip protocol and repacked into the format of a bi-directional tcp/ip protocol called “ppr/ppd” ( page printer remotepage printer daemon). In the following is illustrated how the ida rerouter c...
Page 9: 1.2 Product Features
Introduction ida rerouter 9 ida rerouter the ida rerouter consists of two main programs: - idaroute(lu 6.2 to tcp/ip rerouter for os/2) the function of the idaroute is to act as link between the host (sna environment) and the tcp/ip protocol. In this way the host will assume that communication with ...
Page 10
Kit contents ida rerouter 10 2. Items supplied with ida rerouter the following items are supplied with the ida rerouter: • 3.5" diskette containing among others a setup file and an informatiive file - readme.Txt. ..... And other files used for setting up and configuring the ida rerouter. • product d...
Page 11: 3. Product Requirements
Product requirements ida rerouter 11 3. Product requirements 3.1 host system requirements • mainframe - psf/vm 2.1 or higher - psf/mvs 2.1 or higher - psf/vse 2.1 or higher • as/400 - os/400, version 2.2 or higher - psf/400 for os/400, version 3.1 or higher 3.2 personal computer requirements hardwar...
Page 12: Rerouter
Installation and setup ida rerouter 12 4. Installation and setup of ida rerouter this chapter describes the installation and configuration of the ida rerouter. 4.1 installation of ida rerouter 1. Insert the ida rerouter installation diskette into drive a. 2. Type: a: setup 3. Now the following scree...
Page 13
Installation and setup ida rerouter 13 4. Set the location of the program to the disk and directory of choice 5. Select the field " install" if all files are to be installed (this will create folders, icons, programs, etc). (if the ida rerouter is to be upgraded, select "update" for only the program...
Page 14: 4.2 Setup Of Ida Rerouter
Installation and setup ida rerouter 14 4.2 setup of ida rerouter after having completed the installation, the os/2 desktop will create a folder called “ ida rerouter”. This folder contains two objects: - the configuration program - a readme file 1. Click on the "idarerouter" folder. Ida rerouter 2. ...
Page 15
Installation and setup ida rerouter 15 route name this is the user defined alias for a particular route. Status the status panel provides information on the status of each route session to the remote printer. The status messages are: inactive activating active deactivating intervention required toge...
Page 16
Installation and setup ida rerouter 16 new the defining of new routes is described in details in section 4.2.1: "defining a new route". To add more routes, see section 4.2.2: "additional routes". Change changing an existing route is described in section 4.2.3: "changing a route". Delete deleting a r...
Page 17
Installation and setup ida rerouter 17 deactivate route note: this entry field should be used only with great care. The request for deactivating a route derives from the os/2 system. The remote printer device /queue will be stopped on the host system and active jobs will be interrupted. Refresh this...
Page 18
Installation and setup ida rerouter 18 4.2.1 defining a new route 1. To setup the ida rerouter, click on "setup" in the setup dialog screen (or select: "alt_s"). See the screen on page 16. 2. Click on "new" to define a new route. The following screen will appear: 3. Enter route name (mandatory) rout...
Page 19
Installation and setup ida rerouter 19 note: lu alias must match the lu alias defined in communications manager if the lu alias is not defined, the idaroute will terminate and write to the log file. 6. Enter ip address (in decimal dot notation) note: must match the device (e.G. Ida 913-03 / ida 913 ...
Page 20
Installation and setup ida rerouter 20 when the all the setup entries have been made and verified, the ida rerouter will create a configuration file (idaroute.Ini file). See the sample configuration file below. ; ***************************************************************************************...
Page 21
Installation and setup ida rerouter 21 4.2.2 additional routes more routes may be added by clicking on "setup" and then "new". Follow the setup procedures in the steps 3-10 above. Note: no two route names and lu aliases may be identical. For each route defined, the idaroute will be loaded implying t...
Page 22: 4.3 Keep Alive Function
Installation and setup ida rerouter 22 4.3 keep alive function the keepalive feature is a monitor function to check the conneciton between the transaction program (i.E. The ida rerouter program) and the printer. The monitoring of the conneciton is done at defined intervals. 4.3.1 support for keepali...
Page 23
Installation and setup ida rerouter 23 4.3.2 tcp/ip keepalive configuration on os/2 • os/2 2.0 with apar ir28716 fix must be installed. • tcp/ip 2.0 with csd un64092 or later must be installed. • the tcp/ip "inetcfg" command can be used to configure the "keepalive" parameter. Inetcfg keepalive=nnn w...
Page 24
Configuration ida rerouter 24 5. Configuration of s/370 networks this chapter will provide you with configuration instructions for the s/370- 390 networks with psf. 5.1 configuration examples for mvs and vm 5.1.1 psf/mvs printer definition and startup procedure / from the system parmlib prt08,class=...
Page 25
Configuration ida rerouter 25 //psf proc //idafss1 exec pgm=apsppiep.Region=4m //jobhdr output pagedef=sep300, / * job header pagedef * / // formdef=sep300, / * job header formdef * / // chars=gt15 / * job header font * / //jobtlr output pagedef=sep300, / * job trailer pagedef * / // formdef=sep301,...
Page 26
Configuration ida rerouter 26 note: ovlydd, psegdd, pdefdd and fdefdd the overlay, segment, pagedef. And formdef. Library statements should match the ipds emulation selected on the device to be communicated with. Disintv to avoid unnecessary stopping/starting of sesssion, the disintv (disconnect int...
Page 27
Configuration ida rerouter 27 5.1.3 pss/mvs printer definition and startup procedure /* from the system parmlib prt410,class=a,drain,mode=fss,fss=pss4, prmode=(line, page),ucs=0,ws=(w,r,q/f) prt411,class=a,drain,mode=fss,fss=pss4, prmode=(line, page),ucs=0,ws=(w,r,q/f) example of pss/mvs jes2 printe...
Page 28
Configuration ida rerouter 28 5.1.4 pss/vm pdm definition user idapss password 10m 16m abdg 64 off off off account 3000 udv option ecmode vcunoshr scr ina gre non stata red non cpout yel non vmout blu non inred whi non ipl gcs parm autolog console 009 3215 t operator spool 00c 2540 reader * spool 00...
Page 29
Configuration ida rerouter 29 /**********************************************************************/ /* */ /* ida afp exec version 6 release 01 - (c) copyright i-data a/s 1994 */ /* process parm and transfer them to ida afp virtual machine */ /* */ /* dependencies: list3820, list38pp */ /* pseg382...
Page 30
Configuration ida rerouter 30 5.1.5 pss printer profile using sna and tcp/ip attachment key key=01234567890123450123 ddname ddname=pss4.Temp volid volid=mvspk1 smf type=234 *------------------------------------------------------------------- * global default used by all pss *------------------------...
Page 31
Configuration ida rerouter 31 5.1.6 host vtam definition applpsf vbuild type=appl * * psfapp11 appl auth=acq,eas=1,sonscip=yes psfapp12 appl auth=acq,eas=1,sonscip=yes psfapp13 appl auth=acq,eas=1,sonscip=yes example of mvsvse vtam application definition for psf netid=dkidtn01, this network's id x s...
Page 32
Configuration ida rerouter 32 mode table: local 37xx sdlc remote 37xx sdlc/tr local 3174 tr gateway remote 3174 tr gateway local 3172 etherne t gateway local 37xx tr attachment logmode ibm3820m ibm3820r ibm3820t ibm3820r ibm3820t ibm3820t fmprof x’13’ x’13’ x’13’ x’13’ x’13’ x’13’ tsprof x’07’ x’07’...
Page 33
Configuration of as/400 networks ida rerouter 33 6. Configuration of as/400 networks the object of this chapter is to provide you with guidelines for manual configuration of your as/400 system connecting to an ipds session. The examples assume that configuration is made for a token ring attached wor...
Page 34
Configuration of as/400 networks ida rerouter 34 6.2 creating printer device description type: crtdevprt prompts: parameter and values in parentheses device description devd(rer1prt) device class devcls(*rmt) device model model(0) device type type (*ipds) advanced function afp (*yes) printing the de...
Page 35
Configuration of as/400 networks ida rerouter 35 6.3 updating appn remote location list (sna connections only) the appn location lists, which are only used for appn configurations (i.E. When appn /*yes) is specified in the controller description, define special characteristics of remote locations. T...
Page 36
Configuration of as/400 networks ida rerouter 36 local location name (s4450327) the local location name is the name defined in the network attributes. The value for local location name can be obtained by using the dspneta value. This value must match the following: * lcllocname in the printer device...
Page 37
Configuration of as/400 networks ida rerouter 37 6.4 sample controller definition controller description.................. * idata1 option.......................................... * basic category of controller.................. * appc link type...................................... * lan online at...
Page 38: 7. Workstation Configuration
Workstation configuration ida rerouter 38 7. Workstation configuration - for sna connection - the pc configuration description of communications manager/2, laps and tcp/ip includes both the as/400 and the s/370 (s/390) network systems. 7.1 communications manager/2 for s/370-390 and as/400 this secti...
Page 39
Workstation configuration ida rerouter 39 7.1.1 changing configuration file communications manager setup 1. Select "setup" to create or modify a configuration 2. Enter the name of the configuration file you wish to modify in " configuration" 3. Select "ok". Communications manager configuration def. ...
Page 40
Workstation configuration ida rerouter 40 configuring sna local node characteristics communications manager profile list sheet 1. Select "sna local node characteristics" 2. Select "configure" local node characteristics 1. Set "network id" to, see worksheet ( 6 ) 2. Set "local node name" to the numbe...
Page 41
Workstation configuration ida rerouter 41 connection list the connection may already have been defined. If so, check that the connection matches the description below. (if the connection is to be changed, select “change” instead of “create.) for s/370 host connection: 1. Select "to host" under partn...
Page 42
Workstation configuration ida rerouter 42 2. Host connection (normally s/370-390): 2a. Select “ activate at startup ” 2b. Select “ local pu name” 2c. Select " appn support" (if needed) 2d. Set "node id", see worksheet ( 8 ) 2e. Set "lan destination address " to: see worksheet ( 16 ) 2 f. Specify “ a...
Page 43
Workstation configuration ida rerouter 43 creating a local lu sna / local lus features list 1. Select "local lus" 2. Select "create" local lu 1. Set "lu name" to: see worksheet ( 14 ) 2. Set "alias" to: see worksheet ( 15 ) the lu alias must be the same as defined in the ida rerouter. 3 if dependent...
Page 44
Workstation configuration ida rerouter 44 mode definition ( as/400 only) 1. Select "modes", see worksheet ( 19 ) 2. Select "create" 3. Enter the value “ qspwtr” 4. Select “ok” creating a transaction program definition sna features list / transaction program def. 1. Select "transaction program defini...
Page 45
Workstation configuration ida rerouter 45 for icds connection to ida pss: 1. Set "transaction program (tp) name" to:idaroute 2. Set "os/2 program path and file name" to: see worksheet ( 10 ) 3. Set program parameter strings to “idaroute”. 4. Select “continue”. Note: the tp name used must match the t...
Page 46
Workstation configuration ida rerouter 46 communications manager configuration def. 1. Select "close" your configuration file is automatically verified. You may now be presented with a pop-up window with the following message: “do you wish to dynamically update your sna resources”. Select “yes”. Sel...
Page 47
Workstation configuration ida rerouter 47 7.1.2 s/370 network configuration worksheet on the following pages you will find sample configuration worksheets for two remote devices connected to the ida rerouter, the ida 913-03 token ring and the ida ps 13, using the dependent lus. First device: ida 913...
Page 48
Workstation configuration ida rerouter 48 second device: ida ps 13 work-station: comm. Manager/2 laps psf vtam ncp ida rerouter keywords 1 configuration filename tokenr token ring dlc profile 2 adapter number 0 3 max. Link stations 10 4 max.Ru size 1024 1024 5 c&sm lan id idata1 local node character...
Page 49
Workstation configuration ida rerouter 49 7.1.3 as/400 network configuration worksheet this section provides details on the configuration worksheets for two remote devices connected to the ida rerouter: the ida 913-03 token ring and the ida ps 13. First device: ida 913-03 token ring - part 1. Workst...
Page 50
Workstation configuration ida rerouter 50 first device: ida 913-03 token ring - part 2. Workstation: appcdev printer dev. Configuration list ida rerouter 1 configuration filename token ring dcl profile 2 adapter number 3 max. Link stations 4 max.Ru size 1024 5 c&sm lan id local node characteristics ...
Page 51
Workstation configuration ida rerouter 51 second device: ida ps 13 - part 1. Work-station: comm.Manager/2 laps tr line appccontroller 1 configuration filename tokenr token ring dcl profile 2 adapter number 0 0 3 max. Link stations 2 4 max.Ru size 1024 1024 1024 5 c&sm lan id idata1 local node charac...
Page 52
Workstation configuration ida rerouter 52 second device : ida ps 13 - part 2. Workstation appcdev printer dev. Config. List ida rerouter 1 configuration filename token ring dcl profile 2 adapter number 3 max. Link stations 4 max.Ru size 1024 5 c&sm lan id local node characteristics 6 network name (i...
Page 53
Testing connection to remote device ida rerouter 53 7.1.4 explanation to configuration worksheets this chapter gives a description of each of the communication manager/2 profiles for s/370 - s/390 and as/400 stated in the configuration worksheet (see the sections 7.1.2 for s/370 and section 7.1.3 fo...
Page 54
Testing connection to remote device ida rerouter 54 8. Node id this identifier is used by the host to link with thi s workstation when attached to a t/r network. It must be unique within a switched node network. Co-ordinate this assignment with your network administrator. S/370 - s/390: must match t...
Page 55
Testing connection to remote device ida rerouter 55 as/400: the network id can be obtained from the as/400 rmtnetid parameter in - as/400 appc controller description the partner lu is obtained from the as/400 lcllocname parameter in: - as/400 appc device description - as/400 appc printer device desc...
Page 56
Testing connection to remote device ida rerouter 56 15. Lan destination address specifies the destination address for a lan adapter. The destination address is the address of the partner's lan adapter. 16. Lan adapter address this parameter is for s/370 - s/390 only! Used by the vtam (or an esta bli...
Page 57: 7.2 Laps
Testing connection to remote device ida rerouter 57 7.2 laps when installing tcp/ip, a laps (lan adapter protocol support) protocol must be added for the tpc/ip in question. First select network adapter and then add the protocol for the tcp/ip as illustrated in the screen below. The selected protoco...
Page 58
Testing connection to remote device ida rerouter 58 network tick the field "enable lan adapter 0" and define the ip address for the pc and subnet mask. Routing note: routing is only defined if connection is made to multiple ip network. When configuration of the tcp/ip protocol is completed, you must...
Page 59: 8.1 Ping Function
Testing connection to remote device ida rerouter 59 8. Testing connection to remote device when the ida rerouter has been installed and is ready for operation you are recommended to test the connection to the remote device being communicated with. For a list of remote printer devices being supported...
Page 60
Testing connection to remote device ida rerouter 60 ping function succeeded: if the ping is ok, you receive a system response like this: ping 192.0.5.7: 56 data bytes 64 bytes from 192.0.5.7: icmp_seq=0. Time=0. Ms 64 bytes from 192.0.5.7: icmp_seq=1. Time=0. Ms 64 bytes from 192.0.5.7: icmp_seq=2. ...
Page 61: 8.2 Log Files
Testing connection to remote device ida rerouter 61 8.2 log files in the following chapter 9: "problem determination", all the log files for the idaroute program are described together with a suggested action to correct the error situation. All log messages sent to the log file will be time stamped....
Page 62: 9. Problem Determination
Problem determination ida rerouter 62 9. Problem determination the idaroute program logs all errors. All entries in the log file are time stamped. Apart from the error messages indicated in the following, a number of status messages are also logged. The errors produced will use the following syntax:...
Page 63
Problem determination ida rerouter 63 rout0035e: cannot open configuration file [...] description: the system is not properly configured. The configuration file "idaroute.Ini" is not created in the idaroute directory. Action: use the idarctrl program to make the proper setup. Note: - rout0052e: conf...
Page 64
Problem determination ida rerouter 64 rout0110e: invalid appc opcode [...] description: the transaction program has discovered an appc syntax error. Action: try once more. If problem persists, contact your system administrator. Note: - rout0111e: appc error: opcode [...] primary rc: secondary rc: de...
Page 65
Problem determination ida rerouter 65 rout0604e: tcp/ip communication error [...] description: a situation with a communication failure has occurred. Action: check the remote device to see if it is ready and active. "ping" the remote device (for details.See chapter 8:”testing the remote de vice"). R...
Page 66
Problem determination ida rerouter 66 rout0611i: trace enabled [...] description: program trace is enabled. Action: note: trace information is written to the .Trc file. (see section 9.2: "trace" for further information). Rout0612w: swiddef file error [...] description: the swiddef is either invalid ...
Page 67
Problem determination ida rerouter 67 rout0618i: remote device (printer) is not ready description: an attempt to make a connection has failed. Action: check the remote device and retry. Note: make sure that a test page can be ejected from the remote device. Rout0619e: cannot reach the specified dest...
Page 68: 9.2 Trace
Problem determination ida rerouter 68 rout0803e: thread handling error [...] description: an os/2 system call has failed. Action: re-start the ida rerouter, re-start the os/2. If problem persist, contact your system administrator. Note: - 9.2 trace the trace entry in the setup screen (see chapter 4:...
Page 69: 10. List of Abbreviations
Appendix section ida rerouter 69 10. List of abbreviations appc advanced program to program communication ip internet protocol lu logical unit ping packet internet group pm presentation manager ppd/ppr ppd (page printer daemon) and ppr (page printer remote) are bi-directional print protocols for afp...
Page 70
Appendix section ida rerouter 70 appendix a: keyword definitions the configuration file - idaroute.Ini - created upon completion of the setup dialog (see section 4.2: setup of ida rerouter) consists of multiple route definitions. Each route definition is a set of keywords defining the actual setting...
Page 71
Appendix section ida rerouter 71 keyword: "route_name" description: user defined alias for a particular route. Range: alphanumerical string (a-z, a-z and 0-9) no white spaces max. 15 characters default: none keyword: "description" description: a short description of the defined route range: alphanum...
Page 72
Appendix section ida rerouter 72 keyword: "ipaddress" description: the internet protocol address for the tcp/ip device. Range: decimal dotted notation 0.0.0.0. - 255.255.255.255 default: none keyword: "portno" description: specifies the actual port number of the remote printer device (printer daemon...
Page 73: Appendix B:
Appendix section ida rerouter 73 appendix b: fill-in configuration worksheet in the following pages, you will find blank configuration worksheets for the networks s/370 and as/400. With these you can make your own system configuration worksheets..
Page 74
Appendix section ida rerouter 74 fill-in configuration worksheet for s/370 networks remote device: _______________________ work-station: comm. Manager/2 laps psf vtam ncp ida rerouter 1 configuration filename token ring dlc profile 2 adapter number 3 max. Link stations 4 max.Ru size 5 c&sm lan id lo...
Page 75
Appendix section ida rerouter 75 fill-in configuration worksheet for as/400 - part 1. Remote device: _______________________ work-station: comm. Manager/2 laps tr line appccont 1 configuration filename token ring dcl profile 2 adapter number adptadr 3 max. Link stations 4 max.Ru size maxframe maxfra...
Page 76
Appendix section ida rerouter 76 fill-in configuration worksheet for as/400 - part 2. Communications manager /2 profile appcdev printer dev. Config. List ida reroute remote device 1 configuration filename token ring dcl profile 2 adapter number 3 max. Link stations 4 max.Ru size 5 c&sm lan id local ...
Page 77: Mainframe Environment
Appendix section ida rerouter 77 appendix c: i-data products afp ipds laser ipds matrix non-ipds laser non-ipds matrix hardware ida 270x - optra - 4039 - mio - sio ida pds - 270 c/rs - lcd ida 270 c/rs ida rpp ida ls 100 ida pds - optra - 4039 - mio ida pds - 270 c/rs - tr lcd - lcd ida 234-11 mt 69...
Page 78: Midrange Environment
Appendix section ida rerouter 78 afp ipds laser ipds matrix non-ipds laser non-ipds matrix hardware ida 812-1x - optra - 4029 - 4039 - mio - sio - 250 c/rs ida pds - optra - 4039 - mio ida pds - 250 c/rs - tr lcd - lcd ida 234-12 mt 691 ida 234-12 mt 800 ida 812-1x - optra - 4029 - 4039 - mio - sio ...
Page 79: Reader'S Comments
79 reader's comments this manual is part of a library that serves as a reference source for programmers and operators of i-data equipment. This form may be used to communicate your view about this publication. Your interest is appreciated. Comments may be written in your own language, use of english...