Previous Topic: Notes

Next Topic: YEXCSQL (Execute SQL Statements) Command

Example

To print each function by executing model object list IM0033 from the model contained in the current library list with the Document Model Functions command (YDOCMDLFUN):

YEXCMDLLST CMD( YDOCMDLFUN + MDLFILE(&YO) MDLFUN(&YN) ) MDLLST + (*MDLLIB/IM0033 )

YEXCOVR (Execute with preprocessor) Command

The YEXCOVR command executes a user-specified command that invokes the CA 2E Toolkit compile preprocessor program. The preprocessor processes preprocessor directives held in a source member. The source lines are identified with Z*, Y*, T*, X* or P*.

There are two parameters you can use to specify the request to be executed: CMD and RQSDTA. Each parameter allows the request to be specified, so they are mutually exclusive. Alternatively, a source member that contains preprocessor directives can be specified in the SRCFILE and SRCMBR parameters.

Parameters

The following are parameters for the YEXCOVR command.

CMD

The command to be executed. This parameter is a *CMDSTR, allowing the command to be prompted and validated before execution.

RQSDTA

This parameter allows the command to be entered as a string. The details of the request will not be validated until run time.

*CMD

Use the command specified in the CMD parameter.This is the default.

*SRCMBR

Processes the preprocessor directives in the source member specified in the SRCFILE and SRCMBR parameters.

request-data

Processes the specified data.

SRCFILE

Specifies the name of the source file that contains the source member to be processed and the library where the source file is stored.

Note: This parameter is ignored unless RQSDTA(*SRCMBR) is specified.

Possible library values are:

*LIBL

The system searches the library list to find the library where the source file is stored. This is the default.

*CURLIB

The current library is used to find the source file. If you have not specified a current library, QGPL is used.

library-name

Enter the name of the library where the source file is stored.

SRCMBR

Specifies the name of the member in the source file that contains the preprocessor directives to be processed.

Note: This parameter is ignored unless RQSDTA(*SRCMBR) is specified.

Usage

The YEXCOVR command is used to ensure that any Toolkit preprocessor directives (Z*, Y*, T*, X* and P* source lines) stored in a source member are processed when the source member is compiled. All source members compiled from within a CA 2E model automatically invoke the preprocessor, but unless you have changed your system to automatically invoke the preprocessor when compiling source members from PDM, it will not be invoked.

To set up your system to use the preprocessor, open the CA 2E Toolkit main menu by running the following command:

YGO *Y1

Take option 6 (Installation and Authorization) to display the CMDINZ menu, and then take option 7 (CA 2E Toolkit Compile Pre-processor). This will take you through the necessary steps to set up your system to automatically use the preprocessor.

Examples