ESL 3270 Support
Introduction
Overview
Components of 3270/5250 Support for ESL
Connectivity with ESL Using HLLAPI
Verifying a Successful Working Connection
Using ECS: Required Procedures
Declaring the ECS Stimulus Library
Using 3270 Emulation for More Than One Application
Releasing a Session
Sharing the Emulator
Using an Additional Server Application
Using 3270/5250 Support with ESL
Configuring the ESLCMSRV.INI file
Overview of the ESLCMSRV.INI file
Specifying the HLLAPI DLL Filename
Obtaining the Emulator Window Handle
Pattern Matching on Window Captions
Regular Expressions
Specifying a HLLAPI function
3270/5250 Session and Screen Concepts
Session Names
Session States
Field-Oriented and Line-Oriented Screens
Characteristics of Field-Oriented (Formatted) Screens
Attributes
Field Types
Color Attribute
Character Position
Retrieving Field Information
ECS Subroutines
Overview
Reading Information from the Screen
Writing to the Screen
Controlling the Emulator Window
Synchronizing with the Host
Defining Your Watch Criteria
Executing Your Watch
ECS Subroutines and ESL Built-in Functions
Summary of ECS Subroutines
Connecting and Disconnecting Sessions:
EcsConnect
EcsDisconnect
Examining the Buffer:
EcsReadField
EcsGetFieldCount
EcsGetFieldLength
EcsGetFieldType
EcsReadFieldRowCol
EcsGetFieldAttribute
EcsGetCursorPosition
EcsGetFieldNumber
EcsGetFieldPosition
EcsReadLine
EcsGetLastNonBlankLineNumber
EcsReadScreen
EcsReadColoredScreen
Synchronization:
EcsClearWatch
EcsWatchForScreenSize
EcsWatchForCursorAt
EcsWatchForCursorNotAt
EcsWatchForIIOff
EcsWatchForStringAt
EcsWatchForStringNotAt
EcsWatch
EcsWatchAndWait
Communicating with the Host:
EcsSetAutoWait
EcsPressKey
EcsPressENTER
EcsTypeString
EcsEnterString
EcsWriteField
EcsWriteFieldRowCol
Controlling the Emulator Window:
EcsSetEmulatorWindow
EcsEmulate
EcsEmulateAndWatch
Miscellaneous Subroutines:
EcsReStart
EcsCheckIndicator
EcsGetSessionStatus
EcsGetSessionInfo
EcsGetError
EcsGetCurrentSession
Error Handling
Using ESCGetError
Returning the Host to a Specific Screen
Error Messages
ECS_E_BADCOMBO (31)
ECS_E_BADCOMMAND (30)
ECS_E_BADINDICATOR (22)
ECS_E_BADKEYCODE (27)
ECS_E_BADSCRID (11)
ECS_E_BADTIME (28)
ECS_E_CANTINIT (9)
ECS_E_CANTLOAD (23)
ECS_E_ERRORFREE (0)
ECS_E_FILLSWITCH (26)
ECS_E_FLDATTR (25)
ECS_E_FLDNUM (1)
ECS_E_INUSE (16)
ECS_E_LINENUM (3)
ECS_E_MULTWATCH (21)
ECS_E_NOERROR (32)
ECS_E_NOFLDS (7)
ECS_E_NOMEMORY (12)
ECS_E_NOSTATUS (24)
ECS_E_NOTAVAIL (13)
ECS_E_NOTCONN (14)
ECS_E_NOTINIT (17)
ECS_E_NOT3270SESSION (19)
ECS_E_PROTFLD (2)
ECS_E_ROWCOL (5)
ECS_E_SCRIDFILE (10)
ECS_E_SCRNAREA (4)
ECS_E_SENDKEY (6)
ECS_E_SESSNAME (15)
ECS_E_WATCH (8)
ECS_E_WATCHSTRING (29)
ECS_E_WRONGKEY (18)
Reserved Variables and Constants
Global Variables
Reserved Constants
Sample Programs and 3270/5250 Screens
Sample 3270/5250 Screen "A"
Sample 3270/5250 Screen "B"
Sample Program
Watch Command String Code
Managing the Watch Command Strings in a Text File
Building ECS Watch Commands
Reading Watch Command Strings into an ESL Program
EcsWatchAndWait Code Segment
Host Field Validation Code Sample
FAQs
Q1 How Do I use an emulator with more than one application?
Q2 How do I configure a Windows 3270/5250 Workstation ?
Q3 What does Error 13 from EcsEmulate in Windows mean?
Q4 How can I extend ESL's 3270 Functionality: Watch For String Anywhere?
Q5 How can I edit entries in the ESLCMSRV.INI?
Q6 Miscellaneous 3270 and 5250 Questions and Answers

© 2011 ESL Syndetic Ltd.