  =================================================================

    IBM PL/I for OS/2 -- Shaping the Future by Enabling the Past

  *****************************************************************
  *****************************************************************
  ****                                                         ****
  ****  Thank you for evaluating PL/I for OS/2.  You have      ****
  ****  60 days from today to explore the capability of this   ****
  ****  product.                                               ****
  ****                                                         ****
  ****  Call the Santa Teresa Laboratory at 800-IBM-4STL       ****
  ****  if you have questions.                                 ****
  ****                                                         ****
  *****************************************************************
  *****************************************************************

  PL/I for OS/2 is a full 32-bit PL/I compiler for OS/2 which now
  offers application developers more choice than ever before!
  With the function now available, you can develop, maintain, and
  execute PL/I applications while taking advantage of:

  - An SQL preprocessor that supports DB2/2
  - Header files for DB2/2
  - Header files for Presentation Manager programming
  - A GUI, interactive debugger
  - Multithreading and other language enhancements
  - Interlanguage communications support
  - CICS support
  - An enhanced macro facility and much, much more!

  IBM PL/I for OS/2 Professional Edition Version 1 Release 1
  (C) Copyright IBM Corp. 1994. All Rights Reserved. US Government
  Users Restricted Rights--Use, duplication or disclosure restricted
  by GSA ADP Schedule Contract with IBM Corp.

  =================================================================
  *************************************
  * PL/I for OS/2 Evaluation Diskette *
  *************************************

  IMPORTANT INSTALLATION INFORMATION

  If you have a previously installed release of PL/I Package/2,
  we strongly recommend that you delete that release from your
  system.  Use the same diskettes that you used to install the
  product originally and select the remove option to delete the
  previous version of the product before you install PL/I for OS/2.

  Note:  Make sure that references to the directories associated
  with the previous version of the product are removed from your
  CONFIG.SYS file.

  =================================================================


  PL/I FOR OS/2 HARDWARE AND SOFTWARE REQUIREMENTS
  ________________________________________________

  PL/I for OS/2 requires a PS/2* (or compatible) with at least
  an 80386SX processor.  The minimum operating system software
  requirement is OS/2 Version 2.0 (or later).  You need about
  10 Mb of disk space to install the product.

  In addition, the following hardware is recommended:

  o  8 Mb RAM
  o  120 Mb hard disk
  o  10 Mb of free space after installation

  As is true with most software, the performance of PL/I
  for OS/2 generally improves with increased RAM and
  hard disk capacity.


  OPTIONAL HARDWARE

  A math coprocessor is required only if your program uses:

  o   Floating-point constants
  o   Floating-point variables
  o   Functions requiring floating-point arguments


  INSTALLATION EXITS PROVIDED WITH PL/I FOR OS/2

      ibmuexit.pli   - PL/I user exit
      ibmuexit.def   - PL/I user exit definition file
      ibmuexit.inf   - Data file

      ceebxita.pli   - Sample pre-initialization user exit

      ibmfxita.pli   - Sample CICS user exit



  NOTE TO DCLGEN USERS
  ____________________

  In order to use the DCLGEN utility provided with PL/I for OS/2 Professional 
  Edition, you must have DB2/2 or SDK/2 installed and started on your system.  
  Otherwise, you will get an error message when you double click on the DCLGEN 
  icon or invoke DCLGEN from the command line.



  NOTE ON COMPOUND ASSIGNMENTS
  ____________________________

  When using any of these compound assignment operators for strings,
  the source and target strings must not overlap:
    -- concatenate-and-assign
    -- or-and-assign,
    -- and-and-assign
    -- exclusive-or-and-assign



  PLITEST ENHANCEMENT
  ___________________

  The debugger now supports a GOTO and Halt feature that is
  similar to GOTO Cursor.  GOTO and Halt allows you to goto
  the line where the cursor is currently positioned, but unlike
  GOTO Cursor, execution stops at that line.  The GOTO and
  Halt feature is activated by the accelerator mnemonics, Ctrl+H.



  PL/I INCLUDE FILES FOR DB2/2
  ____________________________

  Header files for the IBM DATABASE 2 OS/2 CLIENT/SERVER product
  have been translated to PL/I include files, and are installed
  in the IBMPLI\INCLUDE directory if you select them during
  installation.

  In addition, header files for the IBM DATABASE 2 SOFTWARE
  DEVELOPER'S KIT/2 product have been translated to PL/I include
  files, and are installed in the IBMPLI\INCLUDE\SDK2 directory if
  you select them during installation.



  UPDATE TO THE PL/I RUN-TIME OPTION -- TEST
  __________________________________________

  The run-time option TEST should read as follows (to view this diagram,
  use the System Monospaced font):

        --TEST----   --ERROR--   --*--   --PROMPT----   --*--
        |        |   |       |   |   |   |          |   |   |
    >>----NOTEST---(-----------,-------,--------------,--------)--><
                     |       |           |          |
                     |-ALL---|           |-NOPROMPT-|
                     |       |           |          |
                     |-NONE--|           |-;--------|
                                         |          |
                                         |-*--------|

  The first sub-option default is now ERROR and not NONE.

  The CICS OS/2 supplied default is NOTEST.  You can change the
  default option using instructions supplied with CICS OS/2.



  NOTES TO CICS USERS
  ___________________

  Dynamically Changing Run-Time Option TEST Under CICS OS/2
  ---------------------------------------------------------
  The run-time option TEST can be dynamically changed using the
  CPOP transaction supplied with CICS OS/2. This change occurs
  only for the terminal that the transaction is run from, allowing you
  to have each terminal with unique settings for this option.

  Just type CPOP as the transaction name and change the options as
  desired.


  Use of PLITEST PF3 and Alt-PF3 keys with CICS
  ---------------------------------------------
  If you use PF3 (Exit) or Alt-PF3 (Exit and Stop) to exit from
  PLITEST, you will not be able to use PLITEST ever again from
  the same terminal unless CICS is shutdown and brought up again.
  It is recommended that you avoid using these keys and use GO
  or ANIMATE instead.


  MARGINS and the CICS Preprocessor
  ---------------------------------
  Use of MARGINS other than MARGINS(2, n) causes the generated
  source code to be always placed in column 2. If you have this
  problem, please contact IBM development for a fix.


  Testing PL/I Applications with CICS OS/2
  ----------------------------------------
  For performance reasons CICS OS/2 keeps the last program run
  in memory until a different program is needed. You may not be
  able to relink a program that was just executed unless you cause
  CICS OS/2 to "unload" it. This can be accomplished by running any
  other transaction (e.g. CPOP, CEDA) from the same terminal.



  I/O UPDATES
  ___________

  Support for the LF and LFEOF suboptions of TYPE
  -----------------------------------------------
  The LF suboption specifies that records are delimited by the
  LF character.  (LF represents the ASCII value of line feed X'0A'.)
  For an output file, PL/I places the characters at the end of
  each record.  For an input file, PL/I discards the LF character.
  For both input and output, the character is not counted in
  consideration for RECSIZE.

  The LFEOF suboption specifies the same information as LF
  except for the output files.  When one of these files is closed
  for output, an end-of-file marker is appended to the last
  record.


  BUFSIZE
  -------
  The BUFSIZE attribute is only supported with record I/O binary
  files, not stream I/O.


  Access of Remote VSAM Data with Data Access Services
  ----------------------------------------------------
  When an application remotely accesses a VSAM data file on the MVS
  platform, the CLOSE statement needs to be explicitly coded in
  the program.



  NOTE TO WORKFRAME/2 USERS
  _________________________

  IBMWF.DLL is placed in the C:\IBMPLI\DLL directory
  during installation.



  ATTENTION LAN USERS
  ___________________

  You should set the TMP environment variable to a drive associated
  with your individual machine instead of to a LAN drive.  Doing this
  improves performance and eliminates the possibility of compilation
  failure due to the use of a Novell 2.1 LAN requester.



  PASSING PARAMETERS TO MAIN
  __________________________

  NOEXECOPS is now supported.  If you have a MAIN procedure that
  receives a character varying string, only the characters after the
  first '/' are passed to that procedure unless NOEXECOPS is specified.

  For example, given the following procedure:

    sample: proc( c ) options( main );
      dcl c char(*) varying;
      display( c );
    end;

  If you invoke it by entering "sample try this", a null string
  is passed to parameter "c", causing a null string to be
  displayed on the screen (since "try this" contains no '/').

  If you invoke it by entering "sample try/this", 'this' is displayed
  on the screen.

  You can, however, add NOEXECOPS to the OPTIONS option of the
  procedure statement as follows:

    sample: proc( c ) options( main noexecops );
      dcl c char(*) varying;
      display( c );
    end;

  If you invoke it by entering "sample try this", 'try this' is
  displayed on the screen.

  If you invoke it by entering "sample try/this", 'try/this' is
  displayed on the screen.



  CONTACTING IBM FOR SERVICE VIA COMPUSERVE

  You can use CompuServe to submit problems to IBM and communicate
  directly with the PL/I product development team.  For CompuServe
  membership information, call 1-800-848-8199 and request
  Representative 239.

  As a CompuServe member, you can access CompuServe using a modem.
  At the ! command prompt enter, "GO OS2DF1".  Place your messages and
  comments regarding PL/I in "Section 6, REXX and Other Languages."



  PL/I FOR OS/2 SAMPLE PROGRAMS

  The following sample programs are shipped with PL/I for OS/2,
  and reside in the SAMPLES subdirectory.

  You can find explanations of many sample programs in the
  PL/I for OS/2 Programming Guide.

  1.  Play some music

      chimes.pli     - Plays the tune "Westminister Chimes"

  2.  Towers of Hanoi: uses built-in Presentation Manager* (PM) features

      towers.pli      - Main program

  3.  Presentation Manager demonstration: PM programming using PL/I

      pmdemo.pli     - Small main program
      pmdemo2.pli    - Simple screen saver

  4.  PL/I Input/Output sample programs

      NATIVE

      bday.pli       - Create a CONSECUTIVE data set
      bday.inp       - Input file

      bday1.pli      - Read a CONSECUTIVE data set

      con3.pli       - Create a SEQUENTIAL data set

      int1.pli       - Create a SEQUENTIAL data set

      con4.pli       - Merge two data sets into a CONSECUTIVE data set
      evens.inp      - Input file
      odds.inp       - Input file

      con5.pli       - Print a SEQUENTIAL data set

      reg1.pli       - Create a REGIONAL(1) data set
      crg.inp        - Input file

      reg2.pli       - Update a REGIONAL(1) data set
      acr.inp        - Input file

  5.  Creating and using a dynamic link library

      driver1.pli    - Main program
      driver1.def    - Main program definition file
      driver2.pli    - Main program (using FETCH/RELEASE)
      extdcl.pli     - External declarations include file
      sort.pli       - Sort routine library
      sort.def       - Sort routine library definition file


  =================================================================

  IBM LAN SERVER 2.0 FIX

  If a PL/I application needs to access a remote VSAM data set that
  resides on a LAN running IBM LAN Server 2.0, ensure that the
  NETWKSTA.200 file on the IBM LAN Requester is dated 07/15/92 or later.
  If it is not, contact IBM Level 2 support and request fix number IC04508.
  This fix (an upgraded NETWKSTA.200 file) enables PL/I to support VSAM
  data sets on a LAN.  Once you get the fix, replace the copy of the
  NETWKSTA.200 file on the IBM LAN Requester with the upgraded file.
  Then, restart both the IBM LAN Requester and OS/2 to enable the fix.


  NOVELL LAN ENVIRONMENT
  ______________________

  NOVELL LAN SERVER NETWARE* VERSION 2.X

  Novell NetWare Version 2.x does not support extended file attributes
  required by PL/I for OS/2 for remote VSAM data sets.  For NetWare
  support for extended file attributes, it is recommended that
  PL/I for OS/2 users who are also NetWare Version 2.x users upgrade
  to NetWare Version 3.x.

  NOVELL FILE SERVER NETWARE VERSION 3.x

  o   To ensure that PL/I for OS/2 accesses remote VSAM data sets,
      the include following statement in the AUTOEXEC.NCF file on your
      LAN server

         SET Maximum Extended Attributes Per File or Path = 50

      Alternatively, you can issue this SET command from the
      system prompt (:) on the LAN server without having to down the
      server and requester and logoff the users.  The command will
      take effect immediately. However, if the server goes down,
      you'll need to reissue the command.  For more information
      about the NetWare SET command, see the
      NetWare System Administration manual.

  o   PL/I for OS/2 also requires that the *first*
      Novell Service Diskette (NSD # 1) for NetWare Workstation Kit
      for OS/2 v2.0 be installed.


  NOTE
  ____

  --Before attempting to create mixed language applications
    or using the ILC sample programs, you should read the
    ILCREAD.ME file.



  TRADEMARKS
  __________

  The following items are trademarks of the IBM Corporation:
      IBM
      OS/2
      Presentation Manager
      PS/2

  The following item is trademark of the Novell Corporation:
      NetWare
      Novell
