Nortel Networks manual Getting started, Before using the VT100 Gateway

Page 40

3-1

Chapter 3: Getting started

Before using the VT100 Gateway

Before you can use the VT100 Gateway, you must complete these tasks:

•If necessary, install a multiport adapter board and expander box.

•Create the action and screen templates necessary to navigate through the host application and return the desired information (see Chapter 2).

•Create the screen.conf, trs.conf, vt100.ctl, and com.conf files (described in this chapter).

•Before starting IVR 2.0/I, cd to the /u/ivr/exe directory on the application processor and execute the ./trs -ccommand. This will verify that the VT100 Gateway has been installed and configured correctly, and that the screen and action templates have the appropriate syntax.

•Start IVR 2.0/I on the application processor. The TRS process is automatically started when you issue the MIVR start command.

If you are going to connect to the host computer via modem, you will have to configure the modem with the correct settings, attach the modem to the communication port, and dial up the host computer. Also make sure that DIAL_UP is specified in the com.conf file (discussed later).

During startup, the trs.log file remains empty unless the verbose option (-v) is added. To debug the application put the TRS process into debug mode. Check the trs.log file or the trs.tmp file for errors. To put the TRS process into verbose mode go to /u/ivr/startup and change the ./trs -b line so that it reads

./trs -b -v.

Meridian IVR VT100 Gateway Development Guide Product release 2.0/I

Image 40

Contents Meridian IVR February Publication historyIii Contents IVR 2.0/I call flow interface Appendix a Host error messagesGlossary Glossary-1 List of figures List of procedures List of tablesAbout this guide How to use this guideWho should use this guide Appendix a Host error messages Additional Nortel manualsConventions used in this guide IVR 2.0/I call flow interfaceAbout the VT100 Gateway VT100 terminalTerminals connected to a host computer Vt100 VT100 application screen sampleMeridian IVR 2.0/I VT100 Gateway configuration VT100 Gateway softwareTRS communication process 6About the VT100 Gateway Template files Determining the required transactions2Template files Shows how screen templates relate to action templates Customer follows this sequence to retrieve dataAction and screen templates Procedure Accessing transaction information Action templatesAction template syntax Action template syntax#comment Action template for accounting applicationAction-name Reset-actionApp-name Reset-action template sequence sample Reset-action template sample Logout-actionLogout action flow Screen-template Manual mode optional fieldLogout-action template sample Screen templates Screen showing fields and the system prompt Screen template syntax Application screen for accounting applicationScreen template syntax Screen template for accounting application Screen-name Validation-tag offsetValidation-tag Field-descriptorRow,column ﬁeld-name ﬁeld I/O Field-descriptor syntaxTemplate files $num Valid ﬁeld I/O entries Entry DescriptionText Key-descriptor Key-descriptor line syntaxTAB Valid key namesSleep-descriptor optional Sleep-descriptor syntaxInitial-action templates Before using the VT100 Gateway Getting startedScreen.conf file Begin string optional KeywordEnd string Setting up the trs.conf file Screen.conf fileBoard-number Session-numberInitial-template Initial-action template Initial-action TemplateProtocol HeartbeatExample trs.conf File Setting up the vt100.ctl file Trs.conf file for accounting applicationVt100.ctl file syntax Vt100.ctl file for accounting applicationSetting up the com.conf file TRS default communication settingsDevice-name Terminal-typeIxon Baud Rate ParityComplete sample transaction Initial-action templateInitial-action template for accounting application TemplatesGetting started 16Getting started Action template performing a transaction 18Getting started Reset-action template for accounting application Action TemplateLogout-action template for accounting application Accessing the mainframe IVR 2.0/I call flow interfaceSetting the Comi cell parameters Activating the gateway from a Comi cellComi cell parameter window Call Audit Enabled Comi cell nameCall Audit Information Comi action templateComi cell buffer count Comi cell timeoutComi cell input buffers Setting the Como cell parameters Como cell name Como cell parameter windowComo cell buffer count Como cell blocking?Como cell output buffers Como cell Como cell branchesBranches of the Como cell Reason the branch would be taken Setting the Coma cell parameters Coma cell in the Cleanup branch of a Start cellAn application using the COMI, COMO, and Coma cells 12IVR 2.0/I call flow interface Application cell functions Step Description 14IVR 2.0/I call flow interface COMI/COMO cell parameters, TRS templates, and VT100 screens Templates Corresponding ScreensAppendix a Host error messages Terminal Resource Server TRS MessagesERR Loadruntimeconfig ERR CreatescreentemplatesERR Createactiontemplates ERR OrdertemplatesERR All available sessions are non-operational ERR xx Sessions are OperationalERR Unable to create Session Object Instance ERR Unable to create Process Object InstanceERR xx is not a keyword ERR BD xx SS xxx ERR start host notifyERR CH=xx ERRRequest does not contain action name ERR CH= xx ERRInvalid action nameERR CH=xx ReadinputERR Createtimerinstance ERR CH=xx ReadUpdateERR CreatetimerinstanceERR CH=xx BD xxx SS xxx ReadinputERR copy PS ERR CH=xx BD xxx SS xxxx ReadinputERR Query cursorERR CH=xx ProcessERR Syntax error for variable operation ERR Send Aid key failedERR CH=xx ProcessERR write to screen ERR msgwaitstartERR Received a service abort from the TRS Server ERR Received a Service Free MessageERR 3270 Envoy Process Startup ERR Process StartupERR Server Node file trs.node does not exist ERR CH=xx illegal CommandERR Invalid Aid key specified use the Enter Key ERR Sendwithaid Connect to session xx failed ERR Sendwithaid failed with return codeERR Writetoscreen Connect request to session xx failed ERR Writetoscreen Writing of input xx failed10Host error messages ERR Createidletimer Idle timer memory allocation failed ERR Configuration file trs.conf not foundERR No Application field in trs.conf ERR An invalid entry in the trs.confERR Protocol missing, specify 3270 or VT100 ERR Incorrect syntax for ping actionERR Invalid Protocol xxx, protocol ERR Invalid entry non-numericERR First LU cannot be less than ERR Last LU cannot be greater thanERR An Invalid Board# xx is specified ERR Couldn’t create appl objectERR In ../3270/lubuf.datloginid xx exceeds xxx characters ERR In ../3270/buf.datpassword xx exceeds xxx charactersERR in map.datSession xx not defined in trs.conf ERR read data from file ../3270/lubuf.datERR In ../3270/lubuf.datlubuf1 exceeds xx characters ERR In ../3270/lubuf.datlubuf2 exceeds xx charactersERR Unable to open screen file ERR Memory allocation failure for Screen entryERR Parse string xx of screen ERR Field id xx exceeds xxx charactersERR Open action file xx failed ERR Memory allocation failure for Action entryERR Read head data from action file ERR Read screen name from action fileERR Settimer Error setting interval timer struct ERR Unable to open Information LoggerERR Buffer size is greater than ERR No row/column delimiter for screen templateGlossary VT100 Gateway termsSystem administrator ChannelComa Cell Comi CellVT100 terminal TransactionGlossary-3 Page February