![]() |
Iron Spring PL/I CompilerLinux Version 1.3.0
|
The current version still contains bugs. You can help improve the compiler. See the section Reporting bugs.
Trademarks
Iron Spring Software grants you the right to use and copy the Iron
Spring PL/I compiler and library freely. You may distribute programs compiled
using the compiler and/or linked with the library under any terms you wish
without restriction.
The source to the library is licensed under the terms of the
Gnu Lesser General Public License (LGPL).
All material is copyright Iron Spring Software, 2023.
THE COMPILER AND LIBRARY ARE PROVIDED "AS IS"
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
PERFORMANCE OF THE COMPILER AND LIBRARY IS WITH YOU. SHOULD THEY PROVE
DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
CORRECTION.
A later version will be installable using one or more of the standard package managers.
The Iron Spring PL/I Compiler Programming Guide describes
the PL/I compiler options available.
ArcaOS is a trademark of Arca Noae.
Gnu is a trademark of the Free Software Foundation.
IBM is a trademark of IBM, Inc.
Intel is a trademark of Intel Corporation.
Iron Spring is a trademark of Iron Spring Software.
Linux is a registered trademark of Linus Torvalds.
VAX is a trademark of Hewlett-Packard, Inc.
WATCOM is a trademark of Sybase, Inc. and its subsidiaries.
Library heap manager based on code
Copyright (c) 2001-2006 Wolfram Gloger.
License
<boring-legal-stuff>
This license a legal agreement between you and Iron Spring Software. Your use of
this software signifies that you agree to the terms of this license.
</boring-legal-stuff>
Contents
This distribution includes the executable for the PL/I compiler plic,
the static library lib/static/libprf.a,
and the sources for the library and sample programs.
pli-1.3.0
|
+-----------------------samples----------------lib
| | |
plic (Sample sources and +--------------------------static---include----source-----------alt
(compiler executable) %include files, | | | |
(documentation, etc.) sample makefiles | | +--------asm |
and module definition | | (PL/I source) | (alt storage
file). | | (assembler management)
| (%include files source)
| required by
| library).
|
libprf.a (static library)
Requirements
The folowing software is required to run the Linux version of the compiler:
The following software is recommended:
Running under Windows WSL2 may work, but has not been tested.
Restrictions
Version 1.3.0 has a number of restrictions. The most
significant are:
Installation
An installation procedure is provided. cd to the 'pli-1.3.0' directory
and type 'make install' (with suitable authority). This procedure moves the
compiler to '/usr/bin' and creates a symlink 'plic' referencing it,
and moves the library to '/usr/lib' and creates the symlink
'libprf.a'.
Sample Programs
The file samples/samples.html contains instructions
and a list of all the sample programs. The comments in each program contain
information on using the program.
Using the compiler
The "samples" directory contains three sample makefiles that can be used to compile and link
PL/I programs. You should copy these and modify them for your requirements.
"LC_make" and "LCC_make" both use gcc to drive the linker; the program entry will be libc's
"_start". "SA_make" calls ld directly and should be used only for programs that don't call
any C functions. The program entry will be PL/I's "main". In all cases the static PL/I
runtime linkary "libprf.a" is required, indicated by "-lprf" in the linker command.
gcc -o ${EXE} ${OBJ} ${ALTDIR}/fhs.o ${ALTDIR}/ghs.o -lprf -Wl,-M >${MAP} |
This command uses gcc to link a PL/I program with libc, and use PL/I's heap storage management.
gcc -o ${EXE} ${OBJ} -lprf -Wl,-M >${MAP} |
This command uses ld to link a standalone PL/I program with no reference to libc.
ld -z muldefs -Bstatic -M -e main -t -o ${EXE} \ ${OBJ} \ -lprf \ >${MAP} |
64-bit Linux Considerations
The Iron Spring PL/I compiler, and compiled PL/I programs,
will run on a 64-bit system as 32-bit applications.
The following steps are required:
sudo apt-get install gcc-multilib
--oformat=elf32-i386
-melf_i386
Documentation
The Iron Spring PL/I Compiler Programming Guide contains
a description of the features of the compiler.
Except as noted in the Programming Guide
under Compiler Differences and
Restrictions this compiler is compatible with
the IBM "PL/I for MVS and VM Compiler 1.1". A complete language reference will be available as part of a future release.
Documentation for the IBM compiler is available online at teampli.net.
Bugs fixed | ||
---|---|---|
Changes in version 1.3.0 | ||
563 | 1.3.0 | Incorrect access to elements of array of structures |
561 | 1.3.0 | Assignment to array of structures may be incorrect |
560 | 1.3.0 | Result of INDEX or SEARCH builtin incorrect if used in expression |
556 | 1.3.0 | LBOUND/HBOUND incorrect for adjustable array. (repeat of 320) |
555 | 1.3.0 | Refer object set incorrectly for array bounds |
554 | 1.3.0 | Incorrect length returned for CONTROLLED string elements |
553 | 1.3.0 | STORAGE/CURRENTSTORAGE values inconsistent for adjustable based structure |
552 | 1.3.0 | Refer expression not converted to FIXED BIN(31) |
551 | 1.3.0 | Allow structure qualification for refer object name |
550 | 1.3.0 | Element name and descriptor not passed to I/O subsystem |
549 | 1.3.0 | Subscripted reference to undeclared variable causes trap |
548 | 1.3.0 | Error with hardware shift instruction with constant shift amount |
547 | 1.3.0 | Declaration of external array causes compiler trap |
540 | 1.3.0 | No warning generated for undeclared programmer-named condition |
530 | 1.3.0 | TRIM(bit string) generates garbage |
454 | 1.3.0 | Error referencing BASED ENTRY variable |
Changes in previous versions | ||
546 | 1.2.0 | Builtin SIZE not recognized as synonym for STORAGE |
539 | 1.2.0 | Incorrect conversion of bit string constant to FIXED DECIMAL |
536 | 1.2.0 | Incorrect output with PUT(bit_string) with A-Format |
534 | 1.2.0 | Errors with UNSIGNED size<4 |
533 | 1.2.0 | Errors converting relational expression to bit string |
532 | 1.1.0 | (OS/2)GOTO out of ON-Unit causes erroneous "recursive abend" |
528 | 1.1.0 | Block initialization calling some library procedures traps at runtime |
518 | 1.1.0 | Initialization of UNALIGNED BIT elements of STATIC structures and arrays incorrect |
513 | 1.1.0 | Various errors with VARYING UNALIGNED BIT arrays |
512 | 1.1.0 | Trap referencing structure with REFER option declared in another block |
511 | 1.1.0 | Floating point numbers print incorrectly if smaller than 1e-16 |
510 | 1.1.0 | ADDR(x) may return incorrect result if x was previously referenced in the same statement |
509 | 1.1.0 | Access to adjustable descriptor in containing block returns incorrect result |
461 462 | 1.1.0 | SIGSEGV on aggregate assignment to array of structures |
508 | 1.0.0 | Incorrect conversion of FLOAT BINARY to FIXED DECIMAL |
506 | 1.0.0 | Compiler trap in some cases where statement not properly terminated |
504 | 1.0.0 | Incorrect conversion of COMPLEX data |
503 | 1.0.0 | Statement label should not be allowed on declaration |
502 | 1.0.0 | Error using array element as control variable in DO-Statement |
501 | 1.0.0 | Code comment not printing subscript for subscripted label constant |
500 | 1.0.0 | GET/PUT array elements off by one |
499 | 1.0.0 | CHAR to BIT conversion not handling leading and trailing blanks |
498 | 1.0.0 | ONCHAR returns incorrect value |
497 | 1.0.0 | Incorrect output for GET/PUT of minor structure |
496 | 1.0.0 | Problems moving FIXED BIN returned value |
495 | 1.0.0 | SIGNED/UNSIGNED builtins may return incorrect precision |
494 | 1.0.0 | Incorrect precision converting FIXED DECIMAL to FIXED BINARY |
493 | 1.0.0 | Fixed documentation of OSGetProcInfo |
The Iron Spring PL/I Users' Forum
(https://groups.io/g/Iron-Spring)
is available as a user forum for problems, tips, etc. The developers also monitor
this group.
Before reporting a bug, please make sure you are running
the most recent release.
The following information is required to report
a bug:
Mail bug reports to:
Support
Iron Spring PL/I is supported on a "best efforts" basis. Attempts will be made
to fix all reported bugs, and have the fixes included in
the next distributed version. "Thank You" to a number of users who have
submitted bug reports which helped improve this version of the compiler.
Reporting bugs
For the current version of the compiler, a bug
is one of the following:
Features not implemented in the current version will
be added in future versions. In the meantime, their
absence should at least be indicated by an error message.
Hopefully, all this information will be small enough to be sent as
plain text in a mail message. Otherwise please attach a zip file.
No other formats will be accepted.
bugs@iron-spring.com
version 1.3.0, 15 Apr 2024
http://www.iron-spring.com