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.

Procedure: How to Configure an Adapter

  1. From the Web Console sidebar, click Connect to Data.

    or

    From the Data Management Console, expand the Adapters folder.

    In the DMC, the Adapters folder opens. In the Web Console, the Adapters page opens showing your configured adapters.

  2. In the Web Console, click the New Datasource button on the menu bar and find the adapter on the drop-down list or, in the DMC, expand the Available folder if it is not already expanded.
    On the Web Console, you can select a category of adapter from the drop-down list or use the search option (magnifying glass) to search for specific characters.
  3. In the DMC, expand the appropriate group folder and the specific adapter folder. The group folder is described in the connection attributes reference.
  4. Right-click the adapter name and/or version and select Configure.

    The Add Adapter to Configuration pane opens.

  5. Enter values for the parameters required by the adapter, as described in the chapter for the specific adapter you want to configure.
  6. Click Configure. The configured adapter is added to the Adapters list in the DMC resources tree or the Configured list in the Web Console.
    In the Web Console, the adapter remains on the Available Adapters list with a check mark to indicate that at least one connection has been configured. You can configure additional connections from either the Configured or Available list by right-clicking the adapter and clicking Add Connection.

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

Feedback