RPG Compiler from MVT
The RPG compiler and installation files are contained in the archive: rpg.tgz [MD5: BFD4FDF4E101EEC04104C76478766BA5]. Click on the archive name to download the archive to your computer. The archive contains:
a HET tape image (rpg.het),
the output of the mainframe utility TAPEMAP showing the contents of the tape image (rpg.map),
an installation jobstream (mvtrpg.jcl), and
an installation verification jobstream (rpgtest.jcl).
Uncompress the archive (use the tar xvzf <archive> command on Linux 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.
The RPG compiler consists of a set of load modules, which are invoked during the compilation of a user written program. The compiler load modules are contained in the first dataset on the tape image (RPG.LOAD). This dataset was created by an IEBCOPY unload and the library was unloaded from 3350 DASD (RECFM=U,BLKSIZE=19069). The second dataset on the tape image (RPG.PROCS) is a set of Catalogued Procedures, in IEBUPDTE format, that can be used to invoke the compiler.
The load modules for the compiler must be restored to a load library. 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), 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.
The installation jobstream reloads the unloaded library to temporary dataset and the re-links the contents to the target library. 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 dataset to during the installation.
When you have verified that the installation jobstream - mvtrpg.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 no more than a minute to execute and the return codes expected for the steps are:
IEF142I MVTRPG RELOAD - STEP WAS EXECUTED - COND CODE 0000 IEF142I MVTRPG PROCS - STEP WAS EXECUTED - COND CODE 0000 IEF142I MVTRPG LINK001 - STEP WAS EXECUTED - COND CODE 0000
The rpgtest.jcl jobstream performs a compile, link, and execute of a simple RPG program to print the phrase "HELLO WORLD" on the printer. The complete JES2 output for this job may be viewed at rpgtest.
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: