Iron Spring PL/I Compiler

Introduction

  pli-0.9.9a
    |
    +-----------------------samples----------------lib
    |                          |                    |
 plic.exe                   (Sample sources and     +--------------------------static---include----source
 (compiler executable)       %include files,        PL/I DLL (prf.dll)         |         |         |
 (documentation, etc.)       sample makefiles       Import Library (prf.lib)   |         |         +--------asm
                             and module definition  (.obj files for all        |         |   (PL/I source)   |   
                             file).                  library procedures).      |         |               (assembler
                                                                               |  (%include files          source)
                                                                               |    required by                                                                                      
                                                                               |     library).
                                                                               |
                                                                      prf.lib (static library)
                                                                      OS2386.lib

Requirements

• OS/2 Warp 4 or higher, includung eCS. Warp 3 has been reported to work, but is unsupported.
• LINK386 linker or equivalent to link object files.
  LINK386 is distributed with OS/2 and installed as part of "Optional System Utilities."

Installation

1. Unpack the distribution file into a directory named "x:\pli-0.9.9a", (Specify your desired drive in place of 'x'.)
2. Only the compiler (x:\pli-0.9.9a\plic.exe) and either the static runtime library (x:\pli-0.9.9a\lib\static\prf.lib) OR the DLL (x:\pli-0.9.9a\lib\prf.dll) and the import library (x:\pli-0.9.9a\lib\\prf.lib) are required. You should already have a version of OS2386.LIB. If you don't, you can use the one supplied in "x:\pli-0.9.9a\lib\static\OS2386.lib".
3. Move the compiler to a directory in your PATH or add x:\pli-0.9.9a to your path in config.sys.
4. If you are using the DLL version of the library, move prf.dll to a directory in LIBPATH, or add (x:\pli-0.9.9a\lib) to your LIBPATH in CONFIG.SYS and reboot. In order to link compiled programs you also need to make the import library prf.lib available by moving it to a directory listed in the LIB environment variable. Alternatatively, you can add the line "LIB = x:\pli-0.9.9a\lib" to your makefiles.
5. If you are using the static version of the library (x:\pli-0.9.9a\lib\static\prf.lib), move it [and x:\pli-0.9.9a\lib\static\OS2386.lib if required] to a directory listed in the LIB environment variable. Alternatatively, you can add the line "LIB = x:\pli-0.9.9a\lib\static" to your makefiles.

• Command should be contained on one line.
• Replace ${OBJ} with the name of your compiled object file (.obj)
• Replace ${LIBDIR} with the name of the directory containing the static library. For example, the default is \pli-0.9.9a\lib\static
• Replace ${DEF} with the name of your module definition files (.def). See the LINK386 reference for a description of module definition files. This is not required for a VIO (non-PM) program, so it could be omitted and the ';' placed after 'OS2386.lib'.

The following command links a PL/I program with the PL/I runtime DLL.

LINK386 /m:f /a:8 /st:0x100000 ${OBJ},,,${LIBDIR}\prf.lib,${DEF};

• Command should be contained on one line.
• Replace ${OBJ} with the name of your compiled object file (.obj)
• Replace ${LIBDIR} with the name of the directory containing the PL/I runtime expore library. For example, the default is \pli-0.9.9a\lib
• Replace ${DEF} with the name of your module definition files (.def). See the LINK386 reference for a description of module definition files. This is not required for a VIO (non-PM) program, so it could be omitted and the ';' placed after 'OS2386.lib'.
• The PL/I DLL must be in $LIBPATH when the program is executed.

Modifying the Runtime Library