Controlling Client Access to Databases

You can control client access to Adabas databases in two ways:

  • Locally, using local Entire Net-Work Client definitions. These definitions are stored in the Entire Net-Work Client configuration file on the local machine, and are therefore available only to the local client.

  • Globally, using Adabas Directory Server definitions. These definitions are stored in the Directory Server configuration file, wherever the Adabas Directory Server is installed, and are published and available for other clients using the same Directory Server.

Updates to the Directory Server configuration affect all clients that use the Directory Server updates to the Entire Net-Work Client configuration only affect the individual client. Entire Net-Work Client configurations can be very useful, therefore, if you want to test a configuration before publishing it for additional clients in the Directory Server.

Using a local Entire Net-Work Client configuration, you can control client access to Adabas databases in two ways:

  • You can use filtering to identify databases that the client can and cannot access.

  • You can define local Adabas access definitions for specific databases.

The difference between the two methods is that you can specify additional connection parameters to a database in an Adabas access definition, whereas filtering controls all connections to the database. The two methods do work in conjunction. For example, if your filtering allows access to a given database, you can further qualify that access by specifying additional database access parameters, as described in this document. But, if your filtering does not allow access to a given database, no additional database access settings you may have specified are processed.

For complete information on filtering in the Entire Net-Work Client configuration, read Understanding Filtering.

Globally, you can perform such filtering in the Directory Server configuration, using partitioning and target definitions. For more information about using the Directory Server, read the Software AG Directory Server Installation and Administration Guide.

This document describes how to control client access to databases in the Entire Net-Work Client configuration. It covers the following topics:


Maintaining Adabas Access Definitions

You can specify access definitions for specific Adabas databases. This access definition will be used when the database is accessed by the client. However, if filtering for the client configuration does not allow access to the database, this access definition is ignored.

This section covers the following topics:

Adding Adabas Access Definitions

Using the System Management Hub (SMH), you can add Adabas database access definitions for a client configuration.

Start of instruction setTo add an Adabas access definition to a client configuration:

Make sure you have accessed the System Management Hub.

  1. Select and expand Entire Net-Work Client from the list in tree-view to access the Entire Net-Work Client administration area.

  2. Select and expand Clients from the Entire Net-Work Client sublist.

    A list of machine names appears. The machines listed are computers on which clients managed by this installation of the System Management Hub are defined.

  3. Select and expand the client machine on which the client configuration is defined.

    The list of clients defined on the client machine appears.

  4. Right-click on the client configuration to which you want to add an Adabas access definition and select Add Adabas Access from the resulting drop-down menu.

    The Add Adabas Access Definition panel appears in detail-view.

    graphics/addAdadb.png

  5. Modify the parameters on the Add Adabas Access Definition panel, as described in the following table. When all parameters are set as you want, click OK.

    Parameter Description Required? Default
    Adabas ID Specify the ID of the Adabas database to which this definition applies. Yes
    Protocol Type Select the communication protocol that will be used to connect to the database: TCP/IP or SSL Yes
    Host Address Specify the name of the host computer where the database runs. Yes
    Port Value The port number of the host computer for the database. Yes
    Reconnect Click in the checkbox if you want reconnection attempts to occur if the database connection is disconnected due to some failure in the system. If this check box is not checked, no reconnection attempt is made. No No reconnection attempt is made.
    Retry Count Specify the number of times reconnection should be attempted. The valid range is "0" through "2147483648". A value should only be specified for this parameter if the Reconnect parameter is turned on (checked). If no value is specified, reconnection attempts do not occur. No 0
    Retry Interval Specify the number of seconds to wait between reconnection attempts. The valid range is "0" through "2147483648". A value should only be specified for this parameter if the Reconnect parameter is turned on (checked). If no value is specified, reconnection attempts do not occur. No 0
    Additional Parameters Specify additional parameters as described in Parameters, in the chapter entitled Directory Server Target Entries of the Software AG Directory Server Installation and Administration Guide. Separate parameters in this field with ampersand (&) symbols. No

    The Adabas access definition is added to the client configuration.

Listing Adabas Access Definitions

Start of instruction setTo list the Adabas access definitions of a client configuration:

Make sure you have accessed the System Management Hub.

  1. Select and expand Entire Net-Work Client from the list in tree-view to access the Entire Net-Work Client administration area.

  2. Select and expand Clients from the Entire Net-Work Client sublist.

    A list of machine names appears. The machines listed are computers on which clients managed by this installation of the System Management Hub are defined.

  3. Select and expand the client machine on which the client configuration is defined.

    The list of client configurations defined on the client machine appears.

  4. In tree-view, expand the client configuration containing the Adabas access definitions you want to review.

    Options for the Adabas access and additional access parameter definitions appear in tree-view.

  5. Select and expand Adabas Access Definitions in the tree-view list for the client configuration.

    The Adabas access definitions are listed in detail-view as well as in the tree-view list below the Adabas Access Definitions heading.

