xpxCompileExpress_X

FUNCTION xpxCompileExpress_X (fileName          : STRING;
                              diagnosticFile    : STRING;
                              options           : INTEGER;
                              VAR noOfWarnings  : INTEGER;
                              VAR noOfErrors    : INTEGER)
                              status            : INTEGER;

This function runs one or more Express schemata through the EDMexpressXCompiler. Optionally it creates and populates an EXPRESS-X dictionary model in the EDMdatabase of one or more of the compiled schemata.

Arguments


TypeNameComment
STRINGfileNameThe Express-X schemata to be compiled. The fileName argument can specify more than one file by using wild cards (star) or by specifying several file names separated by the comma character. Any number of schemata can reside in one file. Short form schemata as well as long form schemata can be compiled. Short form schemata is schemata that contains interface (USE FROM , REFERENCE FROM) constructs.
STRINGdiagnosticFilespecifies the name of a file that will receive the error and warning messages from the EDMexpressXCompiler. If the diagnosticFile is an empty string or has the value indeterminate (question), then the output from the EDMexpressXCompiler will be to the EDMmodelConverter standard output window.
INTEGERoptionsSee below; The options argument should be specified as a zero or as a sum of one or more integer constants.
INTEGERnoOfWarningsnumber of warnings detected during the compilation process.
INTEGERnoOfErrorsnumber of errors detected during the compilation process.

Return Value


Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_XPX_Return_Value'.

Options


 

OptionComment

STORING_SOURCE

Specifies that the Express schema(ta) in its original form will be stored in the EDMdatabase.   This option is automatically enabled in the operation independent of being set in the <options> argument or not. Hence the original source schemata will always be stored in the EDMdatabase.

DELETING_EXISTING_SCHEMAS

Specifies that the existing dictionary model(s) with the same name as the resulting dictionary model(s) from this compilation will be replaced by the new dictionary model(s) as long as there are no data models associated with this (these) existing dictionary  model(s). Dictionary models with associated data models or associated Express-X dictionary models cannot be deleted before all the associated data models or associated Express-X dictionary models are deleted.

PARSE_ONLY

Specifies that the Express-X schema(ta) will be checked for syntax errors only. No dictionary models will be created when this option is enabled.

NO_DICTIONARY_MODEL

Specifies that no Express-X dictionary models will be created by this invocation of the EDMexpressXCompiler .

CONTINUE_STORING_ON_ERROR

Enforces the EDMexpressXCompiler to create and populate Express-X dictionary model(s) of erroneous schema(ta). Only dictionary models of schema(s) compiled without any errors can be stored as an Express-X dictionary model(s) in the EDMdatabase when this option is unset.
NOTE: This option should be used with care as it may lead to unpredictable consequences, possibly fatal system failure!

SDAI_WARNINGS

Activates EDMinterface/SDAI warnings relevant for the usage of EDMinterface functions on an instantiated data model of the actual schema.

ERRORS_ONLY

Warnings will be suppressed.

HTML_ERROR_LISTING

Specifies that compilation diagnostics will be written in HTML on files in the directory defined by the system variable EDMS_TMP_DIR. The diagnostic report is ready to be displayed by an Internet browser. There are three or four HTML diagnostic files with the following names:

  • On UNIX: s_main.html, s_err.html, s_exp0.html and optionally s_sch.html
  • On Windows: s_main.htm, s_err.htm, s_exp0.htm and optionally s_sch.htm

The file named s_main.htm or s_main.html is the main file, hence this file should be specified to the actual Internet browser when displaying the diagnostic report.

MAP_INHERITANCE_REPORT
Specifies that a report of map inheritance should be written to the EDMinterface current output device.  This option is effective only when the MAP_INHERITANCE option is enabled.
INSERT_PROJECT_FILEThe actual EDMcompiledrProject file will be copied as comment in the resulting long form file
INSERT_SHORT_FORM_FILE_NAMES_LIST
The (full) file name of all source files and include files will be listed in the "actual order in the result file" as comment on the resulting long form file
INSERT_FILE_BEGINNING_ENDING_MARK
The beginning and end of each source file and include file will be listed as comment in the resulting long form file
INSERT_LONG_FORM_LINE_NUMBERS
 Line numbers of the long form file will be listed as comment
INSERT_SHORT_FORM_LINE_NUMBER
Line numbers of each source file and include file will be listed as comment

Example


<Missing Example>

 

See also

Filter by label

There are no items with the selected labels at this time.