Version 9.6
 —  Software AG IDL Extractor for Natural  —

Handling CVM Files

A client-side server mapping file (CVM) enables the RPC server to correctly support special Natural syntax such as REDEFINE and other special situations. If one of these elements is used, the EntireX Workbench automatically extracts a CVM file in addition to the IDL (interface definition language), or a CVM file is generated by the Natural Wrapper for a server skeleton. The CVM file is used at runtime to marshal and unmarshal the RPC data stream.

This document covers the following topics:


CVM Files in the EntireX Workbench

In the EntireX Workbench a CVM file has to relate to an appropriate IDL file; always keep the IDL file and the CVM file together in the same folder.

Top of page

Source Control of CVM Files

Because CVM entries within a CVM file contain text data only, a Workbench CVM 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

Compare CVM Files

For CVM files in the EntireX Workbench format, you can use a third-party file/text compare tool to check if two files are identical.

The CVM entries (corresponding to lines in a Workbench CVM file) contain a creation timestamp at offset 276 (decimal) in the format YYYYMMDDHHIISST. The precision is 1/10 of a second.

Top of page

When is a CVM File Required?

For the IDL Extractor for Natural

Natural Syntax IDL Extractor for Natural CVM Reqired More Information
REDEFINE   yes Extracting Natural REDEFINES under Natural to IDL Mapping
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  

For the Natural Wrapper

Natural Wrapper CVM 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