This page is a growing collection of frequently asked questions
about the z390 project. You can join the z390 open discussion
forum for the z390 project by sending email to
firstname.lastname@example.org. You can use this group
to post questions and participate in discussion of hot topics.
Questions and answers will be added to this page:
- How do I quickly identify the macros and copybooks
required to assemble a mainframe assembler source program with
- When you attempt to assembly any program with the command
ASM, ASML, or ASMLG and there are missing macro or copybook
references, the assembler will automatically turn on the ERRSUM
option (z390 v1.3.07d or later). This option lists the
missing macro and copybook names. Once all the missing
files have been found by adding the necessary directory lists to
SYSMAC(...) and SYSCPY(..) parms, then the option ERRSUM can be
used again to list any remaining undefined symbol references
which often indicate a missing macro or copybook reference or a
macro library release level problem.
- How do I search for the errors in a PRN assembly listing
- Search for the character sequence "390E" which is in both
"MZ390E" and "AZ390E" error messages.
- What are the primary uses of the z390
portable mainframe macro assembler and emulator?
- Enable developers to
assemble, link, and execute mainframe assembler programs on any
J2SE platform including PC laptops and home computers.
- Simplify the migration of
applications which include mainframe assembler.
- Provide a useful learning
tool for students learning mainframe assembler or Java.
- Why is z390 open source?
- z390 is an open source
project with free downloads including both the Java source code
and the executable z390.jar file. Downloads are
available in InstallShield format for Windows XP and Vista and in
file zip format for Ubuntu
and other Linux distributions. Open source provides access
at no cost and promotes a continuing cooperative effort to
enhance the tool and correct any bugs found. Open source
also ensures users that they can support the tool and customize
the tool to their own needs as required.
See the Automated
Software Tools statement of direction for z390.
- How is the Java source code
- What is required to run the z390 portable mainframe macro
assembler and emulator?
- Windows XP, Windows Vista,
and Linux are now
- Windows XP requires at
least SP2 update.
- Recommend at least 1.0 GHZ processor and 3.0 GHZ
processor is better for performance. See
benchmark statistics here.
- Recommend at least 512 MB memory.
mz390 macro assembler defaults to 100 MB, and z390 defaults
to 1 MB of z390 main memory with options to increase memory
to physical limit using 24 or 32 bit addressing mode. AMODE 64 will be a
future enhancement for 64 bit platforms.
Sun Microsystems Java 2 Runtime version J2RE 1.5.0+.
Note only the runtime is required. The JDK and J2EE include the J2RE runtime. If you install z390 and receive the
java runtime error message saying major/minor conflict 49.0 it
usually indicates there is an earlier version of J2RE installed
on your PC that may be conflicting with J2SE 1.5 runtime.
Remove the older versions such as 1.4.2 and try it again.
- You can submit
RPI Request Program Information for both problems and
enhancements which will be added to pending
RPI Request Log and will be planned for future maintenance
and enhancement releases base on project priorities and
resources available. See
Download Archive for RPI's included in previous releases.
- There is a
Regression Test Directory with constantly growing number
of regression tests included in the z390 install. Issue
command RT to run all the regression tests.. These
programs also serve as useful demo programs for what functions
and features are supported by z390. For example there
are source programs to test sequential and random file access,
tests for all the instructions, and tests for new support for
multiple Windows command tasks under assembler program
- What are the limitations of
- z390 uses the J2RE
Java Virtual Machine emulator to interpret mainframe
instructions. As a result z390 will never execute
instructions as fast as a real mainframe. However, on a 3
GHZ Intel Dual Core chip, z390 can execute several million
mainframe instructions per second which is sufficient for most
development and production applications which are typically I/O
bound versus CPU bound.
- Specific limitations of the
z390 components are listed here.
- Who is using z390?
- What is the target level of z390 support and how can I
learn more about z390 assembler and the mainframe
- z390 is targeted to be compatible with
IBM High Level Assembler Note some of the less
frequently used features may not yet supported yet and
any required additions are welcome.
- z390 is targeted to support problem
as defined in
IBM z/Architecture Principles Of Operations Manual
- z390 is targeted to support IBM MVS, OS/390, and z/OS
common system macros at the macro interface level.
A subset of the most commonly used macros are included and
support assembly, link, and execution of mainframe assembler
for required additions are welcome. In addition the
public domain MVS 3.8J system macros are included in a
separate library for use in assembling MVS compatible programs
to be executed using the
- Where are additional references for learning about
mainframe assembler and z390?
- My program has aborted, how
do I start to debug the problem?
- The simplest
approach is to rerun the program with option TRACE and then view
the trace output file type ".TRE" which shows every instruction
executed up to the point of failure along with register and
storage operand field values.
- If additional
information is required at the point of failure, rerun the
program with option TEST to invoke the interactive debug
facility and use the command T or G with opcode name, address,
or count to run up to the point of failure. Then use L
command to display additional registers and memory areas.
- What are some of the most
common Java coding errors to check for when modifying z390
- Remember to put break after
each case in a switch otherwise it drops through which can cause
very strange results.
- Remember Java subscripts
start at 0 and end at length of array -1 versus macro assembler
arrays that start at 1 and end at length of array.
- How can I allocate more than
the default 1 MB memory for use by assembler program?
- The MEM(mb) option can be
specified on ez390 command to allocate more memory. For
example, MEM(32) will allocate 16 MB below the line and 16 MB
above the line. The lz390 linker supports both AMODE and
RMODE options to create 390 load module that loads above or
below the line and runs in either 24 bit or 31 bit mode.
See regression test TESTOBJ2.MLC run with options AMODE31
RMODE31 MEM(49) to link 32 MB single CSECT program which loads
and runs above the line. The default is AMODE31 RMODE24
- The maximum memory that can
be allocated is limited by physical memory and the memory
required by other Windows applications and other J2RE
applications. If you want to allocate more that the
default maximum allowed by J2SE (about 50 MB on 1 GB system),
you can add the J2RE option -Xmx option. For example,
-Xmx500000000 will allow up to 500 MB to be allocated to J2RE.
Be careful to leave enough memory for both Windows and other
J2RE applications. Note the mz390.bat command processor
allocates 100 MB for large assembly programs. The largest
seen up to v1.2 has 450 macros with 45,000 macro calls.
This assembly used 88 MB and ran 24 seconds.
- See useful
HP reference for more
information on memory management.
- How can I get more
information on where my macro assembler code went wrong?
- Use the TRACEP option to
generate a macro pseudo code trace on file TRM. This trice
will show the value of every macro variable in every AIF, SETA,
SETB, and SETC statement as well the source lines for both
conditional macro code and generated BAL lines. Note this
trace file can be very large so it is recommended to create a
cut down test version of failing code when possible.
- Use the TRACEM option to
generated TRM trace file with just the conditional macro code
lines and generated BAL lines processing during execution of
- What are the
differences between Hercules and z390?
- Hercules is a
software implementation of the System/370, ESA/390 and
z/Architecture mainframe architectures. Hercules runs under
Windows and Linux. Hercules requires an operating system
to emulate in order to assemble and execute assembler programs.
The only public domain OS type operating system available is MVS
3.8. When emulating MVS 3,8, Hercules emulates physical
I/O supervisor instructions such as Start I/O (SIO) to execute
channel programs which access files in virtual volumes.
z390 emulates problem state instructions and maps Supervisor
Calls (SVC) into calls to Java routines which perform I/O and
other supervisor functions using the J2RE runtime to access any
files on the host system.
- Hercules MVS
3.8 emulation has 24 bit limit of 16 MB for each program address
space. z390 supports AMODE 24 and 31 bits with memory
spaces up to the physical limit of the J2RE host processor.
- Hercules MVS
3.8 emulation includes mainframe assembler running in emulation
with EBCDIC source files. z390 includes a macro assembler
which is compatible with the current HLASM V5 and reads ASCII
- z390 recently added support
for the assembly and execution of Decimal Floating Point plus
226 new instructions added for the z10 processor. The z390
floating point support includes:
|Decimal digit Precision
- What is the purpose of the -Xrs
java runtime option?
- This option turns off J2SE
runtime internal error signal handling for CTRL-BRK allowing
user to successfully stop a z390 program that is running in a
loop or taking too long. Without the option J2SE runtime
attempts to handle CTRL-BRK and does not stop the process
requiring user to abort the command line or GUI dialog to
restart. For more information on
-Xrs for multiple OS's see this.
- How do I debug a memory leak
- In order to debug a reported
memory leak in long running z390 CICS server program I added the
J2SE option -verbose:gc to the exec.bat java invocation command.
This option generates trace on console showing the results of
periodic garbage collection done by J2SE runtime.
Initially this trace showed memory usage growing by 18k every
few seconds. After tracing through server code using
Eclipse, I found and fixed recursive TN3270 screen update loop.
After correcting the problem, the trace showed constant memory
- How do I prevent Windows
from poping up "File" menu when the PF10 key is pressed (For
example start IE7 and press PF10 to see the "File" menu show up
- In the z390.java or
gz390.java open source code the following code has been added to
the KeyPressed event handler:
This code consumes the Key pressed event for PF10 preventing
Windows default action.
- How do I prevent large macro assembly process from
stalling where CPU usage goes to 100% and the process slows down
to a crawl due to excessive garbage collection being repeated by
- Increase the maximum memory allocated by J2SE using
optional parameter which can be added to the z390\MZ390.BAT
command. Add -Xmx100000k parameter after the -Xrs paramter.
This increases the J2SE heap space from the system default to
100 MB which worked for the largest macro process I've seen so
far. The system default is the preferred setting in order
to prevent overcommitting the system and possibly stalling other
tasks if too many are running at once.
- If I must keep both J2SE 1.5 and J2SE 1.6 runtimes on my
system, how do I get z390 to use a specific runtime?
- Add the explicit path to the java.exe in the GUI icon
start up and in all the batch commands such as z390.bat,
asmlg.bat, exe.bat, etc. For example, the path to java.exe
on my Vista system is "c:\program files\java\jre6\bin\java.exe".