Configuring a IBM Connect:Direct Server
To configure general, TCP/IP, and database properties for a server, use the Properties dialog box.
To configure server properties:
- Click the server to configure.
- If the server is running, click the stop icon to stop the server.
- Select Server > Initialization Properties.
- Select one of the following Service Startup methods from
the pull-down menu:
- Automatic to start Connect:Direct IBM Connect:Direct every time the system starts.
- Manual to start Connect:Direct IBM Connect:Direct manually.
- Disabled to prevent Connect:Direct IBM Connect:Direct from being started.
- If necessary, change the settings on the General properties
page. Refer to the following table for a description of the fields:
Field Name Definition Valid Values Max API Connections
Specifies the maximum number of concurrent client API connections permitted for the local node. It defines the maximum number of connections by different userids. API connections by a single user ID has no limit.
A numeric value from 1–255. The default is 10.
Max Pnode Sessions
Specifies the maximum concurrent connections for all remote nodes where the local Connect:Direct for Microsoft Windows server node is the originator of the Process.
This field is limited to the lesser of the values defined in the initialization parameters file and the network map definition for a given node.
A numeric value from 1–255
Max Snode Sessions
Specifies the maximum concurrent connections, where the local Connect:Direct server node is the partner node cooperating with a remote Connect:Direct node to execute a Process.
This field is limited to the lesser of the values defined in the initialization parameters file and the network map definition for a given node.
A numeric value from 1–255
TCQ Startup
Specifies how the Connect:Direct server program starts with respect to the TCQ.
Warm to retain all existing Processes in the TCQ at server startup. If you select a warm start, all Processes in executing state when the server was stopped will restart when the server is restarted. Cold to delete all existing Processes in the TCQ at startup.
Max Total Sessions Specifies the maximum concurrent connections in total, where the local Connect:Direct server node is Pnode or Snode. This field is limited to the lesser of the sum/values defined in the initialization parameters file and the network map definition for a given node.
A numeric value from 1–510. TCQ Max Age
Specifies the maximum number of days a Process with Held due to Error (HE) status remains in the TCQ before it is automatically deleted.
A numeric value from 0–30. The default is 30 days. Connect:Direct does not automatically delete Processes when you specify 0.
Stat Max Age
Specifies the maximum age (in days) that statistics records are allowed to reach before the system automatically deletes them.
A numeric value from 0–30. The default is 7 days. Connect:Direct does not automatically delete statistics records when you specify 0.
- Click the API tab. If necessary change the default values
of API fields. Refer to the following table for a description of the
fields:
Field Name Definition Valid Values Enable TCP/IP API Support
Enables TCP/IP API support.
enabled | disabled
API IP Address
Specifies the IP address that the Connect:Direct Requester or user-written API programs use to establish client sessions with the Connect:Direct server.
API Additional Addresses and Ports
A numeric value in the format
nnn.nnn.nnn.nnn (IPv4) or
nnnn:nnnn:nnnn:nnnn:nnnn
:nnnn:nnnn:nnnn (IPv6),
or the host name.API Port
Specifies the port number that the Requester or user-written API programs use to establish client sessions with this Connect:Direct server.
A numeric value in the format nnnn, where nnnn is a positive integer from 0 to 65535.
The default is 1363.
API Additional Addresses and Ports
Specifies additional addresses and ports that the Connect:Direct Requester or user-written API programs use to establish client sessions with this Connect:Direct server. Multiple address/host names (and combinations with port numbers) can be specified in this field. The port is separated from its corresponding address/host name with a semi-colon (;), and each address/host name and port combination is separated by a comma (,). A space may be added after the comma for readability.
A numeric value in the format
nnn.nnn.nnn.nnn (IPv4) or
nnnn:nnnn:nnnn:nnnn:nnnn
:nnnn:nnnn:nnnn (IPv6),
or the host name.For example, 10.20.9.175;2363, fd00:0:0:2014::7; 2364
This is an optional field.
Host Additional Addresses and Ports
Specifies additional IP addresses and ports for incoming communications from remote Connect:Direct nodes to this Connect:Direct server node. Multiple address/host names (and combinations with port numbers) can be specified in this field. The port is separated from its corresponding address/host name with a semi-colon (;), and each address/host name and port combination is separated by a comma (,). A space may be added after the comma for readability.
A numeric value in the format
nnn.nnn.nnn.nnn (IPv4) or
nnnn:nnnn:nnnn:nnnn:nnnn
:nnnn:nnnn:nnnn (IPv6),
or the host name.For example, 10.20.9.175:2364, mdallas;1364
This is an optional field.
Enable Dynamic Addressing (DHCP)
Enables dynamic addressing, so that the DHCP server will assign an IP address when it is requested for the Connect:Direct server node.
Disabled | Enabled
- Click the TCP/IP tab. If necessary change the default
values of TCP/IP fields. Refer to the following table for a description
of the fields:
Field Name Definition Valid Values Enable TCP/IP Support
Enables TCP/IP support.
enabled | disabled
Host IP Address
Specifies the IP address for incoming communications from remote Connect:Direct nodes to this Connect:Direct server node. A numeric value in the format
nnn.nnn.nnn.nnn (IPv4) or
nnnn:nnnn:nnnn:nnnn:nnnn
:nnnn:nnnn:nnnn (IPv6),
or the host name.Host Port
Specifies the port number for incoming communications from remote Connect:Direct nodes to this Connect:Direct server node.
A numeric value in the format nnnn, where nnnn is a positive integer from 0 to 65535.
The default is 1364.
Host Additional Addresses and Ports
Specifies additional IP addresses and ports for incoming communications from remote Connect:Direct nodes to this Connect:Direct server node. Multiple address/host names (and combinations with port numbers) can be specified in this field. The port is separated from its corresponding address/host name with a semi-colon (;), and each address/host name and port combination is separated by a comma (,). A space may be added after the comma for readability.
A numeric value in the format
nnn.nnn.nnn.nnn (IPv4) or
nnnn:nnnn:nnnn:nnnn:nnnn
:nnnn:nnnn:nnnn (IPv6),
or the host name;nnnnFor example, 10.20.9.175:2364, mdallas;1364
This is an optional field.
Buffer Size
Specifies the data buffer size for transmitting data to and from a remote Connect:Direct node if the value is not in the network map entry. The value entered in the Buffer Size field of the network map TCP/IP Communication Mode object overrides this value.
A numeric value from 256–65536.
The default is 65535.
Enable Dynamic Addressing (DHCP)
Enables dynamic addressing, so that the DHCP server will assign an IP address when it is requested for the Connect:Direct server node.
Disabled | Enabled
- Click the Database tab.
- Click Modify Settings to invoke the Database Wizard utility. Use the utility to configure the ODBC and database environments.
- Select one of the following database types:
- Microsoft SQL Server
- PostgreSQL
- If you selected Microsoft SQL server:
- Identify the TCQ/Stats data source in the TCQ/Stats Datasource field.
- Identify the data source for message in the Message Datasource field.
- Identify the database name in the Database Name field.
- To specify the SQL server, type or select the name of the SQL server or click (...) to select a network SQL server.
- When you validate the information, click Finish.
- Click Yes to build the database.
- Click OK.