Instruction/ maintenance manual of the product ReRouter I-Data
Go to page of 79
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.
- 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.
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.
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 Installation Guide Doc.
Table of Contents ida ReRouter 5 Table of Contents 1. Introduction ................................ ................................ .................... 7 1.1 What is the ida ReRouter ? ................................ ...............................
Table of Contents ida ReRouter 6 8. Testing Connection to Remote Device ................................ .......... 59 8.1 PING Function ................................ ................................ ................. 59 8.2 Log Files .............
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.
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” ( P age P rinter R emote P age P rinter D aemon).
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 an LU 6.
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 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.
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.
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 files to be installed.
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.
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.
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.
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.
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. Clic k on " New " to define a new route.
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.
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. ; **************************************************************************************** ; * idaRoute.
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.
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.
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.
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.
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 / .
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 Interval Timer) should be set to 0.
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 .
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.
Configuration ida ReRouter 29 /**********************************************************************/ /* */ /* IDA AFP EXEC Version 6 Release 01 - (C) Copyright I-data A/S 1994 */ /* Process parm and.
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 *--------------------------.
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,SON.
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 IBM382.
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 workstation.
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 default for this parameter is *NO.
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.
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.
Configuration of AS/400 Networks ida ReRouter 37 6.4 Sample Controller Definition Controller description.................. * IDATA1 Option.......................................... * BASIC Category of controller.................. * APPC Link type.....
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.
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.
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.
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.
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.
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 .
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.
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” .
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”.
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.
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.
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.
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.
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.
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.
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.
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.
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 description 12.
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 blishment controller, e.
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.
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 confirm the configuration.
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.
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.
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.
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: 9.
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.
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 [.
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.
Problem Determination ida ReRouter 66 ROUT0611I: Trace enabled [...] Description: Program trace is enabled. Action: Note: Trace information is written to the <LUALIAS>.trc file. (see section 9.2: "Trace" for further information). ROUT0612W: SWIDDEF file error [.
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.
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.
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/PP.
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 of the route.
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.
Appendix Section ida ReRouter 72 KEYWORD: "IPADDRESS" DESCRIPTION: The Internet Protocol address for the TCP/IP device. RANGE: Decimal dotted notation 0.
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.
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.
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.
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.
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/R.
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.
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 is not required.
An important point after buying a device I-Data ReRouter (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought I-Data ReRouter yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data I-Data ReRouter - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, I-Data ReRouter you will learn all the available features of the product, as well as information on its operation. The information that you get I-Data ReRouter will certainly help you make a decision on the purchase.
If you already are a holder of I-Data ReRouter, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime I-Data ReRouter.
However, one of the most important roles played by the user manual is to help in solving problems with I-Data ReRouter. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device I-Data ReRouter along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
