COMPILE: library compiler

Description

Compiles all programs of the same language in a given library. Produces a log showing return codes, record counts, and system usage statistics.

Categories

Program Maintenance
Program Development

Related files

COMPILE: Object file for utility.

Selected compiler: COMPILE supports COBOL, RPGII, BASIC, Assembler, and FORTRAN4.

LINKER: COMPILE will optionally link the object files.

User Instructions

Compiles and links multiple programs. All entries must be the same language and reside in the same library. Compiled object files can also be linked. Processes all files in a library or selected files only.

COMPILE begins by prompting for the input and output libraries, source language, whether linking is desired, and an option for scratching prior object and print files. Entire libraries may be processed or the user can select specific files to be processed. (Important note: COMPILE accepts up to 256 file names; file counts in excess of that limit must be processed in stages.)

The program then presents the options screen from the compiler in use. The entries made to this screen are retained and passed to all successive programs processed during the run.

If linking is selected, the program prompts for the link options. These options reflect fields on 6-level operating systems, and will not be complete for recent versions of LINKER.

The program then begins the compile, with selected run statistics displayed on the screen. When completed, the EOJ screen allows the user to re-run the program or exit. The compiler run statistics are available in report form, showing the file, return code, number of records, elapsed and CPU time, disk I/Os, and paging activity. In addition, specific compilers and the LINKER may produce listings of their own.

Programmer Instructions

While COMPILE is designed for interactive use, two of the primary screens are GETPARMs. Important note: due to the on-screen statistics and inability to completely control COMPILE from a program, it is not possible to run COMPILE in non-interactive (background) mode.

LIBRARY     Press (RETURN) to continue or PF(16) to exit
            program.

  LANGUAGE  (blank)     May be COBOL, RPGII, Assembler, or
                        FORTRAN4.  All source files to be
                        compiled must be the same language.

  INLIB     (blank)     The location of the input (source)
  INVOL     [invol]     files to be compiled.

  OUTLIB    (blank)     The location of the output (object)
  OUTLIB    [outvol]    files to be produced.

  SELECT    NO          Set to YES to display a list of the
                        files in the INLIB and allow specific
                        files to be selected.

  SCRATCH   NO          Set to YES to scratch prior object
                        and print files without warning.

  LINK      NO          Set to YES to link all object files
                        created.

  LOADLIB   (blank)     The location of the linked output
  LOADVOL   (blank)     (object) files to be produced (if
                        different than the OUTLIB location).

EOJ         Press (RETURN) or PF(16) to exit the program or
            PF(01) to run again.  (There are no additional
            data items on this screen.)

Assembler source is available.

Example of use

Designed for those inevitable library compiles endemic to programming organizations. Produces a concise summary of compile operation, complete with the return codes for all processes.

The files are compiled in the order they appear on the disk. In some circumstances, internal program linking needs may require some programs to be compiled manually; if so, the SELECT option may be used to bypass these programs.

Comments

Libraries with more than 256 files will cause unpredictable results; use the SELECT option to reduce the file count below this amount.

Does not work properly with version 2.0 or above of the Wang LINKER utility due to the additional screens required by the new LINKER. (SUPRLINK does work, and it may be used to link the compiled programs after COMPILE is complete.)