The MFUPP preprocessor is invoked using the PREPROCESS Compiler directive.
The following directives can be used with the MFUPP preprocessor:
- CONFIRM, C
- Specifies whether directives are to be shown on the screen, if accepted.
- Permissible values: CONFIRM | NOCONFIRM, C | NOC
- Default: NOCONFIRM
- IGNORE-PRG-PREFIX, IPP
- Changes program-ids that the preprocessor will ignore (that is, will not pass execution to the controller entry point when
the program is called).
- Permissible values: IGNORE-PRG-PREFIX"file-prefix" | NOIGNORE-PRG-PREFIX, IPP"file-prefix" | NOIPP
- Default: IGNORE-PRG-PREFIX"MFUT,MFUM,Test"
- INSERT-LS, IL
- Inserts a local-storage section if the source under test is not enabled for recursion. (This avoids a
COBRT166 Recursive COBOL CALL is illegal error, as the preprocessor requires source to be compiled for recursion).
- Permissible values: INSERT-LS, IL | NOINSERT-LS NOIL
- Default: INSERT-LS
- MOCK, M
- Turns on or off the instrumentation of the program under test.
- Permissible values: MOCK | NOMOCK
- Default: NOMOCK
- PD-PREFIX, PDP
- Changes the "procedure division" copybook filename insertion prefix; see
Inserting Test Code into Source Code.
- Permissible values: PD-PREFIX"file-prefix" | NOPD-PREFIX, PDP"file-prefix"| NOPDP
- Default: PDS-PREFIX"MFUPD_"
- VERBOSE, V
- Specifies whether verbose messages are to be shown on the screen.
- Permissbile values: VERBOSE | NOVERBOSE
- Default: NOVERBOSE
- WS-PREFIX, WSP
- Changes the "working-storage section" copybook filename insertion prefix; see
Inserting Test Code into Source Code.
- Permissible values: WS-PREFIX"file-prefix" | NOWS-PREFIX, WSP"file-prefix" | NOWSP
- Default: WS-PREFIX"MFUWS_"
Example
cobol myprog.cbl preprocess"mfupp" MOCK PD-PREFIX"MFUPRO_" endp;
Tip: You can store the directives to be used with the preprocessor in a directives file, named
mfupp.dir. In this file, specify only the directives shown above, and only one per line. When using the file, ensure it is in your
working directory, and then specify the preprocessor without any directives; for example:
cobol myprog.cbl preprocess"mfupp" endp;