mfexecpp Utility

The mfexecpp utility handles precompiles of PL/I for EXEC CICS, EXEC SQL and EXEC DLI. You can run it directly from an Enterprise Developer command prompt to manage your own build processes. The mfplx utility also runs mfexecpp automatically when used with the -cics, -sql, or -dli parameters. See mfplx Options for details.

Syntax

mfexecpp program-name.pli parameters

Parameters

program-name.pli
The name of the PL/I program. Include the full path if the file is not in the current directory.
parameters
One or more parameters separated by a space, including:
-mvs Create a shared object to execute under JCL.
-nowarn Suppress warning messages, same as -flag E .
-err_on_stdout Output compiler error messages to STDOUT as opposed to STDERR.
-ipath Search path for include files.
-v Show version number of preprocessor(s) and compiler.
-bifprec Sets the precision of built-in functions (allowed values: 15 or 31).
-bigendian Treat Fixed Bin, Char Var, Widechar Var as bigendian; (Intel only).
-bitsltr Bit Storage Order Left-to-Right (Intel only).
-currency_symbol Select alternate currency symbol for picture specification.
-cics Compile and/or Link to execute under CICS.
-native Force implied -bigendian off when -cics, -dli, -sql, -ims, -mvs used.
-nonnative Same as -bigendian.
-default '-default conn' array parameters have CONNECTED attribute by default.
-default_binary Uses BINARY if the FIXED attribute is specified without BINARY or DECIMAL.
-default_decimal Uses DECIMAL if the FIXED attribute is specified without BINARY or DECIMAL (default).
-dft 'dft conn' - Same as '-default conn'.
-dli Run DLI preprocessor and/or link with mfexecpp DLI support.
-dummy aligned|unaligned. See Compiler Options.
-ebcdic Use EBCDIC character encoding for character data.
-fb7asfb15 Treat fixed bin(7) as fixed bin(15).
-fbmaxp Same as -fixed_bin_max_p .
-fixed_bin_max_p FIXED BIN max precision (allowed values: 63 or 31 default).
-fdcheck Check for FIXED DEC loss of digits.
-fdmaxp Same as -fixed_dec_max_p .
-fixed_dec_max_p Specify FIXED DEC max precision (max 31 is default).
-flag Produce diagnostics for I, W, E or S level errors.
-fldftp Same as -float_bin_dft_p .
-float_bin_dft_p Specify FLOAT BIN default precision (allowed values 21,23,24).
-f Synonymous with -flag .
-fdasfb Use float binary for float decimal (default).
-fmaxp Use floating point for trigonometric functions and related arithmetic built-ins.
-graphic Enables GRAPHIC support.
-initcheck Check for possible uninitialized variables.
-initcall Specify Initial Call subroutine (case sensitive).
-ipubr Inverse bits for UNSPEC, INT, and POSINT on big-endian machines.
-isuffix Include file suffix.
-longint Set the default fixed bin precision to 31.
-laxbased Disable storage checking on BASED (ADDR(x)).
-laxdcl Allow implicit declarations of undeclared variables (default).
-laxdefined Disable checking on invalid DEFINED.
-laxif IF, WHILE, UNTIL, WHEN clauses do not require BIT(1) expr (default).
-laxinit Disable dependency reordering of auto-initializers.
-laxother Disable checking SELECT with no WHEN clause.
-margins Set input source margins.
-maxmsg Max diagnostics at level I|W|E|S[,n].
-multiclose Allow multiple closure of blocks and groups.
-names Specify additional NLS characters.
-nodescriptors Do not generate argument descriptors.
-nofdasfb Do not use float binary for float decimal.
-nofdcheck Do not check for FIXED DEC loss of digits (default).
-nofmaxp Use PLI standard conversion rule trigonometric functions and realted arithmetic built-ins.
-nographic Disables GRAPHIC support (default).
-noinitcheck Do not check for possible uninitialized variables (default).
-nolaxbased Enable storage checking on BASED (ADDR(x)).
-nolaxdcl Do not allow implicit declarations of undeclared variables.
-nolaxdefined Enable checking on invalid DEFINED.
-nolaxif IF, WHILE, UNTIL, WHEN clauses require BIT(1) expr.
-nolaxinit Enable dependency reordering of auto-initializers.
-nolaxother Enable checking SELECT with no WHEN clause.
-nolist Do not produce source listing.
-nomulticlose Do not allow multiple closure of blocks and groups (default).
-noplitdli PLITDLI calls handled as user entry point (default).
-not_symbol Specify an alternate NOT symbol.
-optcics See Compiler Options.
-optdli See Compiler Options.
-optexec See Compiler Options.
-optsql See Compiler Options.
-or_symbol Specify an alternate OR symbol.
-paramcount Enable use of the PARAMCOUNT built-in function.
-plitdli PLITDLI calls handled as special IMS linkages.
-ppcics Specifies CICS preprocessor output filename and saves it.
-ppdli Specifies DLI preprocessor output filename and saves it.
-ppsql Specifies SQL preprocessor output filename and saves it.
-proto More extensive prototype checking parameters vs entry declarations.
-rc Sets zero return code level, -rc 4,0 default.
-shortint Set the default FIXED BIN precision to 15 (default).
-setnull Select value of null pointer.
-sql Indicates using the SQL preprocessor. Takes one of the following sub-options:
  • db2
  • oci
  • odbc
-sqlopts See Compiling SQL Applications.
-stardesc Produce argument descriptors only for (*) length or dimension items.
-structure_fillers Produce warning messages for structures containing fillers.
-systemcics Compile and/or Link to execute under CICS.
-systemims Compile and/or Link to execute under IMS.
-systemmvs Compile and/or Link to execute under JCL.
-rtxit Enable user exit calls for exec statements.
-vax Use VAX conventions.
-warn Issue diagnostics with severity level Warning or higher, same as -flag W .
-window Window value for date/time built-ins.
-xmlattr XMLCHAR -xmlattr apostrophe or quote.
-xmlcase XMLCHAR -xmlcase upper or as-is.
-zalign Specifies Z/OS aggregate mapping and alignment rules.
-zchar Specifies Z/OS CHAR & CHAR VAR attribute rules (unaligned).
-zfloat Specifies Z/OS FLOAT BIN default precisions (21 & 53).
-zp1 Treat structure mapping and based variables as unaligned.

Examples

mfexecpp - A CICS program named cicsprog.pli:
mfexecpp cicsprog.pli -cics

mfexecpp - An SQL program named sqldb2.pli that uses a DB2 LUW database:

mfexecpp sqldb2.pli -sql db2

mfexecpp - An SQL program named sqlodbc.pli that uses a SQL Server database:

mfexecpp sqlodbc.pli -sql ocbc

mfplx - An IMS EXEC DLI program named imsdli.pli that uses CICSand a DB2 LUW database:

mfplx -dli -cics -sql db2