ON_CCE - USAP configuration option
Description
The ON_CCE (On Character Conversion Error) option specifies what the NW RFC library will do when it encounters a character that either:
- Does not exist in the target codepage.
- Is a broken character.
- Is a control character (0x00 - 0x19).
Usage
Method | Syntax | IBM i | HP NonStop | UNIX | Windows | z/OS |
---|---|---|---|---|---|---|
Command Line, Short Form | n/a | |||||
Command Line, Long Form | -rfc_on_cce option | |||||
Environment Variable | USAP_RFC_ON_CCE=option | |||||
Configuration File Keyword | rfc_on_cce option |
Value
option specifies what the NW RFC library will do when it encounters a character that either:
- Does not exist in the target codepage.
- Is a broken character.
- Is a control character (0x00 - 0x19)
0 | Abort with an error message (default behavior). In this case, control characters (for example: tabulator, carriage return, or linefeed characters) are not considered "illegal" and will therefore not cause an abort. |
1 | Copy the character in a "round-trip compatible way". The resulting output character may be "garbage" in the target codepage, but when converted back to the source codepage, it will be the original character. |
2 | Replace the character with a substitute symbol (usually a # character). In this case, the control characters are replaced as well. If you need the control characters, then you will have to use option 0 or 1, depending on whether you want the NW RFC library to abort the call in case of broken characters or not. |
Command Usage
The ON_CCE option is an RFC (Remote Function Call) option.
RFC options are associated with program execution, not commands. They are used to configure the SAP NW RFC connection.