home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / plawo22i.zip / PLWIDIS1.ZIP / readme.doc < prev   
Text File  |  1994-05-16  |  8KB  |  219 lines
  1.  
  2.  
  3. INTRODUCTION
  4. ------------
  5. This is the README.DOC file for the IBM PLANT FLOOR SERIES PlantWorks:
  6. Application Automation Edition, Interface Services/2 Release 2.2.
  7.  
  8. The following areas are covered:
  9.  
  10.      o Pre-Installation requirements
  11.      o Run Time environment prerequisites
  12.      o Components
  13.      o DAE Configuration Notes
  14.      o PlantWorks Configuration
  15.      o APPC Environment Setup - Customer Responsibility
  16.      o Interface Services/2 Installation
  17.      o Interface Services/2 Configuration
  18.      o Starting Interface Services/2
  19.      o Function Clarifications
  20.  
  21.  
  22. PRE-INSTALLATION REQUIREMENTS
  23. -----------------------------
  24. Before you install the Interface Services/2 server (IS/2), you must have
  25. installed the following software:
  26.  
  27.     1. IBM Operating System/2 (OS/2) 2.0 or 2.1
  28.     2. Distributed Automation Edition Communication System/2 Release 3.1
  29.        Distributed Automation Edition Host Link/2 Release 3.1
  30.     3. PlantWorks Execution Services/2 Release 2.2
  31.     4. IBM C/2 compiler Version 1.1   (Optional - Required if OS/2
  32.        based sample programs are to be compiled)
  33.     5. IBM C/370 Compiler and Library (Optional - Required if MVS
  34.        based sample programs are to be compiled).
  35.  
  36.  
  37. RUN TIME ENVIRONMENT PREREQUISITES
  38. -----------------------------------
  39.      1.   IS/2 server and client program on the same node - DAE
  40.           environment
  41.  
  42.      1.1  IS/2 server requires:
  43.           1. OS/2 2.0 or 2.1
  44.           2. DAE 3.1 configured to support IS/2
  45.      1.2  IS/2 client requires:
  46.           1. DAE configured to support IS/2 client
  47.  
  48.  
  49.      2.   IS/2 server and client program on different nodes - DAE
  50.           environment
  51.  
  52.      2.1  IS/2 server requires:
  53.           1. Same prerequisite as 1.1
  54.           2. DAE configured to support a DAE network
  55.  
  56.      2.2  IS/2 client requires:
  57.           1. OS/2 2.0 or 2.1 installed
  58.           2. DAE 3.1 installed
  59.           3. DAE configured to support DAE network and IS/2 client
  60.              Use eaclnt2.cbs as a guideline for the setup
  61.  
  62.  
  63.      3.   IS/2 server and client program on different nodes - OS/2 APPC
  64.           environment
  65.  
  66.      3.1  IS/2 server requires:
  67.           1. Same prerequisite as 2.1
  68.           2. OS/2 Communication Manager configured for APPC
  69.              Use eaappc2.cfg as a guideline (supports the sample
  70.              program when used in conjunction with eaclnt2.cfg using
  71.              SDLC protocol).
  72.           4. DAE configured to support APPC non-DAE client
  73.           5. DAE Host Link/2 program installed and configured
  74.  
  75.      3.2  IS/2 client requires:
  76.           1. OS/2 2.0 or 2.1
  77.           2. OS/2 Communication Manager configured for APPC
  78.              Use eaclnt2.cfg as a guideline (supports the sample
  79.              program when used in conjunction with eaappc2.cfg using
  80.              SDLC protocol)
  81.  
  82.  
  83.      4.   IS/2 server and client program on different nodes - MVS/VTAM APPC
  84.  
  85.      4.1  IS/2 server requires:
  86.           1. Same prerequisite as 3.1 - except -
  87.              Use eaappcv.cfg as a guideline to support the sample
  88.              program using SDLC.
  89.           2. ASCII to EBCDIC conversion on data stream as provided by
  90.              ACSSVC.DLL in OS/2 EE 1.3. See Appendix E in "Conversational
  91.              LU Application Programming Reference", S01F-0277.
  92.  
  93.      4.2. IS/2 client requires:
  94.           1. MVS/VTAM 3.2 or later
  95.           2. VTAM setup to match the eaappcv.cfg using SDLC over a
  96.              nonswitched line
  97.  
  98. COMPONENTS
  99. ----------
  100.      Documentation
  101.         Using Interface Services/2, SC28-8258
  102.  
  103.      IS/2 Product - Diskette 1
  104.         eapi.exe    : server startup and monitoring program
  105.         ea_recv.exe : server receive processor
  106.         ea_send.exe : server send processor
  107.         ea_trig.exe : trigger a chain processor
  108.         eapimsg.h   : IS/2 transaction definition - include file for "C"
  109.                       program
  110.         readme.doc  : this file
  111.  
  112.  
  113. DAE CONFIGURATION NOTES
  114. -----------------------
  115.      . If you intend to use CS2HTR00.EXE program, set the remote
  116.        architecture type to "1" in RCCB and codepage to 037. This is required
  117.        whether the client program is running on MVS or OS/2.
  118.  
  119.  
  120. PLANTWORKS CONFIGURATION
  121. ------------------------
  122.      . The IS/2 service can be enabled by the "User Services Access."
  123.  
  124.      . There is no default user setup for use by IS/2 client programs.
  125.        You must modify or create a new user to provide access through
  126.        IS/2. The sample programs require "EAPIDEMO" as the user ID and
  127.        the password.
  128.  
  129.  
  130. APPC ENVIRONMENT SETUP - CUSTOMER RESPONSIBILITY
  131. ------------------------------------------------
  132. Before attempting to execute either the OS/2 APPC sample program or the
  133. MVS APPC sample program, the underlying APPC environment must be
  134. completely set up. Interface Services/2 assumes that these environments
  135. are capable of supporting APPC and makes no attempt to define the
  136. environments beyond what IS/2 itself requires for the sample program
  137. execution.
  138.  
  139. Provided with the sample programs are the OS/2 Communication Manager
  140. ".cfg" files required for their execution. In addition, for MVS, the
  141. entries required in VTAM to match the CM entries are demonstrated.
  142. However, there is no attempt to provide the complete VTAM and/or NCP
  143. system and network definition. This is the user's responsibility.
  144.  
  145.  
  146. INTERFACE SERVICES/2 INSTALLATION
  147. ---------------------------------
  148.      . You should install IS/2 on the Executive node while DAE is running
  149.        and the PlantWorks executive node is not active.  See the
  150.        Interfaces Services Program Directory for further instructions.
  151.      . The files from the first and second diskette are copied to your
  152.        hard disk.
  153.      . PlantWorks will enable IS/2 to be automatically
  154.        started and stopped with the PlantWorks node.
  155.  
  156.  
  157.  
  158. INTERFACE SERVICES/2 CONFIGURATION
  159. ----------------------------------
  160.  
  161.     . You are now ready to configure your system to support IS/2 as
  162.       described in Chapter 2 of the Using Interface Services/2 manual.
  163.  
  164.     . If you plan to use an IS/2 client program via the APPC protocol
  165.       interface, you need to use Communication Manager to create or
  166.       modify the communication configuration files. You may use
  167.       "eaappc2.cfg" - and - "eaclnt2.cfg" for OS/2 based systems, or
  168.       "eaappcv.cfg" and the sample VTAM entries for the MVS to OS/2 setup.
  169.       Since APPC programs communicate as partner applications, you need
  170.       to carefully match the configurations between the two nodes.
  171.  
  172.     . You may refer to the "easerv2.cbs" and "eaclnt2.cbs" files to see
  173.       how you config DAE to support the different kinds of IS/2
  174.       client programs.
  175.  
  176.  
  177. STARTING INTERFACE SERVICES/2
  178. -----------------------------
  179.  
  180.  
  181.       If you are going to support the APPC environment, you must start the
  182.       Communication Manager before starting DAE and PlantWorks. DAE
  183.       requires that the Communication Manager be running before the
  184.       APPC REM is started.
  185.  
  186.  
  187. FUNCTION CLARIFICATIONS
  188. -----------------------
  189.  
  190. Topic: EA_ALARM - usage
  191.  
  192. The alarm flag should be set to 'on' before you send the alarm message.
  193. This will allow you to see the alarm display on the screen because the
  194. alarm program tests the flag when it receives the request message.
  195.  
  196.  
  197. Topic: EA_PRINT - text must include printer control character
  198.  
  199. If you are printing multiple text lines with EA_PRINT, you must
  200. include control characters in the text. IS/2 will do an EBCDIC type G
  201. data conversion for the MVS clients.
  202.  
  203.  
  204.  
  205.  
  206.  
  207. CHANGES IN THIS RELEASE
  208. -----------------------
  209. Two functions have been enhanced to:
  210.  
  211.      . Add features to SYMLOOKUP transaction to return record formats
  212.        when user requests a RECORD ITEM NAME or RECORD FORMAT NAME
  213.  
  214.      . Add support in EA_RECINIT, EA_READ and EA_WRITE transactions
  215.        to handle multiple-character strings in a RECORD.
  216.  
  217.  
  218. /*             *********** End of the file ***********                */
  219.