z390 Options and File Types
- z390 Options for macro assembler, linker, and emulator
- z390_File_Types and Report Formats
- z390 GUI Startup Command Options
- z390 GUI Environment Variable Options
- J2SE Runtime Startup Options
z390 Command Line options for macro assembler
The following table shows all the z390 options available and which programs they apply to:
- M - mz390 macro processor which reads ASCII assembler source and generates expanded BAL
- A - az390 assembler which reads BAL and generated OBJ relocatible object code
- L - lz390 linker which reads OBJ relocatible object files and generates 390 load module
- E - ez390 emulator runtime which loads and executes 390 load module
To turn off an option that is on, prefix the option name with NO on command line or in OPT options file.
| Option | Scope | Default | Description |
| @file | MALE | NO | Retrieve additional options from free form text file with default suffix OPT. Options can be specified delimited by spaces on as many lines as requires. All characters on a line following * are ignored as comments. The @file option can be nested. The default path is the program path. |
| ALLOW | M | NO | Allow extensions to HLASM syntax including no requirement for quotes around SETC variables in AIF and SETC expressions. The default of NOALLOW insures HLASM compatibility. |
| AMODE24 | LE | NO | Set 390 load module options to start in 24 bit address mode |
| AMODE31 | LE | YES | Set 390 load module options to start in 31 bit address mode |
| ASCII | AE | NO | Generate ASCII versus EBCDIC DC character constants |
| ASM | MA | YES | Run az390 assembler as subtask of mz390 passing BAL |
| ASSIST | MAE | NO | Enabled assembly and execution of the 11 new ASSIST instructions added in v1.4.01 to simplify I/O for student use. This option also sets NOLOADHIGH. See ASSIST Support. |
| AUTOLINK | L | YES | Search for unresolved external references in SYSOBJ directory list which defaults to linklib. |
| BAL | M | NO | Generate BAL expanded assembler source file |
| BS2000 | MA | NO | Support Siemens BS2000 assembler global variables |
| CHKMAC(0-2) | M | 0 | Check macros during
loading as follows: 0 - no checking 1- check for missing AGO and AIF labels and issue warning 2 - check missing labels and also check for non comment text after MEND |
| CHKSRC(0-2) | MA | 1 | Check input source
files as follows: 0 - no checking 1 - check MLC or BAL input source files for any non-ASCII characters and issue error 2 - check MLC, MAC, CPY, and BAL input source files for any non-ASCII characters and issue error. Note this should detect any EBCDIC literal character strings containing non-ASCII characters such as binary 0 byte which must be changed to hex X'00' type strings for portability. |
| CICS | MA | NO | Support EXEC CICS pre-processor expansion and constants. If this option is not on during macro expansion, PROLOG and EPILOG option settings will be ignored. |
| CON | MALE | YES | Console output for all display and error messages |
| DUMP | E | NO | Generate full memory dump on LOG or TRE if abort |
| EPILOG | M | YES | Generate epilog macro call DFHEIEND for CICS program at END statement if CICS option and EPILOG option are on. |
| ERR(100) | MALE | 100 | Terminate process if total errors for program exceeds limit. Use ERR(0) to eliminate any error limit and always generate PRN file. |
| ERRSUM | M | NO | Generate error summary on console and ERR file. This option is turned on automatically if missing macros or copybooks are found. When ERRSUM is on, ERR(0) is set to prevent abort prior to finding all macro and copybook references. To suppress the PRN file generation when using ERRSUM, specify NOLIST. |
| GUAM | E | NO | Support one or more GUI Graphical User Access Method dialogs for MCS, TN3270, or graphics user interface. |
| INIT | E | YES | Initialize all registers to hex x'F4' and all memory to hex x'F5' for easier identification of access to uninitialized registers or memory fields. This default option was adopted when ASSIST option was added after fixing a number of regression test initialization bugs. Use NOINIT to revert to all zeros as work-around for bugs. |
| INSTALL(dir) | MALE | NO | Define alternate z390 install directory to run batch command. The default is set from J2SE Property "user.dir". |
| IPL(pgm) | E | none | Execute 390 program at startup. |
| LIST | ALE | YES | Generate PRN, LST, and LOG files for assembler, linker, and execution respectively. |
| LISTCALL | MA | YES | Generate level macro call and exit comments in BAL file which are used by assembler to format first level macro calls preceding assembler lines with "+" for macro generated source. |
| LISTUSE | A | YES | List active USING definitions each time USING or DROP changes status in the PRN assembly listing file. |
| LOADHIGH | E | YES | Load programs and allocate memory for GETMAIN/STORAGE from high end of first FQE large enough to satisfy request. The ASSIST option changes this option to NOLOADHIGH causing initial program to load starting at X'10000' which simplifies relative address calculations. |
| LOG(file) | MALE | pgm | Set file name for ERR, TR?, and LOG files. The default is the program name. This option is required when running multiple copies of the same program via CMD startup in order to create separate unique ERR, TR?, and LOG files. Otherwise duplicate programs running in parallel will mod the same ERR, TR?, and LOG file. |
| MAXCALL(50) | M | 50 | Set limit for nested macro calls. |
| MAXESD(1000) | AL | 1000 | Set limit for ESD sections or entries in one program. |
| MAXFILE(1000) | M | 1000 | Maximum macro and copybook files |
| MAXGBL(1000000) | M | 100000 | Maximum global macro variables |
| MAXHEIGHT(600) | E | 600 | Maximum pixel height for GUI dialog windows |
| MAXLCL(100000) | M | 100000 | Maximum local macro variables |
| MAXLINE(200000) | MA | 200000 | Maximum MLC, MAC, CPY, and BAL source lines that can be loaded into memory during an assembly. |
| MAXLOG(1000000) | MALE | 1000000 | Maximum GUI log file output before truncation begins by removing 50% to limit memory consumption. The only limit on size of log file is MAXSIZE. |
| MAXPARM(100000) | M | 10000 | Maximum length of any string during macro processing. This is an extension as HLASM limit is currently 1024. |
| MAXPC(50000) | M | 50000 | Maximum pseudo code instructions held in cache before LRU replacement begins. |
| MAXQUE(1000) | E | 1000 | Maximum output queue length from any CMD started task before queue messages are automatically copied to GUI output log to conserve memory and prevent stall. |
| MAXRLD(10000) | L | 10000 | Maximum RLD relocation records allowed in a program. |
| MAXSIZE(50) | MALE | 50 | Maximum size of any output file in MB |
| MAXSYM(50000) | MA | 50000 | Maximum symbols in one macro assembly |
| MAXWARN(4) | MA | 4 | Maximum MNOTE warning level without generating error. |
| MAXWIDTH(800) | E | 800 | Maximum pixel width for GUI dialog windows |
| MEM(1) | E | 1 | Memory allocated for 390 program execution in MB. Note for RMODE31 loads and GETMAIN's memory above the 16 MB line must be allocated. For example MEM(32) would provide 16 MB below the line and 16 MB above. |
| MINHEIGHT(150) | E | 150 | Minimum pixel height for GUI dialog windows |
| MINWIDTH(150) | E | 150 | Minimum pixel width for GUI dialog windows |
| MCALL | A | NO | List each macro call and exit on the PRN assembly listing in addition to first level calls if LISTCALL option is also on. |
| MOD | L | NO | Generate raw code file from lz390 with .MOD suffix and no header or trailer and no RLD's. |
| OBJ | A | YES | Generate relocatible object code file |
| OBJHEX | A | NO | Generate ASCII readable form of OBJ file with support for 31 bit long sections. The default is to generate binary OBJ file which is compatible with mainframe linkers but is limited to 24 bit long sections. |
| PARM('text') | E | none | Define character string parm to passed to executable program via address in R1 at startup pointing to half word length followed by EBCDIC characters. Default length is 0. |
| PC | M | YES | Generate macro pseudo code in cache memory for speeding up macro code that is executed more than once during macro expansion. |
| PCOPT | M | YES | Optimize macro pseudo code by looking for push, add/sub, store sequences and replacing them with inc/dec pseudo code opcodes. These pseudo codes are maintained in a cache in memory during macro execution only and have no affect on generated object code. |
| PROFILE(file) | M | NO | Insert COPY file in front of MLC source file |
| PROLOG | M | YES | Generate CICS prolog macro calls DFHEIGBL, DFHEISTG, and DFHEIENT if CICS option and PROLOG options are on. |
| PROTECT | E | YES | Prevent modification of PSA in low memory 8k block |
| REFORMAT | M | NO | Reformat expanded BAL code to align all opcodes at column 10 and operands at column 16 if possible. |
| REGS | E | NO | Generate GPR register trace before and after each instruction if TRACE option on. |
| RMODE24 | LE | YES | Set 390 load module options to load module below the 24 bit address line. |
| RMODE31 | LE | NO | Set 390 load module options to load module above the 31 bit address line. Note this options requires option MEM be set to include enough memory above the 31 bit address line. |
| STATS or STATS(file) | MALE | NO | Generate statistics file STA with final options listing, macro and copybook file listing, plus all program statistics. If file is omitted the program path and file name are used with STA suffix. |
| SYS390(dir) | LE | pgm dir | Define directory for storing and retrieving 390 load modules |
| SYSPARM('text') | M | none | Define text string which can be accessed by mz390 global macro variable &SYSPARM. |
| SYSTERM(file) | MALE | pgm.ERR | Define alternate file for all start/end messages plus any error messages, plus related source file statistics for each file containing errors. The default is the program name with ERR suffix. |
| SYSBAL(dir) | MA | pgm dir | Define directory for storing and retrieving generated BAL files. This option may also override file name and/or suffix (*.sfx overrides just the suffix in the pgm directory). |
| SYSCPY(dir) | MA | pgm dir | Define one or more directories for retrieving CPY source input files. |
| SYSDAT(dir) | M | pgm dir | Define directory for retrieving DAT source input files for AREAD. |
| SYSERR(dir) | MALE | pgm dir | Define directory for output ERR files. This option may also override file name and/or suffix (*.sfx overrides just the suffix in the pgm directory). |
| SYSLKD(file) | L | pgm dir | Define input source file for linker commands such as INCLUDE, ALIAS, ENTRY, and NAME. |
| SYSLOG(dir) | E | pgm dir | Define directory for output LOG file. This option may also override file name and/or suffix (*.sfx overrides just the suffix in the pgm directory). |
| SYSLST(dir) | AL | pgm dir | Define directory for output LST files. This option may also override file name and/or suffix (*.sfx overrides just the suffix in the pgm directory). |
| SYSMAC(dir) | M | mac dir | Define one or more directories for source MAC files. This option may also override suffix using *.sfx. |
| SYSMLC(dir) | MA | pgm dir | Define directory for source input MLC files. |
| SYSOBJ(dir) | AL | pgm dir | Define directory for OBJ relocatible object files |
| SYSOPT(dir) | MALE | pgm dir | Define directory for @file option files. This option may override suffix using *.sfx. |
| SYSPCH(dir) | M | pgm dir | Define directory for PCH output files from PUNCH. This option may also override file name and/or suffix (*.sfx overrides just the suffix in the pgm directory). Note PUNCH output is in ASCII source format and is not directed to the OBJ file. These files may be used as linker input commands via SYSLKD(file) option. |
| SYSPRN(dir) | A | pgm dir | Define directory for assembler listing PRN output files. This option may also override file name and suffix. This option may also override file name and/or suffix (*.sfx overrides just the suffix in the pgm directory). |
| SYSTRC(dir) | MALE | pgm dir | Define directory for output TRACE TR? files |
| TEST | E | NO | Start execution with interactive TEST mode active which prompts for commands such as T opcode or G opcode to trace or execution to the next occurrence of opcode name. |
| TESTDD(file) | E | NO | Define input command file to run TEST commands. See regression test rt\test\TESTTST1.MLC for example. |
| TIME or TIME(seconds) | MALE | YES | Limit execution time of each program to the number of seconds specified. The default is 15 seconds. This option is turned off if NOTIMING specified. Use NOTIME to allow tasks such as SOA servers like z390CICS to run continuously while still supporting application use of timing functions. |
| TIMING | MALE | YES | Calculate elapsed time and instructions per second statistics for display on START/END messages and STA statistics. tTIMING also displays current z390 and J2SE version on start message and memory usage on ended message. Note NOTIMING is used in regression tests to force generated files to be identical by using fixed data/time stamp using GregorianCalendar(2005,0,2,22,33,44). NOTIMING suppresses versions on start message and memory usage on ended message. NOTIMING also sets NOTIME which prevents application from using time functions.. |
| TRACE or TRACE(AEGLMPQTV) | E | NO | TRACE or TRACE(E) will turn on ez390 execution trace generation on TRE file and turn off CON. Any combination of the following trace options can be set using the TRACE(...) option. |
| TRACEA or TRACE(A) | A | NO | TRACEA or TRACE(A) will turn on az390 assembly trace generation on TRA file and turn off CON. |
| TRACEALL | MALE | NO | Turn on all trace options generating TRM, TRA, TRL, and TRE files and turn off CON. |
| TRACEC or TRACE(C) | M | NO | Trace copy file code for TRACEM and TRACEP. The default is NOTRACEC to eliminated redundant code that usually just contains global variable declarations. |
| TRACEG or TRACE(G) | E | NO | Turn on ez390 emulator trace generation on TRE file with trace of GETMAIN/FREEMAIN FQE memory management control block changes and turn off CON. |
| TRACEL or TRACE(L) | L | NO | TRACEL or TRACE(L) will turn on lz390 linker trace generation on TRL file and turn off CON. |
| TRACEM or TRACE(M) | M | NO | TRACEM or TRACE(M) will turn on mz390 macro processor trace generation on TRM file and turn off CON. |
| TRACEP or TRACE(P) | M | NO | TRACEP or TRACE(P) will turn on mz390 macro processor pseudo code generation and execution trace on TRM file and turn off CON. |
| TRACEQ or TRACE(Q) | E | NO | TRACEQ or TRACE(Q) will turn on ez390 emulator QSAM/BSAM DCB I/O trace generation on TRE file and turn off CON. |
| TRACES or TRACE(S) | M | NO | Displace MLC source lines on console regardless of CON setting to help locate any loops, waits, or hangs in large macro process. If MCALL is also on, then *MCALL and *MEXIT comments will also be displayed to show location with nested macros. |
| TRACET or TRACE(T) | E | NO | TRACET or TRACE(T) will turn on ez390 emulator TGET/TPUT and TCP/IO trace generation on TRE file and turn off CON. |
| TRACEV or TRACE(V) | E | NO | TRACEV or TRACE(V) will turn on ez390 emulator VSAM ACB/RPL I/O trace generation on TRE file and turn off CON. |
| TRAP | E | YES | Trap any unexpected J2SE program exceptions and generate emulator 0C5 exception which can be handled by SPIE/STAE exits if defined. NOTRAP can be used with Eclipse source debugger to stop at J2SE statement causing exception. |
| TS | MALE | NO | Generate JDBC compatible time-stamp on all TRACE and ERR file records for use in debugging time dependent issue. |
| VCB | E | YES | Generate VSAM cache buffer for improving VSAM performance by storing most recently accessed records and indexes. |
| XREF | A | YES | Cross reference symbols to source lines in PRN assembly listing. |
| ZSTRMAC | M | YES | Support expansion of ZSTRMAC structured conditional macro code instructions during loading of MLC, MAC, and CPY files. |
The following options can be added to the Z390.BAT startup command file in the install directory which is executed when you double click on the z390 desktop icon:
- /SC maximize.ini - the /sc option executes the z390 startup commands in the named file. See the z390 User Guide for list of commands including changing the location and size of the z390 GUI dialog.
-
/NP – suppress all permissions to test web version
-
/NT – suppress the unique time stamp included in the default log file name (By default the unique time stamp insures a log of all z390 commands executed are retained for each instance of z390 GUI window, command line, and batch file executions. The log files can be deleted periodically.)
z390 GUI Environment Variable Options
Environment variables are supported on both Windows and Linux for setting the following z390 GUI options. Environment variables are also used to define the file specifications for DDNAME's used in z390 macro assembler program extended AREAD and PUNCH statements and in DCB's and ACB's for file access. The environment variables for batch execution must be set in z390 BAT command or in individual batch commands prior to executing program since each batch command runs in its own environment space.
- Z390ACROBAT=cmd.exe /c Start - default started task for processing Acrobat PDF commands
- Z390BROWSER=cmd.exe /c Start - default started task for web browser started by z390 to access www.z390.org online documentation. For Windows Start invokes IE. For Linux the default is firefox.
- Z390COMMAND=cmd.exe - default batch command processor used by z390 GUI for unknown commands. On Windows this is the standard Windows BAT file command processor. For Linux this is a Perl script named cmd.pl which processes Windows compatible BAT command files and performs the same functions.
- Z390EDITOR=notepad.exe - default GUI editor started by z390 GUI using the EDIT command. For Linux the default is gedit.
- INSTALL="c:\Program Files\Automated Software Tools\z390" - default z390 install location
The following J2SE runtime startup options may be added to any of the following z390 commands:
- z390.bat - start the z390 GUI which in turn runs z390 batch commands in the background
- mz390.bat - run the z390 macro assembler (called from ASMLG, ASML, and ASM commands)
- lz390.bat - run the z390 linker (called from ASMLG, ASML, and LINK commands)
- ez390.bat - run the z390 emulator (called from ASMLG and EXEC commands)
Any of the following J2SE options can be added to the above command files by setting J2SEOPTIONS environment variable:
- -classpath path to jar file (the z390.jar containing all z390 classes is in the install directory)
- -verbose:gc trace garbage collection to detect memory leaks (useful for debugging memory leaks)
- -XmsnK set initial memory allocation to nK (useful to force larger J2SE alloc memory, but can stall OS)
- -XmxnK set max memory allocation to nK (useful to reduce default J2SE alloc memory if needed)
- -Xrs allow control break interruption of java tasks (allows user CTRL-BRK interruptions)
| TYPE | Scope | Format | File Description | File or Report Format Description |
| BAL | MA | ASCII | Basic Assembly Language generated ASCII source file generated by mz390 when option BAL is specified. When option ASM is on (the default), mz390 starts az390 as a separate process running in parallel and passes generated BAL statements directly to it. This allows the first pass of assembler processing to be overlapped with macro expansion and eliminates need to write this file to external disk. | Basic Assembler format is free form within first 71 characters with optional label starting in position 1 followed by opcode followed by operands if any. If continuation is required a non-space character appears in position 72. Positions 73-80 may be used for sequence numbering. The ICTL instruction may be used to change these default setting but it is not recommended as the macro and copybook files are all in the default format. |
| CPY | MA | ASCII | Copybook source included in source programs, macros, or other copybooks | Same format as BAL |
| DAT | M | ASCII | Text data input files read via AREAD statements in macro processor specifying ID=, DDNAME= or DSNAME= extended parameters. AREAD with no extended parameters reads the next statement in the input stream. | Same format as BAL |
| ERR | MALE | ASCII | Output log of all START and ENDED messages plus any errors plus any error file references. | Text file with messages showing start and stop statistics for each step and any error messages issued by those steps. A cross reference of all macro and copybook files with errors is included at the end. For full cross reference of all macros and copybooks used see STA file. |
| LOG | E | ASCII | Output log of for GUI or batch command execution controlled by CON option | Test file with messages issued udring program execution including start and stop statistics plus any errors and any WTO write to operator messages. |
| LKD | L | ASCII | Optional input command for linker (INCLUDE, ENTRY, ALIAS, NAME) | Same format as BAL. |
| MAC | M | ASCII | macro source files | Same format as BAL. |
| MLC | M | ASCII | macro assembler source programs read by mz390 | Same format as BAL. |
| MOD | LE | binary | Binary code output from linker with no header and no RLD records. This type file can be created using option MOD and can be loaded as a data table by Micro Focus CICS, | Binary file with all CSECT binary data. For example DC C'ABC' using option MOD will result in 3 byte MOD file containing x'C1C2C3'. |
| OBJ | AL | EBCDIC ASCII |
Output relocatible object code file for macro assembler with two format options. | The default is mainframe linker compatible relocatible object code 80 records (ESD, TXT, RLD, and END). When OBJHEX option is specified for assembler, ASCII readable text extended format supporting 31 bit long sections is generated. The z390 linker can read either format by examining file. |
| OPT | MALE | ASCII | Optional options files referenced via @file option from command line or other option files | Text file with z390 options entered in free format delimited by spaces. An * will terminate options on a line and start comments on that line. |
| PCH | M | ASCII | Output text files written via PUNCH statements in macro processor using optional ID=, DDNAME=, or DSNAME= extended parameters. The default is pgm.PCH. | Text file output which is not limited to 80 byte BAL format. Any macro program generating BAL output must format continuations. |
| PRN | A | ASCII | Output assembly language listing from az390 | Text
file with the following listing fields: 1) hex relative offset to instruction 2) hex bytes in instruction or data with up ot 8 bytes per line. Direction PRINT DATA will force listing all data 8 bytes per line. 3) (file#/file-line#)generated-line# identified the file # and the relative file line #for the MLC, MAC, or CPY file that the generated line came from followed by the sequential generated line #. 4) Flag field has + for macro generated lines, and = for line from copybook. 5)BAL line with label, opcode, and operands. |
| STA | MALE | ASCII | Output statistics file listing options set, program statistics, and file references | Text file with detail statistics on each step including all option settings, complete macro and copybook cross reference for mz390, and execution statistics. |
| TRA | A | ASCII | Trace output file for assembler (lists each line being assembled during each pass) | Text file with ma390 assembler trace output including source file name, relative line, generated line, relative hex offset, and source statement for each assembler pass which may be 2 or more depending on usage of LOCTR. |
| TRE | E | ASCII | Trace output file for emulator (lists each instruction, address, and operand values) | Text file with ez390 emulator execution trace output showing, hex psw address, condition code, hex instruction, mnemonic, operand register and storage values at the start of each instruction. Blank line inserted for each branch to non sequential address. The high bit of PSW hex address indicates 24 or 31 bit address mode. |
| TRL | L | ASCII | Trace output file for linker (lists each OBJ record processed) | Text file with lz390 linker trace output including ESD external symbol hex addresses and lengths, TXT text records with relative offset within ESD and hex data. RLD relocation records showing hex offset, field length, and ESD symbol. |
| TRM | M | ASCII | Trace output file for macro process (TRACEM lists each macro line executed, TRACEP lists every macro pseudo code instruction executed showing the current value of local and global variables used in SET statements and AIF statements etc.) | Text file with mz390 macro processor trace output file which is typically generated in parallel with the generation of the first pass information in the TRA file since mz390 and az390 run as concurrent tasks. This file includes source file name, relative line number, and source macro statement. For generated BAL output lines the source file# and relative line# cross reference is also include. If the TRACEP option is specified, this file also includes listing of the generation and execution of macro pseudo code instructions. |
| ZSM | M | ASCII | ZSTRMAC Structured Conditional Macro source programs. | Use ZSTRMAC.BAT file1 file2 to translate ZSM type file to standard HLASM compatible MLC type source file. |
| 390 | LE | binary | Executable z390 load modules created by linker from OBJ files and loaded by emulator. | The
390 load modules contain 20 byte header with the following: 1) 4 byte ASCII character version '1002' 2) 1 byte flag AMODE31 'T' or 'F' 3) 1 byte flag RMODE31 'T' or 'F' 4) 2 bytes reserved '??' 5) 4 byte length of code 6) 4 byte offset to entry 7) 4 byte count of RLD's following code The code for all CSECTS follows the header. The RLD table follows the code if any. Each RLD field in load module is relocated by the load address determined at load time. The 5 byte RLD records are as follows: 1) 4 byte offset to RLD field in code 2) 1 byte field length See option MOD and file type MOD to create code without header or any RLD's. |