MFUPP Directives

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;