You can override the four default host connection configuration values; password, username, host address, and host port, that are set in the Project Preferences page.

You can override connection properties:

• Per Client Operation in the Properties view

  In the Transaction Studio, select the client operation name in the Project Explorer. In the Properties view, you can specify the connection parameters per client operation. These values are written to the plain-text properties file inside the project JAR file.

• In the <ProjectName>.properties file

  When you build your project, the output is copied to the <workspace>\<Project Name>\bin directory. In this directory, along with the <ProjectName>.jar file, is its associated <ProjectName>.properties file. This file is a copy of the properties file that is located inside the JAR file. You can specify new values or override existing values at the project or client operation level in this file.

  At runtime, if the values in the properties file differ from those specified within the JAR file, they will override the values in the properties file within the jar.

• In the method at execution time

  Every client operation becomes an execution method in the generated API. Every client operation method takes two parameters; an input bean specific to that method, and a TxConfig. The TxConfig is a container object for host address, port address, username and password values. It will override all other values. If you provide default values elsewhere and don't need this, you can just pass in null.

Other configuration options

In the <ProjectName>.properties file you can manually add other Bridge connection parameters.

• com.attachmate.cicsbridge.timeout — Number of seconds to wait for a host connection.
• com.attachmate.cicsbridge.client.codepage — The code page used by the client. Defaults to the JVM default.
• com.attachmate.cicsbridge.host.codepage — The code page used by the host. Defaults to CP037.
• com.attachmate.cicsbridge.trace — Set to True to enable tracing. This is the same property the BridgeApi uses.
• com.attachmate.cicsbridge.tracefileprefix — A name to prefix the trace file generated.
• com.attachmate.cicsbridge.locale — Used to format numbers to strings. More specifically, use if you want to interpret commas in numbers as decimal points.
• com.attachmate.cicsbridge.truncate.textfield — Used to handle standard codepage-translated fields when an input value to the field is longer than the field length. Set to True the input value is truncated to the field length and an event is logged. Set to False, which is the default, a TxRecordException is thrown.
• com.attachmate.cicsbridge.truncate.notranslate — Used to handle no-translate fields when an input value to the field is longer than the field length. Set to True the input value is truncated to the field length and an event is logged. Set to False, which is the default, a TxRecordException is thrown.

	Configure Connection Default Properties
	About Properties
	Create a Client Operation