Generating the Proxy › Before You Start › Associate Character Names

Associate Character Names

Proxies use information from the model such as pstep and entity names. The file PROXYNMS.DAT is used at generation time to associate alternative names with the model names. The file is created during proxy generation if the environment variable GEN_PROXY_WRITE_NAMES is set.

There are two situations where this file is used:

• Your model uses NLS (National Language Set) characters.
• Valid characters are ASCII A through Z, 0 through 9, and underscore. The proxy generator removes NLS characters from names that would cause compilation errors in the proxies. NLS characters that do not affect compilation are not removed (such as in literal strings and permitted values). This removal can cause problems if the name contained only NLS characters or if the name is now no longer unique. For example, the name ÏÑ would be an empty string causing problems in the proxy.
• Names used in the model are awkward.

  Your model may use names that are non-descriptive, excessively long or otherwise not useful. For example, the pstep name might be STEP3, which is not descriptive. You can use a name such as CREATE_CUSTOMER_RECORD.

Note: Many model names cannot be overridden in this manner, so it is more beneficial to change the model names instead.

All proxies that are generated for the model except the Standard Java Proxy use the file PROXYNMS.DAT located in the <model‑name>.ief directory. Regenerating the proxy updates the file with new names while not affecting old names. Be sure to check the file after each generation.

Delete the GEN_PROXY_WRITE_NAMES environment variable if you do not want to create or update the PROXYNMS.DAT file.

If you use the PROXYNMS.DAT file, remember that it has an impact on the generated code. Include this file when you distribute the model or track model changes using a code management tool.

The following is a sample PROXYNMS.DAT file. On the left side of the equal sign are the names used in the model. On the right side of the equal sign are the names used in the proxy. Note the duplicate name PRXLS and the empty string used for ÑË.

PRÕXÝÑLS=PRXLS
ÕPRÕXÝÑLS=PRXLS
S_PROXY_NLS_ÑÁMË=S_PROXY_NLS_M
ÑË=
NLS_WÔRKÏNG_LÌST=NLS_WRKNG_LST
ÏD=D
ÖÜT=T

To correct these problems, edit the file using an editor that supports NLS characters, and then regenerate the proxy. The proxy generator checks that the names contain valid characters and are the correct length. If necessary, the invalid characters are removed and the name is truncated.

The following is a sample PROXYNMS.DAT file after it has been edited:

PRÕXÝÑLS=PRXLS
ÕPRÕXÝÑLS=OPRXLS
S_PROXY_NLS_ÑÁMË=S_PROXY_NLS_NAME
ÑË=NE
NLS_WÔRKÏNG_LÌST=NLS_WRKNG_LST
ÏD=D
ÖÜT=T

Note: Be sure to check the PROXYNMS.DAT file each time the proxy is generated and after the model or PROXYNMS.DAT file is changed.