JCo 3 properties

Read on this page how to define the connection parameters for the communication between client and host.

The connection data for the communication between client and host can be defined globally in a properties file. For incoming connections, such a properties file is specified for each X4 SAP JCo 3 listener in <X4> /X4DB/0/saplistener.xml.

For outgoing connections via SAP Connector (JCo 3) and SAP Explorer (JCo 3), specify the path to such a properties file within the adapter parameter property file.

Parameter values set within the adapter overwrite the configuration in the properties file at runtime. All properties that are set in the properties file (also additional properties), are taken over by the X4 SAP JCo 3 system.

Properties structure

JAVA

# connection String to SAP
jco.server.gwhost  = Gateway Host
jco.server.gwserv  = Gateway Service (normally sapgwNN)
jco.server.progid  = Program ID
jco.server.trace   = Activate (1) or deactivate (0) RFC Trace 
jco.server.unicode = Connect (1) or do not connect (0) in Unicode mode

# equivalent to (dynamic) adapter parameter 'User'
jco.client.user = User name

# equivalent to (dynamic) adapter parameter 'Password'
jco.client.passwd = Password

# equivalent to (dynamic) adapter parameter 'Client'
jco.client.client = SAP client (3-digit numeric value)

# equivalent to (dynamic) adapter parameter 'Language'
jco.client.lang = Login language 

# equivalent to (dynamic) adapter parameter 'SystemNumber'
jco.client.sysnr = SAP system number

# equivalent to (dynamic) adapter parameter 'RouterString'
jco.client.ashost = Router string

# (optional) type of SAP system 2 = R/2, 3 = R/3, E = External

# equivalent to (dynamic) adapter parameter 'SystemType'
jco.client.type = Type of the remote hosts

# set to true if transactions are used
# equivalent to (dynamic) adapter parameter 'TransactionEnabled'
x4.transactionEnabled = Enable (true) or disable (false) transactionale processing 

# Should be set for each initiated transaction
# equivalent to (dynamic) adapter parameter 'TransactionId'
x4.transactionID = Transaction ID (for each initiated transaction)

Example

In the following an example of a properties file with some values set:

JAVA

# equivalent to (dynamic) adapter parameter 'User'
jco.client.user = <user>

# equivalent to (dynamic) adapter parameter 'Password'
jco.client.passwd = <pwd>

# equivalent to (dynamic) adapter parameter 'Client'
jco.client.client = 800

# equivalent to (dynamic) adapter parameter 'Language'
jco.client.lang = DE

# equivalent to (dynamic) adapter parameter 'SystemNumber'
jco.client.sysnr = 00

# equivalent to (dynamic) adapter parameter 'RouterString'
jco.client.ashost =

# (optional) type of SAP system  2 = R/2, 3 = R/3, E = External
# equivalent to (dynamic) adapter parameter 'SystemType'
jco.client.type = 3

# set to true if transactions are used
# equivalent to (dynamic) adapter parameter 'TransactionEnabled'
x4.transactionEnabled = false

# Should be set for each initiated transaction
# equivalent to (dynamic) adapter parameter 'TransactionId'
x4.transactionID = 1

Additional information: