README.TXT - Quick3270


1) Introduction
2) Contact
3) Install options
4) EHLLAPI
5) Additional options




1) Introduction
   ============
Quick3270 is a powerful, high reliable 3270/5250 terminal emulator for Windows 95/98/NT/2000/XP. Quick3270 is fast, use low memory and includes a large number of advanced features:
- 3270 Connectivity: Microsoft Host Integration Server (FMI3270) and TN3270
- 5250 Connectivity: TN5250
- GUI-on-the-fly
- Cut/Copy/Paste Data
- IND$FILE file transfer (Structured Field and Buffered)
- Transfer of list of files
- Graphic terminal emulation support (GDDM,...)
- 3287 Printer emulation (LU1 and LU3)
- OLE Automation Server
- Macro language
- Standard and enhanced EHLLAPI support
- Large number of host code pages
- English, French, German, Italian and Spanish user interfaces
- English, French and German help files
- SNMP support
- and many more...
Site license and the complete C/C++ source code are available.

Please contact me if you want to report bugs, grammar mistakes, or
give your opinion about the program, or any comments etc...



2) Contact
   =======
DN-Computing
7, rue du Foss
67150 Erstein - France
Tel: +33 675 369 257 
Fax: +33 388 982 120

e-mail : info@dn-computing.com
WWW    : http://www.dn-computing.com

EU VAT number: FR35424175123




3) Install options
   ===============

Quick3270 setup supports the following command line options: 
/Path "[Drive:][\Path\]" (to overwrite the default install path)
/Silent (no user prompt)
/noshortcut (no shortcut created on desktop)




4) EHLLAPI
   ===============
Quick3270 High Level Language API provides compatibility with IBM's
Standard and Enhanced EHLLAPI.
The Standard EHLLAPI DLL file name is EHLAPI32.DLL.
The Enhanced EHLLAPI DLL file name is PCSHLL32.DLL.
The Personal Communications Session API DLL file name PCSAPI32.DLL

The files are designed for Windows 32 bits application only.

Note: Quick3270 setup program don't add the Quick3270 program path to the PATH environment variable. 

Summary of available EHLLAPI functions (Ask us if you need not yet available functions):
 1 - CONNECTPS
 2 - DISCONNECTPS
 3 - SENDKEY
 4 - WAIT
 5 - COPYPS
 6 - SEARCHPS
 7 - QUERYCURSORLOC
 8 - COPYPSTOSTR
 9 - SETSESSIONPARAMETERS
10 - QUERYSESSIONS
11 - RESERVE
12 - RELEASE
13 - COPYOIA
14 - QUERYFIELDATTRIBUTE 
15 - COPYSTRTOPS
18 - PAUSE                           
20 - QUERYSYSTEM
21 - RESETSYSTEM
22 - QUERYSESSIONSTATUS
23 - STARTHOSTNOTIFICATION
24 - QUERYHOSTUPDATE
25 - STOPHOSTNOTIFICATION
30 - SEARCHFIELD
31 - FINDFIELDPOSITION
32 - FINDFIELDLENGTH
33 - COPYSTRINGTOFIELD
34 - COPYFIELDTOSTRING
40 - SETCURSOR
41 - STARTCLOSEINTERCEPT
42 - QUERYCLOSEINTERCEPT
43 - STOPCLOSEINTERCEPT
50 - STARTKSINTERCEPT
51 - GETKEY
52 - POSTINTERCEPTSTATUS
53 - STOPKSINTERCEPT
60 - LOCKPSAPI
61 - LOCKWINDOWSERVICESAPI

90 - SENDFILE
91 - RECEIVEFILE
99 - CONVERT

101 - CONNECTWINDOWSERVICES
102 - DISCONNECTWINDOWSERVICES
103 - QUERYWINDOWCOORDINATES
104 - WINDOWSTATUS
105 - CHANGEPSNAME
106 - CHANGEWINDOWNAME
 
List of supported options you can set with SETSESSIONPARAMETERS:
STRLEN/STREOT, EOT=c, ESC=c, AUTORESET/NORESET, TWAIT/LWAIT/NWAIT,
NOATTRB/ATTRB, EAB/NOEAB, XLATE/NOXLATE, DISPLAY/NODISPLAY,STRLEN/STREOT, EOT=c,
SRCHALL/SRCHFROM, SRCHFRWD/SRCHBKWD, NOCFGSIZE/CFGSIZE, OLDOIA/NEWOIA,
FPAUSE/IPAUSE 



How to use the EHLAPI32.DLL from a C file
----

#include "QHLLAPI.h"

HINSTANCE hHllapi_DLL;
WORD wFunction;
WORD wRetCode;

hHllapi_DLL = LoadLibrary("C:\\Program Files\\Quick3270\\EHLAPI32.dll");
hllapi = (LPFNDLL_hllapi) GetProcAddress(hHllapi_DLL, "hllapi");

wFunction = 21;   // Reset
hllapi(&wFunction, NULL, NULL, &wRetCode);
switch (wRetCode) {
   case RC_INVALID_PS:
      // 1  HLLAPI not Loaded
      break;
   case RC_SYSTEM_ERROR:  
      break;
}

...

----




5) Additional options
   ==================
A complete description of the configuration file can be downloaded from:
www.dn-computing.com/download/Quick3270%20configuration.pdf

Some options can be added to the configuration file or registry to hide  menu options. This options will even be removed from the toolbar.

Note: All file paths can contain environment-variable strings

Samples:

[Menu]
HideMenuBar=True
HideNew=True
HideOpen=True
HideOpenSame=True
HideOpenNew=True
HideSave=True
HideSaveAs=True
HideSaveAsDefault=True
HideOpenLayout=True
HideSaveLayout=True
HideRecentFileList=True

HideGUI=True                  (Hides the View / Quick GUI menu option)
HideTrace=True                (Hides the Session / Start trace menu option)
HideExit=True
HideExitAll=True

HideSettings=True
HideSessionCfg=True
HideFileTransfer=True

HideMacro=True
HideMacroEdit=True
HideMacroRecord=True

HideKeybordMap=True

DeviceNameReadOnly=True       (User can't change TN3270 device name)
ConfigurationReadOnly=True    (user can't overwrite configuration file)
UseOldKbdMap=True             (Use the old keyboard mapping tool - used before version 3.60)


[General]                     (note: path are expanded. You can include environment-variable strings "%variableName%")
szDefaultDirectory=<path>     (if specified, this path will be used for macro, trace and configuration files)
SchemeDirectory=<path>        (if specified, this path will be used for color, keypad, keyboard and GUI scheme files)

NoPrompt=True                 (No error message prompt)
KeepAliveTimer=milliseconds   (Keep alive timer interval for Telnet connections)
Keyboard122=True              (enable support of 122 keys keyboards - ask us for details)
UseSystemCaret=True           (uses the Windows system caret - used for specific input devices)

[Logging]
LogHLLAPI=True                (Log HLLAPI Calls)
LogPath=<path>                (if not specified the default path is used)

[HLLAPI]
SendKeyWait=False             (Used for HLLAPI interface compatibility with other emulators)
MemoryDump=True               (Enable a memory dump of HLLAPI calls. Used to store the last 100 HLLAPI calls)


Alarm option: Sound alarm if a given character is at the given
screen location.
(sample: Sound alarm every second if the character "U" is at location 1,1)
[Alarm] 
AlarmOn=True
Row=1
Line=1
Timer=1000
Token=U