ClipServ - tcp/ip clipboard server for OS/2 2.x

   by Patrick Mueller (pmuellr@vnet.ibm.com)

(c) Copyright International Business Machines Corporation 1993.
All rights Reserved.

-------------------------------------------------------------
Usage
-------------------------------------------------------------

ClipServ.exe is a PM program that acts as an OS/2 tcp/ip server for the
system clipboard.  A remote client can request the text (CF_TEXT)
contents of the clipboard from the system ClipServ.exe runs on.  A
sample client for XEDIT on CMS is provided as an example.  This client,
GETCLIP XEDIT, provides a paste function for XEDIT.

To start ClipServ.exe on OS/2, run it with the port number it will
watch as it's only parameter.  The port number should be an unused port
number on your machine.  The netstat program can show you ports in use
on your machine, and a list of well-known ports is available in the
OS/2 tcp/ip documentation.  These port numbers should be avoided.
Generally port numbers > 1000 are unused.  Port numbers are 16 bit
numbers, so may be as large as 65535.

   ClipServ port

A dialog will be created (minimized) that contains version information
and the host address and port.

To run the GETCLIP client for XEDIT, you need to pass the internet
address and port of the server the first time.  This info will be
stored in your LASTING GLOBALV for future reference.  Any future
invocations of GETCLIP will use this information, and you can pass
parameters to GETCLIP at any time to change the defaults.

If you have problems accessing the host, try using the dot-decimal
address instead of the domain address.

GETCLIP will copy the clipboard text at the cursor location.

Warning: there is no password protection, so anyone that knows your
port number being used by ClipServ will be able to access your
system clipboard (for reading only).

-------------------------------------------------------------
Requirements
-------------------------------------------------------------

On the OS/2 side, you need tcp/ip, 1.2.1 or greater.

For the GETCLIP XEDIT macro, you need the REXX/SOCKETS package from
Arthur Ecock.  This package has been tested with the REXX/SOCKETS 2.01
code.

REXX/SOCKETS is on LISTSERV at CUNYVM and you need BITNET-access to get
to it.  To obtain it, use the command:

  TELL LISTSERV AT CUNYVM GET RXSOCKET $PACKAGE

and you will receive the package file.  Similarly, you can send a GET
for each file you want.  The package includes some optional files and
also the files from REXXWAIT.  (Most probably, there is a way to get
all files in the package with one command, but I do not know it.  If
you send a HELP command to the LISTSERV machine, you will get a list of
valid commands.)

For IBMers, REXX/SOCKETS is available on the VMTOOLS disk, as
the REXXSOCK PACKAGE.

-------------------------------------------------------------
Versions
-------------------------------------------------------------

   version 1.00 - Aug 24 1993
      - GETCLIP XEDIT upgraded to use Arthur Ecock's REXX/SOCKETS
        package.
      - change to the protocol - no longer compatible with older
        versions

   version 0.02 - Aug 23 1992
      - dialog does not stop System Shutdown anymore
      - now displays icon when minimized
      - fix to GETCLIP to fix command resolution problems

   version 0.01 - Aug 21 1992
      - initial release (available by request)

-------------------------------------------------------------
Comments, questions, etc.
-------------------------------------------------------------
   pmuellr@vnet.ibm.com (vnet node carvm3)