Modifying Adabas Access Definitions

Start of instruction setTo modify an Adabas access definition:

Make sure you have accessed the System Management Hub.

  1. Select and expand Entire Net-Work Client from the list in tree-view to access the Entire Net-Work Client administration area.

  2. Select and expand Clients from the Entire Net-Work Client sublist.

    A list of machine names appears. The machines listed are computers on which clients managed by this installation of the System Management Hub are defined.

  3. Select and expand the client machine on which the client configuration is defined.

    The list of client configurations defined on the client machine appears.

  4. In tree-view, expand the client configuration containing the Adabas access definitions you want to modify.

    Options for the Adabas access and additional access parameter definitions appear in tree-view.

  5. Select and expand Adabas Access Definitions in the tree-view list for the client configuration.

    The Adabas access definitions are listed in detail-view as well as in the tree-view list below the Adabas Access Definitions heading.

  6. In tree-view, right-click on the Adabas access definition you want to modify and select Modify Entry from the resulting drop-down menu.

    The Modify Adabas Access panel appears in detail-view.

    graphics/modAdadb.png

  7. Modify the parameters on the Modify Adabas Access panel, as described in the following table. When all parameters are set as you want, click OK.

    Parameter Description Required? Default
    Port The port number of the host computer for the database. Yes
    Host The name of the host computer on which the database is installed. Yes
    Protocol Type Select the communication protocol that will be used to connect to the database: TCP/IP or SSL No The original communications protocol selected when the definition was created is used.
    Additional Parameters Specify additional parameters as described in Parameters, in the chapter entitled Directory Server Target Entries of the Software AG Directory Server Installation and Administration Guide. Separate parameters in this field with ampersand (&) symbols. No

    The Adabas access definition is modified.

Deleting Adabas Access Definitions

Start of instruction setTo delete an Adabas access definition in a client configuration:

Make sure you have accessed the System Management Hub.

  1. Select and expand Entire Net-Work Client from the list in tree-view to access the Entire Net-Work Client administration area.

  2. Select and expand Clients from the Entire Net-Work Client sublist.

    A list of machine names appears. The machines listed are computers on which clients managed by this installation of the System Management Hub are defined.

  3. Select and expand the client machine on which the client configuration is defined.

    The list of client configurations defined on the client machine appears.

  4. In tree-view, expand the client configuration containing the Adabas access definitions you want to delete.

    Options for the Adabas access and additional access parameter definitions appear in tree-view.

  5. Select and expand Adabas Access Definitions in the tree-view list for the client configuration.

    The Adabas access definitions are listed in detail-view as well as in the tree-view list below the Adabas Access Definitions heading.

  6. In tree-view, tight-click on the Adabas access definition you want to delete and select Delete Entry from the resulting drop-down menu.

    A panel appears in tree-view verifying that you want to delete the access definition.

  7. Click OK to confirm deletion of the Adabas access definition from the client configuration.

    The definition is deleted from the configuration.

Maintaining Additional Database Access Parameters

You can specify additional access parameters for specific Adabas databases. These access parameters will be used in conjunction with any other database access specifications specified for the database when it is accessed by the client. However, if filtering for the client configuration does not allow access to the database, these database access parameters are ignored.

This section covers the following topics:

Adding Additional Access Parameter Definitions

Using the System Management Hub (SMH), you can specify additional access parameters for specific Adabas databases.

Start of instruction setTo add an additional access parameter definition to a client configuration:

Make sure you have accessed the System Management Hub.

  1. Select and expand Entire Net-Work Client from the list in tree-view to access the Entire Net-Work Client administration area.

  2. Select and expand Clients from the Entire Net-Work Client sublist.

    A list of machine names appears. The machines listed are computers on which clients managed by this installation of the System Management Hub are defined.

  3. Select and expand the client machine on which the client configuration is defined.

    The list of client configurations defined on the client machine appears.

  4. Right-click on the client configuration to which you want to add an Adabas access parameter definition and select Add Additional Access Parameters from the resulting drop-down menu.

    The Add Additional Access Parameters panel appears in detail-view.

    graphics/addacprm.png

  5. Modify the parameters on the Add Additional Access Parameters panel, as described in the following table. When all parameters are set as you want, click OK.

    Parameter Description Required? Default
    Adabas ID Specify the ID of the Adabas database to which this definition applies. Yes
    Reconnect Click in the checkbox if you want reconnection attempts to occur if the database connection is disconnected due to some failure in the system. If this check box is not checked, no reconnection attempt is made. No No reconnection attempts are made.
    Retry Count Specify the number of times reconnection should be attempted. The valid range is "0" through "2147483648". A value should only be specified for this parameter if the Reconnect parameter is turned on (checked). If no value is specified, reconnection attempts do not occur. No 0
    Retry Interval Specify the number of seconds to wait between reconnection attempts. The valid range is "0" through "2147483648". A value should only be specified for this parameter if the Reconnect parameter is turned on (checked). If no value is specified, reconnection attempts do not occur. No 0
    Additional Parameters Specify additional parameters as described in Parameters, in the chapter entitled Directory Server Target Entries of the Software AG Directory Server Installation and Administration Guide. Separate parameters in this field with ampersand (&) symbols. No

    The Adabas access parameter definition is added to the client configuration.

