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:
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.
If there is a CVM file and a corresponding IDL file, at least one of the IDL programs in the corresponding IDL file requires server-mapping information to correctly call the target server. For those IDL programs, there is a CVM entry (line) in the Workbench CVM file.
If there is an IDL file but no corresponding CVM file, there is no IDL program that requires server mapping information.
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.
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.
| 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 | ||
| 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 |
