JDBC Driver Implementation and Configuration › DataSource Connection Parameters › DatacomDataSource

DatacomDataSource

The DatacomDataSource class implements the JDBC DataSource interface, and is used with an application server provided by the Java Naming and Directory Interface (JNDI) naming service to establish a connection to a CA Datacom database.

DataSource properties conform to the JavaBeans naming conventions and are implicitly defined by public setter and getter methods. For example, the description property, which is required for all DataSource implementations, is set using the setDescription(String) method. The application server can use the java.lang.reflection methods to discover DataSource properties and provide an interface to set them, or can simply require that they are defined in some configuration file.

DataSource properties are used to specify the connection parameters. These properties are the equivalent of the DriverPropertyInfo attributes described in the previous section, and can be used to completely define the parameters needed to connect to a database. Like a URL, a DataSource object can also reference an ODBC style data source name, where the connection parameters are defined in the registry on Windows, the configuration file on z/OS or UNIX, or even in the properties file.

ApplicationID

Specifies the application identification. Enter the same applid that is found in the startup JCL for the server application running on the mainframe.

ConnectType

Specifies the type of connection. Enter CCI for CAICCI or TCP for native TCP/IP connection (z/OS only).

DataSourceName

Specifies the logical data source name. Container provided DataSource implementations use this to name the ConnectionPoolDataSource object. The DataSource implementation does not use this internally.

description

Specifies the data source description. This property is required of all DataSource implementations.

HostName

Specifies the host name. Enter the host name or IP address for the host on which the mainframe server resides.

HostPort

Specifies the port number for the host. Enter the CCI port number specified in the mainframe CCI address space if connecting through CCI.

Enter the TCP/IP port number (z/OS only) specified in the mainframe server startup if connecting through TCP/IP or the default (5465) TCP/IP port number.

networkProtocol

Specifies TCP or CCI.

• TCP indicates that the connection is through the JDBC Proxy, and must be used when the JDBC driver is not running on Windows or the mainframe.
• CCI indicates that the connection is through CAICCI, either CAICCI-PC on Windows or ENF on a mainframe.

password

Specifies the default user ID password. The application can override this when the connection is established. The getter method does not return the value.

PortNumber

Specifies the TCP/IP port number (z/OS only) of the JDBC Proxy or CCITCP address space, depending on the value of networkProtocol.

serverName

Specifies the TCP/IP server name (z/OS only). When networkProtocol is TCP, it refers to the machine where the JDBC Proxy is running, which can be on any platform. When networkProtocol is CCI, it refers to the mainframe where the CCITCP address space is running.

System ID

Specifies the system identification. Enter the CAICCI system ID of the mainframe environment to which the workstation is to connect. This is the SYSID name specified in the CAICCI startup JCL.

user

Specifies the default user ID to sign on to CA Datacom. The application can override this when the connection is established.