Listing Additional Access Parameter Definitions

Start of instruction setTo list the additional access parameter definitions of a client configuration:

Make sure you have accessed the System Management Hub.

  1. Select and expand Entire Net-Work Client from the list in tree-view to access the Entire Net-Work Client administration area.

  2. Select and expand Clients from the Entire Net-Work Client sublist.

    A list of machine names appears. The machines listed are computers on which clients managed by this installation of the System Management Hub are defined.

  3. Select and expand the client machine on which the client configuration is defined.

    The list of client configurations defined on the client machine appears.

  4. In tree-view, expand the client configuration containing the Adabas access parameter definitions you want to review.

    Options for the Adabas access and additional access parameter definitions appear in tree-view.

  5. Select and expand Additional Access Parameters in the tree-view list for the client configuration.

    The Adabas access parameter definitions are listed in detail-view as well as in the tree-view list below the Additional Access Parameters heading.

Modifying Additional Access Parameter Definitions

Start of instruction setTo modify an additional access parameter definition:

Make sure you have accessed the System Management Hub.

  1. Select and expand Entire Net-Work Client from the list in tree-view to access the Entire Net-Work Client administration area.

  2. Select and expand Clients from the Entire Net-Work Client sublist.

    A list of machine names appears. The machines listed are computers on which clients managed by this installation of the System Management Hub are defined.

  3. Select and expand the client machine on which the client configuration is defined.

    The list of client configurations defined on the client machine appears.

  4. In tree-view, expand the client configuration containing the Adabas access parameter definitions you want to modify.

    Options for the Adabas access and additional access parameter definitions appear in tree-view.

  5. Select and expand Additional Access Parameters in the tree-view list for the client configuration.

    The Adabas access parameter definitions are listed in detail-view as well as in the tree-view list below the Additional Access Parameters heading.

  6. In tree-view, right-click on the Adabas access parameter definition you want to modify and select Modify Entry from the resulting drop-down menu.

    The Modify Additional Parameters panel appears in detail-view.

    graphics/modacprm.png

  7. Modify the parameters on the Modify Additional Parameters panel, as described in the following table. When all parameters are set as you want, click OK.

    Parameter Description Required? Default
    Additional Parameters Specify additional parameters as described in Parameters, in the chapter entitled Directory Server Target Entries of the Software AG Directory Server Installation and Administration Guide. Separate parameters in this field with ampersand (&) symbols. No If all additional parameter are removed, the Adabas access parameter definition is also removed.

    The access parameter definition is modified.

Deleting Additional Access Parameter Definitions

Start of instruction setTo delete an additional access parameter definition in a client configuration:

Make sure you have accessed the System Management Hub.

  1. Select and expand Entire Net-Work Client from the list in tree-view to access the Entire Net-Work Client administration area.

  2. Select and expand Clients from the Entire Net-Work Client sublist.

    A list of machine names appears. The machines listed are computers on which clients managed by this installation of the System Management Hub are defined.

  3. Select and expand the client machine on which the client configuration is defined.

    The list of client configurations defined on the client machine appears.

  4. In tree-view, expand the client configuration containing the Adabas access definitions you want to delete.

    Options for the Adabas access and additional access parameter definitions appear in tree-view.

  5. Select and expand Additional Access Parameters in the tree-view list for the client configuration.

    The Adabas access parameter definitions are listed in detail-view as well as in the tree-view list below the Additional Access Parameters heading.

  6. In tree-view, right-click on the Adabas access parameter definition you want to delete and select Delete Entry from the resulting drop-down menu.

    A panel appears in tree-view verifying that you want to delete the access parameter definition.

  7. Click OK to confirm deletion of the Adabas access parameter definition from the client configuration.

    The definition is deleted from the configuration.