home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / tt2man.zip / ttintro.doc < prev    next >
Text File  |  1994-06-10  |  18KB  |  396 lines
  1.  
  2.                              TABLE OF CONTENTS                              
  3.  
  4.  
  5.           1. Introduction
  6.             1.1 Product Overview
  7.             1.2 Product Description
  8.               1.2.1 The Customization File
  9.               1.2.2 Communications Support
  10.               1.2.3 Terminal Emulation
  11.               1.2.4 The Phone Book
  12.               1.2.5 Phone Book Entry Definitions
  13.               1.2.6 Modem Configuration Files
  14.               1.2.7 EHLLAPI Support
  15.               1.2.8 File Transfer
  16.               1.2.9 AUTOPILOT Programming Language
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                               1. Introduction                               
  23.  
  24.  
  25.                             1.1 Product Overview                            
  26.  
  27.  
  28. TalkThru  is  a Presentation Manager based asynchronous, TCP/IP  or  Netbios
  29. Terminal  Emulation product.  Release 1.03 of TalkThru is a  16-bit  version
  30. designed for OS/2 release 1.2 and above.  Release 2.3 of TalkThru is a  full
  31. 32-bit  version  developed  specifically for OS/2 release  2.x.   This  User
  32. Guide  is  designed to provide the necessary information for  releases  1.03
  33. and 2.3 of TalkThru For OS/2.
  34.  
  35. TalkThru  has  been developed to expand the host systems available  to  OS/2
  36. workstations  by providing Terminal Emulation plus an EHLLAPI  interface  to
  37. many  host  environments  not  readily  available  to  OS/2.  The  protocols
  38. supported by TalkThru include:
  39.  
  40.     Generic TTY
  41.     ANSI
  42.     VT52/100/220/320/340
  43.     HP2393A/HP2397A
  44.     TELEVIDEO
  45.     TYMNET78
  46.     TYMNET79
  47.     WYSE 50
  48.     IBM3101
  49.  
  50. TalkThru will communicate through:
  51.  
  52.   o A directly connected COM Port.
  53.   o A COM Port redirected to the IBM LAN Shared Serial Device Support.
  54.   o The Communications Manager's ACDI.
  55.   o ACDI redirected to an IBM LANACS Modem Pool.
  56.   o IBM's TCP/IP for OS/2.
  57.   o OS/2 LAN Requestor, LAN Enabler or Novell's Netbios Interface
  58.  
  59. Although  TalkThru  can cooperate closely with  the  Communications  Manager
  60. without  impacting its function or performance, The  Communications  Manager
  61. is not required for successful TalkThru operation.
  62.  
  63. TalkThru  has implemented an EHLLAPI interface which is compatible with  the
  64. one used  to  direct  the     Communications  Manager.   This  allows  other
  65. development  languages  (i.e.  EASEL, The  Applications  Manager,  etc.)  to
  66. direct the asynchronous connections provided by TalkThru in the same  manner
  67. they can 3270 sessions with the Communications Manager.
  68.  
  69. TalkThru  File  Transfer supports all the popular  protocols  including  IBM
  70. IND$FILE  and Kermit.  It also has support for Drag And Drop such that  file
  71. transfer operations can be automated.
  72.  
  73. TalkThru includes a sophisticated development programming language  entitled
  74. AUTOPILOTTM  which allows OS/2 Workstation Developers to quickly and  easily
  75. automate  all host activity, whether the host is a TalkThru session  or  any
  76. session  available  through the IBM standard EHLLAPI  interface.   AUTOPILOT
  77. can create  simple  Text  Windows      for  displaying  fixed  font  textual
  78. information  or  can  be used to build  sophisticated  Presentation  Manager
  79. Dialogs.   AUTOPILOT also supports Dynamic Data Exchange (DDE) to allow  the
  80. development  of sophisticated cooperative applications with an easy to  use,
  81. easy to maintain language.
  82.  
  83.  
  84.  
  85.  
  86.                           1.2 Product Description                           
  87.  
  88.  
  89. The TalkThru components can be categorized into the following general areas:
  90.  
  91.     1.2.1  The Customization File
  92.     1.2.2  Communications Support
  93.     1.2.3  Terminal Emulation
  94.     1.2.4  The Phone Book
  95.     1.2.5  Phone Book Entry Definitions
  96.     1.2.6  Modem Configuration Files
  97.     1.2.7  EHLLAPI Support
  98.     1.2.8  File Transfer
  99.     1.2.9  AUTOPILOT  Programming Language
  100.  
  101. ┌──────────────────────────────┐
  102. │ 1.2.1 The Customization File │
  103. └──────────────────────────────┘
  104.  
  105.   TalkThru  determines the specifics of the OS/2 environment it  is  running
  106.   under  by referencing a text file called the TalkThru Customization  File.
  107.   This file contains the following information:
  108.  
  109.    - the names of the directories TalkThru was installed in
  110.    - whether the EHLLAPI interface is to be used
  111.    - whether the Communications Manager is present
  112.  
  113.   The Customization  File is updated by selecting System Configuration  from
  114.   the Utilities   pull down menu on any TalkThru Phone Book Window (see  The
  115.   Phone  Book  below)  and  it is the  only  required  parameter  passed  to
  116.   TalkThru at initialization.
  117.  
  118. ┌──────────────────────────────┐
  119. │ 1.2.2 Communications Support │
  120. └──────────────────────────────┘
  121.  
  122.   TalkThru  provides  communications  support  to a  wide  variety  of  host
  123.   computers  that  are  not traditionally available  to  OS/2  Workstations.
  124.   Today,  TalkThru  may communicate quickly and easily to  any  host  system
  125.   that will support any of the following Terminal Protocols:
  126.  
  127.       Generic TTY
  128.       ANSI
  129.       VT52/100/220/320/340
  130.       HP2393A/HP2397A
  131.       TELEVIDEO
  132.       TYMNET78
  133.       TYMNET79
  134.       WYSE 50
  135.       IBM 3101
  136.  
  137.   TalkThru will communicate to these host systems through:
  138.  
  139.     o a COM Port
  140.     o a COM Port redirected to IBM LAN Shared Serial Device Support
  141.     o the Communications Manager's ACDI
  142.     o ACDI redirected to an IBM LANACS Modem Pool
  143.     o IBM's TCP/IP for OS/2
  144.     o OS/2 LAN Requestor, LAN Enabler or Novell's Netbios Interface
  145.  
  146.   TalkThru  will  coexist with the Communications Manager, if  desired,  but
  147.   does not require the Communications Manager for successful operation.   If
  148.   the Communications  Manager  is  present,   TalkThru  will  intercept  ALL
  149.   EHLLAPI  requests  to  the Communications Manager and route  them  to  the
  150.   appropriate  TalkThru session or the Communications Manager  as  required.
  151.   This  allows  multiple   Communications   Manager  sessions  and  multiple
  152.   TalkThru sessions to be active concurrently.
  153.  
  154.   TalkThru  is  constructed such that the Terminal Protocol  being  used  is
  155.   entirely separate from:
  156.  
  157.     - Terminal Emulation
  158.     - the EHLLAPI interface
  159.     - the Device Interface (COM Port, ACDI, TCP/IP, Netbios)
  160.     - File Transfer
  161.  
  162.   If your  connection is through a COM Port or the Communications  Manager's
  163.   ACDI,  you may describe the modem attached to this COM Port and  Associate
  164.   this with all Terminal Sessions from a single centralized dialog.
  165.  
  166. ┌──────────────────────────┐
  167. │ 1.2.3 Terminal Emulation │
  168. └──────────────────────────┘
  169.  
  170.   The Terminal  Emulator  within   TalkThru    allows  for  easy,  intuitive
  171.   modifications  by  providing  numerous dialogs available  from  pull  down
  172.   menus  on  the terminal emulator screen. The changes that can be  made  in
  173.   this  manner  include, not only the specifics of the  connection  (device,
  174.   parity,  baud,  etc.), but also many of the aesthetics.   Amongst  others,
  175.   the individual user can specify:
  176.  
  177.    - What is to appear on the terminal emulator status line.
  178.  
  179.    - What foreground and background colors are to be mapped to the  terminal
  180.      protocol  field  attributes   (i.e.   High  Intensity,  Low  Intensity,
  181.      Protected, etc.).
  182.  
  183.    - Which  font should be used.  Several fixed pitch fonts are  distributed
  184.      with  the  TalkThru product allowing a Terminal Emulator screen  to  be
  185.      just  one  window on the desktop or the entire desktop, but  any  fixed
  186.      pitch font available on your OS/2 system can be selected.
  187.  
  188.    - What  action  the  Left  and Right MOUSE  Buttons  perform.   This  can
  189.      include:
  190.   
  191.           positioning the cursor
  192.           sending the text under the MOUSE
  193.           sending the host key associated with the text under the MOUSE
  194.  
  195.   Any of these parameters may be modified temporarily to view their  effects
  196.   or can  be saved as permanent settings for a specific  Terminal  Emulation
  197.   environment.    There is also a DEFAULT setting for each of these  if  you
  198.   wish to restore any environment to the distributed settings.
  199.  
  200.   The TalkThru  Terminal  Emulator  also allows you to  specify  up  to  144
  201.   Emulator  Buttons which appear under the terminal emulator screen.   These
  202.   buttons  appear up to 12 buttons per row on up to 12 rows.  These  buttons
  203.   are an  integral  part of HP 2393A/HP 2397A Terminal  Emulation,  but  are
  204.   also available with any of the other protocols supported by TalkThru.
  205.  
  206.   These  Emulator  Buttons  can  trigger any keys  that  might  normally  be
  207.   triggered by the PC Keyboard.  An example of this might be the 3270 Keys:
  208.  
  209.       PF1-24
  210.       CLEAR
  211.       ERASE EOF
  212.       PA1-3
  213.  
  214.   Or, the Emulator Keys may trigger other activities such as:
  215.  
  216.       - invoking AUTOPILOT programs to automate host sessions
  217.       - invoking OS/2 programs that can now run as separate OS/2 Sessions
  218.       - sending PC Keystrokes to the host system to start host sessions
  219.       - displaying another row of Emulator Buttons in a menu hierarchy
  220.  
  221.   The Emulator  Buttons  provide  a   useful  mechanism  for  building  OS/2
  222.   Professional Workstation environments which require little or no  keyboard
  223.   skills.
  224.  
  225.   The TalkThru  Terminal  Emulator  also supports the  OS/2  Drag  And  Drop
  226.   feature.    If  a  file name is dragged from the  OS/2  File  Manager  and
  227.   dropped  onto  the  Terminal Emulator, you may specify  a  command  to  be
  228.   executed.    This  feature will most commonly be used  to  invoke  a  file
  229.   transfer operation.
  230.  
  231. ┌──────────────────────┐
  232. │ 1.2.4 The Phone Book │
  233. └──────────────────────┘
  234.  
  235.   The main  component  of TalkThru that always appears on the desktop  is  a
  236.   Phone  Book.   The Phone Book is an OS/2 window which  lists  the  various
  237.   TalkThru  connections  that are available to this OS/2  Workstation  user.
  238.   If desired, multiple Phone Books can be active concurrently.
  239.  
  240.   It is  from the Phone Book that all TalkThru sessions are initiated.   Any
  241.   number  of  sessions from any number of Phone Books can be active  at  any
  242.   given  time.  The only limitation being the number of concurrent  sessions
  243.   that  can be supported by your communications hardware.  For  example,  if
  244.   you only  have one Modem attached to a single COM Port, you  probably  can
  245.   have  only a single session active.  But if you have a LAN Modem  Pool,  a
  246.   TCP/IP  network, or Netbios connected hosts, you may be able to support  a
  247.   large number of connections concurrently.
  248.  
  249.   The Phone  Book contains several dialogs from Pull Down Menus which  allow
  250.   you to:
  251.  
  252.       Open other Phone Books
  253.       Add/Delete/Change Phone Book Entries
  254.       Define/Modify COM Port Configurations
  255.       Terminate TalkThru
  256.  
  257. ┌────────────────────────────────────┐
  258. │ 1.2.5 Phone Book Entry Definitions │
  259. └────────────────────────────────────┘
  260.  
  261.   Each TalkThru session must be described by a Phone Book Entry  Definition.
  262.   The information contained in a Phone Book Entry Definition includes:
  263.  
  264.     - the device being used (COM Port, ACDI, TCP/IP)
  265.     - connection specifics like BAUD, PARITY, etc.
  266.     - the terminal protocol to use (TTY, VTxxx, Hpxxxx)
  267.     - the interface timing for Clipboard and File Transfer
  268.     - the mapping of the PC Keyboard to host keys
  269.     - the number and meaning of any defined Emulator Buttons
  270.     - the items, color and font which appear on the terminal emulator screen
  271.     - the name of any EASEL or AUTOPILOT "script" or any EXE file you  would
  272.       like to invoke whenever this connection is started
  273.  
  274.   Since  the variety of host systems and associated protocol converters  can
  275.   vary tremendously regarding this information, the accuracy of these  files
  276.   is critical to the successful operation of any TalkThru session.   Because
  277.   of this, when new entries are added to a Phone Book, rather than have  you
  278.   build them from scratch, you are offered the list of available Phone  Book
  279.   Entry Definitions to be used as MODELS.
  280.  
  281.   This  allows  you to define a particular connection just  once  and  apply
  282.   that  definition as a model to create other connections.   Also,  TalkThru
  283.   is distributed  with  a wide variety of Phone Book Entry  Definitions  for
  284.   commonly  accessed  services  (Compuserv, Dow  Jones)  and  host  protocol
  285.   converters.
  286.  
  287.   Phone  Book  Entry Definitions are created initially when a new  entry  is
  288.   made  to a Phone Book, but can be modified either from the Phone  Book  or
  289.   Terminal Emulator window.
  290.  
  291. ┌─────────────────────────────────┐
  292. │ 1.2.6 Modem Configuration Files │
  293. └─────────────────────────────────┘
  294.  
  295.   If you  are  using   TalkThru's    OS/2     Standard  COM  Driver  or  the
  296.   Communications  Manager's ACDI support, you need to describe  to  TalkThru
  297.   the type  of  modem  (HAYES,  etc.) connected  to  that  COM  Port.   This
  298.   information  is stored in a Modem Configuration File and is referenced  by
  299.   every Phone Book Entry that indicates that COM Port as it's device.
  300.  
  301.   Modem  Configuration  is   performed   by  selecting  Modem  Configuration
  302.   (release  1.03) or Device/Modem Configuration... (release 2.2  and  above)
  303.   from the Utilities pull down menu from any Phone Book window.
  304.  
  305. ┌───────────────────────┐
  306. │ 1.2.7 EHLLAPI Support │
  307. └───────────────────────┘
  308.  
  309.   The TalkThru  EHLLAPI interface has been developed to be  compatible  with
  310.   the standard  IBM  EHLLAPI interface to the Communications  Manager.   The
  311.   majority  of  EHLLAPI calls will work transparently across  all  protocols
  312.   supported by the Communications Manager and TalkThru. This means that  any
  313.   Proprietary  Product  or  Development Language  (i.e.  EASEL,  REXX,  'C',
  314.   'COBOL',  etc.) that supports EHLLAPI will be able to view and direct  any
  315.   TalkThru session exactly as it does with the Communications Manager.
  316.  
  317.   One exception  to this are the EHLLAPI calls which require Field  Specific
  318.   information  (i.e. EHLLAPI Calls 30 - 34). Some terminal  protocols  (i.e.
  319.   VTxxx  and TTY) do not present field level information to the PC so  there
  320.   is no  definite field association of data. These EHLLAPI  differences  are
  321.   described  in  greater  detail  in  the  Chapter,  EHLLAPI  Support  under
  322.   Guidelines For Usage.
  323.  
  324. ┌─────────────────────┐
  325. │ 1.2.8 File Transfer │
  326. └─────────────────────┘
  327.  
  328.   The following File Transfer protocols are supported by TalkThru:
  329.  
  330.      o Ascii
  331.      o Screen Capture
  332.      o Xmodem
  333.      o Ymodem
  334.      o Zmodem
  335.      o IBM IND$FILE
  336.      o Compuserv B+
  337.      o Kermit
  338.  
  339.   Dialogs for performing all of these File Transfers are available from  the
  340.   Terminal Emulator window.
  341.  
  342. ┌──────────────────────────────────────┐
  343. │ 1.2.9 AUTOPILOT Programming Language │
  344. └──────────────────────────────────────┘
  345.  
  346.   The AUTOPILOT  Programming Language is a powerful,  interpretive  language
  347.   available  only  with TalkThru. AUTOPILOT programs, also  referred  to  as
  348.   "scripts",  may  be used to control the execution of pre-defined  sets  of
  349.   activities, either on the PC, the mainframe, or in combination.
  350.  
  351.   The AUTOPILOT  Programming Language possesses  considerable  functionality
  352.   combined with extensive flexibility. Multiple OS/2 Windows can be  defined
  353.   from  a  single  program with total control over the  size,  location  and
  354.   contents  of each. Besides simple Text Windows, Statements  and  Functions
  355.   are available  to  create  and control Action Bars, Pull  Down  Menus  and
  356.   sophisticated Presentation Manager Dialogs.
  357.  
  358.   Branching  to labels, subroutines, nested scripts, return  codes,  timeout
  359.   processing,  and error recovery facilities are all standard features.   In
  360.   addition, variables can be defined and passed from one script to  another.
  361.   Arithmetic  operations, string functions and comparisons can be  performed
  362.   on the  variables. Extended file support provides the capability  to  read
  363.   and write text files from within AUTOPILOT programs.
  364.  
  365.   Besides  the  wealth  of  functions  available  in  base  AUTOPILOT,   any
  366.   function  defined in other Dynamic Link Libraries (DLLs) can  be  declared
  367.   to AUTOPILOT and used as if they were AUTOPILOT functions.
  368.  
  369.   AUTOPILOT  applications,  besides  being used to  run  OS/2  applications,
  370.   commands or command files, can also be sophisticated scripts developed  to
  371.   combine OS/2 programs and commands with mainframe communication sessions.
  372.  
  373.   Through  the  use of AUTOPILOT, the complexities of  accessing  CMS,  TSO,
  374.   CICS,  IMS,  DOS/VSE or any mainframe environment can  be  totally  hidden
  375.   from  the  PC  user.  Transactions   or  programs  on  different  physical
  376.   computers  can  be  executed  by simply selecting an  item  from  an  OS/2
  377.   Application Menu.
  378.  
  379.   Language  statements   within      AUTOPILOT  support  all  communications
  380.   environments with an EHLLAPI interface.  This includes all  communications
  381.   supported  by TalkThru itself, as well as any 3270 communications  present
  382.   on the  OS/2 workstation. The syntax for all of these environments is  the
  383.   same,  so  that a single AUTOPILOT application can easily support  a  wide
  384.   variety of communications environments without modification.
  385.  
  386.   AUTOPILOT also supports Dynamic Data Exchange (DDE).  This support  allows
  387.   an AUTOPILOT  program  to be a DDE Client, Server or  both.   This  allows
  388.   powerful,  cooperative applications to be developed with  AUTOPILOT  which
  389.   interface  data, not only with the communications environments  available,
  390.   but also with any other applications which support the DDE interface.
  391.  
  392.   The AUTOPILOT  language  is   fully   integrated  with  TalkThru  Terminal
  393.   Emulation  and File Transfer capabilities. Programs may be  created  which
  394.   perform  the  logon  procedure  and,   in  turn,  invoke  either  terminal
  395.   emulation or file transfer.
  396.