ZPAR - z390 and zcobol
to z390 and zcobol Program Analysis Reports documentation website.
The ZPAR utilities and reports documented here are all written in
structured macro assembler and are included with the installation
of z390 portable mainframe
assembler starting with PTF v1.5.00e. The utility
supports batch assembly or compile of all the source programs in a
directory with a single command. For example, all the z390
demo programs in the demo directory can be assembled with the
zpar\ZPARGEN ASM demo\*.MLC
All the zcobol demo programs in the demo directory zcobol\demo can be compiled with the single command:
zpar\ZPARGEN ZC390C zcobol\demo\*.CBL
The report generator ZPARERR can be used to summarize all the ERR files generated by the z390 assembler
in a directory showing the total number of occurrences of any
error messages and the total number of ERR files found. For
example following the above batch assembly of demo programs, the
following command will generate report summarizing any errors
The report generator ZPARTRS (TRace Source) can be used to obtain an execution trace showing the assembler source statement for each instruction executed along with the PSW address, condition code, module name, and relative offset within the module of the source line. For example the following command will generate execution source trace report for the demo program demo\DEMO.MLC:
(assemble, link, and execute with trace)
See examples of COBOL, Assembler, and EXEC CICS source execution traces
The utility FIXCRLF simple copies all the specified ASCII source files adding ASCII CR/LF at the end of each line. This has been used with files created with just LF at the end of each line as some editors and programs require both CR and LF.
Any and all comments, suggestions, requests, and volunteer contributors are welcome. Join the z390 email group and post to the group or email me directly.
ZPARGEN can be used to assemble or compile all the programs in a directory. It can also be used to execute any specified batch command for selected files in a directory. The command syntax is as follows:
zpar\ZPARGEN command dir\file.type
command - is any batch command such as ASM or ZC390C
dir\file.type - is a directory and file selection specification
such as demo\*.mlc or
A temporary file named zpar\TEMPGEN.DIR is generated containing directory records for selected files. A temporary file named zpar\TEMPGEN.BAT is generated containing calls to the specified command for each selected file. Then TEMPGEN.BAT is called to execute the commands.
ZPARERR - Error Summary Report
ZPARERR can be used to summarize all the errors generated in z390 ERR files in a directory. The command syntax is as follows:
dir\file - is a directory and file selection specification such as demo\* or zcobol\demo\*
A temporary file zpar\ZPARERR.DAT is generated with all the selected ERR file records. A temporary report file zpar\ZPARERR.RPT is generated with the following summary of the ERR records:
1. Current date and time of report and file selection
ZPARMLC - Frequency Distribution of MLC Operation Codes
This command reads one or more MLC or BAL type source files and generates report with frequency distribution of the operation codes found. First the counts and opcodes are listed in descending order by frequency and then alphabetically by operation code. See zcobol NIST test program generated opcodes for examples.
ZPARSUM1 - Error Summary Report with START/STOP by 2 char program prefix
Same summary of ERR file statistics as ZPARERR with addition of breaking down program START and STOP statistics by 2 character program name prefix. The command syntax is as follows:
ZPARSUM2 - Summary report of program translation, assembly, and execution by 2 character prefix
This command executes ZPARSUM1 and then ZPARSUM2 to produce summary report by 2 character prefix showing the number of programs translated, assembled, and executed with return code 0 or >0. For example see the NIST COBOL 1985 test results. The command syntax for this command is as follows:
FIXCRLF - Fix carriage return and line feed
FIXCRLF can be used to insert carriage return character (X'0D' at end of each ASCII line preceding line feed character (X'0A'). This is required by some older ASCII editors and other text processing programs. The command syntax is as follows:
zpar\FIXCRLF dir\file.type newtype
dir\file.type - is a directory and file selection specification such as mydir\*.*
newtype - new file type to be assigned to each new output file mydir\*.newtype
IBM, CICS, HLASM, MVS, OS/390, VSAM, z9, z10, and z/OS
are registered trademarks of International Business Machines Corporation
This page last updated
Wednesday May 23, 2012.
Copyright 2011 Automated Software Tools Corporation