EntireX Version 9.7
 —  EntireX Workbench  —

Server Mapping Files for Natural

Server mapping enables the RPC server to correctly support special Natural syntax such as REDEFINEs, special Natural Mapping Editor operations, etc. If one of these elements is used the IDL Extractor for Natural automatically extracts a server mapping file in addition to the IDL file (interface definition language). Also the Natural Wrapper may generate a server mapping file for RPC server generation. The server mapping file is used at runtime to marshal and unmarshal the RPC data stream. Client-side mapping files (EntireX Workbench files with extension .cvm) are used for Natural only. This document covers the following topics:

Server Mapping Files in the EntireX Workbench

The server mapping file for Natural in the EntireX Workbench is of type client-side. There are no server-side mapping files as with COBOL.

Client-side Mapping


The following rules apply to a server mapping file for Natural:

Top of page

When is a Server Mapping File Required?

IDL Extractor for Natural

Natural Syntax Natural Mapping Editor Server Mapping Reqired More Information
REDEFINE   yes Extracting Natural REDEFINES under Natural to IDL Mapping in the IDL Extractor for Natural documentation
all Rename of program yes Renaming a Program
all Multiple interfaces yes Extracting Multiple Interfaces
all Set constant yes Setting Natural Parameters to Constants
all Suppress yes Suppressing Natural Parameters
Other combinations no  

Natural Wrapper

Natural Wrapper Server Mapping Required More Information
IDL program name is not a valid Natural name and is therefore adapted, or the Natural program name is customized yes Step 2: Customize Natural Server Names under Using the Natural Wrapper for the Server Side within NaturalONE

Top of page

Source Control of Server Mapping Files

Because server mapping files (EntireX Workbench files with extension .cvm) contain text data only, a server mapping file is text-based (although it is not intended for human consumption). Therefore, you can include it in your source control management together with the IDL file and the Natural source(s) as a triplet that should always be kept in sync.

Top of page

Comparing Server Mapping Files

For server mapping files (EntireX Workbench files with extension .cvm), you can use a third party file/text compare tool to check if two files are identical.

A server mapping entry (corresponding to a line in a server mapping file) contains a creation timestamp at offset 276 (decimal) in the format YYYYMMDDHHIISST. The precision is 1/10 of a second.

Top of page