PL/I Compiler from MVT

 

The PL/I compiler and installation files are contained in the archive:  pli.tgz [MD5: a19db21b89092c3a5d83d7eebea8b2b8].  Click on the archive name to download the archive to your computer.  The archive contains:

  • a HET tape image (pli.het),

  • the output of the mainframe utility TAPEMAP showing the contents of the tape image (pli.map),

  • an installation jobstream (mvtpli.jcl), 

  • an installation verification jobstream (plitest.jcl), and

  • a jobstream that compiles/links/executes the 99bottles program from http://www.99-bottles-of-beer.net/ (99bottles.jcl).

Uncompress the archive (use the tar xvzf pli.tgz command on Linux, or under CYGWIN; or use WinZip or ZipNAll on Windows/??).  The tape image should go into your tape image subdirectory, the jobstreams should go into your JCL subdirectory, and the map file may be viewed with a text editor or printed if you are curious about the contents of the tape image.  Note:  The jobstreams were created under Windows, so each line is terminated with x'0d0a'.

The PL/I compiler consists of a set of load modules, which are invoked during the compilation of a user written program, and a set of object modules, which are used during the link-editing of a compiled program.  The compiler load modules are contained in the first dataset on the tape image (PL1.LOAD).  The object modules are contained in the second dataset on the tape image (PL1.LIB).  These two datasets were created by an IEBCOPY unload and the two libraries were unloaded from 3350 DASD (RECFM=U,BLKSIZE=19069).  The third dataset on the tape image (PL1.PROCS) is a set of Catalogued Procedures, in IEBUPDTE format, that can be used to invoke the compiler. 

 

Target Libraries

The load modules for the compiler must be restored to a load library and the object modules must be restored to a Partitioned Dataset that will be available to the Linkage Editor.  The Catalogued Procedures should be restored to a procedure library known to JES2 on your system.  The default targets in the installation jobstream are SYS2.LINKLIB (for the load library), SYS1.PL1LIB (for the PL/I object library), and SYS2.PROCLIB (for the Procedure Library).  If these libraries are not correct for your system, you must edit the installation jobstream before submitting it and substitute destination libraries suitable for your configuration.  Search for the comment - <==TARGET - which is contained on each line where a target library is named.  Additionally note that SYS1.PL1LIB is created in step LINK004 and changes to the UNIT and VOL=SER parameters may be required to conform to your configuration.

The installation jobstream reloads the unloaded libraries to temporary datasets and the re-links the contents to the target libraries.  This allows you to place the restored modules on the type of DASD that fits your configuration, rather than restrict the destination to 3350 DASD.  However, you must have 3350 work space available in your configuration to restore the datasets to during the installation.

When you have verified that the installation jobstream - mvtpli.jcl - conforms to your configuration, mount the tape image on a tape device and submit the jobstream to MVS for execution.  The job should take about two minutes to execute and the return codes expected for the steps are:

IEF142I MVTPL1 RELOAD - STEP WAS EXECUTED - COND CODE 0000 
IEF142I MVTPL1 PROCS - STEP WAS EXECUTED - COND CODE 0000 
IEF142I MVTPL1 LINK001 - STEP WAS EXECUTED - COND CODE 0000      
IEF142I MVTPL1 LINK002 - STEP WAS EXECUTED - COND CODE 0000  
IEF142I MVTPL1 LINK003 - STEP WAS EXECUTED - COND CODE 0000
IEF142I MVTPL1 LINK004 - STEP WAS EXECUTED - COND CODE 0004    
IEF142I MVTPL1 LINK005 - STEP WAS EXECUTED - COND CODE 0000  
IEF142I MVTPL1 LINK006 - STEP WAS EXECUTED - COND CODE 0000
IEF142I MVTPL1 LINK007 - STEP WAS EXECUTED - COND CODE 0000   
IEF142I MVTPL1 LINK008 - STEP WAS EXECUTED - COND CODE 0000  

 

Installation Verification Jobstream

The plitest.jcl jobstream performs a compile, link, and execute of a simple PL/I program to print the phrase "HELLO WORLD" on the printer.  The complete JES2 output for this job may be viewed at plitest.

After the compiler has been successfully installed and verified, you do not need to retain the installation jobstreams or the tape image on your host computer.


I hope that you have found my instructions useful.  If you have questions that I can answer to help expand upon the information I have included here, please don't hesitate to send them to me:


This page was last updated on November 12, 2010.