Configuring Remote Servers

How to:

Reference:

x

Configuring the adapter consists of specifying connection and authentication information for each of the connections you want to establish.


Top of page

x
Procedure: How to Declare Connection Attributes

You can configure the adapter from either the Web Console or the Data Management Console.

  1. From the Web Console menu bar, click Adapters

    or

    from the Data Management Console, expand the Adapters folder.

    The Adapters folder opens.

  2. Expand the Available folder, if it is not already expanded.
  3. Click the Remote Servers link. The Remote Server Configuration pane displays basic parameters that are appropriate for the active protocol. If you wish to define connection parameters for services, click Advanced to expose additional connection options.
  4. Enter values for the parameters required by the adapter as described in the connection attributes reference.
  5. Click Configure. The configured adapter is added to the Adapters list in the navigation pane.

Tip: After you configure the remote server, you can test the connection by clicking the Remote Servers folder and selecting Test from the menu.


Top of page

x
Reference: Connection Attributes for Remote Servers

The following list describes the connection attributes for which you can supply values. To complete the attribute declaration, click the Configure button.

Basic

NODE

8-character string

Defines the logical name of a node block, which must be unique in the file. The logical name can be a maximum of 8 characters, must begin with a letter, and can include any characters, except semicolon and equal sign. A node block contains keyword-value pairs, which are enclosed in a BEGIN-END statement. The following is an example of a node block:

NODE = ABC
BEGIN
   DESCRIPTION = client node block
   CLASS = CLIENT
   PROTOCOL = TCP
   HOST = localhost
   PORT = 8100
END
HOST

string

Defines the host that a client is connecting to or an IP address that a listener is listening on.

PORT

positive integer number

Defines the TCP port number that a client is connecting to or a listener is listening on.

HTTP_PORT

positive integer number

Defines the TCP port number on which the remote server's Web Console listener is listening. Also used in declaring a communication block for the purpose of Remote Synonyms.

CLASS

If this is a z/OS server, you must include a qualifier.

SECURITY

Defines the authentication method used in communication to a remote server if no credentials are provided to the application.

  • IWA for Integrated Windows Authentication between a Windows client and a Windows server.
  • PWP for password passthrough authentication.
  • TRUSTED for a trusted connection, where the current logged on user ID is passed to the server.
  • userid,password where any value other than IWA, PWP or TRUSTED is considered a userid and password string for EXPLICIT authentication.

    The information may be clear text or encrypted. Encrypting is automatic when the Web Console is used to set values.

    Any ENGINE EDA SET CONNECTION_ATTRIBUTES server/userid,password command issued in a profile (server, group or user) or in a procedure overrides any value set by SECURITY = (including IWA, PWP, TRUSTED).

DESCRIPTION

string

Description for the server node.

Advanced. These options enable you to provide connection information for specific services.

SERVICE NAME

CLIENT (servicename)

Defines how to send outbound communications to a remote server.

servicename is optional. If provided, it must match the value of SERVICE in the service block of the server.

HTTP_SSL

0 or 1

Defines whether the Secure Sockets Layer protocol is used in the remote server Web Console listener:

  • 0 if no SSL is used in the connection to the Web Console.
  • 1 if SSL is used in the connection to the Web Console.
COMPRESSION

0 or 1

Activates data compression in a data transfer between client and server:

  • 0 for no compression.
  • 1 for compression on.
ENCRYPTION

0 or DES or Advanced or IBCRYPT

Defines the encryption method used in data transfer between client and server:

  • 0 for no encryption.
  • DES for 56-bit fixed-key Data Encryption Standard.
  • Advanced, enables you to more easily select and combine ciphers, modes, and RSA key lengths. This option provides the following ciphers: 3DES, AES 128, AES192, AES 256; and the following modes: ECB and CBC.
  • IBCRYPT for user-defined algorithm. The key is 512-bit RSA-encrypted.

Note: Only 0 and DES are supported for HTTP protocol.

CONNECT_LIMIT

number of seconds

Defines the maximum time that the client will wait for a TCP connection response from the server:

  • -1 for indefinite wait.
  • 0 for no wait.
MAXWAIT

Defines the time, in seconds, that the client will wait for a response from the server:

-1 indicates an indefinite timeout.


WebFOCUS