JDBC Driver Implementation and Configuration › Java Properties File › Properties Files › Global Options

Global Options

The following global options can be specified in the properties file:

ApplicationID=<application_name>

Specifies the application used in the startup JCL. This must match the APPLID= for the server running on the mainframe.

ConnectType=CCI|TCP

Specifies the type of connection to be made to the mainframe server. TCP is valid only if PROTOCOL=BOTH is specified on the mainframe server region to which you are connecting. CCI is valid only if CAICCI is present. However, the default is ConnectType=CCI. Therefore, ConnectType is required for TCP/IP connection types (z/OS only).

FetchRows=

This option is not available in this release.

HostName=<hostname>

Specifies the host name or the IP address for the mainframe where the mainframe server region resides.

HostName is required if ConnectType=TCP.

HostName is optional if ConnectType=CCI. If the application is running under Windows, HostName overrides the CCI Server Identification Name/IP Address provided in the CAICCI-PC Properties dialog. If the application is running under USS, HostName defaults to the mainframe system on which the application executes

HostPort=<hostport>

Specifies the host port number.

HostPort is required if ConnectType=TCP and must match the TCPIP_PORT specification in the mainframe server region startup parameters.

HostPort is optional if ConnectType=CCI. If the application is running under Windows, HostPort overrides the CCI Server Identification Port number provided in the CAICCI-PC Properties dialog. If the application is running under USS, HostPort is ignored and the connection is directed to the mainframe server region by the ApplicationID parameter

LogTimeout=<nnn>

Specifies the number of seconds to wait until a time out occurs on a logon attempt.

Option.CloseCommit=0|1

Specifies that a COMMIT will occur on each CLOSE CURSOR.

Option.CommitBehavior=1|2

Specifies whether the ResultSet object is to be kept open or is to be closed after the transaction in which it was created is committed. Specify 1 to keep open or specify 2 to close.

ServerName=<server_name>

Identifies the server name that is used in the startup JCL for the mainframe server with which it communicates. It must match the SERVERNAME= value in the mainframe server startup parameters.

SystemID=<system_id>

Specifies the CAICCI SYSID provided in the CAICCI startup JCL.

If ConnectType=CCI, SystemID must match the CAICCI SYSID of the mainframe system where the mainframe server region resides.

If ConnectType=TCP, SystemID is a token that uniquely identifies the mainframe system where the mainframe server region resides. Since CAICCI is required in the mainframe system, we recommend that you use the CAICCI SYSID because it uniquely identifies the mainframe system.

Note: For more details on these options, see the installed javadoc for the ca.datacom.io.TraceObject package.