Do you have a question about the ReRouter and is the answer not in the manual?
Questions and answers
Summary of Contents for I-Data ReRouter
Page 1
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.
Page 3
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 operates under OS/2 2.0 or higher.
Page 4
Preface idaReRouter 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 ida 913-03 Token Ring LAN Brick Installation Guide Doc. no. D11068/D61068 i-data 7913-03 IPDS...
3. Product Requirements ..11 3.1 Host System Requirements ..11 3.2 Personal Computer Requirements ..11 4. Installation and Setup of ida ReRouter..12 4.1 Installation of ida ReRouter..12 4.2 Setup of ida ReRouter ..14 4.2.1 Defining a new route ...
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 protocol and pass it to a bi-directional TCP/IP (Transmission Control Protocol / Internet Protocol) protocol on any one of the supported products stated in section 2.2.
Page 8
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 could be applied. See Fig. 1.2: "ida ReRouter in Token Ring Environment" and Fig. 1.3: "ida ReRouter in Ethernet Environment".
(See the idaRoute main screen on page 15). 1.2 Product Features The ida ReRouter provides the following features: The ida ReRouter transaction program performs direct host print from e.g. S/370-390 or AS/400 to the following products: - ida PrintServer 13...
Kit Contents ida ReRouter 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 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...
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 screen will appear:...
Page 13
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.) 6. Select/De-select the installation options according to needs and requirements.
ReRouter 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.
Page 15
8.2: “Log Files” for additional information Description This menu gives a brief description of the defined route. To setup and operate with routes in the ida ReRouter, click on "Setup", and the following screen will appear. Setup menu N e w ..
Page 16
Installation and Setup ida ReRouter 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".
Page 17
Installation and Setup ida ReRouter 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.
ReRouter 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:...
Page 19
Installation and Setup ida ReRouter 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.
Page 20
ReRouter will create a configuration file (idaRoute.ini file). See the sample configuration file below. ; **************************************************************************************** idaRoute.ini ; * Configuration file for the i-data LU 6.2 to TCP/IP ReRouter for OS/2 2.x ; **************************************************************************************** DEFINE_ROUTE ROUTE_NAME PSF-AS400 DESCRIPTION PSF-AS400 to ida 913-03...
Installation and Setup ida ReRouter 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.
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 KeepAlive to OS/2 The TCP/IP components for OS/2 offer network attachment for printers.
Installation and Setup ida ReRouter 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"...
Configuration ida ReRouter 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...
Configuration ida ReRouter 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 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...
Page 29
Configuration ida ReRouter /**********************************************************************/ /* 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 PSEG3820, PSEG38PP, PSEG300 OVLY3820, OVLY38PP and normal files (line data files)
FSSNAME PSS4 FSANAME FSANAME=IDAFSA4 *------------------------------------------------------------------- * LOCAL DEFINITIONS USED BY PSS4 (PROC NAME) *------------------------------------------------------------------- DEFAULT LOGMODE=RSCSPRT1 APPLID APPLID=IDAPSS4 *------------------------------------------------------------------- * PSS PRINTER DEFINITION FOR USE WITH THE IDA REROUTER *------------------------------------------------------------------- PRINTER PRTID=PRT410,LUNAME=IDNET023, LOGMODE=IBM3820T, LOGDD=CONSOLE, RETRY=10, BINM=2, XOFFSET=0, YOFFSET=0 HPDEF=HEAD2,TPDEF=HEAD2, HFDEF=HEAD,TFDEF=HEAD...
Configuration of AS/400 Networks ida ReRouter 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 6.2 Creating Printer Device Description Type: CRTDEVPRT Prompts: Device description Device class Device model Device type Advanced function printing AFP attachment Font identifier Form Feed Remote location name: Remote network identifier Mode TEXT 'description'...
Configuration of AS/400 Networks ida ReRouter 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.
Page 36
Configuration of AS/400 Networks ida ReRouter 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:...
Configuration of AS/400 Networks ida ReRouter 6.4 Sample Controller Definition Controller description... Option... Category of controller... Link type... Online at IPL... Active switched line... Character code... Maximum frame size... Remote network identifier... Remote control point... Initial connection... Dial initiation... Switched disconnect...
An explanation to the worksheets can be seen in section 7.1.4: "Explanation to configuration Worksheets". NOTE: The ida ReRouter setup values and the Communications Manager/2 profiles must match the corresponding parameters of the Host network. The configuration examples assume that the connections are based on Token Ring.
Workstation Configuration ida ReRouter 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 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 ( 2. Set "Local node name" to the number of your workstation (from the host) 3.
Page 41
Workstation Configuration ida ReRouter 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 partner type 2.
Page 42
Workstation Configuration ida ReRouter 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 ( 2e. Set "LAN destination address " to: see worksheet ( 2 f.
Page 43
1. Set "LU name" to: see worksheet ( 2. Set "Alias" to: see worksheet ( The LU Alias must be the same as defined in the ida ReRouter. 3 If dependent LUs are being used select LU NAU address ( 4.
Page 44
For IPDS connection to PSF/370-390 and PSF/400: 1. Set "Transaction program (TP) name" to: $DPF (See worksheet ( 2. Set "OS/2 program path and file name" (ida ReRouter program) to: see worksheet ( 3. Select "Continue" Mode Definition ( AS/400 only)
Page 45
Workstation Configuration ida ReRouter 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 ( 3. Set program parameter strings to “IDAROUTE”. 4. Select “Continue”. Note: The TP name used must match the TP name used in the PSS printer profile (i.e.
Page 46
Workstation Configuration ida ReRouter 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”.
Local LU address Connections Destination address 40005A0001C1 LAN adapter address IP Address Port number LAPS VTAM 1024 DKIDTN01 05D 00000 PSFAPP11 PSFAPP11 IDSNCEP0 IDSNCEP0 40005A0000D5 40005A0000D5 ida ReRouter, IDA REROUTER KEYWORDS 1024 DKIDTN01 05D 00000 PSFAPP11 IDSNCEP0 IDSNCEP0 40005A0001C1 40005A0000D5...
Page 48
LAN adapter address IP Address Port number This profile description is also valid for “Partner Network ID” and “Partner Node Name”. LAPS VTAM 1024 DKIDTN01 05D 00000 PSFAPP12 DKIDTN01 IDSNCEP1 IDSNCEP1 40005A0000D5 40005A0000D5 IDA REROUTER KEYWORDS PSFAPP12 IDSNCEP1 IDSNCEP1 40005A0001C1...
Local LU address Connections Destination address 40000B100002 LAN Adapter addr. IP Address Port No. . Mode Profile Mode name QSPWTR Part 1. LAPS TR LINE 1024 40000B100002 40005A0000D5 ida ReRouter: the ida 913-03 APPCController *CALC DKIDTN01 IDATA1 05D 00000 DKIDTN01. S4450327...
Page 50
Workstation Configuration ida ReRouter First device: ida 913-03 Token Ring - WORKSTATION: APPCDev Configuration filename Token Ring DCL Profile Adapter number Max. link stations Max.RU size 1024 C&SM LAN ID Local Node Characteristics Network name (ID) DKIDT01 Local node name Local Node ID Transaction Program Def.
Page 51
Workstation Configuration ida ReRouter Second device: ida PS 13 WORK-STATION: Comm.Manager/2 Configuration filename TOKENR Token Ring DCL Profile Adapter number Max. link stations Max.RU size 1024 C&SM LAN ID IDATA1 Local Node Characteristics Network name (ID) DKIDTn01 Local node name...
Page 52
Workstation Configuration ida ReRouter Second device ida PS 13 - WORKSTATION APPCDev Configuration filename Token Ring DCL Profile Adapter number Max. link stations Max.RU size 1024 C&SM LAN ID Local Node Characteristics Network name (ID) DKIDTN01 Local node name Local Node ID Transaction Program Def.
Testing Connection to Remote Device ida ReRouter 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 for AS/400).
Page 54
Testing Connection to Remote Device ida ReRouter 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.
Page 55
Testing Connection to Remote Device ida ReRouter 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 - AS/400 APPC device description - AS/400 APPC printer device description 12.
Page 56
Testing Connection to Remote Device ida ReRouter 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.g.
Testing Connection to Remote Device ida ReRouter 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.
Page 58
Testing Connection to Remote Device ida ReRouter 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.
ReRouter 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 with the ida ReRouter, see chapter 1: "Introduction".
Page 60
NOTE: When you press the TEST key, you make a disconnection between the printer and the ida ReRouter. To restart, you simply send another job to this device. If you need further instructions on how to PING the remote device, you are referred to the relevant TCP/IP documentation for the host you are using.
Testing Connection to Remote Device ida ReRouter 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 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.1 Error Syntax...
Page 63
Problem Determination ida ReRouter ROUT0035E: Description: Action: Note: ROUT0052E: Description: Action: Note: ROUT0104E: Description: Action: Note: ROUT0105E: Description: Action: Note: ROUT0106E: Description: Action: Note: Cannot open configuration file [...] The system is not properly configured. The configuration file "idaRoute.ini" is not created in the idaRoute directory.
Page 64
Problem Determination ida ReRouter ROUT0110E: Description: Action: Note: ROUT0111E: Description: Action: Note: ROUT0600E: Description: Action: Note: ROUT0601E: Description: Action: Note: ROUT0602E: Description: Action: Note: ROUT0603E: Description: Action: Note: Invalid APPC opcode [...] The transaction program has discovered an APPC syntax error.
Page 65
Problem Determination ida ReRouter ROUT0604E: Description: Action: Note: ROUT0605E: Description: Action: Note: ROUT0606W: Remote device already connected to another server Description: Action: Note: ROUT0608I: Description: Action: Note: ROUT0609I: Description: Action: Note: ROUT0610I: Description: Action: Note: interrrupted. TCP/IP communication error [...] A situation with a communication failure has occurred.
Page 66
Trace information is written to the <LUALIAS>.trc file. (see section 9.2: "Trace" for further information). The swiddef is either invalid or non-existing. Re-install or update the ida ReRouter. If problem persists then contact your point of purchase. Printer is not ready (IRQ on remote printer) An IRQ message has been discovered in the remote printer.
Page 67
Retry and if the problem persists contact your point of purchase. Semaphore handling error [...] An OS/2 system call has failed. Re-start the ida ReRouter, re-start the OS/2. If problem persist, contact your system administrator. Named Pipe handling error [...] An OS/2 system call has failed.
'???? 0010 1' (Dataflow, trace file wrapped [128kB]) '???? 0010 0' (Dataflow, trace file not wrapped) Default: '0' (OFF) NOTE: The trace file is basically for internal i-data use only. Thread handling error [...] An OS/2 system call has failed.
Appendix Section ida ReRouter 10. List of Abbreviations APPC PING PPD/PPR TCP/IP LAPS Advanced Program to Program Communication Internet Protocol Logical Unit Packet InterNet Group Presentation Manager PPD (Page Printer Daemon) and PPR (Page Printer Remote) are bi-directional print protocols for AFP...
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. The configuration file is not used for normal configuration and operation.
Page 71
Appendix Section ida ReRouter KEYWORD: DESCRIPTION: RANGE: DEFAULT: KEYWORD: DESCRIPTION: RANGE: DEFAULT: KEYWORD: DESCRIPTION: RANGE: DEFAULT: "ROUTE_NAME" User defined Alias for a particular route. Alphanumerical string (A-Z, a-z and 0-9) No white spaces Max. 15 characters None "DESCRIPTION" A short description of the defined...
Page 72
Appendix Section ida ReRouter KEYWORD: DESCRIPTION: RANGE: DEFAULT: KEYWORD: DESCRIPTION: RANGE: DEFAULT: KEYWORD: DESCRIPTION: RANGE: DEFAULT: KEYWORD: DESCRIPTION: RANGE: DEFAULT: "IPADDRESS" Together IPADDRESS and PORTNO specify the actual remote application to reach The Internet Protocol address for the TCP/IP device.
Appendix Section ida ReRouter 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 Fill-In Configuration Worksheet for S/370 Networks Remote Device: _______________________ WORK-STATION: Comm. Manager/2 Configuration filename Token Ring DLC Profile Adapter number Max. link stations Max.RU size C&SM LAN ID Local Node Characteristics Network name Local node name...
Page 75
Appendix Section ida ReRouter Fill-In Configuration Worksheet for AS/400 Remote Device: _______________________ WORK-STATION: Comm. Manager/2 LAPS Configuration filename Token Ring DCL Profile Adapter number Max. link stations Max.RU size C&SM LAN ID Local Node Characteristics Network name (ID) Local node name Local Node ID Transaction Program Def.
Page 76
Appendix Section ida ReRouter Fill-In Configuration Worksheet for AS/400 COMMUNICATIONS APPCDev MANAGER /2 PROFILE Configuration filename Token Ring DCL Profile Adapter number Max. link stations Max.RU size C&SM LAN ID Local Node Characteristics Network name (ID) RMTNETID Local node name Local Node ID Transaction Program Def.
Appendix Section ida ReRouter Appendix C: i-data Products Mainframe environment ida 270x Hardware - Optra - 4039 - MIO - SIO ida PDS - 270 C/RS - LCD ida 270 C/RS ida RPP ida LS 100 ida 820 Font Pack...
Page 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.
Need help?
Do you have a question about the ReRouter and is the answer not in the manual?
Questions and answers