home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR24 / CPICTE.ZIP / CPICTELL.DOC < prev    next >
Text File  |  1992-05-14  |  7KB  |  150 lines
  1. FILE NAME:     CPICTELL.DOC
  2.  
  3. PACKAGE NAME:  CPICTELL
  4.  
  5. COPYRIGHTS:
  6.           This package contains code made available by IBM Corporation on an
  7.           AS IS basis.  Any one receiving the package is considered to be
  8.           licensed under IBM copyrights to use the IBM-provided source code
  9.           in any way he or she deems fit, including copying it, compiling it,
  10.           modifying it, and redistributing it, with or without modifications. 
  11.           No license under any IBM patents or patent applications is to be
  12.           implied from this copyright license.
  13.  
  14.           A user of the package should understand that IBM cannot provide
  15.           technical support for the package and will not be responsible for
  16.           any consequences of use of the program.
  17.  
  18.           Any notices, including this one, are not to be removed from the
  19.           package without the prior written consent of IBM.
  20.  
  21. AUTHOR:
  22.           John E. Diller
  23.           VNET:     JEDILLER at RALVM6           Tie Line: 444-5496
  24.           Internet: jediller@ralvm6.vnet.ibm.com     (919) 254-5496
  25.  
  26. FUNCTION:
  27.           Documentation for the CPICTELL package.  The CPICTELL package is a
  28.           sample using the REXX CPI-C interface which allows one to send a
  29.           message from one OS/2 workstation to another.
  30.  
  31. RELATED FILES:
  32.  
  33.  CPICTELL.CMD -     A CPICREXX application for OS/2.  A command line REXX
  34.                     exec which sends a message to the specified destination.
  35.  CPICHEAR.CMD -     A CPICREXX application for OS/2. This REXX exec receives
  36.                     the message sent using CPICTELL.CMD and displays it using
  37.                     to the OS/2 workstation screen using the POPUP.EXE which
  38.                     is included with the package.
  39.  
  40.  CPICHEAR.EXE -     This is a very small C program. It starts CPICHEAR.CMD. 
  41.                     This program is included so the CPICHEAR.CMD can run
  42.                     without a special definition for the transaction program.
  43.  
  44.  CPICHEAR.C   -     C source for CPICHEAR.EXE
  45.  CPICHEAR.DEF -     Definition file used to produce CPICHEAR.EXE
  46.  CPICHEAR.MAK -     Make file used to produce CPICHEAR.EXE
  47.  
  48.  POPUP.EXE    -     This is a small C program designed so the CPICHEAR.CMD
  49.                     can "POPUP" the message it receives on the screen.
  50.  
  51.  POPUP.C      -     C source for POPUP.EXE
  52.  POPUP.DEF    -     Definition file used to produce POPUP.EXE
  53.  POPUP.MAK    -     Make file used to produce POPUP.EXE
  54.  
  55.  CPICHEAR.NDF -     A sample NDF (Node Definition File) definition for
  56.                     CPICHEAR.CMD.  If this is used, then the CPICHEAR.EXE is
  57.                     not needed.
  58.  
  59. PORTABILITY NOTES:
  60.           This sample was designed using the REXX CPI-C interface available
  61.           on an OS/2 system running either Extended Services or Networking
  62.           Services/2.  To migrate the sample to a different REXX CPI-C
  63.           platform, at least some of the following changes may be required.
  64.  
  65.           -    The XCSCST call in CPICTELL.CMD may need to be eliminated or
  66.                replaced.  There may be a need to define some security on the
  67.                machines running the sample.
  68.           -    ADDRESS CPICOMM may not how REXX calls CPI-C in another
  69.                platform.  The CPICREXX.EXE is called conditionally to set up
  70.                the CPICREXX environment.  This may be different on another
  71.                platform.
  72.           -    The POPUP.EXE may not execute in another platform.  See usage
  73.                notes on how the POPUP.EXE may be replaced.
  74.  
  75. USAGE NOTES:
  76.           This package was designed to use on OS/2 using either Extended
  77.           Services or Networking Services/2 using minimal configuration.
  78.  
  79.           To send a message from one machine to another the following should
  80.           be true at both machines.
  81.  
  82.           -    The OS/2 Communications Manager is started.
  83.           -    The CPICREXX.EXE has been executed to initialize the CPI-C
  84.                REXX environment.  The CPICREXX.EXE comes with both Extended
  85.                Services and Networking Services/2.  Normally the CPICREXX.EXE
  86.                is found in the \CMLIB\APPN directory.  The CPICTELL.CMD or
  87.                CPICHEAR.CMD will attempt to run CPICREXX.EXE if it has not
  88.                been run.
  89.  
  90.           In addition the machine receiving the message should
  91.  
  92.           -    have its attach manager started.
  93.           -    CPICHEAR.EXE, CPICHEAR.CMD, POPUP.EXE are all in the system
  94.                PATH as specified in the CONFIG.SYS file.
  95.           -    have a properly-defined TP definition for CPICHEAR.  See the
  96.                sample TP definition in the CPICHEAR.NDF file.  Extended
  97.                Services and Networking Services/2 allow system default
  98.                information.  The DEFINE_DEFAULTS verb specified in the
  99.                xxxxxxxx.NDF file (where xxxxxxxx is the active communication
  100.                manager configuration.  The NDF file is an ASCII-readable file
  101.                found in the \CMLIB\APPN directory) is used for this purpose. 
  102.                It may not be necessary to add an explicit TP definition for
  103.                CPICHEAR under the following conditions.
  104.  
  105.                --   Default TP directory (system default information)
  106.                     contains the CPICHEAR.EXE.  (The DEFINE_DEFAULTS verb
  107.                     allows the system PATH to be specified as the default TP
  108.                     directory.)
  109.                --   Conversation security required is NO (system default
  110.                     information - DEFINE_DEFAULTS default value.)
  111.                --   Implicit partner LU support is YES (system default
  112.                     information - DEFINE_DEFAULTS default value.)  This is
  113.                     not needed if the partner LU which sends the message is
  114.                     explicitly defined.
  115.  
  116.           POPUP.EXE was designed to help ensure a person using the OS/2
  117.           workstation that receives the message, also sees the message.  The
  118.           POPUP.EXE will place the message on the full workstation screen. 
  119.           The message will remain on the screen until the 'ENTER' key is hit. 
  120.           There are other choices to ensure the message is read.  You can
  121.           replace the POPUP.EXE by using the REXX say and pull commands as
  122.           follows.
  123.  
  124. 'popup message from:' plu 'at' time() '-' buffer
  125.  
  126.           is replaced by
  127.  
  128. say 'message from:' plu 'at' time() '-' buffer
  129. say
  130. say ' Press enter to end'
  131. pull .
  132.  
  133.  
  134.           and
  135.  
  136.  
  137. 'popup CPICHEAR message fails at' err_at 'rc =' rc 'retc =' retc 'from' plu
  138.  
  139.           is replaced by
  140.  
  141. say 'CPICHEAR message fails at' err_at 'rc =' rc 'retc =' retc 'from' plu
  142. say
  143. say ' Press enter to end'
  144. pull .
  145.  
  146.  
  147.           You should then ensure the TP program type is not "background." 
  148.           This is done with the DEFAULT_TP_PROGRAM_TYPE parameter on the
  149.           DEFINE_DEFAULTS verb or the PROGRAM_TYPE parameter on the DEFINE_TP
  150.           verb in the configuration node definition file.