This chapter introduces you to the Open PL/I Source Checker.
The Open PL/I Source Checker, plicheck, is a utility that enables you to scan sets of PL/I source code identifying all features that are not yet supported by the Open PL/I compiler. The results are reported in tabular form.
The source checker is run by use of the mfplx command with the -check option. This command allows you to use the Open PL/I Macro Preprocessor, to run the source checker on multiple source files producing a single report for all of your PL/I source code, to specify the directories containing your include files, and to employ other Open PL/I options that may be needed to describe your source code.
The command syntax is as follows:
mfplx file-list -check [-report report-filename][other mfplx options]
If the -report option is not used, the output of the source checker will be directed to standard error.
mfplx appl* app2.pl1 subdir/app3* -check -report app.rep
If your source code contains macro preprocessor statements (which therefore require the Open PL/I Macro Preprocessor), you must specify the -macro option, and you may also specify any of the other Preprocessor options described in the chapter Using Open PL/I.
All include files needed by your source code must also be accessible for the source checking operation. You may specify include-file search paths by use of the -ipath and -isuffix options that are described in the chapter Using Open PL/I. if these options are not used, your include files must be in the current working directory.
Other options described in the chapter Using Open PL/I, such as -longint and -margins, may also be needed.
Two environment variables can be used to control the source checker: LPI_PLI_CHECKER and TMPDIR.
You can set the environment variable LPI_PLI_CHECKER to point to the directory where the source checker resides. If LPI_PLI_CHECKER is not set, mfplx will try to invoke the source checker from the normal Open PL/I installation directory, MFPLI_PRODUCT_DIR.
The TMPDIR environment variable tells the source checker where to create temporary scratch files. If TMPDIR is not set, scratch files are created in your current working directory. Scratch files are deleted after use.
Note: The Open PL/I Source Checker does not report a complete syntax and semantic analysis of your source code. It serves only to report PL/I features used in your source code that are not supported by the current release of Open PL/I. It does not report errors in your code.
To gain full advantage of the Open PL/I Source Checker, the source code presented to it must be complete, including all include files that are needed, and must be capable of compilation without error. Errors in your code will cause the source checker to skip over portions of your code, and may even cause the source checker to abort its check of some source files.
Copyright © 2009 Micro Focus (IP) Ltd. All rights reserved.