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

(tick)

(tick)

Environment Variable

USAP_RFC_ON_CCE=option

(tick)

(tick)

Configuration File Keyword

rfc_on_cce option

(tick)

(tick)

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.