
   PMVNCD V1.03 2017 (legowelt** release)  
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

   PMVNCD - VNC Server for OS/2 Presentation Manager by Eugene Romanenko.
   
   For more info about VNC in general, see http://www.realvnc.com

   PMVNCD is based on WinVNC 3.3.7 sources. This software is distributed 
   under the GNU General Public Licence.

   Requirements
  ~~~~~~~~~~~~~~
   - PMVNC requires at least Warp 3 with FixPak 32, or Warp 4 with FixPak 5 installed.
     ACP2/MCP2/EcS or ArcaOS 5 meet the requirement out of the box 
   - the Klibc runtime dlls V0.6.6/0.6.3 need to be installed

   Installation
  ~~~~~~~~~~~~~~   
    Unpack zip into a directory of your choice, and run install.cmd -
    folder with name "PM VNC Server" will be created on your desktop.
    No reboot is required.


   Package content
  ~~~~~~~~~~~~~~~~~
    install.cmd       - Rexx script for creating desktop objects
    pmvnchk.dll       - PM hooks dll, used for tracking display changes
                        and input simulation
    pmvncd.exe        - Main executable (server)
    vncpass.exe       - Commandline password-set utility
    pmvncfc.ico       - Icon for closed pmvnc folder (eCS-style)
    pmvncfo.ico       - Icon for opened pmvnc folder (eCS-style)
    pmvncfc_w4.ico    - Icon for closed pmvnc folder (Warp4-style)
    pmvncfo_w4.ico    - Icon for opened pmvnc folder (Warp4-style)
    pmvnci.ico        - Icon for pmvnc "about" object
    pmvnck.ico        - Icon for pmvnc "kill" object
    pmvncs.ico        - Icon for pmvnc "settings" object
    history.txt       - History of changes
    licence.txt       - GNU GENERAL PUBLIC LICENSE
    readme.txt        - This readme file
    docs/             - Folder which contain html documentation


   Usage
  ~~~~~~~
    Just run pmvncd.exe or click on "PM VNC Server" object. On first run
    it will show properties dialog, where you must specify password.

    Command-line options:

         -help              show message about cmdline options

       To send a signal to a running pmvncd instance use these options:

         -settings          show properties dialog
         -about             show about dialog
         -kill              terminate PMVNC
         -connect [<host>]  connect to listening VNC Viewer

     You can also check html documentation which is much more detailed, and
     also describes hidden ini settings.

   SysTray support      
  ~~~~~~~~~~~~~~~~~
    If you have SysTray/WPS or XCenter/eCenter with SysTray widget installed,
    you can control PMVNC through tray icon.
    Note: tray icon becomes gray when client(s) is connected.


   VNCPASS utility
  ~~~~~~~~~~~~~~~~~
    Using vncpass.exe you can set password for PMVNC from command line.
    It may be useful when you manage remote PC using telnet/ssh and want
    run PMVNC. Usage: vncpass <password>.


   What's about fullscreen sessions?
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    PMVNC doesn't support fullscreen sessions. If you switched to fullscreen
    and can't return to desktop - select "Send Ctrl-Alt-Del" in your
    VNC viewer - PMVNC will switch to desktop on receiving CAD sequence
    (not reboot!).


   Limitations/Known problems
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    - the proberties or about dialog may not load and the error "No existing instance of PMVNCD could be contacted."
   correctly when using -settings just try again
      till the dialog is is shown
    - PMVNC doesn't work with native Matrox display driver. Use SDD/SNAP.
    - Shift + <Function keys/Cursor keys> not work in OS/2 VIO.
    - Ctrl + <char> may send <char> to PM programs.
    - Some messageboxes may leave garbage on desktop.


   Where to get and how to use client software
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    VNC Viewer for OS/2 PM - http://www.sra.co.jp/people/akira/os2/vnc-pm/
    Viewers for many other operating systems - http://www.realvnc.com

    Also, any Java-enabled browser may be used as client.

    Using viewer - start it, and it will ask about VNC Server location.
    Enter server hostname or IP and add display number after a colon
    (usually 0 for OS/2 and Windows servers, 1 for UNIX servers)
    example - 192.168.4.7:0

    Using Java-enabled browser - in location, type server hostname or IP 
    and add 5800 (port number) after a colon. 
    Example - http://192.168.4.7:5800


    ** legowelt: http://www.legowelt.org
 