home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 29 Fixes_o / 29-Fixes_o.zip / ehll16.zip / SP016.DOC < prev    next >
Text File  |  1992-12-15  |  6KB  |  146 lines
  1. SP016                 SelectPak                  December 15, 1992
  2.  
  3.  
  4.  
  5.     ===============================================================
  6.     README for EHLLAPI Virtual Device Driver Windows* support
  7.     ===============================================================
  8.                    Windows is a trademark of Microsoft Corporation.
  9.  
  10.  
  11. SP016 introduces an enhanced virtual device driver (VHAPI) which
  12. adds DOS and Windows* EHLLAPI support to the existing ES 1.0
  13. support. It also includes a fix for (APAR JR06329).
  14.  
  15.  
  16. This document contains the following information:
  17.  
  18.    o Packaging
  19.  
  20.    o Installation
  21.  
  22.    o Usage
  23.  
  24.    o Windows EHLLAPI function call syntax
  25.  
  26.    o APAR fix information
  27.  
  28.    o VHAPI system structure
  29.  
  30.  Packaging
  31.  =========
  32.  
  33.    SP016.DOC  ;This document
  34.    SP016.CMD  ;SP016 Install tool (REXX)
  35.    SP016.ZIP  ;PKZIP file contents below:
  36.      VHAPI.OS2  ;The EHLLAPI virtual Device Driver
  37.      PCSHLL.DLL  ;Windows EHLLAPI interface DLL
  38.      SYSLEVEL.ACS  ;Syslevel Update file
  39.   ** DOS Samples
  40.      SAMPLE\DOSSAMPL\PCSSAMP.EXE   Sample DOS .EXE file
  41.                     \HAPI_C.H      Include File
  42.   ** Windows Samples
  43.      SAMPLE\WINSAMPL\HLLTEST.EXE
  44.                     \PCSSTUB.EXE
  45.                     \PCSWSAPI.DLL
  46.                     \HAPI_C.H      Include file
  47.  
  48.  
  49.  Installation
  50.  ============
  51.  
  52.       Type SP016 at an OS/2 command prompt to invoke SP016.CMD. This
  53.       will prompt you through the installation process.
  54.  
  55.       When you have completed, VHAPI.OS2 should have been placed in
  56.       the CMLIB and PCSHLL.DLL should have been placed in \OS2\DLL
  57.  
  58.       Insure that the following statement exists in your CONFIG.SYS.
  59.  
  60.        DEVICE=d:\CMLIB\VHAPI.OS2
  61.  
  62.     Where d is the appropriate drive for your system.
  63.  
  64.     The program VHAPINST has been provided with Extended Services
  65.     to automatically add (or delete) this statement in CONFIG.SYS
  66.  
  67.     Simply type VHAPINST at an OS/2 command prompt to add the DEVICE
  68.     statement, or VHAPINST /D to delete it.
  69.  
  70.     Note: You must restart your workstation after making changes to
  71.           CONFIG.SYS.
  72.  
  73.  
  74.  Usage
  75.  =====
  76.  
  77. To execute a Windows EHLLAPI application in the WIN-OS/2 session, PCSHLL.DLL
  78. provided by this package is prerequisite.  It needs to be called by a Windows
  79. EHLLAPI application running in the WIN-OS/2 session.
  80.  
  81. VHAPI accepts upto 16 hllapi sessions at a time.  If an EHLLAPI application
  82. attempts to establish the 17th hllapi session, VHAPI returns the system error
  83. code (rc=9).
  84.  
  85. Note that this DLL file is the interface module between a Windows EHLLAPI
  86. application and the OS/2 Communications Manager.  If running in the pure
  87. Windows environment, use the DLL path indicating where the Personal
  88. Communications/3270 has been installed.
  89.  
  90.  
  91. Windows EHLLAPI function call syntax
  92. ====================================
  93.  
  94. PCSHLL.DLL only accepts the same syntax as Personal Communications/3270
  95. Version 2.0 provides, though the Version 3.0 offers the additional syntax for
  96. EHLLAPI function call.
  97.  
  98.  
  99.   void FAR PASCAL hllapi(LPINT, LPSTR, LPINT, LPINT);      /*import hllapi*/
  100.  
  101.   hllapi ((LPINT) &iHLLAPIFunction,  /*pointer to EHLLAPI function number */
  102.           (LPSTR) zDataString,       /*pointer to Data String             */
  103.           (LPINT) &iStringLength,    /*pointer to Data String length      */
  104.           (LPINT) &iReturnCode     );/*pointer to retrun code             */
  105.  
  106.  
  107.  
  108.  APAR fix
  109.  ========
  110.  
  111. APAR#:       JR06329
  112. SUMMARY:     Using VHAPI supplied with ES 1.0, NOEAB parameter on the
  113.               Copy_PS_To_String does not function.
  114.  
  115.  
  116. VHAPI system structure
  117. ======================
  118.  
  119.  The next illustrates the VHAPI system structure.
  120.  
  121.  
  122.    VDM_1  (WIN-OS/2 Desktop)     VDM_2(WIN-OS/2 Window)    VDM_3(DOS Window)
  123.  ┌───────────────────────────┐  ┌─────────────────────┐   ┌─────────────────┐
  124.  │ ┌──────────┐┌───────────┐ │  │     ┌─────────┐     │   │   ┌─────────┐   │
  125.  │ │ Windows  ││Windows    │ │  │     │ Windows │     │   │   │   DOS   │   │
  126.  │ │ EHLLAPI  ││EHLLAPI    │ │  │     │ EHLLAPI │     │   │   │ EHLLAPI │   │
  127.  │ │ appl. [1]││appl.[2]   │ │  │     │ appl.[3]│     │   │   │ appl.[4]│   │
  128.  │ └──────────┘└───────────┘ │  │     └─────────┘     │   │   └─┬──────┬┘   │
  129.  │ ┌───────────────────────┐ │  │    ┌───────────┐    │   │     │      │    │
  130.  │ │      PCSHLL.DLL       │ │  │    │ PCSHLL.DLL│    │   │     │      │    │
  131.  │ └───────┬───────┬───────┘ │  │    └──┬──────┬─┘    │   │     │      │    │
  132.  └─────────┼───────┼─────────┘  └───────┼──────┼──────┘   └─────┼──────┼────┘
  133.            │       │                    │      │                │      │
  134.     INT 7Fh│       │IRET         INT 7Fh│      │IRET     INT 7Fh│      │IRET
  135.    AX=0104h│       │            AX=0104h│      │        AX=0104h│      │
  136.            │       │                    │      │                │      │
  137.  ┌─────────┴───────┴────────────────────┴──────┴────────────────┴──────┴────┐
  138.  │                EHLLAPI Virtual Device Driver (VHAPI)                     │
  139.  ├───────────┬───┬──────────┬────┬──────────┬────┬──────────┬───────────────┤
  140.  │ EHLLAPI[1]│   │EHLLAPI[2]│    │EHLLAPI[3]│    │EHLLAPI[4]│...........    │
  141.  ├───────────┴───┴──────────┴────┴──────────┴────┴──────────┴───────────────┤
  142.  │                              LLAPI                                       │
  143.  ├──────────────────────────────────────────────────────────────────────────┤
  144.  │                           3270 Emulator                                  │
  145.  └──────────────────────[Communications Manager]────────────────────────────┘
  146.