![]() |
Iron Spring PL/I CompilerLinux Version 1.1.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.1.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:
Restrictions
Version 1.1.0 has a number of restrictions. The most
significant are:
Installation
An installation procedure is provided. cd to the 'pli-1.1.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.
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:
Changes
Summary of Changes for 1.1.0
Summary of Changes for 1.0.0
Note that these are string format codes. Computational data will be
converted to or from bit strings according to the standard conversion
rules.
Bugs fixed
Changes in version 1.1.0 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
4621.1.0 SIGSEGV on aggregate assignment to
array of structures
Changes in previous versions 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
Modifying the Runtime Library
The document About the Iron Spring PL/I Library
Contains information necessary to modify or extend the runtime library.
Most users of Iron Spring PL/I will probably not be interesting in making
modifications to the library.
Support
No formal support is provided for pre-release versions of Iron Spring PL/I.
Bugs will be fixed on a best-efforts basis only, and the fix 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.1.0, 20 Jun 2023
http://www.iron-spring.com